@theokit/sdk 4.63.4 → 5.0.0-next.2

package/dist/internal/persistence/credential-pool-store.d.cts

@@ -1,32 +0,0 @@
-/**
- * Persistence for the credential-pool subsystem (ADRs D123, D129).
- *
- * Storage layout (`$THEOKIT_HOME/credential-pool.json`):
- *
- * ```json
- * {
- *   "_schemaVersion": 1,
- *   "data": {
- *     "pools": {
- *       "openrouter": {
- *         "provider": "openrouter",
- *         "strategy": "round_robin",
- *         "entries": [ { "id": "...", "label": "...", ... } ]
- *       }
- *     }
- *   }
- * }
- * ```
- *
- * Load is lazy (D129) — callers invoke `loadCredentialPoolStore` on the
- * first `Agent.create()` that registers `apiKeys`. Save is debounced at
- * the wrapper layer; this file exposes only the raw load/save primitive.
- *
- * Cross-process safety: writes acquire `withFileLock` (D61) on the
- * companion lockfile `credential-pool.json.lock`. Reads do not lock
- * because read-during-write at worst yields stale data; the next save
- * heals (EC-G is documented in this file's header).
- *
- * @internal
- */
-export {};

package/dist/internal/persistence/credential-pool-store.d.ts

@@ -1,32 +0,0 @@
-/**
- * Persistence for the credential-pool subsystem (ADRs D123, D129).
- *
- * Storage layout (`$THEOKIT_HOME/credential-pool.json`):
- *
- * ```json
- * {
- *   "_schemaVersion": 1,
- *   "data": {
- *     "pools": {
- *       "openrouter": {
- *         "provider": "openrouter",
- *         "strategy": "round_robin",
- *         "entries": [ { "id": "...", "label": "...", ... } ]
- *       }
- *     }
- *   }
- * }
- * ```
- *
- * Load is lazy (D129) — callers invoke `loadCredentialPoolStore` on the
- * first `Agent.create()` that registers `apiKeys`. Save is debounced at
- * the wrapper layer; this file exposes only the raw load/save primitive.
- *
- * Cross-process safety: writes acquire `withFileLock` (D61) on the
- * companion lockfile `credential-pool.json.lock`. Reads do not lock
- * because read-during-write at worst yields stale data; the next save
- * heals (EC-G is documented in this file's header).
- *
- * @internal
- */
-export {};

package/dist/internal/runtime/memory/memory-path-selector.d.ts

@@ -1,73 +0,0 @@
-/**
- * Memory path selector (SDK 2.0 Phase 1 physical Stage 2b — iter 22).
- *
- * Pure helpers the future kernel flip will use to choose between
- * legacy direct-call path and new MemoryProvider port path. Shipped
- * in isolation so the helpers are tested + frozen BEFORE the actual
- * `LocalAgent.send()` refactor wires them.
- *
- * Gate semantics (option A from the progress doc):
- *   - Default: legacy path (zero behavior change).
- *   - `THEOKIT_PORT_MEMORY_PATH=1` (env var): port path active.
- *
- * Why env var (vs option flag):
- *   - Easy to flip on/off at runtime without rebuild.
- *   - No public API surface added (the env var is internal-only;
- *     consumers don't see it in their TypeScript types).
- *   - Future iter can remove the env var once port path is the
- *     unconditional default — no deprecation cycle on the public API.
- *
- * @internal
- */
-import type { MemoryToolSpec } from "../../agent-loop/loop-types.js";
-import type { MemoryProvider } from "./memory-provider.js";
-/** Env var name — internal, not in public docs yet. */
-export declare const PORT_MEMORY_PATH_ENV_VAR = "THEOKIT_PORT_MEMORY_PATH";
-/**
- * Returns true when the port-memory-path should be active for this send.
- *
- * Checks both `process.env` (Node) and `globalThis.process?.env`
- * (defensive — some test environments stub process differently).
- */
-export declare function shouldUsePortMemoryPath(): boolean;
-/**
- * Pick which `MemoryProvider` (if any) gets passed to the agent loop.
- *
- * Semantics:
- *   - When consumer-supplied `options.memoryProvider` is set: ALWAYS
- *     honor it (regardless of env flag). The flag only affects the
- *     fall-back default.
- *   - When consumer didn't supply AND port path enabled: return the
- *     auto-installed `defaultMemoryProviderForLoop` (the adapter).
- *   - When consumer didn't supply AND port path disabled: return
- *     `undefined` (legacy path; agent-loop sees no provider).
- */
-export declare function resolveMemoryProviderForLoop(consumerSupplied: MemoryProvider | undefined, defaultAdapter: MemoryProvider, portPathEnabled: boolean): MemoryProvider | undefined;
-/**
- * Pick which `memoryTools` (if any) get passed to the agent loop's
- * `inputs.memoryTools` field.
- *
- * Semantics:
- *   - When port path active: return `undefined` (tools surface via
- *     `provider.buildTools()` inside agent-loop instead — iter 18 T1.5.2).
- *   - When port path inactive: return the legacy tools (from
- *     `memoryGlue.ensureTools()`).
- */
-export declare function resolveMemoryToolsForLoop(legacyTools: ReadonlyArray<MemoryToolSpec> | undefined, portPathEnabled: boolean): ReadonlyArray<MemoryToolSpec> | undefined;
-/**
- * Pick the `activeMemorySummary` value to fold into the system-prompt
- * assembly.
- *
- * Semantics:
- *   - When port path active: return `undefined` (additions surface via
- *     `provider.runActivePass()` inside agent-loop instead — iter 18 T1.5.3).
- *   - When port path inactive: return the legacy summary (from
- *     `memoryGlue.runActiveMemoryIfEnabled(...)`).
- */
-export declare function resolveActiveMemorySummaryForSend(legacySummary: string | undefined, portPathEnabled: boolean): string | undefined;
-/**
- * Type-only re-export for downstream consumers of the helpers.
- * `CustomTool` is the port's tool shape; future iter may need it
- * when assembling memoryTools via the port path.
- */
-export type { CustomTool };

