@theokit/sdk 5.12.1 → 5.14.0

package/dist/index.d.cts

@@ -1,16 +1,17 @@
+import { TokenUsage } from "./index.js";
 import { T as TheokitAgentError, E as ErrorMetadata } from './errors-base-B5g01neU.cjs';
 export { a as ErrorCode } from './errors-base-B5g01neU.cjs';
-import { A as AgentOptions, L as LocalOptions, S as SystemPromptResolver, C as CloudOptions, M as MemorySettings, a as AgentDefinition, b as SkillsSettings, c as ListAgentsOptions, d as ListResult, e as SDKAgentInfo, G as GetAgentOptions, f as ListRunsOptions, g as GetRunOptions, h as AgentOperationOptions, i as AgentDescription, P as Plugin$1, j as ProviderProfile, I as InlineSkill, k as Skill, B as BudgetTracker, l as MemoryProvider, m as PreToolCallDecision } from './agent-Cn0sphpA.cjs';
-export { n as ActiveMemoryPassArgs, o as ActiveMemoryPassResult, p as AgentSubagentDescription, q as AgentToolDescription, r as BudgetCheck, s as BudgetTotal, t as BudgetUsageEvent, u as BuiltinToolName, v as CloudEnv, w as CloudRepo, x as CompatSource, y as CompatSourceAdapter, z as CompatSurface, D as CreateSkillSpec, H as HookApprovalGate, E as HookApprovalRequest, F as HookName, J as LlmCallContext, K as MemoryProviderAgentRef, N as MemoryProviderFactory, O as MemoryProviderHandle, Q as MemoryProviderInitOptions, R as PluginContext, T as PluginHookDisposer, U as PostAssistantReplyContext, V as PostToolCallContext, W as PreToolCallContext, X as PreUserSendContext, Y as PreUserSendResult, Z as ProviderTransform, _ as ProviderTransformContext, $ as RecordSessionSummaryArgs, a0 as SessionLifecycleContext, a1 as SessionRecord, a2 as SessionStore, a3 as SettingSource, a4 as Skill, a5 as SkillsResolver, a6 as SkillsResolverContext, a7 as SystemPromptContext, a8 as SystemPromptMemoryFact, a9 as TelemetrySettings, aa as ToolCallSummary, ab as ToolContext, ac as ToolResultTransformContext, ad as TransformContext } from './agent-Cn0sphpA.cjs';
-import { ab as RunEvent, v as CostBreakdown, a_ as TokenUsage, R as RunResult, P as ProviderRoutingSettings, S as SDKAgent, M as McpServerConfig, C as ContextSettings, a as PluginsSettings, b as Run, c as Processor, J as JudgeResult, G as GoalOptions, d as GoalEvent, e as GoalResult, f as MemoryId, g as RunEventSink$1, h as SDKProvider, i as SDKMessage } from './sdk-agent-4-dXI2GS.cjs';
-export { A as AgentConversationTurn, j as AgentMemory, k as AgentOperation, l as AssistantMessage, m as CompletionCheck, n as CompletionCheckResult, o as ContextBudget, p as ContextManagerKind, q as ContextSnapshot, r as ContextSource, s as ContextSourceStatus, t as ConversationStep, u as ConversationTurn, v as CostBreakdown, w as CostSource, x as CostStatus, D as DoomLoopThresholds, E as EnvPolicy, F as ForkOptions, y as ForkResult, z as GenerateOptions, B as GenerateRunResult, I as InputProcessorContext, H as InteractionUpdate, K as InvalidateCacheOptions, L as McpAuthConfig, N as McpHttpServerConfig, O as McpOAuthConfig, Q as McpStdioServerConfig, T as MemoryAdapter, U as MemoryAdapterCapabilities, V as MemoryContext, W as MemoryFact, X as MemoryRevision, Y as MemoryToolSchema, Z as MemoryTurnMessage, _ as MessageOrigin, $ as OutputProcessorContext, a0 as PartialToolCallUpdate, a1 as PersonalityPreset, a2 as ProcessorControls, a3 as ProcessorTripwire, a4 as ProcessorViolation, a5 as ProviderCapability, a6 as ProviderRoute, a7 as ResolvedProviderRoute, a8 as RunCompactBoundaryEvent, a9 as RunCompletionCheckEvent, aa as RunErrorDetail, ab as RunEvent, ac as RunGitInfo, ad as RunMemoryDegradedEvent, ae as RunPermissionDeniedEvent, af as RunRateLimitEvent, ag as RunStatus, ah as RunTaskCompletedEvent, ai as RunTaskStartedEvent, aj as RunTaskUpdatedEvent, ak as RunTimelineEvent, al as RunToCompletionOptions, am as RunToCompletionResult, an as RunToolProgressEvent, ao as RunTripwireEvent, ap as RunUntilIterator, aq as SDKAgentPlugins, ar as SDKAgentSkillDetail, as as SDKAgentSkills, at as SDKArtifact, au as SDKAssistantMessage, av as SDKContextManager, aw as SDKImage, ax as SDKImageDimension, ay as SDKObjectDelta, az as SDKPluginMetadata, aA as SDKProvidersManager, aB as SDKRequestMessage, aC as SDKStatusMessage, aD as SDKSystemMessage, aE as SDKTaskMessage, aF as SDKThinkingMessage, aG as SDKToolUseMessage, aH as SDKUserMessage, aI as SDKUserMessageEvent, aJ as SendOptions, aK as ShellCommand, aL as ShellConversationTurn, aM as ShellOutput, aN as ShellOutputDeltaUpdate, aO as StepCompletedUpdate, aP as StepStartedUpdate, aQ as StreamToCompletionResult, aR as SummaryCompletedUpdate, aS as SummaryStartedUpdate, aT as SummaryUpdate, aU as SystemPromptSkillRef, aV as TextDeltaUpdate, aW as ThinkingCompletedUpdate, aX as ThinkingDeltaUpdate, aY as ThinkingMessage, aZ as TokenDeltaUpdate, a_ as TokenUsage, a$ as ToolCall, b0 as ToolCallCompletedUpdate, b1 as ToolCallStartedUpdate, b2 as ToolResult, b3 as ToolResultGuardOptions, b4 as ToolUseBlock, b5 as TurnEndedUpdate, b6 as UserMessage, b7 as UserMessageAppendedUpdate, b8 as Verdict } from './sdk-agent-4-dXI2GS.cjs';
+import { A as AgentOptions, L as LocalOptions, B as BuiltinToolName, M as MemorySettings, S as SystemPromptResolver, C as CloudOptions, a as AgentDefinition, b as SkillsSettings, c as ListAgentsOptions, d as ListResult, e as SDKAgentInfo, G as GetAgentOptions, f as ListRunsOptions, g as GetRunOptions, h as AgentOperationOptions, i as AgentDescription, P as Plugin$1, j as ProviderProfile, I as InlineSkill, k as Skill, l as BudgetTracker, m as MemoryProvider, n as PreToolCallDecision } from './agent-DExqjqYy.cjs';
+export { o as ActiveMemoryPassArgs, p as ActiveMemoryPassResult, q as AgentSubagentDescription, r as AgentToolDescription, s as BudgetCheck, t as BudgetTotal, u as BudgetUsageEvent, v as CloudEnv, w as CloudRepo, x as CompatSource, y as CompatSourceAdapter, z as CompatSurface, D as CreateSkillSpec, H as HookApprovalGate, E as HookApprovalRequest, F as HookName, J as LlmCallContext, K as MemoryProviderAgentRef, N as MemoryProviderFactory, O as MemoryProviderHandle, Q as MemoryProviderInitOptions, R as PluginContext, T as PluginHookDisposer, U as PostAssistantReplyContext, V as PostToolCallContext, W as PreToolCallContext, X as PreUserSendContext, Y as PreUserSendResult, Z as ProviderTransform, _ as ProviderTransformContext, $ as RecordSessionSummaryArgs, a0 as SessionLifecycleContext, a1 as SessionRecord, a2 as SessionStore, a3 as SettingSource, a4 as Skill, a5 as SkillsResolver, a6 as SkillsResolverContext, a7 as SystemPromptContext, a8 as SystemPromptMemoryFact, a9 as TelemetrySettings, aa as ToolCallSummary, ab as ToolContext, ac as ToolResultTransformContext, ad as TransformContext } from './agent-DExqjqYy.cjs';
+import { ac as RunEvent, v as CostBreakdown, R as RunResult, P as ProviderRoutingSettings, S as SDKAgent, M as McpServerConfig, C as ContextSettings, a as PluginsSettings, b as Run, c as Processor, J as JudgeResult, G as GoalOptions, d as GoalEvent, e as GoalResult, f as MemoryId, g as RunEventSink$1, h as SDKProvider, i as SDKMessage } from './sdk-agent-DwzHcuxy.cjs';
+export { A as AgentConversationTurn, j as AgentMemory, k as AgentOperation, l as AssistantMessage, m as CompletionCheck, n as CompletionCheckResult, o as ContextBudget, p as ContextManagerKind, q as ContextSnapshot, r as ContextSource, s as ContextSourceStatus, t as ConversationStep, u as ConversationTurn, v as CostBreakdown, w as CostSource, x as CostStatus, D as DoomLoopThresholds, E as EnvPolicy, F as ForkOptions, y as ForkResult, z as GenerateOptions, B as GenerateRunResult, I as InputProcessorContext, H as InteractionUpdate, K as InvalidateCacheOptions, L as McpAuthConfig, N as McpHttpServerConfig, O as McpOAuthConfig, Q as McpStdioServerConfig, T as MemoryAdapter, U as MemoryAdapterCapabilities, V as MemoryContext, W as MemoryFact, X as MemoryRevision, Y as MemoryToolSchema, Z as MemoryTurnMessage, _ as MessageOrigin, $ as OutputProcessorContext, a0 as PartialToolCallUpdate, a1 as PersonalityPreset, a2 as ProcessorControls, a3 as ProcessorTripwire, a4 as ProcessorViolation, a5 as ProviderCapability, a6 as ProviderRoute, a7 as PruneToolResultsOptions, a8 as ResolvedProviderRoute, a9 as RunCompactBoundaryEvent, aa as RunCompletionCheckEvent, ab as RunErrorDetail, ac as RunEvent, ad as RunGitInfo, ae as RunMemoryDegradedEvent, af as RunPermissionDeniedEvent, ag as RunRateLimitEvent, ah as RunStatus, ai as RunTaskCompletedEvent, aj as RunTaskStartedEvent, ak as RunTaskUpdatedEvent, al as RunTimelineEvent, am as RunToCompletionOptions, an as RunToCompletionResult, ao as RunToolProgressEvent, ap as RunTripwireEvent, aq as RunUntilIterator, ar as SDKAgentPlugins, as as SDKAgentSkillDetail, at as SDKAgentSkills, au as SDKArtifact, av as SDKAssistantMessage, aw as SDKContextManager, ax as SDKImage, ay as SDKImageDimension, az as SDKObjectDelta, aA as SDKPluginMetadata, aB as SDKProvidersManager, aC as SDKRequestMessage, aD as SDKStatusMessage, aE as SDKSystemMessage, aF as SDKTaskMessage, aG as SDKThinkingMessage, aH as SDKToolUseMessage, aI as SDKUserMessage, aJ as SDKUserMessageEvent, aK as SendOptions, aL as ShellCommand, aM as ShellConversationTurn, aN as ShellOutput, aO as ShellOutputDeltaUpdate, aP as StepCompletedUpdate, aQ as StepStartedUpdate, aR as StreamToCompletionResult, aS as SummaryCompletedUpdate, aT as SummaryStartedUpdate, aU as SummaryUpdate, aV as SystemPromptSkillRef, aW as TextDeltaUpdate, aX as ThinkingCompletedUpdate, aY as ThinkingDeltaUpdate, aZ as ThinkingMessage, a_ as TokenDeltaUpdate, a$ as TokenUsage, b0 as ToolCall, b1 as ToolCallCompletedUpdate, b2 as ToolCallStartedUpdate, b3 as ToolResult, b4 as ToolResultGuardOptions, b5 as ToolUseBlock, b6 as TurnEndedUpdate, b7 as UserMessage, b8 as UserMessageAppendedUpdate, b9 as Verdict } from './sdk-agent-DwzHcuxy.cjs';
 import * as zod from 'zod';
 import { ZodType, z } from 'zod';
 import { S as StructuredOutputError, B as BudgetOptions, a as BudgetHandle, b as BudgetSnapshot } from './errors-BiDQFWTG.cjs';
 export { A as AgentDisposedError, c as AgentRunError, d as AgentRunErrorCode, e as AuthenticationError, f as BudgetExceedEvent, g as BudgetExceededError, h as BudgetLimit, i as BudgetMode, j as BudgetScope, k as BudgetThresholdEvent, l as BudgetWindow, C as ConfigurationError, I as IntegrationNotConnectedError, m as InvalidTaskIdError, M as MemoryAdapterError, n as MemoryAdapterErrorCode, N as NetworkError, R as RateLimitError, T as TaskNotFoundError, U as UnknownAgentError, o as UnsupportedBudgetOperationError, p as UnsupportedRunOperationError, q as UnsupportedTaskOperationError, r as isTransientError } from './errors-BiDQFWTG.cjs';
 import { M as ModelSelection, C as CustomTool, T as ToolResultContentBlock, P as PermissionMode } from './agent-prims-CZyxfCmS.cjs';
 export { I as ImageBlock, a as ModelParameterValue, R as RunOperation, b as TextBlock, c as ToolContextMessage } from './agent-prims-CZyxfCmS.cjs';
