@keystrokehq/keystroke 0.0.99 → 0.0.101

package/dist/agent.d.cts

@@ -1,275 +1,4 @@
-import { c as CredentialRunContext, h as OAuthTokenAdapter } from "./index-CiuCYKLw.cjs";
-import { a as AgentState, i as AgentMessage, l as ThinkingLevel, n as AgentOptions, o as AgentTool, p as Model, t as Agent$1, u as getModel } from "./index-BcMCpDKh.cjs";
-import { n as ActionDefinition } from "./index-CfK7yBQI.cjs";
+import { l as ThinkingLevel, u as getModel } from "./index-BcMCpDKh.cjs";
+import { A as messages, B as AgentCreateInputSchema, C as createAgent, D as errorMessage, E as defineTool, F as resolveAgentTools, G as parseAgentCreateInput, H as ModelRef, I as resolveAgentWorkspaceRoot, K as resolveThinkingLevel, L as runAgentPrompt, M as prepareAgentSession, N as prompt, O as getSubagentToolMetadata, P as resolveAgentAssets, R as snapshot, S as buildAgentRuntime, T as defineSubagentTool, U as ModelRefSchema, V as DEFAULT_THINKING_LEVEL, W as ThinkingLevelSchema, _ as SessionAgentMismatchError, a as AgentDefinitionInput, b as SubagentToolInherit, c as BuildAgentRuntimeContext, d as PromptInput, f as PromptResponse, g as SandboxedAgentRuntime, h as SUBAGENT_TOOL, i as AgentDefinition, j as normalizeAgentDefinition, k as loadAssetManifest, l as DefineAgentOptions, m as RunAgentPromptOptions, n as AgentAssetInput, o as AgentRuntime, p as ResolvedAgentAssets, r as AgentConfig, s as AgentSnapshot, t as Agent, u as DefineSubagentToolInput, v as SubagentTool, w as defineAgent, x as SubagentToolMetadata, y as SubagentToolDetails, z as AgentCreateInput } from "./index-L5a2mf72.cjs";
 import { a as McpDefinition, c as McpServerOptions, d as McpTransport, f as connectMcpDefinition, g as isMcp, h as defineMcp, i as McpConnection, l as McpStdioOptions, m as connectMcpStdio, n as McpAuthOptions, o as McpDefinitionInput, p as connectMcpServer, r as McpCallToolOptions, s as McpHttpTransport, t as ToolCredentialResolver, u as McpStdioTransport } from "./index-MfPRY7cK.cjs";
