octoflow-core 1.0.0

package/dist/adapters/agents/agent-client-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-client-helpers.d.ts","sourceRoot":"","sources":["../../../src/adapters/agents/agent-client-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,iBAAiB,EAClB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAGtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAoBnE,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,kBAAkB,EACxB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,iBAAiB,EAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,EACzB,QAAQ,CAAC,EAAE,OAAO,EAClB,aAAa,CAAC,EAAE,iBAAiB,CAAC,eAAe,CAAC,GACjD,iBAAiB,CAqEnB"}

package/dist/adapters/agents/agent-client-helpers.js

@@ -0,0 +1,68 @@
+import { AgentRunError } from "../../domain/errors/index.js";
+import { resolveOutputTokens } from "./backends/model-matrix.js";
+function deriveMaxContextEnv(backendName, callOpts, clientMaxContext) {
+  if (backendName !== "claude-code-cli") return void 0;
+  const value = callOpts?.maxContext ?? clientMaxContext;
+  if (typeof value !== "number" || value <= 0) return void 0;
+  return { CLAUDE_CODE_MAX_CONTEXT_TOKENS: String(value) };
+}
+function buildAgentBackendRunRequest(opts, backend, prompt, callOpts, sessionId, isResume, runtimePolicy) {
+  const clientEnv = opts.env;
+  const callEnv = callOpts?.env;
+  const maxContextEnv = deriveMaxContextEnv(
+    opts.backend,
+    callOpts,
+    opts.maxContext
+  );
+  const mergedEnv = clientEnv || callEnv || maxContextEnv ? { ...maxContextEnv ?? {}, ...clientEnv ?? {}, ...callEnv ?? {} } : void 0;
+  const requestedModel = callOpts?.model ?? opts.model ?? void 0;
+  const model = requestedModel ?? backend.defaultModel;
+  if (model && typeof backend.validateModel === "function" && !backend.validateModel(model)) {
+    throw new AgentRunError(
+      `Model "${model}" is not valid for backend ${backend.name}. Accepted models: ${backend.models.join(", ")}`,
+      1,
+      opts.backend
+    );
+  }
+  return {
+    prompt,
+    model,
+    requestedModel: requestedModel ?? null,
+    configModel: backend.configModel ?? null,
+    maxOutputTokens: resolveOutputTokens(
+      callOpts?.maxOutputTokens,
+      model,
+      backend.maxOutputTokens
+    ),
+    systemPrompt: callOpts?.systemPrompt ?? opts.systemPrompt ?? null,
+    cwd: runtimePolicy?.workspace ?? callOpts?.cwd ?? opts.cwd ?? null,
+    timeoutMs: callOpts?.timeoutMs ?? opts.timeoutMs,
+    signal: callOpts?.signal,
+    mcpConfigPath: callOpts?.mcpConfigPath ?? opts.mcpConfigPath ?? null,
+    sessionId: sessionId ?? null,
+    isResume: isResume ?? false,
+    runtimePolicy: runtimePolicy ?? null,
+    env: mergedEnv,
+    tools: callOpts?.tools,
+    maxBudgetUsd: callOpts?.maxBudgetUsd,
+    effort: callOpts?.effort,
+    worktree: callOpts?.worktree ?? opts.worktree,
+    allowedTools: callOpts?.allowedTools,
+    disallowedTools: callOpts?.disallowedTools,
+    structuredHistory: callOpts?.structuredHistory,
+    systemPromptParts: callOpts?.systemPromptParts,
+    cache: callOpts?.cache,
+    cacheControl: callOpts?.cacheControl,
+    parts: callOpts?.parts,
+    readOnly: callOpts?.readOnly,
+    outputSchema: callOpts?.outputSchema,
+    appendSystemPrompt: callOpts?.appendSystemPrompt,
+    strictMcpConfig: callOpts?.strictMcpConfig,
+    excludeDynamicSystemPromptSections: callOpts?.excludeDynamicSystemPromptSections,
+    isOrchestration: callOpts?.isOrchestration
+  };
+}
+export {
+  buildAgentBackendRunRequest
+};
+//# sourceMappingURL=agent-client-helpers.js.map

