@axiom-lattice/cli-a2a 0.1.5 → 0.1.7

package/dist/cli.mjs

@@ -2,8 +2,9 @@
 import {
   createA2AServer,
   resolveConfig
-} from "./chunk-G7AGL2QA.mjs";
-import "./chunk-35NFMGMS.mjs";
+} from "./chunk-WZB7FBSX.mjs";
+import "./chunk-ZP3JNJQJ.mjs";
+import "./chunk-DRFFQJII.mjs";
 import {
   logger
 } from "./chunk-VZEH3EPJ.mjs";
@@ -229,10 +230,10 @@ async function main() {
     agent: config.agentCard.name,
     port: config.server?.port
   });
-  const { registerExecutor } = await import("./executors-QIIKBUMJ.mjs");
-  const { createOpenCodeExecutor } = await import("./executor-RVBGAWUF.mjs");
-  const { createCodexExecutor } = await import("./executor-XWHWUVQ3.mjs");
-  const { createClaudeExecutor } = await import("./executor-OWPVDUXH.mjs");
+  const { registerExecutor } = await import("./executors-AQHOPGSR.mjs");
+  const { createOpenCodeExecutor } = await import("./executor-OOLGGXHS.mjs");
+  const { createCodexExecutor } = await import("./executor-LLE5VEFJ.mjs");
+  const { createClaudeExecutor } = await import("./executor-LO7P3KUW.mjs");
   registerExecutor("opencode", createOpenCodeExecutor);
   registerExecutor("codex", createCodexExecutor);
   registerExecutor("claude", createClaudeExecutor);

