@theokit/sdk 2.29.0 → 2.30.0

package/dist/index.d.cts

@@ -1,9 +1,9 @@
-import { T as TheokitAgentError, B as BudgetOptions, a as BudgetHandle, b as BudgetSnapshot, E as ErrorMetadata } from './errors-tP-8O-hR.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, m as ErrorCode, I as IntegrationNotConnectedError, n as InvalidTaskIdError, M as MemoryAdapterError, o as MemoryAdapterErrorCode, N as NetworkError, R as RateLimitError, p as TaskNotFoundError, U as UnknownAgentError, q as UnsupportedBudgetOperationError, r as UnsupportedRunOperationError, s as UnsupportedTaskOperationError, t as isTransientError } from './errors-tP-8O-hR.cjs';
-import { A as AgentOptions, L as LocalOptions, P as ProviderRoutingSettings, S as SystemPromptResolver, C as CloudOptions, M as MemorySettings, a as AgentDefinition, b as ContextSettings, c as PluginsSettings, d as SkillsSettings, e as SDKAgent, f as ListAgentsOptions, g as ListResult, h as SDKAgentInfo, G as GetAgentOptions, i as ListRunsOptions, j as GetRunOptions, k as AgentOperationOptions, l as ProviderProfile, m as Plugin, I as InlineSkill, n as ConversationStorageAdapter, o as StoredMessage, p as SessionMeta, q as SessionMetaPatch, O as ObjectiveRecord, B as BudgetTracker, r as MemoryProvider, s as MemoryId, t as PreToolCallDecision, u as SDKProvider } from './cron-yJoNUZxe.cjs';
-export { v as ActiveMemoryPassArgs, w as ActiveMemoryPassResult, x as AgentGoalConfig, y as AgentMemory, z as BudgetCheck, D as BudgetTotal, E as BudgetUsageEvent, F as CloudEnv, H as CloudRepo, J as ContextBudget, K as ContextManagerKind, N as ContextSnapshot, Q as ContextSource, R as ContextSourceStatus, T as CreateSkillSpec, U as Cron, V as CronCreateOptions, W as CronGetOptions, X as CronJob, Y as CronJobStatus, Z as CronListOptions, _ as CronOperationOptions, $ as CronRunOptions, a0 as CronRuntime, a1 as CronSchedulerStatus, a2 as CronStartOptions, a3 as DurableGoalOptions, a4 as GoalEvent, a5 as GoalOptions, a6 as GoalResult, a7 as HookName, a8 as InvalidateCacheOptions, a9 as MemoryAdapter, aa as MemoryAdapterCapabilities, ab as MemoryContext, ac as MemoryFact, ad as MemoryProviderHandle, ae as MemoryProviderInitOptions, af as MemoryRevision, ag as MemoryToolSchema, ah as MemoryTurnMessage, ai as ObjectiveStatus, aj as PersonalityPreset, ak as PluginContext, al as PostAssistantReplyContext, am as PreToolCallContext, an as PreUserSendContext, ao as PreUserSendResult, ap as ProviderCapability, aq as ProviderRoute, ar as RecordSessionSummaryArgs, as as ResolvedProviderRoute, at as RunUntilIterator, au as SDKAgentPlugins, av as SDKAgentSkillDetail, aw as SDKAgentSkills, ax as SDKArtifact, ay as SDKContextManager, az as SDKPluginMetadata, aA as SDKProvidersManager, aB as SettingSource, aC as SkillsResolver, aD as SkillsResolverContext, aE as SystemPromptContext, aF as SystemPromptMemoryFact, aG as SystemPromptSkillRef, aH as TelemetrySettings, aI as createSkill, aJ as definePlugin } from './cron-yJoNUZxe.cjs';
-import { R as RunResult, M as ModelSelection, C as CustomTool, a as McpServerConfig, b as Run, P as Processor, T as ToolResultContentBlock, S as SDKMessage, c as MessageOrigin } from './run-q_P0vHlY.cjs';
-export { A as AgentConversationTurn, d as AssistantMessage, e as CompletionCheck, f as CompletionCheckResult, g as ConversationStep, h as ConversationTurn, i as CostBreakdown, j as CostSource, k as CostStatus, D as DoomLoopThresholds, G as GenerateOptions, l as GenerateRunResult, I as ImageBlock, m as InputProcessorContext, n as InteractionUpdate, o as McpAuthConfig, p as McpHttpServerConfig, q as McpOAuthConfig, r as McpStdioServerConfig, s as ModelParameterValue, O as OutputProcessorContext, t as PartialToolCallUpdate, u as ProcessorControls, v as ProcessorTripwire, w as ProcessorViolation, x as RunCompactBoundaryEvent, y as RunCompletionCheckEvent, z as RunErrorDetail, B as RunEvent, E as RunEventSink, F as RunGitInfo, H as RunOperation, J as RunPermissionDeniedEvent, K as RunRateLimitEvent, L as RunStatus, N as RunTaskCompletedEvent, Q as RunTaskStartedEvent, U as RunTaskUpdatedEvent, V as RunToCompletionOptions, W as RunToCompletionResult, X as RunToolProgressEvent, Y as RunTripwireEvent, Z as SDKAssistantMessage, _ as SDKImage, $ as SDKImageDimension, a0 as SDKObjectDelta, a1 as SDKRequestMessage, a2 as SDKStatusMessage, a3 as SDKSystemMessage, a4 as SDKTaskMessage, a5 as SDKThinkingMessage, a6 as SDKToolUseMessage, a7 as SDKUserMessage, a8 as SDKUserMessageEvent, a9 as SendOptions, aa as ShellCommand, ab as ShellConversationTurn, ac as ShellOutput, ad as ShellOutputDeltaUpdate, ae as StepCompletedUpdate, af as StepStartedUpdate, ag as StreamToCompletionResult, ah as SummaryCompletedUpdate, ai as SummaryStartedUpdate, aj as SummaryUpdate, ak as TextBlock, al as TextDeltaUpdate, am as ThinkingCompletedUpdate, an as ThinkingDeltaUpdate, ao as ThinkingMessage, ap as TokenDeltaUpdate, aq as TokenUsage, ar as ToolCall, as as ToolCallCompletedUpdate, at as ToolCallStartedUpdate, au as ToolContextMessage, av as ToolResult, aw as ToolResultGuardOptions, ax as ToolUseBlock, ay as TurnEndedUpdate, az as UserMessage, aA as UserMessageAppendedUpdate, aB as emitRunEvent } from './run-q_P0vHlY.cjs';
+import { T as TheokitAgentError, B as BudgetOptions, a as BudgetHandle, b as BudgetSnapshot, E as ErrorMetadata } from './errors-DZpCGlYv.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, m as ErrorCode, I as IntegrationNotConnectedError, n as InvalidTaskIdError, M as MemoryAdapterError, o as MemoryAdapterErrorCode, N as NetworkError, R as RateLimitError, p as TaskNotFoundError, U as UnknownAgentError, q as UnsupportedBudgetOperationError, r as UnsupportedRunOperationError, s as UnsupportedTaskOperationError, t as isTransientError } from './errors-DZpCGlYv.cjs';
+import { A as AgentOptions, L as LocalOptions, P as ProviderRoutingSettings, S as SystemPromptResolver, C as CloudOptions, M as MemorySettings, a as AgentDefinition, b as ContextSettings, c as PluginsSettings, d as SkillsSettings, e as SDKAgent, f as ListAgentsOptions, g as ListResult, h as SDKAgentInfo, G as GetAgentOptions, i as ListRunsOptions, j as GetRunOptions, k as AgentOperationOptions, l as ProviderProfile, m as Plugin, I as InlineSkill, n as ConversationStorageAdapter, o as StoredMessage, p as SessionMeta, q as SessionMetaPatch, O as ObjectiveRecord, B as BudgetTracker, r as MemoryProvider, s as MemoryId, t as PreToolCallDecision, u as StepResult, v as SDKProvider } from './cron-t4oKI2Is.cjs';
+export { w as ActiveMemoryPassArgs, x as ActiveMemoryPassResult, y as AgentGoalConfig, z as AgentMemory, D as BudgetCheck, E as BudgetTotal, F as BudgetUsageEvent, H as CloudEnv, J as CloudRepo, K as ContextBudget, N as ContextManagerKind, Q as ContextSnapshot, R as ContextSource, T as ContextSourceStatus, U as CreateSkillSpec, V as Cron, W as CronCreateOptions, X as CronGetOptions, Y as CronJob, Z as CronJobStatus, _ as CronListOptions, $ as CronOperationOptions, a0 as CronRunOptions, a1 as CronRuntime, a2 as CronSchedulerStatus, a3 as CronStartOptions, a4 as DurableGoalOptions, a5 as GoalEvent, a6 as GoalOptions, a7 as GoalResult, a8 as HookName, a9 as InvalidateCacheOptions, aa as MemoryAdapter, ab as MemoryAdapterCapabilities, ac as MemoryContext, ad as MemoryFact, ae as MemoryProviderHandle, af as MemoryProviderInitOptions, ag as MemoryRevision, ah as MemoryToolSchema, ai as MemoryTurnMessage, aj as ObjectiveStatus, ak as PersonalityPreset, al as PluginContext, am as PostAssistantReplyContext, an as PreToolCallContext, ao as PreUserSendContext, ap as PreUserSendResult, aq as ProviderCapability, ar as ProviderRoute, as as RecordSessionSummaryArgs, at as ResolvedProviderRoute, au as RunUntilIterator, av as SDKAgentPlugins, aw as SDKAgentSkillDetail, ax as SDKAgentSkills, ay as SDKArtifact, az as SDKContextManager, aA as SDKPluginMetadata, aB as SDKProvidersManager, aC as SettingSource, aD as SkillsResolver, aE as SkillsResolverContext, aF as SystemPromptContext, aG as SystemPromptMemoryFact, aH as SystemPromptSkillRef, aI as TelemetrySettings, aJ as createSkill, aK as definePlugin } from './cron-t4oKI2Is.cjs';
+import { R as RunResult, M as ModelSelection, C as CustomTool, a as McpServerConfig, b as Run, P as Processor, T as ToolResultContentBlock, S as SDKMessage } from './run-CLXKMRgq.cjs';
+export { A as AgentConversationTurn, c as AssistantMessage, d as CompletionCheck, e as CompletionCheckResult, f as ConversationStep, g as ConversationTurn, h as CostBreakdown, i as CostSource, j as CostStatus, D as DoomLoopThresholds, G as GenerateOptions, k as GenerateRunResult, I as ImageBlock, l as InputProcessorContext, m as InteractionUpdate, n as McpAuthConfig, o as McpHttpServerConfig, p as McpOAuthConfig, q as McpStdioServerConfig, r as MessageOrigin, s as ModelParameterValue, O as OutputProcessorContext, t as PartialToolCallUpdate, u as ProcessorControls, v as ProcessorTripwire, w as ProcessorViolation, x as RunCompactBoundaryEvent, y as RunCompletionCheckEvent, z as RunErrorDetail, B as RunEvent, E as RunEventSink, F as RunGitInfo, H as RunOperation, J as RunPermissionDeniedEvent, K as RunRateLimitEvent, L as RunStatus, N as RunTaskCompletedEvent, Q as RunTaskStartedEvent, U as RunTaskUpdatedEvent, V as RunToCompletionOptions, W as RunToCompletionResult, X as RunToolProgressEvent, Y as RunTripwireEvent, Z as SDKAssistantMessage, _ as SDKImage, $ as SDKImageDimension, a0 as SDKObjectDelta, a1 as SDKRequestMessage, a2 as SDKStatusMessage, a3 as SDKSystemMessage, a4 as SDKTaskMessage, a5 as SDKThinkingMessage, a6 as SDKToolUseMessage, a7 as SDKUserMessage, a8 as SDKUserMessageEvent, a9 as SendOptions, aa as ShellCommand, ab as ShellConversationTurn, ac as ShellOutput, ad as ShellOutputDeltaUpdate, ae as StepCompletedUpdate, af as StepStartedUpdate, ag as StreamToCompletionResult, ah as SummaryCompletedUpdate, ai as SummaryStartedUpdate, aj as SummaryUpdate, ak as TextBlock, al as TextDeltaUpdate, am as ThinkingCompletedUpdate, an as ThinkingDeltaUpdate, ao as ThinkingMessage, ap as TokenDeltaUpdate, aq as TokenUsage, ar as ToolCall, as as ToolCallCompletedUpdate, at as ToolCallStartedUpdate, au as ToolContextMessage, av as ToolResult, aw as ToolResultGuardOptions, ax as ToolUseBlock, ay as TurnEndedUpdate, az as UserMessage, aA as UserMessageAppendedUpdate, aB as emitRunEvent } from './run-CLXKMRgq.cjs';
 import * as zod from 'zod';
 import { ZodType, z } from 'zod';
 
