@theokit/sdk 2.29.0 → 3.0.0

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-BLRe166v.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 Skill, aE as SkillsResolver, aF as SkillsResolverContext, aG as SystemPromptContext, aH as SystemPromptMemoryFact, aI as SystemPromptSkillRef, aJ as TelemetrySettings } from './cron-BLRe166v.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';
 
@@ -601,26 +601,11 @@ interface AgentFactory {
      */
     getOrCreate(agentId: string, overrides?: Partial<AgentOptions>): Promise<SDKAgent>;
 }
-/**
- * Capture a common {@link AgentOptions} prefix and produce per-session agents
- * with focused overrides. Useful for chat-bot patterns where most config is
- * shared across users/sessions.
- *
- * Merge rules (ADR D23):
- * - Top-level shallow merge with `overrides` winning.
- * - Deep merge for `local`, `memory`, `cloud` (configuration objects with
- *   non-conflicting flat keys).
- * - Total replace for `mcpServers`, `agents`, `tools`, `providers`,
- *   `plugins`, `skills`, `context` (collection-shaped).
- * - The function-level `agentId` always wins over both `common.agentId` and
- *   `overrides.agentId`.
- *
- * The factory holds `common` by reference — mutating it after construction
- * leaks to subsequent `forSession` calls (documented caveat).
- *
- * @public
- */
-declare function createAgentFactory(common: Partial<AgentOptions>): AgentFactory;
+/** SE36 — `AgentFactory.create` replaces `createAgentFactory` (ADR 0015). Merges with the `AgentFactory` interface. @public */
+declare class AgentFactory {
+    private constructor();
+    static create(common: Partial<AgentOptions>): AgentFactory;
+}
 
 /**
  * computeCost — apply pricing entries to a TokenUsage and produce a
@@ -865,15 +850,6 @@ interface UnicodeNormalizerOptions {
     /** Collapse runs of intra-line whitespace to one space, 3+ blank lines to one, and trim. Default `false`. Uses legacy `\s`; Unicode-only whitespace (U+00A0 NBSP, U+FEFF BOM, U+2000–U+200A) is NOT collapsed. */
     collapseWhitespace?: boolean;
 }
-/**
- * SE25 — an input processor that normalizes user text: Unicode NFC (so
- * canonically-equivalent sequences compare equal) plus optional control-char
- * stripping and whitespace collapsing. Pure + deterministic; no LLM. Mirrors
- * Mastra's `UnicodeNormalizer`.
- *
- * @public
- */
-declare function createUnicodeNormalizer(opts?: UnicodeNormalizerOptions): Processor;
 /** Options for {@link createTokenLimiter}. @public */
 interface TokenLimiterOptions {
     /** Positive integer token budget (estimate — see {@link estimateTokens}). */
@@ -881,15 +857,16 @@ interface TokenLimiterOptions {
     /** Over the limit: `"truncate"` (default, cut to fit) or `"block"` (abort with a tripwire). */
     strategy?: "truncate" | "block";
 }
-/**
- * SE25 — a processor that caps text to a token budget. Placed in
- * `inputProcessors` it limits the prompt; in `outputProcessors` it limits the
- * response. Uses a char-based estimate (no tokenizer dep). `truncate` cuts to
- * fit; `block` aborts (tripwire). Mirrors Mastra's `TokenLimiterProcessor`.
- *
- * @public
- */
-declare function createTokenLimiter(opts: TokenLimiterOptions): Processor;
+/** SE36 — `TokenLimiter.create` replaces `createTokenLimiter` (ADR 0015). @public */
+declare class TokenLimiter {
+    private constructor();
+    static create(opts: TokenLimiterOptions): Processor;
+}
+/** SE36 — `UnicodeNormalizer.create` replaces `createUnicodeNormalizer` (ADR 0015). @public */
+declare class UnicodeNormalizer {
+    private constructor();
+    static create(opts?: UnicodeNormalizerOptions): Processor;
+}
 
 /**
  * Options for {@link defineProvider}.
@@ -900,38 +877,11 @@ interface DefineProviderOptions {
     /** Plugin version surfaced in diagnostics. Default `"1.0.0"`. */
     version?: string;
 }
