@supaku/agentfactory 0.1.0

package/dist/src/providers/amp-provider.d.ts

@@ -0,0 +1,20 @@
+/**
+ * AmpCode (Sourcegraph Amp) Agent Provider (Stub)
+ *
+ * Will wrap @sourcegraph/amp-sdk to implement the AgentProvider interface.
+ * Currently a placeholder — install the SDK and implement when ready.
+ *
+ * Expected SDK pattern:
+ *   import { execute } from '@sourcegraph/amp-sdk'
+ *   const stream = execute({ prompt, cwd, ... })
+ *   for await (const msg of stream) { ... }
+ *   // resume: execute({ continue: threadId })
+ */
+import type { AgentProvider, AgentSpawnConfig, AgentHandle } from './types';
+export declare class AmpProvider implements AgentProvider {
+    readonly name: "amp";
+    spawn(_config: AgentSpawnConfig): AgentHandle;
+    resume(_sessionId: string, _config: AgentSpawnConfig): AgentHandle;
+}
+export declare function createAmpProvider(): AmpProvider;
+//# sourceMappingURL=amp-provider.d.ts.map

package/dist/src/providers/amp-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"amp-provider.d.ts","sourceRoot":"","sources":["../../../src/providers/amp-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,WAAW,EACZ,MAAM,SAAS,CAAA;AAEhB,qBAAa,WAAY,YAAW,aAAa;IAC/C,QAAQ,CAAC,IAAI,EAAG,KAAK,CAAS;IAE9B,KAAK,CAAC,OAAO,EAAE,gBAAgB,GAAG,WAAW;IAM7C,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,WAAW;CAKnE;AAED,wBAAgB,iBAAiB,IAAI,WAAW,CAE/C"}

package/dist/src/providers/amp-provider.js

@@ -0,0 +1,24 @@
+/**
+ * AmpCode (Sourcegraph Amp) Agent Provider (Stub)
+ *
+ * Will wrap @sourcegraph/amp-sdk to implement the AgentProvider interface.
+ * Currently a placeholder — install the SDK and implement when ready.
+ *
+ * Expected SDK pattern:
+ *   import { execute } from '@sourcegraph/amp-sdk'
+ *   const stream = execute({ prompt, cwd, ... })
+ *   for await (const msg of stream) { ... }
+ *   // resume: execute({ continue: threadId })
+ */
+export class AmpProvider {
+    name = 'amp';
+    spawn(_config) {
+        throw new Error('Amp provider is not yet implemented. Install @sourcegraph/amp-sdk and implement AmpProvider.');
+    }
+    resume(_sessionId, _config) {
+        throw new Error('Amp provider is not yet implemented. Install @sourcegraph/amp-sdk and implement AmpProvider.');
+    }
+}
+export function createAmpProvider() {
+    return new AmpProvider();
+}

package/dist/src/providers/claude-provider.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Claude Agent Provider
+ *
+ * Wraps @anthropic-ai/claude-agent-sdk to implement the AgentProvider interface.
+ * Translates Claude SDK's `query()` and `SDKMessage` stream into normalized AgentEvents.
+ */
+import type { AgentProvider, AgentSpawnConfig, AgentHandle } from './types';
+export declare class ClaudeProvider implements AgentProvider {
+    readonly name: "claude";
+    spawn(config: AgentSpawnConfig): AgentHandle;
+    resume(sessionId: string, config: AgentSpawnConfig): AgentHandle;
+    private createHandle;
+}
+/**
+ * Create a new Claude provider instance
+ */
+export declare function createClaudeProvider(): ClaudeProvider;
+//# sourceMappingURL=claude-provider.d.ts.map

package/dist/src/providers/claude-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-provider.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,WAAW,EAEZ,MAAM,SAAS,CAAA;AAEhB,qBAAa,cAAe,YAAW,aAAa;IAClD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAS;IAEjC,KAAK,CAAC,MAAM,EAAE,gBAAgB,GAAG,WAAW;IAI5C,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,WAAW;IAIhE,OAAO,CAAC,YAAY;CA2DrB;AAsND;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAErD"}

package/dist/src/providers/claude-provider.js

