agent-framework-js 0.1.1

package/dist/chunk-YBFLWRO5.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agents/loop.ts","../src/agents/agent.ts"],"names":["textMessage","ToolRegistry","SkillIndex","hasImage","ProviderError","composeMiddleware","Thread"],"mappings":"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","file":"chunk-YBFLWRO5.cjs","sourcesContent":["/**\n * The agent run loop: drives provider calls, executes requested tool calls,\n * feeds typed results (including errors, for self-correction) back to the model,\n * and stops on a final answer, the iteration cap, or an abort. (FR-011a, FR-012b)\n *\n * @packageDocumentation\n */\n\nimport type { Message } from \"../core/types.js\";\nimport { textMessage } from \"../core/types.js\";\nimport type { GenerateRequest, GenerateResponse } from \"../providers/provider.js\";\nimport type { ToolRegistry } from \"../tools/registry.js\";\n\n/** Outcome status of a run. */\nexport type RunStatus = \"completed\" | \"failed\" | \"incomplete\" | \"limit-exceeded\";\n\n/** A function that produces a model response (optionally through middleware). */\nexport type GenerateFn = (req: GenerateRequest) => Promise<GenerateResponse>;\n\n/** Settings controlling the loop. */\nexport interface LoopOptions {\n\t/** Maximum iterations; -1 means unlimited. Default 10. (FR-012b) */\n\tmaxIterations?: number;\n\t/** Per-tool-call timeout in ms. (FR-012c) */\n\ttoolTimeoutMs?: number;\n\t/** Abort signal. */\n\tsignal?: AbortSignal;\n}\n\n/** Result of running the loop. */\nexport interface LoopResult {\n\tmessages: Message[];\n\tfinal: GenerateResponse;\n\tstatus: RunStatus;\n}\n\n/**\n * Execute the tool-call loop against a generate function and tool registry.\n *\n * @param generate - Produces a model response (typically the middleware pipeline).\n * @param registry - Tools available to the agent (may be empty).\n * @param messages - Initial conversation (system + user, etc.).\n * @param options - Loop tuning.\n */\nexport async function runLoop(\n\tgenerate: GenerateFn,\n\tregistry: ToolRegistry,\n\tmessages: Message[],\n\toptions?: LoopOptions,\n): Promise<LoopResult> {\n\tconst maxIterations = options?.maxIterations ?? 10;\n\tconst working = [...messages];\n\tlet iteration = 0;\n\n\tfor (; ;) {\n\t\tif (maxIterations !== -1 && iteration >= maxIterations) {\n\t\t\treturn {\n\t\t\t\tmessages: working,\n\t\t\t\tfinal: { text: \"\" },\n\t\t\t\tstatus: \"limit-exceeded\",\n\t\t\t};\n\t\t}\n\t\titeration++;\n\n\t\tconst specs = registry.specs();\n\t\tconst response = await generate({\n\t\t\tmessages: working,\n\t\t\ttools: specs.length > 0 ? specs : undefined,\n\t\t\tsignal: options?.signal,\n\t\t});\n\n\t\tif (!response.toolCalls || response.toolCalls.length === 0) {\n\t\t\treturn { messages: working, final: response, status: \"completed\" };\n\t\t}\n\n\t\t// Record the assistant's tool-call turn.\n\t\tworking.push({\n\t\t\trole: \"assistant\",\n\t\t\tparts: response.text ? [{ type: \"text\", text: response.text }] : [],\n\t\t});\n\n\t\t// Execute each requested tool and feed results (or typed errors) back.\n\t\tfor (const call of response.toolCalls) {\n\t\t\tconst result = await registry.invoke(call.name, call.arguments, options?.toolTimeoutMs);\n\t\t\tconst payload = result.error\n\t\t\t\t? `ERROR (${result.error.reason}): ${result.error.message}`\n\t\t\t\t: JSON.stringify(result.value ?? null);\n\t\t\tworking.push({\n\t\t\t\trole: \"tool\",\n\t\t\t\tname: call.name,\n\t\t\t\ttoolCallId: call.id,\n\t\t\t\tparts: [{ type: \"text\", text: payload }],\n\t\t\t});\n\t\t}\n\t}\n}\n\n/** Build the initial message list from instructions + input. */\nexport function buildMessages(instructions: string, input: Message[]): Message[] {\n\treturn [textMessage(\"system\", instructions), ...input];\n}\n","/**\n * The agent: a configured actor that runs against a provider, optionally using\n * tools and skills, with streaming, reasoning output, multimodal input gating,\n * conversation threads with compaction, and a middleware pipeline.\n *\n * @packageDocumentation\n */\n\nimport type { Message, ContentPart } from \"../core/types.js\";\nimport { hasImage, textMessage } from \"../core/types.js\";\nimport { ProviderError } from \"../core/errors.js\";\nimport type { Provider, GenerateResponse, GenerateRequest } from \"../providers/provider.js\";\nimport { ToolRegistry } from \"../tools/registry.js\";\nimport type { Tool } from \"../tools/tool.js\";\nimport type { Skill } from \"../skills/skill.js\";\nimport { SkillIndex } from \"../skills/index.js\";\nimport type { Middleware, MiddlewareContext } from \"../middleware/middleware.js\";\nimport { composeMiddleware } from \"../middleware/middleware.js\";\nimport { Thread, type ThreadOptions } from \"./thread.js\";\nimport { runLoop, type RunStatus } from \"./loop.js\";\n\n/** Configuration for {@link createAgent}. */\nexport interface AgentConfig {\n\tname: string;\n\tinstructions: string;\n\tprovider: Provider;\n\ttools?: Tool[];\n\tskills?: Skill[];\n\t/** Max tool-call iterations per run; -1 = unlimited. Default 10. (FR-012b) */\n\tmaxIterations?: number;\n\t/** Per-tool-call timeout in ms. (FR-012c) */\n\ttoolTimeoutMs?: number;\n\t/** Compaction threshold as a fraction of maxInputTokens. Default 0.9. (FR-004a) */\n\tcompactionThreshold?: number;\n\t/** Optional override model for compaction summaries. (FR-004b) */\n\tcompactionModel?: Provider;\n\t/** Middleware applied around provider calls. (FR-023) */\n\tmiddleware?: Middleware[];\n}\n\n/** Options for a single run. */\nexport interface RunOptions {\n\t/** Continue an existing conversation. (FR-004) */\n\tthread?: Thread;\n\t/** Abort signal. */\n\tsignal?: AbortSignal;\n}\n\n/** The result of a non-streaming run. */\nexport interface RunResult {\n\toutput: string;\n\t/** Reasoning content — only for reasoning-capable models. (FR-003a) */\n\treasoning?: string;\n\tstatus: RunStatus;\n\t/** True when the run was interrupted before completing. (FR-003b) */\n\tpartial: boolean;\n\terror?: ProviderError;\n\t/** The thread used/updated by this run. */\n\tthread: Thread;\n}\n\n/** Streamed run chunk. */\nexport type RunChunk =\n\t| { type: \"text\"; text: string }\n\t| { type: \"reasoning\"; text: string }\n\t| { type: \"done\"; result: RunResult };\n\n/** Agent input: plain text or structured (multimodal) messages. (FR-002) */\nexport type AgentInput = string | Message | Message[];\n\n/** A runnable agent. */\nexport interface Agent {\n\treadonly name: string;\n\trun(input: AgentInput, opts?: RunOptions): Promise<RunResult>;\n\trunStream(input: AgentInput, opts?: RunOptions): AsyncIterable<RunChunk>;\n}\n\nfunction normalizeInput(input: AgentInput): Message[] {\n\tif (typeof input === \"string\") return [textMessage(\"user\", input)];\n\treturn Array.isArray(input) ? input : [input];\n}\n\nfunction promptText(messages: Message[]): string {\n\treturn messages\n\t\t.flatMap((m) => m.parts)\n\t\t.filter((p): p is { type: \"text\"; text: string } => p.type === \"text\")\n\t\t.map((p) => p.text)\n\t\t.join(\" \");\n}\n\n/**\n * Create an agent.\n *\n * @example\n * ```ts\n * const agent = createAgent({ name: \"Helper\", instructions: \"Be concise.\", provider });\n * const res = await agent.run(\"Say hello.\");\n * console.log(res.status, res.output);\n * ```\n */\nexport function createAgent(config: AgentConfig): Agent {\n\tconst registry = new ToolRegistry(config.tools ?? []);\n\tconst skillIndex = new SkillIndex(config.skills ?? []);\n\tconst middleware = config.middleware ?? [];\n\n\tfunction gateVision(messages: Message[]): void {\n\t\tif (!config.provider.capabilities.supportsVision && messages.some(hasImage)) {\n\t\t\tthrow new ProviderError(\n\t\t\t\t\"Image input was provided but the configured model does not support vision\",\n\t\t\t\t\"client\",\n\t\t\t);\n\t\t}\n\t}\n\n\tasync function injectSkills(userMessages: Message[]): Promise<Message[]> {\n\t\tif ((config.skills ?? []).length === 0) return userMessages;\n\t\tconst selected = skillIndex.select(promptText(userMessages));\n\t\tif (selected.length === 0) return userMessages;\n\t\tconst contents = await Promise.all(selected.map((s) => skillIndex.load(s)));\n\t\tconst skillBlock = textMessage(\n\t\t\t\"system\",\n\t\t\t`Relevant skill knowledge:\\n${contents.join(\"\\n\\n\")}`,\n\t\t);\n\t\treturn [skillBlock, ...userMessages];\n\t}\n\n\tasync function callProvider(req: GenerateRequest): Promise<GenerateResponse> {\n\t\tconst ctx: MiddlewareContext = {\n\t\t\tagentName: config.name,\n\t\t\trequest: req,\n\t\t};\n\t\tconst pipeline = composeMiddleware(middleware, (c) => config.provider.generate(c.request));\n\t\treturn pipeline(ctx);\n\t}\n\n\tasync function prepare(input: AgentInput, opts?: RunOptions): Promise<Thread> {\n\t\tconst userMessages = normalizeInput(input);\n\t\tgateVision(userMessages);\n\t\tconst thread =\n\t\t\topts?.thread ??\n\t\t\tnew Thread(undefined, [textMessage(\"system\", config.instructions)]);\n\t\tconst withSkills = await injectSkills(userMessages);\n\t\tfor (const m of withSkills) thread.add(m);\n\t\tawait thread.maybeCompact(config.provider, {\n\t\t\tcompactionThreshold: config.compactionThreshold,\n\t\t\tcompactionModel: config.compactionModel,\n\t\t} satisfies ThreadOptions);\n\t\treturn thread;\n\t}\n\n\tasync function run(input: AgentInput, opts?: RunOptions): Promise<RunResult> {\n\t\tlet thread: Thread;\n\t\ttry {\n\t\t\tthread = await prepare(input, opts);\n\t\t} catch (e) {\n\t\t\tif (e instanceof ProviderError) {\n\t\t\t\treturn { output: \"\", status: \"failed\", partial: false, error: e, thread: opts?.thread ?? new Thread() };\n\t\t\t}\n\t\t\tthrow e;\n\t\t}\n\n\t\ttry {\n\t\t\tconst loop = await runLoop(callProvider, registry, thread.messages, {\n\t\t\t\tmaxIterations: config.maxIterations,\n\t\t\t\ttoolTimeoutMs: config.toolTimeoutMs,\n\t\t\t\tsignal: opts?.signal,\n\t\t\t});\n\t\t\tif (loop.final.text) {\n\t\t\t\tthread.add({ role: \"assistant\", parts: [{ type: \"text\", text: loop.final.text }] });\n\t\t\t}\n\t\t\treturn {\n\t\t\t\toutput: loop.final.text,\n\t\t\t\treasoning: config.provider.capabilities.supportsReasoning ? loop.final.reasoning : undefined,\n\t\t\t\tstatus: loop.status,\n\t\t\t\tpartial: loop.status === \"incomplete\",\n\t\t\t\tthread,\n\t\t\t};\n\t\t} catch (e) {\n\t\t\tif (e instanceof ProviderError) {\n\t\t\t\treturn { output: \"\", status: \"failed\", partial: false, error: e, thread };\n\t\t\t}\n\t\t\tthrow e;\n\t\t}\n\t}\n\n\tasync function* runStream(input: AgentInput, opts?: RunOptions): AsyncIterable<RunChunk> {\n\t\t// Streaming path: single provider streaming call (tool loops use non-streaming\n\t\t// internally). Suitable for the common single-turn streaming case.\n\t\tlet thread: Thread;\n\t\ttry {\n\t\t\tthread = await prepare(input, opts);\n\t\t} catch (e) {\n\t\t\tif (e instanceof ProviderError) {\n\t\t\t\tyield { type: \"done\", result: { output: \"\", status: \"failed\", partial: false, error: e, thread: opts?.thread ?? new Thread() } };\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tthrow e;\n\t\t}\n\n\t\tlet text = \"\";\n\t\tlet reasoning = \"\";\n\t\ttry {\n\t\t\tfor await (const chunk of config.provider.generateStream({\n\t\t\t\tmessages: thread.messages,\n\t\t\t\ttools: registry.specs(),\n\t\t\t\tsignal: opts?.signal,\n\t\t\t})) {\n\t\t\t\tif (chunk.type === \"text\") {\n\t\t\t\t\ttext += chunk.text;\n\t\t\t\t\tyield { type: \"text\", text: chunk.text };\n\t\t\t\t} else if (chunk.type === \"reasoning\" && config.provider.capabilities.supportsReasoning) {\n\t\t\t\t\treasoning += chunk.text;\n\t\t\t\t\tyield { type: \"reasoning\", text: chunk.text };\n\t\t\t\t} else if (chunk.type === \"done\") {\n\t\t\t\t\ttext = chunk.response.text || text;\n\t\t\t\t\treasoning = chunk.response.reasoning || reasoning;\n\t\t\t\t}\n\t\t\t}\n\t\t} catch (e) {\n\t\t\tconst error = e instanceof ProviderError ? e : new ProviderError((e as Error).message, \"transient\");\n\t\t\tyield {\n\t\t\t\ttype: \"done\",\n\t\t\t\tresult: { output: text, status: \"incomplete\", partial: true, error, thread },\n\t\t\t};\n\t\t\treturn;\n\t\t}\n\n\t\tif (text) thread.add({ role: \"assistant\", parts: [{ type: \"text\", text }] });\n\t\tyield {\n\t\t\ttype: \"done\",\n\t\t\tresult: {\n\t\t\t\toutput: text,\n\t\t\t\treasoning: config.provider.capabilities.supportsReasoning ? reasoning || undefined : undefined,\n\t\t\t\tstatus: \"completed\",\n\t\t\t\tpartial: false,\n\t\t\t\tthread,\n\t\t\t},\n\t\t};\n\t}\n\n\treturn { name: config.name, run, runStream };\n}\n\nexport type { ContentPart };\n"]}

