@theokit/sdk 2.8.0 → 2.10.0

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { T as TheokitAgentError, B as BudgetOptions, a as BudgetHandle, b as BudgetSnapshot } from './errors-FKoM44Mj.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, E as ErrorCode, m as ErrorMetadata, 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-FKoM44Mj.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 MemoryContext, m as ConversationStorageAdapter, n as StoredMessage, B as BudgetTracker, o as MemoryProvider, p as MemoryId, q as SDKProvider } from './cron-CRPY-aKq.cjs';
-export { r as ActiveMemoryPassArgs, s as ActiveMemoryPassResult, t as AgentMemory, u as BudgetCheck, v as BudgetTotal, w as BudgetUsageEvent, x as CloudEnv, y as CloudRepo, z as ContextBudget, D as ContextManagerKind, E as ContextSnapshot, F as ContextSource, H as ContextSourceStatus, I as Cron, J as CronCreateOptions, K as CronGetOptions, N as CronJob, O as CronJobStatus, Q as CronListOptions, R as CronOperationOptions, T as CronRunOptions, U as CronRuntime, V as CronSchedulerStatus, W as CronStartOptions, X as GoalEvent, Y as GoalOptions, Z as GoalResult, _ as InvalidateCacheOptions, $ as MemoryAdapter, a0 as MemoryAdapterCapabilities, a1 as MemoryFact, a2 as MemoryProviderHandle, a3 as MemoryProviderInitOptions, a4 as MemoryRevision, a5 as MemoryToolSchema, a6 as MemoryTurnMessage, a7 as PersonalityPreset, a8 as ProviderCapability, a9 as ProviderRoute, aa as RecordSessionSummaryArgs, ab as ResolvedProviderRoute, ac as RunUntilIterator, ad as SDKAgentPlugins, ae as SDKAgentSkills, af as SDKArtifact, ag as SDKContextManager, ah as SDKPluginMetadata, ai as SDKProvidersManager, aj as SettingSource, ak as SystemPromptContext, al as SystemPromptMemoryFact, am as SystemPromptSkillRef, an as TelemetrySettings } from './cron-CRPY-aKq.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, n as ConversationStorageAdapter, o as StoredMessage, B as BudgetTracker, p as MemoryProvider, q as MemoryId, r as PreToolCallDecision, s as SDKProvider } from './cron-BNI8pyn_.cjs';
+export { t as ActiveMemoryPassArgs, u as ActiveMemoryPassResult, v as AgentMemory, w as BudgetCheck, x as BudgetTotal, y as BudgetUsageEvent, z as CloudEnv, D as CloudRepo, E as ContextBudget, F as ContextManagerKind, H as ContextSnapshot, I as ContextSource, J as ContextSourceStatus, K as Cron, N as CronCreateOptions, O as CronGetOptions, Q as CronJob, R as CronJobStatus, T as CronListOptions, U as CronOperationOptions, V as CronRunOptions, W as CronRuntime, X as CronSchedulerStatus, Y as CronStartOptions, Z as GoalEvent, _ as GoalOptions, $ as GoalResult, a0 as HookName, a1 as InvalidateCacheOptions, a2 as MemoryAdapter, a3 as MemoryAdapterCapabilities, a4 as MemoryContext, a5 as MemoryFact, a6 as MemoryProviderHandle, a7 as MemoryProviderInitOptions, a8 as MemoryRevision, a9 as MemoryToolSchema, aa as MemoryTurnMessage, ab as PersonalityPreset, ac as PluginContext, ad as PostAssistantReplyContext, ae as PreToolCallContext, af as PreUserSendContext, ag as PreUserSendResult, ah as ProviderCapability, ai as ProviderRoute, aj as RecordSessionSummaryArgs, ak as ResolvedProviderRoute, al as RunUntilIterator, am as SDKAgentPlugins, an as SDKAgentSkills, ao as SDKArtifact, ap as SDKContextManager, aq as SDKPluginMetadata, ar as SDKProvidersManager, as as SettingSource, at as SystemPromptContext, au as SystemPromptMemoryFact, av as SystemPromptSkillRef, aw as TelemetrySettings, ax as definePlugin } from './cron-BNI8pyn_.cjs';
 import { R as RunResult, M as ModelSelection, C as CustomTool, a as McpServerConfig, b as Run, S as SDKMessage } from './run-D22b53SU.cjs';
 export { A as AgentConversationTurn, c as AssistantMessage, d as ConversationStep, e as ConversationTurn, f as CostBreakdown, g as CostSource, h as CostStatus, I as InteractionUpdate, i as McpAuthConfig, j as McpHttpServerConfig, k as McpOAuthConfig, l as McpStdioServerConfig, m as ModelParameterValue, P as PartialToolCallUpdate, n as RunErrorDetail, o as RunGitInfo, p as RunOperation, q as RunStatus, r as RunToCompletionOptions, s as RunToCompletionResult, t as SDKAssistantMessage, u as SDKImage, v as SDKImageDimension, w as SDKObjectDelta, x as SDKRequestMessage, y as SDKStatusMessage, z as SDKSystemMessage, B as SDKTaskMessage, D as SDKThinkingMessage, E as SDKToolUseMessage, F as SDKUserMessage, G as SDKUserMessageEvent, H as SendOptions, J as ShellCommand, K as ShellConversationTurn, L as ShellOutput, N as ShellOutputDeltaUpdate, O as StepCompletedUpdate, Q as StepStartedUpdate, T as StreamToCompletionResult, U as SummaryCompletedUpdate, V as SummaryStartedUpdate, W as SummaryUpdate, X as TextBlock, Y as TextDeltaUpdate, Z as ThinkingCompletedUpdate, _ as ThinkingDeltaUpdate, $ as ThinkingMessage, a0 as TokenDeltaUpdate, a1 as TokenUsage, a2 as ToolCall, a3 as ToolCallCompletedUpdate, a4 as ToolCallStartedUpdate, a5 as ToolResult, a6 as ToolUseBlock, a7 as TurnEndedUpdate, a8 as UserMessage, a9 as UserMessageAppendedUpdate } from './run-D22b53SU.cjs';
 import * as zod from 'zod';