-export { C as Cron, a as CronCreateOptions, b as CronGetOptions, c as CronJob, d as CronJobStatus, e as CronListOptions, f as CronOperationOptions, g as CronRunOptions, h as CronRuntime, i as CronSchedulerStatus, j as CronStartOptions } from './cron-BWDYetbq.cjs';
+export { C as Cron, a as CronCreateOptions, b as CronGetOptions, c as CronJob, d as CronJobStatus, e as CronListOptions, f as CronOperationOptions, g as CronRunOptions, h as CronRuntime, i as CronSchedulerStatus, j as CronStartOptions } from './cron-CK2v0VWA.cjs';
 import { StepResult } from './workflow.cjs';
 export { Workflow, agentStep, fn } from './workflow.cjs';
 
@@ -242,6 +243,19 @@ interface StreamObjectOptions<T extends ZodType> {
      * when the right env key is set under a different provider name.
      */
     providers?: ProviderRoutingSettings;
+    /**
+     * Builtin tools removed from the transient agent's catalogue, forwarded to
+     * {@link AgentOptions.withheldBuiltinTools}. Absent ⇒ unchanged default: the agent holds
+     * `shell`. Pass `["shell"]` for a step that must only produce JSON. The `output` tool is
+     * never withheld.
+     */
+    withheldBuiltinTools?: readonly BuiltinToolName[];
+    /**
+     * Memory settings for the transient agent, forwarded to {@link AgentOptions.memory}.
+     * Absent ⇒ unchanged default (a session transcript is written). Pass `{ enabled: false }`
+     * for a step that must leave no transcript.
+     */
+    memory?: MemorySettings;
 }
 /**
  * Recursive partial — `T` where every nested field becomes optional.
@@ -340,6 +354,19 @@ interface GenerateObjectOptions<T extends ZodType> {
      *   to raw.
      */
     errorStrategy?: "throw" | "return-partial" | "return-raw";