package/dist/cli.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * CLI A2A Gateway — Entry Point\n *\n * Usage:\n *   npx @axiom-lattice/cli-a2a --provider opencode --config agents/example.json\n *   npx @axiom-lattice/cli-a2a --provider opencode --port 3000 --opencode-url http://localhost:4096\n *\n * Run with --help for full usage.\n */\n\nimport { parseArgs } from 'node:util';\nimport { dirname, resolve } from 'node:path';\nimport { resolveConfig } from './config/loader.js';\nimport type { AgentConfig, ProviderType } from './config/types.js';\nimport { createA2AServer } from './server/index.js';\nimport { logger, LogLevel } from './logger.js';\n\nconst log = logger.child('cli');\n\n// ─── Version ────────────────────────────────────────────────────────────────\n\nconst PKG_VERSION = '0.1.0';\n\n// ─── Usage ──────────────────────────────────────────────────────────────────\n\nfunction printUsage(): void {\n  console.log(`\nUsage: cli-a2a [options]\n\nOptions:\n  --provider <name>            Provider: opencode | codex | claude\n  --config, -c <path>          Path to agent JSON config file\n  --port, -p <number>          A2A server port (default: 3000)\n  --hostname <addr>            Bind address (default: 0.0.0.0)\n  --advertise-host <host>      Hostname for agent card URLs\n  --agent-name <name>          Agent display name\n  --agent-description <desc>   Agent description\n  --log-level <level>          debug | info | warn | error (default: info)\n\nGateway Registration:\n  --register-url <url>         Gateway URL to register this agent with\n  --register-key <key>         API key for gateway authentication\n  --unregister-on-shutdown     Remove agent from gateway on exit\n\nBridge (NAT traversal):\n  --bridge-url <url>           Gateway WebSocket bridge (ws://gateway:8080/api/a2a/bridge)\n  --bridge-key <key>           API key for bridge authentication\n\nOpenCode Options:\n  --opencode-url <url>         OpenCode server URL (default: http://localhost:4096)\n  --directory, -d <path>       Project directory\n  --model, -m <provider/model> LLM model (e.g. anthropic/claude-sonnet-4)\n  --agent <name>               OpenCode agent preset\n\nCodex Options:\n  --codex-model <model>        Codex model ID\n  --codex-api-key <key>        OpenAI API key\n\nClaude Options:\n  --claude-model <model>       Claude Code model ID\n  --claude-api-key <key>       Anthropic API key\n\n  --help, -h                   Show this help\n  --version, -v                Show version\n\nExamples:\n  npx @axiom-lattice/cli-a2a --provider opencode\n  npx @axiom-lattice/cli-a2a --provider opencode --port 3001 --opencode-url http://localhost:4096\n  npx @axiom-lattice/cli-a2a --config ./my-agent.json\n  npx @axiom-lattice/cli-a2a --provider opencode --model anthropic/claude-sonnet-4\n  npx @axiom-lattice/cli-a2a --provider opencode --register-url http://gateway:8080 --register-key sk-xxx --unregister-on-shutdown\n  npx @axiom-lattice/cli-a2a --provider opencode --bridge-url ws://gateway:8080/api/a2a/bridge --bridge-key sk-xxx\n`);\n}\n\n// ─── CLI Args ───────────────────────────────────────────────────────────────\n\nfunction parseCliArgs(): {\n  configPath?: string;\n  overrides: Partial<AgentConfig>;\n  registerUrl?: string;\n  registerKey?: string;\n  unregisterOnShutdown: boolean;\n  bridgeUrl?: string;\n  bridgeKey?: string;\n} {\n  const { values } = parseArgs({\n    options: {\n      provider:           { type: 'string' },\n      config:             { type: 'string', short: 'c' },\n      port:               { type: 'string', short: 'p' },\n      hostname:           { type: 'string' },\n      'advertise-host':   { type: 'string' },\n      'agent-name':       { type: 'string' },\n      'agent-description':{ type: 'string' },\n      'opencode-url':     { type: 'string' },\n      directory:          { type: 'string', short: 'd' },\n      model:              { type: 'string', short: 'm' },\n      agent:              { type: 'string' },\n      'codex-model':      { type: 'string' },\n      'codex-api-key':    { type: 'string' },\n      'claude-model':     { type: 'string' },\n      'claude-api-key':   { type: 'string' },\n      'log-level':        { type: 'string' },\n      'register-url':     { type: 'string' },\n      'register-key':     { type: 'string' },\n      'unregister-on-shutdown': { type: 'boolean' },\n      'bridge-url':       { type: 'string' },\n      'bridge-key':       { type: 'string' },\n      help:               { type: 'boolean', short: 'h' },\n      version:            { type: 'boolean', short: 'v' },\n    },\n    strict: false,\n  });\n\n  if (values.help) {\n    printUsage();\n    process.exit(0);\n  }\n\n  if (values.version) {\n    console.log(PKG_VERSION);\n    process.exit(0);\n  }\n\n  const overrides: Partial<AgentConfig> = {};\n\n  // Provider\n  if (values.provider) {\n    overrides.provider = values.provider as ProviderType;\n  }\n\n  // Server\n  if (values.port || values.hostname || values['advertise-host']) {\n    overrides.server = {};\n    if (values.port) overrides.server.port = parseInt(values.port as string, 10);\n    if (values.hostname) overrides.server.hostname = values.hostname as string;\n    if (values['advertise-host']) overrides.server.advertiseHost = values['advertise-host'] as string;\n  }\n\n  // Agent card\n  const agentCardOverrides: Partial<AgentConfig['agentCard']> = {};\n  if (values['agent-name']) agentCardOverrides.name = values['agent-name'] as string;\n  if (values['agent-description']) agentCardOverrides.description = values['agent-description'] as string;\n  if (Object.keys(agentCardOverrides).length > 0) {\n    overrides.agentCard = agentCardOverrides as AgentConfig['agentCard'];\n  }\n\n  // OpenCode\n  const hasOpenCode = !!(values['opencode-url'] || values.directory || values.model || values.agent);\n  if (hasOpenCode) {\n    overrides.opencode = {};\n    if (values['opencode-url']) overrides.opencode.baseUrl = values['opencode-url'] as string;\n    if (values.directory) overrides.opencode.projectDirectory = values.directory as string;\n    if (values.model) overrides.opencode.model = values.model as string;\n    if (values.agent) overrides.opencode.agent = values.agent as string;\n  }\n\n  // Codex\n  const hasCodex = !!(values['codex-model'] || values['codex-api-key']);\n  if (hasCodex) {\n    overrides.codex = {};\n    if (values['codex-model']) overrides.codex.model = values['codex-model'] as string;\n    if (values['codex-api-key']) overrides.codex.apiKey = values['codex-api-key'] as string;\n  }\n\n  // Claude\n  const hasClaude = !!(values['claude-model'] || values['claude-api-key']);\n  if (hasClaude) {\n    overrides.claude = {};\n    if (values['claude-model']) overrides.claude.model = values['claude-model'] as string;\n    if (values['claude-api-key']) overrides.claude.apiKey = values['claude-api-key'] as string;\n  }\n\n  // Logging\n  if (values['log-level']) {\n    overrides.logging = { level: values['log-level'] as 'debug' | 'info' | 'warn' | 'error' };\n  }\n\n  const configPath = (values.config) as string | undefined;\n  const registerUrl = values['register-url'] as string | undefined;\n  const registerKey = values['register-key'] as string | undefined;\n  const unregisterOnShutdown = (values['unregister-on-shutdown'] as boolean) ?? false;\n  const bridgeUrl = values['bridge-url'] as string | undefined;\n  const bridgeKey = values['bridge-key'] as string | undefined;\n  return { configPath, overrides, registerUrl, registerKey, unregisterOnShutdown, bridgeUrl, bridgeKey };\n}\n\n// ─── Gateway Registration ───────────────────────────────────────────────────\n\nasync function registerWithGateway(\n  registerUrl: string,\n  registerKey: string,\n  config: Required<AgentConfig>,\n  agentCardUrl: string,\n): Promise<{ assistantId: string; agentCardUrl: string } | null> {\n  const body = {\n    name: config.agentCard.name,\n    description: config.agentCard.description,\n    graphDefinition: {\n      type: 'a2a_remote',\n      key: `a2a-${config.provider}-${config.agentCard.name.toLowerCase().replace(/[^a-z0-9]+/g, '-')}`,\n      name: config.agentCard.name,\n      description: config.agentCard.description,\n      prompt: config.agentCard.description,\n      agentCardUrl,\n      timeout: config.timeouts.prompt,\n    },\n  };\n\n  try {\n    const url = registerUrl.replace(/\\/$/, '') + '/api/assistants';\n    log.info('Registering with gateway', { url, agentCardUrl });\n\n    const resp = await fetch(url, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        'Authorization': `Bearer ${registerKey}`,\n      },\n      body: JSON.stringify(body),\n    });\n\n    if (!resp.ok) {\n      const text = await resp.text().catch(() => '');\n      log.error('Gateway registration failed', { status: resp.status, body: text });\n      return null;\n    }\n\n    const result = await resp.json() as { data?: { id: string } };\n    const assistantId = result.data?.id ?? body.graphDefinition.key;\n\n    log.info('Registered with gateway', { assistantId, agentCardUrl });\n    console.log(`Registered as agent: ${assistantId}`);\n    console.log(`Agent card:        ${agentCardUrl}`);\n\n    return { assistantId, agentCardUrl };\n  } catch (err) {\n    log.error('Gateway registration error', { error: (err as Error).message });\n    return null;\n  }\n}\n\nasync function unregisterFromGateway(\n  registerUrl: string,\n  registerKey: string,\n  assistantId: string,\n): Promise<void> {\n  try {\n    const url = `${registerUrl.replace(/\\/$/, '')}/api/assistants/${assistantId}`;\n    log.info('Unregistering from gateway', { assistantId });\n\n    const resp = await fetch(url, {\n      method: 'DELETE',\n      headers: {\n        'Authorization': `Bearer ${registerKey}`,\n      },\n    });\n\n    if (!resp.ok && resp.status !== 404) {\n      log.warn('Gateway unregistration failed', { status: resp.status });\n    } else {\n      log.info('Unregistered from gateway', { assistantId });\n    }\n  } catch (err) {\n    log.warn('Gateway unregistration error', { error: (err as Error).message });\n  }\n}\n\n// ─── Main ───────────────────────────────────────────────────────────────────\n\nasync function main(): Promise<void> {\n  const { configPath, overrides, registerUrl, registerKey, unregisterOnShutdown, bridgeUrl, bridgeKey } = parseCliArgs();\n\n  // Resolve config\n  const config = resolveConfig(configPath, overrides);\n\n  // Set configDir for relative path resolution\n  if (configPath) {\n    config.configDir = dirname(resolve(configPath));\n  }\n\n  // Apply log level\n  const levelStr = config.logging.level ?? 'info';\n  const levelMap: Record<string, LogLevel> = {\n    debug: LogLevel.DEBUG,\n    info: LogLevel.INFO,\n    warn: LogLevel.WARN,\n    error: LogLevel.ERROR,\n  };\n  logger.setLevel(levelMap[levelStr] ?? LogLevel.INFO);\n\n  if (!configPath) {\n    log.info('No --config provided — running with defaults + CLI args.');\n  }\n\n  log.info('Starting CLI A2A Gateway', {\n    provider: config.provider,\n    config: configPath ?? '(defaults)',\n    agent: config.agentCard.name,\n    port: config.server?.port,\n  });\n\n  // Register executors\n  const { registerExecutor } = await import('./executors/index.js');\n  const { createOpenCodeExecutor } = await import('./executors/opencode/executor.js');\n  const { createCodexExecutor } = await import('./executors/codex/executor.js');\n  const { createClaudeExecutor } = await import('./executors/claude/executor.js');\n  registerExecutor('opencode', createOpenCodeExecutor);\n  registerExecutor('codex', createCodexExecutor);\n  registerExecutor('claude', createClaudeExecutor);\n\n  // Start server\n  const server = await createA2AServer(config);\n\n  const listenPort = config.server?.port ?? 3000;\n  const agentId = `a2a-${config.provider}-${listenPort}`;\n\n  // Connect bridge to gateway (NAT traversal)\n  let bridgeClient: { start(): Promise<void>; stop(): void } | null = null;\n  if (bridgeUrl && bridgeKey) {\n    const { BridgeClient } = await import('./bridge.js');\n    const agentCardUrl = `${config.server?.advertiseProtocol ?? 'http'}://${config.server?.advertiseHost ?? 'localhost'}:${listenPort}/.well-known/agent-card.json`;\n\n    bridgeClient = new BridgeClient({\n      bridgeUrl: bridgeUrl.replace(/^http/, 'ws'),\n      apiKey: bridgeKey,\n      agentId,\n      agentCard: {\n        name: config.agentCard.name,\n        description: config.agentCard.description,\n        url: agentCardUrl,\n      },\n      localBaseUrl: `http://localhost:${listenPort}`,\n    });\n\n    bridgeClient.start().then(() => {\n      log.info('Bridge connected — agent reachable via gateway proxy');\n      console.log(`Bridge: ws://gateway → localhost:${listenPort}`);\n    }).catch((err: Error) => {\n      log.error('Bridge connection failed', { error: err.message });\n    });\n  }\n\n  // Register with gateway (HTTP-based self-registration)\n  let registeredAssistantId: string | null = null;\n  if (registerUrl && registerKey) {\n    // When bridge is active, the agent card URL must point to the gateway proxy\n    // so the orchestrator reaches the agent through the WebSocket bridge, not directly.\n    const agentCardUrl = bridgeUrl\n      ? `${registerUrl.replace(/\\/$/, '')}/api/a2a/bridge/proxy/${agentId}/.well-known/agent-card.json`\n      : `${config.server?.advertiseProtocol ?? 'http'}://${config.server?.advertiseHost ?? 'localhost'}:${listenPort}/.well-known/agent-card.json`;\n\n    const reg = await registerWithGateway(\n      registerUrl,\n      registerKey,\n      config,\n      agentCardUrl,\n    );\n    if (reg) {\n      registeredAssistantId = reg.assistantId;\n    }\n  }\n\n  // Graceful shutdown\n  const shutdown = async (signal: string) => {\n    log.info(`${signal} received, shutting down...`);\n    bridgeClient?.stop();\n    if (registeredAssistantId && registerUrl && registerKey && unregisterOnShutdown) {\n      await unregisterFromGateway(registerUrl, registerKey, registeredAssistantId);\n    }\n    await server.shutdown();\n    process.exit(0);\n  };\n\n  process.on('SIGINT', () => shutdown('SIGINT'));\n  process.on('SIGTERM', () => shutdown('SIGTERM'));\n}\n\nmain().catch((err) => {\n  log.error('Fatal error', { error: (err as Error).message, stack: (err as Error).stack });\n  process.exit(1);\n});\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * CLI A2A Gateway — Entry Point\n *\n * Usage:\n *   npx @axiom-lattice/cli-a2a --provider opencode --config agents/example.json\n *   npx @axiom-lattice/cli-a2a --provider opencode --port 3000 --opencode-url http://localhost:4096\n *\n * Run with --help for full usage.\n */\n\nimport { parseArgs } from 'node:util';\nimport { dirname, resolve } from 'node:path';\nimport { resolveConfig } from './config/loader.js';\nimport type { AgentConfig, ProviderType } from './config/types.js';\nimport { createA2AServer } from './server/index.js';\nimport { logger, LogLevel } from './logger.js';\n\nconst log = logger.child('cli');\n\n// ─── Version ────────────────────────────────────────────────────────────────\n\nconst PKG_VERSION = '0.1.0';\n\n// ─── Usage ──────────────────────────────────────────────────────────────────\n\nfunction printUsage(): void {\n  console.log(`\nUsage: cli-a2a [options]\n\nOptions:\n  --provider <name>            Provider: opencode | codex | claude\n  --config, -c <path>          Path to agent JSON config file\n  --port, -p <number>          A2A server port (default: 3000)\n  --hostname <addr>            Bind address (default: 0.0.0.0)\n  --advertise-host <host>      Hostname for agent card URLs\n  --agent-name <name>          Agent display name\n  --agent-description <desc>   Agent description\n  --log-level <level>          debug | info | warn | error (default: info)\n\nGateway Registration:\n  --register-url <url>         Gateway URL to register this agent with\n  --register-key <key>         API key for gateway authentication\n  --unregister-on-shutdown     Remove agent from gateway on exit\n\nBridge (NAT traversal):\n  --bridge-url <url>           Gateway WebSocket bridge (ws://gateway:8080/api/a2a/bridge)\n  --bridge-key <key>           API key for bridge authentication\n\nOpenCode Options:\n  --opencode-url <url>         OpenCode server URL (default: http://localhost:4096)\n  --directory, -d <path>       Project directory\n  --model, -m <provider/model> LLM model (e.g. anthropic/claude-sonnet-4)\n  --agent <name>               OpenCode agent preset\n\nCodex Options:\n  --codex-model <model>        Codex model ID\n  --codex-api-key <key>        OpenAI API key\n\nClaude Options:\n  --claude-model <model>       Claude Code model ID\n  --claude-api-key <key>       Anthropic API key\n\n  --help, -h                   Show this help\n  --version, -v                Show version\n\nExamples:\n  npx @axiom-lattice/cli-a2a --provider opencode\n  npx @axiom-lattice/cli-a2a --provider opencode --port 3001 --opencode-url http://localhost:4096\n  npx @axiom-lattice/cli-a2a --config ./my-agent.json\n  npx @axiom-lattice/cli-a2a --provider opencode --model anthropic/claude-sonnet-4\n  npx @axiom-lattice/cli-a2a --provider opencode --register-url http://gateway:8080 --register-key sk-xxx --unregister-on-shutdown\n  npx @axiom-lattice/cli-a2a --provider opencode --bridge-url ws://gateway:8080/api/a2a/bridge --bridge-key sk-xxx\n`);\n}\n\n// ─── CLI Args ───────────────────────────────────────────────────────────────\n\nfunction parseCliArgs(): {\n  configPath?: string;\n  overrides: Partial<AgentConfig>;\n  registerUrl?: string;\n  registerKey?: string;\n  unregisterOnShutdown: boolean;\n  bridgeUrl?: string;\n  bridgeKey?: string;\n} {\n  const { values } = parseArgs({\n    options: {\n      provider:           { type: 'string' },\n      config:             { type: 'string', short: 'c' },\n      port:               { type: 'string', short: 'p' },\n      hostname:           { type: 'string' },\n      'advertise-host':   { type: 'string' },\n      'agent-name':       { type: 'string' },\n      'agent-description':{ type: 'string' },\n      'opencode-url':     { type: 'string' },\n      directory:          { type: 'string', short: 'd' },\n      model:              { type: 'string', short: 'm' },\n      agent:              { type: 'string' },\n      'codex-model':      { type: 'string' },\n      'codex-api-key':    { type: 'string' },\n      'claude-model':     { type: 'string' },\n      'claude-api-key':   { type: 'string' },\n      'log-level':        { type: 'string' },\n      'register-url':     { type: 'string' },\n      'register-key':     { type: 'string' },\n      'unregister-on-shutdown': { type: 'boolean' },\n      'bridge-url':       { type: 'string' },\n      'bridge-key':       { type: 'string' },\n      help:               { type: 'boolean', short: 'h' },\n      version:            { type: 'boolean', short: 'v' },\n    },\n    strict: false,\n  });\n\n  if (values.help) {\n    printUsage();\n    process.exit(0);\n  }\n\n  if (values.version) {\n    console.log(PKG_VERSION);\n    process.exit(0);\n  }\n\n  const overrides: Partial<AgentConfig> = {};\n\n  // Provider\n  if (values.provider) {\n    overrides.provider = values.provider as ProviderType;\n  }\n\n  // Server\n  if (values.port || values.hostname || values['advertise-host']) {\n    overrides.server = {};\n    if (values.port) overrides.server.port = parseInt(values.port as string, 10);\n    if (values.hostname) overrides.server.hostname = values.hostname as string;\n    if (values['advertise-host']) overrides.server.advertiseHost = values['advertise-host'] as string;\n  }\n\n  // Agent card\n  const agentCardOverrides: Partial<AgentConfig['agentCard']> = {};\n  if (values['agent-name']) agentCardOverrides.name = values['agent-name'] as string;\n  if (values['agent-description']) agentCardOverrides.description = values['agent-description'] as string;\n  if (Object.keys(agentCardOverrides).length > 0) {\n    overrides.agentCard = agentCardOverrides as AgentConfig['agentCard'];\n  }\n\n  // OpenCode\n  const hasOpenCode = !!(values['opencode-url'] || values.directory || values.model || values.agent);\n  if (hasOpenCode) {\n    overrides.opencode = {};\n    if (values['opencode-url']) overrides.opencode.baseUrl = values['opencode-url'] as string;\n    if (values.directory) overrides.opencode.projectDirectory = values.directory as string;\n    if (values.model) overrides.opencode.model = values.model as string;\n    if (values.agent) overrides.opencode.agent = values.agent as string;\n  }\n\n  // Codex\n  const hasCodex = !!(values['codex-model'] || values['codex-api-key']);\n  if (hasCodex) {\n    overrides.codex = {};\n    if (values['codex-model']) overrides.codex.model = values['codex-model'] as string;\n    if (values['codex-api-key']) overrides.codex.apiKey = values['codex-api-key'] as string;\n  }\n\n  // Claude\n  const hasClaude = !!(values['claude-model'] || values['claude-api-key']);\n  if (hasClaude) {\n    overrides.claude = {};\n    if (values['claude-model']) overrides.claude.model = values['claude-model'] as string;\n    if (values['claude-api-key']) overrides.claude.apiKey = values['claude-api-key'] as string;\n  }\n\n  // Logging\n  if (values['log-level']) {\n    overrides.logging = { level: values['log-level'] as 'debug' | 'info' | 'warn' | 'error' };\n  }\n\n  const configPath = (values.config) as string | undefined;\n  const registerUrl = values['register-url'] as string | undefined;\n  const registerKey = values['register-key'] as string | undefined;\n  const unregisterOnShutdown = (values['unregister-on-shutdown'] as boolean) ?? false;\n  const bridgeUrl = values['bridge-url'] as string | undefined;\n  const bridgeKey = values['bridge-key'] as string | undefined;\n  return { configPath, overrides, registerUrl, registerKey, unregisterOnShutdown, bridgeUrl, bridgeKey };\n}\n\n// ─── Gateway Registration ───────────────────────────────────────────────────\n\nasync function registerWithGateway(\n  registerUrl: string,\n  registerKey: string,\n  config: Required<AgentConfig>,\n  agentCardUrl: string,\n): Promise<{ assistantId: string; agentCardUrl: string } | null> {\n  const body = {\n    name: config.agentCard.name,\n    description: config.agentCard.description,\n    graphDefinition: {\n      type: 'a2a_remote',\n      key: `a2a-${config.provider}-${config.agentCard.name.toLowerCase().replace(/[^a-z0-9]+/g, '-')}`,\n      name: config.agentCard.name,\n      description: config.agentCard.description,\n      prompt: config.agentCard.description,\n      agentCardUrl,\n      timeout: config.timeouts.prompt,\n    },\n  };\n\n  try {\n    const url = registerUrl.replace(/\\/$/, '') + '/api/assistants';\n    log.info('Registering with gateway', { url, agentCardUrl });\n\n    const resp = await fetch(url, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        'Authorization': `Bearer ${registerKey}`,\n      },\n      body: JSON.stringify(body),\n    });\n\n    if (!resp.ok) {\n      const text = await resp.text().catch(() => '');\n      log.error('Gateway registration failed', { status: resp.status, body: text });\n      return null;\n    }\n\n    const result = await resp.json() as { data?: { id: string } };\n    const assistantId = result.data?.id ?? body.graphDefinition.key;\n\n    log.info('Registered with gateway', { assistantId, agentCardUrl });\n    console.log(`Registered as agent: ${assistantId}`);\n    console.log(`Agent card:        ${agentCardUrl}`);\n\n    return { assistantId, agentCardUrl };\n  } catch (err) {\n    log.error('Gateway registration error', { error: (err as Error).message });\n    return null;\n  }\n}\n\nasync function unregisterFromGateway(\n  registerUrl: string,\n  registerKey: string,\n  assistantId: string,\n): Promise<void> {\n  try {\n    const url = `${registerUrl.replace(/\\/$/, '')}/api/assistants/${assistantId}`;\n    log.info('Unregistering from gateway', { assistantId });\n\n    const resp = await fetch(url, {\n      method: 'DELETE',\n      headers: {\n        'Authorization': `Bearer ${registerKey}`,\n      },\n    });\n\n    if (!resp.ok && resp.status !== 404) {\n      log.warn('Gateway unregistration failed', { status: resp.status });\n    } else {\n      log.info('Unregistered from gateway', { assistantId });\n    }\n  } catch (err) {\n    log.warn('Gateway unregistration error', { error: (err as Error).message });\n  }\n}\n\n// ─── Main ───────────────────────────────────────────────────────────────────\n\nasync function main(): Promise<void> {\n  const { configPath, overrides, registerUrl, registerKey, unregisterOnShutdown, bridgeUrl, bridgeKey } = parseCliArgs();\n\n  // Resolve config\n  const config = resolveConfig(configPath, overrides);\n\n  // Set configDir for relative path resolution\n  if (configPath) {\n    config.configDir = dirname(resolve(configPath));\n  }\n\n  // Apply log level\n  const levelStr = config.logging.level ?? 'info';\n  const levelMap: Record<string, LogLevel> = {\n    debug: LogLevel.DEBUG,\n    info: LogLevel.INFO,\n    warn: LogLevel.WARN,\n    error: LogLevel.ERROR,\n  };\n  logger.setLevel(levelMap[levelStr] ?? LogLevel.INFO);\n\n  if (!configPath) {\n    log.info('No --config provided — running with defaults + CLI args.');\n  }\n\n  log.info('Starting CLI A2A Gateway', {\n    provider: config.provider,\n    config: configPath ?? '(defaults)',\n    agent: config.agentCard.name,\n    port: config.server?.port,\n  });\n\n  // Register executors\n  const { registerExecutor } = await import('./executors/index.js');\n  const { createOpenCodeExecutor } = await import('./executors/opencode/executor.js');\n  const { createCodexExecutor } = await import('./executors/codex/executor.js');\n  const { createClaudeExecutor } = await import('./executors/claude/executor.js');\n  registerExecutor('opencode', createOpenCodeExecutor);\n  registerExecutor('codex', createCodexExecutor);\n  registerExecutor('claude', createClaudeExecutor);\n\n  // Start server\n  const server = await createA2AServer(config);\n\n  const listenPort = config.server?.port ?? 3000;\n  const agentId = `a2a-${config.provider}-${listenPort}`;\n\n  // Connect bridge to gateway (NAT traversal)\n  let bridgeClient: { start(): Promise<void>; stop(): void } | null = null;\n  if (bridgeUrl && bridgeKey) {\n    const { BridgeClient } = await import('./bridge.js');\n    const agentCardUrl = `${config.server?.advertiseProtocol ?? 'http'}://${config.server?.advertiseHost ?? 'localhost'}:${listenPort}/.well-known/agent-card.json`;\n\n    bridgeClient = new BridgeClient({\n      bridgeUrl: bridgeUrl.replace(/^http/, 'ws'),\n      apiKey: bridgeKey,\n      agentId,\n      agentCard: {\n        name: config.agentCard.name,\n        description: config.agentCard.description,\n        url: agentCardUrl,\n      },\n      localBaseUrl: `http://localhost:${listenPort}`,\n    });\n\n    bridgeClient.start().then(() => {\n      log.info('Bridge connected — agent reachable via gateway proxy');\n      console.log(`Bridge: ws://gateway → localhost:${listenPort}`);\n    }).catch((err: Error) => {\n      log.error('Bridge connection failed', { error: err.message });\n    });\n  }\n\n  // Register with gateway (HTTP-based self-registration)\n  let registeredAssistantId: string | null = null;\n  if (registerUrl && registerKey) {\n    // When bridge is active, the agent card URL must point to the gateway proxy\n    // so the orchestrator reaches the agent through the WebSocket bridge, not directly.\n    const agentCardUrl = bridgeUrl\n      ? `${registerUrl.replace(/\\/$/, '')}/api/a2a/bridge/proxy/${agentId}/.well-known/agent-card.json`\n      : `${config.server?.advertiseProtocol ?? 'http'}://${config.server?.advertiseHost ?? 'localhost'}:${listenPort}/.well-known/agent-card.json`;\n\n    const reg = await registerWithGateway(\n      registerUrl,\n      registerKey,\n      config,\n      agentCardUrl,\n    );\n    if (reg) {\n      registeredAssistantId = reg.assistantId;\n    }\n  }\n\n  // Graceful shutdown\n  const shutdown = async (signal: string) => {\n    log.info(`${signal} received, shutting down...`);\n    bridgeClient?.stop();\n    if (registeredAssistantId && registerUrl && registerKey && unregisterOnShutdown) {\n      await unregisterFromGateway(registerUrl, registerKey, registeredAssistantId);\n    }\n    await server.shutdown();\n    process.exit(0);\n  };\n\n  process.on('SIGINT', () => shutdown('SIGINT'));\n  process.on('SIGTERM', () => shutdown('SIGTERM'));\n}\n\nmain().catch((err) => {\n  log.error('Fatal error', { error: (err as Error).message, stack: (err as Error).stack });\n  process.exit(1);\n});\n"],"mappings":"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","names":[]}