package/dist/adapters/agents/agent-client-helpers.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/adapters/agents/agent-client-helpers.ts"],
+  "sourcesContent": ["import type {\n  Backend,\n  BackendRunRequest,\n} from '../../domain/contracts/backends.js';\nimport type { AgentClientOptions } from '../../domain/core-client.js';\nimport { AgentRunError } from '../../domain/errors/index.js';\nimport { resolveOutputTokens } from './backends/model-matrix.js';\nimport type { BackendRunOptions } from './internal-run-options.js';\n\n/**\n * RFC-05: derive native env-var injection for the configured CLI backend\n * from `maxContext`. Only `claude-code-cli` consumes\n * `CLAUDE_CODE_MAX_CONTEXT_TOKENS` natively today; other backends are\n * silently no-op so the field stays backend-agnostic at the call site.\n * `0` and unset both skip injection.\n */\nfunction deriveMaxContextEnv(\n  backendName: AgentClientOptions['backend'],\n  callOpts?: BackendRunOptions,\n  clientMaxContext?: AgentClientOptions['maxContext']\n): Record<string, string> | undefined {\n  if (backendName !== 'claude-code-cli') return undefined;\n  const value = callOpts?.maxContext ?? clientMaxContext;\n  if (typeof value !== 'number' || value <= 0) return undefined;\n  return { CLAUDE_CODE_MAX_CONTEXT_TOKENS: String(value) };\n}\n\nexport function buildAgentBackendRunRequest(\n  opts: AgentClientOptions,\n  backend: Backend,\n  prompt: string,\n  callOpts?: BackendRunOptions,\n  sessionId?: string | null,\n  isResume?: boolean,\n  runtimePolicy?: BackendRunRequest['runtimePolicy']\n): BackendRunRequest {\n  const clientEnv = opts.env;\n  const callEnv = callOpts?.env;\n  const maxContextEnv = deriveMaxContextEnv(\n    opts.backend,\n    callOpts,\n    opts.maxContext\n  );\n  const mergedEnv =\n    clientEnv || callEnv || maxContextEnv\n      ? { ...(maxContextEnv ?? {}), ...(clientEnv ?? {}), ...(callEnv ?? {}) }\n      : undefined;\n  // requestedModel: only what the caller explicitly set (undefined when absent).\n  // model: fully resolved \u2014 falls back to backend.defaultModel for token-budget math\n  //        and other infrastructure that needs a concrete value.\n  const requestedModel = callOpts?.model ?? opts.model ?? undefined;\n  const model = requestedModel ?? backend.defaultModel;\n\n  if (\n    model &&\n    typeof backend.validateModel === 'function' &&\n    !backend.validateModel(model)\n  ) {\n    throw new AgentRunError(\n      `Model \"${model}\" is not valid for backend ${backend.name}. ` +\n        `Accepted models: ${backend.models.join(', ')}`,\n      1,\n      opts.backend\n    );\n  }\n\n  return {\n    prompt,\n    model,\n    requestedModel: requestedModel ?? null,\n    configModel: backend.configModel ?? null,\n    maxOutputTokens: resolveOutputTokens(\n      callOpts?.maxOutputTokens,\n      model,\n      backend.maxOutputTokens\n    ),\n    systemPrompt: callOpts?.systemPrompt ?? opts.systemPrompt ?? null,\n    cwd: runtimePolicy?.workspace ?? callOpts?.cwd ?? opts.cwd ?? null,\n    timeoutMs: callOpts?.timeoutMs ?? opts.timeoutMs,\n    signal: callOpts?.signal,\n    mcpConfigPath: callOpts?.mcpConfigPath ?? opts.mcpConfigPath ?? null,\n    sessionId: sessionId ?? null,\n    isResume: isResume ?? false,\n    runtimePolicy: runtimePolicy ?? null,\n    env: mergedEnv,\n    tools: callOpts?.tools,\n    maxBudgetUsd: callOpts?.maxBudgetUsd,\n    effort: callOpts?.effort,\n    worktree: callOpts?.worktree ?? opts.worktree,\n    allowedTools: callOpts?.allowedTools,\n    disallowedTools: callOpts?.disallowedTools,\n    structuredHistory: callOpts?.structuredHistory,\n    systemPromptParts: callOpts?.systemPromptParts,\n    cache: callOpts?.cache,\n    cacheControl: callOpts?.cacheControl,\n    parts: callOpts?.parts,\n    readOnly: callOpts?.readOnly,\n    outputSchema: callOpts?.outputSchema,\n    appendSystemPrompt: callOpts?.appendSystemPrompt,\n    strictMcpConfig: callOpts?.strictMcpConfig,\n    excludeDynamicSystemPromptSections:\n      callOpts?.excludeDynamicSystemPromptSections,\n    isOrchestration: callOpts?.isOrchestration,\n  };\n}\n"],
+  "mappings": "AAKA,SAAS,qBAAqB;AAC9B,SAAS,2BAA2B;AAUpC,SAAS,oBACP,aACA,UACA,kBACoC;AACpC,MAAI,gBAAgB,kBAAmB,QAAO;AAC9C,QAAM,QAAQ,UAAU,cAAc;AACtC,MAAI,OAAO,UAAU,YAAY,SAAS,EAAG,QAAO;AACpD,SAAO,EAAE,gCAAgC,OAAO,KAAK,EAAE;AACzD;AAEO,SAAS,4BACd,MACA,SACA,QACA,UACA,WACA,UACA,eACmB;AACnB,QAAM,YAAY,KAAK;AACvB,QAAM,UAAU,UAAU;AAC1B,QAAM,gBAAgB;AAAA,IACpB,KAAK;AAAA,IACL;AAAA,IACA,KAAK;AAAA,EACP;AACA,QAAM,YACJ,aAAa,WAAW,gBACpB,EAAE,GAAI,iBAAiB,CAAC,GAAI,GAAI,aAAa,CAAC,GAAI,GAAI,WAAW,CAAC,EAAG,IACrE;AAIN,QAAM,iBAAiB,UAAU,SAAS,KAAK,SAAS;AACxD,QAAM,QAAQ,kBAAkB,QAAQ;AAExC,MACE,SACA,OAAO,QAAQ,kBAAkB,cACjC,CAAC,QAAQ,cAAc,KAAK,GAC5B;AACA,UAAM,IAAI;AAAA,MACR,UAAU,KAAK,8BAA8B,QAAQ,IAAI,sBACnC,QAAQ,OAAO,KAAK,IAAI,CAAC;AAAA,MAC/C;AAAA,MACA,KAAK;AAAA,IACP;AAAA,EACF;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,gBAAgB,kBAAkB;AAAA,IAClC,aAAa,QAAQ,eAAe;AAAA,IACpC,iBAAiB;AAAA,MACf,UAAU;AAAA,MACV;AAAA,MACA,QAAQ;AAAA,IACV;AAAA,IACA,cAAc,UAAU,gBAAgB,KAAK,gBAAgB;AAAA,IAC7D,KAAK,eAAe,aAAa,UAAU,OAAO,KAAK,OAAO;AAAA,IAC9D,WAAW,UAAU,aAAa,KAAK;AAAA,IACvC,QAAQ,UAAU;AAAA,IAClB,eAAe,UAAU,iBAAiB,KAAK,iBAAiB;AAAA,IAChE,WAAW,aAAa;AAAA,IACxB,UAAU,YAAY;AAAA,IACtB,eAAe,iBAAiB;AAAA,IAChC,KAAK;AAAA,IACL,OAAO,UAAU;AAAA,IACjB,cAAc,UAAU;AAAA,IACxB,QAAQ,UAAU;AAAA,IAClB,UAAU,UAAU,YAAY,KAAK;AAAA,IACrC,cAAc,UAAU;AAAA,IACxB,iBAAiB,UAAU;AAAA,IAC3B,mBAAmB,UAAU;AAAA,IAC7B,mBAAmB,UAAU;AAAA,IAC7B,OAAO,UAAU;AAAA,IACjB,cAAc,UAAU;AAAA,IACxB,OAAO,UAAU;AAAA,IACjB,UAAU,UAAU;AAAA,IACpB,cAAc,UAAU;AAAA,IACxB,oBAAoB,UAAU;AAAA,IAC9B,iBAAiB,UAAU;AAAA,IAC3B,oCACE,UAAU;AAAA,IACZ,iBAAiB,UAAU;AAAA,EAC7B;AACF;",
+  "names": []
+}

package/dist/adapters/agents/agent-client-plan.d.ts

@@ -0,0 +1,4 @@
+import type { prepareExecutionPlan } from '../../config/runtime.js';
+import { type ParsedEventCallback, type ProcessRunner, type RunExecutionResult } from './runtime/runner.js';
+export declare function runPreparedExecutionPlan(runner: ProcessRunner, prepared: ReturnType<typeof prepareExecutionPlan>, onEvent?: ParsedEventCallback, signal?: AbortSignal): Promise<RunExecutionResult>;
+//# sourceMappingURL=agent-client-plan.d.ts.map

package/dist/adapters/agents/agent-client-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-client-plan.d.ts","sourceRoot":"","sources":["../../../src/adapters/agents/agent-client-plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAEpE,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACxB,MAAM,qBAAqB,CAAC;AAE7B,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,EACjD,OAAO,CAAC,EAAE,mBAAmB,EAC7B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,kBAAkB,CAAC,CAgC7B"}

package/dist/adapters/agents/agent-client-plan.js

@@ -0,0 +1,38 @@
+import {
+  mergeFinalText
+} from "./runtime/runner.js";
+async function runPreparedExecutionPlan(runner, prepared, onEvent, signal) {
+  const plan = prepared.plan;
+  try {
+    if (!plan.execute) {
+      return await runner.run(plan, onEvent, signal);
+    }
+    const events = [];
+    let sessionId = null;
+    for await (const event of plan.execute({
+      signal,
+      env: plan.env,
+      cwd: plan.cwd,
+      timeoutMs: plan.timeoutMs
+    })) {
+      events.push(event);
+      if (event.sessionId) sessionId = event.sessionId;
+      if (onEvent) await onEvent(event);
+    }
+    if (!sessionId && plan.sessionId) sessionId = plan.sessionId;
+    return {
+      exitCode: 0,
+      stdout: "",
+      stderr: "",
+      events,
+      finalText: mergeFinalText(events),
+      sessionId
+    };
+  } finally {
+    await plan.cleanup?.();
+  }
+}
+export {
+  runPreparedExecutionPlan
+};
+//# sourceMappingURL=agent-client-plan.js.map

package/dist/adapters/agents/agent-client-plan.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/adapters/agents/agent-client-plan.ts"],
+  "sourcesContent": ["import type { prepareExecutionPlan } from '../../config/runtime.js';\nimport type { ParsedEvent } from '../../domain/contracts/messages.js';\nimport {\n  mergeFinalText,\n  type ParsedEventCallback,\n  type ProcessRunner,\n  type RunExecutionResult,\n} from './runtime/runner.js';\n\nexport async function runPreparedExecutionPlan(\n  runner: ProcessRunner,\n  prepared: ReturnType<typeof prepareExecutionPlan>,\n  onEvent?: ParsedEventCallback,\n  signal?: AbortSignal\n): Promise<RunExecutionResult> {\n  const plan = prepared.plan;\n  try {\n    if (!plan.execute) {\n      return await runner.run(plan, onEvent, signal);\n    }\n\n    const events: ParsedEvent[] = [];\n    let sessionId: string | null = null;\n    for await (const event of plan.execute({\n      signal,\n      env: plan.env,\n      cwd: plan.cwd,\n      timeoutMs: plan.timeoutMs,\n    })) {\n      events.push(event);\n      if (event.sessionId) sessionId = event.sessionId;\n      if (onEvent) await onEvent(event);\n    }\n\n    if (!sessionId && plan.sessionId) sessionId = plan.sessionId;\n    return {\n      exitCode: 0,\n      stdout: '',\n      stderr: '',\n      events,\n      finalText: mergeFinalText(events),\n      sessionId,\n    };\n  } finally {\n    await plan.cleanup?.();\n  }\n}\n"],
+  "mappings": "AAEA;AAAA,EACE;AAAA,OAIK;AAEP,eAAsB,yBACpB,QACA,UACA,SACA,QAC6B;AAC7B,QAAM,OAAO,SAAS;AACtB,MAAI;AACF,QAAI,CAAC,KAAK,SAAS;AACjB,aAAO,MAAM,OAAO,IAAI,MAAM,SAAS,MAAM;AAAA,IAC/C;AAEA,UAAM,SAAwB,CAAC;AAC/B,QAAI,YAA2B;AAC/B,qBAAiB,SAAS,KAAK,QAAQ;AAAA,MACrC;AAAA,MACA,KAAK,KAAK;AAAA,MACV,KAAK,KAAK;AAAA,MACV,WAAW,KAAK;AAAA,IAClB,CAAC,GAAG;AACF,aAAO,KAAK,KAAK;AACjB,UAAI,MAAM,UAAW,aAAY,MAAM;AACvC,UAAI,QAAS,OAAM,QAAQ,KAAK;AAAA,IAClC;AAEA,QAAI,CAAC,aAAa,KAAK,UAAW,aAAY,KAAK;AACnD,WAAO;AAAA,MACL,UAAU;AAAA,MACV,QAAQ;AAAA,MACR,QAAQ;AAAA,MACR;AAAA,MACA,WAAW,eAAe,MAAM;AAAA,MAChC;AAAA,IACF;AAAA,EACF,UAAE;AACA,UAAM,KAAK,UAAU;AAAA,EACvB;AACF;",
+  "names": []
+}