+    /**
+     * Builtin tools removed from every transient agent's catalogue (the reasoning-phase agent of
+     * `structuringModel` included), forwarded to {@link AgentOptions.withheldBuiltinTools}.
+     * Absent ⇒ unchanged default: the agent holds `shell`. Pass `["shell"]` for a step that must
+     * only produce JSON. The `output` tool is never withheld.
+     */
+    withheldBuiltinTools?: readonly BuiltinToolName[];
+    /**
+     * Memory settings for every transient agent of the call, forwarded to {@link AgentOptions.memory}.
+     * Absent ⇒ unchanged default (a session transcript is written). Pass `{ enabled: false }`
+     * for a step that must leave no transcript.
+     */
+    memory?: MemorySettings;
 }
 /**
  * Successful return from {@link Agent.generateObject}.
@@ -1652,13 +1679,15 @@ declare class Provider {
  * listed by name and description, with the instructions under the frontmatter unable to arrive.
  */
 type ReadableSkill = InlineSkill | Skill;
+/** A fixed list, or a function re-evaluated on every call so later-discovered skills are readable. */
+type SkillReadSource = ReadonlyArray<ReadableSkill> | (() => ReadonlyArray<ReadableSkill> | Promise<ReadonlyArray<ReadableSkill>>);
 /** SE36 — `SkillReadTool.create` replaces `defineSkillReadTool` (ADR 0015). @public  *
  * `SkillReadTool.create` returns a **`CustomTool`** — a skill-reading tool, not a
  * `SkillReadTool` instance.
  */
 declare class SkillReadTool {
     private constructor();
-    static create(skills: ReadonlyArray<ReadableSkill>): CustomTool;
+    static create(skills: SkillReadSource): CustomTool;
 }
 
 /**
@@ -4492,4 +4521,4 @@ interface WiringRecordInput<K extends string> {
  */
 declare function recordWiring<K extends string>(input: WiringRecordInput<K>): Readonly<Record<K, WiredEntity>>;
 
-export { Agent, AgentBuilder, type AgentBuilderDeps, AgentDefinition, type AgentDescription, AgentFactory, AgentOperationOptions, AgentOptions, type AgentPromptResult, type AgentRegistryOptions, type ApprovalDecision, type ApprovalInput, type ApprovalMode, type ApprovalOutcome, type ApprovalReason, type BatchItem, type BatchOptions, type BatchProgress, type BatchResult, type BlastRadiusDecision, type BlastRadiusInput, type BlastRadiusOutcome, type BlastRadiusReason, Budget, BudgetHandle, BudgetOptions, BudgetSnapshot, type BudgetTracker, CloudOptions, ContextSettings, type CounterBudgetTrackerOptions, type CredentialInput, type CredentialReport, type CustomTool, type DeclaredAction, type DeclaredLayer, type DeepPartial, type DefineProviderOptions, type DefineToolSpec, type DiagnosticsSink, type DreamingSweepOptions, type DreamingSweepResult, type EffectiveToolCatalog, type EnvOptOut, type EnvReachabilityAudit, type EnvReachabilityInput, ErrorMetadata, EventBus, type EvictReason, GOAL_CONTINUATION_MARKER, GenerateObjectError, type GenerateObjectOptions, type GenerateObjectResult, GetAgentOptions, GetRunOptions, GoalEvent, type GoalLoopAgent, GoalOptions, GoalResult, InlineSkill, JobQueue, type JobQueueOptions, JudgeCredentialError, type JudgeResult, type KeepReason, type KeptArtifact, LayerOrderError, type LayerValues, ListAgentsOptions, ListResult, ListRunsOptions, type LiveAgentRegistry, LiveSessionError, type LiveSessionReason, LocalOptions, type ManagedSettings, McpServerConfig, Memory, MemoryId, type MemoryProvider, MemorySettings, type MigrateOptions, type MigrateResult, type ModelListItem, type ModelParameterDefinition, ModelSelection, type ModelVariant, NoopMemoryProvider, type NormalizedJsonSchema, type OTelSpan, type PermissionAction, PermissionEngine, type PermissionEngineOptions, type PermissionFloorContext, type PermissionGate, type PermissionGateContext, type PermissionGateDecision, PermissionMode, PermissionPlugin, type PermissionPluginOptions, type PermissionRule, type PermissionRuleSet, Plugin, PluginsSettings, PreToolCallDecision, type Processor, Provider, type ProviderProfile, ProviderRoutingSettings, type ReadSessionMessagesOptions, type ReapPlan, type ReapPlanInput, type ReapableArtifact, type RetentionPolicy, RetentionPolicyError, Run, RunEventSink$1 as RunEventSink, RunResult, type SDKAgent, SDKAgentInfo, SDKMessage, type SDKModel, SDKProvider, type SDKRepository, type SDKUser, SOVEREIGN_ENV_KEYS, Security, type SecurityFloorInput, type SessionMessage, type SessionMessagePart, type SessionScope, type ShareGptMessage, type ShareGptTrajectory, SkillReadTool, SkillsSettings, type SovereignEnvKey, Squad, type SquadOptions, type SquadRun, StreamObjectError, type StreamObjectEvent, type StreamObjectOptions, SystemPromptResolver, TASK_RESERVED_PREFIXES, Task, type TaskCancelResult, type TaskConfigureOptions, type TaskEvent, type TaskFilter, type TaskHandle, type TaskKind, type TaskState, type TaskStoreOptions, type TaskSubmitOptions, type TaskWorkContext, type TaskWorkFn, type TelemetryHandle, Theokit, TheokitAgentError, type TheokitRequestOptions, TokenLimiter, type TokenLimiterOptions, Tool, ToolError, type ToolResultContentBlock, type TrustLevel, type TrustPosture, type TrustPostureInput, type TrustSource, UngatedCapabilityError, UnicodeNormalizer, type UnicodeNormalizerOptions, type UnresolvedToolSource, UsageAccumulator, type WiredEntity, type WiringRecordInput, type WithBlastRadius, applyMode, applySecurityFloor, auditEnvReachability, chargeAndCheckThresholds, computeCost, createCounterBudgetTracker, createTokenLimiter, createUnicodeNormalizer, decideApproval, describeAction, describeCredential, effectiveToolNames, emitRunEvent, estimateTokens, evaluateBlastRadius, extractRawId, foldLayers, getPricingEntry, guardSessionDestruction, inferApiMode, isInside, isValidTaskId, loadProjectEnv, managedSettingsPathFor, migrateSqliteToLance, mkMemoryId, normalizeSchema, normalizeUsage, parsePermissionRules, permissionFloorReason, planReaping, preflightCheck, readManagedSettings, readSessionMessages, recordWiring, resolveTrustPosture, runGoalLoop, scopedConversationId, sessionScopePrefix, setDiagnosticsSink, toShareGptTrajectory, verifyLayerOrdering, withBlastRadius, withCwdMutex };
+export { Agent, AgentBuilder, type AgentBuilderDeps, AgentDefinition, type AgentDescription, AgentFactory, AgentOperationOptions, AgentOptions, type AgentPromptResult, type AgentRegistryOptions, type ApprovalDecision, type ApprovalInput, type ApprovalMode, type ApprovalOutcome, type ApprovalReason, type BatchItem, type BatchOptions, type BatchProgress, type BatchResult, type BlastRadiusDecision, type BlastRadiusInput, type BlastRadiusOutcome, type BlastRadiusReason, Budget, BudgetHandle, BudgetOptions, BudgetSnapshot, type BudgetTracker, BuiltinToolName, CloudOptions, ContextSettings, type CounterBudgetTrackerOptions, type CredentialInput, type CredentialReport, type CustomTool, type DeclaredAction, type DeclaredLayer, type DeepPartial, type DefineProviderOptions, type DefineToolSpec, type DiagnosticsSink, type DreamingSweepOptions, type DreamingSweepResult, type EffectiveToolCatalog, type EnvOptOut, type EnvReachabilityAudit, type EnvReachabilityInput, ErrorMetadata, EventBus, type EvictReason, GOAL_CONTINUATION_MARKER, GenerateObjectError, type GenerateObjectOptions, type GenerateObjectResult, GetAgentOptions, GetRunOptions, GoalEvent, type GoalLoopAgent, GoalOptions, GoalResult, InlineSkill, JobQueue, type JobQueueOptions, JudgeCredentialError, type JudgeResult, type KeepReason, type KeptArtifact, LayerOrderError, type LayerValues, ListAgentsOptions, ListResult, ListRunsOptions, type LiveAgentRegistry, LiveSessionError, type LiveSessionReason, LocalOptions, type ManagedSettings, McpServerConfig, Memory, MemoryId, type MemoryProvider, MemorySettings, type MigrateOptions, type MigrateResult, type ModelListItem, type ModelParameterDefinition, ModelSelection, type ModelVariant, NoopMemoryProvider, type NormalizedJsonSchema, type OTelSpan, type PermissionAction, PermissionEngine, type PermissionEngineOptions, type PermissionFloorContext, type PermissionGate, type PermissionGateContext, type PermissionGateDecision, PermissionMode, PermissionPlugin, type PermissionPluginOptions, type PermissionRule, type PermissionRuleSet, Plugin, PluginsSettings, PreToolCallDecision, type Processor, Provider, type ProviderProfile, ProviderRoutingSettings, type ReadSessionMessagesOptions, type ReapPlan, type ReapPlanInput, type ReapableArtifact, type RetentionPolicy, RetentionPolicyError, Run, RunEventSink$1 as RunEventSink, RunResult, type SDKAgent, SDKAgentInfo, SDKMessage, type SDKModel, SDKProvider, type SDKRepository, type SDKUser, SOVEREIGN_ENV_KEYS, Security, type SecurityFloorInput, type SessionMessage, type SessionMessagePart, type SessionScope, type ShareGptMessage, type ShareGptTrajectory, SkillReadTool, SkillsSettings, type SovereignEnvKey, Squad, type SquadOptions, type SquadRun, StreamObjectError, type StreamObjectEvent, type StreamObjectOptions, SystemPromptResolver, TASK_RESERVED_PREFIXES, Task, type TaskCancelResult, type TaskConfigureOptions, type TaskEvent, type TaskFilter, type TaskHandle, type TaskKind, type TaskState, type TaskStoreOptions, type TaskSubmitOptions, type TaskWorkContext, type TaskWorkFn, type TelemetryHandle, Theokit, TheokitAgentError, type TheokitRequestOptions, TokenLimiter, type TokenLimiterOptions, Tool, ToolError, type ToolResultContentBlock, type TrustLevel, type TrustPosture, type TrustPostureInput, type TrustSource, UngatedCapabilityError, UnicodeNormalizer, type UnicodeNormalizerOptions, type UnresolvedToolSource, UsageAccumulator, type WiredEntity, type WiringRecordInput, type WithBlastRadius, applyMode, applySecurityFloor, auditEnvReachability, chargeAndCheckThresholds, computeCost, createCounterBudgetTracker, createTokenLimiter, createUnicodeNormalizer, decideApproval, describeAction, describeCredential, effectiveToolNames, emitRunEvent, estimateTokens, evaluateBlastRadius, extractRawId, foldLayers, getPricingEntry, guardSessionDestruction, inferApiMode, isInside, isValidTaskId, loadProjectEnv, managedSettingsPathFor, migrateSqliteToLance, mkMemoryId, normalizeSchema, normalizeUsage, parsePermissionRules, permissionFloorReason, planReaping, preflightCheck, readManagedSettings, readSessionMessages, recordWiring, resolveTrustPosture, runGoalLoop, scopedConversationId, sessionScopePrefix, setDiagnosticsSink, toShareGptTrajectory, verifyLayerOrdering, withBlastRadius, withCwdMutex };