package/dist/executor-LLE5VEFJ.mjs

@@ -0,0 +1,12 @@
+import {
+  CodexExecutor,
+  createCodexExecutor
+} from "./chunk-URJDRXJW.mjs";
+import "./chunk-YGUPSPZO.mjs";
+import "./chunk-DRFFQJII.mjs";
+import "./chunk-VZEH3EPJ.mjs";
+export {
+  CodexExecutor,
+  createCodexExecutor
+};
+//# sourceMappingURL=executor-LLE5VEFJ.mjs.map

package/dist/executor-LO7P3KUW.mjs

@@ -0,0 +1,12 @@
+import {
+  ClaudeExecutor,
+  createClaudeExecutor
+} from "./chunk-54SKDK3D.mjs";
+import "./chunk-YGUPSPZO.mjs";
+import "./chunk-DRFFQJII.mjs";
+import "./chunk-VZEH3EPJ.mjs";
+export {
+  ClaudeExecutor,
+  createClaudeExecutor
+};
+//# sourceMappingURL=executor-LO7P3KUW.mjs.map

package/dist/{executor-RVBGAWUF.mjs → executor-OOLGGXHS.mjs}

@@ -1,11 +1,12 @@
 import {
   OpenCodeExecutor,
   createOpenCodeExecutor
-} from "./chunk-WNCDOYZS.mjs";
-import "./chunk-LXL47XMZ.mjs";
+} from "./chunk-BSNQOP2W.mjs";
+import "./chunk-YGUPSPZO.mjs";
+import "./chunk-DRFFQJII.mjs";
 import "./chunk-VZEH3EPJ.mjs";
 export {
   OpenCodeExecutor,
   createOpenCodeExecutor
 };