-import { C as AssetManifest, T as SandboxDefinition, a as RuntimeHooks, c as SkillDefinition, o as RuntimeProvider, s as Sandbox } from "./index-B61sMU7a.cjs";
-import { z } from "zod";
-import { DatabaseSync } from "node:sqlite";
-
-//#region ../agent/dist/schemas.d.mts
-//#region src/schemas.d.ts
-/** Wire-format model reference — resolve with `getModel(provider, id)`. */
-declare const ModelRefSchema: z.ZodObject<{
-  provider: z.ZodString;
-  id: z.ZodString;
-}, z.core.$strip>;
-declare const ThinkingLevelSchema: z.ZodEnum<{
-  off: "off";
-  minimal: "minimal";
-  low: "low";
-  medium: "medium";
-  high: "high";
-  xhigh: "xhigh";
-}>;
-declare const DEFAULT_THINKING_LEVEL: "medium";
-/** Serializable subset of {@link AgentConfig} for JSON/env/CLI boundaries. */
-declare const AgentCreateInputSchema: z.ZodObject<{
-  systemPrompt: z.ZodString;
-  model: z.ZodObject<{
-    provider: z.ZodString;
-    id: z.ZodString;
-  }, z.core.$strip>;
-  thinkingLevel: z.ZodOptional<z.ZodEnum<{
-    off: "off";
-    minimal: "minimal";
-    low: "low";
-    medium: "medium";
-    high: "high";
-    xhigh: "xhigh";
-  }>>;
-}, z.core.$strip>;
-type ModelRef = z.infer<typeof ModelRefSchema>;
-type AgentCreateInput = z.infer<typeof AgentCreateInputSchema>;
-declare function parseAgentCreateInput(input: unknown): AgentCreateInput;
-declare function resolveThinkingLevel(level?: ThinkingLevel): ThinkingLevel; //#endregion
-//#endregion
-//#region ../memory/dist/index.d.mts
-//#region src/config.d.ts
-type MemoryConfig = {
-  enabled: boolean;
-  dir: string;
-  memoryFile: string;
-  userFile: string;
-  archiveDir: string;
-  dbFile: string;
-  sessionsDir: string;
-  memoryCharLimit: number;
-  userCharLimit: number;
-  archiveTocLimit: number;
-  securityScan: boolean;
-};
-//#endregion
-//#region src/prepare.d.ts
-type MemoryHandle = {
-  config: MemoryConfig;
-  db: DatabaseSync;
-  reindexSessions: () => void;
-  close: () => void;
-};
-type MemoryOptions = false | Partial<MemoryConfig>;
-//#endregion
-//#region ../agent/dist/index.d.mts
-//#region src/agent.d.ts
-type AgentConfig = {
-  systemPrompt: string;
-  model: Model<string>;
-  thinkingLevel?: ThinkingLevel;
-  messages?: AgentMessage[];
-  tools?: AgentTool[];
-} & Omit<AgentOptions, "initialState">;
-type AgentRuntime = Readonly<{
-  pi: Agent$1;
-}>;
-type AgentSnapshot = Readonly<{
-  state: AgentState;
-}>;
-declare function createAgent(config: AgentConfig): AgentRuntime;
-declare function prompt(runtime: AgentRuntime, message: string): Promise<AgentSnapshot>;
-declare function snapshot(runtime: AgentRuntime): AgentSnapshot;
-declare function messages(snapshot: AgentSnapshot): AgentMessage[];
-declare function errorMessage(snapshot: AgentSnapshot): string | undefined; //#endregion
-//#region src/tool.d.ts
-declare function defineTool<T extends AgentTool>(tool: T): T; //#endregion
-//#region src/define/types.d.ts
-/** MCP defs vary by credential shape at authoring time. */
-type AgentMcpTool = McpDefinition<any>;
-/** Author-facing agent input — asset keys resolve from src/skills/ and src/files/. */
-type AgentDefinitionAuthorInput = AgentCreateInput & {
-  tools?: Array<ActionDefinition | AgentTool | AgentMcpTool>;
-  runtimeHooks?: RuntimeHooks; /** Skill folder names under `src/skills/{key}/`. */
-  skills?: string[]; /** `true` uses agent `{ key }`; string uses `src/files/{setKey}/`. */
-  files?: boolean | string; /** Advanced inline or shared sandbox layout. Merged with resolved `files`. */
-  sandbox?: SandboxDefinition;
-  runtimeProvider?: RuntimeProvider; /** Persistent memory (default on). Pass `false` to disable. */
-  memory?: MemoryOptions;
-};
-/** Input to {@link defineAgent}. */
-type AgentDefinitionInput = AgentDefinitionAuthorInput;
-/** Normalized agent definition used by the server (defaults applied). */
-type AgentDefinition = AgentCreateInput & {
-  tools?: Array<ActionDefinition | AgentTool | AgentMcpTool>;
-  runtimeHooks?: RuntimeHooks;
-  sandbox?: SandboxDefinition;
-  skills?: SkillDefinition[];
-  runtimeProvider?: RuntimeProvider;
-  memory?: MemoryOptions;
-};
-type PromptInput = {
-  message: string;
-  sessionId?: string;
-  subscriptionId?: string;
-  context?: CredentialRunContext;
-};
-/** Server-level overrides when mounting an agent or calling {@link Agent.prompt}. */
-type RunAgentPromptOptions = {
-  workspacesRoot?: string;
-  /**
-   * Explicit host root backing `/workspace`.
-   * When set (typically by a workflow action), the agent's own `sandbox` definition is not materialized.
-   */
-  workspaceRoot?: string; /** Overrides {@link AgentDefinition.runtimeProvider} for this call. */
-  runtimeProvider?: RuntimeProvider;
-  runtimeHooks?: RuntimeHooks;
-  credentials?: CredentialRunContext;
-  oauthAdapter?: OAuthTokenAdapter;
-  memory?: MemoryOptions; /** Overrides {@link AgentDefinition.thinkingLevel} for this call. */
-  thinkingLevel?: ThinkingLevel;
-  tracing?: {
-    trigger?: "api" | "gateway" | "subagent" | "workflow";
-    gatewayAttachmentId?: string;
-    gatewayAttachmentKey?: string;
-    agentKey?: string;
-  }; /** When set by {@link withManualAgentTrace}, skips the outer agent_session span. */
-  skipAgentSessionSpan?: boolean;
-  invocationRoute?: string;
-};
-type PromptResponse = {
-  sessionId: string;
-  messages: AgentMessage[];
-  error: string | null;
-}; //#endregion
-//#region src/define/build-agent-runtime.d.ts
-type BuildAgentRuntimeContext = {
-  agentId: string;
-  sessionId: string;
-  messages?: AgentMessage[];
-};
-/** Pi agent plus sandbox — dispose {@link SandboxedAgentRuntime.sandbox} after each prompt. */
-type SandboxedAgentRuntime = AgentRuntime & {
-  sandbox: Sandbox;
-  tools: AgentTool[];
-  mcpConnections: McpConnection[];
-  workspaceRoot: string;
-  memory?: MemoryHandle;
-  takeCredentialError?: () => unknown;
-};
-/** Sandbox tools + host tools → pi agent from a {@link AgentDefinition}. */
-declare function buildAgentRuntime(def: AgentDefinition, ctx: BuildAgentRuntimeContext, runPrompt?: RunAgentPromptOptions): Promise<SandboxedAgentRuntime>; //#endregion
-//#region src/define/define-agent.d.ts
-type DefineAgentOptions = {
-  /** Discovery key — resolves agentId from the DB registry after createServer sync. */key?: string; /** Server overrides for sandbox/workspace when prompting. */
-  runPrompt?: RunAgentPromptOptions; /** Agent module URL (`import.meta.url`) — resolves `src/skills/` and `src/files/` in dev. */
-  module?: string;
-};
-type Agent = AgentDefinition & {
-  /** Discovery and route id for this agent (`POST /agents/{key}`). */key: string; /** Per-request pi agent + sandbox from this definition. */
-  buildRuntime: (ctx: BuildAgentRuntimeContext, runPrompt?: RunAgentPromptOptions) => Promise<SandboxedAgentRuntime>;
-  prompt(input: {
-    message: string;
-    sessionId?: string;
-    agentId?: string;
-  }, runPrompt?: RunAgentPromptOptions): Promise<PromptResponse>;
-};
-/**
- * Define an agent: normalized config plus a pipeline that builds sandbox + pi runtime on demand.
- */
-declare function defineAgent(input: AgentDefinitionInput, options?: DefineAgentOptions): Agent; //#endregion
-//#region src/define/define-subagent-tool.d.ts
-declare const SUBAGENT_TOOL: unique symbol;
-/** Reserved for parent→child passthrough (credentials, workspace, etc.). Not wired yet. */
-type SubagentToolInherit = {
-  credentials?: boolean;
-  workspace?: boolean;
-};
-type SubagentToolMetadata = {
-  agent: Agent;
-  inherit?: SubagentToolInherit;
-};
-type SubagentToolDetails = {
-  sessionId: string;
-  error: string | null;
-};
-type SubagentTool = AgentTool & {
-  [SUBAGENT_TOOL]: SubagentToolMetadata;
-};
-type DefineSubagentToolInput = {
-  agent: Agent;
-  name: string;
-  label: string;
-  description?: string;
-  parameters: AgentTool["parameters"];
-  inherit?: SubagentToolInherit; /** Defaults to `params.message`. Override when tool params use a different shape. */
-  toMessage?: (params: unknown) => string;
-};
-declare function getSubagentToolMetadata(tool: AgentTool): SubagentToolMetadata | undefined;
-declare function defineSubagentTool(input: DefineSubagentToolInput): SubagentTool; //#endregion
-//#region src/define/run-prompt.d.ts
-declare function runAgentPrompt(agent: Agent, agentId: string, input: {
-  message: string;
-  sessionId?: string;
-  context?: RunAgentPromptOptions["credentials"];
-}, options?: RunAgentPromptOptions): Promise<PromptResponse>;
-declare class SessionAgentMismatchError extends Error {
-  constructor(sessionId: string);
-} //#endregion
-//#region src/define/prepare-session.d.ts
-declare function prepareAgentSession(agentId: string, sessionId?: string): Promise<{
-  sessionId: string;
-}>; //#endregion
-//#region src/define/normalize-definition.d.ts
-/** Normalizes optional agent fields for the server runtime. */
-declare function normalizeAgentDefinition(input: AgentDefinitionInput, options?: {
-  agentKey?: string;
-  appRoot?: string;
-  module?: string;
-}): AgentDefinition; //#endregion
-//#region src/define/resolve-agent-workspace-root.d.ts
-/**
- * Resolve the host directory backing `/workspace` for an agent prompt.
- *
- * Precedence:
- * 1. Explicit `workspaceRoot` override (workflow handoff) — skips agent sandbox materialization.
- * 2. Agent `sandbox` definition — materialize to `{workspacesRoot}/{agentId}/`.
- * 3. Default agent dir — `{workspacesRoot}/{agentId}/`.
- *
- * Agent skills always materialize into the resolved workspace when configured.
- */
-declare function resolveAgentWorkspaceRoot(agentId: string, options: {
-  workspacesRoot?: string;
-  workspaceRoot?: string;
-  sandbox?: SandboxDefinition;
-  skills?: SkillDefinition[];
-}): Promise<string>; //#endregion
-//#region src/define/resolve-agent-assets.d.ts
-type AgentAssetInput = {
-  skillKeys?: string[];
-  files?: boolean | string;
-  agentKey?: string;
-  appRoot?: string;
-};
-type ResolvedAgentAssets = {
-  skills?: SkillDefinition[];
-  sandbox?: SandboxDefinition;
-};
-declare function loadAssetManifest(appRoot: string): AssetManifest;
-/** Resolve author-facing skill/file keys into packed sandbox + skill definitions. */
-declare function resolveAgentAssets(input: AgentAssetInput): ResolvedAgentAssets; //#endregion
-//#region src/define/resolve-tools.d.ts
-type ResolvedAgentTools = {
-  tools: AgentTool[];
-  mcpConnections: McpConnection[];
-};
-declare function resolveAgentTools(tools: Array<ActionDefinition | AgentTool | AgentMcpTool>, resolver: ToolCredentialResolver): Promise<ResolvedAgentTools>; //#endregion
-//#endregion
-export { type Agent, type AgentAssetInput, type AgentConfig, type AgentCreateInput, AgentCreateInputSchema, type AgentDefinition, type AgentDefinitionInput, type AgentRuntime, type AgentSnapshot, type BuildAgentRuntimeContext, DEFAULT_THINKING_LEVEL, type DefineAgentOptions, type DefineSubagentToolInput, type McpAuthOptions, type McpCallToolOptions, type McpConnection, type McpDefinition, type McpDefinitionInput, type McpHttpTransport, type McpServerOptions, type McpStdioOptions, type McpStdioTransport, type McpTransport, type ModelRef, ModelRefSchema, type PromptInput, type PromptResponse, type ResolvedAgentAssets, type RunAgentPromptOptions, SUBAGENT_TOOL, type SandboxedAgentRuntime, SessionAgentMismatchError, type SubagentTool, type SubagentToolDetails, type SubagentToolInherit, type SubagentToolMetadata, type ThinkingLevel, ThinkingLevelSchema, type ToolCredentialResolver, buildAgentRuntime, connectMcpDefinition, connectMcpServer, connectMcpStdio, createAgent, defineAgent, defineMcp, defineSubagentTool, defineTool, errorMessage, getModel, getSubagentToolMetadata, isMcp, loadAssetManifest, messages, normalizeAgentDefinition, parseAgentCreateInput, prepareAgentSession, prompt, resolveAgentAssets, resolveAgentTools, resolveAgentWorkspaceRoot, resolveThinkingLevel, runAgentPrompt, snapshot };
-//# sourceMappingURL=agent.d.cts.map
+export { type Agent, type AgentAssetInput, type AgentConfig, type AgentCreateInput, AgentCreateInputSchema, type AgentDefinition, type AgentDefinitionInput, type AgentRuntime, type AgentSnapshot, type BuildAgentRuntimeContext, DEFAULT_THINKING_LEVEL, type DefineAgentOptions, type DefineSubagentToolInput, type McpAuthOptions, type McpCallToolOptions, type McpConnection, type McpDefinition, type McpDefinitionInput, type McpHttpTransport, type McpServerOptions, type McpStdioOptions, type McpStdioTransport, type McpTransport, type ModelRef, ModelRefSchema, type PromptInput, type PromptResponse, type ResolvedAgentAssets, type RunAgentPromptOptions, SUBAGENT_TOOL, type SandboxedAgentRuntime, SessionAgentMismatchError, type SubagentTool, type SubagentToolDetails, type SubagentToolInherit, type SubagentToolMetadata, type ThinkingLevel, ThinkingLevelSchema, type ToolCredentialResolver, buildAgentRuntime, connectMcpDefinition, connectMcpServer, connectMcpStdio, createAgent, defineAgent, defineMcp, defineSubagentTool, defineTool, errorMessage, getModel, getSubagentToolMetadata, isMcp, loadAssetManifest, messages, normalizeAgentDefinition, parseAgentCreateInput, prepareAgentSession, prompt, resolveAgentAssets, resolveAgentTools, resolveAgentWorkspaceRoot, resolveThinkingLevel, runAgentPrompt, snapshot };