-/**
- * Canonical factory for a custom LLM provider, mirroring {@link defineTool} and
- * {@link definePlugin} (Inviolable Rule 9 — every agentic capability ships as a
- * factory function).
- *
- * A {@link ProviderProfile} is data-only: it declares the provider name, the
- * HTTP dialect (`apiMode`), auth, base URL and fallback models. The transport
- * is selected from `apiMode` by the router, so any OpenAI-/Anthropic-compatible
- * endpoint (Groq, Together, Fireworks, a private gateway) is expressible as a
- * profile with no new code.
- *
- * Pass the result to `Agent.create({ plugins: [...] })` and route to it with
- * the `provider/model` id prefix or `providers.routes`:
- *
- * ```ts
- * const groq = defineProvider({
- *   name: "groq",
- *   apiMode: "chat_completions",
- *   authType: "api_key",
- *   envVars: ["GROQ_API_KEY"],
- *   baseUrl: "https://api.groq.com/openai/v1",
- *   fallbackModels: ["groq/llama-3.1-8b-instant"],
- * });
- * const agent = await Agent.create({
- *   model: { id: "groq/llama-3.1-8b-instant" },
- *   plugins: [groq],
- * });
- * ```
- *
- * @public
- */
-declare function defineProvider(profile: ProviderProfile, opts?: DefineProviderOptions): Plugin;
+/** SE36 — uniform namespace API. `Provider.create` replaces `defineProvider` (ADR 0015). @public */
+declare class Provider {
+    private constructor();
+    static create(profile: ProviderProfile, opts?: DefineProviderOptions): Plugin;
+}
 
 /**
  * SE23 — `defineSkillReadTool`: an OPT-IN factory that gives the MODEL on-demand
@@ -956,19 +906,11 @@ declare function defineProvider(profile: ProviderProfile, opts?: DefineProviderO
  * @public
  */
 
-/**
- * SE23 — build an OPT-IN `skill_read` {@link CustomTool} over the given inline
- * skills. When the model calls it with `{ name }`, the handler returns that
- * skill's body + references. An UNKNOWN (but well-formed) name returns a typed
- * "not found" string the model can act on — NOT a throw that kills the run.
- * Malformed input (missing `name`) fails at the trust boundary via the schema.
- *
- * The consumer controls exposure by choosing which skills to pass; the SDK
- * never auto-injects this tool.
- *
- * @public
- */
-declare function defineSkillReadTool(skills: ReadonlyArray<InlineSkill>): CustomTool;
+/** SE36 — `SkillReadTool.create` replaces `defineSkillReadTool` (ADR 0015). @public */
+declare class SkillReadTool {
+    private constructor();
+    static create(skills: ReadonlyArray<InlineSkill>): CustomTool;
+}
 
 /**
  * Options for {@link sanitizeToolInput}. Trim is the only default-on rung — coercion and JSON
@@ -1056,7 +998,18 @@ interface DefineToolSpec<T extends ZodType, O extends ZodType = never> {
      */
     sanitize?: boolean | SanitizeOptions;
 }
-declare function defineTool<T extends ZodType, O extends ZodType = never>(spec: DefineToolSpec<T, O>): CustomTool;
+/**
+ * SE36 — the uniform `X.create()` namespace API. `Tool.create(spec)` is the sole public
+ * constructor for a {@link CustomTool}; it wraps the internal builder so behavior is identical
+ * (ADR 0015). A `private constructor` makes `Tool` a namespace, not an instantiable value —
+ * `new Tool()` is a compile error. Mirrors `Agent.create` / `Cron.create`.
+ *
+ * @public
+ */
+declare class Tool {
+    private constructor();
+    static create<T extends ZodType, O extends ZodType = never>(spec: DefineToolSpec<T, O>): CustomTool;
+}
 
 /**
  * `EventBus` — typed EventEmitter wrapper.
@@ -1274,13 +1227,11 @@ declare function buildReplayHistory(base: readonly StoredMessage[], events: read
  * @public — surface-level reference impl.
  */
 