-//# sourceMappingURL=executor-RVBGAWUF.mjs.map
+//# sourceMappingURL=executor-OOLGGXHS.mjs.map

package/dist/{executors-QIIKBUMJ.mjs → executors-AQHOPGSR.mjs}

@@ -4,7 +4,7 @@ import {
   getExecutor,
   registerExecutor,
   v4
-} from "./chunk-35NFMGMS.mjs";
+} from "./chunk-ZP3JNJQJ.mjs";
 export {
   TaskState,
   createExecutor,
@@ -12,4 +12,4 @@ export {
   registerExecutor,
   v4 as uuidv4
 };
-//# sourceMappingURL=executors-QIIKBUMJ.mjs.map
+//# sourceMappingURL=executors-AQHOPGSR.mjs.map

package/dist/index.d.mts

@@ -54,11 +54,16 @@ interface ServerConfig {
 interface SessionConfig {
     /** Session title prefix */
     titlePrefix?: string;
-    /** Reuse sessions by A2A contextId */
+    /** Reuse sessions by A2A contextId (default: true) */
     reuseByContext?: boolean;
-    /** Session TTL in ms */
+    /** Persist session bindings to disk (default: true) */
+    persist?: boolean;
+    /** Path to session binding store file.
+     *  Default: ~/Library/Application Support/axiom-lattice/cli-a2a/sessions-<provider>-<port>.json */
+    storePath?: string;
+    /** Session TTL in ms. Bindings older than this are cleaned up. (default: 24h) */
     ttl?: number;
-    /** Cleanup interval in ms */
+    /** Cleanup interval in ms (default: 1h) */
     cleanupInterval?: number;
 }
 interface FeatureFlags {
@@ -176,6 +181,70 @@ interface ServerHandle {
 }
 declare function createA2AServer(config: Required<AgentConfig>): Promise<ServerHandle>;
 
+/**
+ * SessionBindingStore
+ *
+ * Persists A2A contextId → CLI sessionId mappings so that multi-turn
+ * conversations survive process restarts. Supports atomic file writes,
+ * in-memory caching, TTL-based cleanup, and corrupted-file recovery.
+ */
+
+interface SessionBinding {
+    provider: ProviderType;
+    contextId: string;
+    sessionId: string;
+    activeTaskId?: string;
+    activeTaskState?: string;
+    createdAt: string;
+    updatedAt: string;
+    expiresAt?: string;
+}
+declare function resolveSessionStorePath(options: {
+    configuredPath?: string;
+    provider: ProviderType;
+    port: number;
+    storeDir?: string;
+}): string;
+declare class SessionBindingStore {
+    private cache;
+    private storePath;
+    private persist;
+    private cleanupTimer;
+    private dirty;
+    private flushTimeout;
+    constructor(opts?: {
+        storePath?: string;
+        persist?: boolean;
+        cleanupIntervalMs?: number;
+    });
+    get(contextId: string, provider: ProviderType): SessionBinding | null;
+    set(binding: SessionBinding): void;
+    delete(contextId: string, provider: ProviderType): boolean;
+    clearActiveTask(contextId: string, provider: ProviderType): void;
+    /**
+     * Remove all expired entries.
+     * Called automatically on the cleanup interval; call manually before shutdown.
+     */
+    cleanup(): number;
+    /**
+     * Graceful shutdown: stop cleanup timer, flush pending writes.
+     */
+    shutdown(): void;
+    /** For testing: return the number of cached bindings. */
+    get size(): number;
+    private makeKey;
+    private isExpired;
+    private startCleanup;
+    private markDirty;
+    private flushToFile;
+    private writeAtomically;
+    private loadFromFile;
+}
+/**
+ * Generate a new contextId for use when the A2A client doesn't provide one.
+ */
+declare function generateContextId(): string;
+
 /**
  * Executor types and common interfaces for CLI A2A providers.
  *
@@ -197,74 +266,76 @@ interface A2AExecutor extends AgentExecutor {
 }
 
 /**
- * Factory function type: given resolved config, produce an executor.
+ * Factory function type: given resolved config and a session store,
+ * produce an executor.
  */
-type ExecutorFactory = (config: Required<AgentConfig>) => A2AExecutor;
+type ExecutorFactory = (config: Required<AgentConfig>, sessionStore: SessionBindingStore) => A2AExecutor;
 declare function registerExecutor(provider: ProviderType, factory: ExecutorFactory): void;
 declare function getExecutor(provider: ProviderType): ExecutorFactory | undefined;
-declare function createExecutor(config: Required<AgentConfig>): A2AExecutor;
+declare function createExecutor(config: Required<AgentConfig>, sessionStore: SessionBindingStore): A2AExecutor;
 
 /**
  * OpenCode A2A Executor
  *
  * Bridges the local OpenCode CLI to the A2A protocol. Spawns `opencode run`
- * as a child process for each request and captures stdout as the response.
- * Same spawn pattern as Codex and Claude Code executors.
+ * as a child process for each request. Supports multi-turn conversation
+ * via contextId → sessionId binding through SessionBindingStore.
  */
 
 declare class OpenCodeExecutor implements A2AExecutor {
     private config;
     private client;
     private initialized;
-    constructor(config: Required<AgentConfig>);
+    private sessionStore;
+    constructor(config: Required<AgentConfig>, sessionStore: SessionBindingStore);
     initialize(): Promise<void>;
     shutdown(): Promise<void>;
     execute(ctx: RequestContext, bus: ExecutionEventBus): Promise<void>;
     cancelTask(taskId: string, bus: ExecutionEventBus): Promise<void>;
-    private extractText;
 }
-declare function createOpenCodeExecutor(config: Required<AgentConfig>): A2AExecutor;
+declare function createOpenCodeExecutor(config: Required<AgentConfig>, sessionStore: SessionBindingStore): A2AExecutor;
 
 /**
  * Codex A2A Executor
  *
  * Bridges the local Codex CLI to the A2A protocol. Spawns Codex as a
- * child process for each request and captures stdout as the response.
+ * child process for each request. Supports multi-turn conversation via
+ * contextId → sessionId binding through SessionBindingStore.
  */
 
 declare class CodexExecutor implements A2AExecutor {
     private config;
     private client;
     private initialized;
-    constructor(config: Required<AgentConfig>);
+    private sessionStore;
+    constructor(config: Required<AgentConfig>, sessionStore: SessionBindingStore);
     initialize(): Promise<void>;
     shutdown(): Promise<void>;
     execute(ctx: RequestContext, bus: ExecutionEventBus): Promise<void>;
     cancelTask(taskId: string, bus: ExecutionEventBus): Promise<void>;
-    private extractText;
 }
-declare function createCodexExecutor(config: Required<AgentConfig>): A2AExecutor;
+declare function createCodexExecutor(config: Required<AgentConfig>, sessionStore: SessionBindingStore): A2AExecutor;
 
 /**
  * Claude Code A2A Executor
  *
  * Bridges the local Claude Code CLI to the A2A protocol. Spawns Claude Code
- * in non-interactive print mode (`-p`) for each request and captures stdout
- * as the response.
+ * in non-interactive print mode (`-p`) for each request. Supports multi-turn
+ * conversation via contextId → sessionId binding through SessionBindingStore.
  */
 
 declare class ClaudeExecutor implements A2AExecutor {
     private config;
     private client;
     private initialized;
-    constructor(config: Required<AgentConfig>);
+    private sessionStore;
+    constructor(config: Required<AgentConfig>, sessionStore: SessionBindingStore);
     initialize(): Promise<void>;
     shutdown(): Promise<void>;
     execute(ctx: RequestContext, bus: ExecutionEventBus): Promise<void>;
     cancelTask(taskId: string, bus: ExecutionEventBus): Promise<void>;
-    private extractText;
 }
-declare function createClaudeExecutor(config: Required<AgentConfig>): A2AExecutor;
+declare function createClaudeExecutor(config: Required<AgentConfig>, sessionStore: SessionBindingStore): A2AExecutor;
 
 /**
  * Lightweight structured logger for the CLI A2A gateway.
@@ -292,4 +363,4 @@ declare class Logger {
 }
 declare const logger: Logger;
 
-export { type A2AExecutor, type AgentCardConfig, type AgentConfig, type ClaudeCodeConfig, ClaudeExecutor, type CodexConfig, CodexExecutor, type ExecutorFactory, type FeatureFlags, LogLevel, type LoggingConfig, type OpenCodeConfig, OpenCodeExecutor, type ProviderType, type ServerConfig, type ServerHandle, type SessionConfig, type SkillConfig, type TimeoutConfig, createA2AServer, createClaudeExecutor, createCodexExecutor, createExecutor, createOpenCodeExecutor, getExecutor, loadConfigFile, logger, registerExecutor, resolveConfig };
+export { type A2AExecutor, type AgentCardConfig, type AgentConfig, type ClaudeCodeConfig, ClaudeExecutor, type CodexConfig, CodexExecutor, type ExecutorFactory, type FeatureFlags, LogLevel, type LoggingConfig, type OpenCodeConfig, OpenCodeExecutor, type ProviderType, type ServerConfig, type ServerHandle, type SessionBinding, SessionBindingStore, type SessionConfig, type SkillConfig, type TimeoutConfig, createA2AServer, createClaudeExecutor, createCodexExecutor, createExecutor, createOpenCodeExecutor, generateContextId, getExecutor, loadConfigFile, logger, registerExecutor, resolveConfig, resolveSessionStorePath };

package/dist/index.d.ts

@@ -54,11 +54,16 @@ interface ServerConfig {
 interface SessionConfig {
     /** Session title prefix */
     titlePrefix?: string;
-    /** Reuse sessions by A2A contextId */
+    /** Reuse sessions by A2A contextId (default: true) */
     reuseByContext?: boolean;
-    /** Session TTL in ms */
+    /** Persist session bindings to disk (default: true) */
+    persist?: boolean;
+    /** Path to session binding store file.
+     *  Default: ~/Library/Application Support/axiom-lattice/cli-a2a/sessions-<provider>-<port>.json */
+    storePath?: string;
+    /** Session TTL in ms. Bindings older than this are cleaned up. (default: 24h) */
     ttl?: number;
-    /** Cleanup interval in ms */
+    /** Cleanup interval in ms (default: 1h) */
     cleanupInterval?: number;
 }
 interface FeatureFlags {
@@ -176,6 +181,70 @@ interface ServerHandle {
 }
 declare function createA2AServer(config: Required<AgentConfig>): Promise<ServerHandle>;
 
+/**
+ * SessionBindingStore
+ *
+ * Persists A2A contextId → CLI sessionId mappings so that multi-turn
+ * conversations survive process restarts. Supports atomic file writes,
+ * in-memory caching, TTL-based cleanup, and corrupted-file recovery.
+ */
+
+interface SessionBinding {
+    provider: ProviderType;
+    contextId: string;
+    sessionId: string;
+    activeTaskId?: string;
+    activeTaskState?: string;
+    createdAt: string;
+    updatedAt: string;
+    expiresAt?: string;
+}
+declare function resolveSessionStorePath(options: {
+    configuredPath?: string;
+    provider: ProviderType;
+    port: number;
+    storeDir?: string;
+}): string;
+declare class SessionBindingStore {
+    private cache;
+    private storePath;
+    private persist;
+    private cleanupTimer;
+    private dirty;
+    private flushTimeout;
+    constructor(opts?: {
+        storePath?: string;
+        persist?: boolean;
+        cleanupIntervalMs?: number;
+    });
+    get(contextId: string, provider: ProviderType): SessionBinding | null;
+    set(binding: SessionBinding): void;
+    delete(contextId: string, provider: ProviderType): boolean;
+    clearActiveTask(contextId: string, provider: ProviderType): void;
+    /**
+     * Remove all expired entries.
+     * Called automatically on the cleanup interval; call manually before shutdown.
+     */
+    cleanup(): number;
+    /**
+     * Graceful shutdown: stop cleanup timer, flush pending writes.
+     */
+    shutdown(): void;
+    /** For testing: return the number of cached bindings. */
+    get size(): number;
+    private makeKey;
+    private isExpired;
+    private startCleanup;
+    private markDirty;
+    private flushToFile;
+    private writeAtomically;
+    private loadFromFile;
+}
+/**
+ * Generate a new contextId for use when the A2A client doesn't provide one.
+ */
+declare function generateContextId(): string;
+
 /**
  * Executor types and common interfaces for CLI A2A providers.
  *
@@ -197,74 +266,76 @@ interface A2AExecutor extends AgentExecutor {
 }
 
 /**
- * Factory function type: given resolved config, produce an executor.
+ * Factory function type: given resolved config and a session store,
+ * produce an executor.
  */
-type ExecutorFactory = (config: Required<AgentConfig>) => A2AExecutor;
+type ExecutorFactory = (config: Required<AgentConfig>, sessionStore: SessionBindingStore) => A2AExecutor;
 declare function registerExecutor(provider: ProviderType, factory: ExecutorFactory): void;
 declare function getExecutor(provider: ProviderType): ExecutorFactory | undefined;
-declare function createExecutor(config: Required<AgentConfig>): A2AExecutor;
+declare function createExecutor(config: Required<AgentConfig>, sessionStore: SessionBindingStore): A2AExecutor;
 
 /**
  * OpenCode A2A Executor
  *
  * Bridges the local OpenCode CLI to the A2A protocol. Spawns `opencode run`
- * as a child process for each request and captures stdout as the response.
- * Same spawn pattern as Codex and Claude Code executors.
+ * as a child process for each request. Supports multi-turn conversation
+ * via contextId → sessionId binding through SessionBindingStore.
  */
 
 declare class OpenCodeExecutor implements A2AExecutor {
     private config;
     private client;
     private initialized;
-    constructor(config: Required<AgentConfig>);
+    private sessionStore;
+    constructor(config: Required<AgentConfig>, sessionStore: SessionBindingStore);
     initialize(): Promise<void>;
     shutdown(): Promise<void>;
     execute(ctx: RequestContext, bus: ExecutionEventBus): Promise<void>;
     cancelTask(taskId: string, bus: ExecutionEventBus): Promise<void>;
-    private extractText;
 }
-declare function createOpenCodeExecutor(config: Required<AgentConfig>): A2AExecutor;
+declare function createOpenCodeExecutor(config: Required<AgentConfig>, sessionStore: SessionBindingStore): A2AExecutor;
 
 /**
  * Codex A2A Executor
  *
  * Bridges the local Codex CLI to the A2A protocol. Spawns Codex as a
- * child process for each request and captures stdout as the response.
+ * child process for each request. Supports multi-turn conversation via
+ * contextId → sessionId binding through SessionBindingStore.
  */
 
 declare class CodexExecutor implements A2AExecutor {
     private config;
     private client;
     private initialized;
-    constructor(config: Required<AgentConfig>);
+    private sessionStore;
+    constructor(config: Required<AgentConfig>, sessionStore: SessionBindingStore);
     initialize(): Promise<void>;
     shutdown(): Promise<void>;
     execute(ctx: RequestContext, bus: ExecutionEventBus): Promise<void>;
     cancelTask(taskId: string, bus: ExecutionEventBus): Promise<void>;
-    private extractText;
 }
-declare function createCodexExecutor(config: Required<AgentConfig>): A2AExecutor;
+declare function createCodexExecutor(config: Required<AgentConfig>, sessionStore: SessionBindingStore): A2AExecutor;
 
 /**
  * Claude Code A2A Executor
  *
  * Bridges the local Claude Code CLI to the A2A protocol. Spawns Claude Code
- * in non-interactive print mode (`-p`) for each request and captures stdout
- * as the response.
+ * in non-interactive print mode (`-p`) for each request. Supports multi-turn
+ * conversation via contextId → sessionId binding through SessionBindingStore.
  */
 
 declare class ClaudeExecutor implements A2AExecutor {
     private config;
     private client;
     private initialized;
-    constructor(config: Required<AgentConfig>);
+    private sessionStore;
+    constructor(config: Required<AgentConfig>, sessionStore: SessionBindingStore);
     initialize(): Promise<void>;
     shutdown(): Promise<void>;
     execute(ctx: RequestContext, bus: ExecutionEventBus): Promise<void>;
     cancelTask(taskId: string, bus: ExecutionEventBus): Promise<void>;
-    private extractText;
 }
-declare function createClaudeExecutor(config: Required<AgentConfig>): A2AExecutor;
+declare function createClaudeExecutor(config: Required<AgentConfig>, sessionStore: SessionBindingStore): A2AExecutor;
 
 /**
  * Lightweight structured logger for the CLI A2A gateway.
@@ -292,4 +363,4 @@ declare class Logger {
 }
 declare const logger: Logger;
 
-export { type A2AExecutor, type AgentCardConfig, type AgentConfig, type ClaudeCodeConfig, ClaudeExecutor, type CodexConfig, CodexExecutor, type ExecutorFactory, type FeatureFlags, LogLevel, type LoggingConfig, type OpenCodeConfig, OpenCodeExecutor, type ProviderType, type ServerConfig, type ServerHandle, type SessionConfig, type SkillConfig, type TimeoutConfig, createA2AServer, createClaudeExecutor, createCodexExecutor, createExecutor, createOpenCodeExecutor, getExecutor, loadConfigFile, logger, registerExecutor, resolveConfig };
+export { type A2AExecutor, type AgentCardConfig, type AgentConfig, type ClaudeCodeConfig, ClaudeExecutor, type CodexConfig, CodexExecutor, type ExecutorFactory, type FeatureFlags, LogLevel, type LoggingConfig, type OpenCodeConfig, OpenCodeExecutor, type ProviderType, type ServerConfig, type ServerHandle, type SessionBinding, SessionBindingStore, type SessionConfig, type SkillConfig, type TimeoutConfig, createA2AServer, createClaudeExecutor, createCodexExecutor, createExecutor, createOpenCodeExecutor, generateContextId, getExecutor, loadConfigFile, logger, registerExecutor, resolveConfig, resolveSessionStorePath };