Merge pull request #29 from gramaziokohler/feat/cross-language-serialization

feat!: consume the Antikythera and compas_pb TypeScript SDKs

Author: gonzalocasas

.github/workflows/test.yml

@@ -23,8 +23,5 @@ jobs:
       - name: Install dependencies
         run: npm ci
 
-      - name: Generate proto bundle
-        run: npm run proto:update
-
       - name: Run tests
         run: npm test

CHANGELOG.md

@@ -18,6 +18,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Blueprint uploads rejected by the API report each reason in the notification overlay, alongside session failures, instead of a bare "Upload failed" status line.
 - Notification messages longer than 140 characters are collapsed to a word-boundary preview with a "show more.." toggle; expanded messages scroll instead of growing the toast without limit.
 - Session failures are reported through the notification overlay instead of the inline error line, titled with the error code (e.g. "Session failed: SCOPE_CONDITION_ERROR"). The banner previously rendered `[object Object]`, since the error is COMPAS-serialized and its fields live under `data`.
+- **Breaking:** Browser agents now read and write the `compas_pb` v1 wire format, including its versioned root envelope, explicit integer/float fields, and native nested list/dictionary fields.
+- Protobuf generation now downloads the official `compas-dev/compas_pb` definitions pinned to v1.1.4 instead of following the legacy repository's `main` branch.
 - `SessionMonitor` replaced its 500ms polling loop with `useSessionStream`; only a single long-lived SSE connection is opened per session.
 - Pause and resume apply optimistic state updates immediately; the stream confirms or corrects them.
 - `task_state_changed` events are filtered by `visibleBlueprintId` so drilling into a composite task's inner blueprint does not apply outer events to the displayed graph.

README.md

@@ -25,7 +25,7 @@ To generate the necessary files:
 npm run proto:update
 ```
 
-The script will attempt to download `antikythera.proto` and `compas_pb` definitions from their respective GitHub repositories. If the `antikythera` repository is private, you can provide a `GITHUB_TOKEN` environment variable, or ensure the backend repository is checked out in a sibling directory named `antikythera` for a local fallback.
+The script will attempt to download `antikythera.proto` and the pinned `compas_pb` v1 definitions from their respective GitHub repositories. If the `antikythera` repository is private, you can provide a `GITHUB_TOKEN` environment variable, or ensure the backend repository is checked out in a sibling directory named `antikythera` for a local fallback.
 
 ## Configuration
 

package-lock.json

@@ -5,23 +5,24 @@
   "type": "module",
   "scripts": {
     "dev": "vite",
-    "build": "node scripts/update-blueprint-schema.js && node scripts/update-protos.js && tsc -b && vite build",
-    "proto:update": "node scripts/update-protos.js",
+    "build": "node scripts/update-blueprint-schema.js && tsc -b && vite build",
     "schema:update": "node scripts/update-blueprint-schema.js",
     "lint": "eslint .",
     "preview": "vite preview",
     "test": "vitest run",
     "test:watch": "vitest"
   },
   "dependencies": {
+    "@bufbuild/protobuf": "^2.14.0",
     "@dagrejs/dagre": "^1.1.8",
+    "@gramaziokohler/antikythera-ts": "^0.1.0",
+    "@gramaziokohler/compas-pb-ts": "^3.0.0",
     "@react-three/drei": "^10.7.7",
     "@react-three/fiber": "^9.5.0",
     "@xyflow/react": "^12.9.3",
     "ajv": "^8.20.0",
     "lucide-react": "^0.563.0",
     "mqtt": "^5.14.1",
-    "protobufjs": "^7.5.4",
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
     "three": "^0.182.0",

package.json

@@ -1,7 +1,7 @@
 import { useState, useEffect } from 'react'
 import { UserPromptDialog } from './components/UserPromptDialog'
-import { MqttService } from './services/MqttService'
-import { AgentLauncher } from './agents/AgentLauncher'
+import { MqttService } from "@gramaziokohler/antikythera-ts/agents"
+import { AgentLauncher } from "@gramaziokohler/antikythera-ts/agents"
 import { BlueprintBackground } from './components/BlueprintBackground'
 import { NotificationManager } from './components/NotificationManager'