package/dist/agent.d.mts

@@ -1,275 +1,4 @@
-import { c as CredentialRunContext, h as OAuthTokenAdapter } from "./index-CiuCYKLw.mjs";
-import { a as AgentState, i as AgentMessage, l as ThinkingLevel, n as AgentOptions, o as AgentTool, p as Model, t as Agent$1, u as getModel } from "./index-Bd_asjgz.mjs";
-import { n as ActionDefinition } from "./index-by6PXA-8.mjs";
+import { l as ThinkingLevel, u as getModel } from "./index-Bd_asjgz.mjs";
+import { A as messages, B as AgentCreateInputSchema, C as createAgent, D as errorMessage, E as defineTool, F as resolveAgentTools, G as parseAgentCreateInput, H as ModelRef, I as resolveAgentWorkspaceRoot, K as resolveThinkingLevel, L as runAgentPrompt, M as prepareAgentSession, N as prompt, O as getSubagentToolMetadata, P as resolveAgentAssets, R as snapshot, S as buildAgentRuntime, T as defineSubagentTool, U as ModelRefSchema, V as DEFAULT_THINKING_LEVEL, W as ThinkingLevelSchema, _ as SessionAgentMismatchError, a as AgentDefinitionInput, b as SubagentToolInherit, c as BuildAgentRuntimeContext, d as PromptInput, f as PromptResponse, g as SandboxedAgentRuntime, h as SUBAGENT_TOOL, i as AgentDefinition, j as normalizeAgentDefinition, k as loadAssetManifest, l as DefineAgentOptions, m as RunAgentPromptOptions, n as AgentAssetInput, o as AgentRuntime, p as ResolvedAgentAssets, r as AgentConfig, s as AgentSnapshot, t as Agent, u as DefineSubagentToolInput, v as SubagentTool, w as defineAgent, x as SubagentToolMetadata, y as SubagentToolDetails, z as AgentCreateInput } from "./index-CBgXyNH2.mjs";
 import { a as McpDefinition, c as McpServerOptions, d as McpTransport, f as connectMcpDefinition, g as isMcp, h as defineMcp, i as McpConnection, l as McpStdioOptions, m as connectMcpStdio, n as McpAuthOptions, o as McpDefinitionInput, p as connectMcpServer, r as McpCallToolOptions, s as McpHttpTransport, t as ToolCredentialResolver, u as McpStdioTransport } from "./index-ptRM3z9H.mjs";