package/dist/judge-call-LAHMBJ57.cjs

@@ -1,23 +0,0 @@
-'use strict';
-
-var chunk3NSS2OIZ_cjs = require('./chunk-3NSS2OIZ.cjs');
-require('./chunk-4ZHTIJNE.cjs');
-require('./chunk-XL7Q7HB2.cjs');
-require('./chunk-EG4QM7ZJ.cjs');
-
-
-
-Object.defineProperty(exports, "JudgeCredentialError", {
-  enumerable: true,
-  get: function () { return chunk3NSS2OIZ_cjs.JudgeCredentialError; }
-});
-Object.defineProperty(exports, "composeJudgePrompt", {
-  enumerable: true,
-  get: function () { return chunk3NSS2OIZ_cjs.composeJudgePrompt; }
-});
-Object.defineProperty(exports, "judgeCallImpl", {
-  enumerable: true,
-  get: function () { return chunk3NSS2OIZ_cjs.judgeCallImpl; }
-});
-//# sourceMappingURL=judge-call-LAHMBJ57.cjs.map
-//# sourceMappingURL=judge-call-LAHMBJ57.cjs.map

package/dist/judge-call-LVXABPS3.js

@@ -1,6 +0,0 @@
-export { JudgeCredentialError, composeJudgePrompt, judgeCallImpl } from './chunk-IPYYKCRC.js';
-import './chunk-ZZMZWBR6.js';
-import './chunk-D4CUGAKZ.js';
-import './chunk-XEQ3TM66.js';
-//# sourceMappingURL=judge-call-LVXABPS3.js.map
-//# sourceMappingURL=judge-call-LVXABPS3.js.map

package/dist/oauth-transaction-store-BT4GLTLK.cjs

@@ -1,36 +0,0 @@
-'use strict';
-
-var chunkB2J4ZMZL_cjs = require('./chunk-B2J4ZMZL.cjs');
-
-
-
-Object.defineProperty(exports, "AuthSecretTooShortError", {
-  enumerable: true,
-  get: function () { return chunkB2J4ZMZL_cjs.AuthSecretTooShortError; }
-});
-Object.defineProperty(exports, "COOKIE_NAME", {
-  enumerable: true,
-  get: function () { return chunkB2J4ZMZL_cjs.COOKIE_NAME; }
-});
-Object.defineProperty(exports, "__TESTING__deriveKey", {
-  enumerable: true,
-  get: function () { return chunkB2J4ZMZL_cjs.__TESTING__deriveKey; }
-});
-Object.defineProperty(exports, "clearTransaction", {
-  enumerable: true,
-  get: function () { return chunkB2J4ZMZL_cjs.clearTransaction; }
-});
-Object.defineProperty(exports, "encodeTransaction", {
-  enumerable: true,
-  get: function () { return chunkB2J4ZMZL_cjs.encodeTransaction; }
-});
-Object.defineProperty(exports, "getTransaction", {
-  enumerable: true,
-  get: function () { return chunkB2J4ZMZL_cjs.getTransaction; }
-});
-Object.defineProperty(exports, "newTransaction", {
-  enumerable: true,
-  get: function () { return chunkB2J4ZMZL_cjs.newTransaction; }
-});
-//# sourceMappingURL=oauth-transaction-store-BT4GLTLK.cjs.map
-//# sourceMappingURL=oauth-transaction-store-BT4GLTLK.cjs.map

package/dist/oauth-transaction-store-W52KVHQ4.js

@@ -1,3 +0,0 @@
-export { AuthSecretTooShortError, COOKIE_NAME, __TESTING__deriveKey, clearTransaction, encodeTransaction, getTransaction, newTransaction } from './chunk-AWO27VRZ.js';
-//# sourceMappingURL=oauth-transaction-store-W52KVHQ4.js.map
-//# sourceMappingURL=oauth-transaction-store-W52KVHQ4.js.map

package/dist/registry-75W33OGL.js

@@ -1,10 +0,0 @@
-export { __getSubscribersCountForTests, __resetTaskRegistryForTests, cancel, configure, get, list, submit, subscribe } from './chunk-A46SWMIF.js';
-import './chunk-K2BQQ445.js';
-import './chunk-4QZSA2HJ.js';
-import './chunk-KQRW2GPZ.js';
-import './chunk-2GUYQR5P.js';
-import './chunk-ZZMZWBR6.js';
-import './chunk-D4CUGAKZ.js';
-import './chunk-XEQ3TM66.js';
-//# sourceMappingURL=registry-75W33OGL.js.map
-//# sourceMappingURL=registry-75W33OGL.js.map

package/dist/registry-V7BDQ6QB.cjs

