@theokit/sdk 1.8.0 → 1.9.0

package/dist/internal/runtime/{cloud-config-serializer.d.ts → cloud/cloud-config-serializer.d.ts}

@@ -1,3 +1,3 @@
-import type { AgentOptions } from "../../types/agent.js";
+import type { AgentOptions } from "../../../types/agent.js";
 import type { CloudAgentPayload } from "./cloud-payload-types.js";
 export declare function serializeCloudAgentConfig(options: AgentOptions): CloudAgentPayload;

package/dist/internal/runtime/{real-cloud-run.d.ts → cloud/real-cloud-run.d.ts}

@@ -1,2 +1,2 @@
-import type { Run } from "../../types/run.js";
+import type { Run } from "../../../types/run.js";
 export declare function createRealCloudRun(options: CreateRealCloudRunOptions): Run;

package/dist/internal/runtime/fixtures/fixture-scripts.d.ts

@@ -1,5 +1,5 @@
 import type { FixtureRequest, FixtureScript } from "./fixture-types.js";
-export { extractMemoryFact, isMemoryWritePrompt } from "../memory-store.js";
+export { extractMemoryFact, isMemoryWritePrompt } from "../memory/memory-store.js";
 export declare function isMemoryRecallPrompt(message: string, request: FixtureRequest): boolean;
 export declare function memoryWriteScript(request: FixtureRequest): FixtureScript;
 export declare function memoryRecallScript(request: FixtureRequest): FixtureScript;

package/dist/internal/runtime/fork-agent.d.ts

@@ -12,4 +12,4 @@
  *
  * @internal
  */
-export {};
+export type { ForkOptions, ForkResult } from "../../types/fork.js";

package/dist/internal/runtime/{local-agent-bootstrap.d.ts → local-agent/local-agent-bootstrap.d.ts}

@@ -7,10 +7,10 @@
  *
  * @internal
  */
