@axiom-lattice/cli-a2a 0.1.1

package/dist/executor-OWPVDUXH.mjs

@@ -0,0 +1,11 @@
+import {
+  ClaudeExecutor,
+  createClaudeExecutor
+} from "./chunk-NQIDRU47.mjs";
+import "./chunk-LXL47XMZ.mjs";
+import "./chunk-VZEH3EPJ.mjs";
+export {
+  ClaudeExecutor,
+  createClaudeExecutor
+};
+//# sourceMappingURL=executor-OWPVDUXH.mjs.map

package/dist/executor-OWPVDUXH.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/executor-RVBGAWUF.mjs

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

package/dist/executor-RVBGAWUF.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/executor-XWHWUVQ3.mjs

@@ -0,0 +1,11 @@
+import {
+  CodexExecutor,
+  createCodexExecutor
+} from "./chunk-VSZ3DACI.mjs";
+import "./chunk-LXL47XMZ.mjs";
+import "./chunk-VZEH3EPJ.mjs";
+export {
+  CodexExecutor,
+  createCodexExecutor
+};
+//# sourceMappingURL=executor-XWHWUVQ3.mjs.map

package/dist/executor-XWHWUVQ3.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/executors-QIIKBUMJ.mjs

@@ -0,0 +1,15 @@
+import {
+  TaskState,
+  createExecutor,
+  getExecutor,
+  registerExecutor,
+  v4
+} from "./chunk-35NFMGMS.mjs";
+export {
+  TaskState,
+  createExecutor,
+  getExecutor,
+  registerExecutor,
+  v4 as uuidv4
+};
+//# sourceMappingURL=executors-QIIKBUMJ.mjs.map

package/dist/executors-QIIKBUMJ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/index.d.mts