@@ -1,47 +0,0 @@
-'use strict';
-
-var chunk3FFAEAUJ_cjs = require('./chunk-3FFAEAUJ.cjs');
-require('./chunk-BUUUWQMB.cjs');
-require('./chunk-XWTLIGO3.cjs');
-require('./chunk-RFMBZPOW.cjs');
-require('./chunk-UALX2J2Q.cjs');
-require('./chunk-4ZHTIJNE.cjs');
-require('./chunk-XL7Q7HB2.cjs');
-require('./chunk-EG4QM7ZJ.cjs');
-
-
-
-Object.defineProperty(exports, "__getSubscribersCountForTests", {
-  enumerable: true,
-  get: function () { return chunk3FFAEAUJ_cjs.__getSubscribersCountForTests; }
-});
-Object.defineProperty(exports, "__resetTaskRegistryForTests", {
-  enumerable: true,
-  get: function () { return chunk3FFAEAUJ_cjs.__resetTaskRegistryForTests; }
-});
-Object.defineProperty(exports, "cancel", {
-  enumerable: true,
-  get: function () { return chunk3FFAEAUJ_cjs.cancel; }
-});
-Object.defineProperty(exports, "configure", {
-  enumerable: true,
-  get: function () { return chunk3FFAEAUJ_cjs.configure; }
-});
-Object.defineProperty(exports, "get", {
-  enumerable: true,
-  get: function () { return chunk3FFAEAUJ_cjs.get; }
-});
-Object.defineProperty(exports, "list", {
-  enumerable: true,
-  get: function () { return chunk3FFAEAUJ_cjs.list; }
-});
-Object.defineProperty(exports, "submit", {
-  enumerable: true,
-  get: function () { return chunk3FFAEAUJ_cjs.submit; }
-});
-Object.defineProperty(exports, "subscribe", {
-  enumerable: true,
-  get: function () { return chunk3FFAEAUJ_cjs.subscribe; }
-});
-//# sourceMappingURL=registry-V7BDQ6QB.cjs.map
-//# sourceMappingURL=registry-V7BDQ6QB.cjs.map