package/dist/adapters/agents/agent-client.d.ts

@@ -0,0 +1,73 @@
+import type { Backend, BackendCapabilities, BackendRunRequest } from '../../domain/contracts/backends.js';
+import type { AgentClientOptions, Client, RunOptions, RunResult, SessionOptions, StreamCallback } from '../../domain/core-client.js';
+import type { BackendInfo } from '../../domain/protocol.js';
+import { AgentSession } from './agent-session.js';
+import type { BackendRunOptions } from './internal-run-options.js';
+/**
+ * Generic client for any supported backend.
+ * Concrete subclasses (ClaudeCodeClient, CodexClient, …) pre-fill `backend`.
+ */
+export declare class AgentClient implements Client {
+    protected readonly opts: AgentClientOptions;
+    protected _backend?: Backend;
+    private _installChecked;
+    private readonly _runner;
+    constructor(opts: AgentClientOptions);
+    private get runner();
+    private isConfigurableBuiltInBackend;
+    private resolveBackend;
+    private withRetry;
+    private executePreparedPlan;
+    private prepareBackendRun;
+    /**
+     * Run a prompt to completion and return the result.
+     *
+     * @example
+     * const { text } = await client.run('Write hello world in Python');
+     */
+    run(prompt: string, opts?: RunOptions): Promise<RunResult>;
+    /**
+     * Run a prompt and receive events in real time.
+     *
+     * @example
+     * await client.stream('Explain quantum computing', (e) => {
+     *   if (e.type === 'text') process.stdout.write(e.text ?? '');
+     * });
+     */
+    stream(prompt: string, onEvent: StreamCallback, opts?: RunOptions): Promise<RunResult>;
+    /**
+     * Create a stateful session for multi-turn conversation.
+     * Pass `{ resumeFrom: savedId }` to restore a previously saved session.
+     *
+     * @example
+     * const s = client.session();
+     * await s.send('What is 2+2?');
+     * await s.send('Multiply by 3');
+     *
+     * @example
+     * const resumed = client.session({ resumeFrom: savedId });
+     * await resumed.send('Continue'); // isResume=true
+     */
+    session(opts?: SessionOptions): AgentSession;
+    /** Return true if the backend CLI/API is ready. Never throws. */
+    isReady(): Promise<boolean>;
+    /** Return the CLI version string, or null. */
+    getVersion(): Promise<string | null>;
+    /**
+     * : self-describing snapshot of the resolved backend. Forces backend
+     * resolution (triggers install check unless `skipInstallCheck` is set) and
+     * then delegates to `backend.info()`.
+     */
+    info(): Promise<BackendInfo>;
+    /**
+     * @internal
+     * Resolved backend capabilities. Forces backend resolution on first call,
+     * then returns the cached value. Used by `AgentSession` to decide whether
+     * to replay accumulated history on stateless API backends.
+     */
+    _capabilities(): Promise<BackendCapabilities>;
+    /** @internal */
+    _runWithSession(prompt: string, sessionId: string | null, isResume: boolean, onEvent?: StreamCallback, opts?: BackendRunOptions): Promise<RunResult>;
+    protected buildRequest(backend: Backend, prompt: string, callOpts?: BackendRunOptions, sessionId?: string | null, isResume?: boolean, runtimePolicy?: BackendRunRequest['runtimePolicy']): BackendRunRequest;
+}
+//# sourceMappingURL=agent-client.d.ts.map

package/dist/adapters/agents/agent-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-client.d.ts","sourceRoot":"","sources":["../../../src/adapters/agents/agent-client.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,OAAO,EACP,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,KAAK,EACV,kBAAkB,EAClB,MAAM,EACN,UAAU,EACV,SAAS,EACT,cAAc,EACd,cAAc,EACf,MAAM,6BAA6B,CAAC;AAKrC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAO5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKlD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAKnE;;;GAGG;AACH,qBAAa,WAAY,YAAW,MAAM;IACxC,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAC5C,SAAS,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC7B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgD;gBAE5D,IAAI,EAAE,kBAAkB;IAKpC,OAAO,KAAK,MAAM,GAEjB;IAED,OAAO,CAAC,4BAA4B;YAUtB,cAAc;IAkD5B,OAAO,CAAC,SAAS;YAkBH,mBAAmB;YAQnB,iBAAiB;IA8D/B;;;;;OAKG;IACG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IAmChE;;;;;;;OAOG;IACG,MAAM,CACV,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,cAAc,EACvB,IAAI,CAAC,EAAE,UAAU,GAChB,OAAO,CAAC,SAAS,CAAC;IA6BrB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,IAAI,CAAC,EAAE,cAAc,GAAG,YAAY;IAI5C,iEAAiE;IAC3D,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IASjC,8CAA8C;IACxC,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAK1C;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC;IAIlC;;;;;OAKG;IACG,aAAa,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAKnD,gBAAgB;IACV,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,QAAQ,EAAE,OAAO,EACjB,OAAO,CAAC,EAAE,cAAc,EACxB,IAAI,CAAC,EAAE,iBAAiB,GACvB,OAAO,CAAC,SAAS,CAAC;IAqCrB,SAAS,CAAC,YAAY,CACpB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,iBAAiB,EAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,EACzB,QAAQ,CAAC,EAAE,OAAO,EAClB,aAAa,CAAC,EAAE,iBAAiB,CAAC,eAAe,CAAC,GACjD,iBAAiB;CAWrB"}

package/dist/adapters/agents/agent-client.js