package/dist/chunk-YCBDEEAV.js

@@ -0,0 +1,82 @@
+// src/skills/skill.ts
+function defineSkill(skill) {
+  return skill;
+}
+async function loadSource(source) {
+  switch (source.kind) {
+    case "inline":
+      return source.content;
+    case "code":
+      return source.load();
+    case "file": {
+      const { readFile } = await import('fs/promises');
+      return readFile(source.path, "utf8");
+    }
+  }
+}
+
+// src/skills/index.ts
+var STOPWORDS = /* @__PURE__ */ new Set([
+  "the",
+  "a",
+  "an",
+  "and",
+  "or",
+  "of",
+  "to",
+  "in",
+  "for",
+  "on",
+  "is",
+  "are",
+  "with",
+  "how",
+  "what",
+  "do",
+  "does",
+  "i",
+  "you",
+  "it",
+  "this",
+  "that"
+]);
+function tokenize(text) {
+  return new Set(
+    text.toLowerCase().split(/[^a-z0-9]+/).filter((w) => w.length > 2 && !STOPWORDS.has(w))
+  );
+}
+var SkillIndex = class {
+  entries = [];
+  constructor(skills = []) {
+    for (const s of skills) this.add(s);
+  }
+  /** Add a skill to the index (description-only). */
+  add(skill) {
+    this.entries.push({ skill, tokens: tokenize(`${skill.name} ${skill.description}`) });
+  }
+  /**
+   * Select skills relevant to `prompt` by keyword overlap with their descriptions.
+   *
+   * @param prompt - The user prompt.
+   * @param minOverlap - Minimum overlapping tokens to count as relevant. Default 1.
+   */
+  select(prompt, minOverlap = 1) {
+    const promptTokens = tokenize(prompt);
+    const scored = [];
+    for (const { skill, tokens } of this.entries) {
+      let score = 0;
+      for (const t of tokens) if (promptTokens.has(t)) score++;
+      if (score >= minOverlap) scored.push({ skill, score });
+    }
+    return scored.sort((a, b) => b.score - a.score).map((s) => s.skill);
+  }
+  /** Load the full content of a selected skill (concatenated sources). (FR-017) */
+  async load(skill) {
+    const parts = await Promise.all(skill.sources.map(loadSource));
+    return parts.join("\n\n");
+  }
+};
+
+export { SkillIndex, defineSkill, loadSource };
+//# sourceMappingURL=chunk-YCBDEEAV.js.map
+//# sourceMappingURL=chunk-YCBDEEAV.js.map