package/dist/run-until-HEQOUVU6.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/internal/runtime/lifecycle/run-until.ts"],"names":[],"mappings":"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","file":"run-until-HEQOUVU6.js","sourcesContent":["/**\n * Goal-driven Ralph loop (T3.2, ADRs D115-D121).\n *\n * `runUntilImpl` is an `AsyncGenerator<GoalEvent, GoalResult, void>`:\n * yields events as the loop progresses, returns the final result when\n * the goal completes, fails, or is paused. The auxiliary judge model is\n * injected via `deps.judge` so the generator stays free of the `Agent`\n * façade import.\n *\n * EC-C fix: pre-aborted signals emit only `[paused]`, not `[active, paused]`.\n * EC-D: `maxTurns: 0` is supported (vacuous yield active → failed).\n *\n * @internal\n */\n\nimport type { SDKAgent } from \"../../../types/agent.js\";\nimport type {\n  GoalEvent,\n  GoalOptions,\n  GoalResult,\n  JudgeResult,\n} from \"../../../types/goal-events.js\";\nimport type { JudgeContext, JudgeOptions } from \"../../judge/judge-call.js\";\nimport { GOAL_CONTINUATION_MARKER } from \"./goal-marker.js\";\n\n/** DI contract: the judge is the only external touchpoint. */\nexport interface RunUntilDeps {\n  judge: (ctx: JudgeContext, opts?: JudgeOptions) => Promise<JudgeResult>;\n}\n\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: the goal-loop interleaves turn-start, send, judge, continuation, abort-check, and failure-bail — extracting helpers harms the linear narrative.\nexport async function* runUntilImpl(\n  agent: SDKAgent,\n  goal: string,\n  options: GoalOptions | undefined,\n  deps: RunUntilDeps,\n): AsyncGenerator<GoalEvent, GoalResult, void> {\n  const maxTurns = options?.maxTurns ?? 20;\n  const maxFails = options?.maxConsecutiveJudgeFailures ?? 3;\n  const tokenBudget = options?.tokenBudget; // M55 — undefined ⇒ unlimited\n  const signal = options?.signal;\n  // Use a function (not direct property access) so TS does not narrow\n  // `signal.aborted` to `false | undefined` after the initial check.\n  // AbortSignal.aborted is a getter that can flip true between calls.\n  // biome-ignore lint/complexity/useOptionalChain: optional-chain would re-narrow signal?.aborted to `false | undefined` after the first check, defeating the purpose of this helper.\n  const isAborted = (): boolean => signal !== undefined && signal.aborted;\n  let turn = 0;\n  let consecutiveFailures = 0;\n  let tokensUsed = 0; // M55 — the observed sum (0 when usage is absent — fail-open)\n  let lastResponse = \"\";\n\n  // EC-C: signal already aborted BEFORE first event → emit only [paused].\n  if (isAborted()) {\n    yield {\n      type: \"status_change\",\n      status: \"paused\",\n      reason: \"aborted via AbortSignal before first turn\",\n    };\n    return { status: \"paused\", turnsUsed: 0, tokensUsed, finalResponse: undefined };\n  }\n\n  yield { type: \"status_change\", status: \"active\", reason: \"Goal started\" };\n\n  while (turn < maxTurns) {\n    if (isAborted()) {\n      yield { type: \"status_change\", status: \"paused\", reason: \"aborted via AbortSignal\" };\n      return {\n        status: \"paused\",\n        turnsUsed: turn,\n        tokensUsed,\n        finalResponse: lastResponse || undefined,\n      };\n    }\n\n    turn += 1;\n    yield { type: \"turn_start\", turn, goal };\n\n    const continuationPrompt = turn === 1 ? goal : composeContinuation(goal, lastResponse);\n\n    const run = await agent.send(continuationPrompt);\n    // M55 review HIGH — thread the abort INTO the in-flight run: without this, Esc mid-turn is\n    // cosmetic (the turn keeps mutating the workspace until it finishes on its own). `run.cancel()`\n    // aborts the stream + in-flight tool calls (types/run.ts contract).\n    const cancelOnAbort = (): void => {\n      void (run as { cancel?: () => Promise<void> }).cancel?.();\n    };\n    if (signal !== undefined) {\n      if (signal.aborted) cancelOnAbort();\n      else signal.addEventListener(\"abort\", cancelOnAbort, { once: true });\n    }\n    const result = await run.wait();\n    if (signal !== undefined) signal.removeEventListener(\"abort\", cancelOnAbort);\n    lastResponse = result.result ?? \"\";\n    // M55 — token accounting fails open: it only sums when the run reports usage.\n    const turnTokens = (result as { usage?: { totalTokens?: number } }).usage?.totalTokens;\n    if (typeof turnTokens === \"number\") tokensUsed += turnTokens;\n    // Re-check aborted right after the turn lands: a cancelled turn must NOT spend a judge call.\n    if (isAborted()) {\n      yield { type: \"status_change\", status: \"paused\", reason: \"aborted via AbortSignal\" };\n      return {\n        status: \"paused\",\n        turnsUsed: turn,\n        tokensUsed,\n        finalResponse: lastResponse || undefined,\n      };\n    }\n    yield { type: \"agent_response\", turn, content: lastResponse };\n\n    const judgeOpts: JudgeOptions = {};\n    if (options?.judgeModel !== undefined) judgeOpts.judgeModel = options.judgeModel;\n    if (options?.judgeApiKey !== undefined) judgeOpts.apiKey = options.judgeApiKey;\n    // M80 — forwards the driven agent's model so the judge can derive when `judgeModel` is omitted.\n    if (options?.agentModel !== undefined) judgeOpts.agentModel = options.agentModel;\n    const judgeCtx: JudgeContext = { goal, lastResponse };\n    if (options?.subgoals !== undefined) judgeCtx.subgoals = options.subgoals;\n    const judgment = await deps.judge(judgeCtx, judgeOpts);\n    yield {\n      type: \"judge_verdict\",\n      turn,\n      verdict: judgment.verdict,\n      reason: judgment.reason,\n      parseFailed: judgment.parseFailed,\n    };\n\n    if (judgment.parseFailed) {\n      consecutiveFailures += 1;\n      if (consecutiveFailures >= maxFails) {\n        yield {\n          type: \"status_change\",\n          status: \"failed\",\n          reason: `judge model too unreliable (${consecutiveFailures} parse failures in a row)`,\n        };\n        return {\n          status: \"failed\",\n          turnsUsed: turn,\n          tokensUsed,\n          finalResponse: lastResponse || undefined,\n        };\n      }\n    } else {\n      consecutiveFailures = 0;\n    }\n\n    if (judgment.verdict === \"done\") {\n      yield { type: \"status_change\", status: \"completed\", reason: judgment.reason };\n      return {\n        status: \"completed\",\n        turnsUsed: turn,\n        tokensUsed,\n        finalResponse: lastResponse || undefined,\n      };\n    }\n    // M80 — the missing arm. Without it, a judge recognizing impossibility could only say\n    // \"continue\", and the loop repeated the same turn until it blew the budget — reporting `failed` on\n    // a limit rather than `blocked` on impossibility. Two distinct causes with the same\n    // visible outcome, and the consumer had to reconcile after the loop to tell them apart.\n    if (judgment.verdict === \"blocked\") {\n      yield { type: \"status_change\", status: \"blocked\", reason: judgment.reason };\n      return {\n        status: \"blocked\",\n        turnsUsed: turn,\n        tokensUsed,\n        finalResponse: lastResponse || undefined,\n      };\n    }\n    if (judgment.verdict === \"skipped\") {\n      yield {\n        type: \"status_change\",\n        status: \"completed\",\n        reason: `skipped: ${judgment.reason}`,\n      };\n      return {\n        status: \"completed\",\n        turnsUsed: turn,\n        tokensUsed,\n        finalResponse: lastResponse || undefined,\n      };\n    }\n\n    // M55 — token-budget check AFTER the turn (Codex: gentle wind-down, stops the loop).\n    if (tokenBudget !== undefined && tokensUsed >= tokenBudget) {\n      yield {\n        type: \"status_change\",\n        status: \"budget_limited\",\n        reason: `token budget (${tokenBudget}) reached: ${tokensUsed} used`,\n      };\n      return {\n        status: \"budget_limited\",\n        turnsUsed: turn,\n        tokensUsed,\n        finalResponse: lastResponse || undefined,\n      };\n    }\n\n    yield { type: \"continuation\", turn, prompt: continuationPrompt };\n  }\n\n  yield {\n    type: \"status_change\",\n    status: \"failed\",\n    reason: `max turns (${maxTurns}) exhausted`,\n  };\n  return {\n    status: \"failed\",\n    turnsUsed: turn,\n    tokensUsed,\n    finalResponse: lastResponse || undefined,\n  };\n}\n\n/**\n * Build the continuation user message for turns 2+. Keeps last response\n * preview short so we don't bloat the prompt cache.\n *\n * @internal\n */\n\nexport function composeContinuation(goal: string, lastResponse: string): string {\n  // M55 — Codex-faithful continuation (ext/goal templates/goals/continuation.md): keep the FULL\n  // objective intact, work from current-state evidence, and audit completion requirement-by-requirement\n  // before declaring done. Improves the quality of what the judge then evaluates.\n  return [\n    GOAL_CONTINUATION_MARKER,\n    \"Continue working toward the active goal.\",\n    \"\",\n    `<objective>\\n${goal}\\n</objective>`,\n    \"\",\n    \"Continuation behavior:\",\n    \"- This goal persists across turns. Keep the full objective intact; if it cannot be finished now,\",\n    \"  make concrete progress toward the real requested end state and do not redefine success around a\",\n    \"  smaller or easier task.\",\n    \"\",\n    \"Work from evidence:\",\n    \"- Use the current worktree and external state as authoritative. Inspect the current state before\",\n    \"  relying on it. Improve, replace, or remove existing work as needed to satisfy the actual objective.\",\n    \"\",\n    \"Completion audit:\",\n    \"- Before deciding the goal is achieved, treat completion as unproven and verify it against the actual\",\n    \"  current state, requirement by requirement. Treat uncertain or indirect evidence as not achieved.\",\n    \"\",\n    `Your last response was:\\n${lastResponse.slice(-1000)}`,\n  ].join(\"\\n\");\n}\n"]}

