@theokit/sdk 1.8.1 → 2.0.0

package/dist/{cron-BnywDYLq.d.cts → cron-Bse1MbaE.d.cts}

@@ -1,5 +1,55 @@
 import { C as CustomTool, M as ModelSelection, D as SDKUserMessage, F as SendOptions, b as Run, a as McpServerConfig } from './run-DrwUpFxZ.cjs';
 
+/**
+ * Fork primitive public type contracts (T1.2, ADRs D110-D114).
+ *
+ * Extracted into a leaf type module (arch-review ADR 0001) so the public
+ * `types/agent.ts` barrel can reference `ForkOptions`/`ForkResult` without
+ * importing the `internal/runtime/fork-agent.ts` implementation — which in
+ * turn imports back from `types/agent.ts`. That mutual reference created a
+ * type-only `madge` cycle. These interfaces are self-contained (no SDKAgent
+ * / AgentOptions references), so co-locating them here breaks the cycle with
+ * no runtime change. `fork-agent.ts` re-exports them for back-compat.
+ */
+/**
+ * Caller-supplied fork configuration. See `forkAgentImpl`.
+ *
+ * @public
+ */
+interface ForkOptions {
+    /**
+     * Tool subset visible to the fork. Names must match the canonical (post-repair)
+     * tool name — typically lowercase. Tools not in this set return a `tool_result`
+     * with `"Tool blocked by fork whitelist"` content (EC-H).
+     */
+    allowedTools: Set<string>;
+    /** Task prompt sent to the fork. */
+    prompt: string;
+    /** Override system prompt. Default: byte-identical inheritance from parent (D112). */
+    systemPrompt?: string;
+    /** Memory write provenance tag (D114). Default `"fork"`. */
+    forkOrigin?: string;
+}
+/**
+ * Outcome of a fork run.
+ *
+ * @public
+ */
+interface ForkResult {
+    /** Final agent response text (`undefined` when the fork produced no result). */
+    result: string | undefined;
+    /** Tool calls executed inside the fork. */
+    toolCalls: ReadonlyArray<{
+        name: string;
+        input: Record<string, unknown>;
+    }>;
+    /** Aggregate token usage reported by the run. */
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}
+
 /**
  * Public event types emitted by {@link SDKAgent.runUntil} (ADRs D115-D117).
  *
@@ -66,7 +116,7 @@ interface GoalResult {
     finalResponse: string | undefined;
 }
 /**
- * Return type of {@link import("../internal/runtime/local-agent.js").LocalAgent.runUntil}.
+ * Return type of {@link import("../internal/runtime/local-agent/local-agent.js").LocalAgent.runUntil}.
  * Extracted so the LocalAgent method signature stays a single line (G8 LoC budget).
  *
  * @public
@@ -1388,7 +1438,7 @@ interface SDKAgent {
      *
      * @public
      */
-    fork?(options: undefined): Promise<undefined>;
+    fork?(options: ForkOptions): Promise<ForkResult>;
     /**
      * Direct API to third-party memory adapter(s) registered via
      * `plugins: [...]` (ADR D141 / D142). Returns `null` when no adapter

package/dist/{cron-CtZvJD9J.d.ts → cron-Ci_NUkUj.d.ts}

@@ -1,5 +1,55 @@
 import { C as CustomTool, M as ModelSelection, D as SDKUserMessage, F as SendOptions, b as Run, a as McpServerConfig } from './run-DrwUpFxZ.js';
 
+/**
+ * Fork primitive public type contracts (T1.2, ADRs D110-D114).
+ *
+ * Extracted into a leaf type module (arch-review ADR 0001) so the public
+ * `types/agent.ts` barrel can reference `ForkOptions`/`ForkResult` without
+ * importing the `internal/runtime/fork-agent.ts` implementation — which in
+ * turn imports back from `types/agent.ts`. That mutual reference created a
+ * type-only `madge` cycle. These interfaces are self-contained (no SDKAgent
+ * / AgentOptions references), so co-locating them here breaks the cycle with
+ * no runtime change. `fork-agent.ts` re-exports them for back-compat.
+ */
+/**
+ * Caller-supplied fork configuration. See `forkAgentImpl`.
+ *
+ * @public
+ */
+interface ForkOptions {
+    /**
+     * Tool subset visible to the fork. Names must match the canonical (post-repair)
+     * tool name — typically lowercase. Tools not in this set return a `tool_result`
+     * with `"Tool blocked by fork whitelist"` content (EC-H).
+     */
+    allowedTools: Set<string>;
+    /** Task prompt sent to the fork. */
+    prompt: string;
+    /** Override system prompt. Default: byte-identical inheritance from parent (D112). */
+    systemPrompt?: string;
+    /** Memory write provenance tag (D114). Default `"fork"`. */
+    forkOrigin?: string;
+}
+/**
+ * Outcome of a fork run.
+ *
+ * @public
+ */
+interface ForkResult {
+    /** Final agent response text (`undefined` when the fork produced no result). */
+    result: string | undefined;
+    /** Tool calls executed inside the fork. */
+    toolCalls: ReadonlyArray<{
+        name: string;
+        input: Record<string, unknown>;
+    }>;
+    /** Aggregate token usage reported by the run. */
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}
+
 /**
  * Public event types emitted by {@link SDKAgent.runUntil} (ADRs D115-D117).
  *
@@ -66,7 +116,7 @@ interface GoalResult {
     finalResponse: string | undefined;
 }
 /**
- * Return type of {@link import("../internal/runtime/local-agent.js").LocalAgent.runUntil}.
+ * Return type of {@link import("../internal/runtime/local-agent/local-agent.js").LocalAgent.runUntil}.
  * Extracted so the LocalAgent method signature stays a single line (G8 LoC budget).
  *
  * @public
@@ -1388,7 +1438,7 @@ interface SDKAgent {
      *
      * @public
      */
-    fork?(options: undefined): Promise<undefined>;
+    fork?(options: ForkOptions): Promise<ForkResult>;
     /**
      * Direct API to third-party memory adapter(s) registered via
      * `plugins: [...]` (ADR D141 / D142). Returns `null` when no adapter