@axiom-lattice/cli-a2a 0.1.5 → 0.1.6

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @axiom-lattice/cli-a2a@0.1.5 build /home/runner/work/agentic/agentic/packages/cli-a2a
+> @axiom-lattice/cli-a2a@0.1.6 build /home/runner/work/agentic/agentic/packages/cli-a2a
 > tsup src/index.ts src/cli.ts --format cjs,esm --dts --clean --sourcemap
 
 CLI Building entry: src/cli.ts, src/index.ts
@@ -9,43 +9,45 @@
 CLI Cleaning output folder
 CJS Build start
 ESM Build start
-ESM dist/cli.mjs                    11.29 KB
-ESM dist/index.mjs                  824.00 B
-ESM dist/chunk-G7AGL2QA.mjs         10.48 KB
-ESM dist/executors-QIIKBUMJ.mjs     251.00 B
-ESM dist/chunk-35NFMGMS.mjs         696.00 B
-ESM dist/executor-RVBGAWUF.mjs      250.00 B
-ESM dist/chunk-WNCDOYZS.mjs         6.24 KB
-ESM dist/executor-XWHWUVQ3.mjs      238.00 B
-ESM dist/chunk-VSZ3DACI.mjs         5.76 KB
-ESM dist/executor-OWPVDUXH.mjs      242.00 B
-ESM dist/chunk-NQIDRU47.mjs         5.75 KB
-ESM dist/chunk-LXL47XMZ.mjs         934.00 B
+CJS dist/cli.js       80.46 KB
+CJS dist/index.js     54.18 KB
+CJS dist/cli.js.map   144.21 KB
+CJS dist/index.js.map 107.36 KB
+CJS ⚡️ Build success in 649ms
+ESM dist/cli.mjs                    11.33 KB
+ESM dist/index.mjs                  1005.00 B
+ESM dist/chunk-WZB7FBSX.mjs         10.98 KB
+ESM dist/executors-AQHOPGSR.mjs     251.00 B
+ESM dist/chunk-ZP3JNJQJ.mjs         724.00 B
+ESM dist/executor-OOLGGXHS.mjs      281.00 B
+ESM dist/chunk-BSNQOP2W.mjs         12.17 KB
+ESM dist/executor-LLE5VEFJ.mjs      269.00 B
+ESM dist/chunk-URJDRXJW.mjs         12.67 KB
+ESM dist/executor-LO7P3KUW.mjs      273.00 B
+ESM dist/chunk-54SKDK3D.mjs         7.81 KB
+ESM dist/chunk-YGUPSPZO.mjs         1.12 KB
+ESM dist/chunk-DRFFQJII.mjs         5.62 KB
 ESM dist/bridge-7ZUDKCZT.mjs        8.09 KB
 ESM dist/chunk-VZEH3EPJ.mjs         1.49 KB
 ESM dist/cli.mjs.map                20.54 KB
 ESM dist/index.mjs.map              71.00 B
-ESM dist/chunk-G7AGL2QA.mjs.map     19.20 KB
-ESM dist/executors-QIIKBUMJ.mjs.map 71.00 B
-ESM dist/chunk-35NFMGMS.mjs.map     2.26 KB
-ESM dist/executor-RVBGAWUF.mjs.map  71.00 B
-ESM dist/chunk-WNCDOYZS.mjs.map     13.07 KB
-ESM dist/executor-XWHWUVQ3.mjs.map  71.00 B
-ESM dist/chunk-VSZ3DACI.mjs.map     12.29 KB
-ESM dist/executor-OWPVDUXH.mjs.map  71.00 B
-ESM dist/chunk-NQIDRU47.mjs.map     12.18 KB
-ESM dist/chunk-LXL47XMZ.mjs.map     3.54 KB
+ESM dist/chunk-WZB7FBSX.mjs.map     20.01 KB
+ESM dist/executors-AQHOPGSR.mjs.map 71.00 B
+ESM dist/chunk-ZP3JNJQJ.mjs.map     2.46 KB
+ESM dist/executor-OOLGGXHS.mjs.map  71.00 B
+ESM dist/chunk-BSNQOP2W.mjs.map     23.76 KB
+ESM dist/executor-LLE5VEFJ.mjs.map  71.00 B
+ESM dist/chunk-URJDRXJW.mjs.map     25.03 KB
+ESM dist/executor-LO7P3KUW.mjs.map  71.00 B
+ESM dist/chunk-54SKDK3D.mjs.map     15.69 KB
+ESM dist/chunk-YGUPSPZO.mjs.map     4.16 KB
+ESM dist/chunk-DRFFQJII.mjs.map     11.36 KB
 ESM dist/bridge-7ZUDKCZT.mjs.map    16.70 KB
 ESM dist/chunk-VZEH3EPJ.mjs.map     3.18 KB