package/dist/index.d.ts

@@ -1,16 +1,17 @@
+import { TokenUsage } from "./types/index.js";
 import { T as TheokitAgentError, E as ErrorMetadata } from './errors-base-B5g01neU.js';
 export { a as ErrorCode } from './errors-base-B5g01neU.js';
-import { A as AgentOptions, L as LocalOptions, S as SystemPromptResolver, C as CloudOptions, M as MemorySettings, a as AgentDefinition, b as SkillsSettings, c as ListAgentsOptions, d as ListResult, e as SDKAgentInfo, G as GetAgentOptions, f as ListRunsOptions, g as GetRunOptions, h as AgentOperationOptions, i as AgentDescription, P as Plugin$1, j as ProviderProfile, I as InlineSkill, k as Skill, B as BudgetTracker, l as MemoryProvider, m as PreToolCallDecision } from './agent-CVzDy_Oj.js';
-export { n as ActiveMemoryPassArgs, o as ActiveMemoryPassResult, p as AgentSubagentDescription, q as AgentToolDescription, r as BudgetCheck, s as BudgetTotal, t as BudgetUsageEvent, u as BuiltinToolName, v as CloudEnv, w as CloudRepo, x as CompatSource, y as CompatSourceAdapter, z as CompatSurface, D as CreateSkillSpec, H as HookApprovalGate, E as HookApprovalRequest, F as HookName, J as LlmCallContext, K as MemoryProviderAgentRef, N as MemoryProviderFactory, O as MemoryProviderHandle, Q as MemoryProviderInitOptions, R as PluginContext, T as PluginHookDisposer, U as PostAssistantReplyContext, V as PostToolCallContext, W as PreToolCallContext, X as PreUserSendContext, Y as PreUserSendResult, Z as ProviderTransform, _ as ProviderTransformContext, $ as RecordSessionSummaryArgs, a0 as SessionLifecycleContext, a1 as SessionRecord, a2 as SessionStore, a3 as SettingSource, a4 as Skill, a5 as SkillsResolver, a6 as SkillsResolverContext, a7 as SystemPromptContext, a8 as SystemPromptMemoryFact, a9 as TelemetrySettings, aa as ToolCallSummary, ab as ToolContext, ac as ToolResultTransformContext, ad as TransformContext } from './agent-CVzDy_Oj.js';
-import { ab as RunEvent, v as CostBreakdown, a_ as TokenUsage, R as RunResult, P as ProviderRoutingSettings, S as SDKAgent, M as McpServerConfig, C as ContextSettings, a as PluginsSettings, b as Run, c as Processor, J as JudgeResult, G as GoalOptions, d as GoalEvent, e as GoalResult, f as MemoryId, g as RunEventSink$1, h as SDKProvider, i as SDKMessage } from './sdk-agent-CTOJlWA_.js';
-export { A as AgentConversationTurn, j as AgentMemory, k as AgentOperation, l as AssistantMessage, m as CompletionCheck, n as CompletionCheckResult, o as ContextBudget, p as ContextManagerKind, q as ContextSnapshot, r as ContextSource, s as ContextSourceStatus, t as ConversationStep, u as ConversationTurn, v as CostBreakdown, w as CostSource, x as CostStatus, D as DoomLoopThresholds, E as EnvPolicy, F as ForkOptions, y as ForkResult, z as GenerateOptions, B as GenerateRunResult, I as InputProcessorContext, H as InteractionUpdate, K as InvalidateCacheOptions, L as McpAuthConfig, N as McpHttpServerConfig, O as McpOAuthConfig, Q as McpStdioServerConfig, T as MemoryAdapter, U as MemoryAdapterCapabilities, V as MemoryContext, W as MemoryFact, X as MemoryRevision, Y as MemoryToolSchema, Z as MemoryTurnMessage, _ as MessageOrigin, $ as OutputProcessorContext, a0 as PartialToolCallUpdate, a1 as PersonalityPreset, a2 as ProcessorControls, a3 as ProcessorTripwire, a4 as ProcessorViolation, a5 as ProviderCapability, a6 as ProviderRoute, a7 as ResolvedProviderRoute, a8 as RunCompactBoundaryEvent, a9 as RunCompletionCheckEvent, aa as RunErrorDetail, ab as RunEvent, ac as RunGitInfo, ad as RunMemoryDegradedEvent, ae as RunPermissionDeniedEvent, af as RunRateLimitEvent, ag as RunStatus, ah as RunTaskCompletedEvent, ai as RunTaskStartedEvent, aj as RunTaskUpdatedEvent, ak as RunTimelineEvent, al as RunToCompletionOptions, am as RunToCompletionResult, an as RunToolProgressEvent, ao as RunTripwireEvent, ap as RunUntilIterator, aq as SDKAgentPlugins, ar as SDKAgentSkillDetail, as as SDKAgentSkills, at as SDKArtifact, au as SDKAssistantMessage, av as SDKContextManager, aw as SDKImage, ax as SDKImageDimension, ay as SDKObjectDelta, az as SDKPluginMetadata, aA as SDKProvidersManager, aB as SDKRequestMessage, aC as SDKStatusMessage, aD as SDKSystemMessage, aE as SDKTaskMessage, aF as SDKThinkingMessage, aG as SDKToolUseMessage, aH as SDKUserMessage, aI as SDKUserMessageEvent, aJ as SendOptions, aK as ShellCommand, aL as ShellConversationTurn, aM as ShellOutput, aN as ShellOutputDeltaUpdate, aO as StepCompletedUpdate, aP as StepStartedUpdate, aQ as StreamToCompletionResult, aR as SummaryCompletedUpdate, aS as SummaryStartedUpdate, aT as SummaryUpdate, aU as SystemPromptSkillRef, aV as TextDeltaUpdate, aW as ThinkingCompletedUpdate, aX as ThinkingDeltaUpdate, aY as ThinkingMessage, aZ as TokenDeltaUpdate, a_ as TokenUsage, a$ as ToolCall, b0 as ToolCallCompletedUpdate, b1 as ToolCallStartedUpdate, b2 as ToolResult, b3 as ToolResultGuardOptions, b4 as ToolUseBlock, b5 as TurnEndedUpdate, b6 as UserMessage, b7 as UserMessageAppendedUpdate, b8 as Verdict } from './sdk-agent-CTOJlWA_.js';
+import { A as AgentOptions, L as LocalOptions, B as BuiltinToolName, M as MemorySettings, S as SystemPromptResolver, C as CloudOptions, a as AgentDefinition, b as SkillsSettings, c as ListAgentsOptions, d as ListResult, e as SDKAgentInfo, G as GetAgentOptions, f as ListRunsOptions, g as GetRunOptions, h as AgentOperationOptions, i as AgentDescription, P as Plugin$1, j as ProviderProfile, I as InlineSkill, k as Skill, l as BudgetTracker, m as MemoryProvider, n as PreToolCallDecision } from './agent-Dfw3VsIX.js';
+export { o as ActiveMemoryPassArgs, p as ActiveMemoryPassResult, q as AgentSubagentDescription, r as AgentToolDescription, s as BudgetCheck, t as BudgetTotal, u as BudgetUsageEvent, v as CloudEnv, w as CloudRepo, x as CompatSource, y as CompatSourceAdapter, z as CompatSurface, D as CreateSkillSpec, H as HookApprovalGate, E as HookApprovalRequest, F as HookName, J as LlmCallContext, K as MemoryProviderAgentRef, N as MemoryProviderFactory, O as MemoryProviderHandle, Q as MemoryProviderInitOptions, R as PluginContext, T as PluginHookDisposer, U as PostAssistantReplyContext, V as PostToolCallContext, W as PreToolCallContext, X as PreUserSendContext, Y as PreUserSendResult, Z as ProviderTransform, _ as ProviderTransformContext, $ as RecordSessionSummaryArgs, a0 as SessionLifecycleContext, a1 as SessionRecord, a2 as SessionStore, a3 as SettingSource, a4 as Skill, a5 as SkillsResolver, a6 as SkillsResolverContext, a7 as SystemPromptContext, a8 as SystemPromptMemoryFact, a9 as TelemetrySettings, aa as ToolCallSummary, ab as ToolContext, ac as ToolResultTransformContext, ad as TransformContext } from './agent-Dfw3VsIX.js';
+import { ac as RunEvent, v as CostBreakdown, R as RunResult, P as ProviderRoutingSettings, S as SDKAgent, M as McpServerConfig, C as ContextSettings, a as PluginsSettings, b as Run, c as Processor, J as JudgeResult, G as GoalOptions, d as GoalEvent, e as GoalResult, f as MemoryId, g as RunEventSink$1, h as SDKProvider, i as SDKMessage } from './sdk-agent-a3fW1xUK.js';
+export { A as AgentConversationTurn, j as AgentMemory, k as AgentOperation, l as AssistantMessage, m as CompletionCheck, n as CompletionCheckResult, o as ContextBudget, p as ContextManagerKind, q as ContextSnapshot, r as ContextSource, s as ContextSourceStatus, t as ConversationStep, u as ConversationTurn, v as CostBreakdown, w as CostSource, x as CostStatus, D as DoomLoopThresholds, E as EnvPolicy, F as ForkOptions, y as ForkResult, z as GenerateOptions, B as GenerateRunResult, I as InputProcessorContext, H as InteractionUpdate, K as InvalidateCacheOptions, L as McpAuthConfig, N as McpHttpServerConfig, O as McpOAuthConfig, Q as McpStdioServerConfig, T as MemoryAdapter, U as MemoryAdapterCapabilities, V as MemoryContext, W as MemoryFact, X as MemoryRevision, Y as MemoryToolSchema, Z as MemoryTurnMessage, _ as MessageOrigin, $ as OutputProcessorContext, a0 as PartialToolCallUpdate, a1 as PersonalityPreset, a2 as ProcessorControls, a3 as ProcessorTripwire, a4 as ProcessorViolation, a5 as ProviderCapability, a6 as ProviderRoute, a7 as PruneToolResultsOptions, a8 as ResolvedProviderRoute, a9 as RunCompactBoundaryEvent, aa as RunCompletionCheckEvent, ab as RunErrorDetail, ac as RunEvent, ad as RunGitInfo, ae as RunMemoryDegradedEvent, af as RunPermissionDeniedEvent, ag as RunRateLimitEvent, ah as RunStatus, ai as RunTaskCompletedEvent, aj as RunTaskStartedEvent, ak as RunTaskUpdatedEvent, al as RunTimelineEvent, am as RunToCompletionOptions, an as RunToCompletionResult, ao as RunToolProgressEvent, ap as RunTripwireEvent, aq as RunUntilIterator, ar as SDKAgentPlugins, as as SDKAgentSkillDetail, at as SDKAgentSkills, au as SDKArtifact, av as SDKAssistantMessage, aw as SDKContextManager, ax as SDKImage, ay as SDKImageDimension, az as SDKObjectDelta, aA as SDKPluginMetadata, aB as SDKProvidersManager, aC as SDKRequestMessage, aD as SDKStatusMessage, aE as SDKSystemMessage, aF as SDKTaskMessage, aG as SDKThinkingMessage, aH as SDKToolUseMessage, aI as SDKUserMessage, aJ as SDKUserMessageEvent, aK as SendOptions, aL as ShellCommand, aM as ShellConversationTurn, aN as ShellOutput, aO as ShellOutputDeltaUpdate, aP as StepCompletedUpdate, aQ as StepStartedUpdate, aR as StreamToCompletionResult, aS as SummaryCompletedUpdate, aT as SummaryStartedUpdate, aU as SummaryUpdate, aV as SystemPromptSkillRef, aW as TextDeltaUpdate, aX as ThinkingCompletedUpdate, aY as ThinkingDeltaUpdate, aZ as ThinkingMessage, a_ as TokenDeltaUpdate, a$ as TokenUsage, b0 as ToolCall, b1 as ToolCallCompletedUpdate, b2 as ToolCallStartedUpdate, b3 as ToolResult, b4 as ToolResultGuardOptions, b5 as ToolUseBlock, b6 as TurnEndedUpdate, b7 as UserMessage, b8 as UserMessageAppendedUpdate, b9 as Verdict } from './sdk-agent-a3fW1xUK.js';
 import * as zod from 'zod';
 import { ZodType, z } from 'zod';
 import { S as StructuredOutputError, B as BudgetOptions, a as BudgetHandle, b as BudgetSnapshot } from './errors-Pf22PJJ-.js';
 export { A as AgentDisposedError, c as AgentRunError, d as AgentRunErrorCode, e as AuthenticationError, f as BudgetExceedEvent, g as BudgetExceededError, h as BudgetLimit, i as BudgetMode, j as BudgetScope, k as BudgetThresholdEvent, l as BudgetWindow, C as ConfigurationError, I as IntegrationNotConnectedError, m as InvalidTaskIdError, M as MemoryAdapterError, n as MemoryAdapterErrorCode, N as NetworkError, R as RateLimitError, T as TaskNotFoundError, U as UnknownAgentError, o as UnsupportedBudgetOperationError, p as UnsupportedRunOperationError, q as UnsupportedTaskOperationError, r as isTransientError } from './errors-Pf22PJJ-.js';
 import { M as ModelSelection, C as CustomTool, T as ToolResultContentBlock, P as PermissionMode } from './agent-prims-CZyxfCmS.js';
 export { I as ImageBlock, a as ModelParameterValue, R as RunOperation, b as TextBlock, c as ToolContextMessage } from './agent-prims-CZyxfCmS.js';