@@ -0,0 +1,267 @@
+/**
+ * Claude Agent Provider
+ *
+ * Wraps @anthropic-ai/claude-agent-sdk to implement the AgentProvider interface.
+ * Translates Claude SDK's `query()` and `SDKMessage` stream into normalized AgentEvents.
+ */
+import { spawn } from 'child_process';
+import { query, } from '@anthropic-ai/claude-agent-sdk';
+export class ClaudeProvider {
+    name = 'claude';
+    spawn(config) {
+        return this.createHandle(config);
+    }
+    resume(sessionId, config) {
+        return this.createHandle(config, sessionId);
+    }
+    createHandle(config, resumeSessionId) {
+        const abortController = config.abortController;
+        const agentQuery = query({
+            prompt: config.prompt,
+            options: {
+                cwd: config.cwd,
+                env: config.env,
+                abortController,
+                permissionMode: 'acceptEdits',
+                disallowedTools: config.autonomous ? ['AskUserQuestion'] : [],
+                settingSources: ['project'],
+                systemPrompt: { type: 'preset', preset: 'claude_code' },
+                resume: resumeSessionId,
+                sandbox: config.sandboxEnabled
+                    ? {
+                        enabled: true,
+                        autoAllowBashIfSandboxed: true,
+                        excludedCommands: ['git', 'gh', 'pnpm', 'npm', 'npx', 'node', 'vercel'],
+                        network: {
+                            allowLocalBinding: true,
+                            allowAllUnixSockets: true,
+                            allowedDomains: ['*'],
+                        },
+                    }
+                    : { enabled: false },
+                spawnClaudeCodeProcess: (spawnOptions) => {
+                    const nodePath = process.execPath;
+                    const args = spawnOptions.args || [];
+                    const child = spawn(nodePath, args, {
+                        cwd: spawnOptions.cwd,
+                        env: spawnOptions.env,
+                        stdio: ['pipe', 'pipe', 'pipe'],
+                    });
+                    config.onProcessSpawned?.(child.pid);
+                    child.on('error', (err) => {
+                        console.error('[ClaudeProvider] Child process error:', err.message);
+                    });
+                    if (spawnOptions.signal) {
+                        const abortHandler = () => {
+                            child.kill('SIGTERM');
+                        };
+                        spawnOptions.signal.addEventListener('abort', abortHandler);
+                        child.once('exit', () => {
+                            spawnOptions.signal.removeEventListener('abort', abortHandler);
+                        });
+                    }
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    return child;
+                },
+            },
+        });
+        return new ClaudeAgentHandle(agentQuery, abortController);
+    }
+}
+/**
+ * AgentHandle implementation wrapping a Claude SDK Query object.
+ */
+class ClaudeAgentHandle {
+    sessionId = null;
+    agentQuery;
+    abortController;
+    constructor(agentQuery, abortController) {
+        this.agentQuery = agentQuery;
+        this.abortController = abortController;
+    }
+    get stream() {
+        return this.createEventStream();
+    }
+    async injectMessage(text) {
+        const sessionId = this.sessionId;
+        async function* userMessageGenerator() {
+            yield {
+                type: 'user',
+                message: {
+                    role: 'user',
+                    content: text,
+                },
+                parent_tool_use_id: null,
+                session_id: sessionId || '',
+            };
+        }
+        await this.agentQuery.streamInput(userMessageGenerator());
+    }
+    async stop() {
+        this.abortController.abort();
+    }
+    /**
+     * Returns the underlying Query object for direct access if needed.
+     * This is an escape hatch — prefer using the AgentHandle interface.
+     */
+    getRawQuery() {
+        return this.agentQuery;
+    }
+    async *createEventStream() {
+        for await (const message of this.agentQuery) {
+            const events = this.mapSDKMessage(message);
+            for (const event of events) {
+                yield event;
+            }
+        }
+    }
+    /**
+     * Map a single SDKMessage to one or more AgentEvents.
+     * Most messages map 1:1, but assistant messages with multiple content blocks
+     * may produce multiple events.
+     */
+    mapSDKMessage(message) {
+        switch (message.type) {
+            case 'system':
+                return this.mapSystemMessage(message);
+            case 'user':
+                return this.mapUserMessage(message);
+            case 'assistant':
+                return this.mapAssistantMessage(message);
+            case 'result':
+                return this.mapResultMessage(message);
+            case 'tool_progress':
+                return [{
+                        type: 'tool_progress',
+                        toolName: message.tool_name,
+                        elapsedSeconds: message.elapsed_time_seconds,
+                        raw: message,
+                    }];
+            case 'stream_event':
+                // Partial streaming — skip (high frequency, low value for orchestrator)
+                return [];
+            case 'auth_status':
+                if (message.error) {
+                    return [{
+                            type: 'error',
+                            message: message.error,
+                            raw: message,
+                        }];
+                }
+                return [{
+                        type: 'system',
+                        subtype: 'auth_status',
+                        message: message.isAuthenticating ? 'Authenticating...' : 'Authenticated',
+                        raw: message,
+                    }];
+            default:
+                return [{
+                        type: 'system',
+                        subtype: 'unknown',
+                        message: `Unhandled message type: ${message.type}`,
+                        raw: message,
+                    }];
+        }
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    mapSystemMessage(message) {
+        if (message.subtype === 'init') {
+            this.sessionId = message.session_id;
+            return [{
+                    type: 'init',
+                    sessionId: message.session_id,
+                    raw: message,
+                }];
+        }
+        return [{
+                type: 'system',
+                subtype: message.subtype ?? 'unknown',
+                message: message.status ?? message.message,
+                raw: message,
+            }];
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    mapUserMessage(message) {
+        const events = [];
+        if (message.message?.content) {
+            for (const block of message.message.content) {
+                if (typeof block === 'object' &&
+                    block !== null &&
+                    'type' in block &&
+                    block.type === 'tool_result' &&
+                    'content' in block) {
+                    events.push({
+                        type: 'tool_result',
+                        toolUseId: 'tool_use_id' in block ? String(block.tool_use_id) : undefined,
+                        content: typeof block.content === 'string' ? block.content : JSON.stringify(block.content),
+                        isError: 'is_error' in block && block.is_error === true,
+                        raw: message,
+                    });
+                }
+            }
+        }
+        // If no tool results were extracted, emit as a generic system event
+        if (events.length === 0) {
+            events.push({
+                type: 'system',
+                subtype: 'user_message',
+                raw: message,
+            });
+        }
+        return events;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    mapAssistantMessage(message) {
+        const events = [];
+        if (message.message?.content) {
+            for (const block of message.message.content) {
+                if (block.type === 'text' && block.text) {
+                    events.push({
+                        type: 'assistant_text',
+                        text: block.text,
+                        raw: message,
+                    });
+                }
+                else if (block.type === 'tool_use') {
+                    events.push({
+                        type: 'tool_use',
+                        toolName: block.name,
+                        toolUseId: block.id,
+                        input: block.input,
+                        raw: message,
+                    });
+                }
+            }
+        }
+        return events;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    mapResultMessage(message) {
+        if (message.subtype === 'success') {
+            return [{
+                    type: 'result',
+                    success: true,
+                    message: message.result,
+                    cost: {
+                        totalCostUsd: message.total_cost_usd,
+                        numTurns: message.num_turns,
+                    },
+                    raw: message,
+                }];
+        }
+        // Error result
+        return [{
+                type: 'result',
+                success: false,
+                errors: 'errors' in message && message.errors ? message.errors : [],
+                errorSubtype: message.subtype,
+                raw: message,
+            }];
+    }
+}
+/**
+ * Create a new Claude provider instance
+ */
+export function createClaudeProvider() {
+    return new ClaudeProvider();
+}

package/dist/src/providers/codex-provider.d.ts

@@ -0,0 +1,21 @@
+/**
+ * OpenAI Codex Agent Provider (Stub)
+ *
+ * Will wrap @openai/codex-sdk to implement the AgentProvider interface.
+ * Currently a placeholder — install the SDK and implement when ready.
+ *
+ * Expected SDK pattern:
+ *   import { Codex } from '@openai/codex-sdk'
+ *   const codex = new Codex({ apiKey })
+ *   const thread = codex.startThread()
+ *   const result = await thread.run(prompt)
+ *   // or streamed: for await (const event of thread.runStreamed().events) { ... }
+ */
+import type { AgentProvider, AgentSpawnConfig, AgentHandle } from './types';
+export declare class CodexProvider implements AgentProvider {
+    readonly name: "codex";
+    spawn(_config: AgentSpawnConfig): AgentHandle;
+    resume(_sessionId: string, _config: AgentSpawnConfig): AgentHandle;
+}
+export declare function createCodexProvider(): CodexProvider;
+//# sourceMappingURL=codex-provider.d.ts.map

package/dist/src/providers/codex-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-provider.d.ts","sourceRoot":"","sources":["../../../src/providers/codex-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,WAAW,EACZ,MAAM,SAAS,CAAA;AAEhB,qBAAa,aAAc,YAAW,aAAa;IACjD,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAS;IAEhC,KAAK,CAAC,OAAO,EAAE,gBAAgB,GAAG,WAAW;IAM7C,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,WAAW;CAKnE;AAED,wBAAgB,mBAAmB,IAAI,aAAa,CAEnD"}

package/dist/src/providers/codex-provider.js

@@ -0,0 +1,25 @@
+/**
+ * OpenAI Codex Agent Provider (Stub)
+ *
+ * Will wrap @openai/codex-sdk to implement the AgentProvider interface.
+ * Currently a placeholder — install the SDK and implement when ready.
+ *
+ * Expected SDK pattern:
+ *   import { Codex } from '@openai/codex-sdk'
+ *   const codex = new Codex({ apiKey })
+ *   const thread = codex.startThread()
+ *   const result = await thread.run(prompt)
+ *   // or streamed: for await (const event of thread.runStreamed().events) { ... }
+ */
+export class CodexProvider {
+    name = 'codex';
+    spawn(_config) {
+        throw new Error('Codex provider is not yet implemented. Install @openai/codex-sdk and implement CodexProvider.');
+    }
+    resume(_sessionId, _config) {
+        throw new Error('Codex provider is not yet implemented. Install @openai/codex-sdk and implement CodexProvider.');
+    }
+}
+export function createCodexProvider() {
+    return new CodexProvider();
+}

package/dist/src/providers/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Agent Provider Factory
+ *
+ * Creates provider instances based on name.
+ * Supports provider selection via env vars:
+ *   AGENT_PROVIDER=claude            (global default)
+ *   AGENT_PROVIDER_SOCIAL=codex      (per-project override)
+ *   AGENT_PROVIDER_QA=amp            (per-work-type override)
+ *
+ * Resolution order: work-type → project → env default → 'claude'
+ */
+export type { AgentProviderName, AgentProvider, AgentSpawnConfig, AgentHandle, AgentEvent } from './types';
+export type { AgentInitEvent, AgentSystemEvent, AgentAssistantTextEvent, AgentToolUseEvent, AgentToolResultEvent, AgentToolProgressEvent, AgentResultEvent, AgentErrorEvent, AgentCostData, } from './types';
+export { ClaudeProvider, createClaudeProvider } from './claude-provider';
+export { CodexProvider, createCodexProvider } from './codex-provider';
+export { AmpProvider, createAmpProvider } from './amp-provider';
+import type { AgentProvider, AgentProviderName } from './types';
+/**
+ * Create a provider instance by name.
+ *
+ * @param name - Provider name ('claude', 'codex', 'amp')
+ * @returns AgentProvider instance
+ * @throws Error if provider name is unknown
+ */
+export declare function createProvider(name: AgentProviderName): AgentProvider;
+/**
+ * Resolve which provider to use based on env vars, project, and work type.
+ *
+ * Resolution order (highest priority first):
+ * 1. AGENT_PROVIDER_{WORKTYPE} (e.g., AGENT_PROVIDER_QA=amp)
+ * 2. AGENT_PROVIDER_{PROJECT} (e.g., AGENT_PROVIDER_SOCIAL=codex)
+ * 3. AGENT_PROVIDER (global default)
+ * 4. 'claude' (fallback)
+ *
+ * @param options - Project and work type context for resolution
+ * @returns The resolved provider name
+ */
+export declare function resolveProviderName(options?: {
+    project?: string;
+    workType?: string;
+}): AgentProviderName;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,gBAAgB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAC1G,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,aAAa,GACd,MAAM,SAAS,CAAA;AAEhB,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AACxE,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AACrE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAE/D,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAK/D;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAWrE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,GAAG,iBAAiB,CA2BpB"}

package/dist/src/providers/index.js

@@ -0,0 +1,77 @@
+/**
+ * Agent Provider Factory
+ *
+ * Creates provider instances based on name.
+ * Supports provider selection via env vars:
+ *   AGENT_PROVIDER=claude            (global default)
+ *   AGENT_PROVIDER_SOCIAL=codex      (per-project override)
+ *   AGENT_PROVIDER_QA=amp            (per-work-type override)
+ *
+ * Resolution order: work-type → project → env default → 'claude'
+ */
+export { ClaudeProvider, createClaudeProvider } from './claude-provider';
+export { CodexProvider, createCodexProvider } from './codex-provider';
+export { AmpProvider, createAmpProvider } from './amp-provider';
+import { ClaudeProvider } from './claude-provider';
+import { CodexProvider } from './codex-provider';
+import { AmpProvider } from './amp-provider';
+/**
+ * Create a provider instance by name.
+ *
+ * @param name - Provider name ('claude', 'codex', 'amp')
+ * @returns AgentProvider instance
+ * @throws Error if provider name is unknown
+ */
+export function createProvider(name) {
+    switch (name) {
+        case 'claude':
+            return new ClaudeProvider();
+        case 'codex':
+            return new CodexProvider();
+        case 'amp':
+            return new AmpProvider();
+        default:
+            throw new Error(`Unknown agent provider: ${name}. Supported: claude, codex, amp`);
+    }
+}
+/**
+ * Resolve which provider to use based on env vars, project, and work type.
+ *
+ * Resolution order (highest priority first):
+ * 1. AGENT_PROVIDER_{WORKTYPE} (e.g., AGENT_PROVIDER_QA=amp)
+ * 2. AGENT_PROVIDER_{PROJECT} (e.g., AGENT_PROVIDER_SOCIAL=codex)
+ * 3. AGENT_PROVIDER (global default)
+ * 4. 'claude' (fallback)
+ *
+ * @param options - Project and work type context for resolution
+ * @returns The resolved provider name
+ */
+export function resolveProviderName(options) {
+    // Check work-type-specific override
+    if (options?.workType) {
+        const workTypeKey = `AGENT_PROVIDER_${options.workType.toUpperCase().replace(/-/g, '_')}`;
+        const workTypeProvider = process.env[workTypeKey];
+        if (workTypeProvider && isValidProviderName(workTypeProvider)) {
+            return workTypeProvider;
+        }
+    }
+    // Check project-specific override
+    if (options?.project) {
+        const projectKey = `AGENT_PROVIDER_${options.project.toUpperCase()}`;
+        const projectProvider = process.env[projectKey];
+        if (projectProvider && isValidProviderName(projectProvider)) {
+            return projectProvider;
+        }
+    }
+    // Check global default
+    const globalProvider = process.env.AGENT_PROVIDER;
+    if (globalProvider && isValidProviderName(globalProvider)) {
+        return globalProvider;
+    }
+    // Fallback
+    return 'claude';
+}
+const VALID_PROVIDER_NAMES = ['claude', 'codex', 'amp'];
+function isValidProviderName(name) {
+    return VALID_PROVIDER_NAMES.includes(name);
+}

package/dist/src/providers/types.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Agent Provider Interface
+ *
+ * Abstracts the underlying agent SDK (Claude, Codex, Amp, etc.)
+ * so the orchestrator is provider-agnostic.
+ *
+ * All three providers follow the same pattern:
+ * 1. Initialize with config + working directory
+ * 2. Send a prompt
+ * 3. Iterate over a stream of events
+ * 4. Get a final result with cost/token data
+ */
+/** Supported agent provider names */
+export type AgentProviderName = 'claude' | 'codex' | 'amp';
+/**
+ * Agent Provider
+ *
+ * Each provider implements spawn/resume to create an AgentHandle
+ * that streams normalized AgentEvents.
+ */
+export interface AgentProvider {
+    /** Provider identifier */
+    readonly name: AgentProviderName;
+    /** Spawn a new agent session */
+    spawn(config: AgentSpawnConfig): AgentHandle;
+    /** Resume a previously interrupted session */
+    resume(sessionId: string, config: AgentSpawnConfig): AgentHandle;
+}
+/**
+ * Configuration passed to a provider when spawning an agent.
+ * Provider implementations translate these to SDK-specific options.
+ */
+export interface AgentSpawnConfig {
+    /** The prompt/instruction for the agent */
+    prompt: string;
+    /** Working directory for the agent */
+    cwd: string;
+    /** Environment variables to pass to the agent process */
+    env: Record<string, string>;
+    /** AbortController for cancellation support */
+    abortController: AbortController;
+    /** Whether agent runs in autonomous mode (no user input) */
+    autonomous: boolean;
+    /** Sandbox level for filesystem/network restrictions */
+    sandboxEnabled: boolean;
+    /**
+     * Callback to capture PID when the agent process is spawned.
+     * Providers call this once the underlying process is created.
+     */
+    onProcessSpawned?: (pid: number | undefined) => void;
+}
+/**
+ * Handle to a running agent session.
+ * Returned by AgentProvider.spawn() and AgentProvider.resume().
+ */
+export interface AgentHandle {
+    /** Provider-specific session/thread ID (available after init event) */
+    sessionId: string | null;
+    /** Async iterable stream of normalized events */
+    stream: AsyncIterable<AgentEvent>;
+    /**
+     * Inject a follow-up user message into the running session.
+     * Used for user prompts without restarting the agent.
+     */
+    injectMessage(text: string): Promise<void>;
+    /**
+     * Stop the agent. Delegates to the provider's abort mechanism.
+     */
+    stop(): Promise<void>;
+}
+/**
+ * Normalized agent event.
+ * Each provider maps its native events to this common format.
+ */
+export type AgentEvent = AgentInitEvent | AgentSystemEvent | AgentAssistantTextEvent | AgentToolUseEvent | AgentToolResultEvent | AgentToolProgressEvent | AgentResultEvent | AgentErrorEvent;
+/** Agent initialized — contains session ID for resume */
+export interface AgentInitEvent {
+    type: 'init';
+    sessionId: string;
+    raw: unknown;
+}
+/** System-level event (status changes, compaction, etc.) */
+export interface AgentSystemEvent {
+    type: 'system';
+    subtype: string;
+    message?: string;
+    raw: unknown;
+}
+/** Assistant text output */
+export interface AgentAssistantTextEvent {
+    type: 'assistant_text';
+    text: string;
+    raw: unknown;
+}
+/** Agent is invoking a tool */
+export interface AgentToolUseEvent {
+    type: 'tool_use';
+    toolName: string;
+    toolUseId?: string;
+    input: Record<string, unknown>;
+    raw: unknown;
+}
+/** Tool execution result */
+export interface AgentToolResultEvent {
+    type: 'tool_result';
+    toolName?: string;
+    toolUseId?: string;
+    content: string;
+    isError: boolean;
+    raw: unknown;
+}
+/** Tool execution progress update */
+export interface AgentToolProgressEvent {
+    type: 'tool_progress';
+    toolName: string;
+    elapsedSeconds: number;
+    raw: unknown;
+}
+/** Final result — agent has finished */
+export interface AgentResultEvent {
+    type: 'result';
+    success: boolean;
+    /** Completion message (only on success) */
+    message?: string;
+    /** Error messages (only on failure) */
+    errors?: string[];
+    /** Error subtype from the provider (e.g., 'error_during_execution', 'error_max_turns') */
+    errorSubtype?: string;
+    /** Cost/usage data */
+    cost?: AgentCostData;
+    raw: unknown;
+}
+/** Error event */
+export interface AgentErrorEvent {
+    type: 'error';
+    message: string;
+    code?: string;
+    raw: unknown;
+}
+/** Cost and token usage data */
+export interface AgentCostData {
+    inputTokens?: number;
+    outputTokens?: number;
+    totalCostUsd?: number;
+    numTurns?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/providers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/providers/types.ts"],"names":[],"mappings":"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"}