package/dist/chunk-YCBDEEAV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/skills/skill.ts","../src/skills/index.ts"],"names":[],"mappings":"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","file":"chunk-YCBDEEAV.js","sourcesContent":["/**\n * Skills: domain-specific knowledge bundles attached to agents. Skills use\n * progressive disclosure — only a skill's short description is used to decide\n * relevance, and its full content is loaded only when the skill is deemed needed.\n * (FR-016, FR-017)\n *\n * @packageDocumentation\n */\n\n/** A source of skill content, loaded on demand. */\nexport type SkillSource =\n\t| { kind: \"inline\"; content: string }\n\t| { kind: \"file\"; path: string }\n\t| { kind: \"code\"; load: () => Promise<string> };\n\n/** A domain knowledge bundle. */\nexport interface Skill {\n\t/** Unique skill name. */\n\tname: string;\n\t/** Short description — the ONLY text used to decide relevance. (FR-017) */\n\tdescription: string;\n\t/** Content sources, read only when the skill is selected. */\n\tsources: SkillSource[];\n}\n\n/**\n * Define a skill.\n *\n * @example\n * ```ts\n * const refund = defineSkill({\n *   name: \"refund-policy\",\n *   description: \"Company refund and return rules.\",\n *   sources: [{ kind: \"inline\", content: \"Refunds allowed within 30 days...\" }],\n * });\n * ```\n */\nexport function defineSkill(skill: Skill): Skill {\n\treturn skill;\n}\n\n/** Read a single source's content. File sources require a Node runtime. */\nexport async function loadSource(source: SkillSource): Promise<string> {\n\tswitch (source.kind) {\n\t\tcase \"inline\":\n\t\t\treturn source.content;\n\t\tcase \"code\":\n\t\t\treturn source.load();\n\t\tcase \"file\": {\n\t\t\tconst { readFile } = await import(\"node:fs/promises\");\n\t\t\treturn readFile(source.path, \"utf8\");\n\t\t}\n\t}\n}\n","/**\n * Client-side keyword/text index over skill descriptions. No embeddings and no\n * extra provider — relevance is decided by simple token overlap so it runs fully\n * in the browser/edge. Full content is loaded only after a skill is selected.\n * (FR-017, FR-017a)\n *\n * @packageDocumentation\n */\n\nimport type { Skill } from \"./skill.js\";\nimport { loadSource } from \"./skill.js\";\n\nexport * from \"./skill.js\";\n\nconst STOPWORDS = new Set([\n\t\"the\", \"a\", \"an\", \"and\", \"or\", \"of\", \"to\", \"in\", \"for\", \"on\", \"is\", \"are\",\n\t\"with\", \"how\", \"what\", \"do\", \"does\", \"i\", \"you\", \"it\", \"this\", \"that\",\n]);\n\nfunction tokenize(text: string): Set<string> {\n\treturn new Set(\n\t\ttext\n\t\t\t.toLowerCase()\n\t\t\t.split(/[^a-z0-9]+/)\n\t\t\t.filter((w) => w.length > 2 && !STOPWORDS.has(w)),\n\t);\n}\n\n/** Indexes skills by description and selects relevant ones for a prompt. */\nexport class SkillIndex {\n\tprivate readonly entries: Array<{ skill: Skill; tokens: Set<string> }> = [];\n\n\tconstructor(skills: Skill[] = []) {\n\t\tfor (const s of skills) this.add(s);\n\t}\n\n\t/** Add a skill to the index (description-only). */\n\tadd(skill: Skill): void {\n\t\tthis.entries.push({ skill, tokens: tokenize(`${skill.name} ${skill.description}`) });\n\t}\n\n\t/**\n\t * Select skills relevant to `prompt` by keyword overlap with their descriptions.\n\t *\n\t * @param prompt - The user prompt.\n\t * @param minOverlap - Minimum overlapping tokens to count as relevant. Default 1.\n\t */\n\tselect(prompt: string, minOverlap = 1): Skill[] {\n\t\tconst promptTokens = tokenize(prompt);\n\t\tconst scored: Array<{ skill: Skill; score: number }> = [];\n\t\tfor (const { skill, tokens } of this.entries) {\n\t\t\tlet score = 0;\n\t\t\tfor (const t of tokens) if (promptTokens.has(t)) score++;\n\t\t\tif (score >= minOverlap) scored.push({ skill, score });\n\t\t}\n\t\treturn scored.sort((a, b) => b.score - a.score).map((s) => s.skill);\n\t}\n\n\t/** Load the full content of a selected skill (concatenated sources). (FR-017) */\n\tasync load(skill: Skill): Promise<string> {\n\t\tconst parts = await Promise.all(skill.sources.map(loadSource));\n\t\treturn parts.join(\"\\n\\n\");\n\t}\n}\n"]}

