@keystrokehq/keystroke 0.1.32 → 0.1.33

package/dist/index-BIEIqsqn.d.mts

@@ -0,0 +1,279 @@
+import { t as AgentTool } from "./index-DHLs5qPc.mjs";
+import { z } from "zod";
+
+//#region ../sandbox/dist/types-BMPq9MU0.d.mts
+//#region src/types.d.ts
+type ExecResult = {
+  stdout: string;
+  stderr: string;
+  exitCode: number;
+};
+type ExecOptions = {
+  cwd?: string;
+  env?: Record<string, string>;
+  stdin?: string;
+  signal?: AbortSignal;
+};
+type RuntimeHooks = {
+  beforeExec?: (ctx: RuntimeHookContext & {
+    script: string;
+  }) => void | Promise<void>;
+  afterExec?: (ctx: RuntimeHookContext & {
+    script: string;
+    result: ExecResult;
+  }) => void | Promise<void>;
+  onDispose?: (ctx: RuntimeHookContext) => void | Promise<void>;
+};
+type RuntimeHookContext = {
+  agentId: string;
+  sessionId: string;
+  agentRoot: string;
+  sessionRoot: string;
+};
+/** Host callback for js-exec tool invocations (just-bash `javascript.invokeTool`). */
+type InvokeToolCallback = (path: string, argsJson: string) => Promise<string>;
+/** Input to {@link RuntimeProvider.create} after workspace paths are resolved. */
+type ProviderSandboxOptions = {
+  agentId: string;
+  sessionId: string; /** Host directory backing `/workspace/agent` (persistent per-agent files + skills). */
+  agentRoot: string; /** Host directory backing `/workspace/session` (ephemeral per-session scratch). */
+  sessionRoot: string;
+  hooks?: RuntimeHooks; /** Bridge host tools into js-exec scripts via `tools["name"](args)`. */
+  invokeTool?: InvokeToolCallback;
+};
+/** Low-level sandbox: exec, workspace files, lifecycle. */
+type Sandbox = {
+  readonly agentId: string;
+  readonly sessionId: string;
+  readonly agentRoot: string;
+  readonly sessionRoot: string;
+  exec(script: string, options?: ExecOptions): Promise<ExecResult>; /** Read a workspace file. `path` is a canonical `/workspace/...` guest path. */
+  readFile(path: string): Promise<string>; /** Write a workspace file, creating parent directories. Canonical `/workspace/...` path. */
+  writeFile(path: string, content: string): Promise<void>;
+  dispose(): Promise<void>;
+};
+/**
+ * Sandbox plus tools that run inside it (read, write, edit, bash, …).
+ * Host-only tools (Stripe, DB, etc.) are attached separately in the server layer.
+ */
+type SandboxHandle = {
+  runtime: Sandbox;
+  tools: AgentTool[];
+};
+type RuntimeProvider = {
+  create(options: ProviderSandboxOptions): Promise<SandboxHandle>;
+}; //#endregion
+//#endregion
+//#region ../sandbox/dist/index-8_bX9Bno.d.mts
+//#region src/runtime-config.d.ts
+/** Env var for sandbox mode override (`in-process` | `vm`). */
+declare const SANDBOX_MODE_ENV = "KEYSTROKE_SANDBOX_MODE";
+type SandboxMode = "in-process" | "vm";
+type SandboxEnv = Record<string, string | undefined>;
+declare function resolveSandboxMode(options: {
+  mode?: SandboxMode;
+}, env?: SandboxEnv): SandboxMode;
+type ResolveDefaultRuntimeProviderOptions = {
+  mode?: SandboxMode;
+  inProcessProvider?: RuntimeProvider;
+  vmProvider?: RuntimeProvider;
+};
+/** Default provider from mode (just-bash in-process or microsandbox VM fallback). */
+declare function resolveDefaultRuntimeProvider(options?: ResolveDefaultRuntimeProviderOptions, env?: SandboxEnv): Promise<RuntimeProvider>; //#endregion
+//#region src/files/schemas.d.ts
+declare const SandboxFileContentSchema: z.ZodObject<{
+  path: z.ZodString;
+  file: z.ZodString;
+}, z.core.$strip>;
+/** Destination path under `/workspace`. For `dir`, used as a prefix. */
+declare const SandboxFileSchema: z.ZodObject<{
+  path: z.ZodString;
+  file: z.ZodOptional<z.ZodString>;
+  dir: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    path: z.ZodString;
+    file: z.ZodString;
+  }, z.core.$strip>>>;
+}, z.core.$strip>;
+/** Author-facing project file set reference under `src/files/`. */
+/** Author-facing sandbox files: inline entries or a project file set. */
+declare const SandboxFilesInputSchema: z.ZodUnion<readonly [z.ZodArray<z.ZodObject<{
+  path: z.ZodString;
+  file: z.ZodOptional<z.ZodString>;
+  dir: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    path: z.ZodString;
+    file: z.ZodString;
+  }, z.core.$strip>>>;
+}, z.core.$strip>>, z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodString]>]>;
+type SandboxFilesInput = z.infer<typeof SandboxFilesInputSchema>;
+/** Author-facing sandbox definition (`defineSandbox`, agent `sandbox`). */
+declare const SandboxDefinitionInputSchema: z.ZodObject<{
+  key: z.ZodOptional<z.ZodString>;
+  mode: z.ZodOptional<z.ZodEnum<{
+    "in-process": "in-process";
+    vm: "vm";
+  }>>;
+  files: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodObject<{
+    path: z.ZodString;
+    file: z.ZodOptional<z.ZodString>;
+    dir: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      path: z.ZodString;
+      file: z.ZodString;
+    }, z.core.$strip>>>;
+  }, z.core.$strip>>, z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodString]>]>>;
+}, z.core.$strip>;
+/** Normalized sandbox definition after project file sets are resolved. */
+declare const SandboxDefinitionSchema: z.ZodObject<{
+  key: z.ZodOptional<z.ZodString>;
+  mode: z.ZodOptional<z.ZodEnum<{
+    "in-process": "in-process";
+    vm: "vm";
+  }>>;
+  files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    path: z.ZodString;
+    file: z.ZodOptional<z.ZodString>;
+    dir: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      path: z.ZodString;
+      file: z.ZodString;
+    }, z.core.$strip>>>;
+  }, z.core.$strip>>>;
+}, z.core.$strip>;
+type SandboxFileContent = z.infer<typeof SandboxFileContentSchema>;
+type SandboxFile = z.infer<typeof SandboxFileSchema>;
+type SandboxDefinitionInput = z.infer<typeof SandboxDefinitionInputSchema>;
+type SandboxDefinition = z.infer<typeof SandboxDefinitionSchema>; //#endregion
+//#region src/files/define-sandbox.d.ts
+/** Define a reusable sandbox file layout. */
+declare function defineSandbox(def: SandboxDefinitionInput): SandboxDefinitionInput; //#endregion
+//#region src/files/types.d.ts
+type SandboxInstance = {
+  root: string;
+  agentId: string;
+  definition?: SandboxDefinition;
+};
+type AgentWorkspaceRoots = {
+  agentRoot: string;
+  sessionRoot: string;
+}; //#endregion
+//#region src/files/flatten-sandbox-files.d.ts
+/** Expand directory entries into flat `{ path, file }` records under `/workspace`. */
+//#endregion
+//#region src/files/materialize-sandbox.d.ts
+type MaterializeSandboxOptions = {
+  workspacesRoot: string;
+  agentId: string;
+  definition?: SandboxDefinition;
+};
+declare function materializeSandbox(options: MaterializeSandboxOptions): Promise<SandboxInstance>; //#endregion
+//#region src/files/pack-dir.d.ts
+type PackedFile = {
+  path: string;
+  file: string;
+};
+/** Recursively read a host file or directory into sandbox-relative `{ path, file }` entries. */
+declare function packDirFromDisk(rootPath: string): PackedFile[]; //#endregion
+//#region src/files/pack-asset-dirs.d.ts
+type AssetManifest = {
+  skills: Record<string, PackedFile[]>;
+  files: Record<string, PackedFile[]>;
+};
+/** Pack every subdir under `src/skills/` and `src/files/` into an asset manifest. */
+declare function packAssetDirs(appRoot: string, srcDir?: string): AssetManifest; //#endregion
+//#region src/files/resolve-sandbox-definition.d.ts
+type ResolveSandboxDefinitionOptions = {
+  /** When files is `true`, uses this slug for `src/files/{slug}/`. */projectSlug?: string;
+  appRoot?: string;
+};
+declare function loadAssetManifest(appRoot: string): AssetManifest;
+/** Resolve author sandbox input into a normalized definition for materialization/runtime. */
+declare function resolveSandboxDefinition(input: SandboxDefinitionInput, options?: ResolveSandboxDefinitionOptions): SandboxDefinition; //#endregion
+//#region src/files/app-root-scope.d.ts
+/** Run with an explicit user-app root (parallel-safe alternative to mutating `KEYSTROKE_ROOT`). */
+declare function runWithAppRoot<T>(appRoot: string, fn: () => T): T;
+declare function getBoundAppRoot(): string | undefined; //#endregion
+//#region src/files/resolve-app-root.d.ts
+/** Walk upward from a module file to find the user app root (`src/agents`, `src/skills`, etc.). */
+declare function resolveAppRoot(fromPath: string): string;
+/** Resolve app root from an agent (or other) module URL. */
+declare function resolveAppRootFromModule(moduleUrl: string): string; //#endregion
+//#endregion
+//#region ../sandbox/dist/index.d.mts
+//#region src/create-sandbox.d.ts
+type CreateSandboxOptions = {
+  agentId: string;
+  sessionId: string; /** Explicit host root backing `/workspace/agent`. Skips agent-id resolution when set. */
+  agentRoot?: string; /** Explicit host root backing `/workspace/session`. Skips session-id resolution when set. */
+  sessionRoot?: string;
+  workspacesRoot?: string; /** Sandbox runtime mode. Default `in-process` (or `KEYSTROKE_SANDBOX_MODE`). */
+  mode?: SandboxMode; /** Injected in-process runtime provider (skipped when mode is `vm`). */
+  provider?: RuntimeProvider; /** Injected VM runtime provider (cloud Daytona proxy path). */
+  vmProvider?: RuntimeProvider;
+  hooks?: RuntimeHooks; /** Bridge host tools into js-exec scripts via `tools["name"](args)`. */
+  invokeTool?: InvokeToolCallback;
+};
+declare function defaultWorkspacesRoot(): string;
+/** Spin up workspace + coding tools (read, write, edit, bash). */
+declare function createSandbox(options: CreateSandboxOptions): Promise<SandboxHandle>; //#endregion
+//#region src/skills/types.d.ts
+type SkillDefinitionInput = {
+  /** Skill folder name under `skills/`. */slug: string;
+  name?: string;
+  description?: string; /** Files relative to the skill root. */
+  files: SandboxFileContent[];
+};
+type SkillDefinition = SkillDefinitionInput; //#endregion
+//#region src/skills/define-skill.d.ts
+/** Declare an Agent Skills protocol bundle for `skills/{slug}/`. */
+declare function defineSkill(input: SkillDefinitionInput): SkillDefinition; //#endregion
+//#region src/skills/materialize-skills.d.ts
+type MaterializeSkillsOptions = {
+  workspaceRoot: string;
+  skills: SkillDefinition[];
+};
+/** Write skill files to `{workspaceRoot}/skills/{slug}/`. */
+declare function materializeSkills(options: MaterializeSkillsOptions): Promise<void>; //#endregion
+//#region src/providers/just-bash/index.d.ts
+declare function createJustBashProvider(): RuntimeProvider; //#endregion
+//#region src/tools/workspace-path.d.ts
+/** Guest parent directory for agent + session mounts. */
+declare const WORKSPACE_MOUNT = "/workspace";
+/** Persistent per-agent files and skills. */
+declare const AGENT_MOUNT = "/workspace/agent";
+/** Ephemeral per-session scratch space. */
+declare const SESSION_MOUNT = "/workspace/session"; //#endregion
+//#region src/workspace-system-prompt.d.ts
+type SandboxSystemPromptOptions = {
+  hasUserFiles?: boolean;
+  hasSkills?: boolean;
+};
+/** System-prompt note describing the dual workspace layout. */
+declare function sandboxSystemPromptInjection(options?: SandboxSystemPromptOptions): string; //#endregion
+//#region src/tools/create-coding-tools.d.ts
+type CodingToolsOptions = {
+  /** When true (default), bash tool documents js-exec codemode. VM runtimes pass false. */codemode?: boolean;
+};
+declare function createCodingTools(runtime: Sandbox, options?: CodingToolsOptions): AgentTool[]; //#endregion
+//#region src/providers/just-bash/create-invoke-tool-bridge.d.ts
+/** Static poll-script check for tool references agents cannot call. */
+declare function findUnknownPollScriptToolCalls(code: string, tools: AgentTool[]): void;
+/** Empty collections so dry-run scripts can guard on `.messages.length` safely. */
+declare const STUB_TOOL_RESPONSE_JSON: string;
+/** Bridge host {@link AgentTool}s into just-bash js-exec via `tools["name"](args)`. */
+declare function createInvokeToolBridge(tools: AgentTool[]): InvokeToolCallback;
+/** Dry-run bridge: validates tool names resolve but stubs responses without calling tools. */
+declare function createStubInvokeToolBridge(tools: AgentTool[]): InvokeToolCallback; //#endregion
+//#region src/ensure-sandbox-dirs.d.ts
+/** Ensure the workspaces root directory exists. Session dirs are created on demand. */
+declare function ensureSandboxDirs(workspacesRoot: string): Promise<void>; //#endregion
+//#region src/sandbox-dirs.d.ts
+/** @deprecated Use {@link resolveSessionRoot}. Kept for tests migrating off session-only layout. */
+declare function resolveSandboxRoot(workspacesRoot: string, sessionId: string): string;
+declare function resolveAgentRoot(workspacesRoot: string, agentId: string): string;
+declare function resolveSessionRoot(workspacesRoot: string, sessionId: string): string;
+declare function ensureWorkspaceDir(workspaceRoot: string): Promise<void>; //#endregion
+//#region src/project-scope-registry.d.ts
+/** @internal Test hook — runtime registers via `@keystrokehq/action`. */
+declare function registerProjectScopeGetter(fn: () => string | undefined): void;
+declare function getRegisteredProjectScopeId(): string | undefined; //#endregion
+//#endregion
+export { InvokeToolCallback as $, SandboxDefinition as A, getBoundAppRoot as B, resolveSessionRoot as C, MaterializeSandboxOptions as D, AssetManifest as E, SandboxFileContent as F, resolveAppRoot as G, materializeSandbox as H, SandboxFilesInput as I, resolveSandboxDefinition as J, resolveAppRootFromModule as K, SandboxInstance as L, SandboxDefinitionInputSchema as M, SandboxDefinitionSchema as N, ResolveSandboxDefinitionOptions as O, SandboxFile as P, ExecResult as Q, SandboxMode as R, resolveSandboxRoot as S, AgentWorkspaceRoots as T, packAssetDirs as U, loadAssetManifest as V, packDirFromDisk as W, runWithAppRoot as X, resolveSandboxMode as Y, ExecOptions as Z, findUnknownPollScriptToolCalls as _, SkillDefinition as a, registerProjectScopeGetter as b, createCodingTools as c, createSandbox as d, ProviderSandboxOptions as et, createStubInvokeToolBridge as f, ensureWorkspaceDir as g, ensureSandboxDirs as h, SandboxSystemPromptOptions as i, Sandbox as it, SandboxDefinitionInput as j, SANDBOX_MODE_ENV as k, createInvokeToolBridge as l, defineSkill as m, SESSION_MOUNT as n, RuntimeHooks as nt, SkillDefinitionInput as o, defaultWorkspacesRoot as p, resolveDefaultRuntimeProvider as q, STUB_TOOL_RESPONSE_JSON as r, RuntimeProvider as rt, WORKSPACE_MOUNT as s, AGENT_MOUNT as t, RuntimeHookContext as tt, createJustBashProvider as u, getRegisteredProjectScopeId as v, sandboxSystemPromptInjection as w, resolveAgentRoot as x, materializeSkills as y, defineSandbox as z };
+//# sourceMappingURL=index-BIEIqsqn.d.mts.map

