@theokit/sdk 5.6.0 → 5.8.0

package/dist/subagents-loader.cjs

@@ -1,9 +1,9 @@
 'use strict';
 
-var chunkRWPLWMCZ_cjs = require('./chunk-RWPLWMCZ.cjs');
+var chunkXW4POZ6V_cjs = require('./chunk-XW4POZ6V.cjs');
 require('./chunk-TY56BKSK.cjs');
-require('./chunk-QRVS2PRE.cjs');
-var chunkJ7J7J2GN_cjs = require('./chunk-J7J7J2GN.cjs');
+require('./chunk-MPR2ISL2.cjs');
+var chunkUNFBHV46_cjs = require('./chunk-UNFBHV46.cjs');
 require('./chunk-6LHQPOMI.cjs');
 
 // src/subagents-loader.ts
@@ -13,7 +13,7 @@ function resolveSources(options) {
   if (declared === void 0) return ACCEPTED_SOURCES;
   for (const source of declared) {
     if (!ACCEPTED_SOURCES.includes(source)) {
-      throw new chunkJ7J7J2GN_cjs.ConfigurationError(
+      throw new chunkUNFBHV46_cjs.ConfigurationError(
         `Unknown subagent setting source "${String(source)}" (accepted: ${ACCEPTED_SOURCES.join(", ")})`,
         { code: "subagent_unknown_setting_source" }
       );
@@ -23,7 +23,7 @@ function resolveSources(options) {
 }
 async function discoverSubagents(cwd, options) {
   const sources = resolveSources(options);
-  return chunkRWPLWMCZ_cjs.loadSubagents(cwd, sources.includes("project"), void 0, options?.compatSources ?? []);
+  return chunkXW4POZ6V_cjs.loadSubagents(cwd, sources.includes("project"), void 0, options?.compatSources ?? []);
 }
 async function loadSubagentDefinition(name, cwd, options) {
   return (await discoverSubagents(cwd, options))[name];

package/dist/subagents-loader.d.cts

@@ -1,6 +1,6 @@
-import { a as AgentDefinition } from './agent-82d_DrCL.cjs';
-import './sdk-agent-BOiKqOgL.cjs';
-import './run-CTAdRU3U.cjs';
+import { a as AgentDefinition } from './agent-3RcPVGMo.cjs';
+import './sdk-agent-dNwjwCt5.cjs';
+import './run-DsA5Ip2i.cjs';
 import 'zod';
 
 /**

package/dist/subagents-loader.d.ts

@@ -1,6 +1,6 @@
-import { a as AgentDefinition } from './agent-G6g-uwcB.js';
-import './sdk-agent-D4a_BR_6.js';
-import './run-CTAdRU3U.js';
+import { a as AgentDefinition } from './agent-lS68mYIL.js';
+import './sdk-agent-wEOLXD3F.js';
+import './run-DsA5Ip2i.js';
 import 'zod';
 
 /**

package/dist/subagents-loader.js

@@ -1,7 +1,7 @@
-import { loadSubagents } from './chunk-T3ZDEYTJ.js';
+import { loadSubagents } from './chunk-W4VQMXBZ.js';
 import './chunk-X7EUUHXU.js';
-import './chunk-UOLBAPDM.js';
-import { ConfigurationError } from './chunk-ALUN2B4W.js';
+import './chunk-MQGSOKR3.js';
+import { ConfigurationError } from './chunk-B5MHRQJZ.js';
 import './chunk-CZJ6Q7CW.js';
 
 // src/subagents-loader.ts

package/dist/subscription/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkJ7J7J2GN_cjs = require('../chunk-J7J7J2GN.cjs');
+var chunkUNFBHV46_cjs = require('../chunk-UNFBHV46.cjs');
 require('../chunk-6LHQPOMI.cjs');
 
 // src/subscription/define-subscription.ts
@@ -138,7 +138,7 @@ function tracked(id, payload) {
   }
   return [id, payload];
 }
-var SubscriptionError = class extends chunkJ7J7J2GN_cjs.TheokitAgentError {
+var SubscriptionError = class extends chunkUNFBHV46_cjs.TheokitAgentError {
   name = "SubscriptionError";
   constructor(message, options = {}) {
     super(message, { ...options, isRetryable: false });
@@ -401,6 +401,7 @@ exports.Subscription = Subscription;
 exports.SubscriptionDisconnectError = SubscriptionDisconnectError;
 exports.SubscriptionError = SubscriptionError;
 exports.SubscriptionInputError = SubscriptionInputError;
+exports.defineSubscription = defineSubscription;
 exports.isTrackedEnvelope = isTrackedEnvelope;
 exports.subscribe = subscribe;
 exports.tracked = tracked;

package/dist/subscription/index.d.cts

@@ -15,6 +15,6 @@
  *
  * @public
  */
-export { type DefineSubscriptionOptions, Subscription, } from "./define-subscription.js";
+export { type DefineSubscriptionOptions, defineSubscription, Subscription, } from "./define-subscription.js";
 export { type SubscribeOptions, subscribe } from "./theokit-subscribe.js";
 export { isTrackedEnvelope, type SubscriptionCtx, type SubscriptionDescriptor, SubscriptionDisconnectError, SubscriptionError, SubscriptionInputError, type SubscriptionTransport, type TrackedEnvelope, tracked, } from "./types.js";

package/dist/subscription/index.d.ts

@@ -15,6 +15,6 @@
  *
  * @public
  */
-export { type DefineSubscriptionOptions, Subscription, } from "./define-subscription.js";
+export { type DefineSubscriptionOptions, defineSubscription, Subscription, } from "./define-subscription.js";
 export { type SubscribeOptions, subscribe } from "./theokit-subscribe.js";
 export { isTrackedEnvelope, type SubscriptionCtx, type SubscriptionDescriptor, SubscriptionDisconnectError, SubscriptionError, SubscriptionInputError, type SubscriptionTransport, type TrackedEnvelope, tracked, } from "./types.js";

package/dist/subscription/index.js

@@ -1,4 +1,4 @@
-import { TheokitAgentError } from '../chunk-ALUN2B4W.js';
+import { TheokitAgentError } from '../chunk-B5MHRQJZ.js';
 import '../chunk-CZJ6Q7CW.js';
 
 // src/subscription/define-subscription.ts
@@ -395,6 +395,6 @@ function sleep(ms, signal) {
   });
 }
 
-export { Subscription, SubscriptionDisconnectError, SubscriptionError, SubscriptionInputError, isTrackedEnvelope, subscribe, tracked };
+export { Subscription, SubscriptionDisconnectError, SubscriptionError, SubscriptionInputError, defineSubscription, isTrackedEnvelope, subscribe, tracked };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/task-store.cjs

@@ -1,23 +1,23 @@
 'use strict';
 
-var chunkHCT4HPCL_cjs = require('./chunk-HCT4HPCL.cjs');
+var chunkGHHIJEFX_cjs = require('./chunk-GHHIJEFX.cjs');
 require('./chunk-JLRLCBJ4.cjs');
-require('./chunk-J7J7J2GN.cjs');
+require('./chunk-UNFBHV46.cjs');
 require('./chunk-6LHQPOMI.cjs');
 
 
 
 Object.defineProperty(exports, "InMemoryTaskStore", {
   enumerable: true,
-  get: function () { return chunkHCT4HPCL_cjs.InMemoryTaskStore; }
+  get: function () { return chunkGHHIJEFX_cjs.InMemoryTaskStore; }
 });
 Object.defineProperty(exports, "JsonFileTaskStore", {
   enumerable: true,
-  get: function () { return chunkHCT4HPCL_cjs.JsonFileTaskStore; }
+  get: function () { return chunkGHHIJEFX_cjs.JsonFileTaskStore; }
 });
 Object.defineProperty(exports, "getTaskStoreFor", {
   enumerable: true,
-  get: function () { return chunkHCT4HPCL_cjs.getTaskStoreFor; }
+  get: function () { return chunkGHHIJEFX_cjs.getTaskStoreFor; }
 });
 //# sourceMappingURL=task-store.cjs.map
 //# sourceMappingURL=task-store.cjs.map

package/dist/task-store.js

@@ -1,6 +1,6 @@
-export { InMemoryTaskStore, JsonFileTaskStore, getTaskStoreFor } from './chunk-EIQFAOFD.js';
+export { InMemoryTaskStore, JsonFileTaskStore, getTaskStoreFor } from './chunk-GGRPAQ3B.js';
 import './chunk-3JHIFQ4I.js';
-import './chunk-ALUN2B4W.js';
+import './chunk-B5MHRQJZ.js';
 import './chunk-CZJ6Q7CW.js';
 //# sourceMappingURL=task-store.js.map
 //# sourceMappingURL=task-store.js.map

package/dist/types/agent.d.ts

@@ -31,7 +31,7 @@ export type SettingSource = "project" | "user" | "team" | "mdm" | "plugins" | "a
  *
  * @public
  */
-export type CompatSource = "claude-code" | "theokit" | CompatSourceAdapter;
+export type CompatSource = "claude-code" | "theokit" | "agents" | "gemini" | "cursor" | CompatSourceAdapter;
 /**
  * A surface a foreign configuration source may be admitted to.
  *

package/dist/workflow.cjs

@@ -1,100 +1,100 @@
 'use strict';
 
-var chunk4HS6FFGL_cjs = require('./chunk-4HS6FFGL.cjs');
-var chunk4A3SKJ53_cjs = require('./chunk-4A3SKJ53.cjs');
+var chunkMPQJE3G4_cjs = require('./chunk-MPQJE3G4.cjs');
+var chunk6PB5AQCY_cjs = require('./chunk-6PB5AQCY.cjs');
 require('./chunk-VTYY7XL5.cjs');
 require('./chunk-AA27GEYS.cjs');
-require('./chunk-7A6535RA.cjs');
+require('./chunk-GM54F4FE.cjs');
 require('./chunk-SA6K24NB.cjs');
 require('./chunk-JLRLCBJ4.cjs');
-require('./chunk-J7J7J2GN.cjs');
+require('./chunk-UNFBHV46.cjs');
 require('./chunk-6LHQPOMI.cjs');
 
 
 
 Object.defineProperty(exports, "Workflow", {
   enumerable: true,
-  get: function () { return chunk4HS6FFGL_cjs.Workflow; }
+  get: function () { return chunkMPQJE3G4_cjs.Workflow; }
 });
 Object.defineProperty(exports, "WorkflowBuilder", {
   enumerable: true,
-  get: function () { return chunk4HS6FFGL_cjs.WorkflowBuilder; }
+  get: function () { return chunkMPQJE3G4_cjs.WorkflowBuilder; }
 });
 Object.defineProperty(exports, "WorkflowToolError", {
   enumerable: true,
-  get: function () { return chunk4HS6FFGL_cjs.WorkflowToolError; }
+  get: function () { return chunkMPQJE3G4_cjs.WorkflowToolError; }
 });
 Object.defineProperty(exports, "agentStep", {
   enumerable: true,
-  get: function () { return chunk4HS6FFGL_cjs.agentStep; }
+  get: function () { return chunkMPQJE3G4_cjs.agentStep; }
 });
 Object.defineProperty(exports, "cloneWorkflow", {
   enumerable: true,
-  get: function () { return chunk4HS6FFGL_cjs.cloneWorkflow; }
+  get: function () { return chunkMPQJE3G4_cjs.cloneWorkflow; }
 });
 Object.defineProperty(exports, "fn", {
   enumerable: true,
-  get: function () { return chunk4HS6FFGL_cjs.fn; }
+  get: function () { return chunkMPQJE3G4_cjs.fn; }
 });
 Object.defineProperty(exports, "workflowAsTool", {
   enumerable: true,
-  get: function () { return chunk4HS6FFGL_cjs.workflowAsTool; }
+  get: function () { return chunkMPQJE3G4_cjs.workflowAsTool; }
 });
 Object.defineProperty(exports, "workflowStep", {
   enumerable: true,
-  get: function () { return chunk4HS6FFGL_cjs.workflowStep; }
+  get: function () { return chunkMPQJE3G4_cjs.workflowStep; }
 });
 Object.defineProperty(exports, "WorkflowAlreadyRunningError", {
   enumerable: true,
-  get: function () { return chunk4A3SKJ53_cjs.WorkflowAlreadyRunningError; }
+  get: function () { return chunk6PB5AQCY_cjs.WorkflowAlreadyRunningError; }
 });
 Object.defineProperty(exports, "WorkflowCompensateNotImplementedError", {
   enumerable: true,
-  get: function () { return chunk4A3SKJ53_cjs.WorkflowCompensateNotImplementedError; }
+  get: function () { return chunk6PB5AQCY_cjs.WorkflowCompensateNotImplementedError; }
 });
 Object.defineProperty(exports, "WorkflowDuplicateStepIdError", {
   enumerable: true,
-  get: function () { return chunk4A3SKJ53_cjs.WorkflowDuplicateStepIdError; }
+  get: function () { return chunk6PB5AQCY_cjs.WorkflowDuplicateStepIdError; }
 });
 Object.defineProperty(exports, "WorkflowInputError", {
   enumerable: true,
-  get: function () { return chunk4A3SKJ53_cjs.WorkflowInputError; }
+  get: function () { return chunk6PB5AQCY_cjs.WorkflowInputError; }
 });
 Object.defineProperty(exports, "WorkflowMaxIterationsExceededError", {
   enumerable: true,
-  get: function () { return chunk4A3SKJ53_cjs.WorkflowMaxIterationsExceededError; }
+  get: function () { return chunk6PB5AQCY_cjs.WorkflowMaxIterationsExceededError; }
 });
 Object.defineProperty(exports, "WorkflowNestedError", {
   enumerable: true,
-  get: function () { return chunk4A3SKJ53_cjs.WorkflowNestedError; }
+  get: function () { return chunk6PB5AQCY_cjs.WorkflowNestedError; }
 });
 Object.defineProperty(exports, "WorkflowNotSerializableError", {
   enumerable: true,
-  get: function () { return chunk4A3SKJ53_cjs.WorkflowNotSerializableError; }
+  get: function () { return chunk6PB5AQCY_cjs.WorkflowNotSerializableError; }
 });
 Object.defineProperty(exports, "WorkflowOutputError", {
   enumerable: true,
-  get: function () { return chunk4A3SKJ53_cjs.WorkflowOutputError; }
+  get: function () { return chunk6PB5AQCY_cjs.WorkflowOutputError; }
 });
 Object.defineProperty(exports, "WorkflowParallelError", {
   enumerable: true,
-  get: function () { return chunk4A3SKJ53_cjs.WorkflowParallelError; }
+  get: function () { return chunk6PB5AQCY_cjs.WorkflowParallelError; }
 });
 Object.defineProperty(exports, "WorkflowResumeStepNotFoundError", {
   enumerable: true,
-  get: function () { return chunk4A3SKJ53_cjs.WorkflowResumeStepNotFoundError; }
+  get: function () { return chunk6PB5AQCY_cjs.WorkflowResumeStepNotFoundError; }
 });
 Object.defineProperty(exports, "WorkflowSnapshotNotFoundError", {
   enumerable: true,
-  get: function () { return chunk4A3SKJ53_cjs.WorkflowSnapshotNotFoundError; }
+  get: function () { return chunk6PB5AQCY_cjs.WorkflowSnapshotNotFoundError; }
 });
 Object.defineProperty(exports, "WorkflowStateError", {
   enumerable: true,
-  get: function () { return chunk4A3SKJ53_cjs.WorkflowStateError; }
+  get: function () { return chunk6PB5AQCY_cjs.WorkflowStateError; }
 });
 Object.defineProperty(exports, "__resetSnapshotStoresForTests", {
   enumerable: true,
-  get: function () { return chunk4A3SKJ53_cjs.__resetSnapshotStoresForTests; }
+  get: function () { return chunk6PB5AQCY_cjs.__resetSnapshotStoresForTests; }
 });
 //# sourceMappingURL=workflow.cjs.map
 //# sourceMappingURL=workflow.cjs.map

package/dist/workflow.d.cts

@@ -1,6 +1,6 @@
 import { ZodType, z } from 'zod';
-import { S as SDKAgent } from './sdk-agent-BOiKqOgL.cjs';
-import { t as MessageOrigin, C as CustomTool } from './run-CTAdRU3U.cjs';
+import { S as SDKAgent } from './sdk-agent-dNwjwCt5.cjs';
+import { t as MessageOrigin, C as CustomTool } from './run-DsA5Ip2i.cjs';
 import { T as TheokitAgentError } from './errors-base-B5g01neU.cjs';
 
 /**

package/dist/workflow.d.ts

@@ -1,6 +1,6 @@
 import { ZodType, z } from 'zod';
-import { S as SDKAgent } from './sdk-agent-D4a_BR_6.js';
-import { t as MessageOrigin, C as CustomTool } from './run-CTAdRU3U.js';
+import { S as SDKAgent } from './sdk-agent-wEOLXD3F.js';
+import { t as MessageOrigin, C as CustomTool } from './run-DsA5Ip2i.js';
 import { T as TheokitAgentError } from './errors-base-B5g01neU.js';
 
 /**

package/dist/workflow.js

@@ -1,11 +1,11 @@
-export { Workflow, WorkflowBuilder, WorkflowToolError, agentStep, cloneWorkflow, fn, workflowAsTool, workflowStep } from './chunk-HFEJE7AC.js';
-export { WorkflowAlreadyRunningError, WorkflowCompensateNotImplementedError, WorkflowDuplicateStepIdError, WorkflowInputError, WorkflowMaxIterationsExceededError, WorkflowNestedError, WorkflowNotSerializableError, WorkflowOutputError, WorkflowParallelError, WorkflowResumeStepNotFoundError, WorkflowSnapshotNotFoundError, WorkflowStateError, __resetSnapshotStoresForTests } from './chunk-GBCVPKHE.js';
+export { Workflow, WorkflowBuilder, WorkflowToolError, agentStep, cloneWorkflow, fn, workflowAsTool, workflowStep } from './chunk-MU7IAA7G.js';
+export { WorkflowAlreadyRunningError, WorkflowCompensateNotImplementedError, WorkflowDuplicateStepIdError, WorkflowInputError, WorkflowMaxIterationsExceededError, WorkflowNestedError, WorkflowNotSerializableError, WorkflowOutputError, WorkflowParallelError, WorkflowResumeStepNotFoundError, WorkflowSnapshotNotFoundError, WorkflowStateError, __resetSnapshotStoresForTests } from './chunk-HV4V63CO.js';
 import './chunk-HY66GLM6.js';
 import './chunk-7I5Z3UBJ.js';
-import './chunk-EH6XD3FY.js';
+import './chunk-5DD4NJN3.js';
 import './chunk-UKMBRMGT.js';
 import './chunk-3JHIFQ4I.js';
-import './chunk-ALUN2B4W.js';
+import './chunk-B5MHRQJZ.js';
 import './chunk-CZJ6Q7CW.js';
 //# sourceMappingURL=workflow.js.map
 //# sourceMappingURL=workflow.js.map

package/docs/error-codes.md

@@ -45,7 +45,7 @@ Branch on `code`, never on the message: messages carry context (an id, a path, a
 | `cloud_run_unknown_status` | domain | NetworkError | `packages/sdk/src/internal/cloud-agent/real-cloud-run.ts:284` +1 |
 | `cloud_runtime_pre_release` | domain | ConfigurationError | `packages/sdk/src/agent.ts:417` +2 |
 | `cloud_stdio_cwd_rejected` | domain | ConfigurationError | `packages/sdk/src/internal/runtime/validation/validate-agent-options.ts:121` |
-| `compression_failed` | domain | — | `packages/sdk/src/internal/runtime/compression/compression-summarizer.ts:41` |
+| `compression_failed` | domain | — | `packages/sdk/src/errors.ts:700` |
 | `compression_model_unresolved` | domain | — | `packages/sdk/src/internal/runtime/compression/compression-model-registry.ts:102` +1 |
 | `context_config_shape` | domain | ConfigurationError | `packages/sdk/src/internal/runtime/context/context-manager.ts:288` |
 | `context_frontmatter_invalid` | domain | ConfigurationError | `packages/sdk/src/internal/runtime/context/context-frontmatter.ts:38` |

package/docs/harness-capability-map.md

@@ -4,7 +4,7 @@ Every public symbol the TheoKit workspace publishes, and the exact specifier to
 
 A symbol listed under two specifiers is reachable from both, but that does NOT make the two interchangeable: a class emitted separately into a subpath entry is a distinct nominal type from the one in the root bundle, so passing one where the other is expected fails on a private field. When a symbol appears twice, import it and everything it is passed to from the SAME specifier.
 
-1212 export(s) across 46 entry point(s).
+1228 export(s) across 46 entry point(s).
 
 ## `@theokit/acp`
 
@@ -61,6 +61,7 @@ A symbol listed under two specifiers is reachable from both, but that does NOT m
 | `ActiveMemoryPassResult` | interface | Result of `MemoryProvider.runActivePass(...)` — what the kernel injects into the LLM call. |
 | `Agent` | class | Static façade for creating and managing Theo agents. |
 | `AgentBuilder` | class | Fluent builder for {@link AgentOptions } .  |
+| `AgentBuilderDeps` | interface | Terminal-method callbacks injected by `Agent.builder()` so that `agent-builder.ts` does NOT need a static import of `Agent` — keeps the dependency graph acyclic (G6).  |
 | `AgentConversationTurn` | interface | Agent turn: user message + assistant/tool/thinking steps. |
 | `AgentDefinition` | interface | Subagent definition.  |
 | `AgentDescription` | interface | theokit#123 — the read-only introspection of a registered agent, returned by `Agent.describe()`.  |
@@ -136,6 +137,8 @@ A symbol listed under two specifiers is reachable from both, but that does NOT m
 | `CounterBudgetTrackerOptions` | interface | Options for `createCounterBudgetTracker`. |
 | `createCounterBudgetTracker` | function | Build a fresh tracker.  |
 | `CreateSkillSpec` | interface | Spec accepted by {@link createSkill } . |
+| `createTokenLimiter` | function | SE25 — a processor that caps text to a token budget.  |
+| `createUnicodeNormalizer` | function | SE25 — an input processor that normalizes user text: Unicode NFC (so canonically-equivalent sequences compare equal) plus optional control-char stripping and whitespace collapsing.  |
 | `CredentialInput` | interface | One provider's credential lookup, as the product resolved it.  |
 | `CredentialReport` | interface | A presence-only view of one credential, safe to print, log, or attach to a support bundle.  |
 | `Cron` | class | Static façade for scheduling Theo agent runs on a cron expression. |
@@ -166,6 +169,7 @@ A symbol listed under two specifiers is reachable from both, but that does NOT m
 | `effectiveToolNames` | function | The tool names an agent created with `options` will offer the model, as far as the options can say.  |
 | `emitRunEvent` | function | SE2 — emit a {@link RunEvent } to an optional sink, swallowing any sink error so observability can never break the run (fail-safe, mirrors the EventBus EC-2 contract).  |
 | `EnvOptOut` | interface | A key deliberately left off the environment, with the reason and what would reverse it. |
+| `EnvPolicy` | type | Owner: `sandbox/` (1 of 2 importers).  |
 | `EnvReachabilityAudit` | interface | The two failures, reported separately because they have opposite fixes.  |
 | `EnvReachabilityInput` | interface | The three lists the audit compares: every key the product declares, the subset an environment variable can set, and the documented exemptions.  |
 | `ErrorCode` | type | Finite, machine-readable error codes for provider-originated errors (ADR D66).  |
@@ -177,6 +181,8 @@ A symbol listed under two specifiers is reachable from both, but that does NOT m
 | `extractRawId` | function | Extract the raw provider id from a `MemoryId`, enforcing that the prefix matches `expectedAdapterId`.  |
 | `fn` | function | Build a `FnStep`.  |
 | `foldLayers` | function | Combine `entries` into one record.  |
+| `ForkOptions` | interface | Caller-supplied fork configuration.  |
+| `ForkResult` | interface | Outcome of a fork run. |
 | `GenerateObjectError` | class | Typed error thrown by {@link Agent.generateObject } when the model refuses to call the synthetic `output` tool or when retries are exhausted. |
 | `GenerateObjectOptions` | interface | Options accepted by {@link Agent.generateObject } .  |
 | `GenerateObjectResult` | interface | Successful return from {@link Agent.generateObject } . |
@@ -191,6 +197,8 @@ A symbol listed under two specifiers is reachable from both, but that does NOT m
 | `GoalOptions` | interface | Per-call configuration for `Agent.runUntil`. |
 | `GoalResult` | interface | Return value of the `runUntil` async generator.  |
 | `guardSessionDestruction` | function | Throw unless `sessionId` is safe to destroy. |
+| `HookApprovalGate` | interface | #631 — a consumer's decision point before this package spawns a hook.  |
+| `HookApprovalRequest` | interface | #631 — what the consumer is shown when asked to approve a hook.  |
 | `HookName` | type | The fixed set of points a `"general"` plugin may attach to through `PluginContext.on`.  |
 | `ImageBlock` | interface | SE7 — a base64-encoded image block a tool can hand back as (part of) its result or its `ToolError`.  |
 | `inferApiMode` | function | Guess which usage shape a provider reports, from its name alone.  |
@@ -217,6 +225,7 @@ A symbol listed under two specifiers is reachable from both, but that does NOT m
 | `LiveAgentRegistry` | class | An LRU-plus-idle cache of live `SDKAgent` instances, reached through `Agent.registry`.  |
 | `LiveSessionError` | class | Raised by `guardSessionDestruction` instead of letting a session be destroyed.  |
 | `LiveSessionReason` | type | Why the destruction was refused. |
+| `LlmCallContext` | interface | #65 — context for the `pre_llm_call` / `post_llm_call` hooks. |
 | `loadProjectEnv` | function | Read the project's `.env` into `env`, then restore every {@link SOVEREIGN_ENV_KEYS } entry to the value it had BEFORE the load — including restoring it to absent.  |
 | `LocalOptions` | interface | Local agent configuration.  |
 | `ManagedSettings` | interface | What an operator may impose.  |
@@ -436,6 +445,7 @@ A symbol listed under two specifiers is reachable from both, but that does NOT m
 | `ToolCallCompletedUpdate` | interface | Tool call completed. |
 | `ToolCallStartedUpdate` | interface | Tool call started — args committed. |
 | `ToolCallSummary` | interface | M82 — one tool call of the turn, as seen by `transform_tool_result`.  |
+| `ToolContext` | interface | #65 — a 2nd argument passed to a tool handler, carrying the run's cancellation signal (ties into #58) so a cooperative tool can stop when the run is cancelled.  |
 | `ToolContextMessage` | interface | SE12 — a read-only, text-only projection of one turn of the run's conversation, exposed to a tool handler via `ctx.messages`.  |
 | `ToolError` | class | Thrown from a tool `handler` to surface a failure to the model.  |
 | `ToolResult` | interface | Result of a tool invocation.  |
@@ -895,6 +905,8 @@ A symbol listed under two specifiers is reachable from both, but that does NOT m
 | `compactTranscript` | function | Compact a transcript.  |
 | `CompactTranscriptOptions` | interface | Options for {@link compactTranscript } . |
 | `CompressibleMessage` | interface | Minimal message shape for compaction/compression input.  |
+| `CompressionConfig` | interface | Consumer-facing compression options on `Agent.create`. |
+| `CompressionModelUnresolvedError` | class | T2.2 — Typed error thrown when `resolveCompressionModel` cannot find a same-family-cheaper-tier mapping for `agentModel`.  |
 | `CONTEXT_WINDOW_FLOOR` | const | M77 — the floor used ONLY when neither the catalog nor the caller knows the window.  |
 | `CONTEXT_WINDOW_MARGIN` | const | M77 — default safety margin on the context window.  |
 | `ContextWindowMarginError` | class | M77 — the margin is outside `(0, 1]`.  |
@@ -932,6 +944,8 @@ A symbol listed under two specifiers is reachable from both, but that does NOT m
 | `ResolveContextImportsOptions` | interface | Options for {@link resolveContextImports } .  |
 | `runDiscovery` | function | Find, read and parse every context file the specs describe, and return them ready for the aggregator.  |
 | `shouldActivateRule` | function | Decide whether a parsed rule applies to this turn, given the files in scope.  |
+| `WithheldSpec` | interface | A spec a declaration did not admit, with the grant that would.  |
+| `withheldSpecs` | function | The mirror of {@link admittedSpecs } : the specs a declaration did NOT admit.  |
 
 ## `@theokit/sdk/cron`
 
@@ -949,6 +963,7 @@ A symbol listed under two specifiers is reachable from both, but that does NOT m
 | `AuthenticationError` | class | Invalid API key, not logged in, insufficient permissions. |
 | `BudgetExceededError` | class | Thrown by `Budget` enforcement (ADR D386) when a `mode: "block"` budget would be exceeded by the upcoming LLM call.  |
 | `coerceToKnownAgentRunErrorCode` | function | T1.1 boundary helper — coerce an arbitrary string (typically arriving from a downstream `RunErrorDetail.code` or a deserialized cloud response) into a `KnownAgentRunErrorCode`.  |
+| `CompressionFailedError` | class | Compression of a conversation failed.  |
 | `ConfigurationError` | class | Invalid model, bad request parameters, malformed options. |
 | `CredentialPoolExhaustedError` | class | Thrown when every credential in a per-provider pool is in cooldown and no healthy key is available (ADR D133).  |
 | `ErrorCode` | type | Finite, machine-readable error codes for provider-originated errors (ADR D66).  |
@@ -1376,6 +1391,7 @@ A symbol listed under two specifiers is reachable from both, but that does NOT m
 
 | Symbol | Kind | Summary |
 |---|---|---|
+| `defineSubscription` | function | Define a typed subscription.  |
 | `DefineSubscriptionOptions` | interface | Options accepted by {@link defineSubscription } . |
 | `isTrackedEnvelope` | function | Type guard for {@link TrackedEnvelope } . |
 | `subscribe` | function | Subscribe to a typed subscription.  |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theokit/sdk",
-  "version": "5.6.0",
+  "version": "5.8.0",
   "description": "TypeScript SDK for the Theo agent harness — same surface, local or cloud.",
   "license": "Apache-2.0",
   "homepage": "https://github.com/usetheokit/theokit-sdk#readme",

package/dist/agent-47NS6ZVL.cjs

@@ -1,67 +0,0 @@
-'use strict';
-
-var chunkGCHZMH42_cjs = require('./chunk-GCHZMH42.cjs');
-require('./chunk-KVSAY6NZ.cjs');
-require('./chunk-DZG77WU7.cjs');
-require('./chunk-BUUUWQMB.cjs');
-require('./chunk-VUHXC74Q.cjs');
-require('./chunk-7IZKTQ5G.cjs');
-require('./chunk-BV2MWEMV.cjs');
-require('./chunk-D6POWE7E.cjs');
-require('./chunk-GHX4P3V2.cjs');
-require('./chunk-TMKTSYDS.cjs');
-require('./chunk-GFFBXSQT.cjs');
-require('./chunk-7FDKWDA2.cjs');
-require('./chunk-C4ZQPWXJ.cjs');
-require('./chunk-FUSDYC2B.cjs');
-require('./chunk-YJNYDJ2T.cjs');
-require('./chunk-24SYBZPL.cjs');
-require('./chunk-QOGNZMHD.cjs');
-require('./chunk-YIFFF23U.cjs');
-require('./chunk-2ZPEDVLM.cjs');
-require('./chunk-EIOMN5VA.cjs');
-require('./chunk-KRD3GQAA.cjs');
-require('./chunk-RQMCOFAI.cjs');
-require('./chunk-MUUQ2WFJ.cjs');
-require('./chunk-AA27GEYS.cjs');
-require('./chunk-YSTXFWQE.cjs');
-require('./chunk-FRITRLZQ.cjs');
-require('./chunk-NQTD6QOW.cjs');
-require('./chunk-NINIJCHU.cjs');
-require('./chunk-MYJGWS2J.cjs');
-require('./chunk-LD6HASA5.cjs');
-require('./chunk-IJ7M6GOG.cjs');
-require('./chunk-7A6535RA.cjs');
-require('./chunk-SA6K24NB.cjs');
-require('./chunk-I2PWY7VM.cjs');
-require('./chunk-KTTHHYEW.cjs');
-require('./chunk-Z3NTRKIC.cjs');
-require('./chunk-GZV6AVRL.cjs');
-require('./chunk-A4RAL2ER.cjs');
-require('./chunk-DQZU7JK6.cjs');
-require('./chunk-BJUJT5ED.cjs');
-require('./chunk-ZF2LDKQQ.cjs');
-require('./chunk-HCT4HPCL.cjs');
-require('./chunk-JLRLCBJ4.cjs');
-require('./chunk-RWPLWMCZ.cjs');
-require('./chunk-TY56BKSK.cjs');
-require('./chunk-QRVS2PRE.cjs');
-require('./chunk-ATT276RD.cjs');
-require('./chunk-3EE6LVWT.cjs');
-require('./chunk-ANMJJD6D.cjs');
-require('./chunk-QC55H6RJ.cjs');
-require('./chunk-NVXXWAU7.cjs');
-require('./chunk-4NLCWGH7.cjs');
-require('./chunk-EXTRW7GW.cjs');
-require('./chunk-HUFSABUZ.cjs');
-require('./chunk-J7J7J2GN.cjs');
-require('./chunk-6LHQPOMI.cjs');
-
-
-
-Object.defineProperty(exports, "Agent", {
-  enumerable: true,
-  get: function () { return chunkGCHZMH42_cjs.Agent; }
-});
-//# sourceMappingURL=agent-47NS6ZVL.cjs.map
-//# sourceMappingURL=agent-47NS6ZVL.cjs.map

package/dist/agent-JJZM2VIK.js

@@ -1,58 +0,0 @@
-export { Agent } from './chunk-2UXQASTX.js';
-import './chunk-K2VMFZQ5.js';
-import './chunk-2QKV4CGK.js';
-import './chunk-K2BQQ445.js';
-import './chunk-7MMTZBTT.js';
-import './chunk-N2KAIZ5D.js';
-import './chunk-2SFBB54R.js';
-import './chunk-55GB6JYQ.js';
-import './chunk-H73MEMQB.js';
-import './chunk-OR6XIWLB.js';
-import './chunk-BZ3YMAMP.js';
-import './chunk-AAEZSPTC.js';
-import './chunk-KZSKIUXZ.js';
-import './chunk-UBR5PWD7.js';
-import './chunk-2XC6KDJM.js';
-import './chunk-XB4GI5RZ.js';
-import './chunk-24MGQDK3.js';
-import './chunk-2WXHA33T.js';
-import './chunk-HKCKOAIO.js';
-import './chunk-HUDNLFY4.js';
-import './chunk-KVNWIAO4.js';
-import './chunk-SVQIW5RJ.js';
-import './chunk-FD2UT76F.js';
-import './chunk-7I5Z3UBJ.js';
-import './chunk-FJWQP6EE.js';
-import './chunk-NAF4L3T6.js';
-import './chunk-CFE6QF2Q.js';
-import './chunk-6X6ID4MO.js';
-import './chunk-CA5VUAP3.js';
-import './chunk-5NELQ6LB.js';
-import './chunk-SAGRF4IB.js';
-import './chunk-EH6XD3FY.js';
-import './chunk-UKMBRMGT.js';
-import './chunk-4MMWFSCD.js';
-import './chunk-G7BLGBRN.js';
-import './chunk-VE6DFSKU.js';
-import './chunk-JOFVLOFY.js';
-import './chunk-WE22OXQA.js';
-import './chunk-6PWOWXMC.js';
-import './chunk-TA3K7SBK.js';
-import './chunk-Q5EWJPRY.js';
-import './chunk-EIQFAOFD.js';
-import './chunk-3JHIFQ4I.js';
-import './chunk-T3ZDEYTJ.js';
-import './chunk-X7EUUHXU.js';
-import './chunk-UOLBAPDM.js';
-import './chunk-6M2OIS4Y.js';
-import './chunk-R7WIIPUR.js';
-import './chunk-XYFGKVZ7.js';
-import './chunk-VWUXIVEI.js';
-import './chunk-AGACYRJ2.js';
-import './chunk-JMDDYA22.js';
-import './chunk-V22DZIXO.js';
-import './chunk-NJWYQWDL.js';
-import './chunk-ALUN2B4W.js';
-import './chunk-CZJ6Q7CW.js';
-//# sourceMappingURL=agent-JJZM2VIK.js.map
-//# sourceMappingURL=agent-JJZM2VIK.js.map