package/dist/chunk-YH5746OF.js

@@ -0,0 +1,69 @@
+import { requireCapability } from './chunk-ACBIHS5H.js';
+import { MCPError } from './chunk-IXV4UIF5.js';
+
+// src/mcp/adapter.ts
+function mcpToolToTool(serverId, def, client) {
+  return {
+    name: def.name,
+    description: def.description ?? "",
+    inputSchema: def.inputSchema,
+    source: serverId,
+    enabled: true,
+    async run(args) {
+      try {
+        const result = await client.callTool({ name: def.name, arguments: args });
+        return result.content ?? result;
+      } catch (e) {
+        throw new MCPError(`MCP tool "${def.name}" failed: ${e.message}`, serverId);
+      }
+    }
+  };
+}
+
+// src/mcp/connection.ts
+async function createTransport(config) {
+  if (config.transport.kind === "stdio") {
+    requireCapability("canSpawnProcess", "MCP stdio transport");
+    const { StdioClientTransport } = await import('@modelcontextprotocol/sdk/client/stdio.js');
+    return new StdioClientTransport({
+      command: config.transport.command,
+      args: config.transport.args ?? []
+    });
+  }
+  const { StreamableHTTPClientTransport } = await import('@modelcontextprotocol/sdk/client/streamableHttp.js');
+  return new StreamableHTTPClientTransport(new URL(config.transport.url));
+}
+async function connectMCP(config) {
+  let client;
+  async function connect() {
+    try {
+      const { Client } = await import('@modelcontextprotocol/sdk/client/index.js');
+      const transport = await createTransport(config);
+      client = new Client({ name: "agent-framework-js", version: "0.1.0" }, { capabilities: {} });
+      await client.connect(transport);
+    } catch (e) {
+      if (e.name === "RuntimeUnsupportedError") throw e;
+      throw new MCPError(`Failed to connect to MCP server: ${e.message}`, config.id);
+    }
+  }
+  async function listTools() {
+    if (!client) throw new MCPError("Not connected", config.id);
+    try {
+      const result = await client.listTools();
+      return (result.tools ?? []).map(
+        (t) => mcpToolToTool(config.id, t, client)
+      );
+    } catch (e) {
+      throw new MCPError(`Failed to list tools: ${e.message}`, config.id);
+    }
+  }
+  async function close() {
+    await client?.close?.();
+    client = void 0;
+  }
+  return { id: config.id, connect, listTools, close };
+}
+
+export { connectMCP, mcpToolToTool };
+//# sourceMappingURL=chunk-YH5746OF.js.map
+//# sourceMappingURL=chunk-YH5746OF.js.map