-export { C as Cron, a as CronCreateOptions, b as CronGetOptions, c as CronJob, d as CronJobStatus, e as CronListOptions, f as CronOperationOptions, g as CronRunOptions, h as CronRuntime, i as CronSchedulerStatus, j as CronStartOptions } from './cron-CHn-F0fC.js';
+export { C as Cron, a as CronCreateOptions, b as CronGetOptions, c as CronJob, d as CronJobStatus, e as CronListOptions, f as CronOperationOptions, g as CronRunOptions, h as CronRuntime, i as CronSchedulerStatus, j as CronStartOptions } from './cron-BubDpFJG.js';
 import { StepResult } from './workflow.js';
 export { Workflow, agentStep, fn } from './workflow.js';
 
@@ -242,6 +243,19 @@ interface StreamObjectOptions<T extends ZodType> {
      * when the right env key is set under a different provider name.
      */
     providers?: ProviderRoutingSettings;
+    /**
+     * Builtin tools removed from the transient agent's catalogue, forwarded to
+     * {@link AgentOptions.withheldBuiltinTools}. Absent ⇒ unchanged default: the agent holds
+     * `shell`. Pass `["shell"]` for a step that must only produce JSON. The `output` tool is
+     * never withheld.
+     */
+    withheldBuiltinTools?: readonly BuiltinToolName[];
+    /**
+     * Memory settings for the transient agent, forwarded to {@link AgentOptions.memory}.
+     * Absent ⇒ unchanged default (a session transcript is written). Pass `{ enabled: false }`
+     * for a step that must leave no transcript.
+     */
+    memory?: MemorySettings;
 }
 /**
  * Recursive partial — `T` where every nested field becomes optional.
@@ -340,6 +354,19 @@ interface GenerateObjectOptions<T extends ZodType> {
      *   to raw.
      */
     errorStrategy?: "throw" | "return-partial" | "return-raw";
