@theokit/agents 13.0.0-next.10 → 13.0.0-next.11

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @theokit/agents
 
+## 13.0.0-next.11
+
+### Patch Changes
+
+- 5451233: Say, where a consumer can read it, why `CompatSurface` has five names and the SDK's has four
+
+  `CompatSurface` gained `'commands'` in #704 because this package reads
+  `<projectDir>/.claude/commands/*.md` itself. The SDK's own union still has four. A caller who
+  builds SDK `local` options directly therefore cannot pass a value of this type, and `TS2345` names
+  the mismatch without naming the reason.
+
+  The explanation existed only in `//` comments, which do not survive into the emitted `.d.ts` — so
+  it was invisible to exactly the audience that hits the error. It now lives in the JSDoc block that
+  does ship, together with the guidance to derive the SDK's four from this five rather than writing a
+  second list by hand: a hand-copied list goes stale the day a surface is added, which is the
+  divergence #704 existed to remove.
+
+  Documentation only; no behaviour changes. Reported by a consumer who hit the compiler error while
+  converging four call sites onto one declaration, and who supplied the sentence that was missing.
+
 ## 13.0.0-next.10
 
 ### Minor Changes

package/dist/{agent-compiler-CvYfM-0t.d.ts → agent-compiler-DRfBbirH.d.ts}

@@ -1,7 +1,7 @@
 import { InlineSkill, SystemPromptResolver, SettingSource, MemorySettings, SkillsSettings, ContextSettings } from '@theokit/sdk';
 import { TheokitAgentError } from '@theokit/sdk/errors';
 import { R as ReasoningEffort, a as MemoryOptions, P as ProjectContextOptions, M as McpServersMap, H as HumanInTheLoopOptions, C as CheckpointOptions, T as ToolOptions, A as ApprovalOptions, B as BudgetOptions } from './types-C16Wuh9E.js';