package/dist/run-until-U2B5FJJI.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/internal/runtime/lifecycle/run-until.ts"],"names":["GOAL_CONTINUATION_MARKER"],"mappings":"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","file":"run-until-U2B5FJJI.cjs","sourcesContent":["/**\n * Goal-driven Ralph loop (T3.2, ADRs D115-D121).\n *\n * `runUntilImpl` is an `AsyncGenerator<GoalEvent, GoalResult, void>`:\n * yields events as the loop progresses, returns the final result when\n * the goal completes, fails, or is paused. The auxiliary judge model is\n * injected via `deps.judge` so the generator stays free of the `Agent`\n * façade import.\n *\n * EC-C fix: pre-aborted signals emit only `[paused]`, not `[active, paused]`.\n * EC-D: `maxTurns: 0` is supported (vacuous yield active → failed).\n *\n * @internal\n */\n\nimport type { SDKAgent } from \"../../../types/agent.js\";\nimport type {\n  GoalEvent,\n  GoalOptions,\n  GoalResult,\n  JudgeResult,\n} from \"../../../types/goal-events.js\";\nimport type { JudgeContext, JudgeOptions } from \"../../judge/judge-call.js\";\nimport { GOAL_CONTINUATION_MARKER } from \"./goal-marker.js\";\n\n/** DI contract: the judge is the only external touchpoint. */\nexport interface RunUntilDeps {\n  judge: (ctx: JudgeContext, opts?: JudgeOptions) => Promise<JudgeResult>;\n}\n\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: the goal-loop interleaves turn-start, send, judge, continuation, abort-check, and failure-bail — extracting helpers harms the linear narrative.\nexport async function* runUntilImpl(\n  agent: SDKAgent,\n  goal: string,\n  options: GoalOptions | undefined,\n  deps: RunUntilDeps,\n): AsyncGenerator<GoalEvent, GoalResult, void> {\n  const maxTurns = options?.maxTurns ?? 20;\n  const maxFails = options?.maxConsecutiveJudgeFailures ?? 3;\n  const tokenBudget = options?.tokenBudget; // M55 — undefined ⇒ unlimited\n  const signal = options?.signal;\n  // Use a function (not direct property access) so TS does not narrow\n  // `signal.aborted` to `false | undefined` after the initial check.\n  // AbortSignal.aborted is a getter that can flip true between calls.\n  // biome-ignore lint/complexity/useOptionalChain: optional-chain would re-narrow signal?.aborted to `false | undefined` after the first check, defeating the purpose of this helper.\n  const isAborted = (): boolean => signal !== undefined && signal.aborted;\n  let turn = 0;\n  let consecutiveFailures = 0;\n  let tokensUsed = 0; // M55 — the observed sum (0 when usage is absent — fail-open)\n  let lastResponse = \"\";\n\n  // EC-C: signal already aborted BEFORE first event → emit only [paused].\n  if (isAborted()) {\n    yield {\n      type: \"status_change\",\n      status: \"paused\",\n      reason: \"aborted via AbortSignal before first turn\",\n    };\n    return { status: \"paused\", turnsUsed: 0, tokensUsed, finalResponse: undefined };\n  }\n\n  yield { type: \"status_change\", status: \"active\", reason: \"Goal started\" };\n\n  while (turn < maxTurns) {\n    if (isAborted()) {\n      yield { type: \"status_change\", status: \"paused\", reason: \"aborted via AbortSignal\" };\n      return {\n        status: \"paused\",\n        turnsUsed: turn,\n        tokensUsed,\n        finalResponse: lastResponse || undefined,\n      };\n    }\n\n    turn += 1;\n    yield { type: \"turn_start\", turn, goal };\n\n    const continuationPrompt = turn === 1 ? goal : composeContinuation(goal, lastResponse);\n\n    const run = await agent.send(continuationPrompt);\n    // M55 review HIGH — thread the abort INTO the in-flight run: without this, Esc mid-turn is\n    // cosmetic (the turn keeps mutating the workspace until it finishes on its own). `run.cancel()`\n    // aborts the stream + in-flight tool calls (types/run.ts contract).\n    const cancelOnAbort = (): void => {\n      void (run as { cancel?: () => Promise<void> }).cancel?.();\n    };\n    if (signal !== undefined) {\n      if (signal.aborted) cancelOnAbort();\n      else signal.addEventListener(\"abort\", cancelOnAbort, { once: true });\n    }\n    const result = await run.wait();\n    if (signal !== undefined) signal.removeEventListener(\"abort\", cancelOnAbort);\n    lastResponse = result.result ?? \"\";\n    // M55 — token accounting fails open: it only sums when the run reports usage.\n    const turnTokens = (result as { usage?: { totalTokens?: number } }).usage?.totalTokens;\n    if (typeof turnTokens === \"number\") tokensUsed += turnTokens;\n    // Re-check aborted right after the turn lands: a cancelled turn must NOT spend a judge call.\n    if (isAborted()) {\n      yield { type: \"status_change\", status: \"paused\", reason: \"aborted via AbortSignal\" };\n      return {\n        status: \"paused\",\n        turnsUsed: turn,\n        tokensUsed,\n        finalResponse: lastResponse || undefined,\n      };\n    }\n    yield { type: \"agent_response\", turn, content: lastResponse };\n\n    const judgeOpts: JudgeOptions = {};\n    if (options?.judgeModel !== undefined) judgeOpts.judgeModel = options.judgeModel;\n    if (options?.judgeApiKey !== undefined) judgeOpts.apiKey = options.judgeApiKey;\n    // M80 — forwards the driven agent's model so the judge can derive when `judgeModel` is omitted.\n    if (options?.agentModel !== undefined) judgeOpts.agentModel = options.agentModel;\n    const judgeCtx: JudgeContext = { goal, lastResponse };\n    if (options?.subgoals !== undefined) judgeCtx.subgoals = options.subgoals;\n    const judgment = await deps.judge(judgeCtx, judgeOpts);\n    yield {\n      type: \"judge_verdict\",\n      turn,\n      verdict: judgment.verdict,\n      reason: judgment.reason,\n      parseFailed: judgment.parseFailed,\n    };\n\n    if (judgment.parseFailed) {\n      consecutiveFailures += 1;\n      if (consecutiveFailures >= maxFails) {\n        yield {\n          type: \"status_change\",\n          status: \"failed\",\n          reason: `judge model too unreliable (${consecutiveFailures} parse failures in a row)`,\n        };\n        return {\n          status: \"failed\",\n          turnsUsed: turn,\n          tokensUsed,\n          finalResponse: lastResponse || undefined,\n        };\n      }\n    } else {\n      consecutiveFailures = 0;\n    }\n\n    if (judgment.verdict === \"done\") {\n      yield { type: \"status_change\", status: \"completed\", reason: judgment.reason };\n      return {\n        status: \"completed\",\n        turnsUsed: turn,\n        tokensUsed,\n        finalResponse: lastResponse || undefined,\n      };\n    }\n    // M80 — the missing arm. Without it, a judge recognizing impossibility could only say\n    // \"continue\", and the loop repeated the same turn until it blew the budget — reporting `failed` on\n    // a limit rather than `blocked` on impossibility. Two distinct causes with the same\n    // visible outcome, and the consumer had to reconcile after the loop to tell them apart.\n    if (judgment.verdict === \"blocked\") {\n      yield { type: \"status_change\", status: \"blocked\", reason: judgment.reason };\n      return {\n        status: \"blocked\",\n        turnsUsed: turn,\n        tokensUsed,\n        finalResponse: lastResponse || undefined,\n      };\n    }\n    if (judgment.verdict === \"skipped\") {\n      yield {\n        type: \"status_change\",\n        status: \"completed\",\n        reason: `skipped: ${judgment.reason}`,\n      };\n      return {\n        status: \"completed\",\n        turnsUsed: turn,\n        tokensUsed,\n        finalResponse: lastResponse || undefined,\n      };\n    }\n\n    // M55 — token-budget check AFTER the turn (Codex: gentle wind-down, stops the loop).\n    if (tokenBudget !== undefined && tokensUsed >= tokenBudget) {\n      yield {\n        type: \"status_change\",\n        status: \"budget_limited\",\n        reason: `token budget (${tokenBudget}) reached: ${tokensUsed} used`,\n      };\n      return {\n        status: \"budget_limited\",\n        turnsUsed: turn,\n        tokensUsed,\n        finalResponse: lastResponse || undefined,\n      };\n    }\n\n    yield { type: \"continuation\", turn, prompt: continuationPrompt };\n  }\n\n  yield {\n    type: \"status_change\",\n    status: \"failed\",\n    reason: `max turns (${maxTurns}) exhausted`,\n  };\n  return {\n    status: \"failed\",\n    turnsUsed: turn,\n    tokensUsed,\n    finalResponse: lastResponse || undefined,\n  };\n}\n\n/**\n * Build the continuation user message for turns 2+. Keeps last response\n * preview short so we don't bloat the prompt cache.\n *\n * @internal\n */\n\nexport function composeContinuation(goal: string, lastResponse: string): string {\n  // M55 — Codex-faithful continuation (ext/goal templates/goals/continuation.md): keep the FULL\n  // objective intact, work from current-state evidence, and audit completion requirement-by-requirement\n  // before declaring done. Improves the quality of what the judge then evaluates.\n  return [\n    GOAL_CONTINUATION_MARKER,\n    \"Continue working toward the active goal.\",\n    \"\",\n    `<objective>\\n${goal}\\n</objective>`,\n    \"\",\n    \"Continuation behavior:\",\n    \"- This goal persists across turns. Keep the full objective intact; if it cannot be finished now,\",\n    \"  make concrete progress toward the real requested end state and do not redefine success around a\",\n    \"  smaller or easier task.\",\n    \"\",\n    \"Work from evidence:\",\n    \"- Use the current worktree and external state as authoritative. Inspect the current state before\",\n    \"  relying on it. Improve, replace, or remove existing work as needed to satisfy the actual objective.\",\n    \"\",\n    \"Completion audit:\",\n    \"- Before deciding the goal is achieved, treat completion as unproven and verify it against the actual\",\n    \"  current state, requirement by requirement. Treat uncertain or indirect evidence as not achieved.\",\n    \"\",\n    `Your last response was:\\n${lastResponse.slice(-1000)}`,\n  ].join(\"\\n\");\n}\n"]}