package/dist/chunk-YH5746OF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mcp/adapter.ts","../src/mcp/connection.ts"],"names":[],"mappings":"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","file":"chunk-YH5746OF.js","sourcesContent":["/**\n * Adapts MCP-provided tools onto the framework's uniform {@link Tool} contract,\n * namespaced by the connection id so collisions are impossible. (FR-014, FR-014a)\n *\n * @packageDocumentation\n */\n\nimport type { Tool } from \"../tools/tool.js\";\nimport { MCPError } from \"../core/errors.js\";\n\ninterface MCPToolDef {\n\tname: string;\n\tdescription?: string;\n\tinputSchema: Record<string, unknown>;\n}\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n/**\n * Wrap an MCP tool definition as a framework tool. Invocation calls back through\n * the MCP client; failures surface as typed {@link MCPError}/tool errors.\n */\nexport function mcpToolToTool(serverId: string, def: MCPToolDef, client: any): Tool {\n\treturn {\n\t\tname: def.name,\n\t\tdescription: def.description ?? \"\",\n\t\tinputSchema: def.inputSchema,\n\t\tsource: serverId,\n\t\tenabled: true,\n\t\tasync run(args: unknown): Promise<unknown> {\n\t\t\ttry {\n\t\t\t\tconst result = await client.callTool({ name: def.name, arguments: args });\n\t\t\t\treturn result.content ?? result;\n\t\t\t} catch (e) {\n\t\t\t\tthrow new MCPError(`MCP tool \"${def.name}\" failed: ${(e as Error).message}`, serverId);\n\t\t\t}\n\t\t},\n\t};\n}\n","/**\n * MCP (Model Context Protocol) integration. Connects to MCP servers and exposes\n * their tools through the framework's uniform tool interface.\n *\n * Remote transport (HTTP/SSE) works in all runtimes; stdio (spawning a server\n * process) works only where process spawning is permitted (Node). Requesting\n * stdio elsewhere throws a typed {@link RuntimeUnsupportedError}. (FR-013, FR-013a,\n * FR-013b, FR-030a)\n *\n * The `@modelcontextprotocol/sdk` package is an optional peer dependency and is\n * loaded lazily so browser bundles that do not use MCP pay no cost.\n *\n * @packageDocumentation\n */\n\nimport { MCPError } from \"../core/errors.js\";\nimport { requireCapability } from \"../core/runtime.js\";\nimport type { Tool } from \"../tools/tool.js\";\nimport { mcpToolToTool } from \"./adapter.js\";\n\n/** Transport options for an MCP connection. */\nexport type MCPTransport =\n\t| { kind: \"remote\"; url: string }\n\t| { kind: \"stdio\"; command: string; args?: string[] };\n\n/** Configuration for connecting to an MCP server. */\nexport interface MCPConnectionConfig {\n\t/** Connection id; becomes the namespace prefix for discovered tools. (FR-014a) */\n\tid: string;\n\ttransport: MCPTransport;\n\t/** Whether the connection's tools are enabled. Defaults to true. */\n\tenabled?: boolean;\n}\n\n/** A live connection to an MCP server. */\nexport interface MCPConnection {\n\treadonly id: string;\n\tconnect(): Promise<void>;\n\tlistTools(): Promise<Tool[]>;\n\tclose(): Promise<void>;\n}\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\ntype AnyClient = any;\n\nasync function createTransport(config: MCPConnectionConfig): Promise<AnyClient> {\n\tif (config.transport.kind === \"stdio\") {\n\t\t// Gate on runtime capability before attempting to spawn. (FR-013b, FR-030a)\n\t\trequireCapability(\"canSpawnProcess\", \"MCP stdio transport\");\n\t\tconst { StdioClientTransport } = await import(\n\t\t\t\"@modelcontextprotocol/sdk/client/stdio.js\"\n\t\t);\n\t\treturn new StdioClientTransport({\n\t\t\tcommand: config.transport.command,\n\t\t\targs: config.transport.args ?? [],\n\t\t});\n\t}\n\tconst { StreamableHTTPClientTransport } = await import(\n\t\t\"@modelcontextprotocol/sdk/client/streamableHttp.js\"\n\t);\n\treturn new StreamableHTTPClientTransport(new URL(config.transport.url));\n}\n\n/**\n * Connect to an MCP server.\n *\n * @example\n * ```ts\n * const mcp = await connectMCP({ id: \"docs\", transport: { kind: \"remote\", url: \"https://mcp.example.com\" } });\n * const tools = await mcp.listTools(); // namespaced as docs.<tool>\n * ```\n */\nexport async function connectMCP(config: MCPConnectionConfig): Promise<MCPConnection> {\n\tlet client: AnyClient | undefined;\n\n\tasync function connect(): Promise<void> {\n\t\ttry {\n\t\t\tconst { Client } = await import(\"@modelcontextprotocol/sdk/client/index.js\");\n\t\t\tconst transport = await createTransport(config);\n\t\t\tclient = new Client({ name: \"agent-framework-js\", version: \"0.1.0\" }, { capabilities: {} });\n\t\t\tawait client.connect(transport);\n\t\t} catch (e) {\n\t\t\t// Preserve typed runtime errors; wrap everything else as an MCP error.\n\t\t\tif ((e as Error).name === \"RuntimeUnsupportedError\") throw e;\n\t\t\tthrow new MCPError(`Failed to connect to MCP server: ${(e as Error).message}`, config.id);\n\t\t}\n\t}\n\n\tasync function listTools(): Promise<Tool[]> {\n\t\tif (!client) throw new MCPError(\"Not connected\", config.id);\n\t\ttry {\n\t\t\tconst result = await client.listTools();\n\t\t\treturn (result.tools ?? []).map((t: { name: string; description?: string; inputSchema: Record<string, unknown> }) =>\n\t\t\t\tmcpToolToTool(config.id, t, client),\n\t\t\t);\n\t\t} catch (e) {\n\t\t\tthrow new MCPError(`Failed to list tools: ${(e as Error).message}`, config.id);\n\t\t}\n\t}\n\n\tasync function close(): Promise<void> {\n\t\tawait client?.close?.();\n\t\tclient = undefined;\n\t}\n\n\treturn { id: config.id, connect, listTools, close };\n}\n"]}

package/dist/chunk-YKZJRE32.cjs

@@ -0,0 +1,50 @@
+'use strict';
+
+var chunkYBFLWRO5_cjs = require('./chunk-YBFLWRO5.cjs');
+var chunkMQ2XTH3S_cjs = require('./chunk-MQ2XTH3S.cjs');
+
+// src/declarative/loader.ts
+function looksLikeJson(source) {
+  const t = source.trimStart();
+  return t.startsWith("{") || t.startsWith("[");
+}
+async function parse(source) {
+  if (looksLikeJson(source)) {
+    try {
+      return JSON.parse(source);
+    } catch (e) {
+      throw new chunkMQ2XTH3S_cjs.ValidationError(`Invalid JSON definition: ${e.message}`);
+    }
+  }
+  const YAML = await import('yaml');
+  try {
+    return YAML.parse(source);
+  } catch (e) {
+    throw new chunkMQ2XTH3S_cjs.ValidationError(`Invalid YAML definition: ${e.message}`);
+  }
+}
+function assertDefinition(value) {
+  const d = value;
+  if (!d || typeof d.name !== "string" || typeof d.instructions !== "string" || !d.provider) {
+    throw new chunkMQ2XTH3S_cjs.ValidationError("Definition must include name, instructions, and provider");
+  }
+}
+async function loadAgentDefinition(source, deps) {
+  const parsed = await parse(source);
+  assertDefinition(parsed);
+  const provider = deps.providerFactory(parsed.provider, deps.getCredential);
+  const tools = (parsed.tools ?? []).map((name) => deps.tools?.[name]).filter((t) => !!t);
+  const skills = (parsed.skills ?? []).map((name) => deps.skills?.[name]).filter((s) => !!s);
+  return chunkYBFLWRO5_cjs.createAgent({
+    name: parsed.name,
+    instructions: parsed.instructions,
+    provider,
+    tools,
+    skills,
+    maxIterations: parsed.maxIterations
+  });
+}
+
+exports.loadAgentDefinition = loadAgentDefinition;
+//# sourceMappingURL=chunk-YKZJRE32.cjs.map
+//# sourceMappingURL=chunk-YKZJRE32.cjs.map