-/**
- * Build a fresh no-op MemoryProvider. The returned object is independent —
- * call `createNoopMemoryProvider()` per Agent instance. `init()` is
- * idempotent: subsequent calls return a NEW handle (no per-agent cache —
- * the no-op has no state worth caching).
- */
-declare function createNoopMemoryProvider(): MemoryProvider;
+/** SE36 — `NoopMemoryProvider.create` replaces `createNoopMemoryProvider` (ADR 0015). @public */
+declare class NoopMemoryProvider {
+    private constructor();
+    static create(): MemoryProvider;
+}
 
 /**
  * `JobQueue` — background job queue with status tracking, cancellation, and an
@@ -1669,12 +1620,11 @@ interface PermissionPluginOptions {
      */
     readonly onAsk?: (toolName: string) => PreToolCallDecision | undefined;
 }
-/**
- * Build a `general` plugin that vetoes tool calls per the engine's verdict, under
- * the configured {@link PermissionMode}, resolving `ask` via the {@link canUseTool}
- * gate. Register it on an agent's plugin manager (same as the ACP permission plugin).
- */
-declare function createPermissionPlugin(engine: PermissionEngine, opts?: PermissionPluginOptions): Plugin;
+/** SE36 — `PermissionPlugin.create` replaces `createPermissionPlugin` (ADR 0015). @public */
+declare class PermissionPlugin {
+    private constructor();
+    static create(engine: PermissionEngine, opts?: PermissionPluginOptions): Plugin;
+}
 
 /** The internal JSON-Schema shape the synthetic `output` tool consumes. */
 type NormalizedJsonSchema = Record<string, unknown>;
@@ -1870,12 +1820,11 @@ interface SessionManager {
  * @public
  */
 
-/**
- * Build a {@link SessionManager} bound to `storage`.
- *
- * @public
- */
-declare function createSessionManager(storage: ConversationStorageAdapter): SessionManager;
+/** SE36 — `Session.create` replaces `createSessionManager` (ADR 0015). @public */
+declare class Session {
+    private constructor();
+    static create(storage: ConversationStorageAdapter): SessionManager;
+}
 
 /**
  * M3 #62 — scoped session state.
@@ -1903,134 +1852,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.
  *
@@ -2084,14 +1905,11 @@ interface Squad {
     /** Run the team over `input`, threading each agent's output to the next. */
     run(input: unknown): Promise<SquadRun>;
 }
-/**
- * Build a sequential agent team. The returned {@link Squad} composes a
- * `Workflow` of `agentStep`s under the hood — all orchestration is delegated
- * to the workflow engine.
- *
- * @public
- */
-declare function createSquad(options: SquadOptions): Squad;
+/** SE36 — `Squad.create` replaces `createSquad` (ADR 0015). Merges with the `Squad` interface. @public */
+declare class Squad {
+    private constructor();
+    static create(options: SquadOptions): Squad;
+}
 
 /**
  * Public type contract for the Task observability registry (ADRs D361-D374).
@@ -2588,4 +2406,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, 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, NoopMemoryProvider, type NormalizedJsonSchema, ObjectiveRecord, type PermissionAction, PermissionEngine, type PermissionEngineOptions, type PermissionGate, type PermissionGateContext, type PermissionGateDecision, type PermissionMode, PermissionPlugin, type PermissionPluginOptions, type PermissionRule, Plugin, PluginsSettings, PreToolCallDecision, Processor, Provider, ProviderProfile, ProviderRoutingSettings, type ReplayHistoryOptions, Run, RunResult, SDKAgent, SDKAgentInfo, SDKMessage, type SDKModel, SDKProvider, type SDKRepository, type SDKUser, Security, Session, type SessionCapabilityResult, type SessionListOptions, type SessionManager, SessionMeta, SessionMetaPatch, type SessionScope, type SessionSummary, type ShareGptMessage, type ShareGptTrajectory, SkillReadTool, SkillsSettings, 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, TokenLimiter, type TokenLimiterOptions, Tool, ToolError, ToolResultContentBlock, UnicodeNormalizer, type UnicodeNormalizerOptions, UsageAccumulator, applyMode, buildReplayHistory, chargeAndCheckThresholds, computeCost, createCounterBudgetTracker, estimateTokens, extractRawId, getPricingEntry, inferApiMode, isValidTaskId, migrateSqliteToLance, mkMemoryId, normalizeSchema, normalizeUsage, preflightCheck, scopedConversationId, sessionScopePrefix, toShareGptTrajectory, withCwdMutex };