-import { FileContextManager } from "./context/context-manager.js";
-import { type PluginMetadata, PluginsManager } from "./plugins/plugins-manager.js";
-import { ProvidersManagerImpl } from "./providers-manager.js";
-import { type SkillMetadata, SkillsManager } from "./skills-manager.js";
+import { FileContextManager } from "../context/context-manager.js";
+import { type PluginMetadata, PluginsManager } from "../plugins/plugins-manager.js";
+import { ProvidersManagerImpl } from "../providers-manager.js";
+import { type SkillMetadata, SkillsManager } from "../skills/skills-manager.js";
 export declare function registerLocalAgent(args: {
     agentId: string;
     model: ModelSelection | undefined;

package/dist/internal/runtime/{local-agent-dispatch.d.ts → local-agent/local-agent-dispatch.d.ts}

@@ -4,13 +4,13 @@
  *
  * @internal
  */
-import type { AgentDefinition, AgentOptions, ModelSelection } from "../../types/agent.js";
-import type { Run, SDKUserMessage, SendOptions } from "../../types/run.js";
-import type { MemoryToolSpec } from "../agent-loop/loop-types.js";
-import type { PersonalityPreset } from "../personality/types.js";
-import type { PluginManager } from "../plugins/manager.js";
-import type { HooksExecutor } from "./hooks-executor.js";
-import type { MemoryFact } from "./memory-store.js";
+import type { AgentDefinition, AgentOptions, ModelSelection } from "../../../types/agent.js";
+import type { Run, SDKUserMessage, SendOptions } from "../../../types/run.js";
+import type { MemoryToolSpec } from "../../agent-loop/loop-types.js";
+import type { PersonalityPreset } from "../../personality/types.js";
+import type { PluginManager } from "../../plugins/manager.js";
+import type { HooksExecutor } from "../hooks/hooks-executor.js";
+import type { MemoryFact } from "../memory/memory-store.js";
 import { createRealLocalRun } from "./real-local-run.js";
 export interface DispatchInputs {
     agentId: string;

package/dist/internal/runtime/{local-agent-memory-hooks.d.ts → local-agent/local-agent-memory-hooks.d.ts}

@@ -10,8 +10,8 @@
  *
  * @internal
  */
-import type { Run, SDKUserMessage, SendOptions } from "../../types/run.js";
-import type { PluginManager } from "../plugins/manager.js";
+import type { Run, SDKUserMessage, SendOptions } from "../../../types/run.js";
+import type { PluginManager } from "../../plugins/manager.js";
 /**
  * EC-A + EC-G + EC-H: fire `pre_user_send` hooks, cap recalled context,
  * and prepend it as a `<memory-context>` fence around the original

package/dist/internal/runtime/{local-agent-memory-provider.d.ts → local-agent/local-agent-memory-provider.d.ts}

@@ -25,8 +25,8 @@
  * @internal — sdk-core's bridging glue. Replaced by sdk-memory rich impl
  * in Stage 3.
  */
-import type { TelemetryHandle } from "../telemetry/tracer.js";
-import type { MemoryProvider } from "./memory-provider.js";
+import type { TelemetryHandle } from "../../telemetry/tracer.js";
+import type { MemoryProvider } from "../memory/memory-provider.js";
 /**
  * Options for `createLocalAgentMemoryProvider`. Mirrors what
  * `LocalAgentMemory`'s constructor needs.

package/dist/internal/runtime/{real-local-run.d.ts → local-agent/real-local-run.d.ts}

@@ -1,2 +1,2 @@
-import type { Run } from "../../types/run.js";
+import type { Run } from "../../../types/run.js";
 export declare function createRealLocalRun(options: CreateRealLocalRunOptions): Run;

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

@@ -19,7 +19,7 @@
  *
  * @internal
  */
-import type { MemoryToolSpec } from "../agent-loop/loop-types.js";
+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";

package/dist/internal/runtime/{memory-provider.d.ts → memory/memory-provider.d.ts}

@@ -28,8 +28,8 @@
  *
  * @public — surface-level interface; impls are internal-but-replaceable.
  */
-import type { CustomTool, SDKAgent } from "../../types/agent.js";
-import type { MemoryAdapter, MemoryFact } from "../../types/memory-adapter.js";
+import type { CustomTool, SDKAgent } from "../../../types/agent.js";
+import type { MemoryAdapter, MemoryFact } from "../../../types/memory-adapter.js";
 /** Result of `MemoryProvider.runActivePass(...)` — what the kernel injects into the LLM call. */
 export interface ActiveMemoryPassResult {
     /** Compressed memory facts to seed the LLM's context window for this turn. */

package/dist/internal/runtime/{memory-store.d.ts → memory/memory-store.d.ts}

@@ -1,4 +1,4 @@
-import { type MemoryConfig, type MemoryFact, redactSecrets } from "../memory/types.js";
+import { type MemoryConfig, type MemoryFact, redactSecrets } from "../../memory/types.js";
 export { redactSecrets };
 export declare function readMemoryFacts(cwd: string, config: MemoryConfig): Promise<MemoryFact[]>;
 export declare function appendMemoryFact(cwd: string, config: MemoryConfig, fact: MemoryFact): Promise<void>;

package/dist/internal/runtime/skills/subagents-loader.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/agent.d.ts

@@ -478,7 +478,7 @@ export interface AgentOptions {
      *
      * @public
      */
-    budgetTracker?: import("../internal/runtime/budget-tracker.js").BudgetTracker;
+    budgetTracker?: import("../internal/runtime/budget/budget-tracker.js").BudgetTracker;
     /**
      * Pluggable memory subsystem (SDK 2.0 Phase 1 / T1.3 — Hexagonal
      * Architecture interface inversion). When provided, the agent loop
@@ -502,7 +502,7 @@ export interface AgentOptions {
      *
      * @public
      */
-    memoryProvider?: import("../internal/runtime/memory-provider.js").MemoryProvider;
+    memoryProvider?: import("../internal/runtime/memory/memory-provider.js").MemoryProvider;
 }
 /**
  * Artifact produced inside an agent's workspace. Cloud-only.
@@ -607,7 +607,7 @@ export interface SDKAgent {
      *
      * @public
      */
-    fork?(options: import("../internal/runtime/fork-agent.js").ForkOptions): Promise<import("../internal/runtime/fork-agent.js").ForkResult>;
+    fork?(options: import("./fork.js").ForkOptions): Promise<import("./fork.js").ForkResult>;
     /**
      * Direct API to third-party memory adapter(s) registered via
      * `plugins: [...]` (ADR D141 / D142). Returns `null` when no adapter

package/dist/types/fork.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 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
+ */
+export 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
+ */
+export 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;
+    };
+}

package/dist/types/goal-events.d.ts

@@ -64,7 +64,7 @@ export 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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theokit/sdk",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "description": "TypeScript SDK for the Theo agent harness — same surface, local or cloud.",
   "license": "Apache-2.0",
   "homepage": "https://github.com/usetheo/theokit-sdk#readme",
@@ -214,15 +214,6 @@
     "theokit-migrate-memory": "./bin/theokit-migrate-memory.mjs"
   },
   "sideEffects": false,
-  "scripts": {
-    "build": "tsup && cp src/internal/providers/provider-catalog.json dist/provider-catalog.json",
-    "test": "vitest run --no-file-parallelism",
-    "test:watch": "vitest",
-    "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist",
-    "docs:json": "typedoc --options typedoc.json",
-    "docs:drift": "tsx scripts/check-docs-drift.ts"
-  },
   "peerDependencies": {
     "@lancedb/lancedb": "^0.30.0",
     "@types/ws": ">=8.0.0",
@@ -256,8 +247,7 @@
     }
   },
   "publishConfig": {
-    "access": "public",
-    "provenance": true
+    "access": "public"
   },
   "keywords": [
     "agent",
@@ -280,8 +270,6 @@
   "devDependencies": {
     "@opentelemetry/api": "^1.9.1",
     "@opentelemetry/sdk-trace-base": "^1.30.1",
-    "@theokit/sdk-handoff": "workspace:*",
-    "@theokit/sdk-memory": "workspace:*",
     "@types/better-sqlite3": "^7.6.13",
     "@types/proper-lockfile": "^4.1.4",
     "@types/ws": "^8.18.0",
@@ -291,6 +279,17 @@
     "sqlite-vec": "^0.1.9",
     "typedoc": "^0.28.19",
     "ws": "^8.18.0",
-    "zod": "^4.0.0"
+    "zod": "^4.0.0",
+    "@theokit/sdk-handoff": "0.1.0",
+    "@theokit/sdk-memory": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsup && cp src/internal/providers/provider-catalog.json dist/provider-catalog.json",
+    "test": "vitest run --no-file-parallelism",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "docs:json": "typedoc --options typedoc.json",
+    "docs:drift": "tsx scripts/check-docs-drift.ts"
   }
-}
+}