-import { R as ResolvedCompatSource } from './setting-sources-gate-tadmHT0c.js';
+import { R as ResolvedCompatSource } from './setting-sources-gate-D2NS1GsB.js';
 
 /**
  * M9 (theokit-ai-first) — guardrail contract + typed errors.

package/dist/{bridge-entry-B3BRB3e_.d.ts → bridge-entry-Bk4rgMF8.d.ts}

@@ -1,14 +1,14 @@
 import { ExecutionContext } from '@theokit/http';
 import { c as AgentOptions, T as ToolOptions, P as ProjectContextOptions, H as HumanInTheLoopOptions, R as ReasoningEffort, M as McpServersMap } from './types-C16Wuh9E.js';
-import { C as CompiledAgentOptions, a as CompiledTool, G as Guardrail, S as SkillsSelection, H as HookApprovalGate } from './agent-compiler-CvYfM-0t.js';
+import { C as CompiledAgentOptions, a as CompiledTool, G as Guardrail, S as SkillsSelection, H as HookApprovalGate } from './agent-compiler-DRfBbirH.js';
 import { SkillsSettings, ContextSettings, SystemPromptResolver, ModelSelection, PluginsSettings, Plugin, ProviderRoutingSettings, AgentDefinition as AgentDefinition$1, BudgetTracker, CustomTool, RunEventSink, MemorySettings } from '@theokit/sdk';
-import { S as StreamEvent, f as ApprovalRequiredEvent, a4 as MaskError } from './delegation-scoring-BZdtCdMN.js';
+import { S as StreamEvent, f as ApprovalRequiredEvent, a4 as MaskError } from './delegation-scoring-CjzhqW2q.js';
 import { RetryOptions } from '@theokit/sdk/retry';
 import { SandboxPosture } from '@theokit/sdk/sandbox';
-import { A as AgentDefinition } from './define-agent-Dp6e7chT.js';
+import { A as AgentDefinition } from './define-agent-Cu9uZY7B.js';
 import { z } from 'zod';
 import { H as HookHandlers } from './hook-handlers-Cw2FsnE5.js';
-import { S as SettingSourcesSelection } from './setting-sources-gate-tadmHT0c.js';
+import { S as SettingSourcesSelection } from './setting-sources-gate-D2NS1GsB.js';
 import { WireChunk } from '@theokit/presenter/wire';
 import { TheokitAgentError } from '@theokit/sdk/errors';
 

package/dist/bridge.d.ts

@@ -1,8 +1,8 @@
-export { c as APPROVAL_MODES, d as AfterToolCallContext, e as AgentBuilder, f as AgentDefinitionError, g as AgentExecutionContext, h as AgentManifest, A as AgentManifestEntry, i as AgentManifestSource, j as AgentManifestTool, b as AgentModule, k as AgentRoute, l as AgentRouteContext, m as AgentRunInfo, n as AgentsPluginOptions, o as ApiErrorContext, p as ApiErrorDecision, q as ApiErrorPolicy, r as ApprovalMode, a as ApprovalPosture, B as BeforeToolCallContext, u as CompiledContextWindow, v as ContextualTool, D as DefinitionOrThunk, w as DelegationTimeoutError, E as EphemeralAgent, L as LLMCallContext, M as McpApprovalSpec, x as McpFileError, y as McpRegistryConfig, z as McpRequestContext, F as McpSelection, P as ProcessInputContext, G as SdkAgentHandle, I as SdkMessage, J as SdkSendOptions, K as SdkTurnHandle, N as Segment, O as ShouldAutoApproveOptions, T as ToolCallVeto, Q as ToolHooks, R as ToolHooksPlugin, W as WRITE_SCOPED_TOOLS, U as agentsPlugin, V as applyPosture, X as buildModelSelection, Y as compileAgentModule, Z as compileContextWindow, _ as compileLoadedAgentModule, $ as compileProjectContext, a0 as compileSkills, a1 as createAgentExecutionContext, a2 as createApiErrorHandler, a3 as createSdkAgentStream, a4 as createThinkTagExtractor, a5 as createToolHooksPlugin, a6 as extractThinkTagStream, a7 as generateAgentManifest, a8 as generateAgentRoutes, a9 as isAgentContext, aa as loadMcpJson, ab as mcpRegistry, ac as mcpToolApprovals, ad as projectContextMetadataOnlyKnobs, ae as reasoningEffortOf, af as resolveMcpServers, ag as runWithApiErrorHandling, ah as shouldAutoApprove, s as streamAgentUIMessages, ai as toAgentFactory, aj as translateSdkEvent, ak as withClockCap, al as withEphemeralAgent } from './bridge-entry-B3BRB3e_.js';
-export { C as CompiledAgentOptions, a as CompiledTool, H as HookApprovalGate, g as HookApprovalRequest, h as HookGateUnsupportedError, T as ToolWalkResult, j as ToolboxWalkResult, k as compileTools } from './agent-compiler-CvYfM-0t.js';
-export { A as AgentStopReason, d as AgentStreamEvent, e as AgentTurnMetadata, f as ApprovalRequiredEvent, g as ArtifactChunkEvent, h as ArtifactStartEvent, B as BackgroundDelegation, i as BudgetExceededError, C as CheckpointSavedEvent, k as DelegateFn, a as DelegateOptions, l as DelegationBudgetExceededError, m as DelegationError, n as DelegationPort, c as DelegationResult, D as DelegationTarget, o as DoneEvent, E as ErrorEvent, F as FileEditEvent, I as IterationEvent, P as PartialToolCallEvent, v as RunStartedEvent, w as ScoreVerdict, x as ScoredDelegation, y as Scorer, z as StateUpdateEvent, S as StreamEvent, T as TextDeltaEvent, G as ThinkingEvent, H as ToolCallEvent, J as ToolResultEvent, K as delegate, M as delegateBackground, N as delegateWithScoring, O as isApprovalRequired, Q as isDone, U as isError, V as isPartialToolCall, W as isTextDelta, X as isToolCall, Y as isToolResult, a0 as presentUIMessageStream, a3 as streamAgentResponse } from './delegation-scoring-BZdtCdMN.js';
-export { a as AGENT_BRAND, A as AgentDefinition, D as DefineAgentConfig, I as InferAgentInput, b as InferAgentToolNames, c as compileAgentDefinition, i as isAgentDefinition } from './define-agent-Dp6e7chT.js';
-export { C as CompatSurface, P as ProjectSettingsGrant, R as ResolvedCompatSource, a as SettingSourceCapability, S as SettingSourcesSelection, U as UntrustedSettingSourceError, r as resolveCompatSources, b as resolveSettingSources } from './setting-sources-gate-tadmHT0c.js';
+export { c as APPROVAL_MODES, d as AfterToolCallContext, e as AgentBuilder, f as AgentDefinitionError, g as AgentExecutionContext, h as AgentManifest, A as AgentManifestEntry, i as AgentManifestSource, j as AgentManifestTool, b as AgentModule, k as AgentRoute, l as AgentRouteContext, m as AgentRunInfo, n as AgentsPluginOptions, o as ApiErrorContext, p as ApiErrorDecision, q as ApiErrorPolicy, r as ApprovalMode, a as ApprovalPosture, B as BeforeToolCallContext, u as CompiledContextWindow, v as ContextualTool, D as DefinitionOrThunk, w as DelegationTimeoutError, E as EphemeralAgent, L as LLMCallContext, M as McpApprovalSpec, x as McpFileError, y as McpRegistryConfig, z as McpRequestContext, F as McpSelection, P as ProcessInputContext, G as SdkAgentHandle, I as SdkMessage, J as SdkSendOptions, K as SdkTurnHandle, N as Segment, O as ShouldAutoApproveOptions, T as ToolCallVeto, Q as ToolHooks, R as ToolHooksPlugin, W as WRITE_SCOPED_TOOLS, U as agentsPlugin, V as applyPosture, X as buildModelSelection, Y as compileAgentModule, Z as compileContextWindow, _ as compileLoadedAgentModule, $ as compileProjectContext, a0 as compileSkills, a1 as createAgentExecutionContext, a2 as createApiErrorHandler, a3 as createSdkAgentStream, a4 as createThinkTagExtractor, a5 as createToolHooksPlugin, a6 as extractThinkTagStream, a7 as generateAgentManifest, a8 as generateAgentRoutes, a9 as isAgentContext, aa as loadMcpJson, ab as mcpRegistry, ac as mcpToolApprovals, ad as projectContextMetadataOnlyKnobs, ae as reasoningEffortOf, af as resolveMcpServers, ag as runWithApiErrorHandling, ah as shouldAutoApprove, s as streamAgentUIMessages, ai as toAgentFactory, aj as translateSdkEvent, ak as withClockCap, al as withEphemeralAgent } from './bridge-entry-Bk4rgMF8.js';
+export { C as CompiledAgentOptions, a as CompiledTool, H as HookApprovalGate, g as HookApprovalRequest, h as HookGateUnsupportedError, T as ToolWalkResult, j as ToolboxWalkResult, k as compileTools } from './agent-compiler-DRfBbirH.js';
+export { A as AgentStopReason, d as AgentStreamEvent, e as AgentTurnMetadata, f as ApprovalRequiredEvent, g as ArtifactChunkEvent, h as ArtifactStartEvent, B as BackgroundDelegation, i as BudgetExceededError, C as CheckpointSavedEvent, k as DelegateFn, a as DelegateOptions, l as DelegationBudgetExceededError, m as DelegationError, n as DelegationPort, c as DelegationResult, D as DelegationTarget, o as DoneEvent, E as ErrorEvent, F as FileEditEvent, I as IterationEvent, P as PartialToolCallEvent, v as RunStartedEvent, w as ScoreVerdict, x as ScoredDelegation, y as Scorer, z as StateUpdateEvent, S as StreamEvent, T as TextDeltaEvent, G as ThinkingEvent, H as ToolCallEvent, J as ToolResultEvent, K as delegate, M as delegateBackground, N as delegateWithScoring, O as isApprovalRequired, Q as isDone, U as isError, V as isPartialToolCall, W as isTextDelta, X as isToolCall, Y as isToolResult, a0 as presentUIMessageStream, a3 as streamAgentResponse } from './delegation-scoring-CjzhqW2q.js';
+export { a as AGENT_BRAND, A as AgentDefinition, D as DefineAgentConfig, I as InferAgentInput, b as InferAgentToolNames, c as compileAgentDefinition, i as isAgentDefinition } from './define-agent-Cu9uZY7B.js';
+export { C as CompatSurface, P as ProjectSettingsGrant, R as ResolvedCompatSource, a as SettingSourceCapability, S as SettingSourcesSelection, U as UntrustedSettingSourceError, r as resolveCompatSources, b as resolveSettingSources } from './setting-sources-gate-D2NS1GsB.js';
 import '@theokit/http';
 import './types-C16Wuh9E.js';
 import '@theokit/sdk';

package/dist/bridge.js

@@ -29,7 +29,7 @@ import {
   runWithApiErrorHandling,
   streamAgentResponse,
   streamAgentUIMessages
-} from "./chunk-6YJIXBMA.js";
+} from "./chunk-BHW7CSF4.js";
 import {
   APPROVAL_MODES,
   BudgetExceededError,
@@ -55,7 +55,7 @@ import {
   translateSdkEvent,
   withClockCap,
   withEphemeralAgent
-} from "./chunk-FXQF7LS3.js";
+} from "./chunk-AHLGDLUX.js";
 import "./chunk-RKWCXVYG.js";
 import {
   AGENT_BRAND,
@@ -64,7 +64,7 @@ import {
   isAgentDefinition,
   resolveCompatSources,
   resolveSettingSources
-} from "./chunk-43O2CCZR.js";
+} from "./chunk-KTOWSF2S.js";
 import "./chunk-OXNDJSAJ.js";
 import "./chunk-Z4QWC7IK.js";
 export {

package/dist/{chunk-FXQF7LS3.js → chunk-AHLGDLUX.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-RKWCXVYG.js";
 import {
   compileAgentDefinition
-} from "./chunk-43O2CCZR.js";
+} from "./chunk-KTOWSF2S.js";
 import {
   createRunUsageMeter
 } from "./chunk-OXNDJSAJ.js";
@@ -2553,4 +2553,4 @@ export {
   delegateBackground,
   delegateWithScoring
 };
-//# sourceMappingURL=chunk-FXQF7LS3.js.map
+//# sourceMappingURL=chunk-AHLGDLUX.js.map

package/dist/{chunk-6YJIXBMA.js → chunk-BHW7CSF4.js}

@@ -1,12 +1,12 @@
 import {
   createHitlPlugin,
   createSdkAgentStream
-} from "./chunk-FXQF7LS3.js";
+} from "./chunk-AHLGDLUX.js";
 import {
   compileAgentDefinition,
   defineAgent,
   isAgentDefinition
-} from "./chunk-43O2CCZR.js";
+} from "./chunk-KTOWSF2S.js";
 import {
   __name
 } from "./chunk-Z4QWC7IK.js";
@@ -1240,4 +1240,4 @@ export {
   generateAgentManifest,
   agentsPlugin
 };
-//# sourceMappingURL=chunk-6YJIXBMA.js.map
+//# sourceMappingURL=chunk-BHW7CSF4.js.map

package/dist/{chunk-43O2CCZR.js → chunk-KTOWSF2S.js}

@@ -232,4 +232,4 @@ export {
   compileAgentDefinition,
   compileSkillsSelection
 };
-//# sourceMappingURL=chunk-43O2CCZR.js.map
+//# sourceMappingURL=chunk-KTOWSF2S.js.map

package/dist/{chunk-43O2CCZR.js.map → chunk-KTOWSF2S.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/bridge/setting-sources-gate.ts","../src/bridge/define-agent.ts"],"mappings":"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","names":["TheokitAgentError","UntrustedSettingSourceError","TheokitAgentError","name","message","trustSource","capability","resolveSettingSources","selection","undefined","sources","user","push","grant","project","posture","trustedBy","allows","projectSettings","level","source","resolveCompatSources","claudeCode","surfaces","import","length","kind","AGENT_BRAND","Symbol","for","defineAgent","config","assertValidMaxIterations","maxIterations","value","undefined","Number","isInteger","Error","String","isAgentDefinition","toCompiledTool","tool","handler","compiled","name","description","inputSchema","input","ctx","sym","Object","getOwnPropertySymbols","compileAgentDefinition","def","model","reasoningEffort","systemPrompt","system","tools","map","agents","stream","context","runContext","guardrails","approvals","hitl","compileApprovals","compileSkillsSelection","skills","settingSources","resolveSettingSources","claudeCode","compatSources","resolveCompatSources","hookApproval","memory","compileHooksAndPlugins","mcpServers","hooks","entries","filter","h","explicit","plugins","length","plugin","version","kind","register","hookName","on","skillsResolver","enabled","inline","entry","push","autoInject","toolNames","Set","t","gates","Map","toolName","options","has","join","set"]}
+{"version":3,"sources":["../src/bridge/setting-sources-gate.ts","../src/bridge/define-agent.ts"],"mappings":"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","names":["TheokitAgentError","UntrustedSettingSourceError","TheokitAgentError","name","message","trustSource","capability","resolveSettingSources","selection","undefined","sources","user","push","grant","project","posture","trustedBy","allows","projectSettings","level","source","resolveCompatSources","claudeCode","surfaces","import","length","kind","AGENT_BRAND","Symbol","for","defineAgent","config","assertValidMaxIterations","maxIterations","value","undefined","Number","isInteger","Error","String","isAgentDefinition","toCompiledTool","tool","handler","compiled","name","description","inputSchema","input","ctx","sym","Object","getOwnPropertySymbols","compileAgentDefinition","def","model","reasoningEffort","systemPrompt","system","tools","map","agents","stream","context","runContext","guardrails","approvals","hitl","compileApprovals","compileSkillsSelection","skills","settingSources","resolveSettingSources","claudeCode","compatSources","resolveCompatSources","hookApproval","memory","compileHooksAndPlugins","mcpServers","hooks","entries","filter","h","explicit","plugins","length","plugin","version","kind","register","hookName","on","skillsResolver","enabled","inline","entry","push","autoInject","toolNames","Set","t","gates","Map","toolName","options","has","join","set"]}

package/dist/config.d.ts

@@ -1,7 +1,7 @@
 import { TheokitAgentError } from '@theokit/sdk/errors';
 import { z } from 'zod';
 import { TrustPosture } from '@theokit/sdk';
-import { R as ResolvedCompatSource } from './setting-sources-gate-tadmHT0c.js';
+import { R as ResolvedCompatSource } from './setting-sources-gate-D2NS1GsB.js';
 export { resolveEffectiveContextWindow as effectiveContextWindow } from '@theokit/sdk/compaction';
 
 /**

package/dist/{define-agent-Dp6e7chT.d.ts → define-agent-Cu9uZY7B.d.ts}

@@ -1,9 +1,9 @@
 import { CustomTool, MemorySettings } from '@theokit/sdk';
 import { z } from 'zod';
-import { G as Guardrail, S as SkillsSelection, H as HookApprovalGate, C as CompiledAgentOptions } from './agent-compiler-CvYfM-0t.js';
+import { G as Guardrail, S as SkillsSelection, H as HookApprovalGate, C as CompiledAgentOptions } from './agent-compiler-DRfBbirH.js';
 import { R as ReasoningEffort, H as HumanInTheLoopOptions, M as McpServersMap } from './types-C16Wuh9E.js';
 import { H as HookHandlers } from './hook-handlers-Cw2FsnE5.js';
-import { S as SettingSourcesSelection } from './setting-sources-gate-tadmHT0c.js';
+import { S as SettingSourcesSelection } from './setting-sources-gate-D2NS1GsB.js';
 
 /**
  * M2 (theokit-ai-first) — `defineAgent`, the zero-config imperative agent surface.

package/dist/{delegation-scoring-BZdtCdMN.d.ts → delegation-scoring-CjzhqW2q.d.ts}

@@ -1,6 +1,6 @@
 import { PluginsSettings, ProviderRoutingSettings, AgentDefinition, BudgetTracker, CustomTool } from '@theokit/sdk';
 import { RetryOptions } from '@theokit/sdk/retry';
-import { C as CompiledAgentOptions, a as CompiledTool } from './agent-compiler-CvYfM-0t.js';
+import { C as CompiledAgentOptions, a as CompiledTool } from './agent-compiler-DRfBbirH.js';
 import { TheokitAgentError } from '@theokit/sdk/errors';
 import { z } from 'zod';
 import { b as MainLoopMeta } from './types-C16Wuh9E.js';

package/dist/index.d.ts

@@ -2,18 +2,18 @@ import { PluginsSettings, Plugin, ProviderRoutingSettings, AgentDefinition, Budg
 export { CustomTool, DiagnosticsSink, GenerateObjectError, GoalEvent, GoalLoopAgent, GoalOptions, GoalResult, JudgeCredentialError, JudgeResult, LayerOrderError, McpAuthConfig, McpHttpServerConfig, McpOAuthConfig, McpServerConfig, McpStdioServerConfig, Provider, RunEvent, SDKAgent, SessionRecord, Squad, StreamObjectError, Tool, ToolError, ToolResultContentBlock, TrustLevel, TrustPosture, TrustPostureInput, TrustSource, UngatedCapabilityError, Verdict, WiredEntity, applySecurityFloor, auditEnvReachability, foldLayers, recordWiring, resolveTrustPosture, setDiagnosticsSink, verifyLayerOrdering } from '@theokit/sdk';
 import { b as MainLoopMeta, R as ReasoningEffort, T as ToolOptions, A as ApprovalOptions, H as HumanInTheLoopOptions } from './types-C16Wuh9E.js';
 export { c as AgentOptions, B as BudgetOptions, d as MainLoopOptions, M as McpServersMap, e as PolicyHandler, f as TimeoutAction, g as ToolboxOptions } from './types-C16Wuh9E.js';
-import { C as ContextWindowOptions, S as SkillsOptions, A as AgentManifestEntry, H as HitlDecision, s as streamAgentUIMessages, a as ApprovalPosture, b as AgentModule } from './bridge-entry-B3BRB3e_.js';
-export { c as APPROVAL_MODES, d as AfterToolCallContext, e as AgentBuilder, f as AgentDefinitionError, g as AgentExecutionContext, h as AgentManifest, i as AgentManifestSource, j as AgentManifestTool, k as AgentRoute, l as AgentRouteContext, m as AgentRunInfo, n as AgentsPluginOptions, o as ApiErrorContext, p as ApiErrorDecision, q as ApiErrorPolicy, r as ApprovalMode, t as ApprovalRequest, B as BeforeToolCallContext, u as CompiledContextWindow, v as ContextualTool, D as DefinitionOrThunk, w as DelegationTimeoutError, E as EphemeralAgent, L as LLMCallContext, M as McpApprovalSpec, x as McpFileError, y as McpRegistryConfig, z as McpRequestContext, F as McpSelection, P as ProcessInputContext, G as SdkAgentHandle, I as SdkMessage, J as SdkSendOptions, K as SdkTurnHandle, N as Segment, O as ShouldAutoApproveOptions, T as ToolCallVeto, Q as ToolHooks, R as ToolHooksPlugin, W as WRITE_SCOPED_TOOLS, U as agentsPlugin, V as applyPosture, X as buildModelSelection, Y as compileAgentModule, Z as compileContextWindow, _ as compileLoadedAgentModule, $ as compileProjectContext, a0 as compileSkills, a1 as createAgentExecutionContext, a2 as createApiErrorHandler, a3 as createSdkAgentStream, a4 as createThinkTagExtractor, a5 as createToolHooksPlugin, a6 as extractThinkTagStream, a7 as generateAgentManifest, a8 as generateAgentRoutes, a9 as isAgentContext, aa as loadMcpJson, ab as mcpRegistry, ac as mcpToolApprovals, ad as projectContextMetadataOnlyKnobs, ae as reasoningEffortOf, af as resolveMcpServers, ag as runWithApiErrorHandling, ah as shouldAutoApprove, ai as toAgentFactory, aj as translateSdkEvent, ak as withClockCap, al as withEphemeralAgent } from './bridge-entry-B3BRB3e_.js';
+import { C as ContextWindowOptions, S as SkillsOptions, A as AgentManifestEntry, H as HitlDecision, s as streamAgentUIMessages, a as ApprovalPosture, b as AgentModule } from './bridge-entry-Bk4rgMF8.js';
+export { c as APPROVAL_MODES, d as AfterToolCallContext, e as AgentBuilder, f as AgentDefinitionError, g as AgentExecutionContext, h as AgentManifest, i as AgentManifestSource, j as AgentManifestTool, k as AgentRoute, l as AgentRouteContext, m as AgentRunInfo, n as AgentsPluginOptions, o as ApiErrorContext, p as ApiErrorDecision, q as ApiErrorPolicy, r as ApprovalMode, t as ApprovalRequest, B as BeforeToolCallContext, u as CompiledContextWindow, v as ContextualTool, D as DefinitionOrThunk, w as DelegationTimeoutError, E as EphemeralAgent, L as LLMCallContext, M as McpApprovalSpec, x as McpFileError, y as McpRegistryConfig, z as McpRequestContext, F as McpSelection, P as ProcessInputContext, G as SdkAgentHandle, I as SdkMessage, J as SdkSendOptions, K as SdkTurnHandle, N as Segment, O as ShouldAutoApproveOptions, T as ToolCallVeto, Q as ToolHooks, R as ToolHooksPlugin, W as WRITE_SCOPED_TOOLS, U as agentsPlugin, V as applyPosture, X as buildModelSelection, Y as compileAgentModule, Z as compileContextWindow, _ as compileLoadedAgentModule, $ as compileProjectContext, a0 as compileSkills, a1 as createAgentExecutionContext, a2 as createApiErrorHandler, a3 as createSdkAgentStream, a4 as createThinkTagExtractor, a5 as createToolHooksPlugin, a6 as extractThinkTagStream, a7 as generateAgentManifest, a8 as generateAgentRoutes, a9 as isAgentContext, aa as loadMcpJson, ab as mcpRegistry, ac as mcpToolApprovals, ad as projectContextMetadataOnlyKnobs, ae as reasoningEffortOf, af as resolveMcpServers, ag as runWithApiErrorHandling, ah as shouldAutoApprove, ai as toAgentFactory, aj as translateSdkEvent, ak as withClockCap, al as withEphemeralAgent } from './bridge-entry-Bk4rgMF8.js';
 import { TheokitAgentError } from '@theokit/sdk/errors';
 export * from '@theokit/sdk/errors';
 export { ConfigurationError, BudgetExceededError as WindowBudgetExceededError } from '@theokit/sdk/errors';
-import { G as Guardrail, C as CompiledAgentOptions, a as CompiledTool } from './agent-compiler-CvYfM-0t.js';
-export { b as CostBudgetExceededError, c as GuardrailAction, d as GuardrailPhase, e as GuardrailResult, f as GuardrailViolationError, H as HookApprovalGate, g as HookApprovalRequest, h as HookGateUnsupportedError, i as SkillsRequestContext, S as SkillsSelection, T as ToolWalkResult, j as ToolboxWalkResult, k as compileTools, r as resolveEnabledSkills } from './agent-compiler-CvYfM-0t.js';
-import { S as SettingSourcesSelection } from './setting-sources-gate-tadmHT0c.js';
-export { C as CompatSurface, P as ProjectSettingsGrant, R as ResolvedCompatSource, a as SettingSourceCapability, U as UntrustedSettingSourceError, r as resolveCompatSources, b as resolveSettingSources } from './setting-sources-gate-tadmHT0c.js';
-import { L as LoopStrategy, R as ReflectionStrategy, b as RoundStreamFactory, S as StreamEvent, c as DelegationResult } from './delegation-scoring-BZdtCdMN.js';
-export { A as AgentStopReason, d as AgentStreamEvent, e as AgentTurnMetadata, f as ApprovalRequiredEvent, g as ArtifactChunkEvent, h as ArtifactStartEvent, B as BackgroundDelegation, i as BudgetExceededError, C as CheckpointSavedEvent, j as DEFAULT_MAX_ITERATIONS, k as DelegateFn, a as DelegateOptions, l as DelegationBudgetExceededError, m as DelegationError, n as DelegationPort, D as DelegationTarget, o as DoneEvent, E as ErrorEvent, F as FileEditEvent, I as IterationEvent, p as LoopFinishReason, q as LoopOutcome, r as LoopStrategyConfig, P as PartialToolCallEvent, s as ReflectionContext, t as ReflectionResult, u as ReflectionStrategyConfig, v as RunStartedEvent, w as ScoreVerdict, x as ScoredDelegation, y as Scorer, z as StateUpdateEvent, T as TextDeltaEvent, G as ThinkingEvent, H as ToolCallEvent, J as ToolResultEvent, K as delegate, M as delegateBackground, N as delegateWithScoring, O as isApprovalRequired, Q as isDone, U as isError, V as isPartialToolCall, W as isTextDelta, X as isToolCall, Y as isToolResult, Z as ladderReflectionStrategy, _ as loopStrategyConfigSchema, $ as noopReflectionStrategy, a0 as presentUIMessageStream, a1 as reflectionStrategyConfigSchema, a2 as resolveLoopStrategy, a3 as streamAgentResponse } from './delegation-scoring-BZdtCdMN.js';
-export { a as AGENT_BRAND, A as AgentDefinition, D as DefineAgentConfig, I as InferAgentInput, b as InferAgentToolNames, c as compileAgentDefinition, i as isAgentDefinition } from './define-agent-Dp6e7chT.js';
+import { G as Guardrail, C as CompiledAgentOptions, a as CompiledTool } from './agent-compiler-DRfBbirH.js';
+export { b as CostBudgetExceededError, c as GuardrailAction, d as GuardrailPhase, e as GuardrailResult, f as GuardrailViolationError, H as HookApprovalGate, g as HookApprovalRequest, h as HookGateUnsupportedError, i as SkillsRequestContext, S as SkillsSelection, T as ToolWalkResult, j as ToolboxWalkResult, k as compileTools, r as resolveEnabledSkills } from './agent-compiler-DRfBbirH.js';
+import { S as SettingSourcesSelection } from './setting-sources-gate-D2NS1GsB.js';
+export { C as CompatSurface, P as ProjectSettingsGrant, R as ResolvedCompatSource, a as SettingSourceCapability, U as UntrustedSettingSourceError, r as resolveCompatSources, b as resolveSettingSources } from './setting-sources-gate-D2NS1GsB.js';
+import { L as LoopStrategy, R as ReflectionStrategy, b as RoundStreamFactory, S as StreamEvent, c as DelegationResult } from './delegation-scoring-CjzhqW2q.js';
+export { A as AgentStopReason, d as AgentStreamEvent, e as AgentTurnMetadata, f as ApprovalRequiredEvent, g as ArtifactChunkEvent, h as ArtifactStartEvent, B as BackgroundDelegation, i as BudgetExceededError, C as CheckpointSavedEvent, j as DEFAULT_MAX_ITERATIONS, k as DelegateFn, a as DelegateOptions, l as DelegationBudgetExceededError, m as DelegationError, n as DelegationPort, D as DelegationTarget, o as DoneEvent, E as ErrorEvent, F as FileEditEvent, I as IterationEvent, p as LoopFinishReason, q as LoopOutcome, r as LoopStrategyConfig, P as PartialToolCallEvent, s as ReflectionContext, t as ReflectionResult, u as ReflectionStrategyConfig, v as RunStartedEvent, w as ScoreVerdict, x as ScoredDelegation, y as Scorer, z as StateUpdateEvent, T as TextDeltaEvent, G as ThinkingEvent, H as ToolCallEvent, J as ToolResultEvent, K as delegate, M as delegateBackground, N as delegateWithScoring, O as isApprovalRequired, Q as isDone, U as isError, V as isPartialToolCall, W as isTextDelta, X as isToolCall, Y as isToolResult, Z as ladderReflectionStrategy, _ as loopStrategyConfigSchema, $ as noopReflectionStrategy, a0 as presentUIMessageStream, a1 as reflectionStrategyConfigSchema, a2 as resolveLoopStrategy, a3 as streamAgentResponse } from './delegation-scoring-CjzhqW2q.js';
+export { a as AGENT_BRAND, A as AgentDefinition, D as DefineAgentConfig, I as InferAgentInput, b as InferAgentToolNames, c as compileAgentDefinition, i as isAgentDefinition } from './define-agent-Cu9uZY7B.js';
 import { RetryOptions } from '@theokit/sdk/retry';
 export * from '@theokit/sdk/retry';
 import { CompressibleMessage } from '@theokit/sdk/compaction';

package/dist/index.js

@@ -32,7 +32,7 @@ import {
   streamAgentResponse,
   streamAgentUIMessages,
   toolRuntimeName
-} from "./chunk-6YJIXBMA.js";
+} from "./chunk-BHW7CSF4.js";
 import {
   APPROVAL_MODES,
   AgentRunner,
@@ -84,7 +84,7 @@ import {
   unicodeNormalizer,
   withClockCap,
   withEphemeralAgent
-} from "./chunk-FXQF7LS3.js";
+} from "./chunk-AHLGDLUX.js";
 import "./chunk-RKWCXVYG.js";
 import {
   AGENT_BRAND,
@@ -94,7 +94,7 @@ import {
   isAgentDefinition,
   resolveCompatSources,
   resolveSettingSources
-} from "./chunk-43O2CCZR.js";
+} from "./chunk-KTOWSF2S.js";
 import "./chunk-OXNDJSAJ.js";
 import {
   __name

package/dist/{setting-sources-gate-tadmHT0c.d.ts → setting-sources-gate-D2NS1GsB.d.ts}

@@ -120,6 +120,13 @@ interface SettingSourcesSelection {
  * that cannot build against its own minimum dependency is worse than a constant that has been
  * checked. Verified against the published 5.4.0 `.d.ts`, where the union is
  * `"hooks" | "plugins" | "skills" | "subagents"` — note `subagents`, not `agents`.
+ *
+ * The two unions therefore DIVERGE by one name, on purpose: the SDK has four, and `commands` is
+ * this layer's, because `<projectDir>/.claude/commands/*.md` is read here and never by the SDK.
+ * A caller who builds SDK `local` options directly cannot pass a value of this type — `TS2345`,
+ * with a compiler message that names the mismatch and not the reason. Derive the SDK's list from
+ * this one minus `commands` rather than writing four names beside five; a hand-copied list goes
+ * stale the day a surface is added, which is the divergence #704 existed to remove.
  */
 type CompatSurface = 'commands' | 'hooks' | 'plugins' | 'skills' | 'subagents';
 /** What `resolveCompatSources` returns: the whole root, or the root narrowed to some surfaces. */