package/dist/index-BIEIqsqn.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-BIEIqsqn.d.mts","names":["AgentTool","ExecResult","stdout","stderr","exitCode","ExecOptions","Record","AbortSignal","cwd","env","stdin","signal","RuntimeHooks","RuntimeHookContext","Promise","beforeExec","script","ctx","afterExec","result","onDispose","agentId","sessionId","agentRoot","sessionRoot","InvokeToolCallback","path","argsJson","ProviderSandboxOptions","hooks","invokeTool","Sandbox","exec","options","readFile","writeFile","content","dispose","SandboxHandle","runtime","tools","RuntimeProvider","create","a","c","i","l","n","o","r","s","t","s","RuntimeProvider","z","SANDBOX_MODE_ENV","SandboxMode","SandboxEnv","Record","resolveSandboxMode","mode","options","env","ResolveDefaultRuntimeProviderOptions","inProcessProvider","vmProvider","resolveDefaultRuntimeProvider","Promise","SandboxModeSchema","ZodEnum","vm","SandboxFileContentSchema","ZodString","core","$strip","ZodObject","path","file","SandboxFileSchema","ZodOptional","ZodArray","dir","SandboxProjectFilesSchema","ZodLiteral","ZodUnion","SandboxFilesInputSchema","SandboxFilesInput","infer","SandboxDefinitionInputSchema","key","files","SandboxDefinitionSchema","SandboxFileContent","SandboxFile","SandboxDefinitionInput","SandboxDefinition","defineSandbox","def","SandboxInstance","root","agentId","definition","AgentWorkspaceRoots","agentRoot","sessionRoot","flattenSandboxFiles","MaterializeSandboxOptions","workspacesRoot","materializeSandbox","PackedFile","packDirFromDisk","rootPath","AssetManifest","skills","packAssetDirs","appRoot","srcDir","ResolveSandboxDefinitionOptions","projectSlug","loadAssetManifest","resolveSandboxDefinition","input","runWithAppRoot","T","fn","getBoundAppRoot","resolveAppRoot","fromPath","resolveAppRootFromModule","moduleUrl","A","C","D","E","M","N","O","S","_","a","b","c","d","f","g","h","i","j","k","l","m","n","o","p","r","t","u","v","w","x","y","a","RuntimeHookContext","c","Sandbox","i","ProviderSandboxOptions","l","SandboxHandle","n","ExecResult","o","RuntimeHooks","r","InvokeToolCallback","s","RuntimeProvider","t","ExecOptions","A","SANDBOX_MODE_ENV","C","SandboxFileContent","E","SandboxFilesInput","M","resolveDefaultRuntimeProvider","N","resolveSandboxMode","S","SandboxFile","_","defineSandbox","ResolveSandboxDefinitionOptions","b","SandboxDefinitionInputSchema","AssetManifest","d","packDirFromDisk","f","MaterializeSandboxOptions","g","SandboxInstance","h","AgentWorkspaceRoots","runWithAppRoot","j","SandboxMode","packAssetDirs","resolveAppRootFromModule","loadAssetManifest","p","materializeSandbox","getBoundAppRoot","resolveSandboxDefinition","resolveAppRoot","v","SandboxDefinition","x","SandboxDefinitionSchema","y","SandboxDefinitionInput","AgentTool","AgentTool$1","AgentToolResult","defineTool","CreateSandboxOptions","agentId","sessionId","agentRoot","sessionRoot","workspacesRoot","mode","provider","vmProvider","hooks","invokeTool","defaultWorkspacesRoot","createSandbox","Promise","options","SkillDefinitionInput","slug","name","description","files","SkillDefinition","defineSkill","input","MaterializeSkillsOptions","workspaceRoot","skills","materializeSkills","createJustBashProvider","WORKSPACE_MOUNT","AGENT_MOUNT","SESSION_MOUNT","SandboxSystemPromptOptions","hasUserFiles","hasSkills","sandboxSystemPromptInjection","CodingToolsOptions","codemode","createCodingTools","runtime","findUnknownPollScriptToolCalls","code","tools","STUB_TOOL_RESPONSE_JSON","createInvokeToolBridge","createStubInvokeToolBridge","ensureSandboxDirs","resolveSandboxRoot","resolveAgentRoot","resolveSessionRoot","ensureWorkspaceDir","registerProjectScopeGetter","fn","getRegisteredProjectScopeId"],"sources":["../../sandbox/dist/types-BMPq9MU0.d.mts","../../sandbox/dist/index-8_bX9Bno.d.mts","../../sandbox/dist/index.d.mts"],"mappings":"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"}