-ESM ⚡️ Build success in 221ms
-CJS dist/cli.js       56.81 KB
-CJS dist/index.js     32.87 KB
-CJS dist/cli.js.map   104.01 KB
-CJS dist/index.js.map 67.18 KB
-CJS ⚡️ Build success in 232ms
+ESM ⚡️ Build success in 664ms
 DTS Build start
-DTS ⚡️ Build success in 12086ms
+DTS ⚡️ Build success in 17931ms
 DTS dist/cli.d.ts    20.00 B
-DTS dist/index.d.ts  9.50 KB
+DTS dist/index.d.ts  12.14 KB
 DTS dist/cli.d.mts   20.00 B
-DTS dist/index.d.mts 9.50 KB
+DTS dist/index.d.mts 12.14 KB

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @axiom-lattice/cli-a2a
 
+## 0.1.6
+
+### Patch Changes
+
+- 3a124ab: **BREAKING**: Remove `LocalA2ATemplateStore` from store lattice, replacing it with static template config.
+
+  - Deleted `LocalA2ATemplateStoreProtocol` and all implementations (InMemory, PostgreSQL, SQLite)
+  - Removed `localA2ATemplate` entry from `StoreTypeMap` and store lattice default registrations
+  - Removed obsolete PostgreSQL Local A2A template migration source; existing database tables are not dropped
+  - Removed `LocalA2ATemplateEntry`, `CreateLocalA2ATemplateRequest`, `UpdateLocalA2ATemplateRequest` types
+  - `client.assistants.localA2A.templates` now only supports `.list()` (returns `LocalA2ATemplateDefinition[]`)
+  - Templates are now defined in `packages/gateway/src/config/local-a2a-templates.ts`
+  - Gateway resolves the managed CLI through the installed `@axiom-lattice/cli-a2a/cli-path` export and declares the CLI package as a runtime dependency
+  - Templates no longer contain port or agentCardUrl; those are user-supplied at creation time
+  - `CreateAssistantModal` appends the Agent Card URL port to template commands as `--port <port>` when the template does not already declare a port
+  - CLI session files are isolated by provider and server port when no explicit store path is configured
+
+- Updated dependencies [3a124ab]
+  - @axiom-lattice/protocols@3.0.0
+
 ## 0.1.5
 
 ### Patch Changes

package/README.md

@@ -164,10 +164,15 @@ import {
   resolveConfig,
   registerExecutor,
   createOpenCodeExecutor,
+  createCodexExecutor,
+  createClaudeExecutor,
+  SessionBindingStore,
 } from '@axiom-lattice/cli-a2a';
 
 // Register executors
 registerExecutor('opencode', createOpenCodeExecutor);
+registerExecutor('codex', createCodexExecutor);
+registerExecutor('claude', createClaudeExecutor);
 
 // Load config
 const config = resolveConfig('agent-config.json');