@@ -683,11 +683,11 @@ declare function chargeAndCheckThresholds(name: string, actualUsd: number): Prom
  *
  * @internal
  */
-type ApiMode$1 = "anthropic_messages" | "openai_chat_completions" | "openai_responses";
-declare function inferApiMode(provider: string): ApiMode$1;
+type ApiMode = "anthropic_messages" | "openai_chat_completions" | "openai_responses";
+declare function inferApiMode(provider: string): ApiMode;
 declare function normalizeUsage(rawUsage: unknown, opts: {
     provider: string;
-    apiMode?: ApiMode$1;
+    apiMode?: ApiMode;
 }): TokenUsage;
 
 /**
@@ -821,120 +821,6 @@ declare class Budget {
     static snapshot(): readonly BudgetSnapshot[];
 }
 
-/**
- * ProviderProfile + ApiMode types (T3.1, ADR D105).
- *
- * Profile is **data-only** — no methods. Adding a provider is declaring an
- * object literal; the Transport layer (D106) consumes `apiMode` to pick
- * the HTTP dialect.
- *
- * @public
- */
-type ApiMode = "chat_completions" | "anthropic_messages" | "responses_api" | "bedrock" | "bedrock_anthropic";
-type AuthType = "api_key" | "oauth_device_code" | "oauth_external" | "aws_sdk" | "aws_bearer" | "gcp_oauth" | "none";
-interface ProviderProfile {
-    name: string;
-    apiMode: ApiMode;
-    aliases?: ReadonlyArray<string>;
-    displayName?: string;
-    description?: string;
-    signupUrl?: string;
-    envVars: ReadonlyArray<string>;
-    authType: AuthType;
-    baseUrl: string;
-    modelsUrl?: string;
-    hostname?: string;
-    fallbackModels: ReadonlyArray<string>;
-    extraHeaders?: Record<string, string>;
-    bodyOverrides?: Record<string, unknown>;
-}
-
-type HookName = "pre_tool_call" | "post_tool_call" | "pre_llm_call" | "post_llm_call" | "on_session_start" | "on_session_end" | "transform_tool_result" | "transform_llm_output" | "pre_user_send" | "post_assistant_reply";
-interface PreToolCallContext {
-    name: string;
-    args: Record<string, unknown>;
-    agentId: string;
-    runId: string;
-}
-interface PreToolCallDecision {
-    block: true;
-    message: string;
-}
-/**
- * Context passed to `pre_user_send` hook handlers (ADR D145).
- *
- * @public
- */
-interface PreUserSendContext {
-    prompt: string;
-    agentId: string;
-    runId: string;
-    /** Caller-supplied memory context, flowing through from `AgentOptions.memoryContext`. */
-    memoryContext?: MemoryContext;
-    /** Forwarded `AbortSignal` so adapter recall HTTP can be cancelled mid-flight (EC-H). */
-    signal?: AbortSignal;
-}
-/**
- * Optional result returned by `pre_user_send` handlers. The agent loop
- * concatenates `recalledContext` from all handlers and injects it as a
- * `<memory-context>...</memory-context>` block before the user prompt.
- *
- * @public
- */
-interface PreUserSendResult {
-    recalledContext?: string;
-}
-/**
- * Context passed to `post_assistant_reply` hook handlers (ADR D145).
- * Fire-and-forget — exceptions are caught and surfaced to stderr; the
- * caller's `wait()` never blocks on this dispatch.
- *
- * @public
- */
-interface PostAssistantReplyContext {
-    prompt: string;
-    reply: string;
-    agentId: string;
-    runId: string;
-    memoryContext?: MemoryContext;
-}
-type HookHandler = (ctx: unknown) => unknown | Promise<unknown>;
-type CommandHandler = (args: Record<string, unknown>) => Promise<string> | string;
-interface CommandOptions {
-    description?: string;
-}
-interface PluginContext {
-    /** Register a custom tool. Equivalent to passing in `AgentOptions.tools`. */
-    registerTool(tool: CustomTool): void;
-    /** Register a slash-command-style handler. Consumed by CLI/bot wrappers; NOT used by the agent loop. */
-    registerCommand(name: string, handler: CommandHandler, opts?: CommandOptions): void;
-    /** Attach a hook handler. `pre_tool_call` supports veto via `PreToolCallDecision`. */
-    on(hook: HookName, handler: HookHandler): void;
-    /** Inject a user/system message into the next agent turn. v1 supports only `on_session_start` context. */
-    injectMessage(content: string, role?: "user" | "system"): void;
-}
-interface BasePlugin {
-    name: string;
-    version: string;
-}
-type Plugin = (BasePlugin & {
-    kind: "general";
-    register: (ctx: PluginContext) => void | Promise<void>;
-}) | (BasePlugin & {
-    kind: "model-provider";
-    profile: ProviderProfile;
-}) | (BasePlugin & {
-    kind: "memory";
-    createProvider: MemoryProviderFactory;
-});
-/**
- * Identity helper for plugin authors. TS-only convenience — preserves
- * inferred type without forcing manual `Plugin` annotation.
- *
- * @public
- */
-declare function definePlugin<P extends Plugin>(p: P): P;
-
 /**
  * Options for {@link defineProvider}.
  *
@@ -2186,4 +2072,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, EventBus, type EvictReason, FileSystemConversationStorage, GenerateObjectError, type GenerateObjectOptions, type GenerateObjectResult, GetAgentOptions, GetRunOptions, type HookName, InMemoryConversationStorage, JobQueue, ListAgentsOptions, ListResult, ListRunsOptions, LiveAgentRegistry, LocalOptions, McpServerConfig, Memory, MemoryContext, MemoryId, MemoryProvider, MemorySettings, type MigrateOptions, type MigrateResult, type ModelListItem, type ModelParameterDefinition, ModelSelection, type ModelVariant, type PermissionAction, PermissionEngine, type PermissionEngineOptions, type PermissionPluginOptions, type PermissionRule, type Plugin, type PluginContext, PluginsSettings, type PostAssistantReplyContext, type PreToolCallContext, type PreToolCallDecision, type PreUserSendContext, type PreUserSendResult, type ProviderProfile, ProviderRoutingSettings, type ReplayHistoryOptions, Run, RunResult, SDKAgent, SDKAgentInfo, SDKMessage, type SDKModel, SDKProvider, type SDKRepository, type SDKUser, Security, 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, UsageAccumulator, buildReplayHistory, chargeAndCheckThresholds, computeCost, createAgentFactory, createCounterBudgetTracker, createNoopMemoryProvider, createPermissionPlugin, createSquad, definePlugin, defineProvider, defineTool, extractRawId, getPricingEntry, inferApiMode, isValidTaskId, migrateSqliteToLance, mkMemoryId, normalizeUsage, preflightCheck, 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, EventBus, type EvictReason, FileSystemConversationStorage, GenerateObjectError, type GenerateObjectOptions, type GenerateObjectResult, GetAgentOptions, GetRunOptions, InMemoryConversationStorage, JobQueue, ListAgentsOptions, ListResult, ListRunsOptions, LiveAgentRegistry, LocalOptions, McpServerConfig, Memory, MemoryId, MemoryProvider, MemorySettings, type MigrateOptions, type MigrateResult, type ModelListItem, type ModelParameterDefinition, ModelSelection, type ModelVariant, type PermissionAction, PermissionEngine, type PermissionEngineOptions, type PermissionPluginOptions, type PermissionRule, Plugin, PluginsSettings, PreToolCallDecision, ProviderProfile, ProviderRoutingSettings, type ReplayHistoryOptions, Run, RunResult, SDKAgent, SDKAgentInfo, SDKMessage, type SDKModel, SDKProvider, type SDKRepository, type SDKUser, Security, 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, UsageAccumulator, buildReplayHistory, chargeAndCheckThresholds, computeCost, createAgentFactory, createCounterBudgetTracker, createNoopMemoryProvider, createPermissionPlugin, createSquad, defineProvider, defineTool, extractRawId, getPricingEntry, inferApiMode, isValidTaskId, migrateSqliteToLance, mkMemoryId, normalizeUsage, preflightCheck, toShareGptTrajectory, withCwdMutex };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { T as TheokitAgentError, B as BudgetOptions, a as BudgetHandle, b as BudgetSnapshot } from './errors-C8EVGqje.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, E as ErrorCode, m as ErrorMetadata, 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-C8EVGqje.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 MemoryContext, m as ConversationStorageAdapter, n as StoredMessage, B as BudgetTracker, o as MemoryProvider, p as MemoryId, q as SDKProvider } from './cron-Bhp8rP8i.js';
-export { r as ActiveMemoryPassArgs, s as ActiveMemoryPassResult, t as AgentMemory, u as BudgetCheck, v as BudgetTotal, w as BudgetUsageEvent, x as CloudEnv, y as CloudRepo, z as ContextBudget, D as ContextManagerKind, E as ContextSnapshot, F as ContextSource, H as ContextSourceStatus, I as Cron, J as CronCreateOptions, K as CronGetOptions, N as CronJob, O as CronJobStatus, Q as CronListOptions, R as CronOperationOptions, T as CronRunOptions, U as CronRuntime, V as CronSchedulerStatus, W as CronStartOptions, X as GoalEvent, Y as GoalOptions, Z as GoalResult, _ as InvalidateCacheOptions, $ as MemoryAdapter, a0 as MemoryAdapterCapabilities, a1 as MemoryFact, a2 as MemoryProviderHandle, a3 as MemoryProviderInitOptions, a4 as MemoryRevision, a5 as MemoryToolSchema, a6 as MemoryTurnMessage, a7 as PersonalityPreset, a8 as ProviderCapability, a9 as ProviderRoute, aa as RecordSessionSummaryArgs, ab as ResolvedProviderRoute, ac as RunUntilIterator, ad as SDKAgentPlugins, ae as SDKAgentSkills, af as SDKArtifact, ag as SDKContextManager, ah as SDKPluginMetadata, ai as SDKProvidersManager, aj as SettingSource, ak as SystemPromptContext, al as SystemPromptMemoryFact, am as SystemPromptSkillRef, an as TelemetrySettings } from './cron-Bhp8rP8i.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, n as ConversationStorageAdapter, o as StoredMessage, B as BudgetTracker, p as MemoryProvider, q as MemoryId, r as PreToolCallDecision, s as SDKProvider } from './cron-CZlMLA1K.js';
+export { t as ActiveMemoryPassArgs, u as ActiveMemoryPassResult, v as AgentMemory, w as BudgetCheck, x as BudgetTotal, y as BudgetUsageEvent, z as CloudEnv, D as CloudRepo, E as ContextBudget, F as ContextManagerKind, H as ContextSnapshot, I as ContextSource, J as ContextSourceStatus, K as Cron, N as CronCreateOptions, O as CronGetOptions, Q as CronJob, R as CronJobStatus, T as CronListOptions, U as CronOperationOptions, V as CronRunOptions, W as CronRuntime, X as CronSchedulerStatus, Y as CronStartOptions, Z as GoalEvent, _ as GoalOptions, $ as GoalResult, a0 as HookName, a1 as InvalidateCacheOptions, a2 as MemoryAdapter, a3 as MemoryAdapterCapabilities, a4 as MemoryContext, a5 as MemoryFact, a6 as MemoryProviderHandle, a7 as MemoryProviderInitOptions, a8 as MemoryRevision, a9 as MemoryToolSchema, aa as MemoryTurnMessage, ab as PersonalityPreset, ac as PluginContext, ad as PostAssistantReplyContext, ae as PreToolCallContext, af as PreUserSendContext, ag as PreUserSendResult, ah as ProviderCapability, ai as ProviderRoute, aj as RecordSessionSummaryArgs, ak as ResolvedProviderRoute, al as RunUntilIterator, am as SDKAgentPlugins, an as SDKAgentSkills, ao as SDKArtifact, ap as SDKContextManager, aq as SDKPluginMetadata, ar as SDKProvidersManager, as as SettingSource, at as SystemPromptContext, au as SystemPromptMemoryFact, av as SystemPromptSkillRef, aw as TelemetrySettings, ax as definePlugin } from './cron-CZlMLA1K.js';
 import { R as RunResult, M as ModelSelection, C as CustomTool, a as McpServerConfig, b as Run, S as SDKMessage } from './run-D22b53SU.js';
 export { A as AgentConversationTurn, c as AssistantMessage, d as ConversationStep, e as ConversationTurn, f as CostBreakdown, g as CostSource, h as CostStatus, I as InteractionUpdate, i as McpAuthConfig, j as McpHttpServerConfig, k as McpOAuthConfig, l as McpStdioServerConfig, m as ModelParameterValue, P as PartialToolCallUpdate, n as RunErrorDetail, o as RunGitInfo, p as RunOperation, q as RunStatus, r as RunToCompletionOptions, s as RunToCompletionResult, t as SDKAssistantMessage, u as SDKImage, v as SDKImageDimension, w as SDKObjectDelta, x as SDKRequestMessage, y as SDKStatusMessage, z as SDKSystemMessage, B as SDKTaskMessage, D as SDKThinkingMessage, E as SDKToolUseMessage, F as SDKUserMessage, G as SDKUserMessageEvent, H as SendOptions, J as ShellCommand, K as ShellConversationTurn, L as ShellOutput, N as ShellOutputDeltaUpdate, O as StepCompletedUpdate, Q as StepStartedUpdate, T as StreamToCompletionResult, U as SummaryCompletedUpdate, V as SummaryStartedUpdate, W as SummaryUpdate, X as TextBlock, Y as TextDeltaUpdate, Z as ThinkingCompletedUpdate, _ as ThinkingDeltaUpdate, $ as ThinkingMessage, a0 as TokenDeltaUpdate, a1 as TokenUsage, a2 as ToolCall, a3 as ToolCallCompletedUpdate, a4 as ToolCallStartedUpdate, a5 as ToolResult, a6 as ToolUseBlock, a7 as TurnEndedUpdate, a8 as UserMessage, a9 as UserMessageAppendedUpdate } from './run-D22b53SU.js';
 import * as zod from 'zod';
@@ -683,11 +683,11 @@ declare function chargeAndCheckThresholds(name: string, actualUsd: number): Prom
  *
  * @internal
  */