-import { C as AssetManifest, T as SandboxDefinition, a as RuntimeHooks, c as SkillDefinition, o as RuntimeProvider, s as Sandbox } from "./index-BbMesmXS.mjs";
-import { z } from "zod";
-import { DatabaseSync } from "node:sqlite";
-
-//#region ../agent/dist/schemas.d.mts
-//#region src/schemas.d.ts
-/** Wire-format model reference — resolve with `getModel(provider, id)`. */
-declare const ModelRefSchema: z.ZodObject<{
-  provider: z.ZodString;
-  id: z.ZodString;
-}, z.core.$strip>;
-declare const ThinkingLevelSchema: z.ZodEnum<{
-  off: "off";
-  minimal: "minimal";
-  low: "low";
-  medium: "medium";
-  high: "high";
-  xhigh: "xhigh";
-}>;
-declare const DEFAULT_THINKING_LEVEL: "medium";
-/** Serializable subset of {@link AgentConfig} for JSON/env/CLI boundaries. */
-declare const AgentCreateInputSchema: z.ZodObject<{
-  systemPrompt: z.ZodString;
-  model: z.ZodObject<{
-    provider: z.ZodString;
-    id: z.ZodString;
-  }, z.core.$strip>;
-  thinkingLevel: z.ZodOptional<z.ZodEnum<{
-    off: "off";
-    minimal: "minimal";
-    low: "low";
-    medium: "medium";
-    high: "high";
-    xhigh: "xhigh";
-  }>>;
-}, z.core.$strip>;
-type ModelRef = z.infer<typeof ModelRefSchema>;
-type AgentCreateInput = z.infer<typeof AgentCreateInputSchema>;
-declare function parseAgentCreateInput(input: unknown): AgentCreateInput;
-declare function resolveThinkingLevel(level?: ThinkingLevel): ThinkingLevel; //#endregion
-//#endregion
-//#region ../memory/dist/index.d.mts
-//#region src/config.d.ts
-type MemoryConfig = {
-  enabled: boolean;
-  dir: string;
-  memoryFile: string;
-  userFile: string;
-  archiveDir: string;
-  dbFile: string;
-  sessionsDir: string;
-  memoryCharLimit: number;
-  userCharLimit: number;
-  archiveTocLimit: number;
-  securityScan: boolean;
-};
-//#endregion
-//#region src/prepare.d.ts
-type MemoryHandle = {
-  config: MemoryConfig;
-  db: DatabaseSync;
-  reindexSessions: () => void;
-  close: () => void;
-};
-type MemoryOptions = false | Partial<MemoryConfig>;
-//#endregion
-//#region ../agent/dist/index.d.mts
-//#region src/agent.d.ts
-type AgentConfig = {
-  systemPrompt: string;
-  model: Model<string>;
-  thinkingLevel?: ThinkingLevel;
-  messages?: AgentMessage[];
-  tools?: AgentTool[];
-} & Omit<AgentOptions, "initialState">;
-type AgentRuntime = Readonly<{
-  pi: Agent$1;
-}>;
-type AgentSnapshot = Readonly<{
-  state: AgentState;
-}>;
-declare function createAgent(config: AgentConfig): AgentRuntime;
-declare function prompt(runtime: AgentRuntime, message: string): Promise<AgentSnapshot>;
-declare function snapshot(runtime: AgentRuntime): AgentSnapshot;
-declare function messages(snapshot: AgentSnapshot): AgentMessage[];
-declare function errorMessage(snapshot: AgentSnapshot): string | undefined; //#endregion
-//#region src/tool.d.ts
-declare function defineTool<T extends AgentTool>(tool: T): T; //#endregion
-//#region src/define/types.d.ts
-/** MCP defs vary by credential shape at authoring time. */
-type AgentMcpTool = McpDefinition<any>;
-/** Author-facing agent input — asset keys resolve from src/skills/ and src/files/. */
-type AgentDefinitionAuthorInput = AgentCreateInput & {
-  tools?: Array<ActionDefinition | AgentTool | AgentMcpTool>;
-  runtimeHooks?: RuntimeHooks; /** Skill folder names under `src/skills/{key}/`. */
-  skills?: string[]; /** `true` uses agent `{ key }`; string uses `src/files/{setKey}/`. */
-  files?: boolean | string; /** Advanced inline or shared sandbox layout. Merged with resolved `files`. */
-  sandbox?: SandboxDefinition;
-  runtimeProvider?: RuntimeProvider; /** Persistent memory (default on). Pass `false` to disable. */
-  memory?: MemoryOptions;
-};
-/** Input to {@link defineAgent}. */
-type AgentDefinitionInput = AgentDefinitionAuthorInput;
-/** Normalized agent definition used by the server (defaults applied). */
-type AgentDefinition = AgentCreateInput & {
-  tools?: Array<ActionDefinition | AgentTool | AgentMcpTool>;
-  runtimeHooks?: RuntimeHooks;
-  sandbox?: SandboxDefinition;
-  skills?: SkillDefinition[];
-  runtimeProvider?: RuntimeProvider;
-  memory?: MemoryOptions;
-};
-type PromptInput = {
-  message: string;
-  sessionId?: string;
-  subscriptionId?: string;
-  context?: CredentialRunContext;
-};
-/** Server-level overrides when mounting an agent or calling {@link Agent.prompt}. */
-type RunAgentPromptOptions = {
-  workspacesRoot?: string;
-  /**
-   * Explicit host root backing `/workspace`.
-   * When set (typically by a workflow action), the agent's own `sandbox` definition is not materialized.
-   */
-  workspaceRoot?: string; /** Overrides {@link AgentDefinition.runtimeProvider} for this call. */
-  runtimeProvider?: RuntimeProvider;
-  runtimeHooks?: RuntimeHooks;
-  credentials?: CredentialRunContext;
-  oauthAdapter?: OAuthTokenAdapter;
-  memory?: MemoryOptions; /** Overrides {@link AgentDefinition.thinkingLevel} for this call. */
-  thinkingLevel?: ThinkingLevel;
-  tracing?: {
-    trigger?: "api" | "gateway" | "subagent" | "workflow";
-    gatewayAttachmentId?: string;
-    gatewayAttachmentKey?: string;
-    agentKey?: string;
-  }; /** When set by {@link withManualAgentTrace}, skips the outer agent_session span. */
-  skipAgentSessionSpan?: boolean;
-  invocationRoute?: string;
-};
-type PromptResponse = {
-  sessionId: string;
-  messages: AgentMessage[];
-  error: string | null;
-}; //#endregion
-//#region src/define/build-agent-runtime.d.ts
-type BuildAgentRuntimeContext = {
-  agentId: string;
-  sessionId: string;
-  messages?: AgentMessage[];
-};
-/** Pi agent plus sandbox — dispose {@link SandboxedAgentRuntime.sandbox} after each prompt. */
-type SandboxedAgentRuntime = AgentRuntime & {
-  sandbox: Sandbox;
-  tools: AgentTool[];
-  mcpConnections: McpConnection[];
-  workspaceRoot: string;
-  memory?: MemoryHandle;
-  takeCredentialError?: () => unknown;
-};
-/** Sandbox tools + host tools → pi agent from a {@link AgentDefinition}. */
-declare function buildAgentRuntime(def: AgentDefinition, ctx: BuildAgentRuntimeContext, runPrompt?: RunAgentPromptOptions): Promise<SandboxedAgentRuntime>; //#endregion
-//#region src/define/define-agent.d.ts
-type DefineAgentOptions = {
-  /** Discovery key — resolves agentId from the DB registry after createServer sync. */key?: string; /** Server overrides for sandbox/workspace when prompting. */
-  runPrompt?: RunAgentPromptOptions; /** Agent module URL (`import.meta.url`) — resolves `src/skills/` and `src/files/` in dev. */
-  module?: string;
-};
-type Agent = AgentDefinition & {
-  /** Discovery and route id for this agent (`POST /agents/{key}`). */key: string; /** Per-request pi agent + sandbox from this definition. */
-  buildRuntime: (ctx: BuildAgentRuntimeContext, runPrompt?: RunAgentPromptOptions) => Promise<SandboxedAgentRuntime>;
-  prompt(input: {
-    message: string;
-    sessionId?: string;
-    agentId?: string;
-  }, runPrompt?: RunAgentPromptOptions): Promise<PromptResponse>;
-};
-/**
- * Define an agent: normalized config plus a pipeline that builds sandbox + pi runtime on demand.
- */
-declare function defineAgent(input: AgentDefinitionInput, options?: DefineAgentOptions): Agent; //#endregion
-//#region src/define/define-subagent-tool.d.ts
-declare const SUBAGENT_TOOL: unique symbol;
-/** Reserved for parent→child passthrough (credentials, workspace, etc.). Not wired yet. */
-type SubagentToolInherit = {
-  credentials?: boolean;
-  workspace?: boolean;
-};
-type SubagentToolMetadata = {
-  agent: Agent;
-  inherit?: SubagentToolInherit;
-};
-type SubagentToolDetails = {
-  sessionId: string;
-  error: string | null;
-};
-type SubagentTool = AgentTool & {
-  [SUBAGENT_TOOL]: SubagentToolMetadata;
-};
-type DefineSubagentToolInput = {
-  agent: Agent;
-  name: string;
-  label: string;
-  description?: string;
-  parameters: AgentTool["parameters"];
-  inherit?: SubagentToolInherit; /** Defaults to `params.message`. Override when tool params use a different shape. */
-  toMessage?: (params: unknown) => string;
-};
-declare function getSubagentToolMetadata(tool: AgentTool): SubagentToolMetadata | undefined;
-declare function defineSubagentTool(input: DefineSubagentToolInput): SubagentTool; //#endregion
-//#region src/define/run-prompt.d.ts
-declare function runAgentPrompt(agent: Agent, agentId: string, input: {
-  message: string;
-  sessionId?: string;
-  context?: RunAgentPromptOptions["credentials"];
-}, options?: RunAgentPromptOptions): Promise<PromptResponse>;
-declare class SessionAgentMismatchError extends Error {
-  constructor(sessionId: string);
-} //#endregion
-//#region src/define/prepare-session.d.ts
-declare function prepareAgentSession(agentId: string, sessionId?: string): Promise<{
-  sessionId: string;
-}>; //#endregion
-//#region src/define/normalize-definition.d.ts
-/** Normalizes optional agent fields for the server runtime. */
-declare function normalizeAgentDefinition(input: AgentDefinitionInput, options?: {
-  agentKey?: string;
-  appRoot?: string;
-  module?: string;
-}): AgentDefinition; //#endregion
-//#region src/define/resolve-agent-workspace-root.d.ts
-/**
- * Resolve the host directory backing `/workspace` for an agent prompt.
- *
- * Precedence:
- * 1. Explicit `workspaceRoot` override (workflow handoff) — skips agent sandbox materialization.
- * 2. Agent `sandbox` definition — materialize to `{workspacesRoot}/{agentId}/`.
- * 3. Default agent dir — `{workspacesRoot}/{agentId}/`.
- *
- * Agent skills always materialize into the resolved workspace when configured.
- */
-declare function resolveAgentWorkspaceRoot(agentId: string, options: {
-  workspacesRoot?: string;
-  workspaceRoot?: string;
-  sandbox?: SandboxDefinition;
-  skills?: SkillDefinition[];
-}): Promise<string>; //#endregion
-//#region src/define/resolve-agent-assets.d.ts
-type AgentAssetInput = {
-  skillKeys?: string[];
-  files?: boolean | string;
-  agentKey?: string;
-  appRoot?: string;
-};
-type ResolvedAgentAssets = {
-  skills?: SkillDefinition[];
-  sandbox?: SandboxDefinition;
-};
-declare function loadAssetManifest(appRoot: string): AssetManifest;
-/** Resolve author-facing skill/file keys into packed sandbox + skill definitions. */
-declare function resolveAgentAssets(input: AgentAssetInput): ResolvedAgentAssets; //#endregion
-//#region src/define/resolve-tools.d.ts
-type ResolvedAgentTools = {
-  tools: AgentTool[];
-  mcpConnections: McpConnection[];
-};
-declare function resolveAgentTools(tools: Array<ActionDefinition | AgentTool | AgentMcpTool>, resolver: ToolCredentialResolver): Promise<ResolvedAgentTools>; //#endregion
-//#endregion
-export { type Agent, type AgentAssetInput, type AgentConfig, type AgentCreateInput, AgentCreateInputSchema, type AgentDefinition, type AgentDefinitionInput, type AgentRuntime, type AgentSnapshot, type BuildAgentRuntimeContext, DEFAULT_THINKING_LEVEL, type DefineAgentOptions, type DefineSubagentToolInput, type McpAuthOptions, type McpCallToolOptions, type McpConnection, type McpDefinition, type McpDefinitionInput, type McpHttpTransport, type McpServerOptions, type McpStdioOptions, type McpStdioTransport, type McpTransport, type ModelRef, ModelRefSchema, type PromptInput, type PromptResponse, type ResolvedAgentAssets, type RunAgentPromptOptions, SUBAGENT_TOOL, type SandboxedAgentRuntime, SessionAgentMismatchError, type SubagentTool, type SubagentToolDetails, type SubagentToolInherit, type SubagentToolMetadata, type ThinkingLevel, ThinkingLevelSchema, type ToolCredentialResolver, buildAgentRuntime, connectMcpDefinition, connectMcpServer, connectMcpStdio, createAgent, defineAgent, defineMcp, defineSubagentTool, defineTool, errorMessage, getModel, getSubagentToolMetadata, isMcp, loadAssetManifest, messages, normalizeAgentDefinition, parseAgentCreateInput, prepareAgentSession, prompt, resolveAgentAssets, resolveAgentTools, resolveAgentWorkspaceRoot, resolveThinkingLevel, runAgentPrompt, snapshot };
-//# sourceMappingURL=agent.d.mts.map
+export { type Agent, type AgentAssetInput, type AgentConfig, type AgentCreateInput, AgentCreateInputSchema, type AgentDefinition, type AgentDefinitionInput, type AgentRuntime, type AgentSnapshot, type BuildAgentRuntimeContext, DEFAULT_THINKING_LEVEL, type DefineAgentOptions, type DefineSubagentToolInput, type McpAuthOptions, type McpCallToolOptions, type McpConnection, type McpDefinition, type McpDefinitionInput, type McpHttpTransport, type McpServerOptions, type McpStdioOptions, type McpStdioTransport, type McpTransport, type ModelRef, ModelRefSchema, type PromptInput, type PromptResponse, type ResolvedAgentAssets, type RunAgentPromptOptions, SUBAGENT_TOOL, type SandboxedAgentRuntime, SessionAgentMismatchError, type SubagentTool, type SubagentToolDetails, type SubagentToolInherit, type SubagentToolMetadata, type ThinkingLevel, ThinkingLevelSchema, type ToolCredentialResolver, buildAgentRuntime, connectMcpDefinition, connectMcpServer, connectMcpStdio, createAgent, defineAgent, defineMcp, defineSubagentTool, defineTool, errorMessage, getModel, getSubagentToolMetadata, isMcp, loadAssetManifest, messages, normalizeAgentDefinition, parseAgentCreateInput, prepareAgentSession, prompt, resolveAgentAssets, resolveAgentTools, resolveAgentWorkspaceRoot, resolveThinkingLevel, runAgentPrompt, snapshot };