@@ -0,0 +1,314 @@
+import {
+  prepareExecutionPlan,
+  resolveContextPolicy,
+  toExecutionRuntimePolicy
+} from "../../config/runtime.js";
+import {
+  AgentRunError,
+  BackendNotAvailableError
+} from "../../domain/errors/index.js";
+import { resolveManagedWorktree } from "../../runtime/isolation/managed-worktree.js";
+import { API_KEY_ENV, HOST_CONFIG_KEY } from "../../utils/api-keys.js";
+import { withRetry } from "../../utils/retry.js";
+import { buildAgentBackendRunRequest } from "./agent-client-helpers.js";
+import { runPreparedExecutionPlan } from "./agent-client-plan.js";
+import { toRunResult } from "./agent-run-result.js";
+import { AgentSession } from "./agent-session.js";
+import {
+  createBuiltInBackends
+} from "./backends/index.js";
+import {
+  createDefaultProcessRunner
+} from "./runtime/runner.js";
+class AgentClient {
+  opts;
+  _backend;
+  _installChecked = false;
+  _runner;
+  constructor(opts) {
+    this.opts = opts;
+    this._runner = opts.runner ?? createDefaultProcessRunner();
+  }
+  get runner() {
+    return this._runner;
+  }
+  isConfigurableBuiltInBackend(backend) {
+    return backend === "anthropic-api" || backend === "gemini-api" || backend === "openai-api" || backend === "ollama";
+  }
+  async resolveBackend() {
+    if (this._backend) return this._backend;
+    const envKey = API_KEY_ENV[this.opts.backend];
+    const hostKey = HOST_CONFIG_KEY[this.opts.backend];
+    const backendConfig = {};
+    if (this.isConfigurableBuiltInBackend(this.opts.backend) && (envKey && this.opts.apiKey || hostKey && this.opts.host || this.opts.headers)) {
+      backendConfig[this.opts.backend] = {
+        ...envKey && this.opts.apiKey ? { [envKey]: this.opts.apiKey } : {},
+        ...hostKey && this.opts.host ? { [hostKey]: this.opts.host } : {},
+        ...this.opts.headers ? { EXTRA_HEADERS: this.opts.headers } : {}
+      };
+    }
+    if (this.opts.backend === "acp-cli" && this.opts.onAcpElicitation) {
+      backendConfig["acp-cli"] = {
+        ...backendConfig["acp-cli"],
+        onElicitation: this.opts.onAcpElicitation
+      };
+    }
+    const registry = createBuiltInBackends(backendConfig);
+    const backend = registry.get(this.opts.backend);
+    if (!backend) {
+      throw new BackendNotAvailableError(
+        this.opts.backend,
+        "unknown backend name"
+      );
+    }
+    if (!this.opts.skipInstallCheck && !this._installChecked) {
+      const installed = await backend.isInstalled();
+      if (!installed) {
+        throw new BackendNotAvailableError(
+          this.opts.backend,
+          envKey ? `set the ${envKey} environment variable or pass apiKey to the constructor` : `install the CLI first`
+        );
+      }
+      this._installChecked = true;
+    }
+    this._backend = backend;
+    return backend;
+  }
+  withRetry(fn, retries, options) {
+    return withRetry(fn, {
+      retries,
+      backend: this.opts.backend,
+      phase: options.phase,
+      onError: options.onError,
+      onRetry: options.onRetry
+    });
+  }
+  async executePreparedPlan(prepared, onEvent, signal) {
+    return runPreparedExecutionPlan(this.runner, prepared, onEvent, signal);
+  }
+  async prepareBackendRun(backend, prompt, opts, sessionId, isResume) {
+    const context = resolveContextPolicy({
+      approvalMode: opts?.approvalMode ?? this.opts.approvalMode,
+      config: this.opts.config,
+      cwd: opts?.cwd ?? this.opts.cwd,
+      profile: opts?.profile ?? this.opts.profile
+    });
+    const requestedWorktree = opts?.worktree ?? this.opts.worktree;
+    const managedWorktree = await resolveManagedWorktree({
+      workspace: context.workspace,
+      worktree: requestedWorktree,
+      sessionId
+    });
+    const effectiveContext = managedWorktree.managed ? resolveContextPolicy({
+      approvalMode: context.approvalMode,
+      config: this.opts.config,
+      cwd: managedWorktree.workspace,
+      profile: context.profile
+    }) : context;
+    const requestOpts = managedWorktree.managed ? { ...opts, cwd: managedWorktree.workspace, worktree: void 0 } : opts;
+    const request = this.buildRequest(
+      backend,
+      prompt,
+      requestOpts,
+      sessionId,
+      isResume,
+      toExecutionRuntimePolicy(effectiveContext, this.opts.backend)
+    );
+    const prepared = prepareExecutionPlan(
+      this.opts.backend,
+      backend.buildExecutionPlan(request),
+      {
+        approvalMode: effectiveContext.approvalMode,
+        config: this.opts.config,
+        cwd: effectiveContext.workspace,
+        profile: effectiveContext.profile
+      }
+    );
+    if (managedWorktree.cleanup) {
+      const backendCleanup = prepared.plan.cleanup;
+      prepared.plan.cleanup = async () => {
+        try {
+          await backendCleanup?.();
+        } finally {
+          await managedWorktree.cleanup?.();
+        }
+      };
+    }
+    return prepared;
+  }
+  /**
+   * Run a prompt to completion and return the result.
+   *
+   * @example
+   * const { text } = await client.run('Write hello world in Python');
+   */
+  async run(prompt, opts) {
+    const retries = opts?.retries ?? this.opts.retries ?? 0;
+    return this.withRetry(
+      async () => {
+        const backend = await this.resolveBackend();
+        const prepared = await this.prepareBackendRun(backend, prompt, opts);
+        const raw = await this.executePreparedPlan(
+          prepared,
+          void 0,
+          opts?.signal
+        );
+        const result = toRunResult(
+          raw,
+          this.opts.backend,
+          prepared.metadata,
+          opts?.model ?? this.opts.model ?? backend.defaultModel
+        );
+        if (result.exitCode !== 0 && raw.events.some((e) => e.isError)) {
+          throw new AgentRunError(
+            result.text,
+            result.exitCode,
+            this.opts.backend
+          );
+        }
+        return result;
+      },
+      retries,
+      {
+        phase: "run",
+        onError: opts?.onError,
+        onRetry: opts?.onRetry
+      }
+    );
+  }
+  /**
+   * Run a prompt and receive events in real time.
+   *
+   * @example
+   * await client.stream('Explain quantum computing', (e) => {
+   *   if (e.type === 'text') process.stdout.write(e.text ?? '');
+   * });
+   */
+  async stream(prompt, onEvent, opts) {
+    const retries = opts?.retries ?? this.opts.retries ?? 0;
+    return this.withRetry(
+      async () => {
+        const backend = await this.resolveBackend();
+        const prepared = await this.prepareBackendRun(backend, prompt, opts);
+        const raw = await this.executePreparedPlan(
+          prepared,
+          async (e) => {
+            await onEvent(e);
+          },
+          opts?.signal
+        );
+        return toRunResult(
+          raw,
+          this.opts.backend,
+          prepared.metadata,
+          opts?.model ?? this.opts.model ?? backend.defaultModel
+        );
+      },
+      retries,
+      {
+        phase: "stream",
+        onError: opts?.onError,
+        onRetry: opts?.onRetry
+      }
+    );
+  }
+  /**
+   * Create a stateful session for multi-turn conversation.
+   * Pass `{ resumeFrom: savedId }` to restore a previously saved session.
+   *
+   * @example
+   * const s = client.session();
+   * await s.send('What is 2+2?');
+   * await s.send('Multiply by 3');
+   *
+   * @example
+   * const resumed = client.session({ resumeFrom: savedId });
+   * await resumed.send('Continue'); // isResume=true
+   */
+  session(opts) {
+    return new AgentSession(this, opts);
+  }
+  /** Return true if the backend CLI/API is ready. Never throws. */
+  async isReady() {
+    try {
+      const backend = await this.resolveBackend();
+      return backend.isInstalled();
+    } catch {
+      return false;
+    }
+  }
+  /** Return the CLI version string, or null. */
+  async getVersion() {
+    const backend = await this.resolveBackend();
+    return backend.getVersion();
+  }
+  /**
+   * : self-describing snapshot of the resolved backend. Forces backend
+   * resolution (triggers install check unless `skipInstallCheck` is set) and
+   * then delegates to `backend.info()`.
+   */
+  async info() {
+    const backend = await this.resolveBackend();
+    return backend.info();
+  }
+  /**
+   * @internal
+   * Resolved backend capabilities. Forces backend resolution on first call,
+   * then returns the cached value. Used by `AgentSession` to decide whether
+   * to replay accumulated history on stateless API backends.
+   */
+  async _capabilities() {
+    const backend = await this.resolveBackend();
+    return backend.capabilities;
+  }
+  /** @internal */
+  async _runWithSession(prompt, sessionId, isResume, onEvent, opts) {
+    const retries = opts?.retries ?? this.opts.retries ?? 0;
+    return this.withRetry(
+      async () => {
+        const backend = await this.resolveBackend();
+        const prepared = await this.prepareBackendRun(
+          backend,
+          prompt,
+          opts,
+          sessionId,
+          isResume
+        );
+        const raw = await this.executePreparedPlan(
+          prepared,
+          onEvent ? async (e) => {
+            await onEvent(e);
+          } : void 0,
+          opts?.signal
+        );
+        return toRunResult(
+          raw,
+          this.opts.backend,
+          prepared.metadata,
+          opts?.model ?? this.opts.model ?? backend.defaultModel
+        );
+      },
+      retries,
+      {
+        phase: "session",
+        onError: opts?.onError,
+        onRetry: opts?.onRetry
+      }
+    );
+  }
+  buildRequest(backend, prompt, callOpts, sessionId, isResume, runtimePolicy) {
+    return buildAgentBackendRunRequest(
+      this.opts,
+      backend,
+      prompt,
+      callOpts,
+      sessionId,
+      isResume,
+      runtimePolicy
+    );
+  }
+}
+export {
+  AgentClient
+};
+//# sourceMappingURL=agent-client.js.map