+    /**
+     * Builtin tools removed from every transient agent's catalogue (the reasoning-phase agent of
+     * `structuringModel` included), forwarded to {@link AgentOptions.withheldBuiltinTools}.
+     * Absent ⇒ unchanged default: the agent holds `shell`. Pass `["shell"]` for a step that must
+     * only produce JSON. The `output` tool is never withheld.
+     */
+    withheldBuiltinTools?: readonly BuiltinToolName[];
+    /**
+     * Memory settings for every transient agent of the call, forwarded to {@link AgentOptions.memory}.
+     * Absent ⇒ unchanged default (a session transcript is written). Pass `{ enabled: false }`
+     * for a step that must leave no transcript.
+     */
+    memory?: MemorySettings;
 }
 /**
  * Successful return from {@link Agent.generateObject}.
@@ -1652,13 +1679,15 @@ declare class Provider {
  * listed by name and description, with the instructions under the frontmatter unable to arrive.
  */
 type ReadableSkill = InlineSkill | Skill;
+/** A fixed list, or a function re-evaluated on every call so later-discovered skills are readable. */
+type SkillReadSource = ReadonlyArray<ReadableSkill> | (() => ReadonlyArray<ReadableSkill> | Promise<ReadonlyArray<ReadableSkill>>);
 /** SE36 — `SkillReadTool.create` replaces `defineSkillReadTool` (ADR 0015). @public  *
  * `SkillReadTool.create` returns a **`CustomTool`** — a skill-reading tool, not a
  * `SkillReadTool` instance.
  */
 declare class SkillReadTool {
     private constructor();
-    static create(skills: ReadonlyArray<ReadableSkill>): CustomTool;
+    static create(skills: SkillReadSource): CustomTool;
 }
 
 /**
@@ -4492,4 +4521,4 @@ interface WiringRecordInput<K extends string> {
  */
 declare function recordWiring<K extends string>(input: WiringRecordInput<K>): Readonly<Record<K, WiredEntity>>;
 