package/dist/agent.mjs

@@ -1,9 +1,9 @@
 import { $ as Options, $t as IsMap, An as IsSymbol$1, At as Unreachable, Bn as __require, Bt as IsRef$1, Cn as IsMinLength$2, Ct as IsInteger$2, Dn as IsObject$1, Dt as IsCodec, En as IsNumber$1, Et as IsBigInt$2, Fn as Symbols, Ft as IsUnion, G as ensureWorkspaceDir, Gt as IsArray$2, Ht as IsFunction$2, In as guard_exports, It as Union, Jt as IsOptional, K as materializeSandbox, Kt as Base, Ln as __commonJSMin, Lt as IsObject$2, Mn as IsUnsafePropertyKey, Mt as IsEnum$1, Nn as IsValueLike, Nt as IsCyclic, On as IsObjectNotArray$1, Ot as Hash, Pn as Keys$1, Pt as Unknown, Q as Instantiate, Qt as Get$3, Rt as _Object_, Sn as IsMaxLength$2, St as IsIterator$2, Tn as IsNull$1, Tt as IsBoolean$2, Ut as IsConstructor$2, Vt as Ref$1, W as defineSandbox, Wt as IsAsyncIterator$2, X as resolveSandboxRoot, Xt as IsPromise, Y as resolveAppRootFromModule, Yt as Optional, Z as Evaluate$1, Zt as IsSchema$1, _n as IsGreaterThan$1, _t as IsLiteralBigInt, a as createSandbox, an as EveryAll, at as RecordPattern, bn as IsLessEqualThan$1, bt as IsLiteralString, c as defineTool$1, cn as IsAsyncIterator$1, ct as EnumToUnion, d as resolveRunProvider, dn as IsClassInstance, dt as String$1, en as IsSet, et as Compare, fn as IsConstructor$1, ft as IsSymbol$2, gn as IsGreaterEqualThan$1, gt as IsLiteral, hn as IsFunction$1, ht as IsNull$2, i as createJustBashProvider, in as Every$1, it as IsRecord, jn as IsUndefined$1, jt as IsIntersect, kn as IsString$1, kt as hash_exports, ln as IsBigInt$1, lt as TemplateLiteralDecode, mn as IsEqual$1, mt as Number$1, nn as Entries$2, nt as IsVoid, o as defaultWorkspacesRoot, on as HasPropertyKey$1, ot as RecordValue, pn as IsDeepEqual$1, pt as IsNumber$2, q as packAssetDirs, qt as IsBase, r as createInvokeToolBridge, rn as EntriesRegExp, rt as IsUndefined$2, s as defineSkill, sn as IsArray$1, st as IsTuple, tn as IsTypeArray, tt as IsTemplateLiteral, u as materializeSkills, un as IsBoolean$1, ut as IsString$2, vn as IsInteger$1, vt as IsLiteralBoolean, wn as IsMultipleOf$1, wt as Boolean$1, xn as IsLessThan$1, xt as Literal, yn as IsIterator$1, yt as IsLiteralNumber, zn as __exportAll, zt as IsNever } from "./dist-f_JGyGWx.mjs";