package/dist/server/adapter/express.d.cts

@@ -1,9 +0,0 @@
-/**
- * Express server adapter — mounts a TheoKit agent as Express middleware (T12.2).
- *
- * Optional peer dep: express@^4||^5
- *
- * @public
- */
-import type { AgentHandlerOptions, AgentLike } from "./types.js";
-export declare function createAgentHandler(agent: AgentLike, opts?: AgentHandlerOptions): import("./types.js").AgentHandler;

package/dist/server/adapter/express.d.ts

@@ -1,9 +0,0 @@
-/**
- * Express server adapter — mounts a TheoKit agent as Express middleware (T12.2).
- *
- * Optional peer dep: express@^4||^5
- *
- * @public
- */
-import type { AgentHandlerOptions, AgentLike } from "./types.js";
-export declare function createAgentHandler(agent: AgentLike, opts?: AgentHandlerOptions): import("./types.js").AgentHandler;

package/dist/server/adapter/fastify.d.cts

@@ -1,9 +0,0 @@
-/**
- * Fastify server adapter — mounts a TheoKit agent as Fastify plugin (T12.2).
- *
- * Optional peer dep: fastify@^5
- *
- * @public
- */
-import type { AgentHandlerOptions, AgentLike } from "./types.js";
-export declare function createAgentHandler(agent: AgentLike, opts?: AgentHandlerOptions): import("./types.js").AgentHandler;