package/dist/index-DD1dNpCS.d.mts

@@ -0,0 +1,359 @@
+import { S as PromptLlmRunOptions, T as StoredRouteManifest, b as OAuthTokenAdapter, p as CredentialRunContext, t as AgentTool, v as ModelCapabilities } from "./index-DHLs5qPc.mjs";
+import { a as McpCredentialContext, n as ActionDefinition } from "./index-ClbddHis.mjs";
+import { a as UIMessage, i as ToolLoopAgent, l as ToolSet, n as FileUIPart, r as LanguageModel, t as LlmUsageRecordInput } from "./index-laoo2SkM.mjs";
+import { n as AgentStreamEvent, r as ThinkingLevel, t as AgentMessage } from "./types-DpYxSJ5x.mjs";
+import { i as McpDefinition, t as ToolCredentialResolver } from "./index-BWOPtMGc.mjs";
+import { $ as InvokeToolCallback, A as SandboxDefinition, R as SandboxMode, T as AgentWorkspaceRoots, a as SkillDefinition, it as Sandbox, j as SandboxDefinitionInput, nt as RuntimeHooks, rt as RuntimeProvider } from "./index-BIEIqsqn.mjs";
+import { v as WorkflowDefinition } from "./index-BboH3db0.mjs";
+import { z } from "zod";
+import { DatabaseSync } from "node:sqlite";
+
+//#region ../agent/dist/schemas-BU2tnCfd.d.mts
+//#region src/define/resolve-agent-model.d.ts
+/** Gateway-style model id, e.g. `anthropic/claude-sonnet-4.6`. */
+type AgentModelId = `${string}/${string}`;
+declare const AgentModelIdSchema: z.ZodCustom<`${string}/${string}`, `${string}/${string}`>;
+type ResolvedAgentModel = {
+  /** AI SDK language model (always via AI Gateway). */languageModel: LanguageModel; /** Full gateway model id (`vendor/model`). */
+  modelId: AgentModelId;
+  provider: "vercel-ai-gateway";
+  baseUrl?: string;
+  pricing?: {
+    inputPerMillion: number;
+    outputPerMillion: number;
+    cacheReadPerMillion: number;
+  };
+  capabilities: ModelCapabilities;
+};
+/** Cached gateway catalog lookup for model multimodal capabilities. */
+declare function resolveModelCapabilities(modelId: AgentModelId): Promise<ModelCapabilities>;
+/** Resolve a user-authored model id to an AI Gateway language model + optional pricing metadata. */
+declare function resolveAgentModel(modelId: AgentModelId): Promise<ResolvedAgentModel>; //#endregion
+//#region src/schemas.d.ts
+declare const ThinkingLevelSchema: z.ZodEnum<{
+  "provider-default": "provider-default";
+  none: "none";
+  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.ZodCustom<`${string}/${string}`, `${string}/${string}`>;
+  thinkingLevel: z.ZodOptional<z.ZodEnum<{
+    "provider-default": "provider-default";
+    none: "none";
+    minimal: "minimal";
+    low: "low";
+    medium: "medium";
+    high: "high";
+    xhigh: "xhigh";
+  }>>;
+}, z.core.$strip>;
+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
+//#endregion
+//#region src/types.d.ts
+type Memory = {
+  tool: AgentTool;
+  systemPromptInjection(): string;
+  close?(): Promise<void>;
+};
+type DefaultMemoryOptions = {
+  /** Char budget for `MEMORY.md`, enforced by the memory tool on write/edit (default 2200). */memoryCharLimit?: number; /** Char budget for `USER.md`, enforced by the memory tool on write/edit (default 1375). */
+  userCharLimit?: number; /** Max archive notes listed in the snapshot table-of-contents (default 30). */
+  archiveTocLimit?: number;
+};
+type MemoryCreateContext = {
+  agentId: string;
+  sessionId: string;
+  /**
+   * Per-agent memory options (from `defineAgent({ memory })`), merged over any factory-level
+   * options. Required so hosted factories (e.g. storage-backed) still apply the agent's limits.
+   */
+  options?: DefaultMemoryOptions;
+};
+type MemoryFactory = {
+  create(ctx: MemoryCreateContext): Promise<Memory>;
+}; //#endregion
+//#region src/providers/default-memory/index.d.ts
+//#endregion
+//#region ../agent/dist/index.d.mts
+//#region src/ai/experimental-download.d.ts
+type AgentExperimentalDownload = NonNullable<ConstructorParameters<typeof ToolLoopAgent>[0]["experimental_download"]>; //#endregion
+//#region src/ai/stream-agent-prompt.d.ts
+type AgentRunConfig = {
+  systemPrompt: string;
+  resolvedModel: ResolvedAgentModel;
+  thinkingLevel: ThinkingLevel;
+  messages: UIMessage[];
+  tools: AgentTool[];
+  mcpToolSet: ToolSet;
+  files?: FileUIPart[];
+  experimentalDownload?: AgentExperimentalDownload;
+};
+type StreamAgentPromptOptions = {
+  signal: AbortSignal;
+  onEvent: (event: AgentStreamEvent) => void | Promise<void>; /** When set, forces a structured response validated against this schema (AI SDK `Output.object`). */
+  outputSchema?: z.ZodType;
+};
+type StreamAgentPromptResult = {
+  messages: UIMessage[]; /** Plain-text assistant reply from this turn (AI SDK aggregated `text`). */
+  text: string;
+  error: string | null; /** Parsed structured result when {@link StreamAgentPromptOptions.outputSchema} was provided. */
+  output?: unknown;
+};
+/** Run one agent turn via AI SDK ToolLoopAgent; emits {@link AgentStreamEvent}s for persistence. */
+declare function streamAgentPrompt(config: AgentRunConfig, input: string, options: StreamAgentPromptOptions): Promise<StreamAgentPromptResult>; //#endregion
+//#region src/define/types.d.ts
+/** MCP defs vary by credential shape at authoring time. */
+type AgentMcpTool = McpDefinition<any>;
+/** Per-agent built-in web_search / web_fetch host tool options (each defaults to on). */
+type WebToolsOptions = {
+  search?: boolean;
+  fetch?: boolean;
+};
+/** Author-facing agent input — asset slugs resolve from src/skills/ and src/files/. */
+type AgentDefinitionBaseInput = AgentCreateInput & {
+  /** Discovery and route id for this agent (`POST /agents/{slug}`). */slug: string;
+  name?: string;
+  description?: string;
+  tools?: Array<ActionDefinition | AgentTool | AgentMcpTool | WorkflowDefinition | Agent>;
+  runtimeHooks?: RuntimeHooks; /** Skill folder names under `src/skills/{slug}/`. */
+  skills?: string[]; /** Sandbox layout, project files, and execution mode. */
+  sandbox?: SandboxDefinitionInput; /** Persistent memory (default on). Pass `false` to disable. */
+  memory?: false | DefaultMemoryOptions; /** Built-in web_search / web_fetch host tools (default on). Pass `false` to disable both. */
+  web?: false | WebToolsOptions;
+};
+/** Input to {@link defineAgent}. */
+type AgentDefinitionInput = AgentDefinitionBaseInput & {
+  name: string;
+  description: string;
+};
+/** Normalized agent definition used by the server (defaults applied). */
+type AgentDefinition = AgentCreateInput & {
+  tools?: Array<ActionDefinition | AgentTool | AgentMcpTool | WorkflowDefinition | Agent>;
+  runtimeHooks?: RuntimeHooks;
+  sandbox?: SandboxDefinition;
+  skills?: SkillDefinition[];
+  memory?: false | DefaultMemoryOptions;
+  web?: false | WebToolsOptions;
+};
+type PromptInput = {
+  message: string;
+  sessionId?: string;
+  subscriptionId?: string;
+  context?: CredentialRunContext;
+  files?: FileUIPart[];
+};
+type SessionLifecycleContext = {
+  agentId: string;
+  sessionId: string;
+};
+/** Optional hooks for host-side session transcript sync (e.g. object storage on the worker). */
+type SessionLifecycle = {
+  beforeRuntime?: (ctx: SessionLifecycleContext) => Promise<void>;
+  afterRuntime?: (ctx: SessionLifecycleContext) => Promise<void>;
+};
+/** Server-level overrides when mounting an agent or calling {@link Agent.prompt}. */
+type RunAgentPromptOptions = {
+  /**
+   * Internal: build-injected structural call-site id (the compiled `__site`
+   * property). Lines the agent step's runtime correlation id up with its canvas
+   * graph node. Never written by users.
+   */
+  __site?: string;
+  workspacesRoot?: string; /** Explicit host root backing `/workspace/agent`. Skips agent sandbox materialization when set. */
+  agentRoot?: string; /** Explicit host root backing `/workspace/session`. */
+  sessionRoot?: string;
+  /**
+   * @deprecated Use agentRoot.
+   * Explicit host root backing `/workspace/agent`.
+   */
+  workspaceRoot?: string; /** Overrides sandbox mode from {@link AgentDefinition.sandbox} for this call. */
+  mode?: SandboxMode;
+  runtimeHooks?: RuntimeHooks;
+  runtimeProvider?: RuntimeProvider;
+  vmRuntimeProvider?: RuntimeProvider;
+  memoryFactory?: MemoryFactory;
+  credentials?: CredentialRunContext;
+  oauthAdapter?: OAuthTokenAdapter;
+  memory?: false | DefaultMemoryOptions; /** Server-injected tools (e.g. trigger management) merged after the agent's own tools. */
+  hostTools?: AgentTool[]; /** Dry-run js-exec: resolve tool names but return `{}` without calling tools. */
+  stubInvokeTool?: boolean; /** Override js-exec host tool bridge (e.g. custom stubs). */
+  invokeTool?: InvokeToolCallback; /** 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; /** Host hooks around runtime setup/teardown (e.g. hydrate/persist session `.jsonl`). */
+  sessionLifecycle?: SessionLifecycle; /** IANA timezone for local-time context in the agent system prompt (e.g. `America/Los_Angeles`). */
+  timezone?: string; /** Server-side download hook for private chat attachment URLs (AI SDK `experimental_download`). */
+  experimentalDownload?: AgentExperimentalDownload; /** Native file parts for this prompt (programmatic callers or runtime-mapped attachments). */
+  files?: FileUIPart[];
+};
+type PromptResponse<TOutput = unknown> = {
+  sessionId: string;
+  messages: AgentMessage[]; /** Plain-text assistant reply from this prompt turn (AI SDK aggregated `text`). */
+  text: string;
+  error: string | null;
+  canceled?: boolean; /** Parsed structured result when the prompt was called with an `outputSchema`. */
+  output?: TOutput;
+}; //#endregion
+//#region src/define/resolve-tools.d.ts
+type McpConnectionHandle = {
+  close(): Promise<void>;
+};
+type ResolvedAgentTools = {
+  tools: AgentTool[]; /** Native AI SDK MCP tools merged across all servers, keyed by prefixed name. */
+  mcpToolSet: ToolSet;
+  mcpConnections: McpConnectionHandle[];
+};
+/**
+ * Parent execution context forwarded to workflow-as-tool and subagent-as-tool
+ * runs so a nested workflow/agent resolves credentials the same way it would
+ * when invoked directly.
+ */
+type AgentChildRunContext = {
+  credentials?: Partial<CredentialRunContext>;
+  oauthAdapter?: OAuthTokenAdapter;
+  actor?: {
+    userId?: string;
+  };
+};
+type ResolveAgentToolsOptions = {
+  mcpCredentialContext?: McpCredentialContext;
+  childContext?: AgentChildRunContext;
+};
+type AgentToolInput = ActionDefinition | AgentTool | AgentMcpTool | WorkflowDefinition | Agent;
+declare function resolveAgentTools(tools: AgentToolInput[], resolver: ToolCredentialResolver, options?: ResolveAgentToolsOptions): Promise<ResolvedAgentTools>; //#endregion
+//#region src/define/build-agent-runtime.d.ts
+type BuildAgentRuntimeContext = {
+  agentId: string;
+  sessionId: string;
+  messages?: AgentMessage[];
+};
+/** Sandbox + AI SDK run config — dispose {@link SandboxedAgentRuntime.sandbox} after each prompt. */
+type SandboxedAgentRuntime = {
+  runConfig: AgentRunConfig;
+  sandbox: Sandbox;
+  tools: AgentTool[];
+  mcpConnections: McpConnectionHandle[];
+  agentRoot: string;
+  sessionRoot: string;
+  agentId: string;
+  sessionId: string;
+  memory?: Memory;
+  takeCredentialError?: () => unknown;
+};
+/** Sandbox tools + host tools → pi agent from a {@link AgentDefinition}. */
+declare function buildAgentRuntime(def: AgentDefinition, ctx: BuildAgentRuntimeContext, runPrompt?: RunAgentPromptOptions, agentSlug?: string): Promise<SandboxedAgentRuntime>; //#endregion
+//#region src/define/define-agent.d.ts
+/** Optional structured-output schema; when set, `prompt` resolves a typed `output`. */
+type AgentPromptInput<S extends z.ZodType | undefined = undefined> = {
+  message: string;
+  sessionId?: string;
+  agentId?: string; /** Forces a structured response validated against this schema. */
+  outputSchema?: S;
+  files?: FileUIPart[];
+};
+type AgentPromptOutput<S extends z.ZodType | undefined> = S extends z.ZodType ? z.infer<S> : undefined;
+declare const AGENT: unique symbol;
+type Agent = AgentDefinition & {
+  /** Discovery and route id for this agent (`POST /agents/{slug}`). */slug: string;
+  name: string;
+  description: string; /** Per-request pi agent + sandbox from this definition. */
+  buildRuntime: (ctx: BuildAgentRuntimeContext, runPrompt?: RunAgentPromptOptions) => Promise<SandboxedAgentRuntime>;
+  prompt<S extends z.ZodType | undefined = undefined>(input: AgentPromptInput<S>, runPrompt?: RunAgentPromptOptions): Promise<PromptResponse<AgentPromptOutput<S>>>;
+  readonly [AGENT]: true;
+};
+declare function isAgent(value: unknown): value is Agent;
+/**
+ * Define an agent: normalized config plus a pipeline that builds sandbox + pi runtime on demand.
+ */
+declare function defineAgent(input: AgentDefinitionInput): Agent; //#endregion
+//#region src/run-direct-prompt.d.ts
+/** Resolves an agent id from the DB registry by slug when not passed explicitly. */
+declare function resolveAgentId(agentSlug: string, explicitId?: string): Promise<string>; //#endregion
+//#region src/define/run-prompt.d.ts
+declare function runAgentPrompt(agent: Agent, agentId: string, input: {
+  message: string;
+  sessionId?: string;
+  context?: RunAgentPromptOptions["credentials"];
+  outputSchema?: z.ZodType;
+  files?: FileUIPart[];
+}, 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, options?: {
+  ranByUserId?: string | null;
+}): Promise<{
+  sessionId: string;
+}>; //#endregion
+//#region src/define/normalize-definition.d.ts
+/** Normalizes optional agent fields for the server runtime. */
+declare function normalizeAgentDefinition(input: AgentDefinitionBaseInput, options?: {
+  agentSlug?: string;
+  appRoot?: string;
+}): AgentDefinition; //#endregion
+//#region src/ai/validate-agent-model-ids.d.ts
+/**
+ * Fail when any model id is unknown. Checks the committed catalog first (fast,
+ * offline) and only fetches the live catalog to confirm misses — so newly added
+ * gateway models still validate without a per-build network round-trip.
+ */
+declare function validateAgentModelIds(modelIds: readonly AgentModelId[]): Promise<void>;
+/** Collect agent model ids from a stored route manifest (deploy validation). */
+declare function agentModelIdsFromStoredManifest(manifest: StoredRouteManifest): AgentModelId[]; //#endregion
+//#region src/llm/run-llm.d.ts
+type RunLlmHooks = {
+  onUsage?: (usage: LlmUsageRecordInput) => void | Promise<void>;
+};
+/** One-shot LLM generation for workflow `promptLlm` steps (AI SDK transport). */
+declare function runLlm(opts: PromptLlmRunOptions, hooks?: RunLlmHooks): Promise<unknown>; //#endregion
+//#region src/define/resolve-agent-workspace-root.d.ts
+/**
+ * Resolve host directories backing `/workspace/agent` and `/workspace/session`.
+ *
+ * Precedence:
+ * 1. Explicit `agentRoot` / `sessionRoot` overrides — skips sandbox materialization.
+ * 2. Agent `sandbox` definition — materialize files to `{workspacesRoot}/agents/{agentId}/`.
+ * 3. Default agent + session dirs under `{workspacesRoot}/agents/` and `{workspacesRoot}/sessions/`.
+ *
+ * Agent skills always materialize into the agent root when configured.
+ */
+declare function resolveAgentWorkspaceRoot(agentId: string, sessionId: string, options: {
+  workspacesRoot?: string;
+  agentRoot?: string;
+  sessionRoot?: string; /** @deprecated Use agentRoot */
+  workspaceRoot?: string;
+  sandbox?: SandboxDefinition;
+  skills?: SkillDefinition[];
+}): Promise<AgentWorkspaceRoots>; //#endregion
+//#region src/define/resolve-agent-assets.d.ts
+type AgentAssetInput = {
+  skillKeys?: string[];
+  agentSlug?: string;
+  appRoot?: string;
+};
+type ResolvedAgentAssets = {
+  skills?: SkillDefinition[];
+};
+/** Resolve author-facing skill keys into packed skill definitions. */
+declare function resolveAgentAssets(input: AgentAssetInput): ResolvedAgentAssets; //#endregion
+//#endregion
+export { resolveAgentWorkspaceRoot as A, ThinkingLevelSchema as B, defineAgent as C, resolveAgentAssets as D, prepareAgentSession as E, AgentCreateInput as F, resolveAgentModel as H, AgentCreateInputSchema as I, AgentModelId as L, runLlm as M, streamAgentPrompt as N, resolveAgentId as O, validateAgentModelIds as P, AgentModelIdSchema as R, buildAgentRuntime as S, normalizeAgentDefinition as T, resolveModelCapabilities as U, parseAgentCreateInput as V, resolveThinkingLevel as W, SessionLifecycleContext as _, AgentDefinitionInput as a, WebToolsOptions as b, AgentToolInput as c, PromptResponse as d, ResolvedAgentAssets as f, SessionLifecycle as g, SessionAgentMismatchError as h, AgentDefinition as i, runAgentPrompt as j, resolveAgentTools as k, BuildAgentRuntimeContext as l, SandboxedAgentRuntime as m, Agent as n, AgentExperimentalDownload as o, RunAgentPromptOptions as p, AgentAssetInput as r, AgentRunConfig as s, AGENT as t, PromptInput as u, StreamAgentPromptOptions as v, isAgent as w, agentModelIdsFromStoredManifest as x, StreamAgentPromptResult as y, DEFAULT_THINKING_LEVEL as z };
+//# sourceMappingURL=index-DD1dNpCS.d.mts.map