@@ -1903,134 +1903,6 @@ declare function scopedConversationId(scope: SessionScope, id: string): string;
 /** M3 #62 — the id prefix (`"<scope>__"`) used to match a scope's conversations. */
 declare function sessionScopePrefix(scope: SessionScope): string;
 
-/**
- * Public type contract for `Workflow.create / .run / .resume` (Adoption
- * Roadmap #5; ADRs D230-D248).
- *
- * Step types form a discriminated union by `kind`. Helper factory functions
- * (`fn()`, `agentStep()`) live in `workflow.ts` and hide the discriminator
- * from end users.
- *
- * @public
- */
-
-type Step = FnStep | AgentStep | ParallelStep | BranchStep | ForeachStep | DowhileStep | SleepStep | SuspendStep;
-/** A pure function step. */
-interface FnStep {
-    readonly kind: "fn";
-    readonly id: string;
-    readonly fn: (input: unknown, ctx: StepContext) => Promise<unknown> | unknown;
-    readonly inputSchema?: ZodType;
-    readonly outputSchema?: ZodType;
-    readonly retry?: RetryPolicy;
-    /** D238 — slot reserved; runtime throws if engine not yet implemented. */
-    readonly compensate?: (input: unknown, output: unknown, error: Error) => Promise<void> | void;
-}
-/** An agent.send-driven step. */
-interface AgentStep {
-    readonly kind: "agent";
-    readonly id: string;
-    readonly agent: SDKAgent;
-    readonly promptTemplate: string | ((input: unknown) => string);
-    readonly retry?: RetryPolicy;
-    /**
-     * SE3 — provenance stamped onto this step's `agent.send()` (forwarded to
-     * `RunResult.origin`). Squad sets `{ kind: "peer", from: "agent-<i-1>" }` on
-     * every step after the first so a peer-driven turn is attributable.
-     */
-    readonly origin?: MessageOrigin;
-}
-/** N concurrent branches, each its own mini-step-list. */
-interface ParallelStep {
-    readonly kind: "parallel";
-    readonly id: string;
-    readonly branches: ReadonlyArray<ReadonlyArray<Step>>;
-    readonly concurrency?: number;
-    readonly errorPolicy?: "fail-fast" | "collect";
-}
-/** First-match-wins predicates + optional fallback. */
-interface BranchStep {
-    readonly kind: "branch";
-    readonly id: string;
-    readonly predicates: ReadonlyArray<readonly [(input: unknown) => boolean | Promise<boolean>, ReadonlyArray<Step>]>;
-    readonly fallback?: ReadonlyArray<Step>;
-}
-/** Map a step over an upstream array output. */
-interface ForeachStep {
-    readonly kind: "foreach";
-    readonly id: string;
-    /** ID of an upstream top-level step whose output is iterable. */
-    readonly iterableFrom: string;
-    readonly step: Step;
-    readonly concurrency?: number;
-}
-/** Loop a step until condFn returns false. */
-interface DowhileStep {
-    readonly kind: "dowhile";
-    readonly id: string;
-    readonly step: Step;
-    readonly condFn: (output: unknown, iteration: number) => boolean | Promise<boolean>;
-    readonly maxIterations?: number;
-}
-/** Pause for a fixed duration. */
-interface SleepStep {
-    readonly kind: "sleep";
-    readonly id: string;
-    readonly durationMs: number;
-}
-/** Standalone explicit suspend point. */
-interface SuspendStep {
-    readonly kind: "suspend";
-    readonly id: string;
-    readonly payloadSchema?: ZodType;
-}
-/** D237 — retry policy applied per fn/agent step. */
-interface RetryPolicy {
-    /** Total attempts (MIN 1, MAX 20). `1` = no retry. */
-    readonly maxAttempts: number;
-    readonly initialBackoffMs?: number;
-    readonly backoffCoefficient?: number;
-    readonly maximumBackoffMs?: number;
-    readonly nonRetryableErrors?: ReadonlyArray<string>;
-}
-/** D247 — context handed to every step.fn. */
-interface StepContext {
-    readonly runId: string;
-    readonly signal: AbortSignal;
-    readonly log: {
-        debug: (msg: string, attrs?: Record<string, unknown>) => void;
-        info: (msg: string, attrs?: Record<string, unknown>) => void;
-        warn: (msg: string, attrs?: Record<string, unknown>) => void;
-    };
-    /** Pause the workflow; resume via `Workflow.resume({...})`. */
-    readonly suspend: (payload?: unknown) => Promise<never>;
-    /**
-     * SE29 — the workflow's shared state (from `WorkflowOptions.initialState`,
-     * mutated by {@link setState}), visible to every subsequent step in the run.
-     * `undefined` when no `initialState`/`setState` has run. Persisted across
-     * suspend/resume.
-     */
-    readonly state: unknown;
-    /**
-     * SE29 — update the shared state for subsequent steps. Validated against
-     * `WorkflowOptions.stateSchema` when set (a mismatch throws
-     * {@link WorkflowStateError}, which fails the step/run — Rule 8).
-     */
-    readonly setState: (next: unknown) => void;
-}
-interface StepResult {
-    readonly stepId: string;
-    readonly kind: Step["kind"];
-    readonly status: "completed" | "failed" | "skipped" | "suspended";
-    readonly attempts: number;
-    readonly durationMs: number;
-    readonly output?: unknown;
-    readonly error?: {
-        name: string;
-        message: string;
-    };
-}
-
 /**
  * `createSquad` — a sequential team of agents.
  *
@@ -2588,4 +2460,4 @@ declare function toShareGptTrajectory(result: BatchResult, options?: {
     model?: string;
 }): ShareGptTrajectory | null;
 
-export { Agent, AgentBuilder, AgentDefinition, type AgentFactory, AgentOperationOptions, AgentOptions, type AgentPromptResult, type AgentRegistryOptions, type BatchItem, type BatchOptions, type BatchProgress, type BatchResult, Budget, BudgetHandle, BudgetOptions, BudgetSnapshot, BudgetTracker, CloudOptions, ContextSettings, ConversationStorageAdapter, type CounterBudgetTrackerOptions, CustomTool, type DeepPartial, type DefineProviderOptions, type DefineToolSpec, type DreamingSweepOptions, type DreamingSweepResult, ErrorMetadata, EventBus, type EvictReason, FileSystemConversationStorage, GenerateObjectError, type GenerateObjectOptions, type GenerateObjectResult, GetAgentOptions, GetRunOptions, InMemoryConversationStorage, InlineSkill, JobQueue, type JobQueueOptions, ListAgentsOptions, ListResult, ListRunsOptions, LiveAgentRegistry, LocalOptions, McpServerConfig, Memory, MemoryId, MemoryProvider, MemorySettings, MessageOrigin, type MigrateOptions, type MigrateResult, type ModelListItem, type ModelParameterDefinition, ModelSelection, type ModelVariant, type NormalizedJsonSchema, ObjectiveRecord, type PermissionAction, PermissionEngine, type PermissionEngineOptions, type PermissionGate, type PermissionGateContext, type PermissionGateDecision, type PermissionMode, type PermissionPluginOptions, type PermissionRule, Plugin, PluginsSettings, PreToolCallDecision, Processor, ProviderProfile, ProviderRoutingSettings, type ReplayHistoryOptions, Run, RunResult, SDKAgent, SDKAgentInfo, SDKMessage, type SDKModel, SDKProvider, type SDKRepository, type SDKUser, Security, type SessionCapabilityResult, type SessionListOptions, type SessionManager, SessionMeta, SessionMetaPatch, type SessionScope, type SessionSummary, type ShareGptMessage, type ShareGptTrajectory, SkillsSettings, type Squad, type SquadOptions, type SquadRun, StoredMessage, 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, Theokit, TheokitAgentError, type TheokitRequestOptions, type TokenLimiterOptions, ToolError, ToolResultContentBlock, type UnicodeNormalizerOptions, UsageAccumulator, applyMode, buildReplayHistory, chargeAndCheckThresholds, computeCost, createAgentFactory, createCounterBudgetTracker, createNoopMemoryProvider, createPermissionPlugin, createSessionManager, createSquad, createTokenLimiter, createUnicodeNormalizer, defineProvider, defineSkillReadTool, defineTool, estimateTokens, extractRawId, getPricingEntry, inferApiMode, isValidTaskId, migrateSqliteToLance, mkMemoryId, normalizeSchema, normalizeUsage, preflightCheck, scopedConversationId, sessionScopePrefix, toShareGptTrajectory, withCwdMutex };
+export { Agent, AgentBuilder, AgentDefinition, type AgentFactory, AgentOperationOptions, AgentOptions, type AgentPromptResult, type AgentRegistryOptions, type BatchItem, type BatchOptions, type BatchProgress, type BatchResult, Budget, BudgetHandle, BudgetOptions, BudgetSnapshot, BudgetTracker, CloudOptions, ContextSettings, ConversationStorageAdapter, type CounterBudgetTrackerOptions, CustomTool, type DeepPartial, type DefineProviderOptions, type DefineToolSpec, type DreamingSweepOptions, type DreamingSweepResult, ErrorMetadata, EventBus, type EvictReason, FileSystemConversationStorage, GenerateObjectError, type GenerateObjectOptions, type GenerateObjectResult, GetAgentOptions, GetRunOptions, InMemoryConversationStorage, InlineSkill, JobQueue, type JobQueueOptions, ListAgentsOptions, ListResult, ListRunsOptions, LiveAgentRegistry, LocalOptions, McpServerConfig, Memory, MemoryId, MemoryProvider, MemorySettings, type MigrateOptions, type MigrateResult, type ModelListItem, type ModelParameterDefinition, ModelSelection, type ModelVariant, type NormalizedJsonSchema, ObjectiveRecord, type PermissionAction, PermissionEngine, type PermissionEngineOptions, type PermissionGate, type PermissionGateContext, type PermissionGateDecision, type PermissionMode, type PermissionPluginOptions, type PermissionRule, Plugin, PluginsSettings, PreToolCallDecision, Processor, ProviderProfile, ProviderRoutingSettings, type ReplayHistoryOptions, Run, RunResult, SDKAgent, SDKAgentInfo, SDKMessage, type SDKModel, SDKProvider, type SDKRepository, type SDKUser, Security, type SessionCapabilityResult, type SessionListOptions, type SessionManager, SessionMeta, SessionMetaPatch, type SessionScope, type SessionSummary, type ShareGptMessage, type ShareGptTrajectory, SkillsSettings, type Squad, type SquadOptions, type SquadRun, StoredMessage, 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, Theokit, TheokitAgentError, type TheokitRequestOptions, type TokenLimiterOptions, ToolError, ToolResultContentBlock, type UnicodeNormalizerOptions, UsageAccumulator, applyMode, buildReplayHistory, chargeAndCheckThresholds, computeCost, createAgentFactory, createCounterBudgetTracker, createNoopMemoryProvider, createPermissionPlugin, createSessionManager, createSquad, createTokenLimiter, createUnicodeNormalizer, defineProvider, defineSkillReadTool, defineTool, estimateTokens, extractRawId, getPricingEntry, inferApiMode, isValidTaskId, migrateSqliteToLance, mkMemoryId, normalizeSchema, normalizeUsage, preflightCheck, scopedConversationId, sessionScopePrefix, toShareGptTrajectory, withCwdMutex };

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { T as TheokitAgentError, B as BudgetOptions, a as BudgetHandle, b as BudgetSnapshot, E as ErrorMetadata } from './errors-BxMIlgLP.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, m as ErrorCode, I as IntegrationNotConnectedError, n as InvalidTaskIdError, M as MemoryAdapterError, o as MemoryAdapterErrorCode, N as NetworkError, R as RateLimitError, p as TaskNotFoundError, U as UnknownAgentError, q as UnsupportedBudgetOperationError, r as UnsupportedRunOperationError, s as UnsupportedTaskOperationError, t as isTransientError } from './errors-BxMIlgLP.js';
-import { A as AgentOptions, L as LocalOptions, P as ProviderRoutingSettings, S as SystemPromptResolver, C as CloudOptions, M as MemorySettings, a as AgentDefinition, b as ContextSettings, c as PluginsSettings, d as SkillsSettings, e as SDKAgent, f as ListAgentsOptions, g as ListResult, h as SDKAgentInfo, G as GetAgentOptions, i as ListRunsOptions, j as GetRunOptions, k as AgentOperationOptions, l as ProviderProfile, m as Plugin, I as InlineSkill, n as ConversationStorageAdapter, o as StoredMessage, p as SessionMeta, q as SessionMetaPatch, O as ObjectiveRecord, B as BudgetTracker, r as MemoryProvider, s as MemoryId, t as PreToolCallDecision, u as SDKProvider } from './cron-COSAehOL.js';
-export { v as ActiveMemoryPassArgs, w as ActiveMemoryPassResult, x as AgentGoalConfig, y as AgentMemory, z as BudgetCheck, D as BudgetTotal, E as BudgetUsageEvent, F as CloudEnv, H as CloudRepo, J as ContextBudget, K as ContextManagerKind, N as ContextSnapshot, Q as ContextSource, R as ContextSourceStatus, T as CreateSkillSpec, U as Cron, V as CronCreateOptions, W as CronGetOptions, X as CronJob, Y as CronJobStatus, Z as CronListOptions, _ as CronOperationOptions, $ as CronRunOptions, a0 as CronRuntime, a1 as CronSchedulerStatus, a2 as CronStartOptions, a3 as DurableGoalOptions, a4 as GoalEvent, a5 as GoalOptions, a6 as GoalResult, a7 as HookName, a8 as InvalidateCacheOptions, a9 as MemoryAdapter, aa as MemoryAdapterCapabilities, ab as MemoryContext, ac as MemoryFact, ad as MemoryProviderHandle, ae as MemoryProviderInitOptions, af as MemoryRevision, ag as MemoryToolSchema, ah as MemoryTurnMessage, ai as ObjectiveStatus, aj as PersonalityPreset, ak as PluginContext, al as PostAssistantReplyContext, am as PreToolCallContext, an as PreUserSendContext, ao as PreUserSendResult, ap as ProviderCapability, aq as ProviderRoute, ar as RecordSessionSummaryArgs, as as ResolvedProviderRoute, at as RunUntilIterator, au as SDKAgentPlugins, av as SDKAgentSkillDetail, aw as SDKAgentSkills, ax as SDKArtifact, ay as SDKContextManager, az as SDKPluginMetadata, aA as SDKProvidersManager, aB as SettingSource, aC as SkillsResolver, aD as SkillsResolverContext, aE as SystemPromptContext, aF as SystemPromptMemoryFact, aG as SystemPromptSkillRef, aH as TelemetrySettings, aI as createSkill, aJ as definePlugin } from './cron-COSAehOL.js';
-import { R as RunResult, M as ModelSelection, C as CustomTool, a as McpServerConfig, b as Run, P as Processor, T as ToolResultContentBlock, S as SDKMessage, c as MessageOrigin } from './run-q_P0vHlY.js';
-export { A as AgentConversationTurn, d as AssistantMessage, e as CompletionCheck, f as CompletionCheckResult, g as ConversationStep, h as ConversationTurn, i as CostBreakdown, j as CostSource, k as CostStatus, D as DoomLoopThresholds, G as GenerateOptions, l as GenerateRunResult, I as ImageBlock, m as InputProcessorContext, n as InteractionUpdate, o as McpAuthConfig, p as McpHttpServerConfig, q as McpOAuthConfig, r as McpStdioServerConfig, s as ModelParameterValue, O as OutputProcessorContext, t as PartialToolCallUpdate, u as ProcessorControls, v as ProcessorTripwire, w as ProcessorViolation, x as RunCompactBoundaryEvent, y as RunCompletionCheckEvent, z as RunErrorDetail, B as RunEvent, E as RunEventSink, F as RunGitInfo, H as RunOperation, J as RunPermissionDeniedEvent, K as RunRateLimitEvent, L as RunStatus, N as RunTaskCompletedEvent, Q as RunTaskStartedEvent, U as RunTaskUpdatedEvent, V as RunToCompletionOptions, W as RunToCompletionResult, X as RunToolProgressEvent, Y as RunTripwireEvent, Z as SDKAssistantMessage, _ as SDKImage, $ as SDKImageDimension, a0 as SDKObjectDelta, a1 as SDKRequestMessage, a2 as SDKStatusMessage, a3 as SDKSystemMessage, a4 as SDKTaskMessage, a5 as SDKThinkingMessage, a6 as SDKToolUseMessage, a7 as SDKUserMessage, a8 as SDKUserMessageEvent, a9 as SendOptions, aa as ShellCommand, ab as ShellConversationTurn, ac as ShellOutput, ad as ShellOutputDeltaUpdate, ae as StepCompletedUpdate, af as StepStartedUpdate, ag as StreamToCompletionResult, ah as SummaryCompletedUpdate, ai as SummaryStartedUpdate, aj as SummaryUpdate, ak as TextBlock, al as TextDeltaUpdate, am as ThinkingCompletedUpdate, an as ThinkingDeltaUpdate, ao as ThinkingMessage, ap as TokenDeltaUpdate, aq as TokenUsage, ar as ToolCall, as as ToolCallCompletedUpdate, at as ToolCallStartedUpdate, au as ToolContextMessage, av as ToolResult, aw as ToolResultGuardOptions, ax as ToolUseBlock, ay as TurnEndedUpdate, az as UserMessage, aA as UserMessageAppendedUpdate, aB as emitRunEvent } from './run-q_P0vHlY.js';
+import { T as TheokitAgentError, B as BudgetOptions, a as BudgetHandle, b as BudgetSnapshot, E as ErrorMetadata } from './errors-D_Bfo30u.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, m as ErrorCode, I as IntegrationNotConnectedError, n as InvalidTaskIdError, M as MemoryAdapterError, o as MemoryAdapterErrorCode, N as NetworkError, R as RateLimitError, p as TaskNotFoundError, U as UnknownAgentError, q as UnsupportedBudgetOperationError, r as UnsupportedRunOperationError, s as UnsupportedTaskOperationError, t as isTransientError } from './errors-D_Bfo30u.js';
+import { A as AgentOptions, L as LocalOptions, P as ProviderRoutingSettings, S as SystemPromptResolver, C as CloudOptions, M as MemorySettings, a as AgentDefinition, b as ContextSettings, c as PluginsSettings, d as SkillsSettings, e as SDKAgent, f as ListAgentsOptions, g as ListResult, h as SDKAgentInfo, G as GetAgentOptions, i as ListRunsOptions, j as GetRunOptions, k as AgentOperationOptions, l as ProviderProfile, m as Plugin, I as InlineSkill, n as ConversationStorageAdapter, o as StoredMessage, p as SessionMeta, q as SessionMetaPatch, O as ObjectiveRecord, B as BudgetTracker, r as MemoryProvider, s as MemoryId, t as PreToolCallDecision, u as StepResult, v as SDKProvider } from './cron-BNHJywtl.js';
+export { w as ActiveMemoryPassArgs, x as ActiveMemoryPassResult, y as AgentGoalConfig, z as AgentMemory, D as BudgetCheck, E as BudgetTotal, F as BudgetUsageEvent, H as CloudEnv, J as CloudRepo, K as ContextBudget, N as ContextManagerKind, Q as ContextSnapshot, R as ContextSource, T as ContextSourceStatus, U as CreateSkillSpec, V as Cron, W as CronCreateOptions, X as CronGetOptions, Y as CronJob, Z as CronJobStatus, _ as CronListOptions, $ as CronOperationOptions, a0 as CronRunOptions, a1 as CronRuntime, a2 as CronSchedulerStatus, a3 as CronStartOptions, a4 as DurableGoalOptions, a5 as GoalEvent, a6 as GoalOptions, a7 as GoalResult, a8 as HookName, a9 as InvalidateCacheOptions, aa as MemoryAdapter, ab as MemoryAdapterCapabilities, ac as MemoryContext, ad as MemoryFact, ae as MemoryProviderHandle, af as MemoryProviderInitOptions, ag as MemoryRevision, ah as MemoryToolSchema, ai as MemoryTurnMessage, aj as ObjectiveStatus, ak as PersonalityPreset, al as PluginContext, am as PostAssistantReplyContext, an as PreToolCallContext, ao as PreUserSendContext, ap as PreUserSendResult, aq as ProviderCapability, ar as ProviderRoute, as as RecordSessionSummaryArgs, at as ResolvedProviderRoute, au as RunUntilIterator, av as SDKAgentPlugins, aw as SDKAgentSkillDetail, ax as SDKAgentSkills, ay as SDKArtifact, az as SDKContextManager, aA as SDKPluginMetadata, aB as SDKProvidersManager, aC as SettingSource, aD as SkillsResolver, aE as SkillsResolverContext, aF as SystemPromptContext, aG as SystemPromptMemoryFact, aH as SystemPromptSkillRef, aI as TelemetrySettings, aJ as createSkill, aK as definePlugin } from './cron-BNHJywtl.js';
+import { R as RunResult, M as ModelSelection, C as CustomTool, a as McpServerConfig, b as Run, P as Processor, T as ToolResultContentBlock, S as SDKMessage } from './run-CLXKMRgq.js';
+export { A as AgentConversationTurn, c as AssistantMessage, d as CompletionCheck, e as CompletionCheckResult, f as ConversationStep, g as ConversationTurn, h as CostBreakdown, i as CostSource, j as CostStatus, D as DoomLoopThresholds, G as GenerateOptions, k as GenerateRunResult, I as ImageBlock, l as InputProcessorContext, m as InteractionUpdate, n as McpAuthConfig, o as McpHttpServerConfig, p as McpOAuthConfig, q as McpStdioServerConfig, r as MessageOrigin, s as ModelParameterValue, O as OutputProcessorContext, t as PartialToolCallUpdate, u as ProcessorControls, v as ProcessorTripwire, w as ProcessorViolation, x as RunCompactBoundaryEvent, y as RunCompletionCheckEvent, z as RunErrorDetail, B as RunEvent, E as RunEventSink, F as RunGitInfo, H as RunOperation, J as RunPermissionDeniedEvent, K as RunRateLimitEvent, L as RunStatus, N as RunTaskCompletedEvent, Q as RunTaskStartedEvent, U as RunTaskUpdatedEvent, V as RunToCompletionOptions, W as RunToCompletionResult, X as RunToolProgressEvent, Y as RunTripwireEvent, Z as SDKAssistantMessage, _ as SDKImage, $ as SDKImageDimension, a0 as SDKObjectDelta, a1 as SDKRequestMessage, a2 as SDKStatusMessage, a3 as SDKSystemMessage, a4 as SDKTaskMessage, a5 as SDKThinkingMessage, a6 as SDKToolUseMessage, a7 as SDKUserMessage, a8 as SDKUserMessageEvent, a9 as SendOptions, aa as ShellCommand, ab as ShellConversationTurn, ac as ShellOutput, ad as ShellOutputDeltaUpdate, ae as StepCompletedUpdate, af as StepStartedUpdate, ag as StreamToCompletionResult, ah as SummaryCompletedUpdate, ai as SummaryStartedUpdate, aj as SummaryUpdate, ak as TextBlock, al as TextDeltaUpdate, am as ThinkingCompletedUpdate, an as ThinkingDeltaUpdate, ao as ThinkingMessage, ap as TokenDeltaUpdate, aq as TokenUsage, ar as ToolCall, as as ToolCallCompletedUpdate, at as ToolCallStartedUpdate, au as ToolContextMessage, av as ToolResult, aw as ToolResultGuardOptions, ax as ToolUseBlock, ay as TurnEndedUpdate, az as UserMessage, aA as UserMessageAppendedUpdate, aB as emitRunEvent } from './run-CLXKMRgq.js';
 import * as zod from 'zod';
 import { ZodType, z } from 'zod';
 
@@ -1903,134 +1903,6 @@ declare function scopedConversationId(scope: SessionScope, id: string): string;
 /** M3 #62 — the id prefix (`"<scope>__"`) used to match a scope's conversations. */
 declare function sessionScopePrefix(scope: SessionScope): string;
 