-type ApiMode$1 = "anthropic_messages" | "openai_chat_completions" | "openai_responses";
-declare function inferApiMode(provider: string): ApiMode$1;
+type ApiMode = "anthropic_messages" | "openai_chat_completions" | "openai_responses";
+declare function inferApiMode(provider: string): ApiMode;
 declare function normalizeUsage(rawUsage: unknown, opts: {
     provider: string;
-    apiMode?: ApiMode$1;
+    apiMode?: ApiMode;
 }): TokenUsage;
 
 /**
@@ -821,120 +821,6 @@ declare class Budget {
     static snapshot(): readonly BudgetSnapshot[];
 }
 
-/**
- * ProviderProfile + ApiMode types (T3.1, ADR D105).
- *
- * Profile is **data-only** — no methods. Adding a provider is declaring an
- * object literal; the Transport layer (D106) consumes `apiMode` to pick
- * the HTTP dialect.
- *
- * @public
- */
-type ApiMode = "chat_completions" | "anthropic_messages" | "responses_api" | "bedrock" | "bedrock_anthropic";
-type AuthType = "api_key" | "oauth_device_code" | "oauth_external" | "aws_sdk" | "aws_bearer" | "gcp_oauth" | "none";
-interface ProviderProfile {
-    name: string;
-    apiMode: ApiMode;
-    aliases?: ReadonlyArray<string>;
-    displayName?: string;
-    description?: string;
-    signupUrl?: string;
-    envVars: ReadonlyArray<string>;
-    authType: AuthType;
-    baseUrl: string;
-    modelsUrl?: string;
-    hostname?: string;
-    fallbackModels: ReadonlyArray<string>;
-    extraHeaders?: Record<string, string>;
-    bodyOverrides?: Record<string, unknown>;
-}
-
-type HookName = "pre_tool_call" | "post_tool_call" | "pre_llm_call" | "post_llm_call" | "on_session_start" | "on_session_end" | "transform_tool_result" | "transform_llm_output" | "pre_user_send" | "post_assistant_reply";
-interface PreToolCallContext {
-    name: string;
-    args: Record<string, unknown>;
-    agentId: string;
-    runId: string;
-}
-interface PreToolCallDecision {
-    block: true;
-    message: string;
-}
-/**
- * Context passed to `pre_user_send` hook handlers (ADR D145).
- *
- * @public
- */
-interface PreUserSendContext {
-    prompt: string;
-    agentId: string;
-    runId: string;
-    /** Caller-supplied memory context, flowing through from `AgentOptions.memoryContext`. */
-    memoryContext?: MemoryContext;
-    /** Forwarded `AbortSignal` so adapter recall HTTP can be cancelled mid-flight (EC-H). */
-    signal?: AbortSignal;
-}
-/**
- * Optional result returned by `pre_user_send` handlers. The agent loop
- * concatenates `recalledContext` from all handlers and injects it as a
- * `<memory-context>...</memory-context>` block before the user prompt.
- *
- * @public
- */
-interface PreUserSendResult {
-    recalledContext?: string;
-}
-/**
- * Context passed to `post_assistant_reply` hook handlers (ADR D145).
- * Fire-and-forget — exceptions are caught and surfaced to stderr; the
- * caller's `wait()` never blocks on this dispatch.
- *
- * @public
- */
-interface PostAssistantReplyContext {
-    prompt: string;
-    reply: string;
-    agentId: string;
-    runId: string;
-    memoryContext?: MemoryContext;
-}
-type HookHandler = (ctx: unknown) => unknown | Promise<unknown>;
-type CommandHandler = (args: Record<string, unknown>) => Promise<string> | string;
-interface CommandOptions {
-    description?: string;
-}
-interface PluginContext {
-    /** Register a custom tool. Equivalent to passing in `AgentOptions.tools`. */
-    registerTool(tool: CustomTool): void;
-    /** Register a slash-command-style handler. Consumed by CLI/bot wrappers; NOT used by the agent loop. */
-    registerCommand(name: string, handler: CommandHandler, opts?: CommandOptions): void;
-    /** Attach a hook handler. `pre_tool_call` supports veto via `PreToolCallDecision`. */
-    on(hook: HookName, handler: HookHandler): void;
-    /** Inject a user/system message into the next agent turn. v1 supports only `on_session_start` context. */
-    injectMessage(content: string, role?: "user" | "system"): void;
-}
-interface BasePlugin {
-    name: string;
-    version: string;
-}
-type Plugin = (BasePlugin & {
-    kind: "general";
-    register: (ctx: PluginContext) => void | Promise<void>;
-}) | (BasePlugin & {
-    kind: "model-provider";
-    profile: ProviderProfile;
-}) | (BasePlugin & {
-    kind: "memory";
-    createProvider: MemoryProviderFactory;
-});
-/**
- * Identity helper for plugin authors. TS-only convenience — preserves
- * inferred type without forcing manual `Plugin` annotation.
- *
- * @public
- */
-declare function definePlugin<P extends Plugin>(p: P): P;
-
 /**
  * Options for {@link defineProvider}.
  *
@@ -2186,4 +2072,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, EventBus, type EvictReason, FileSystemConversationStorage, GenerateObjectError, type GenerateObjectOptions, type GenerateObjectResult, GetAgentOptions, GetRunOptions, type HookName, InMemoryConversationStorage, JobQueue, ListAgentsOptions, ListResult, ListRunsOptions, LiveAgentRegistry, LocalOptions, McpServerConfig, Memory, MemoryContext, MemoryId, MemoryProvider, MemorySettings, type MigrateOptions, type MigrateResult, type ModelListItem, type ModelParameterDefinition, ModelSelection, type ModelVariant, type PermissionAction, PermissionEngine, type PermissionEngineOptions, type PermissionPluginOptions, type PermissionRule, type Plugin, type PluginContext, PluginsSettings, type PostAssistantReplyContext, type PreToolCallContext, type PreToolCallDecision, type PreUserSendContext, type PreUserSendResult, type ProviderProfile, ProviderRoutingSettings, type ReplayHistoryOptions, Run, RunResult, SDKAgent, SDKAgentInfo, SDKMessage, type SDKModel, SDKProvider, type SDKRepository, type SDKUser, Security, 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, UsageAccumulator, buildReplayHistory, chargeAndCheckThresholds, computeCost, createAgentFactory, createCounterBudgetTracker, createNoopMemoryProvider, createPermissionPlugin, createSquad, definePlugin, defineProvider, defineTool, extractRawId, getPricingEntry, inferApiMode, isValidTaskId, migrateSqliteToLance, mkMemoryId, normalizeUsage, preflightCheck, 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, EventBus, type EvictReason, FileSystemConversationStorage, GenerateObjectError, type GenerateObjectOptions, type GenerateObjectResult, GetAgentOptions, GetRunOptions, InMemoryConversationStorage, JobQueue, ListAgentsOptions, ListResult, ListRunsOptions, LiveAgentRegistry, LocalOptions, McpServerConfig, Memory, MemoryId, MemoryProvider, MemorySettings, type MigrateOptions, type MigrateResult, type ModelListItem, type ModelParameterDefinition, ModelSelection, type ModelVariant, type PermissionAction, PermissionEngine, type PermissionEngineOptions, type PermissionPluginOptions, type PermissionRule, Plugin, PluginsSettings, PreToolCallDecision, ProviderProfile, ProviderRoutingSettings, type ReplayHistoryOptions, Run, RunResult, SDKAgent, SDKAgentInfo, SDKMessage, type SDKModel, SDKProvider, type SDKRepository, type SDKUser, Security, 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, UsageAccumulator, buildReplayHistory, chargeAndCheckThresholds, computeCost, createAgentFactory, createCounterBudgetTracker, createNoopMemoryProvider, createPermissionPlugin, createSquad, defineProvider, defineTool, extractRawId, getPricingEntry, inferApiMode, isValidTaskId, migrateSqliteToLance, mkMemoryId, normalizeUsage, preflightCheck, toShareGptTrajectory, withCwdMutex };

package/dist/index.js

@@ -5871,6 +5871,18 @@ async function writeVersionedJson(path, data2, currentVersion) {
   await atomicWriteJson(path, file);
 }
 
+// src/internal/plugins/enabled-names.ts
+function isPluginArray(plugins) {
+  return Array.isArray(plugins);
+}
+function asPluginsSettings(plugins) {
+  if (plugins === void 0) return void 0;
+  return isPluginArray(plugins) ? void 0 : plugins;
+}
+function enabledPluginNames(plugins) {
+  return asPluginsSettings(plugins)?.enabled ?? [];
+}
+
 // src/internal/runtime/registry/agent-registry-store.ts
 var SCHEMA_VERSION = 1;
 var LEGACY_SCHEMA_VERSION_STRING = "1.0";
@@ -5884,7 +5896,9 @@ function stripSecretsFromOptions(options) {
     cloud: serializeCloud(options.cloud),
     memory: serializeMemory(options.memory),
     skills: serializeEnabledList(options.skills),
-    plugins: serializeEnabledList(options.plugins),
+    // Code-`Plugin` objects are closures and cannot be persisted (like custom
+    // tools); only the named-enable settings form is serialized.
+    plugins: serializeEnabledList(asPluginsSettings(options.plugins)),
     context: serializeContext(options.context),
     providers: serializeProviders(options.providers),
     agents: serializeAgents(options.agents)
@@ -6192,8 +6206,9 @@ function serializeSkills(skills) {
   return { enabled: [...skills.enabled] };
 }
 function serializePlugins(plugins) {
-  if (plugins?.enabled === void 0 || plugins.enabled.length === 0) return void 0;
-  return { enabled: [...plugins.enabled] };
+  const enabled = enabledPluginNames(plugins);
+  if (enabled.length === 0) return void 0;
+  return { enabled: [...enabled] };
 }
 function serializeMcp(mcpServers) {
   if (mcpServers === void 0) return void 0;
@@ -6376,11 +6391,8 @@ function defaultLocalTools(request) {
       tools.push(`mcp_${sanitizeMcpName(name)}_call`);
     }
   }
-  const plugins = request.agentOptions.plugins;
-  if (plugins?.enabled !== void 0) {
-    for (const _pluginName of plugins.enabled) {
-      tools.push("mcp_search_provider_web_search");
-    }
+  for (const _pluginName of enabledPluginNames(request.agentOptions.plugins)) {
+    tools.push("mcp_search_provider_web_search");
   }
   return tools;
 }
@@ -9500,7 +9512,7 @@ function resolveRoute(route, modelProvider, plugins) {
     if (modelName !== void 0) base.model = modelName;
     return base;
   }
-  if (plugins?.enabled !== void 0 && plugins.enabled.length > 0) {
+  if (enabledPluginNames(plugins).length > 0) {
     return {
       capability: route.capability,
       provider: route.provider,
@@ -10505,7 +10517,7 @@ function bootstrapSubmanagers(args) {
       args.settingSourcesIncludeProject
     );
   }
-  const providerCount = (args.options.providers?.routes?.length ?? 0) + (args.options.plugins?.enabled?.length ?? 0);
+  const providerCount = (args.options.providers?.routes?.length ?? 0) + enabledPluginNames(args.options.plugins).length;
   if (providerCount > 0 || args.options.providers !== void 0) {
     out.providers = new ProvidersManagerImpl(
       args.options.model,
@@ -10525,7 +10537,9 @@ function bootstrapSubmanagers(args) {
   if (args.options.plugins !== void 0 || args.settingSourcesIncludePlugins) {
     out.pluginsManager = new PluginsManager(
       args.workspaceCwd,
-      args.options.plugins?.enabled,
+      // The array (code-`Plugin`) form has no named-enable list; `undefined`
+      // here preserves "no filter / load all file-discovered plugins".
+      asPluginsSettings(args.options.plugins)?.enabled,
       args.settingSourcesIncludePlugins,
       false,
       void 0
@@ -16885,7 +16899,7 @@ var Agent = class _Agent {
     const runtime = options.cloud !== void 0 ? "cloud" : "local";
     const span = telemetry.startSpan(SPAN_NAMES.AGENT_CREATE, {
       runtime,
-      pluginCount: options.plugins?.enabled?.length ?? 0
+      pluginCount: enabledPluginNames(options.plugins).length
     });
     try {
       const agent = await runCreateUnderSpan(options, span);