-import { s as isAction, u as resolveActionTool } from "./dist-B1fqDXYa.mjs";
+import { s as isAction, u as resolveActionTool } from "./dist-CAGgGvND.mjs";
 import "./env-api-keys-BSMeSmLq.mjs";
 import { i as getModel, t as AssistantMessageEventStream } from "./event-stream-C7YBbzsc.mjs";
 import "./json-parse-BhvKZ346.mjs";
-import { S as isMcp, _ as touchSession, a as buildCredentialRunContext, b as connectMcpStdio, c as isCredentialError, d as MESSAGE_EVENT_TYPE$1, f as appendEvent, g as listMessageEvents, h as getSession, i as withSpan, l as resolveActionCredentials, m as getAgentByRoute, n as getTraceContext, o as captureCredentialToolErrors, p as createSession, s as createCredentialResolver, t as captureConsole, u as resolveMcpTools, v as connectMcpDefinition, x as defineMcp, y as connectMcpServer } from "./dist-BML_gJSh.mjs";
+import { C as isMcp, S as defineMcp, a as resolveActionCredentials, b as connectMcpServer, c as appendEvent, d as getSession, f as listMessageEvents, g as getTraceContext, h as captureConsole, i as isCredentialError, l as createSession, m as touchSession, n as captureCredentialToolErrors, o as resolveMcpTools, p as resolveRunSourceFromTraceContext, r as createCredentialResolver, s as MESSAGE_EVENT_TYPE$1, t as buildCredentialRunContext, u as getAgentByRoute, v as withSpan, x as connectMcpStdio, y as connectMcpDefinition } from "./dist-DzfOPx7X.mjs";
 import { createRequire } from "node:module";
 import { z } from "zod";
 import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