@@ -182,6 +187,76 @@ process.on('SIGINT', async () => {
 });
 ```
 
+## Multi-Turn Conversations
+
+The A2A protocol uses `contextId` to group messages into a single conversation.
+`cli-a2a` maps each `contextId` to an underlying CLI session, enabling multi-turn
+continuity across all three providers:
+
+| Provider | New Session | Resume Session | Session ID Source |
+|----------|-------------|----------------|-------------------|
+| Codex | `codex exec --json <prompt>` | `codex exec resume <thread_id> <prompt>` | `thread_id` from JSONL `thread.started` event |
+| Claude Code | `claude -p --session-id <uuid> <prompt>` | `claude -p --resume <uuid> <prompt>` | Generated UUID |
+| OpenCode | `opencode run --format json <prompt>` | `opencode run --session <sessionID> <prompt>` | `sessionID` from JSON events |
+
+**How it works:**
+1. The A2A client sends a message with a `contextId`
+2. `cli-a2a` looks up the `contextId` in the SessionBindingStore
+3. If found: uses the provider's resume command to continue the CLI session
+4. If not found: creates a new CLI session and saves the binding
+5. Subsequent messages with the same `contextId` reuse the same CLI session
+
+History is maintained by the underlying CLI tool — no prompt concatenation needed.
+
+### Session Persistence
+
+Bindings are persisted to disk so that `cli-a2a` restarts preserve conversations:
+
+- **Default path**: `~/Library/Application Support/axiom-lattice/cli-a2a/sessions.json`
+- **Format**: JSON array of `{ provider, contextId, sessionId, ... }`
+- **TTL**: 24 hours by default (configurable via `session.ttl`)
+- **Cleanup**: Expired bindings removed on load and periodically (every 1h)
+
+To disable persistence:
+```json
+{
+  "session": {
+    "persist": false
+  }
+}
+```
+
+To disable session reuse entirely (each request creates a new session):
+```json
+{
+  "session": {
+    "reuseByContext": false
+  }
+}
+```
+
+### Session Config
+
+```json
+{
+  "session": {
+    "reuseByContext": true,
+    "persist": true,
+    "storePath": "~/custom/path/sessions.json",
+    "ttl": 86400000,
+    "cleanupInterval": 3600000
+  }
+}
+```
+
+| Field | Default | Description |
+|-------|---------|-------------|
+| `reuseByContext` | `true` | Map `contextId` to CLI session for multi-turn |
+| `persist` | `true` | Save bindings to disk across restarts |
+| `storePath` | `~/Library/Application Support/axiom-lattice/cli-a2a/sessions.json` | Custom binding store path |
+| `ttl` | `86400000` (24h) | Session TTL in milliseconds |
+| `cleanupInterval` | `3600000` (1h) | Cleanup interval in milliseconds |
+
 ## Architecture
 
 ```
@@ -199,6 +274,11 @@ process.on('SIGINT', async () => {
 │  │  │ Executor   │ │ Executor│ │ Executor         │ ││
 │  │  └─────┬──────┘ └────┬────┘ └───────┬──────────┘ ││
 │  └────────┼─────────────┼──────────────┼────────────┘│
+│           │             │              │              │
+│  ┌────────▼─────────────▼──────────────▼────────────┐│
+│  │  SessionBindingStore                              ││
+│  │  contextId → CLI sessionId + file persistence     ││
+│  └──────────────────────────────────────────────────┘│
 └───────────┼─────────────┼──────────────┼─────────────┘
             │ HTTP        │ spawn        │ spawn
     ┌───────▼────────┐ ┌──▼───────┐ ┌───▼────────────┐
@@ -281,8 +361,11 @@ npx @axiom-lattice/cli-a2a --provider opencode -d /proj/backend  --port 3002 &
 | `resolveConfig(path?, overrides?)` | Merge config layers |
 | `loadConfigFile(path)` | Read and parse a JSON config file |
 | `registerExecutor(provider, factory)` | Register an executor factory |
-| `createOpenCodeExecutor(config)` | Create an OpenCode executor |
-| `OpenCodeExecutor` | Executor class (for extension) |
+| `createOpenCodeExecutor(config, store)` | Create an OpenCode executor |
+| `createCodexExecutor(config, store)` | Create a Codex executor |
+| `createClaudeExecutor(config, store)` | Create a Claude executor |
+| `SessionBindingStore` | `contextId → sessionId` persistence |
+| `generateContextId()` | Generate a new UUID contextId |
 | `logger`, `LogLevel` | Structured logger |
 
 ## License