-/**
- * Public type contract for `Workflow.create / .run / .resume` (Adoption
- * Roadmap #5; ADRs D230-D248).
- *
- * Step types form a discriminated union by `kind`. Helper factory functions
- * (`fn()`, `agentStep()`) live in `workflow.ts` and hide the discriminator
- * from end users.
- *
- * @public
- */
-
-type Step = FnStep | AgentStep | ParallelStep | BranchStep | ForeachStep | DowhileStep | SleepStep | SuspendStep;
-/** A pure function step. */
-interface FnStep {
-    readonly kind: "fn";
-    readonly id: string;
-    readonly fn: (input: unknown, ctx: StepContext) => Promise<unknown> | unknown;
-    readonly inputSchema?: ZodType;
-    readonly outputSchema?: ZodType;
-    readonly retry?: RetryPolicy;
-    /** D238 — slot reserved; runtime throws if engine not yet implemented. */
-    readonly compensate?: (input: unknown, output: unknown, error: Error) => Promise<void> | void;
-}
-/** An agent.send-driven step. */
-interface AgentStep {
-    readonly kind: "agent";
-    readonly id: string;
-    readonly agent: SDKAgent;
-    readonly promptTemplate: string | ((input: unknown) => string);
-    readonly retry?: RetryPolicy;
-    /**
-     * SE3 — provenance stamped onto this step's `agent.send()` (forwarded to
-     * `RunResult.origin`). Squad sets `{ kind: "peer", from: "agent-<i-1>" }` on
-     * every step after the first so a peer-driven turn is attributable.
-     */
-    readonly origin?: MessageOrigin;
-}
-/** N concurrent branches, each its own mini-step-list. */
-interface ParallelStep {
-    readonly kind: "parallel";
-    readonly id: string;
-    readonly branches: ReadonlyArray<ReadonlyArray<Step>>;
-    readonly concurrency?: number;
-    readonly errorPolicy?: "fail-fast" | "collect";
-}
-/** First-match-wins predicates + optional fallback. */
-interface BranchStep {
-    readonly kind: "branch";
-    readonly id: string;
-    readonly predicates: ReadonlyArray<readonly [(input: unknown) => boolean | Promise<boolean>, ReadonlyArray<Step>]>;
-    readonly fallback?: ReadonlyArray<Step>;
-}
-/** Map a step over an upstream array output. */
-interface ForeachStep {
-    readonly kind: "foreach";
-    readonly id: string;
-    /** ID of an upstream top-level step whose output is iterable. */
-    readonly iterableFrom: string;
-    readonly step: Step;
-    readonly concurrency?: number;
-}
-/** Loop a step until condFn returns false. */
-interface DowhileStep {
-    readonly kind: "dowhile";
-    readonly id: string;
-    readonly step: Step;
-    readonly condFn: (output: unknown, iteration: number) => boolean | Promise<boolean>;
-    readonly maxIterations?: number;
-}
-/** Pause for a fixed duration. */
-interface SleepStep {
-    readonly kind: "sleep";
-    readonly id: string;
-    readonly durationMs: number;
-}
-/** Standalone explicit suspend point. */
-interface SuspendStep {
-    readonly kind: "suspend";
-    readonly id: string;
-    readonly payloadSchema?: ZodType;
-}
-/** D237 — retry policy applied per fn/agent step. */
-interface RetryPolicy {
-    /** Total attempts (MIN 1, MAX 20). `1` = no retry. */
-    readonly maxAttempts: number;
-    readonly initialBackoffMs?: number;
-    readonly backoffCoefficient?: number;
-    readonly maximumBackoffMs?: number;
-    readonly nonRetryableErrors?: ReadonlyArray<string>;
-}
-/** D247 — context handed to every step.fn. */
-interface StepContext {
-    readonly runId: string;
-    readonly signal: AbortSignal;
-    readonly log: {
-        debug: (msg: string, attrs?: Record<string, unknown>) => void;
-        info: (msg: string, attrs?: Record<string, unknown>) => void;
-        warn: (msg: string, attrs?: Record<string, unknown>) => void;
-    };
-    /** Pause the workflow; resume via `Workflow.resume({...})`. */
-    readonly suspend: (payload?: unknown) => Promise<never>;
-    /**
-     * SE29 — the workflow's shared state (from `WorkflowOptions.initialState`,
-     * mutated by {@link setState}), visible to every subsequent step in the run.
-     * `undefined` when no `initialState`/`setState` has run. Persisted across
-     * suspend/resume.
-     */
-    readonly state: unknown;
-    /**
-     * SE29 — update the shared state for subsequent steps. Validated against
-     * `WorkflowOptions.stateSchema` when set (a mismatch throws
-     * {@link WorkflowStateError}, which fails the step/run — Rule 8).
-     */
-    readonly setState: (next: unknown) => void;
-}
-interface StepResult {
-    readonly stepId: string;
-    readonly kind: Step["kind"];
-    readonly status: "completed" | "failed" | "skipped" | "suspended";
-    readonly attempts: number;
-    readonly durationMs: number;
-    readonly output?: unknown;
-    readonly error?: {
-        name: string;
-        message: string;
-    };
-}
-
 /**
  * `createSquad` — a sequential team of agents.
  *
@@ -2588,4 +2460,4 @@ declare function toShareGptTrajectory(result: BatchResult, options?: {
     model?: string;
 }): ShareGptTrajectory | null;
 
-export { Agent, AgentBuilder, AgentDefinition, type AgentFactory, AgentOperationOptions, AgentOptions, type AgentPromptResult, type AgentRegistryOptions, type BatchItem, type BatchOptions, type BatchProgress, type BatchResult, Budget, BudgetHandle, BudgetOptions, BudgetSnapshot, BudgetTracker, CloudOptions, ContextSettings, ConversationStorageAdapter, type CounterBudgetTrackerOptions, CustomTool, type DeepPartial, type DefineProviderOptions, type DefineToolSpec, type DreamingSweepOptions, type DreamingSweepResult, ErrorMetadata, EventBus, type EvictReason, FileSystemConversationStorage, GenerateObjectError, type GenerateObjectOptions, type GenerateObjectResult, GetAgentOptions, GetRunOptions, InMemoryConversationStorage, InlineSkill, JobQueue, type JobQueueOptions, ListAgentsOptions, ListResult, ListRunsOptions, LiveAgentRegistry, LocalOptions, McpServerConfig, Memory, MemoryId, MemoryProvider, MemorySettings, MessageOrigin, type MigrateOptions, type MigrateResult, type ModelListItem, type ModelParameterDefinition, ModelSelection, type ModelVariant, type NormalizedJsonSchema, ObjectiveRecord, type PermissionAction, PermissionEngine, type PermissionEngineOptions, type PermissionGate, type PermissionGateContext, type PermissionGateDecision, type PermissionMode, type PermissionPluginOptions, type PermissionRule, Plugin, PluginsSettings, PreToolCallDecision, Processor, ProviderProfile, ProviderRoutingSettings, type ReplayHistoryOptions, Run, RunResult, SDKAgent, SDKAgentInfo, SDKMessage, type SDKModel, SDKProvider, type SDKRepository, type SDKUser, Security, type SessionCapabilityResult, type SessionListOptions, type SessionManager, SessionMeta, SessionMetaPatch, type SessionScope, type SessionSummary, type ShareGptMessage, type ShareGptTrajectory, SkillsSettings, type Squad, type SquadOptions, type SquadRun, StoredMessage, 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, Theokit, TheokitAgentError, type TheokitRequestOptions, type TokenLimiterOptions, ToolError, ToolResultContentBlock, type UnicodeNormalizerOptions, UsageAccumulator, applyMode, buildReplayHistory, chargeAndCheckThresholds, computeCost, createAgentFactory, createCounterBudgetTracker, createNoopMemoryProvider, createPermissionPlugin, createSessionManager, createSquad, createTokenLimiter, createUnicodeNormalizer, defineProvider, defineSkillReadTool, defineTool, estimateTokens, extractRawId, getPricingEntry, inferApiMode, isValidTaskId, migrateSqliteToLance, mkMemoryId, normalizeSchema, normalizeUsage, preflightCheck, scopedConversationId, sessionScopePrefix, toShareGptTrajectory, withCwdMutex };
+export { Agent, AgentBuilder, AgentDefinition, type AgentFactory, AgentOperationOptions, AgentOptions, type AgentPromptResult, type AgentRegistryOptions, type BatchItem, type BatchOptions, type BatchProgress, type BatchResult, Budget, BudgetHandle, BudgetOptions, BudgetSnapshot, BudgetTracker, CloudOptions, ContextSettings, ConversationStorageAdapter, type CounterBudgetTrackerOptions, CustomTool, type DeepPartial, type DefineProviderOptions, type DefineToolSpec, type DreamingSweepOptions, type DreamingSweepResult, ErrorMetadata, EventBus, type EvictReason, FileSystemConversationStorage, GenerateObjectError, type GenerateObjectOptions, type GenerateObjectResult, GetAgentOptions, GetRunOptions, InMemoryConversationStorage, InlineSkill, JobQueue, type JobQueueOptions, ListAgentsOptions, ListResult, ListRunsOptions, LiveAgentRegistry, LocalOptions, McpServerConfig, Memory, MemoryId, MemoryProvider, MemorySettings, type MigrateOptions, type MigrateResult, type ModelListItem, type ModelParameterDefinition, ModelSelection, type ModelVariant, type NormalizedJsonSchema, ObjectiveRecord, type PermissionAction, PermissionEngine, type PermissionEngineOptions, type PermissionGate, type PermissionGateContext, type PermissionGateDecision, type PermissionMode, type PermissionPluginOptions, type PermissionRule, Plugin, PluginsSettings, PreToolCallDecision, Processor, ProviderProfile, ProviderRoutingSettings, type ReplayHistoryOptions, Run, RunResult, SDKAgent, SDKAgentInfo, SDKMessage, type SDKModel, SDKProvider, type SDKRepository, type SDKUser, Security, type SessionCapabilityResult, type SessionListOptions, type SessionManager, SessionMeta, SessionMetaPatch, type SessionScope, type SessionSummary, type ShareGptMessage, type ShareGptTrajectory, SkillsSettings, type Squad, type SquadOptions, type SquadRun, StoredMessage, 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, Theokit, TheokitAgentError, type TheokitRequestOptions, type TokenLimiterOptions, ToolError, ToolResultContentBlock, type UnicodeNormalizerOptions, UsageAccumulator, applyMode, buildReplayHistory, chargeAndCheckThresholds, computeCost, createAgentFactory, createCounterBudgetTracker, createNoopMemoryProvider, createPermissionPlugin, createSessionManager, createSquad, createTokenLimiter, createUnicodeNormalizer, defineProvider, defineSkillReadTool, defineTool, estimateTokens, extractRawId, getPricingEntry, inferApiMode, isValidTaskId, migrateSqliteToLance, mkMemoryId, normalizeSchema, normalizeUsage, preflightCheck, scopedConversationId, sessionScopePrefix, toShareGptTrajectory, withCwdMutex };

package/dist/index.js

@@ -19889,15 +19889,31 @@ function createSkill(spec) {
 // src/cron.ts
 init_errors();
 
+// src/internal/cron/fire-handler.ts
+init_registry();
+
 // src/internal/cron/run-job.ts
 init_errors();
 init_agent_factory_registry();
 async function runCronJob(job) {
-  if (job.agent !== void 0) return runWithEphemeralAgent(job.agent, job.message);
-  if (job.agentId !== void 0) return runWithExistingAgent(job.agentId, job.message);
-  throw new ConfigurationError(`Cron job ${job.id} has neither agent nor agentId \u2014 cannot run.`, {
-    code: "cron_no_target"
-  });
+  if (job.workflow !== void 0) return job.workflow.run(job.inputData);
+  if (job.agent !== void 0) return runWithEphemeralAgent(job.agent, requireMessage(job));
+  if (job.agentId !== void 0) return runWithExistingAgent(job.agentId, requireMessage(job));
+  throw new ConfigurationError(
+    `Cron job ${job.id} has no target (agent, agentId, or workflow) \u2014 cannot run.`,
+    { code: "cron_no_target" }
+  );
+}
+function isAgentRun(outcome) {
+  return typeof outcome.wait === "function";
+}
+function requireMessage(job) {
+  if (job.message === void 0) {
+    throw new ConfigurationError(`Cron job ${job.id} is an agent target but has no message.`, {
+      code: "cron_missing_message"
+    });
+  }
+  return job.message;
 }
 async function runWithExistingAgent(agentId, message) {
   const info = await getAgentFacade().get(agentId).catch(() => void 0);
@@ -19915,6 +19931,37 @@ async function runWithEphemeralAgent(baseOptions, message) {
   return agent.send(message);
 }
 
+// src/internal/cron/fire-handler.ts
+async function fireCronJobAsTask(job) {
+  const fireTs = Date.now();
+  const taskId = `cron-${job.id}-${fireTs}`;
+  try {
+    await submit({
+      kind: "cron",
+      id: taskId,
+      allowReservedPrefix: true,
+      meta: { jobId: job.id, jobName: job.name, schedule: job.cron, firedAt: fireTs },
+      work: async (ctx) => {
+        const outcome = await runCronJob(job);
+        if (isAgentRun(outcome)) {
+          ctx.signal.addEventListener("abort", () => void outcome.cancel().catch(() => {
+          }), {
+            once: true
+          });
+          const result = await outcome.wait();
+          ctx.emit({ status: result.status, runId: outcome.id });
+          return { status: result.status, runId: outcome.id };
+        }
+        ctx.emit({ status: outcome.status, runId: outcome.id });
+        return { status: outcome.status, runId: outcome.id };
+      }
+    });
+  } catch {
+    const outcome = await runCronJob(job);
+    if (isAgentRun(outcome)) await outcome.wait();
+  }
+}
+
 // src/internal/cron/store.ts
 var jobs = /* @__PURE__ */ new Map();
 function listJobs() {
@@ -20105,7 +20152,6 @@ function estimateNextRunAt(_cron, _timezone) {
 }
 
 // src/cron.ts
-init_registry();
 var Cron = class {
   constructor() {
   }
@@ -20172,7 +20218,8 @@ var Cron = class {
     return updateJobStatus(jobId, false);
   }
   /**
-   * Manually trigger a cron job off-schedule. Returns the resulting `Run`.
+   * Manually trigger a cron job off-schedule. Returns the resulting `Run`
+   * (agent target) or `WorkflowRun` (workflow target — SE35).
    *
    * @public
    */
@@ -20189,30 +20236,7 @@ var Cron = class {
    * @public
    */
   static start(options = {}) {
-    setCronFireHandler(async (job) => {
-      const fireTs = Date.now();
-      const taskId = `cron-${job.id}-${fireTs}`;
-      try {
-        await submit({
-          kind: "cron",
-          id: taskId,
-          allowReservedPrefix: true,
-          meta: { jobId: job.id, jobName: job.name, schedule: job.cron, firedAt: fireTs },
-          work: async (ctx) => {
-            const run = await runCronJob(job);
-            ctx.signal.addEventListener("abort", () => void run.cancel().catch(() => {
-            }), {
-              once: true
-            });
-            const result = await run.wait();
-            ctx.emit({ status: result.status, runId: run.id });
-            return { status: result.status, runId: run.id };
-          }
-        });
-      } catch {
-        await runCronJob(job).then((run) => run.wait());
-      }
-    });
+    setCronFireHandler(fireCronJobAsTask);
     startScheduler(options.cwd);
     return Promise.resolve();
   }
@@ -20236,17 +20260,7 @@ var Cron = class {
   }
 };
 async function createCronJob(options) {
-  if (options.agent !== void 0 && options.agentId !== void 0) {
-    throw new ConfigurationError(
-      "agent and agentId are mutually exclusive \u2014 pass either agent (ephemeral) or agentId (reuse).",
-      { code: "cron_agent_exclusive" }
-    );
-  }
-  if (options.agent === void 0 && options.agentId === void 0) {
-    throw new ConfigurationError("Cron job requires either agent or agentId", {
-      code: "cron_missing_agent"
-    });
-  }
+  validateCronTarget(options);
   validateCronExpression(options.cron);
   const timezone = options.timezone ?? "UTC";
   validateTimezone(timezone);
@@ -20257,20 +20271,51 @@ async function createCronJob(options) {
     id: generateCronId(),
     cron: options.cron,
     timezone,
-    message: options.message,
     enabled: options.enabled ?? true,
     status: options.enabled === false ? "paused" : "scheduled",
     runtime,
     createdAt: now,
     nextRunAt: estimateNextRunAt(options.cron),
     ...options.name !== void 0 ? { name: options.name } : {},
+    ...options.message !== void 0 ? { message: options.message } : {},
     ...options.agent !== void 0 ? { agent: options.agent } : {},
-    ...options.agentId !== void 0 ? { agentId: options.agentId } : {}
+    ...options.agentId !== void 0 ? { agentId: options.agentId } : {},
+    ...options.workflow !== void 0 ? { workflow: options.workflow } : {},
+    ...options.inputData !== void 0 ? { inputData: options.inputData } : {}
   };
   upsertJob(job);
   return job;
 }
+function validateCronTarget(options) {
+  const targets = [options.agent, options.agentId, options.workflow].filter(
+    (t) => t !== void 0
+  ).length;
+  if (targets > 1) {
+    throw new ConfigurationError(
+      "agent, agentId, and workflow are mutually exclusive \u2014 pass exactly one target.",
+      { code: "cron_ambiguous_target" }
+    );
+  }
+  if (targets === 0) {
+    throw new ConfigurationError(
+      "Cron job requires exactly one target: agent, agentId, or workflow.",
+      { code: "cron_no_target" }
+    );
+  }
+  if (options.workflow !== void 0 && options.message !== void 0) {
+    throw new ConfigurationError(
+      "A workflow cron target takes inputData, not a message \u2014 remove `message`.",
+      { code: "cron_workflow_message" }
+    );
+  }
+  if (options.workflow === void 0 && options.message === void 0) {
+    throw new ConfigurationError("An agent cron target requires a message.", {
+      code: "cron_missing_message"
+    });
+  }
+}
 function detectRuntime(options) {
+  if (options.workflow !== void 0) return "local";
   if (options.agentId !== void 0) {
     return options.agentId.startsWith("bc-") ? "cloud" : "local";
   }