@@ -0,0 +1,295 @@
+import express from 'express';
+import { AgentExecutor, RequestContext, ExecutionEventBus } from '@a2a-js/sdk/server';
+export { AgentExecutor, ExecutionEventBus, RequestContext } from '@a2a-js/sdk/server';
+
+/**
+ * Unified configuration types for the CLI A2A gateway.
+ *
+ * Each provider (OpenCode, Codex, Claude Code) extends the base config
+ * with its own connection settings. A single config file can declare
+ * multiple providers, and the CLI selects one at startup via --provider.
+ */
+interface AgentCardConfig {
+    /** Human-readable agent name */
+    name: string;
+    /** Agent description shown to orchestrators / callers */
+    description: string;
+    /** Protocol version (default: "0.3.0") */
+    protocolVersion?: string;
+    /** Agent version string */
+    version?: string;
+    /** Skills advertised on the agent card */
+    skills?: SkillConfig[];
+    /** Supported input modes */
+    defaultInputModes?: string[];
+    /** Supported output modes */
+    defaultOutputModes?: string[];
+    /** Enable streaming */
+    streaming?: boolean;
+    /** Enable push notifications */
+    pushNotifications?: boolean;
+    /** Provider info */
+    provider?: {
+        organization: string;
+        url?: string;
+    };
+}
+interface SkillConfig {
+    id: string;
+    name: string;
+    description: string;
+    tags?: string[];
+    examples?: string[];
+}
+interface ServerConfig {
+    /** A2A server port */
+    port?: number;
+    /** Bind address */
+    hostname?: string;
+    /** Hostname advertised in agent card URLs */
+    advertiseHost?: string;
+    /** Protocol for advertised URLs */
+    advertiseProtocol?: 'http' | 'https';
+}
+interface SessionConfig {
+    /** Session title prefix */
+    titlePrefix?: string;
+    /** Reuse sessions by A2A contextId */
+    reuseByContext?: boolean;
+    /** Session TTL in ms */
+    ttl?: number;
+    /** Cleanup interval in ms */
+    cleanupInterval?: number;
+}
+interface FeatureFlags {
+    /** Auto-approve all permission requests */
+    autoApprovePermissions?: boolean;
+    /** Auto-answer question prompts */
+    autoAnswerQuestions?: boolean;
+    /** Stream artifact chunks individually vs buffer */
+    streamArtifactChunks?: boolean;
+    /** Enable polling fallback on SSE failure */
+    enablePollingFallback?: boolean;
+}
+interface TimeoutConfig {
+    /** Timeout for a single prompt in ms */
+    prompt?: number;
+    /** Polling interval in ms */
+    pollingInterval?: number;
+    /** Health check interval in ms */
+    healthCheck?: number;
+}
+interface LoggingConfig {
+    /** Log level */
+    level?: 'debug' | 'info' | 'warn' | 'error';
+}
+interface OpenCodeConfig {
+    /** OpenCode server base URL */
+    baseUrl?: string;
+    /** Target project directory */
+    projectDirectory?: string;
+    /** Model identifier (e.g. "anthropic/claude-sonnet-4-20250514") */
+    model?: string;
+    /** Agent preset name */
+    agent?: string;
+    /** System prompt */
+    systemPrompt?: string;
+    /** How system prompt is applied */
+    systemPromptMode?: 'append' | 'replace';
+    /** Context file name */
+    contextFile?: string;
+    /** Prompt for building context */
+    contextPrompt?: string;
+}
+interface CodexConfig {
+    /** Codex CLI path */
+    cliPath?: string;
+    /** Working directory */
+    workdir?: string;
+    /** Model identifier */
+    model?: string;
+    /** API key for OpenAI */
+    apiKey?: string;
+}
+interface ClaudeCodeConfig {
+    /** Claude Code CLI path */
+    cliPath?: string;
+    /** Working directory */
+    workdir?: string;
+    /** Model identifier */
+    model?: string;
+    /** API key for Anthropic */
+    apiKey?: string;
+}
+type ProviderType = 'opencode' | 'codex' | 'claude';
+interface AgentConfig {
+    /** Active provider to use */
+    provider: ProviderType;
+    /** Agent card identity */
+    agentCard: AgentCardConfig;
+    /** Server settings */
+    server?: ServerConfig;
+    /** Session management */
+    session?: SessionConfig;
+    /** Feature flags */
+    features?: FeatureFlags;
+    /** Timeout settings */
+    timeouts?: TimeoutConfig;
+    /** Logging settings */
+    logging?: LoggingConfig;
+    /** Provider-specific connection configs */
+    opencode?: OpenCodeConfig;
+    codex?: CodexConfig;
+    claude?: ClaudeCodeConfig;
+    /** Directory containing config file (populated at runtime) */
+    configDir?: string;
+}
+
+/**
+ * Config loader — reads JSON config files and resolves the final config
+ * by merging layers: defaults ← config file ← env overrides ← CLI args.
+ */
+
+/**
+ * Read and parse a JSON config file.
+ */
+declare function loadConfigFile(filePath: string): Partial<AgentConfig>;
+/**
+ * Resolve full config from defaults + file + env.
+ */
+declare function resolveConfig(configPath?: string, cliOverrides?: Partial<AgentConfig>): Required<AgentConfig>;
+
+/**
+ * A2A HTTP Server
+ *
+ * Creates an Express server with standard A2A endpoints:
+ *  - GET /.well-known/agent-card.json  → Agent Card
+ *  - POST /a2a/jsonrpc                 → JSON-RPC transport
+ *  - POST /a2a/rest                    → REST transport
+ *  - GET /health                       → Health check
+ */
+
+interface ServerHandle {
+    app: ReturnType<typeof express>;
+    server: ReturnType<ReturnType<typeof express>['listen']>;
+    shutdown(): Promise<void>;
+}
+declare function createA2AServer(config: Required<AgentConfig>): Promise<ServerHandle>;
+
+/**
+ * Executor types and common interfaces for CLI A2A providers.
+ *
+ * Each provider (OpenCode, Codex, Claude) implements its own executor
+ * conforming to the A2AExecutor interface which extends the SDK's
+ * AgentExecutor with lifecycle methods (initialize, shutdown).
+ */
+
+/**
+ * Extended executor interface with lifecycle methods.
+ *
+ * The base AgentExecutor from @a2a-js/sdk only defines execute() and
+ * cancelTask(). We add initialize() for server setup and shutdown()
+ * for graceful cleanup.
+ */
+interface A2AExecutor extends AgentExecutor {
+    initialize(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+
+/**
+ * Factory function type: given resolved config, produce an executor.
+ */
+type ExecutorFactory = (config: Required<AgentConfig>) => A2AExecutor;
+declare function registerExecutor(provider: ProviderType, factory: ExecutorFactory): void;
+declare function getExecutor(provider: ProviderType): ExecutorFactory | undefined;
+declare function createExecutor(config: Required<AgentConfig>): 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.
+ */
+
+declare class OpenCodeExecutor implements A2AExecutor {
+    private config;
+    private client;
+    private initialized;
+    constructor(config: Required<AgentConfig>);
+    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;
+
+/**
+ * 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.
+ */
+
+declare class CodexExecutor implements A2AExecutor {
+    private config;
+    private client;
+    private initialized;
+    constructor(config: Required<AgentConfig>);
+    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;
+
+/**
+ * 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.
+ */
+
+declare class ClaudeExecutor implements A2AExecutor {
+    private config;
+    private client;
+    private initialized;
+    constructor(config: Required<AgentConfig>);
+    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;
+
+/**
+ * Lightweight structured logger for the CLI A2A gateway.
+ *
+ * Uses pino-compatible structured logging. In production mode the output is
+ * JSON; in dev mode it is pretty-printed via pino-pretty.
+ */
+declare enum LogLevel {
+    DEBUG = 10,
+    INFO = 20,
+    WARN = 30,
+    ERROR = 40
+}
+declare class Logger {
+    private level;
+    private name;
+    constructor(name: string);
+    setLevel(level: LogLevel): void;
+    child(name: string): Logger;
+    debug(msg: string, ctx?: Record<string, unknown>): void;
+    info(msg: string, ctx?: Record<string, unknown>): void;
+    warn(msg: string, ctx?: Record<string, unknown>): void;
+    error(msg: string, ctx?: Record<string, unknown>): void;
+    private log;
+}
+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 };

package/dist/index.d.ts

@@ -0,0 +1,295 @@
+import express from 'express';
+import { AgentExecutor, RequestContext, ExecutionEventBus } from '@a2a-js/sdk/server';
+export { AgentExecutor, ExecutionEventBus, RequestContext } from '@a2a-js/sdk/server';
+
+/**
+ * Unified configuration types for the CLI A2A gateway.
+ *
+ * Each provider (OpenCode, Codex, Claude Code) extends the base config
+ * with its own connection settings. A single config file can declare
+ * multiple providers, and the CLI selects one at startup via --provider.
+ */
+interface AgentCardConfig {
+    /** Human-readable agent name */
+    name: string;
+    /** Agent description shown to orchestrators / callers */
+    description: string;
+    /** Protocol version (default: "0.3.0") */
+    protocolVersion?: string;
+    /** Agent version string */
+    version?: string;
+    /** Skills advertised on the agent card */
+    skills?: SkillConfig[];
+    /** Supported input modes */
+    defaultInputModes?: string[];
+    /** Supported output modes */
+    defaultOutputModes?: string[];
+    /** Enable streaming */
+    streaming?: boolean;
+    /** Enable push notifications */
+    pushNotifications?: boolean;
+    /** Provider info */
+    provider?: {
+        organization: string;
+        url?: string;
+    };
+}
+interface SkillConfig {
+    id: string;
+    name: string;
+    description: string;
+    tags?: string[];
+    examples?: string[];
+}
+interface ServerConfig {
+    /** A2A server port */
+    port?: number;
+    /** Bind address */
+    hostname?: string;
+    /** Hostname advertised in agent card URLs */
+    advertiseHost?: string;
+    /** Protocol for advertised URLs */
+    advertiseProtocol?: 'http' | 'https';
+}
+interface SessionConfig {
+    /** Session title prefix */
+    titlePrefix?: string;
+    /** Reuse sessions by A2A contextId */
+    reuseByContext?: boolean;
+    /** Session TTL in ms */
+    ttl?: number;
+    /** Cleanup interval in ms */
+    cleanupInterval?: number;
+}
+interface FeatureFlags {
+    /** Auto-approve all permission requests */
+    autoApprovePermissions?: boolean;
+    /** Auto-answer question prompts */
+    autoAnswerQuestions?: boolean;
+    /** Stream artifact chunks individually vs buffer */
+    streamArtifactChunks?: boolean;
+    /** Enable polling fallback on SSE failure */
+    enablePollingFallback?: boolean;
+}
+interface TimeoutConfig {
+    /** Timeout for a single prompt in ms */
+    prompt?: number;
+    /** Polling interval in ms */
+    pollingInterval?: number;
+    /** Health check interval in ms */
+    healthCheck?: number;
+}
+interface LoggingConfig {
+    /** Log level */
+    level?: 'debug' | 'info' | 'warn' | 'error';
+}
+interface OpenCodeConfig {
+    /** OpenCode server base URL */
+    baseUrl?: string;
+    /** Target project directory */
+    projectDirectory?: string;
+    /** Model identifier (e.g. "anthropic/claude-sonnet-4-20250514") */
+    model?: string;
+    /** Agent preset name */
+    agent?: string;
+    /** System prompt */
+    systemPrompt?: string;
+    /** How system prompt is applied */
+    systemPromptMode?: 'append' | 'replace';
+    /** Context file name */
+    contextFile?: string;
+    /** Prompt for building context */
+    contextPrompt?: string;
+}
+interface CodexConfig {
+    /** Codex CLI path */
+    cliPath?: string;
+    /** Working directory */
+    workdir?: string;
+    /** Model identifier */
+    model?: string;
+    /** API key for OpenAI */
+    apiKey?: string;
+}
+interface ClaudeCodeConfig {
+    /** Claude Code CLI path */
+    cliPath?: string;
+    /** Working directory */
+    workdir?: string;
+    /** Model identifier */
+    model?: string;
+    /** API key for Anthropic */
+    apiKey?: string;
+}
+type ProviderType = 'opencode' | 'codex' | 'claude';
+interface AgentConfig {
+    /** Active provider to use */
+    provider: ProviderType;
+    /** Agent card identity */
+    agentCard: AgentCardConfig;
+    /** Server settings */
+    server?: ServerConfig;
+    /** Session management */
+    session?: SessionConfig;
+    /** Feature flags */
+    features?: FeatureFlags;
+    /** Timeout settings */
+    timeouts?: TimeoutConfig;
+    /** Logging settings */
+    logging?: LoggingConfig;
+    /** Provider-specific connection configs */
+    opencode?: OpenCodeConfig;
+    codex?: CodexConfig;
+    claude?: ClaudeCodeConfig;
+    /** Directory containing config file (populated at runtime) */
+    configDir?: string;
+}
+
+/**
+ * Config loader — reads JSON config files and resolves the final config
+ * by merging layers: defaults ← config file ← env overrides ← CLI args.
+ */
+
+/**
+ * Read and parse a JSON config file.
+ */
+declare function loadConfigFile(filePath: string): Partial<AgentConfig>;
+/**
+ * Resolve full config from defaults + file + env.
+ */
+declare function resolveConfig(configPath?: string, cliOverrides?: Partial<AgentConfig>): Required<AgentConfig>;
+
+/**
+ * A2A HTTP Server
+ *
+ * Creates an Express server with standard A2A endpoints:
+ *  - GET /.well-known/agent-card.json  → Agent Card
+ *  - POST /a2a/jsonrpc                 → JSON-RPC transport
+ *  - POST /a2a/rest                    → REST transport
+ *  - GET /health                       → Health check
+ */
+
+interface ServerHandle {
+    app: ReturnType<typeof express>;
+    server: ReturnType<ReturnType<typeof express>['listen']>;
+    shutdown(): Promise<void>;
+}
+declare function createA2AServer(config: Required<AgentConfig>): Promise<ServerHandle>;
+
+/**
+ * Executor types and common interfaces for CLI A2A providers.
+ *
+ * Each provider (OpenCode, Codex, Claude) implements its own executor
+ * conforming to the A2AExecutor interface which extends the SDK's
+ * AgentExecutor with lifecycle methods (initialize, shutdown).
+ */
+
+/**
+ * Extended executor interface with lifecycle methods.
+ *
+ * The base AgentExecutor from @a2a-js/sdk only defines execute() and
+ * cancelTask(). We add initialize() for server setup and shutdown()
+ * for graceful cleanup.
+ */
+interface A2AExecutor extends AgentExecutor {
+    initialize(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+
+/**
+ * Factory function type: given resolved config, produce an executor.
+ */
+type ExecutorFactory = (config: Required<AgentConfig>) => A2AExecutor;
+declare function registerExecutor(provider: ProviderType, factory: ExecutorFactory): void;
+declare function getExecutor(provider: ProviderType): ExecutorFactory | undefined;
+declare function createExecutor(config: Required<AgentConfig>): 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.
+ */
+
+declare class OpenCodeExecutor implements A2AExecutor {
+    private config;
+    private client;
+    private initialized;
+    constructor(config: Required<AgentConfig>);
+    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;
+
+/**
+ * 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.
+ */
+
+declare class CodexExecutor implements A2AExecutor {
+    private config;
+    private client;
+    private initialized;
+    constructor(config: Required<AgentConfig>);
+    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;
+
+/**
+ * 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.
+ */
+
+declare class ClaudeExecutor implements A2AExecutor {
+    private config;
+    private client;
+    private initialized;
+    constructor(config: Required<AgentConfig>);
+    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;
+
+/**
+ * Lightweight structured logger for the CLI A2A gateway.
+ *
+ * Uses pino-compatible structured logging. In production mode the output is
+ * JSON; in dev mode it is pretty-printed via pino-pretty.
+ */
+declare enum LogLevel {
+    DEBUG = 10,
+    INFO = 20,
+    WARN = 30,
+    ERROR = 40
+}
+declare class Logger {
+    private level;
+    private name;
+    constructor(name: string);
+    setLevel(level: LogLevel): void;
+    child(name: string): Logger;
+    debug(msg: string, ctx?: Record<string, unknown>): void;
+    info(msg: string, ctx?: Record<string, unknown>): void;
+    warn(msg: string, ctx?: Record<string, unknown>): void;
+    error(msg: string, ctx?: Record<string, unknown>): void;
+    private log;
+}
+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 };