package/dist/server/adapter/fastify.d.ts

@@ -1,9 +0,0 @@
-/**
- * Fastify server adapter — mounts a TheoKit agent as Fastify plugin (T12.2).
- *
- * Optional peer dep: fastify@^5
- *
- * @public
- */
-import type { AgentHandlerOptions, AgentLike } from "./types.js";
-export declare function createAgentHandler(agent: AgentLike, opts?: AgentHandlerOptions): import("./types.js").AgentHandler;

package/dist/server/adapter/hono.d.cts

@@ -1,9 +0,0 @@
-/**
- * Hono server adapter — mounts a TheoKit agent as Hono middleware (T12.2).
- *
- * Optional peer dep: hono@^4
- *
- * @public
- */
-import type { AgentHandlerOptions, AgentLike } from "./types.js";
-export declare function createAgentHandler(agent: AgentLike, opts?: AgentHandlerOptions): import("./types.js").AgentHandler;

package/dist/server/adapter/hono.d.ts

@@ -1,9 +0,0 @@
-/**
- * Hono server adapter — mounts a TheoKit agent as Hono middleware (T12.2).
- *
- * Optional peer dep: hono@^4
- *
- * @public
- */
-import type { AgentHandlerOptions, AgentLike } from "./types.js";
-export declare function createAgentHandler(agent: AgentLike, opts?: AgentHandlerOptions): import("./types.js").AgentHandler;

package/dist/server/adapter/shared-handler.d.cts

@@ -1,9 +0,0 @@
-/**
- * Shared agent handler factory — common logic used by all framework adapters (T12.2).
- *
- * Each adapter re-exports its own `createAgentHandler` for tree-shaking
- * friendliness, but the actual implementation lives here.
- *
- * @internal
- */
-export declare function createSharedAgentHandler(agent: AgentLike, opts?: AgentHandlerOptions): AgentHandler;

package/dist/server/adapter/shared-handler.d.ts

@@ -1,9 +0,0 @@
-/**
- * Shared agent handler factory — common logic used by all framework adapters (T12.2).
- *
- * Each adapter re-exports its own `createAgentHandler` for tree-shaking
- * friendliness, but the actual implementation lives here.
- *
- * @internal
- */
-export declare function createSharedAgentHandler(agent: AgentLike, opts?: AgentHandlerOptions): AgentHandler;

package/dist/server/adapter/types.d.cts

@@ -1,33 +0,0 @@
-/**
- * AgentMiddleware — shared contract for server adapters (T12.2).
- * @public
- */
-export interface AgentHandlerOptions {
-    basePath?: string;
-    onError?: (err: Error) => void;
-}
-export interface AgentLike {
-    send(input: string, opts?: {
-        signal?: AbortSignal;
-    }): {
-        stream(): AsyncIterable<unknown>;
-        wait(): Promise<unknown>;
-    };
-    dispose(): void;
-}
-export interface AgentHandler {
-    routes: ReadonlyArray<{
-        method: string;
-        path: string;
-    }>;
-    handleRequest(req: {
-        method: string;
-        url: string;
-        body?: unknown;
-        signal?: AbortSignal;
-    }): Promise<{
-        status: number;
-        body?: unknown;
-        stream?: AsyncIterable<unknown>;
-    }>;
-}

package/dist/server/adapter/types.d.ts

@@ -1,33 +0,0 @@
-/**
- * AgentMiddleware — shared contract for server adapters (T12.2).
- * @public
- */
-export interface AgentHandlerOptions {
-    basePath?: string;
-    onError?: (err: Error) => void;
-}
-export interface AgentLike {
-    send(input: string, opts?: {
-        signal?: AbortSignal;
-    }): {
-        stream(): AsyncIterable<unknown>;
-        wait(): Promise<unknown>;
-    };
-    dispose(): void;
-}
-export interface AgentHandler {
-    routes: ReadonlyArray<{
-        method: string;
-        path: string;
-    }>;
-    handleRequest(req: {
-        method: string;
-        url: string;
-        body?: unknown;
-        signal?: AbortSignal;
-    }): Promise<{
-        status: number;
-        body?: unknown;
-        stream?: AsyncIterable<unknown>;
-    }>;
-}

package/dist/session-transcript-6WNITKRE.cjs