package/dist/adapters/agents/agent-client.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/adapters/agents/agent-client.ts"],
+  "sourcesContent": ["import {\n  prepareExecutionPlan,\n  resolveContextPolicy,\n  toExecutionRuntimePolicy,\n} from '../../config/runtime.js';\nimport type {\n  Backend,\n  BackendCapabilities,\n  BackendRunRequest,\n} from '../../domain/contracts/backends.js';\nimport type { ParsedEvent } from '../../domain/contracts/messages.js';\nimport type {\n  AgentClientOptions,\n  Client,\n  RunOptions,\n  RunResult,\n  SessionOptions,\n  StreamCallback,\n} from '../../domain/core-client.js';\nimport {\n  AgentRunError,\n  BackendNotAvailableError,\n} from '../../domain/errors/index.js';\nimport type { BackendInfo } from '../../domain/protocol.js';\nimport { resolveManagedWorktree } from '../../runtime/isolation/managed-worktree.js';\nimport { API_KEY_ENV, HOST_CONFIG_KEY } from '../../utils/api-keys.js';\nimport { withRetry } from '../../utils/retry.js';\nimport { buildAgentBackendRunRequest } from './agent-client-helpers.js';\nimport { runPreparedExecutionPlan } from './agent-client-plan.js';\nimport { toRunResult } from './agent-run-result.js';\nimport { AgentSession } from './agent-session.js';\nimport {\n  type BuiltInBackendConfigMap,\n  createBuiltInBackends,\n} from './backends/index.js';\nimport type { BackendRunOptions } from './internal-run-options.js';\nimport {\n  createDefaultProcessRunner,\n  type RunExecutionResult,\n} from './runtime/runner.js';\n/**\n * Generic client for any supported backend.\n * Concrete subclasses (ClaudeCodeClient, CodexClient, \u2026) pre-fill `backend`.\n */\nexport class AgentClient implements Client {\n  protected readonly opts: AgentClientOptions;\n  protected _backend?: Backend;\n  private _installChecked = false;\n  private readonly _runner: ReturnType<typeof createDefaultProcessRunner>;\n\n  constructor(opts: AgentClientOptions) {\n    this.opts = opts;\n    this._runner = opts.runner ?? createDefaultProcessRunner();\n  }\n\n  private get runner() {\n    return this._runner;\n  }\n\n  private isConfigurableBuiltInBackend(\n    backend: AgentClientOptions['backend']\n  ): backend is keyof BuiltInBackendConfigMap {\n    return (\n      backend === 'anthropic-api' ||\n      backend === 'gemini-api' ||\n      backend === 'openai-api' ||\n      backend === 'ollama'\n    );\n  }\n  private async resolveBackend(): Promise<Backend> {\n    if (this._backend) return this._backend;\n\n    const envKey = API_KEY_ENV[this.opts.backend];\n    const hostKey = HOST_CONFIG_KEY[this.opts.backend];\n    const backendConfig: BuiltInBackendConfigMap = {};\n    if (\n      this.isConfigurableBuiltInBackend(this.opts.backend) &&\n      ((envKey && this.opts.apiKey) ||\n        (hostKey && this.opts.host) ||\n        this.opts.headers)\n    ) {\n      backendConfig[this.opts.backend] = {\n        ...(envKey && this.opts.apiKey ? { [envKey]: this.opts.apiKey } : {}),\n        ...(hostKey && this.opts.host ? { [hostKey]: this.opts.host } : {}),\n        ...(this.opts.headers ? { EXTRA_HEADERS: this.opts.headers } : {}),\n      };\n    }\n    if (this.opts.backend === 'acp-cli' && this.opts.onAcpElicitation) {\n      backendConfig['acp-cli'] = {\n        ...backendConfig['acp-cli'],\n        onElicitation: this.opts.onAcpElicitation,\n      };\n    }\n\n    const registry = createBuiltInBackends(backendConfig);\n    const backend = registry.get(this.opts.backend);\n    if (!backend) {\n      throw new BackendNotAvailableError(\n        this.opts.backend,\n        'unknown backend name'\n      );\n    }\n\n    if (!this.opts.skipInstallCheck && !this._installChecked) {\n      const installed = await backend.isInstalled();\n      if (!installed) {\n        throw new BackendNotAvailableError(\n          this.opts.backend,\n          envKey\n            ? `set the ${envKey} environment variable or pass apiKey to the constructor`\n            : `install the CLI first`\n        );\n      }\n      this._installChecked = true;\n    }\n\n    this._backend = backend;\n    return backend;\n  }\n  private withRetry<T>(\n    fn: () => Promise<T>,\n    retries: number,\n    options: {\n      onError?: RunOptions['onError'];\n      onRetry?: RunOptions['onRetry'];\n      phase: 'run' | 'stream' | 'session';\n    }\n  ): Promise<T> {\n    return withRetry(fn, {\n      retries,\n      backend: this.opts.backend,\n      phase: options.phase,\n      onError: options.onError,\n      onRetry: options.onRetry,\n    });\n  }\n\n  private async executePreparedPlan(\n    prepared: ReturnType<typeof prepareExecutionPlan>,\n    onEvent?: (event: ParsedEvent) => void | Promise<void>,\n    signal?: AbortSignal\n  ): Promise<RunExecutionResult> {\n    return runPreparedExecutionPlan(this.runner, prepared, onEvent, signal);\n  }\n\n  private async prepareBackendRun(\n    backend: Backend,\n    prompt: string,\n    opts?: BackendRunOptions,\n    sessionId?: string | null,\n    isResume?: boolean\n  ): Promise<ReturnType<typeof prepareExecutionPlan>> {\n    const context = resolveContextPolicy({\n      approvalMode: opts?.approvalMode ?? this.opts.approvalMode,\n      config: this.opts.config,\n      cwd: opts?.cwd ?? this.opts.cwd,\n      profile: opts?.profile ?? this.opts.profile,\n    });\n    const requestedWorktree = opts?.worktree ?? this.opts.worktree;\n    const managedWorktree = await resolveManagedWorktree({\n      workspace: context.workspace,\n      worktree: requestedWorktree,\n      sessionId,\n    });\n    const effectiveContext = managedWorktree.managed\n      ? resolveContextPolicy({\n          approvalMode: context.approvalMode,\n          config: this.opts.config,\n          cwd: managedWorktree.workspace,\n          profile: context.profile,\n        })\n      : context;\n    const requestOpts = managedWorktree.managed\n      ? ({ ...opts, cwd: managedWorktree.workspace, worktree: undefined } as\n          | BackendRunOptions\n          | undefined)\n      : opts;\n    const request = this.buildRequest(\n      backend,\n      prompt,\n      requestOpts,\n      sessionId,\n      isResume,\n      toExecutionRuntimePolicy(effectiveContext, this.opts.backend)\n    );\n    const prepared = prepareExecutionPlan(\n      this.opts.backend,\n      backend.buildExecutionPlan(request),\n      {\n        approvalMode: effectiveContext.approvalMode,\n        config: this.opts.config,\n        cwd: effectiveContext.workspace,\n        profile: effectiveContext.profile,\n      }\n    );\n    if (managedWorktree.cleanup) {\n      const backendCleanup = prepared.plan.cleanup;\n      prepared.plan.cleanup = async () => {\n        try {\n          await backendCleanup?.();\n        } finally {\n          await managedWorktree.cleanup?.();\n        }\n      };\n    }\n    return prepared;\n  }\n  /**\n   * Run a prompt to completion and return the result.\n   *\n   * @example\n   * const { text } = await client.run('Write hello world in Python');\n   */\n  async run(prompt: string, opts?: RunOptions): Promise<RunResult> {\n    const retries = opts?.retries ?? this.opts.retries ?? 0;\n    return this.withRetry(\n      async () => {\n        const backend = await this.resolveBackend();\n        const prepared = await this.prepareBackendRun(backend, prompt, opts);\n        const raw = await this.executePreparedPlan(\n          prepared,\n          undefined,\n          opts?.signal\n        );\n        const result = toRunResult(\n          raw,\n          this.opts.backend,\n          prepared.metadata,\n          opts?.model ?? this.opts.model ?? backend.defaultModel\n        );\n        if (result.exitCode !== 0 && raw.events.some((e) => e.isError)) {\n          throw new AgentRunError(\n            result.text,\n            result.exitCode,\n            this.opts.backend\n          );\n        }\n        return result;\n      },\n      retries,\n      {\n        phase: 'run',\n        onError: opts?.onError,\n        onRetry: opts?.onRetry,\n      }\n    );\n  }\n\n  /**\n   * Run a prompt and receive events in real time.\n   *\n   * @example\n   * await client.stream('Explain quantum computing', (e) => {\n   *   if (e.type === 'text') process.stdout.write(e.text ?? '');\n   * });\n   */\n  async stream(\n    prompt: string,\n    onEvent: StreamCallback,\n    opts?: RunOptions\n  ): Promise<RunResult> {\n    const retries = opts?.retries ?? this.opts.retries ?? 0;\n    return this.withRetry(\n      async () => {\n        const backend = await this.resolveBackend();\n        const prepared = await this.prepareBackendRun(backend, prompt, opts);\n        const raw = await this.executePreparedPlan(\n          prepared,\n          async (e) => {\n            await onEvent(e);\n          },\n          opts?.signal\n        );\n        return toRunResult(\n          raw,\n          this.opts.backend,\n          prepared.metadata,\n          opts?.model ?? this.opts.model ?? backend.defaultModel\n        );\n      },\n      retries,\n      {\n        phase: 'stream',\n        onError: opts?.onError,\n        onRetry: opts?.onRetry,\n      }\n    );\n  }\n\n  /**\n   * Create a stateful session for multi-turn conversation.\n   * Pass `{ resumeFrom: savedId }` to restore a previously saved session.\n   *\n   * @example\n   * const s = client.session();\n   * await s.send('What is 2+2?');\n   * await s.send('Multiply by 3');\n   *\n   * @example\n   * const resumed = client.session({ resumeFrom: savedId });\n   * await resumed.send('Continue'); // isResume=true\n   */\n  session(opts?: SessionOptions): AgentSession {\n    return new AgentSession(this, opts);\n  }\n\n  /** Return true if the backend CLI/API is ready. Never throws. */\n  async isReady(): Promise<boolean> {\n    try {\n      const backend = await this.resolveBackend();\n      return backend.isInstalled();\n    } catch {\n      return false;\n    }\n  }\n\n  /** Return the CLI version string, or null. */\n  async getVersion(): Promise<string | null> {\n    const backend = await this.resolveBackend();\n    return backend.getVersion();\n  }\n\n  /**\n   * : self-describing snapshot of the resolved backend. Forces backend\n   * resolution (triggers install check unless `skipInstallCheck` is set) and\n   * then delegates to `backend.info()`.\n   */\n  async info(): Promise<BackendInfo> {\n    const backend = await this.resolveBackend();\n    return backend.info();\n  }\n  /**\n   * @internal\n   * Resolved backend capabilities. Forces backend resolution on first call,\n   * then returns the cached value. Used by `AgentSession` to decide whether\n   * to replay accumulated history on stateless API backends.\n   */\n  async _capabilities(): Promise<BackendCapabilities> {\n    const backend = await this.resolveBackend();\n    return backend.capabilities;\n  }\n\n  /** @internal */\n  async _runWithSession(\n    prompt: string,\n    sessionId: string | null,\n    isResume: boolean,\n    onEvent?: StreamCallback,\n    opts?: BackendRunOptions\n  ): Promise<RunResult> {\n    const retries = opts?.retries ?? this.opts.retries ?? 0;\n    return this.withRetry(\n      async () => {\n        const backend = await this.resolveBackend();\n        const prepared = await this.prepareBackendRun(\n          backend,\n          prompt,\n          opts,\n          sessionId,\n          isResume\n        );\n        const raw = await this.executePreparedPlan(\n          prepared,\n          onEvent\n            ? async (e) => {\n                await onEvent(e);\n              }\n            : undefined,\n          opts?.signal\n        );\n        return toRunResult(\n          raw,\n          this.opts.backend,\n          prepared.metadata,\n          opts?.model ?? this.opts.model ?? backend.defaultModel\n        );\n      },\n      retries,\n      {\n        phase: 'session',\n        onError: opts?.onError,\n        onRetry: opts?.onRetry,\n      }\n    );\n  }\n\n  protected buildRequest(\n    backend: Backend,\n    prompt: string,\n    callOpts?: BackendRunOptions,\n    sessionId?: string | null,\n    isResume?: boolean,\n    runtimePolicy?: BackendRunRequest['runtimePolicy']\n  ): BackendRunRequest {\n    return buildAgentBackendRunRequest(\n      this.opts,\n      backend,\n      prompt,\n      callOpts,\n      sessionId,\n      isResume,\n      runtimePolicy\n    );\n  }\n}\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAeP;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAEP,SAAS,8BAA8B;AACvC,SAAS,aAAa,uBAAuB;AAC7C,SAAS,iBAAiB;AAC1B,SAAS,mCAAmC;AAC5C,SAAS,gCAAgC;AACzC,SAAS,mBAAmB;AAC5B,SAAS,oBAAoB;AAC7B;AAAA,EAEE;AAAA,OACK;AAEP;AAAA,EACE;AAAA,OAEK;AAKA,MAAM,YAA8B;AAAA,EACtB;AAAA,EACT;AAAA,EACF,kBAAkB;AAAA,EACT;AAAA,EAEjB,YAAY,MAA0B;AACpC,SAAK,OAAO;AACZ,SAAK,UAAU,KAAK,UAAU,2BAA2B;AAAA,EAC3D;AAAA,EAEA,IAAY,SAAS;AACnB,WAAO,KAAK;AAAA,EACd;AAAA,EAEQ,6BACN,SAC0C;AAC1C,WACE,YAAY,mBACZ,YAAY,gBACZ,YAAY,gBACZ,YAAY;AAAA,EAEhB;AAAA,EACA,MAAc,iBAAmC;AAC/C,QAAI,KAAK,SAAU,QAAO,KAAK;AAE/B,UAAM,SAAS,YAAY,KAAK,KAAK,OAAO;AAC5C,UAAM,UAAU,gBAAgB,KAAK,KAAK,OAAO;AACjD,UAAM,gBAAyC,CAAC;AAChD,QACE,KAAK,6BAA6B,KAAK,KAAK,OAAO,MACjD,UAAU,KAAK,KAAK,UACnB,WAAW,KAAK,KAAK,QACtB,KAAK,KAAK,UACZ;AACA,oBAAc,KAAK,KAAK,OAAO,IAAI;AAAA,QACjC,GAAI,UAAU,KAAK,KAAK,SAAS,EAAE,CAAC,MAAM,GAAG,KAAK,KAAK,OAAO,IAAI,CAAC;AAAA,QACnE,GAAI,WAAW,KAAK,KAAK,OAAO,EAAE,CAAC,OAAO,GAAG,KAAK,KAAK,KAAK,IAAI,CAAC;AAAA,QACjE,GAAI,KAAK,KAAK,UAAU,EAAE,eAAe,KAAK,KAAK,QAAQ,IAAI,CAAC;AAAA,MAClE;AAAA,IACF;AACA,QAAI,KAAK,KAAK,YAAY,aAAa,KAAK,KAAK,kBAAkB;AACjE,oBAAc,SAAS,IAAI;AAAA,QACzB,GAAG,cAAc,SAAS;AAAA,QAC1B,eAAe,KAAK,KAAK;AAAA,MAC3B;AAAA,IACF;AAEA,UAAM,WAAW,sBAAsB,aAAa;AACpD,UAAM,UAAU,SAAS,IAAI,KAAK,KAAK,OAAO;AAC9C,QAAI,CAAC,SAAS;AACZ,YAAM,IAAI;AAAA,QACR,KAAK,KAAK;AAAA,QACV;AAAA,MACF;AAAA,IACF;AAEA,QAAI,CAAC,KAAK,KAAK,oBAAoB,CAAC,KAAK,iBAAiB;AACxD,YAAM,YAAY,MAAM,QAAQ,YAAY;AAC5C,UAAI,CAAC,WAAW;AACd,cAAM,IAAI;AAAA,UACR,KAAK,KAAK;AAAA,UACV,SACI,WAAW,MAAM,4DACjB;AAAA,QACN;AAAA,MACF;AACA,WAAK,kBAAkB;AAAA,IACzB;AAEA,SAAK,WAAW;AAChB,WAAO;AAAA,EACT;AAAA,EACQ,UACN,IACA,SACA,SAKY;AACZ,WAAO,UAAU,IAAI;AAAA,MACnB;AAAA,MACA,SAAS,KAAK,KAAK;AAAA,MACnB,OAAO,QAAQ;AAAA,MACf,SAAS,QAAQ;AAAA,MACjB,SAAS,QAAQ;AAAA,IACnB,CAAC;AAAA,EACH;AAAA,EAEA,MAAc,oBACZ,UACA,SACA,QAC6B;AAC7B,WAAO,yBAAyB,KAAK,QAAQ,UAAU,SAAS,MAAM;AAAA,EACxE;AAAA,EAEA,MAAc,kBACZ,SACA,QACA,MACA,WACA,UACkD;AAClD,UAAM,UAAU,qBAAqB;AAAA,MACnC,cAAc,MAAM,gBAAgB,KAAK,KAAK;AAAA,MAC9C,QAAQ,KAAK,KAAK;AAAA,MAClB,KAAK,MAAM,OAAO,KAAK,KAAK;AAAA,MAC5B,SAAS,MAAM,WAAW,KAAK,KAAK;AAAA,IACtC,CAAC;AACD,UAAM,oBAAoB,MAAM,YAAY,KAAK,KAAK;AACtD,UAAM,kBAAkB,MAAM,uBAAuB;AAAA,MACnD,WAAW,QAAQ;AAAA,MACnB,UAAU;AAAA,MACV;AAAA,IACF,CAAC;AACD,UAAM,mBAAmB,gBAAgB,UACrC,qBAAqB;AAAA,MACnB,cAAc,QAAQ;AAAA,MACtB,QAAQ,KAAK,KAAK;AAAA,MAClB,KAAK,gBAAgB;AAAA,MACrB,SAAS,QAAQ;AAAA,IACnB,CAAC,IACD;AACJ,UAAM,cAAc,gBAAgB,UAC/B,EAAE,GAAG,MAAM,KAAK,gBAAgB,WAAW,UAAU,OAAU,IAGhE;AACJ,UAAM,UAAU,KAAK;AAAA,MACnB;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,yBAAyB,kBAAkB,KAAK,KAAK,OAAO;AAAA,IAC9D;AACA,UAAM,WAAW;AAAA,MACf,KAAK,KAAK;AAAA,MACV,QAAQ,mBAAmB,OAAO;AAAA,MAClC;AAAA,QACE,cAAc,iBAAiB;AAAA,QAC/B,QAAQ,KAAK,KAAK;AAAA,QAClB,KAAK,iBAAiB;AAAA,QACtB,SAAS,iBAAiB;AAAA,MAC5B;AAAA,IACF;AACA,QAAI,gBAAgB,SAAS;AAC3B,YAAM,iBAAiB,SAAS,KAAK;AACrC,eAAS,KAAK,UAAU,YAAY;AAClC,YAAI;AACF,gBAAM,iBAAiB;AAAA,QACzB,UAAE;AACA,gBAAM,gBAAgB,UAAU;AAAA,QAClC;AAAA,MACF;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,IAAI,QAAgB,MAAuC;AAC/D,UAAM,UAAU,MAAM,WAAW,KAAK,KAAK,WAAW;AACtD,WAAO,KAAK;AAAA,MACV,YAAY;AACV,cAAM,UAAU,MAAM,KAAK,eAAe;AAC1C,cAAM,WAAW,MAAM,KAAK,kBAAkB,SAAS,QAAQ,IAAI;AACnE,cAAM,MAAM,MAAM,KAAK;AAAA,UACrB;AAAA,UACA;AAAA,UACA,MAAM;AAAA,QACR;AACA,cAAM,SAAS;AAAA,UACb;AAAA,UACA,KAAK,KAAK;AAAA,UACV,SAAS;AAAA,UACT,MAAM,SAAS,KAAK,KAAK,SAAS,QAAQ;AAAA,QAC5C;AACA,YAAI,OAAO,aAAa,KAAK,IAAI,OAAO,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG;AAC9D,gBAAM,IAAI;AAAA,YACR,OAAO;AAAA,YACP,OAAO;AAAA,YACP,KAAK,KAAK;AAAA,UACZ;AAAA,QACF;AACA,eAAO;AAAA,MACT;AAAA,MACA;AAAA,MACA;AAAA,QACE,OAAO;AAAA,QACP,SAAS,MAAM;AAAA,QACf,SAAS,MAAM;AAAA,MACjB;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,OACJ,QACA,SACA,MACoB;AACpB,UAAM,UAAU,MAAM,WAAW,KAAK,KAAK,WAAW;AACtD,WAAO,KAAK;AAAA,MACV,YAAY;AACV,cAAM,UAAU,MAAM,KAAK,eAAe;AAC1C,cAAM,WAAW,MAAM,KAAK,kBAAkB,SAAS,QAAQ,IAAI;AACnE,cAAM,MAAM,MAAM,KAAK;AAAA,UACrB;AAAA,UACA,OAAO,MAAM;AACX,kBAAM,QAAQ,CAAC;AAAA,UACjB;AAAA,UACA,MAAM;AAAA,QACR;AACA,eAAO;AAAA,UACL;AAAA,UACA,KAAK,KAAK;AAAA,UACV,SAAS;AAAA,UACT,MAAM,SAAS,KAAK,KAAK,SAAS,QAAQ;AAAA,QAC5C;AAAA,MACF;AAAA,MACA;AAAA,MACA;AAAA,QACE,OAAO;AAAA,QACP,SAAS,MAAM;AAAA,QACf,SAAS,MAAM;AAAA,MACjB;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeA,QAAQ,MAAqC;AAC3C,WAAO,IAAI,aAAa,MAAM,IAAI;AAAA,EACpC;AAAA;AAAA,EAGA,MAAM,UAA4B;AAChC,QAAI;AACF,YAAM,UAAU,MAAM,KAAK,eAAe;AAC1C,aAAO,QAAQ,YAAY;AAAA,IAC7B,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,aAAqC;AACzC,UAAM,UAAU,MAAM,KAAK,eAAe;AAC1C,WAAO,QAAQ,WAAW;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,OAA6B;AACjC,UAAM,UAAU,MAAM,KAAK,eAAe;AAC1C,WAAO,QAAQ,KAAK;AAAA,EACtB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,gBAA8C;AAClD,UAAM,UAAU,MAAM,KAAK,eAAe;AAC1C,WAAO,QAAQ;AAAA,EACjB;AAAA;AAAA,EAGA,MAAM,gBACJ,QACA,WACA,UACA,SACA,MACoB;AACpB,UAAM,UAAU,MAAM,WAAW,KAAK,KAAK,WAAW;AACtD,WAAO,KAAK;AAAA,MACV,YAAY;AACV,cAAM,UAAU,MAAM,KAAK,eAAe;AAC1C,cAAM,WAAW,MAAM,KAAK;AAAA,UAC1B;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,QACF;AACA,cAAM,MAAM,MAAM,KAAK;AAAA,UACrB;AAAA,UACA,UACI,OAAO,MAAM;AACX,kBAAM,QAAQ,CAAC;AAAA,UACjB,IACA;AAAA,UACJ,MAAM;AAAA,QACR;AACA,eAAO;AAAA,UACL;AAAA,UACA,KAAK,KAAK;AAAA,UACV,SAAS;AAAA,UACT,MAAM,SAAS,KAAK,KAAK,SAAS,QAAQ;AAAA,QAC5C;AAAA,MACF;AAAA,MACA;AAAA,MACA;AAAA,QACE,OAAO;AAAA,QACP,SAAS,MAAM;AAAA,QACf,SAAS,MAAM;AAAA,MACjB;AAAA,IACF;AAAA,EACF;AAAA,EAEU,aACR,SACA,QACA,UACA,WACA,UACA,eACmB;AACnB,WAAO;AAAA,MACL,KAAK;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/adapters/agents/agent-run-result.d.ts

@@ -0,0 +1,5 @@
+import type { RunResult } from '../../domain/core-client.js';
+import type { BackendName } from '../../domain/core-task.js';
+import type { RunExecutionResult } from './runtime/runner.js';
+export declare function toRunResult(raw: RunExecutionResult, backend: BackendName, runtime?: RunResult['runtime'], model?: string): RunResult;
+//# sourceMappingURL=agent-run-result.d.ts.map

package/dist/adapters/agents/agent-run-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-run-result.d.ts","sourceRoot":"","sources":["../../../src/adapters/agents/agent-run-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAsB9D,wBAAgB,WAAW,CACzB,GAAG,EAAE,kBAAkB,EACvB,OAAO,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,EAC9B,KAAK,CAAC,EAAE,MAAM,GACb,SAAS,CAeX"}

package/dist/adapters/agents/agent-run-result.js

@@ -0,0 +1,29 @@
+import { estimateTokenCost } from "../../domain/cost-estimation.js";
+const ANSI_RE = /\u001B\[[0-9;]*[A-Za-z]/g;
+function deriveFailureText(raw) {
+  if (raw.finalText && raw.finalText.trim().length > 0) return raw.finalText;
+  if (raw.exitCode === 0) return raw.finalText;
+  const cleaned = (raw.stderr ?? "").replace(ANSI_RE, "").trim();
+  if (cleaned.length === 0) return raw.finalText;
+  return cleaned.length > 600 ? `\u2026${cleaned.slice(-600)}` : cleaned;
+}
+function toRunResult(raw, backend, runtime, model) {
+  const resultEvent = raw.events.find((e) => e.type === "result");
+  const usage = resultEvent?.usage ?? null;
+  const cost = estimateTokenCost(resultEvent?.costUsd ?? null, usage, model);
+  return {
+    text: deriveFailureText(raw),
+    events: raw.events,
+    sessionId: raw.sessionId,
+    usage,
+    costUsd: cost.source === "unknown" ? null : cost.usd,
+    ...cost.source !== "unknown" ? { costSource: cost.source } : {},
+    exitCode: raw.exitCode,
+    backend,
+    runtime: runtime ?? null
+  };
+}
+export {
+  toRunResult
+};
+//# sourceMappingURL=agent-run-result.js.map

package/dist/adapters/agents/agent-run-result.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/adapters/agents/agent-run-result.ts"],
+  "sourcesContent": ["import type { RunResult } from '../../domain/core-client.js';\nimport type { BackendName } from '../../domain/core-task.js';\nimport { estimateTokenCost } from '../../domain/cost-estimation.js';\nimport type { RunExecutionResult } from './runtime/runner.js';\n\n// Strips common ANSI escape sequences so a stderr tail surfaced via\n// RunResult.text isn't peppered with terminal color codes when consumers log it.\n// eslint-disable-next-line no-control-regex\nconst ANSI_RE = /\\u001B\\[[0-9;]*[A-Za-z]/g;\n\n/**\n * When a CLI exits non-zero and emitted nothing parseable on stdout (e.g. codex\n * prints `400 invalid_request_error` to stderr, gemini prints `TerminalQuotaError`\n * to stderr), the parsed `finalText` is empty and the actual diagnostic is lost\n * in `raw.stderr`. Surface the last ~600 chars of stderr \u2014 sanitized \u2014 so the\n * caller (and AgentRunError.message) shows the real cause instead of \"exit 1\".\n */\nfunction deriveFailureText(raw: RunExecutionResult): string {\n  if (raw.finalText && raw.finalText.trim().length > 0) return raw.finalText;\n  if (raw.exitCode === 0) return raw.finalText;\n  const cleaned = (raw.stderr ?? '').replace(ANSI_RE, '').trim();\n  if (cleaned.length === 0) return raw.finalText;\n  return cleaned.length > 600 ? `\u2026${cleaned.slice(-600)}` : cleaned;\n}\n\nexport function toRunResult(\n  raw: RunExecutionResult,\n  backend: BackendName,\n  runtime?: RunResult['runtime'],\n  model?: string\n): RunResult {\n  const resultEvent = raw.events.find((e) => e.type === 'result');\n  const usage = resultEvent?.usage ?? null;\n  const cost = estimateTokenCost(resultEvent?.costUsd ?? null, usage, model);\n  return {\n    text: deriveFailureText(raw),\n    events: raw.events,\n    sessionId: raw.sessionId,\n    usage,\n    costUsd: cost.source === 'unknown' ? null : cost.usd,\n    ...(cost.source !== 'unknown' ? { costSource: cost.source } : {}),\n    exitCode: raw.exitCode,\n    backend,\n    runtime: runtime ?? null,\n  };\n}\n"],
+  "mappings": "AAEA,SAAS,yBAAyB;AAMlC,MAAM,UAAU;AAShB,SAAS,kBAAkB,KAAiC;AAC1D,MAAI,IAAI,aAAa,IAAI,UAAU,KAAK,EAAE,SAAS,EAAG,QAAO,IAAI;AACjE,MAAI,IAAI,aAAa,EAAG,QAAO,IAAI;AACnC,QAAM,WAAW,IAAI,UAAU,IAAI,QAAQ,SAAS,EAAE,EAAE,KAAK;AAC7D,MAAI,QAAQ,WAAW,EAAG,QAAO,IAAI;AACrC,SAAO,QAAQ,SAAS,MAAM,SAAI,QAAQ,MAAM,IAAI,CAAC,KAAK;AAC5D;AAEO,SAAS,YACd,KACA,SACA,SACA,OACW;AACX,QAAM,cAAc,IAAI,OAAO,KAAK,CAAC,MAAM,EAAE,SAAS,QAAQ;AAC9D,QAAM,QAAQ,aAAa,SAAS;AACpC,QAAM,OAAO,kBAAkB,aAAa,WAAW,MAAM,OAAO,KAAK;AACzE,SAAO;AAAA,IACL,MAAM,kBAAkB,GAAG;AAAA,IAC3B,QAAQ,IAAI;AAAA,IACZ,WAAW,IAAI;AAAA,IACf;AAAA,IACA,SAAS,KAAK,WAAW,YAAY,OAAO,KAAK;AAAA,IACjD,GAAI,KAAK,WAAW,YAAY,EAAE,YAAY,KAAK,OAAO,IAAI,CAAC;AAAA,IAC/D,UAAU,IAAI;AAAA,IACd;AAAA,IACA,SAAS,WAAW;AAAA,EACtB;AACF;",
+  "names": []
+}

package/dist/adapters/agents/agent-session-client.d.ts

@@ -0,0 +1,8 @@
+import type { BackendCapabilities } from '../../domain/contracts/backends.js';
+import type { RunResult, StreamCallback } from '../../domain/core-client.js';
+import type { BackendRunOptions } from './internal-run-options.js';
+export interface AgentSessionClient {
+    _capabilities(): Promise<BackendCapabilities>;
+    _runWithSession(prompt: string, sessionId: string | null, isResume: boolean, onEvent?: StreamCallback, opts?: BackendRunOptions): Promise<RunResult>;
+}
+//# sourceMappingURL=agent-session-client.d.ts.map

package/dist/adapters/agents/agent-session-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session-client.d.ts","sourceRoot":"","sources":["../../../src/adapters/agents/agent-session-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,MAAM,WAAW,kBAAkB;IACjC,aAAa,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAE9C,eAAe,CACb,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,QAAQ,EAAE,OAAO,EACjB,OAAO,CAAC,EAAE,cAAc,EACxB,IAAI,CAAC,EAAE,iBAAiB,GACvB,OAAO,CAAC,SAAS,CAAC,CAAC;CACvB"}