feat: add autonomous fiscal control panel

agent/scripts/run_agent_service.py

@@ -206,6 +206,7 @@ def run(config, env, *, max_iterations=None, stopper=None):
     executor = load_executor()
     state = AgentState(config.state_db)
     client = HubClient(config.hub_url, config.agent_token)
+    installation_id = state.installation_id() if hasattr(state, "installation_id") else (config.agent_id or "legacy-installation")
     stopper = stopper if stopper is not None else GracefulStop()
 
     backoff = 1
@@ -218,7 +219,18 @@ def run(config, env, *, max_iterations=None, stopper=None):
         iterations += 1
 
         try:
-            client.heartbeat("IDLE", schema_fingerprint=config.schema_fingerprint, agent_version=config.agent_version, last_job_id=last_job_id)
+            heartbeat_payload = {
+                "installation_id": installation_id, "status": "IDLE", "schema_fingerprint": config.schema_fingerprint,
+                "agent_version": config.agent_version, "last_job_id": last_job_id, "display_name": env.get("AGENT_DISPLAY_NAME", ""),
+                "customer_code": env.get("CUSTOMER_CODE"), "hostname": env.get("AGENT_HOSTNAME") or os.environ.get("COMPUTERNAME"),
+                "windows_version": env.get("WINDOWS_VERSION"), "company_code": config.company_id, "company_uf": config.company_uf,
+                "database_path": config.database_path, "capabilities": {"heartbeat": True, "jobs": True, "local_logs": True},
+                "fiscal_engine_version": env.get("FISCAL_ENGINE_VERSION", config.agent_version), "dataset_versions": {},
+            }
+            if hasattr(client, "heartbeat_metadata"):
+                client.heartbeat_metadata(heartbeat_payload)
+            else:
+                client.heartbeat("IDLE", schema_fingerprint=config.schema_fingerprint, agent_version=config.agent_version, last_job_id=last_job_id)
             if was_down:
                 logger.info("reconnected to Hub after %ss backoff", backoff)
                 was_down = False
@@ -246,7 +258,10 @@ def run(config, env, *, max_iterations=None, stopper=None):
         last_job_id = job.get("job_id")
         logger.info("job %s received: kind=%s", job.get("job_id"), job["kind"])
         try:
-            client.heartbeat("BUSY", schema_fingerprint=config.schema_fingerprint, agent_version=config.agent_version, last_job_id=last_job_id)
+            if hasattr(client, "heartbeat_metadata"):
+                client.heartbeat_metadata({"installation_id": installation_id, "status": "BUSY", "schema_fingerprint": config.schema_fingerprint, "agent_version": config.agent_version, "last_job_id": last_job_id})
+            else:
+                client.heartbeat("BUSY", schema_fingerprint=config.schema_fingerprint, agent_version=config.agent_version, last_job_id=last_job_id)
         except Exception:
             pass  # best-effort; the job itself still proceeds
 

agent/src/gti_fiscal_agent/client.py

@@ -20,6 +20,15 @@ class HubClient:
         payload = {"status": status, "schema_fingerprint": schema_fingerprint, "agent_version": agent_version, "last_job_id": last_job_id}
         response = httpx.post(f"{self.url}/v1/agents/heartbeat", json=payload, headers=self._headers(), timeout=15)
         response.raise_for_status(); return response.json()
+    def register(self, payload):
+        response = httpx.post(f"{self.url}/v1/agents/register", json=payload, headers=self._headers(), timeout=15)
+        response.raise_for_status(); return response.json()
+    def heartbeat_metadata(self, payload):
+        response = httpx.post(f"{self.url}/v1/agents/heartbeat", json=payload, headers=self._headers(), timeout=15)
+        response.raise_for_status(); return response.json()
+    def event(self, payload):
+        response = httpx.post(f"{self.url}/v1/agents/events", json=payload, headers=self._headers(), timeout=15)
+        response.raise_for_status(); return response.json()
     def next_job(self):
         response = httpx.get(f"{self.url}/v1/jobs/next", headers=self._headers(), timeout=15)
         response.raise_for_status(); return response.json()

agent/src/gti_fiscal_agent/state.py

@@ -1,11 +1,21 @@
 """Local SQLite outbox; it has no Firebird dependency or write path."""
 import sqlite3
 from pathlib import Path
+import uuid
 
 class AgentState:
     def __init__(self, path):
         self.connection = sqlite3.connect(Path(path)); self.connection.row_factory = sqlite3.Row
         self.connection.executescript("CREATE TABLE IF NOT EXISTS product_state(product_id TEXT PRIMARY KEY, source_fingerprint TEXT NOT NULL, dataset_version TEXT NOT NULL, engine_version TEXT NOT NULL, status TEXT NOT NULL, last_processed_at TEXT, last_result_hash TEXT, reason_code TEXT); CREATE TABLE IF NOT EXISTS outbox(product_id TEXT PRIMARY KEY, source_fingerprint TEXT NOT NULL, status TEXT NOT NULL, retries INTEGER NOT NULL DEFAULT 0); CREATE TABLE IF NOT EXISTS ipi_write_log(product_id TEXT NOT NULL, source_fingerprint TEXT NOT NULL, decision_status TEXT, ipi_status TEXT, write_status TEXT NOT NULL, before_value TEXT, proposed_value TEXT, result TEXT, reason_code TEXT, timestamp TEXT NOT NULL);")
+        self.connection.execute("CREATE TABLE IF NOT EXISTS installation_identity (id INTEGER PRIMARY KEY CHECK(id=1), installation_id TEXT NOT NULL)")
+        self.connection.commit()
+    def installation_id(self):
+        row = self.connection.execute("SELECT installation_id FROM installation_identity WHERE id=1").fetchone()
+        if row:
+            return row["installation_id"]
+        value = str(uuid.uuid4())
+        self.connection.execute("INSERT INTO installation_identity(id, installation_id) VALUES(1, ?)", (value,)); self.connection.commit()
+        return value
     def enqueue(self, product_id, source_fingerprint, dataset_version, engine_version):
         row = self.connection.execute("SELECT * FROM product_state WHERE product_id=?", (product_id,)).fetchone()
         if row and tuple(row[key] for key in ("source_fingerprint", "engine_version", "status")) == (source_fingerprint, engine_version, "RESULT_RECEIVED"): return False