@@ -1,63 +0,0 @@
-'use strict';
-
-var chunk5HEG4CQH_cjs = require('./chunk-5HEG4CQH.cjs');
-require('./chunk-UALX2J2Q.cjs');
-require('./chunk-XL7Q7HB2.cjs');
-require('./chunk-EG4QM7ZJ.cjs');
-
-
-
-Object.defineProperty(exports, "SessionTranscript", {
-  enumerable: true,
-  get: function () { return chunk5HEG4CQH_cjs.SessionTranscript; }
-});
-Object.defineProperty(exports, "defaultBaseDir", {
-  enumerable: true,
-  get: function () { return chunk5HEG4CQH_cjs.defaultBaseDir; }
-});
-Object.defineProperty(exports, "encodeProjectDir", {
-  enumerable: true,
-  get: function () { return chunk5HEG4CQH_cjs.encodeProjectDir; }
-});
-Object.defineProperty(exports, "expandTilde", {
-  enumerable: true,
-  get: function () { return chunk5HEG4CQH_cjs.expandTilde; }
-});
-Object.defineProperty(exports, "isSessionUuid", {
-  enumerable: true,
-  get: function () { return chunk5HEG4CQH_cjs.isSessionUuid; }
-});
-Object.defineProperty(exports, "legacyTranscriptPath", {
-  enumerable: true,
-  get: function () { return chunk5HEG4CQH_cjs.legacyTranscriptPath; }
-});
-Object.defineProperty(exports, "readTranscript", {
-  enumerable: true,
-  get: function () { return chunk5HEG4CQH_cjs.readTranscript; }
-});
-Object.defineProperty(exports, "reconstructMessages", {
-  enumerable: true,
-  get: function () { return chunk5HEG4CQH_cjs.reconstructMessages; }
-});
-Object.defineProperty(exports, "safeSessionId", {
-  enumerable: true,
-  get: function () { return chunk5HEG4CQH_cjs.safeSessionId; }
-});
-Object.defineProperty(exports, "sessionUuidFor", {
-  enumerable: true,
-  get: function () { return chunk5HEG4CQH_cjs.sessionUuidFor; }
-});
-Object.defineProperty(exports, "transcriptPath", {
-  enumerable: true,
-  get: function () { return chunk5HEG4CQH_cjs.transcriptPath; }
-});
-Object.defineProperty(exports, "transcriptRoot", {
-  enumerable: true,
-  get: function () { return chunk5HEG4CQH_cjs.transcriptRoot; }
-});
-Object.defineProperty(exports, "writeTranscript", {
-  enumerable: true,
-  get: function () { return chunk5HEG4CQH_cjs.writeTranscript; }
-});
-//# sourceMappingURL=session-transcript-6WNITKRE.cjs.map
-//# sourceMappingURL=session-transcript-6WNITKRE.cjs.map

package/dist/session-transcript-XAEKW6P7.js

@@ -1,6 +0,0 @@
-export { SessionTranscript, defaultBaseDir, encodeProjectDir, expandTilde, isSessionUuid, legacyTranscriptPath, readTranscript, reconstructMessages, safeSessionId, sessionUuidFor, transcriptPath, transcriptRoot, writeTranscript } from './chunk-UMP6OJIM.js';
-import './chunk-2GUYQR5P.js';
-import './chunk-D4CUGAKZ.js';
-import './chunk-XEQ3TM66.js';
-//# sourceMappingURL=session-transcript-XAEKW6P7.js.map
-//# sourceMappingURL=session-transcript-XAEKW6P7.js.map

package/dist/stream-object-UF4QRQRU.js

@@ -1,8 +0,0 @@
-export { StreamObjectError, streamObjectImpl } from './chunk-U6IFHFWK.js';
-import './chunk-UNYXQ4M5.js';
-import './chunk-4VPXM6UU.js';
-import './chunk-ZZMZWBR6.js';
-import './chunk-D4CUGAKZ.js';
-import './chunk-XEQ3TM66.js';
-//# sourceMappingURL=stream-object-UF4QRQRU.js.map
-//# sourceMappingURL=stream-object-UF4QRQRU.js.map

package/dist/stream-object-ZJTQNKY3.cjs

@@ -1,21 +0,0 @@
-'use strict';
-
-var chunkLYRDF5TQ_cjs = require('./chunk-LYRDF5TQ.cjs');
-require('./chunk-B4EOJWOY.cjs');
-require('./chunk-WJVHMTKB.cjs');
-require('./chunk-4ZHTIJNE.cjs');
-require('./chunk-XL7Q7HB2.cjs');
-require('./chunk-EG4QM7ZJ.cjs');
-
-
-
-Object.defineProperty(exports, "StreamObjectError", {
-  enumerable: true,
-  get: function () { return chunkLYRDF5TQ_cjs.StreamObjectError; }
-});
-Object.defineProperty(exports, "streamObjectImpl", {
-  enumerable: true,
-  get: function () { return chunkLYRDF5TQ_cjs.streamObjectImpl; }
-});
-//# sourceMappingURL=stream-object-ZJTQNKY3.cjs.map
-//# sourceMappingURL=stream-object-ZJTQNKY3.cjs.map

package/dist/subagents-loader-UCNO7FUH.cjs

@@ -1,17 +0,0 @@
-'use strict';
-
-var chunk43ZQRWAP_cjs = require('./chunk-43ZQRWAP.cjs');
-require('./chunk-AKJP2STZ.cjs');
-require('./chunk-4CLOXP6H.cjs');
-require('./chunk-4ZHTIJNE.cjs');
-require('./chunk-XL7Q7HB2.cjs');
-require('./chunk-EG4QM7ZJ.cjs');
-
-
-
-Object.defineProperty(exports, "loadSubagents", {
-  enumerable: true,
-  get: function () { return chunk43ZQRWAP_cjs.loadSubagents; }
-});
-//# sourceMappingURL=subagents-loader-UCNO7FUH.cjs.map
-//# sourceMappingURL=subagents-loader-UCNO7FUH.cjs.map

package/dist/subagents-loader-XP5ERVDZ.js

@@ -1,8 +0,0 @@
-export { loadSubagents } from './chunk-LKBEROHN.js';
-import './chunk-247ZTLNU.js';
-import './chunk-LXQ6HKPS.js';
-import './chunk-ZZMZWBR6.js';
-import './chunk-D4CUGAKZ.js';
-import './chunk-XEQ3TM66.js';
-//# sourceMappingURL=subagents-loader-XP5ERVDZ.js.map
-//# sourceMappingURL=subagents-loader-XP5ERVDZ.js.map