package/dist/testing.d.ts

@@ -1,12 +1,12 @@
 import { AgentOutputEvent } from '@theokit/presenter';
 import { WireChunk } from '@theokit/presenter/wire';
-import { A as AgentDefinition } from './define-agent-Dp6e7chT.js';
+import { A as AgentDefinition } from './define-agent-Cu9uZY7B.js';
 import '@theokit/sdk';
 import 'zod';
-import './agent-compiler-CvYfM-0t.js';
+import './agent-compiler-DRfBbirH.js';
 import '@theokit/sdk/errors';
 import './types-C16Wuh9E.js';
-import './setting-sources-gate-tadmHT0c.js';
+import './setting-sources-gate-D2NS1GsB.js';
 import './hook-handlers-Cw2FsnE5.js';
 
 /**

package/dist/testing.js

@@ -1,6 +1,6 @@
 import {
   compileAgentDefinition
-} from "./chunk-43O2CCZR.js";
+} from "./chunk-KTOWSF2S.js";
 import {
   __name
 } from "./chunk-Z4QWC7IK.js";

package/dist/tools.d.ts

@@ -1,12 +1,12 @@
 export { CatastrophicCommandError, CommandPolicy, ContextMatchError, ContextMatchReason, CreateApplyPatchToolOptions, CreateBraveWebSearchAdapterOptions, CreateCurrentTimeToolOptions, CreateEditFileToolOptions, CreateGenericHttpSearchAdapterOptions, CreateGitDiffToolOptions, CreateGitStatusToolOptions, CreateGlobToolOptions, CreateInteractiveShellToolOptions, CreateListDirToolOptions, CreateReadFileToolOptions, CreateRunVitestToolOptions, CreateSearchTextToolOptions, CreateShellToolOptions, CreateViewImageToolOptions, CreateWebFetchToolOptions, CreateWebSearchToolOptions, CreateWriteFileToolOptions, DEFAULT_MAX_IMAGE_BYTES, DEFAULT_TOOL_GUIDANCE, EnvContextOptions, PlanModeTool, PlanModeToolOptions, PlanModeToolWithStore, PlanNode, QuestionTool, QuestionToolOptions, ReadTracker, ReasoningTools, RedirectBlockedError, RepoMapOptions, ResolveAndScreenOptions, ScreenedFetchOptions, SessionArtifactStore, SessionArtifactStoreOptions, SsrfBlockedError, TodoItem, TodolistTool, ToolGuidanceMap, TruncationMode, TruncationOptions, TruncationResult, VitestSummary, WebSearchCallback, WebSearchResult, buildEnvContext, buildRepoMap, catastrophicShellReason, commandDenialReason, createApplyPatchTool, createBraveWebSearchAdapter, createCurrentTimeTool, createEditFileTool, createGenericHttpSearchAdapter, createGitDiffTool, createGitStatusTool, createGlobTool, createInteractiveShellTool, createListDirTool, createPlanModeTool, createQuestionTool, createReadFileTool, createRunVitestTool, createSearchTextTool, createSessionArtifactStore, createShellTool, createTodolistTool, createUpdatePlanTool, createViewImageTool, createWebFetchTool, createWebSearchTool, createWriteFileTool, createWriteStdinTool, denyCatastrophicCommands, formatCode, formatDiff, formatError, formatFileList, injectGuidance, isBlockedIp, isCommandAllowed, renderToolList, replaceUnique, resolveAndScreen, screenedFetch, todoItemsToPlanNodes, truncateOutput, withDefaultGuidance, withDescription, withName, withShellExitGuidance, withToolResultGuidance } from '@theokit/sdk-tools';
 import * as _theokit_sdk from '@theokit/sdk';
 import { TheokitAgentError } from '@theokit/sdk/errors';
-import { D as DelegationTarget, a as DelegateOptions } from './delegation-scoring-BZdtCdMN.js';
+import { D as DelegationTarget, a as DelegateOptions } from './delegation-scoring-CjzhqW2q.js';
 import '@theokit/sdk/retry';
-import './agent-compiler-CvYfM-0t.js';
+import './agent-compiler-DRfBbirH.js';
 import './types-C16Wuh9E.js';
 import 'zod';
-import './setting-sources-gate-tadmHT0c.js';
+import './setting-sources-gate-D2NS1GsB.js';
 import '@theokit/presenter/wire';
 import './hook-handlers-Cw2FsnE5.js';
 

package/dist/tools.js

@@ -4,9 +4,9 @@ import {
   DelegationTimeoutError,
   delegate,
   isPort
-} from "./chunk-FXQF7LS3.js";
+} from "./chunk-AHLGDLUX.js";
 import "./chunk-RKWCXVYG.js";
-import "./chunk-43O2CCZR.js";
+import "./chunk-KTOWSF2S.js";
 import "./chunk-OXNDJSAJ.js";
 import {
   __name

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theokit/agents",
-  "version": "13.0.0-next.10",
+  "version": "13.0.0-next.11",
   "description": "AI agents as first-class citizens of the TheoKit pipeline. The AgentBuilder.create() authoring chain compiles to the @theokit/sdk runtime.",
   "repository": {
     "type": "git",