@standardagents/spec 0.43.0 → 0.44.0

package/dist/index.d.ts

@@ -409,6 +409,7 @@ type ResolveUsesState<Uses extends readonly string[]> = IsEmptyArray<Uses> exten
  * @template Uses - Readonly array of allowed tool names
  */
 type UsesAwareExecute<State, Args extends ToolArgs | null, Uses extends readonly string[]> = Args extends ToolArgs ? (state: ResolveUsesState<Uses>, args: z.infer<Args>) => Promise<ToolResult> : (state: ResolveUsesState<Uses>) => Promise<ToolResult>;
+type ToolAnnotations = Record<string, unknown>;
 /**
  * Options for defining a tool.
  *
@@ -420,6 +421,7 @@ type UsesAwareExecute<State, Args extends ToolArgs | null, Uses extends readonly
 interface DefineToolOptions<State = ThreadState, Args extends ToolArgs | null = null, Tenvs extends ToolTenvs | null = null, Uses extends readonly string[] = readonly string[]> {
     /** Description of what the tool does (shown to the LLM). */
     description: string;
+    annotations?: ToolAnnotations;
     /** Zod schema for validating tool arguments. Omit for tools with no args. */
     args?: Args;
     /** The tool implementation function. */
@@ -527,6 +529,7 @@ interface DefineToolOptions<State = ThreadState, Args extends ToolArgs | null =
 interface ToolDefinition<State = ThreadState, Args extends ToolArgs | null = null, Tenvs extends ToolTenvs | null = null, Uses extends readonly string[] = readonly string[]> {
     /** Description of what the tool does (shown to the LLM). */
     description: string;
+    annotations?: ToolAnnotations;
     /** Zod schema for validating tool arguments, or null for no args. */
     args: Args;
     /** The tool implementation function. */
@@ -882,6 +885,8 @@ interface ProviderRequest {
     stopSequences?: string[];
     reasoning?: {
         level?: number;
+        /** The model definition map takes precedence over the provider catalog. */
+        levels?: Record<number, string | null>;
         maxTokens?: number;
         exclude?: boolean;
     };
@@ -923,7 +928,6 @@ interface ProviderToolMessage {
     toolCallId: string;
     toolName: string;
     content: ProviderToolResultContent;
-    attachments?: ProviderAttachment[];
 }
 /**
  * Attachment on a provider message (loaded from storage, ready for provider-specific transformation)
@@ -1215,6 +1219,13 @@ declare class ProviderError extends Error {
      */
     get isRetryable(): boolean;
 }
+/**
+ * Optional provider helper for reasoning discovery before dispatch.
+ * A catalog lookup may delay a request by at most 250 ms.
+ * Request aborts reject the wait; failures and timeouts omit discovered levels.
+ * Declared levels bypass discovery. The catalog may continue filling its cache.
+ */
+declare function resolveRequestReasoningLevels(request: ProviderRequest, lookup: (model: string) => Promise<ModelCapabilities | null>): Promise<ModelCapabilities['reasoningLevels']>;
 /**
  * Maps a 0-100 reasoning level to the model's nearest supported level
  */
@@ -1404,7 +1415,10 @@ declare function defineEffect<State = ThreadState>(description: string, handler:
  * id; a runtime with exactly one principal resolves all requests to a single
  * constant user id.
  */
-type UserIdentity = ThreadUser;
+type UserIdentity = Omit<ThreadUser, 'username' | 'role'> & {
+    username?: string | null;
+    role?: string | null;
+};
 /**
  * A client attached to the user event stream, as reported to user lifecycle
  * hooks. `kind` is a client-declared label (for example `"cli"`, `"web"`).
@@ -1913,7 +1927,7 @@ interface SubagentRegistryEntry {
     reference: string;
     /**
      * The relationship name this instance was spawned under — the `as` name
-     * (defaulting to the agent name) of the owning side's declaration. This is
+     * (defaulting to the unqualified part of `agent`) of the owning side's declaration. This is
      * the name lifecycle tools address; `name` is the implementing agent
      * definition.
      */
@@ -2562,7 +2576,11 @@ interface ExecutionState {
     readonly stopped: boolean;
     /** Which side initiated the stop (if stopped) */
     readonly stoppedBy?: 'a' | 'b';
-    /** Live chronological persisted history for the current execution */
+    /**
+     * Live chronological persisted history for the current execution. With
+     * the active prompt's `historyLimit`, only its newest window of
+     * top-level messages (see `PromptDefinition.historyLimit`).
+     */
     readonly messageHistory: Message[];
     /**
      * Force a specific side to play the next turn.
@@ -3708,7 +3726,7 @@ interface ProviderDefinition<N extends string = string, Base extends ProviderFac
  * ```
  */
 interface ProviderFactoryWithOptions<TOptions extends ZodTypeAny = ZodTypeAny> {
-    (config: ProviderFactoryConfig): ProviderInstance;
+    (config: ProviderFactoryConfig, context?: Pick<ProviderOverrideContext, 'state'>): ProviderInstance;
     /** Zod schema for provider-specific options */
     providerOptions?: TOptions;
     /** Connection-level config slots accepted by this provider factory */
@@ -3758,7 +3776,7 @@ interface ModelCapabilities {
      *
      * @example
      * // OpenAI o-series
-     * reasoningLevels: { 0: null, 33: 'low', 66: 'medium', 100: 'high' }
+     * reasoningLevels: { 0: 'low', 33: 'low', 66: 'medium', 100: 'high' }
      *
      * @example
      * // Binary reasoning (Claude extended thinking)
@@ -4208,31 +4226,26 @@ type SubagentToolConfig<T extends string = string> = never;
 interface ReasoningConfig {
     /**
      * Numeric reasoning level on a 0-100 scale.
-     * The FlowEngine maps this to the model's nearest supported reasoning option.
+     * An unset level uses the model's default. Level 0 requests the least reasoning.
+     * Providers disable reasoning when supported or select the lowest native setting.
+     * Each provider maps this to the model's nearest declared reasoning option.
+     * A level replaces native effort in providerOptions and preserves other keys.
+     * Without a level, providerOptions apply as provided.
+     * Native effort in model providerOptions remains valid.
+     * Saved input with reasoning.effort fails validation.
+     * A published package prompt with reasoning.effort loads with a warning.
+     * The runtime ignores that field.
      *
      * @example
      * // Typical breakpoints:
-     * // 0   = No reasoning
+     * // 0   = Least reasoning
      * // 33  = Low effort
      * // 66  = Medium effort
      * // 100 = Maximum effort
      *
-     * reasoning: { level: 75 } // Maps to 'high' on most models
+     * reasoning: { level: 90 } // Maps to 'high' on most models
      */
     level?: number;
-    /**
-     * @deprecated Use `level` instead. Will be removed in future versions.
-     *
-     * Effort level for reasoning models.
-     * Higher effort = more thinking tokens = potentially better results.
-     *
-     * - `low`: Minimal reasoning, faster responses (equivalent to level ~33)
-     * - `medium`: Balanced reasoning and speed (equivalent to level ~66)
-     * - `high`: Maximum reasoning, slower but more thorough (equivalent to level ~100)
-     *
-     * @default undefined (use model defaults)
-     */
-    effort?: 'low' | 'medium' | 'high';
     /**
      * Maximum tokens to allocate for reasoning.
      * Applies to models that support token limits on reasoning.
@@ -4380,6 +4393,19 @@ interface PromptDefinition<N extends string = string, S extends ToolArgs = ToolA
      * @default 10
      */
     recentImageThreshold?: number;
+    /**
+     * Bound the stored chat history a request loads (with `includeChat`):
+     * only the newest top-level messages, at least `historyLimit` and fewer
+     * than twice it. The cut moves `historyLimit` messages at a time, never
+     * per message, so the loaded rows stay the same between steps and a
+     * provider's prompt cache stays warm; a `filter_messages` window that
+     * moves in steps dividing `historyLimit` keeps the same messages it
+     * would keep over the whole history. The window is the execution's
+     * history itself, not only the request: `execution.messageHistory`, tools,
+     * hooks and `filter_messages` all see just these rows. Stored history is
+     * untouched. Unset loads the whole history.
+     */
+    historyLimit?: number;
     /**
      * Provider-specific options passed through to the provider.
      * These override model-level providerOptions for this prompt.
@@ -4504,7 +4530,11 @@ interface SubagentRelationship<Agent extends string = StandardAgentSpec.Agents>
      */
     readonly agent: Agent;
     /**
-     * Relationship name; defaults to `agent`.
+     * Relationship name; defaults to the unqualified part of `agent`.
+     * A packed definition uses `{packageId}/{name}`.
+     * For `@scope/pkg/agent`, the package is `@scope/pkg` and the name is `agent`.
+     * `@scope/name` is unqualified.
+     * Type registries include qualified packed entry agents and exclude package internals.
      *
      * This is the tool-surface name, the registry identity, and the name the
      * lifecycle tools' `agent` argument enumerates. Aliasing lets the same
@@ -4775,12 +4805,12 @@ interface PromptSide<Prompt extends string = StandardAgentSpec.Prompts, Callable
     /**
      * Stop this side's turn when a specific tool is called.
      * Overrides stopOnResponse when the named tool is invoked.
-     * Requires stopToolResponseProperty to extract the result.
+     * Set stopToolResponseProperty to extract the result from the tool call.
      */
     readonly stopTool?: Callable;
     /**
      * Property to extract from the stop tool's result.
-     * Required when stopTool is set.
+     * Valid only when stopTool is set.
      * The extracted value is used to determine the conversation outcome.
      */
     readonly stopToolResponseProperty?: string;
@@ -4989,7 +5019,7 @@ interface AgentDefinition<N extends string = string, Prompt extends string = Sta
     readonly icon?: string;
     /**
      * Environment values provided by this agent.
-     * Agent values are lower priority than thread/account/instance values.
+     * Resolution precedence is thread, agent, prompt, user, then instance.
      */
     readonly env?: Readonly<Record<string, string>>;
     /**
@@ -5118,6 +5148,131 @@ interface AgentDefinition<N extends string = string, Prompt extends string = Sta
  */
 declare function defineAgent<N extends string>(options: AgentDefinition<N>): AgentDefinition<N>;
 
+/**
+ * Handler definition types for Standard Agents.
+ *
+ * A handler is a function that takes one side's turns in a conversation.
+ * When a side of an agent is backed by a handler, the runtime does not call
+ * a model to answer an inbound message — it calls the handler function once,
+ * with the thread state and the message, and whatever that function does is
+ * the side's turn.
+ *
+ * A handler is NOT a hook (hooks decorate turns owned by something else, and
+ * their failures are non-fatal), NOT a tool (tools are capabilities a
+ * turn-owner chooses to invoke), and NOT an effect (effects run outside the
+ * conversation flow). Its only seat is backing a side of an agent: handlers
+ * MUST NOT be referenced by prompt `tools` arrays, hook lists, or effect
+ * schedules, and implementations MUST reject such references at definition
+ * time.
+ *
+ * https://standardagentspec.com/0.2.0/specification/handlers
+ *
+ * @module
+ */
+
+/**
+ * Brand marking a value as a handler definition.
+ *
+ * The brand makes `HandlerDefinition` structurally unassignable to tool,
+ * hook, and effect positions, so a handler referenced where those are
+ * expected fails to compile wherever TypeScript can see the reference.
+ * Implementations additionally reject by-name references that types cannot
+ * catch during their definition-registry pass.
+ */
+declare const HANDLER_SYMBOL: unique symbol;
+/**
+ * A handler definition — deterministic code that owns one side's turns.
+ *
+ * Execution model (one turn):
+ * 1. An inbound message arrives on the side's perspective.
+ * 2. The runtime invokes `execute` once with the thread's `ThreadState` and
+ *    that message.
+ * 3. The invocation returns (or throws). The turn is complete.
+ *
+ * There are no steps, no tool-choice loop, and no model requests for a
+ * handler-backed side. When the agent sets `maxSessionTurns`, a handler turn
+ * counts toward the exchange cap exactly like a prompt turn.
+ *
+ * Delivery is exactly-once per message, in message persistence order, one
+ * invocation at a time per thread; messages that arrive while a turn is in
+ * flight wait in the queue. A failed invocation is never automatically
+ * redelivered — retry is a userland decision.
+ *
+ * Errors are fatal to the turn, and only the turn: the turn is marked failed
+ * as a runtime-origin failure, the inbound message stays persisted, and the
+ * session continues. A handler ends sessions explicitly via
+ * `state.stopSession()`.
+ *
+ * @template State - The thread state type (defaults to {@link ThreadState})
+ */
+interface HandlerDefinition<State = ThreadState> {
+    /** Optional human-facing summary of what this handler does. */
+    readonly description?: string;
+    /**
+     * The turn implementation.
+     *
+     * Receives the full `ThreadState` — it may forward (`queueMessage` toward a
+     * child), respond (`injectMessage` as its own side's role), spawn children,
+     * stop the session, and read/write thread values: anything tools can do.
+     *
+     * The `message` parameter is the full persisted {@link Message} — id, role,
+     * content, silent flag, metadata, timestamps — not a narrowed view:
+     * handlers are trusted definition code, like tools.
+     *
+     * There is no auto-reply channel: the runtime routes inbound; userland
+     * decides outbound. If the handler wants to speak outward, that is code in
+     * this function.
+     */
+    readonly execute: (state: State, message: Message) => Promise<void>;
+    readonly [HANDLER_SYMBOL]: true;
+}
+/**
+ * Options accepted by {@link defineHandler}.
+ *
+ * @template State - The thread state type (defaults to {@link ThreadState})
+ */
+interface DefineHandlerOptions<State = ThreadState> {
+    /** Optional human-facing summary of what this handler does. */
+    readonly description?: string;
+    /** The turn implementation. See {@link HandlerDefinition.execute}. */
+    readonly execute: (state: State, message: Message) => Promise<void>;
+}
+/**
+ * Defines a handler — deterministic code that backs one side of an agent and
+ * takes that side's turns in place of a model.
+ *
+ * Handlers live in their own definition directory (`agents/handlers/` in the
+ * conventional layout). The handler's name is derived from its file name and
+ * referenced from exactly one place: the `handler` property of a side
+ * configuration.
+ *
+ * @template State - The thread state type (defaults to {@link ThreadState})
+ * @param options - Handler configuration options
+ * @returns The branded handler definition for registration
+ *
+ * @example
+ * ```typescript
+ * // agents/handlers/relay_pipe.ts
+ * import { defineHandler } from '@standardagents/spec';
+ *
+ * export default defineHandler({
+ *   description: 'Forwards inbound user traffic to the assistant child and relays answers back.',
+ *   execute: async (state, message) => {
+ *     const assistant = state.children.find(c => c.relationship === 'assistant_agent');
+ *     if (!assistant) return;
+ *     const child = await state.getChildThread(assistant.reference);
+ *     await child?.queueMessage({ role: 'user', content: message.content ?? '' });
+ *   },
+ * });
+ * ```
+ */
+declare function defineHandler<State = ThreadState>(options: DefineHandlerOptions<State>): HandlerDefinition<State>;
+/**
+ * Type guard: is this value a handler definition created by
+ * {@link defineHandler}?
+ */
+declare function isHandler(value: unknown): value is HandlerDefinition;
+
 /**
  * Endpoint definition types for Standard Agents.
  *
@@ -5646,6 +5801,8 @@ type DefinitionLoader<T> = () => Promise<T>;
  * ```
  */
 interface PackedExports {
+    /** Handler definitions, keyed by name */
+    handlers: Record<string, DefinitionLoader<HandlerDefinition>>;
     /** Agent definitions, keyed by name */
     agents: Record<string, DefinitionLoader<AgentDefinition>>;
     /** Prompt definitions, keyed by name */
@@ -5676,6 +5833,18 @@ interface PackedExports {
     /** Package metadata */
     __meta: PackedMeta;
 }
+/**
+ * Parse a potentially qualified name into package ID and short name.
+ *
+ * For scoped npm packages (starting with @), the format is @scope/pkg-name/item-name
+ * where @scope/pkg-name is the package and item-name is the short name.
+ *
+ * For non-scoped packages, the format is pkg-name/item-name.
+ *
+ * @param name - The name to parse (e.g., 'tool', 'pkg/tool', or '@scope/pkg/tool')
+ * @returns Tuple of [packageId, shortName] where packageId is null for unqualified names
+ */
+declare function parseQualifiedName(name: string): [string | null, string];
 
 /**
  * Hook definition types for Standard Agents.
@@ -5863,7 +6032,8 @@ interface HookSignatures<State = ThreadState, Msg = HookMessage, ToolCall = Hook
      * Called exactly once per model-context assembly on a stable snapshot of
      * eligible persisted history.
      *
-     * Receives raw message rows from storage before any transformation.
+     * Receives raw message rows from storage before any transformation:
+     * with the prompt's `historyLimit`, only its newest window of them.
      * Use for filtering, sorting, or augmenting message history.
      * The result is the request context and does not replace
      * `state.execution.messageHistory`. Messages injected while this hook runs
@@ -6253,131 +6423,6 @@ interface HookDefinitionResult<K extends HookName> {
  */
 declare function defineHook<K extends HookName>(options: HookDefinitionOptions<K>): HookDefinitionResult<K>;
 
-/**
- * Handler definition types for Standard Agents.
- *
- * A handler is a function that takes one side's turns in a conversation.
- * When a side of an agent is backed by a handler, the runtime does not call
- * a model to answer an inbound message — it calls the handler function once,
- * with the thread state and the message, and whatever that function does is
- * the side's turn.
- *
- * A handler is NOT a hook (hooks decorate turns owned by something else, and
- * their failures are non-fatal), NOT a tool (tools are capabilities a
- * turn-owner chooses to invoke), and NOT an effect (effects run outside the
- * conversation flow). Its only seat is backing a side of an agent: handlers
- * MUST NOT be referenced by prompt `tools` arrays, hook lists, or effect
- * schedules, and implementations MUST reject such references at definition
- * time.
- *
- * https://standardagentspec.com/0.2.0/specification/handlers
- *
- * @module
- */
-
-/**
- * Brand marking a value as a handler definition.
- *
- * The brand makes `HandlerDefinition` structurally unassignable to tool,
- * hook, and effect positions, so a handler referenced where those are
- * expected fails to compile wherever TypeScript can see the reference.
- * Implementations additionally reject by-name references that types cannot
- * catch during their definition-registry pass.
- */
-declare const HANDLER_SYMBOL: unique symbol;
-/**
- * A handler definition — deterministic code that owns one side's turns.
- *
- * Execution model (one turn):
- * 1. An inbound message arrives on the side's perspective.
- * 2. The runtime invokes `execute` once with the thread's `ThreadState` and
- *    that message.
- * 3. The invocation returns (or throws). The turn is complete.
- *
- * There are no steps, no tool-choice loop, and no model requests for a
- * handler-backed side. When the agent sets `maxSessionTurns`, a handler turn
- * counts toward the exchange cap exactly like a prompt turn.
- *
- * Delivery is exactly-once per message, in message persistence order, one
- * invocation at a time per thread; messages that arrive while a turn is in
- * flight wait in the queue. A failed invocation is never automatically
- * redelivered — retry is a userland decision.
- *
- * Errors are fatal to the turn, and only the turn: the turn is marked failed
- * as a runtime-origin failure, the inbound message stays persisted, and the
- * session continues. A handler ends sessions explicitly via
- * `state.stopSession()`.
- *
- * @template State - The thread state type (defaults to {@link ThreadState})
- */
-interface HandlerDefinition<State = ThreadState> {
-    /** Optional human-facing summary of what this handler does. */
-    readonly description?: string;
-    /**
-     * The turn implementation.
-     *
-     * Receives the full `ThreadState` — it may forward (`queueMessage` toward a
-     * child), respond (`injectMessage` as its own side's role), spawn children,
-     * stop the session, and read/write thread values: anything tools can do.
-     *
-     * The `message` parameter is the full persisted {@link Message} — id, role,
-     * content, silent flag, metadata, timestamps — not a narrowed view:
-     * handlers are trusted definition code, like tools.
-     *
-     * There is no auto-reply channel: the runtime routes inbound; userland
-     * decides outbound. If the handler wants to speak outward, that is code in
-     * this function.
-     */
-    readonly execute: (state: State, message: Message) => Promise<void>;
-    readonly [HANDLER_SYMBOL]: true;
-}
-/**
- * Options accepted by {@link defineHandler}.
- *
- * @template State - The thread state type (defaults to {@link ThreadState})
- */
-interface DefineHandlerOptions<State = ThreadState> {
-    /** Optional human-facing summary of what this handler does. */
-    readonly description?: string;
-    /** The turn implementation. See {@link HandlerDefinition.execute}. */
-    readonly execute: (state: State, message: Message) => Promise<void>;
-}
-/**
- * Defines a handler — deterministic code that backs one side of an agent and
- * takes that side's turns in place of a model.
- *
- * Handlers live in their own definition directory (`agents/handlers/` in the
- * conventional layout). The handler's name is derived from its file name and
- * referenced from exactly one place: the `handler` property of a side
- * configuration.
- *
- * @template State - The thread state type (defaults to {@link ThreadState})
- * @param options - Handler configuration options
- * @returns The branded handler definition for registration
- *
- * @example
- * ```typescript
- * // agents/handlers/relay_pipe.ts
- * import { defineHandler } from '@standardagents/spec';
- *
- * export default defineHandler({
- *   description: 'Forwards inbound user traffic to the assistant child and relays answers back.',
- *   execute: async (state, message) => {
- *     const assistant = state.children.find(c => c.relationship === 'assistant_agent');
- *     if (!assistant) return;
- *     const child = await state.getChildThread(assistant.reference);
- *     await child?.queueMessage({ role: 'user', content: message.content ?? '' });
- *   },
- * });
- * ```
- */
-declare function defineHandler<State = ThreadState>(options: DefineHandlerOptions<State>): HandlerDefinition<State>;
-/**
- * Type guard: is this value a handler definition created by
- * {@link defineHandler}?
- */
-declare function isHandler(value: unknown): value is HandlerDefinition;
-
 /**
  * Pure definition-time validation for Standard Agents.
  *
@@ -6398,7 +6443,7 @@ declare function isHandler(value: unknown): value is HandlerDefinition;
 /**
  * Every issue code `validateAgentDefinition` can emit.
  */
-declare const DEFINITION_ISSUE_CODES: readonly ["agent_name_missing", "agent_name_invalid", "agent_side_missing", "agent_side_invalid", "agent_side_backing_missing", "agent_side_backing_conflict", "agent_side_option_invalid_for_backing", "agent_subagents_on_human_side", "agent_both_sides_human", "agent_legacy_type", "agent_session_binding_legacy_string", "agent_session_binding_invalid", "agent_stop_tool_response_property_missing", "agent_max_steps_invalid", "agent_max_session_turns_invalid", "agent_tool_description_missing", "agent_parent_hooks_invalid", "agent_tenvs_deprecated", "subagent_agent_missing", "subagent_relationship_invalid", "subagent_relationship_duplicate", "subagent_relationship_reserved_name", "subagent_max_instances_invalid", "subagent_legacy_name", "subagent_legacy_resumable", "subagent_legacy_receives_messages"];
+declare const DEFINITION_ISSUE_CODES: readonly ["agent_name_missing", "agent_name_invalid", "agent_side_missing", "agent_side_invalid", "agent_side_backing_missing", "agent_side_backing_conflict", "agent_side_option_invalid_for_backing", "agent_subagents_on_human_side", "agent_both_sides_human", "agent_legacy_type", "agent_session_binding_legacy_string", "agent_session_binding_invalid", "agent_max_steps_invalid", "agent_stop_tool_missing", "agent_max_session_turns_invalid", "agent_tool_description_missing", "agent_parent_hooks_invalid", "agent_tenvs_deprecated", "subagent_agent_missing", "subagent_relationship_invalid", "subagent_relationship_duplicate", "subagent_relationship_reserved_name", "subagent_max_instances_invalid", "subagent_legacy_name", "subagent_legacy_resumable", "subagent_legacy_receives_messages"];
 /**
  * Union of all definition issue codes.
  */
@@ -6451,4 +6496,4 @@ declare function validateAgentDefinition(def: unknown): DefinitionIssue[];
  */
 declare const SPEC_VERSION = "0.2.0";
 
-export { type AgentDefinition, type AgentType, type AttachmentRef, type CodeExecution, type CodeExecutionError, type CodeExecutionLog, type CodeExecutionOptions, type CodeExecutionResult, type CodeExecutionStatus, type ContentPart, type Controller, type ControllerContext, type ControllerReturn, type CreateFetch, type CredentialGrant, DEFINITION_ISSUE_CODES, type DecideOptions, type DecisionAnswer, type DecisionAnswers, type DecisionBooleanAnswer, type DecisionChoiceAnswer, type DecisionContext, type DecisionJson, type DecisionProviderFactory, type DecisionProviderInterface, type DecisionQuestion, type DecisionQuestions, type DecisionRequest, type DecisionResult, type DecisionScoreAnswer, type DefineHandlerOptions, type DefineToolOptions, type DefinitionIssue, type DefinitionIssueCode, type DefinitionLoader, ENDPOINT_ACCESS_SYMBOL, type Effect, type EffectDefinition, type EmptyUsesState, type EndpointAccess, type EndpointOptions, type EnvValueType, type ErrorOrigin, type ExecutionState, type FetchLike, type FileChunk, type FilePart, type FileRecord, type FileStats, type FileStorage, type FindResult, type GetMessagesOptions, type GlobalNamespaceContext, type GrepResult, HANDLER_SYMBOL, type HandlerDefinition, type HandlerSide, type HookContext, type HookDefinition, type HookDefinitionOptions, type HookDefinitionResult, type HookExecutionContext, type HookExecutionSource, type HookMessage, type HookName, type HookSignatures, type HookToolCall, type HookToolResult, type HumanSide, type ImageContent, type ImagePart, type ImageUrlPart, type InferProviderOptions, type InjectMessageInput, type InspectedRequest, type LLMMessage, type LLMProviderInterface, type ListUserThreadsOptions, type ListUserValuesOptions, type MarkedThreadEndpoint, type MarkedUserEndpoint, type MarkedUserRoom, type Message, type MessageUpdates, type MessagesResult, type ModelCapabilities, type ModelDefinition, type ModelProvider, type NamespaceContext, type PackageSignature, type PackedExports, type PackedMeta, type PackedMetadata, type PackedNamespaceContext, type ParentHookRequirement, type ParentHookStage, type PromptContent, type PromptDefinition, type PromptEnvPart, type PromptIncludePart, type PromptInput, type PromptPart, type PromptSide, type PromptTextPart, type PromptToolConfig, type ProviderAssistantMessage, type ProviderAttachment, type ProviderConfigSlot, type ProviderConfigSlots, type ProviderConfigValueSource, type ProviderDefinition, ProviderError, type ProviderErrorCode, type ProviderErrorOptions, type ProviderExecutedToolResult, type ProviderFactory, type ProviderFactoryConfig, type ProviderFactoryWithOptions, type ProviderFinishReason, type ProviderGeneratedImage, type ProviderInstance, type ProviderMessage, type ProviderMessageContent, type ProviderMethodOverrides, type ProviderModelInfo, type ProviderModelsPage, type ProviderModelsQuery, type ProviderOverride, type ProviderOverrideContext, type ProviderReasoningDetail, type ProviderRequest, type ProviderResponse, type ProviderStreamChunk, type ProviderSyncOverride, type ProviderSystemMessage, type ProviderTool, type ProviderToolCallPart, type ProviderToolMessage, type ProviderToolResultContent, type ProviderUsage, type ProviderUsagePricing, type ProviderUserMessage, type ProviderWebSearchResult, type QueueMessageInput, RESERVED_RELATIONSHIP_NAMES, type ReadFileStreamOptions, type ReaddirResult, type ReasoningConfig, type ResolveUsesState, type ResponseSummary, type RuntimeByteStream, type RuntimeStreamErrorCode, type RuntimeStreamRequest, type RuntimeStreamResult, type RuntimeStreams, SPEC_VERSION, type ScheduledEffect, type SessionToolBinding, type SessionToolConfig, type SetEnvOptions, type SideConfig, type SkillFileInput, type SkillMetadata, type SkillsNamespace, type StopSessionOptions, type StructuredPrompt, type SubagentRegistryEntry, type SubagentRelationship, type SubagentToolConfig, type SubpromptConfig, THREAD_ENDPOINT_SYMBOL, THREAD_STREAM_REASONING_PARAM, type TenvRawShape, type TextContent, type TextPart, type ThreadEndpointAuth, type ThreadEndpointHandler, type ThreadEndpointRouteParams, type ThreadHookName, type ThreadMessageChunkEvent, type ThreadMetadata, type ThreadReasoningChunkEvent, type ThreadRunState, type ThreadState, type ThreadStatus, type ThreadStatusEvent, type ThreadUser, type Tool, type ToolArgs, type ToolArgsNode, type ToolArgsRawShape, type ToolAttachment, type ToolConfig, type ToolContent, type ToolDefinition, type ToolResult, type ToolTenvs, type ToolVariables, USER_ENDPOINT_SYMBOL, USER_ROOM_SYMBOL, type UserClientInfo, type UserEndpointHandler, type UserEndpointRouteParams, type UserHandle, type UserIdentity, type UserRoomAttachments, type UserRoomConnection, type UserRoomDefinition, type UserRoomFrame, type UserRoomPresenceEvent, type UserState, type UserThreadSummary, type UserValueEntry, type UsesAwareExecute, type UsesConstrainedState, type VariableDefinition, type VariableType, type VirtualModuleLoader, type VirtualModuleRegistry, type WriteFileOptions, belongsToPackage, decide, defineAgent, defineController, defineEffect, defineHandler, defineHook, defineModel, definePrompt, defineProvider, defineThreadEndpoint, defineTool, defineUserEndpoint, defineUserRoom, getEndpointAccess, isHandler, isPacked, isThreadEndpoint, isUserEndpoint, isUserRoom, isVisibleInNamespace, mapReasoningLevel, providerConst, providerEnv, providerValue, validateAgentDefinition, validateToolName };
+export { type AgentDefinition, type AgentType, type AttachmentRef, type CodeExecution, type CodeExecutionError, type CodeExecutionLog, type CodeExecutionOptions, type CodeExecutionResult, type CodeExecutionStatus, type ContentPart, type Controller, type ControllerContext, type ControllerReturn, type CreateFetch, type CredentialGrant, DEFINITION_ISSUE_CODES, type DecideOptions, type DecisionAnswer, type DecisionAnswers, type DecisionBooleanAnswer, type DecisionChoiceAnswer, type DecisionContext, type DecisionJson, type DecisionProviderFactory, type DecisionProviderInterface, type DecisionQuestion, type DecisionQuestions, type DecisionRequest, type DecisionResult, type DecisionScoreAnswer, type DefineHandlerOptions, type DefineToolOptions, type DefinitionIssue, type DefinitionIssueCode, type DefinitionLoader, ENDPOINT_ACCESS_SYMBOL, type Effect, type EffectDefinition, type EmptyUsesState, type EndpointAccess, type EndpointOptions, type EnvValueType, type ErrorOrigin, type ExecutionState, type FetchLike, type FileChunk, type FilePart, type FileRecord, type FileStats, type FileStorage, type FindResult, type GetMessagesOptions, type GlobalNamespaceContext, type GrepResult, HANDLER_SYMBOL, type HandlerDefinition, type HandlerSide, type HookContext, type HookDefinition, type HookDefinitionOptions, type HookDefinitionResult, type HookExecutionContext, type HookExecutionSource, type HookMessage, type HookName, type HookSignatures, type HookToolCall, type HookToolResult, type HumanSide, type ImageContent, type ImagePart, type ImageUrlPart, type InferProviderOptions, type InjectMessageInput, type InspectedRequest, type LLMMessage, type LLMProviderInterface, type ListUserThreadsOptions, type ListUserValuesOptions, type MarkedThreadEndpoint, type MarkedUserEndpoint, type MarkedUserRoom, type Message, type MessageUpdates, type MessagesResult, type ModelCapabilities, type ModelDefinition, type ModelProvider, type NamespaceContext, type PackageSignature, type PackedExports, type PackedMeta, type PackedMetadata, type PackedNamespaceContext, type ParentHookRequirement, type ParentHookStage, type PromptContent, type PromptDefinition, type PromptEnvPart, type PromptIncludePart, type PromptInput, type PromptPart, type PromptSide, type PromptTextPart, type PromptToolConfig, type ProviderAssistantMessage, type ProviderAttachment, type ProviderConfigSlot, type ProviderConfigSlots, type ProviderConfigValueSource, type ProviderDefinition, ProviderError, type ProviderErrorCode, type ProviderErrorOptions, type ProviderExecutedToolResult, type ProviderFactory, type ProviderFactoryConfig, type ProviderFactoryWithOptions, type ProviderFinishReason, type ProviderGeneratedImage, type ProviderInstance, type ProviderMessage, type ProviderMessageContent, type ProviderMethodOverrides, type ProviderModelInfo, type ProviderModelsPage, type ProviderModelsQuery, type ProviderOverride, type ProviderOverrideContext, type ProviderReasoningDetail, type ProviderRequest, type ProviderResponse, type ProviderStreamChunk, type ProviderSyncOverride, type ProviderSystemMessage, type ProviderTool, type ProviderToolCallPart, type ProviderToolMessage, type ProviderToolResultContent, type ProviderUsage, type ProviderUsagePricing, type ProviderUserMessage, type ProviderWebSearchResult, type QueueMessageInput, RESERVED_RELATIONSHIP_NAMES, type ReadFileStreamOptions, type ReaddirResult, type ReasoningConfig, type ResolveUsesState, type ResponseSummary, type RuntimeByteStream, type RuntimeStreamErrorCode, type RuntimeStreamRequest, type RuntimeStreamResult, type RuntimeStreams, SPEC_VERSION, type ScheduledEffect, type SessionToolBinding, type SessionToolConfig, type SetEnvOptions, type SideConfig, type SkillFileInput, type SkillMetadata, type SkillsNamespace, type StopSessionOptions, type StructuredPrompt, type SubagentRegistryEntry, type SubagentRelationship, type SubagentToolConfig, type SubpromptConfig, THREAD_ENDPOINT_SYMBOL, THREAD_STREAM_REASONING_PARAM, type TenvRawShape, type TextContent, type TextPart, type ThreadEndpointAuth, type ThreadEndpointHandler, type ThreadEndpointRouteParams, type ThreadHookName, type ThreadMessageChunkEvent, type ThreadMetadata, type ThreadReasoningChunkEvent, type ThreadRunState, type ThreadState, type ThreadStatus, type ThreadStatusEvent, type ThreadUser, type Tool, type ToolAnnotations, type ToolArgs, type ToolArgsNode, type ToolArgsRawShape, type ToolAttachment, type ToolConfig, type ToolContent, type ToolDefinition, type ToolResult, type ToolTenvs, type ToolVariables, USER_ENDPOINT_SYMBOL, USER_ROOM_SYMBOL, type UserClientInfo, type UserEndpointHandler, type UserEndpointRouteParams, type UserHandle, type UserIdentity, type UserRoomAttachments, type UserRoomConnection, type UserRoomDefinition, type UserRoomFrame, type UserRoomPresenceEvent, type UserState, type UserThreadSummary, type UserValueEntry, type UsesAwareExecute, type UsesConstrainedState, type VariableDefinition, type VariableType, type VirtualModuleLoader, type VirtualModuleRegistry, type WriteFileOptions, belongsToPackage, decide, defineAgent, defineController, defineEffect, defineHandler, defineHook, defineModel, definePrompt, defineProvider, defineThreadEndpoint, defineTool, defineUserEndpoint, defineUserRoom, getEndpointAccess, isHandler, isPacked, isThreadEndpoint, isUserEndpoint, isUserRoom, isVisibleInNamespace, mapReasoningLevel, parseQualifiedName, providerConst, providerEnv, providerValue, resolveRequestReasoningLevels, validateAgentDefinition, validateToolName };