@@ -927,7 +927,7 @@ function loadGoogleVertexProviderModule() {
 	return googleVertexProviderModulePromise;
 }
 function loadMistralProviderModule() {
-	mistralProviderModulePromise ||= import("./mistral-CI7CQc_C.mjs").then((module) => {
+	mistralProviderModulePromise ||= import("./mistral-CGHbHFQG.mjs").then((module) => {
 		const provider = module;
 		return {
 			stream: provider.streamMistral,
@@ -13931,11 +13931,11 @@ async function persistAgentEvent(sessionId, event, memoryConfig) {
 async function prepareAgentSession(agentId, sessionId) {
 	if (sessionId) {
 		const session = await getSession(sessionId);
-		if (!session) await createSession(agentId, sessionId);
+		if (!session) await createSession(agentId, sessionId, await resolveRunSourceFromTraceContext());
 		else if (session.agentId !== agentId) throw new SessionAgentMismatchError(sessionId);
 		return { sessionId };
 	}
-	return { sessionId: (await createSession(agentId)).id };
+	return { sessionId: (await createSession(agentId, void 0, await resolveRunSourceFromTraceContext())).id };
 }
 async function runAgentPrompt(agent, agentId, input, options = {}) {
 	const { sessionId } = await prepareAgentSession(agentId, input.sessionId);