package/dist/chunk-YKZJRE32.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/declarative/loader.ts"],"names":["ValidationError","createAgent"],"mappings":";;;;;;AA+CA,SAAS,cAAc,MAAA,EAAyB;AAC/C,EAAA,MAAM,CAAA,GAAI,OAAO,SAAA,EAAU;AAC3B,EAAA,OAAO,EAAE,UAAA,CAAW,GAAG,CAAA,IAAK,CAAA,CAAE,WAAW,GAAG,CAAA;AAC7C;AAEA,eAAe,MAAM,MAAA,EAAkC;AACtD,EAAA,IAAI,aAAA,CAAc,MAAM,CAAA,EAAG;AAC1B,IAAA,IAAI;AACH,MAAA,OAAO,IAAA,CAAK,MAAM,MAAM,CAAA;AAAA,IACzB,SAAS,CAAA,EAAG;AACX,MAAA,MAAM,IAAIA,iCAAA,CAAgB,CAAA,yBAAA,EAA6B,CAAA,CAAY,OAAO,CAAA,CAAE,CAAA;AAAA,IAC7E;AAAA,EACD;AAEA,EAAA,MAAM,IAAA,GAAO,MAAM,OAAO,MAAM,CAAA;AAChC,EAAA,IAAI;AACH,IAAA,OAAO,IAAA,CAAK,MAAM,MAAM,CAAA;AAAA,EACzB,SAAS,CAAA,EAAG;AACX,IAAA,MAAM,IAAIA,iCAAA,CAAgB,CAAA,yBAAA,EAA6B,CAAA,CAAY,OAAO,CAAA,CAAE,CAAA;AAAA,EAC7E;AACD;AAEA,SAAS,iBAAiB,KAAA,EAAkD;AAC3E,EAAA,MAAM,CAAA,GAAI,KAAA;AACV,EAAA,IAAI,CAAC,CAAA,IAAK,OAAO,CAAA,CAAE,IAAA,KAAS,QAAA,IAAY,OAAO,CAAA,CAAE,YAAA,KAAiB,QAAA,IAAY,CAAC,CAAA,CAAE,QAAA,EAAU;AAC1F,IAAA,MAAM,IAAIA,kCAAgB,0DAA0D,CAAA;AAAA,EACrF;AACD;AAaA,eAAsB,mBAAA,CAAoB,QAAgB,IAAA,EAAkC;AAC3F,EAAA,MAAM,MAAA,GAAS,MAAM,KAAA,CAAM,MAAM,CAAA;AACjC,EAAA,gBAAA,CAAiB,MAAM,CAAA;AAEvB,EAAA,MAAM,WAAW,IAAA,CAAK,eAAA,CAAgB,MAAA,CAAO,QAAA,EAAU,KAAK,aAAa,CAAA;AACzE,EAAA,MAAM,SAAS,MAAA,CAAO,KAAA,IAAS,EAAC,EAC9B,GAAA,CAAI,CAAC,IAAA,KAAS,IAAA,CAAK,KAAA,GAAQ,IAAI,CAAC,CAAA,CAChC,MAAA,CAAO,CAAC,CAAA,KAAiB,CAAC,CAAC,CAAC,CAAA;AAC9B,EAAA,MAAM,UAAU,MAAA,CAAO,MAAA,IAAU,EAAC,EAChC,GAAA,CAAI,CAAC,IAAA,KAAS,IAAA,CAAK,MAAA,GAAS,IAAI,CAAC,CAAA,CACjC,MAAA,CAAO,CAAC,CAAA,KAAkB,CAAC,CAAC,CAAC,CAAA;AAE/B,EAAA,OAAOC,6BAAA,CAAY;AAAA,IAClB,MAAM,MAAA,CAAO,IAAA;AAAA,IACb,cAAc,MAAA,CAAO,YAAA;AAAA,IACrB,QAAA;AAAA,IACA,KAAA;AAAA,IACA,MAAA;AAAA,IACA,eAAe,MAAA,CAAO;AAAA,GACtB,CAAA;AACF","file":"chunk-YKZJRE32.cjs","sourcesContent":["/**\n * Declarative agent definitions. Agents can be defined in YAML or JSON against a\n * single shared schema; the loader auto-detects the format (the YAML parser is\n * lazy-loaded so JSON-only/browser use pays no cost) and builds an equivalent\n * runnable agent. Credentials are still injected via callback, never embedded.\n * (FR-027, FR-005a)\n *\n * @packageDocumentation\n */\n\nimport type { ModelCapabilities } from \"../core/types.js\";\nimport type { Provider } from \"../providers/provider.js\";\nimport type { Tool } from \"../tools/tool.js\";\nimport type { Skill } from \"../skills/skill.js\";\nimport { createAgent, type Agent } from \"../agents/agent.js\";\nimport { ValidationError } from \"../core/errors.js\";\n\n/** Provider section of a declarative definition. */\nexport interface ProviderDefinition extends ModelCapabilities {\n\ttype: \"copilot\" | \"openai-compatible\";\n\tbaseUrl?: string;\n}\n\n/** A declarative agent definition (shared by YAML and JSON). */\nexport interface AgentDefinition {\n\tname: string;\n\tinstructions: string;\n\tprovider: ProviderDefinition;\n\t/** Names referencing tools provided in `deps.tools`. */\n\ttools?: string[];\n\t/** Names referencing skills provided in `deps.skills`. */\n\tskills?: string[];\n\tmaxIterations?: number;\n}\n\n/** Dependencies the loader needs to construct a live agent. */\nexport interface LoaderDeps {\n\t/** Build a provider from the definition + injected credential. */\n\tproviderFactory: (def: ProviderDefinition, getCredential: () => string | Promise<string>) => Provider;\n\t/** Credential callback — never embedded in the definition. (FR-005a) */\n\tgetCredential: () => string | Promise<string>;\n\t/** Registered tools available for reference by name. */\n\ttools?: Record<string, Tool>;\n\t/** Registered skills available for reference by name. */\n\tskills?: Record<string, Skill>;\n}\n\nfunction looksLikeJson(source: string): boolean {\n\tconst t = source.trimStart();\n\treturn t.startsWith(\"{\") || t.startsWith(\"[\");\n}\n\nasync function parse(source: string): Promise<unknown> {\n\tif (looksLikeJson(source)) {\n\t\ttry {\n\t\t\treturn JSON.parse(source);\n\t\t} catch (e) {\n\t\t\tthrow new ValidationError(`Invalid JSON definition: ${(e as Error).message}`);\n\t\t}\n\t}\n\t// Lazy-load the YAML parser only when needed. (FR-027)\n\tconst YAML = await import(\"yaml\");\n\ttry {\n\t\treturn YAML.parse(source);\n\t} catch (e) {\n\t\tthrow new ValidationError(`Invalid YAML definition: ${(e as Error).message}`);\n\t}\n}\n\nfunction assertDefinition(value: unknown): asserts value is AgentDefinition {\n\tconst d = value as Partial<AgentDefinition>;\n\tif (!d || typeof d.name !== \"string\" || typeof d.instructions !== \"string\" || !d.provider) {\n\t\tthrow new ValidationError(\"Definition must include name, instructions, and provider\");\n\t}\n}\n\n/**\n * Load an agent from a YAML or JSON definition string.\n *\n * @example\n * ```ts\n * const agent = await loadAgentDefinition(yamlOrJson, {\n *   providerFactory,\n *   getCredential: () => process.env.LMSTUDIO_KEY ?? \"\",\n * });\n * ```\n */\nexport async function loadAgentDefinition(source: string, deps: LoaderDeps): Promise<Agent> {\n\tconst parsed = await parse(source);\n\tassertDefinition(parsed);\n\n\tconst provider = deps.providerFactory(parsed.provider, deps.getCredential);\n\tconst tools = (parsed.tools ?? [])\n\t\t.map((name) => deps.tools?.[name])\n\t\t.filter((t): t is Tool => !!t);\n\tconst skills = (parsed.skills ?? [])\n\t\t.map((name) => deps.skills?.[name])\n\t\t.filter((s): s is Skill => !!s);\n\n\treturn createAgent({\n\t\tname: parsed.name,\n\t\tinstructions: parsed.instructions,\n\t\tprovider,\n\t\ttools,\n\t\tskills,\n\t\tmaxIterations: parsed.maxIterations,\n\t});\n}\n"]}