-export { Agent, AgentBuilder, type AgentBuilderDeps, AgentDefinition, type AgentDescription, AgentFactory, AgentOperationOptions, AgentOptions, type AgentPromptResult, type AgentRegistryOptions, type ApprovalDecision, type ApprovalInput, type ApprovalMode, type ApprovalOutcome, type ApprovalReason, type BatchItem, type BatchOptions, type BatchProgress, type BatchResult, type BlastRadiusDecision, type BlastRadiusInput, type BlastRadiusOutcome, type BlastRadiusReason, Budget, BudgetHandle, BudgetOptions, BudgetSnapshot, type BudgetTracker, CloudOptions, ContextSettings, type CounterBudgetTrackerOptions, type CredentialInput, type CredentialReport, type CustomTool, type DeclaredAction, type DeclaredLayer, type DeepPartial, type DefineProviderOptions, type DefineToolSpec, type DiagnosticsSink, type DreamingSweepOptions, type DreamingSweepResult, type EffectiveToolCatalog, type EnvOptOut, type EnvReachabilityAudit, type EnvReachabilityInput, ErrorMetadata, EventBus, type EvictReason, GOAL_CONTINUATION_MARKER, GenerateObjectError, type GenerateObjectOptions, type GenerateObjectResult, GetAgentOptions, GetRunOptions, GoalEvent, type GoalLoopAgent, GoalOptions, GoalResult, InlineSkill, JobQueue, type JobQueueOptions, JudgeCredentialError, type JudgeResult, type KeepReason, type KeptArtifact, LayerOrderError, type LayerValues, ListAgentsOptions, ListResult, ListRunsOptions, type LiveAgentRegistry, LiveSessionError, type LiveSessionReason, LocalOptions, type ManagedSettings, McpServerConfig, Memory, MemoryId, type MemoryProvider, MemorySettings, type MigrateOptions, type MigrateResult, type ModelListItem, type ModelParameterDefinition, ModelSelection, type ModelVariant, NoopMemoryProvider, type NormalizedJsonSchema, type OTelSpan, type PermissionAction, PermissionEngine, type PermissionEngineOptions, type PermissionFloorContext, type PermissionGate, type PermissionGateContext, type PermissionGateDecision, PermissionMode, PermissionPlugin, type PermissionPluginOptions, type PermissionRule, type PermissionRuleSet, Plugin, PluginsSettings, PreToolCallDecision, type Processor, Provider, type ProviderProfile, ProviderRoutingSettings, type ReadSessionMessagesOptions, type ReapPlan, type ReapPlanInput, type ReapableArtifact, type RetentionPolicy, RetentionPolicyError, Run, RunEventSink$1 as RunEventSink, RunResult, type SDKAgent, SDKAgentInfo, SDKMessage, type SDKModel, SDKProvider, type SDKRepository, type SDKUser, SOVEREIGN_ENV_KEYS, Security, type SecurityFloorInput, type SessionMessage, type SessionMessagePart, type SessionScope, type ShareGptMessage, type ShareGptTrajectory, SkillReadTool, SkillsSettings, type SovereignEnvKey, Squad, type SquadOptions, type SquadRun, StreamObjectError, type StreamObjectEvent, type StreamObjectOptions, SystemPromptResolver, TASK_RESERVED_PREFIXES, Task, type TaskCancelResult, type TaskConfigureOptions, type TaskEvent, type TaskFilter, type TaskHandle, type TaskKind, type TaskState, type TaskStoreOptions, type TaskSubmitOptions, type TaskWorkContext, type TaskWorkFn, type TelemetryHandle, Theokit, TheokitAgentError, type TheokitRequestOptions, TokenLimiter, type TokenLimiterOptions, Tool, ToolError, type ToolResultContentBlock, type TrustLevel, type TrustPosture, type TrustPostureInput, type TrustSource, UngatedCapabilityError, UnicodeNormalizer, type UnicodeNormalizerOptions, type UnresolvedToolSource, UsageAccumulator, type WiredEntity, type WiringRecordInput, type WithBlastRadius, applyMode, applySecurityFloor, auditEnvReachability, chargeAndCheckThresholds, computeCost, createCounterBudgetTracker, createTokenLimiter, createUnicodeNormalizer, decideApproval, describeAction, describeCredential, effectiveToolNames, emitRunEvent, estimateTokens, evaluateBlastRadius, extractRawId, foldLayers, getPricingEntry, guardSessionDestruction, inferApiMode, isInside, isValidTaskId, loadProjectEnv, managedSettingsPathFor, migrateSqliteToLance, mkMemoryId, normalizeSchema, normalizeUsage, parsePermissionRules, permissionFloorReason, planReaping, preflightCheck, readManagedSettings, readSessionMessages, recordWiring, resolveTrustPosture, runGoalLoop, scopedConversationId, sessionScopePrefix, setDiagnosticsSink, toShareGptTrajectory, verifyLayerOrdering, withBlastRadius, withCwdMutex };
+export { Agent, AgentBuilder, type AgentBuilderDeps, AgentDefinition, type AgentDescription, AgentFactory, AgentOperationOptions, AgentOptions, type AgentPromptResult, type AgentRegistryOptions, type ApprovalDecision, type ApprovalInput, type ApprovalMode, type ApprovalOutcome, type ApprovalReason, type BatchItem, type BatchOptions, type BatchProgress, type BatchResult, type BlastRadiusDecision, type BlastRadiusInput, type BlastRadiusOutcome, type BlastRadiusReason, Budget, BudgetHandle, BudgetOptions, BudgetSnapshot, type BudgetTracker, BuiltinToolName, CloudOptions, ContextSettings, type CounterBudgetTrackerOptions, type CredentialInput, type CredentialReport, type CustomTool, type DeclaredAction, type DeclaredLayer, type DeepPartial, type DefineProviderOptions, type DefineToolSpec, type DiagnosticsSink, type DreamingSweepOptions, type DreamingSweepResult, type EffectiveToolCatalog, type EnvOptOut, type EnvReachabilityAudit, type EnvReachabilityInput, ErrorMetadata, EventBus, type EvictReason, GOAL_CONTINUATION_MARKER, GenerateObjectError, type GenerateObjectOptions, type GenerateObjectResult, GetAgentOptions, GetRunOptions, GoalEvent, type GoalLoopAgent, GoalOptions, GoalResult, InlineSkill, JobQueue, type JobQueueOptions, JudgeCredentialError, type JudgeResult, type KeepReason, type KeptArtifact, LayerOrderError, type LayerValues, ListAgentsOptions, ListResult, ListRunsOptions, type LiveAgentRegistry, LiveSessionError, type LiveSessionReason, LocalOptions, type ManagedSettings, McpServerConfig, Memory, MemoryId, type MemoryProvider, MemorySettings, type MigrateOptions, type MigrateResult, type ModelListItem, type ModelParameterDefinition, ModelSelection, type ModelVariant, NoopMemoryProvider, type NormalizedJsonSchema, type OTelSpan, type PermissionAction, PermissionEngine, type PermissionEngineOptions, type PermissionFloorContext, type PermissionGate, type PermissionGateContext, type PermissionGateDecision, PermissionMode, PermissionPlugin, type PermissionPluginOptions, type PermissionRule, type PermissionRuleSet, Plugin, PluginsSettings, PreToolCallDecision, type Processor, Provider, type ProviderProfile, ProviderRoutingSettings, type ReadSessionMessagesOptions, type ReapPlan, type ReapPlanInput, type ReapableArtifact, type RetentionPolicy, RetentionPolicyError, Run, RunEventSink$1 as RunEventSink, RunResult, type SDKAgent, SDKAgentInfo, SDKMessage, type SDKModel, SDKProvider, type SDKRepository, type SDKUser, SOVEREIGN_ENV_KEYS, Security, type SecurityFloorInput, type SessionMessage, type SessionMessagePart, type SessionScope, type ShareGptMessage, type ShareGptTrajectory, SkillReadTool, SkillsSettings, type SovereignEnvKey, Squad, type SquadOptions, type SquadRun, StreamObjectError, type StreamObjectEvent, type StreamObjectOptions, SystemPromptResolver, TASK_RESERVED_PREFIXES, Task, type TaskCancelResult, type TaskConfigureOptions, type TaskEvent, type TaskFilter, type TaskHandle, type TaskKind, type TaskState, type TaskStoreOptions, type TaskSubmitOptions, type TaskWorkContext, type TaskWorkFn, type TelemetryHandle, Theokit, TheokitAgentError, type TheokitRequestOptions, TokenLimiter, type TokenLimiterOptions, Tool, ToolError, type ToolResultContentBlock, type TrustLevel, type TrustPosture, type TrustPostureInput, type TrustSource, UngatedCapabilityError, UnicodeNormalizer, type UnicodeNormalizerOptions, type UnresolvedToolSource, UsageAccumulator, type WiredEntity, type WiringRecordInput, type WithBlastRadius, applyMode, applySecurityFloor, auditEnvReachability, chargeAndCheckThresholds, computeCost, createCounterBudgetTracker, createTokenLimiter, createUnicodeNormalizer, decideApproval, describeAction, describeCredential, effectiveToolNames, emitRunEvent, estimateTokens, evaluateBlastRadius, extractRawId, foldLayers, getPricingEntry, guardSessionDestruction, inferApiMode, isInside, isValidTaskId, loadProjectEnv, managedSettingsPathFor, migrateSqliteToLance, mkMemoryId, normalizeSchema, normalizeUsage, parsePermissionRules, permissionFloorReason, planReaping, preflightCheck, readManagedSettings, readSessionMessages, recordWiring, resolveTrustPosture, runGoalLoop, scopedConversationId, sessionScopePrefix, setDiagnosticsSink, toShareGptTrajectory, verifyLayerOrdering, withBlastRadius, withCwdMutex };

package/dist/index.js

@@ -1,19 +1,19 @@
-export { StreamObjectError } from './chunk-XRPMZ7TO.js';
+export { StreamObjectError } from './chunk-CYWOJA6B.js';
 export { GOAL_CONTINUATION_MARKER } from './chunk-PY2RQOA7.js';
 export { JudgeCredentialError } from './chunk-XZKIAENA.js';
 import { migrateSqliteToLance, appendDiaryEntry } from './chunk-MSEL5E5P.js';