package/dist/declarative/index.cjs

@@ -0,0 +1,19 @@
+'use strict';
+
+var chunkYKZJRE32_cjs = require('../chunk-YKZJRE32.cjs');
+require('../chunk-YBFLWRO5.cjs');
+require('../chunk-WSMYH2IN.cjs');
+require('../chunk-TAMJ5HSR.cjs');
+require('../chunk-FSDMBWQV.cjs');
+require('../chunk-LMN75W3W.cjs');
+require('../chunk-MQ2XTH3S.cjs');
+require('../chunk-IJASUMIQ.cjs');
+
+
+
+Object.defineProperty(exports, "loadAgentDefinition", {
+  enumerable: true,
+  get: function () { return chunkYKZJRE32_cjs.loadAgentDefinition; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/declarative/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/dist/declarative/index.d.cts

@@ -0,0 +1,60 @@
+import { a as ModelCapabilities } from '../types-Cn1g9Tg4.cjs';
+import { P as Provider } from '../provider-CMAymr1b.cjs';
+import { T as Tool } from '../tool-BZg_znMZ.cjs';
+import { S as Skill } from '../skill-DfNChtJN.cjs';
+import { A as Agent } from '../index-DdYZeNIu.cjs';
+import '../errors-CjVz4W_5.cjs';
+import '../thread-Dfo9LLf7.cjs';
+import '../registry-D4fThGiN.cjs';
+
+/**
+ * Declarative agent definitions. Agents can be defined in YAML or JSON against a
+ * single shared schema; the loader auto-detects the format (the YAML parser is
+ * lazy-loaded so JSON-only/browser use pays no cost) and builds an equivalent
+ * runnable agent. Credentials are still injected via callback, never embedded.
+ * (FR-027, FR-005a)
+ *
+ * @packageDocumentation
+ */
+
+/** Provider section of a declarative definition. */
+interface ProviderDefinition extends ModelCapabilities {
+    type: "copilot" | "openai-compatible";
+    baseUrl?: string;
+}
+/** A declarative agent definition (shared by YAML and JSON). */
+interface AgentDefinition {
+    name: string;
+    instructions: string;
+    provider: ProviderDefinition;
+    /** Names referencing tools provided in `deps.tools`. */
+    tools?: string[];
+    /** Names referencing skills provided in `deps.skills`. */
+    skills?: string[];
+    maxIterations?: number;
+}
+/** Dependencies the loader needs to construct a live agent. */
+interface LoaderDeps {
+    /** Build a provider from the definition + injected credential. */
+    providerFactory: (def: ProviderDefinition, getCredential: () => string | Promise<string>) => Provider;
+    /** Credential callback — never embedded in the definition. (FR-005a) */
+    getCredential: () => string | Promise<string>;
+    /** Registered tools available for reference by name. */
+    tools?: Record<string, Tool>;
+    /** Registered skills available for reference by name. */
+    skills?: Record<string, Skill>;
+}
+/**
+ * Load an agent from a YAML or JSON definition string.
+ *
+ * @example
+ * ```ts
+ * const agent = await loadAgentDefinition(yamlOrJson, {
+ *   providerFactory,
+ *   getCredential: () => process.env.LMSTUDIO_KEY ?? "",
+ * });
+ * ```
+ */
+declare function loadAgentDefinition(source: string, deps: LoaderDeps): Promise<Agent>;
+
+export { type AgentDefinition, type LoaderDeps, type ProviderDefinition, loadAgentDefinition };

package/dist/declarative/index.d.ts

@@ -0,0 +1,60 @@
+import { a as ModelCapabilities } from '../types-Cn1g9Tg4.js';
+import { P as Provider } from '../provider-osAtfZ7x.js';
+import { T as Tool } from '../tool-CSCC87OD.js';
+import { S as Skill } from '../skill-DfNChtJN.js';
+import { A as Agent } from '../index-D7-znzrc.js';
+import '../errors-CjVz4W_5.js';
+import '../thread-CWVzTyti.js';
+import '../registry-CpO0yH5v.js';
+
+/**
+ * Declarative agent definitions. Agents can be defined in YAML or JSON against a
+ * single shared schema; the loader auto-detects the format (the YAML parser is
+ * lazy-loaded so JSON-only/browser use pays no cost) and builds an equivalent
+ * runnable agent. Credentials are still injected via callback, never embedded.
+ * (FR-027, FR-005a)
+ *
+ * @packageDocumentation
+ */
+
+/** Provider section of a declarative definition. */
+interface ProviderDefinition extends ModelCapabilities {
+    type: "copilot" | "openai-compatible";
+    baseUrl?: string;
+}
+/** A declarative agent definition (shared by YAML and JSON). */
+interface AgentDefinition {
+    name: string;
+    instructions: string;
+    provider: ProviderDefinition;
+    /** Names referencing tools provided in `deps.tools`. */
+    tools?: string[];
+    /** Names referencing skills provided in `deps.skills`. */
+    skills?: string[];
+    maxIterations?: number;
+}
+/** Dependencies the loader needs to construct a live agent. */
+interface LoaderDeps {
+    /** Build a provider from the definition + injected credential. */
+    providerFactory: (def: ProviderDefinition, getCredential: () => string | Promise<string>) => Provider;
+    /** Credential callback — never embedded in the definition. (FR-005a) */
+    getCredential: () => string | Promise<string>;
+    /** Registered tools available for reference by name. */
+    tools?: Record<string, Tool>;
+    /** Registered skills available for reference by name. */
+    skills?: Record<string, Skill>;
+}
+/**
+ * Load an agent from a YAML or JSON definition string.
+ *
+ * @example
+ * ```ts
+ * const agent = await loadAgentDefinition(yamlOrJson, {
+ *   providerFactory,
+ *   getCredential: () => process.env.LMSTUDIO_KEY ?? "",
+ * });
+ * ```
+ */
+declare function loadAgentDefinition(source: string, deps: LoaderDeps): Promise<Agent>;
+
+export { type AgentDefinition, type LoaderDeps, type ProviderDefinition, loadAgentDefinition };

package/dist/declarative/index.js

@@ -0,0 +1,10 @@
+export { loadAgentDefinition } from '../chunk-VLSVL5N2.js';
+import '../chunk-RD5YUB2E.js';
+import '../chunk-YCBDEEAV.js';
+import '../chunk-HGEPXJDG.js';
+import '../chunk-7ZXUIHLH.js';
+import '../chunk-XPXTXOYQ.js';
+import '../chunk-IXV4UIF5.js';
+import '../chunk-DEABART4.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/declarative/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/errors-CjVz4W_5.d.cts

@@ -0,0 +1,68 @@
+/**
+ * Typed error hierarchy. Every failure surfaced by the framework is one of these
+ * typed errors so callers (and agents) can branch on `kind` rather than parsing
+ * messages. All error serialization passes through redaction (see `redaction.ts`).
+ *
+ * @packageDocumentation
+ */
+/** Discriminator for {@link FrameworkError} subclasses. */
+type ErrorKind = "provider" | "tool" | "mcp" | "checkpoint" | "runtime-unsupported" | "validation";
+/** Base class for all framework errors. */
+declare abstract class FrameworkError extends Error {
+    abstract readonly kind: ErrorKind;
+    /** Optional structured details (already redaction-safe at serialization time). */
+    readonly details?: Record<string, unknown>;
+    constructor(message: string, details?: Record<string, unknown>);
+    /** Redaction-safe JSON form used by logs/traces. */
+    toJSON(): Record<string, unknown>;
+}
+/** Reason a provider call failed. Transient reasons are retryable. */
+type ProviderErrorReason = "transient" | "auth" | "client" | "malformed";
+/** LLM provider failure. (FR-008a) */
+declare class ProviderError extends FrameworkError {
+    readonly kind: "provider";
+    readonly reason: ProviderErrorReason;
+    readonly status?: number;
+    constructor(message: string, reason: ProviderErrorReason, opts?: {
+        status?: number;
+        details?: Record<string, unknown>;
+    });
+    /** Whether this error should be retried with backoff. */
+    get retryable(): boolean;
+}
+/** Reason a tool invocation failed. */
+type ToolErrorReason = "not-found" | "invalid-arguments" | "timeout" | "run-failure";
+/** Tool invocation failure. (FR-011a, FR-012c) */
+declare class ToolError extends FrameworkError {
+    readonly kind: "tool";
+    readonly reason: ToolErrorReason;
+    readonly toolName: string;
+    constructor(message: string, reason: ToolErrorReason, toolName: string, details?: Record<string, unknown>);
+}
+/** MCP server failure (e.g., unavailable). (FR-015) */
+declare class MCPError extends FrameworkError {
+    readonly kind: "mcp";
+    readonly serverId: string;
+    constructor(message: string, serverId: string, details?: Record<string, unknown>);
+}
+/** Reason a checkpoint could not be restored. (FR-022a) */
+type CheckpointErrorReason = "corrupt" | "version-mismatch";
+/** Checkpoint restore failure. Fails closed — no partial restore. */
+declare class CheckpointError extends FrameworkError {
+    readonly kind: "checkpoint";
+    readonly reason: CheckpointErrorReason;
+    constructor(message: string, reason: CheckpointErrorReason, details?: Record<string, unknown>);
+}
+/** A feature was requested that the current runtime cannot support. (FR-030a) */
+declare class RuntimeUnsupportedError extends FrameworkError {
+    readonly kind: "runtime-unsupported";
+    readonly feature: string;
+    constructor(feature: string, details?: Record<string, unknown>);
+}
+/** Schema validation failure. (FR-011) */
+declare class ValidationError extends FrameworkError {
+    readonly kind: "validation";
+    constructor(message: string, details?: Record<string, unknown>);
+}
+
+export { CheckpointError as C, type ErrorKind as E, FrameworkError as F, MCPError as M, ProviderError as P, RuntimeUnsupportedError as R, ToolError as T, ValidationError as V, type CheckpointErrorReason as a, type ProviderErrorReason as b, type ToolErrorReason as c };

package/dist/errors-CjVz4W_5.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Typed error hierarchy. Every failure surfaced by the framework is one of these
+ * typed errors so callers (and agents) can branch on `kind` rather than parsing
+ * messages. All error serialization passes through redaction (see `redaction.ts`).
+ *
+ * @packageDocumentation
+ */
+/** Discriminator for {@link FrameworkError} subclasses. */
+type ErrorKind = "provider" | "tool" | "mcp" | "checkpoint" | "runtime-unsupported" | "validation";
+/** Base class for all framework errors. */
+declare abstract class FrameworkError extends Error {
+    abstract readonly kind: ErrorKind;
+    /** Optional structured details (already redaction-safe at serialization time). */
+    readonly details?: Record<string, unknown>;
+    constructor(message: string, details?: Record<string, unknown>);
+    /** Redaction-safe JSON form used by logs/traces. */
+    toJSON(): Record<string, unknown>;
+}
+/** Reason a provider call failed. Transient reasons are retryable. */
+type ProviderErrorReason = "transient" | "auth" | "client" | "malformed";
+/** LLM provider failure. (FR-008a) */
+declare class ProviderError extends FrameworkError {
+    readonly kind: "provider";
+    readonly reason: ProviderErrorReason;
+    readonly status?: number;
+    constructor(message: string, reason: ProviderErrorReason, opts?: {
+        status?: number;
+        details?: Record<string, unknown>;
+    });
+    /** Whether this error should be retried with backoff. */
+    get retryable(): boolean;
+}
+/** Reason a tool invocation failed. */
+type ToolErrorReason = "not-found" | "invalid-arguments" | "timeout" | "run-failure";
+/** Tool invocation failure. (FR-011a, FR-012c) */
+declare class ToolError extends FrameworkError {
+    readonly kind: "tool";
+    readonly reason: ToolErrorReason;
+    readonly toolName: string;
+    constructor(message: string, reason: ToolErrorReason, toolName: string, details?: Record<string, unknown>);
+}
+/** MCP server failure (e.g., unavailable). (FR-015) */
+declare class MCPError extends FrameworkError {
+    readonly kind: "mcp";
+    readonly serverId: string;
+    constructor(message: string, serverId: string, details?: Record<string, unknown>);
+}
+/** Reason a checkpoint could not be restored. (FR-022a) */
+type CheckpointErrorReason = "corrupt" | "version-mismatch";
+/** Checkpoint restore failure. Fails closed — no partial restore. */
+declare class CheckpointError extends FrameworkError {
+    readonly kind: "checkpoint";
+    readonly reason: CheckpointErrorReason;
+    constructor(message: string, reason: CheckpointErrorReason, details?: Record<string, unknown>);
+}
+/** A feature was requested that the current runtime cannot support. (FR-030a) */
+declare class RuntimeUnsupportedError extends FrameworkError {
+    readonly kind: "runtime-unsupported";
+    readonly feature: string;
+    constructor(feature: string, details?: Record<string, unknown>);
+}
+/** Schema validation failure. (FR-011) */
+declare class ValidationError extends FrameworkError {
+    readonly kind: "validation";
+    constructor(message: string, details?: Record<string, unknown>);
+}
+
+export { CheckpointError as C, type ErrorKind as E, FrameworkError as F, MCPError as M, ProviderError as P, RuntimeUnsupportedError as R, ToolError as T, ValidationError as V, type CheckpointErrorReason as a, type ProviderErrorReason as b, type ToolErrorReason as c };