-export { GenerateObjectError } from './chunk-VVGFZQZC.js';
-import './chunk-AQW54OWQ.js';
-import { Workflow, agentStep } from './chunk-ZLFFDPXC.js';
-export { Workflow, agentStep, fn } from './chunk-ZLFFDPXC.js';
-import './chunk-BO3PV3OP.js';
+export { GenerateObjectError } from './chunk-3LMVJTNJ.js';
+import './chunk-DFBWYETS.js';
+import { Workflow, agentStep } from './chunk-73IITAF7.js';
+export { Workflow, agentStep, fn } from './chunk-73IITAF7.js';
+import './chunk-TDED5XES.js';
 import './chunk-HY66GLM6.js';
-export { Cron } from './chunk-NJBJ3CUG.js';
-import { MEMORY_EMBEDDING_ADAPTERS, resolveSessionDir, DEFAULT_AGENTIC_MODEL_ID, Agent } from './chunk-BJ7BPLQK.js';
-export { Agent, AgentBuilder, Tool, ToolError, UsageAccumulator, computeCost, getPricingEntry, managedSettingsPathFor, readManagedSettings } from './chunk-BJ7BPLQK.js';
+export { Cron } from './chunk-NAVUTK6X.js';
+import { MEMORY_EMBEDDING_ADAPTERS, resolveSessionDir, DEFAULT_AGENTIC_MODEL_ID, Agent } from './chunk-GARVAUCU.js';
+export { Agent, AgentBuilder, Tool, ToolError, UsageAccumulator, computeCost, getPricingEntry, managedSettingsPathFor, readManagedSettings } from './chunk-GARVAUCU.js';
 import { configure, submit, list, get, cancel, subscribe } from './chunk-HWMGR3HA.js';
 export { emitRunEvent } from './chunk-HWMGR3HA.js';
-import './chunk-4GUFNDZR.js';
+import './chunk-3ONIVO2I.js';
 import './chunk-K2BQQ445.js';
 import './chunk-2C24NSNV.js';
 import './chunk-HJ2LV464.js';
@@ -23,8 +23,8 @@ import './chunk-H73MEMQB.js';
 import './chunk-QK2ERTO3.js';
 import { resolveMemoryRoot, readFactsFromMarkdown } from './chunk-DF77RBF4.js';
 import { FsSessionStore } from './chunk-AB4OPJLD.js';
-import { discoverProviderPlugins, shouldUseFixtureMode, isFixtureApiKey, httpRequest, mapOllamaTransportError, readErrorResponseBody, mapOllamaHttpError } from './chunk-XJ4C4NFX.js';
-export { inferApiMode, normalizeUsage } from './chunk-XJ4C4NFX.js';
+import { discoverProviderPlugins, shouldUseFixtureMode, isFixtureApiKey, httpRequest, mapOllamaTransportError, readErrorResponseBody, mapOllamaHttpError } from './chunk-ZOL3L4EH.js';
+export { inferApiMode, normalizeUsage } from './chunk-ZOL3L4EH.js';
 import './chunk-5AR6O7GW.js';
 import './chunk-2XC6KDJM.js';
 import './chunk-ZJAYFSVI.js';
@@ -41,7 +41,7 @@ import './chunk-FJWQP6EE.js';
 import './chunk-NAF4L3T6.js';
 import './chunk-VZGE7NAI.js';
 import './chunk-6X6ID4MO.js';
-import { stripSkillFrontmatter } from './chunk-NHOEXFZT.js';
+import { stripSkillFrontmatter } from './chunk-2HXTNVLM.js';
 import './chunk-4QCJAJAG.js';
 import './chunk-SAGRF4IB.js';
 import './chunk-PKRPV3R7.js';
@@ -63,13 +63,13 @@ import { CLAUDE_DIR_NAME, THEOKIT_DIR_LITERAL } from './chunk-YMVTUV5K.js';
 import './chunk-Q7UG242V.js';
 import { estimateTokens, CHARS_PER_TOKEN } from './chunk-SZQFCHU6.js';
 export { estimateTokens } from './chunk-SZQFCHU6.js';
-import './chunk-2SFLLOMN.js';
+import './chunk-NVQSBRG6.js';
 import { parseModelId } from './chunk-R7WIIPUR.js';
-import './chunk-NKQVLWDF.js';
-import { registerBuiltins, listProviders, getCatalogCapabilities, getProviderProfile } from './chunk-5HSMH2ZZ.js';
+import './chunk-ULEK4OM4.js';
+import { registerBuiltins, listProviders, getCatalogCapabilities, getProviderProfile } from './chunk-CJN5CEI3.js';
 import './chunk-AGACYRJ2.js';
-import './chunk-3FSBE4PS.js';
-import './chunk-MS3TQSXU.js';
+import './chunk-3GTN4HOO.js';
+import './chunk-QD6B6W6I.js';
 import './chunk-5IUDICRK.js';
 import './chunk-Q7GYMXVC.js';
 import { BudgetExceededError, ConfigurationError, TheokitAgentError, MemoryAdapterError, AuthenticationError } from './chunk-TNFOU6SB.js';
@@ -77,8 +77,8 @@ export { AgentDisposedError, AgentRunError, AuthenticationError, BudgetExceededE
 import { diag, redactSecrets, addPattern, resolveApiKey } from './chunk-3OY6H3I7.js';
 export { setDiagnosticsSink } from './chunk-3OY6H3I7.js';
 import { createHash, randomUUID } from 'crypto';
-import { readFile, mkdir, readdir } from 'fs/promises';
-import { resolve, normalize, sep, isAbsolute, parse, relative, dirname, join } from 'path';
+import { mkdir, readFile, readdir } from 'fs/promises';
+import { resolve, normalize, sep, isAbsolute, parse, relative, join, dirname } from 'path';
 import { z } from 'zod';
 import { homedir } from 'os';
 
@@ -630,6 +630,14 @@ async function readReferences(skillDir) {
   }
   return Object.keys(refs).length > 0 ? refs : void 0;
 }
+function readNamed(skills, name) {
+  const skill = skills.find((s) => s.name === name);
+  if (skill === void 0) {
+    const available = skills.map((s) => s.name).join(", ");
+    return `Skill "${name}" not found. Available skills: ${available.length > 0 ? available : "(none)"}.`;
+  }
+  return renderSkill(skill);
+}
 var SkillReadInputSchema = z.object({
   name: z.string().min(1, "skill_read: `name` is required.")
 });
@@ -645,7 +653,9 @@ async function renderSkill(skill) {
   }
   return parts.join("\n");
 }
-function defineSkillReadTool(skills) {
+function defineSkillReadTool(source) {
+  if (typeof source === "function") return lazySkillReadTool(source);
+  const skills = source;
   const seen = /* @__PURE__ */ new Set();
   for (const skill of skills) {
     if (seen.has(skill.name)) {
@@ -666,12 +676,18 @@ function defineSkillReadTool(skills) {
     // promise: parse and the not-found answer stay exactly as synchronous as they were.
     handler: (input) => {
       const { name } = SkillReadInputSchema.parse(input);
-      const skill = skills.find((s) => s.name === name);
-      if (skill === void 0) {
-        const available = skills.map((s) => s.name).join(", ");
-        return `Skill "${name}" not found. Available skills: ${available.length > 0 ? available : "(none)"}.`;
-      }
-      return renderSkill(skill);
+      return readNamed(skills, name);
+    }
+  };
+}
+function lazySkillReadTool(source) {
+  const fixed = defineSkillReadTool([]);
+  return {
+    ...fixed,
+    handler: async (input) => {
+      const { name } = SkillReadInputSchema.parse(input);
+      const skills = await source();
+      return readNamed(skills, name);
     }
   };
 }
@@ -1929,7 +1945,7 @@ function isBuiltAgent(m) {
   return typeof m.send === "function";
 }
 async function materialize(def, index) {
-  const { Agent: Agent2 } = await import('./agent-IG7BP6GN.js');
+  const { Agent: Agent2 } = await import('./agent-T34LCGQM.js');
   return Agent2.create({
     // `AgentDefinition.model` admits the sentinel `'inherit'`, which is not a model id. Inheriting
     // here means "declare nothing and let the default apply" — forwarding the literal would create