@anvia/core 0.26.0 → 1.0.0-rc.10

package/dist/mcp/index.js

@@ -1,352 +1,7 @@
 import {
-  isRecord
-} from "../chunk-CQNNSZPG.js";
-
-// src/mcp/result.ts
-function createCallToolParams(name, args) {
-  if (args === null || args === void 0) {
-    return { name };
-  }
-  if (!isRecord(args)) {
-    throw new Error("MCP tool arguments must be a JSON object");
-  }
-  return { name, arguments: args };
-}
-function mapMcpToolResult(result) {
-  if ("toolResult" in result) {
-    return serializeMcpValue(result.toolResult);
-  }
-  if (result.isError === true) {
-    throw new Error(mcpErrorMessage(result.content));
-  }
-  return result.content.map(mapMcpContent).join("");
-}
-function mcpErrorMessage(content) {
-  const text = content.map((item) => item.type === "text" ? item.text : void 0).filter((item) => item !== void 0).join("\n");
-  return text === "" ? "MCP tool returned an error" : text;
-}
-function mapMcpContent(content) {
-  if (content.type === "text") {
-    return content.text;
-  }
-  if (content.type === "image") {
-    return `data:${content.mimeType};base64,${content.data}`;
-  }
-  if (content.type === "resource") {
-    const mimeType = content.resource.mimeType === void 0 ? "" : `data:${content.resource.mimeType};`;
-    if ("text" in content.resource) {
-      return `${mimeType}${content.resource.uri}:${content.resource.text}`;
-    }
-    return `${mimeType}${content.resource.uri}:${content.resource.blob}`;
-  }
-  throw new Error(`Unsupported MCP tool result content: ${serializeMcpValue(content)}`);
-}
-function serializeMcpValue(value) {
-  if (typeof value === "string") {
-    return value;
-  }
-  const serialized = JSON.stringify(value);
-  return serialized === void 0 ? String(value) : serialized;
-}
-
-// src/mcp/tool.ts
-var MCP_TOOL_METADATA_KEY = /* @__PURE__ */ Symbol.for("anvia.mcp.tool.metadata");
-function createMcpTool(definition, client, serverName) {
-  const tool = {
-    name: definition.name,
-    definition() {
-      return {
-        name: definition.name,
-        description: definition.description ?? "",
-        parameters: definition.inputSchema
-      };
-    },
-    async call(args) {
-      const result = await client.callTool(createCallToolParams(definition.name, args));
-      return mapMcpToolResult(result);
-    }
-  };
-  if (serverName !== void 0) {
-    Object.defineProperty(tool, MCP_TOOL_METADATA_KEY, {
-      value: { serverName },
-      enumerable: false
-    });
-  }
-  return tool;
-}
-
-// src/mcp/connect.ts
-async function connectMcp(connection) {
-  const client = await connection.connect();
-  let tools;
-  try {
-    ({ tools } = await client.listTools());
-  } catch (error) {
-    try {
-      await client.close();
-    } catch {
-    }
-    throw error;
-  }
-  return {
-    name: connection.name,
-    tools: tools.map((tool) => createMcpTool(tool, client, connection.name)),
-    close: () => client.close()
-  };
-}
-
-// src/mcp/connections.ts
-import { readFileSync } from "fs";
-import { Client } from "@modelcontextprotocol/sdk/client/index.js";
-import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";
-import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
-import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
-
-// src/mcp/url-safety.ts
-import { lookup } from "dns/promises";
-import { BlockList, isIP } from "net";
-import { Agent, Pool, fetch as undiciFetch } from "undici";
-var blockedIpv4Addresses = new BlockList();
-var blockedIpv6Addresses = new BlockList();
-for (const [network, prefix] of [
-  ["0.0.0.0", 8],
-  ["10.0.0.0", 8],
-  ["100.64.0.0", 10],
-  ["127.0.0.0", 8],
-  ["169.254.0.0", 16],
-  ["172.16.0.0", 12],
-  ["192.0.0.0", 24],
-  ["192.0.2.0", 24],
-  ["192.88.99.0", 24],
-  ["192.168.0.0", 16],
-  ["198.18.0.0", 15],
-  ["198.51.100.0", 24],
-  ["203.0.113.0", 24],
-  ["224.0.0.0", 4],
-  ["240.0.0.0", 4]
-]) {
-  blockedIpv4Addresses.addSubnet(network, prefix, "ipv4");
-}
-for (const [network, prefix] of [
-  ["::", 96],
-  ["::ffff:0:0", 96],
-  ["64:ff9b::", 96],
-  ["64:ff9b:1::", 48],
-  ["100::", 64],
-  ["2001::", 32],
-  ["2001:2::", 48],
-  ["2001:10::", 28],
-  ["2001:20::", 28],
-  ["2001:db8::", 32],
-  ["2002::", 16],
-  ["fc00::", 7],
-  ["fe80::", 10],
-  ["fec0::", 10],
-  ["ff00::", 8]
-]) {
-  blockedIpv6Addresses.addSubnet(network, prefix, "ipv6");
-}
-var defaultAddressResolver = (hostname) => lookup(hostname, { all: true, verbatim: true });
-function parseAndValidateMcpUrl(url) {
-  let parsed;
-  try {
-    parsed = new URL(url);
-  } catch {
-    throw new Error(`Invalid MCP URL: ${url}`);
-  }
-  if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
-    throw new Error(`MCP URL blocked: only HTTP(S) URLs are allowed (${parsed.protocol})`);
-  }
-  validateMcpHostname(parsed.hostname);
-  return parsed;
-}
-async function resolveAndValidateMcpHostname(hostname, resolveAddresses = defaultAddressResolver) {
-  const normalizedHostname = normalizeHostname(hostname);
-  validateMcpHostname(normalizedHostname);
-  const family = isIP(normalizedHostname);
-  if (family !== 0) {
-    return [{ address: normalizedHostname, family }];
-  }
-  let addresses;
-  try {
-    addresses = await resolveAddresses(normalizedHostname);
-  } catch (cause) {
-    throw new Error(`Unable to resolve MCP URL hostname (${normalizedHostname})`, { cause });
-  }
-  if (addresses.length === 0) {
-    throw new Error(`Unable to resolve MCP URL hostname (${normalizedHostname})`);
-  }
-  for (const { address } of addresses) {
-    validateMcpHostname(address);
-  }
-  return addresses;
-}
-function createSafeMcpLookup(resolveAddresses = defaultAddressResolver) {
-  return (hostname, options, callback) => {
-    void resolveAndValidateMcpHostname(hostname, resolveAddresses).then(
-      (addresses) => {
-        const requestedFamily = normalizeRequestedFamily(options.family);
-        const matchingAddresses = requestedFamily === 0 ? addresses : addresses.filter(({ family }) => family === requestedFamily);
-        if (matchingAddresses.length === 0) {
-          const error = new Error(`No matching address family for MCP URL (${hostname})`);
-          Object.assign(error, { code: "EAI_ADDRFAMILY" });
-          callback(error, []);
-          return;
-        }
-        if (options.all) {
-          callback(null, matchingAddresses);
-          return;
-        }
-        const address = matchingAddresses[0];
-        if (!address) {
-          callback(new Error(`Unable to resolve MCP URL hostname (${hostname})`), []);
-          return;
-        }
-        callback(null, address.address, address.family);
-      },
-      (cause) => {
-        callback(asError(cause), []);
-      }
-    );
-  };
-}
-function createSafeMcpFetch() {
-  return (url, init) => {
-    parseAndValidateMcpUrl(url);
-    return undiciFetch(url, {
-      ...init,
-      dispatcher: safeMcpDispatcher
-    });
-  };
-}
-function validateMcpHostname(hostname) {
-  const normalizedHostname = normalizeHostname(hostname);
-  if (normalizedHostname === "localhost" || normalizedHostname.endsWith(".localhost")) {
-    throw new Error(`MCP URL blocked: localhost not allowed (${normalizedHostname})`);
-  }
-  const family = isIP(normalizedHostname);
-  if (family === 0) {
-    return;
-  }
-  if (family === 4 && normalizedHostname.startsWith("127.") || family === 6 && normalizedHostname === "::1") {
-    throw new Error(`MCP URL blocked: localhost not allowed (${normalizedHostname})`);
-  }
-  if (normalizedHostname === "169.254.169.254" || normalizedHostname === "fd00:ec2::254") {
-    throw new Error(`MCP URL blocked: cloud metadata endpoint not allowed (${normalizedHostname})`);
-  }
-  if (family === 4 && blockedIpv4Addresses.check(normalizedHostname, "ipv4") || family === 6 && blockedIpv6Addresses.check(normalizedHostname, "ipv6")) {
-    const range = family === 4 ? "IP" : "IPv6";
-    throw new Error(`MCP URL blocked: private ${range} range not allowed (${normalizedHostname})`);
-  }
-}
-function normalizeHostname(hostname) {
-  const withoutBrackets = hostname.startsWith("[") && hostname.endsWith("]") ? hostname.slice(1, -1) : hostname;
-  return withoutBrackets.toLowerCase().replace(/\.+$/, "");
-}
-function normalizeRequestedFamily(family) {
-  if (family === 4 || family === "IPv4") {
-    return 4;
-  }
-  if (family === 6 || family === "IPv6") {
-    return 6;
-  }
-  return 0;
-}
-function asError(cause) {
-  return cause instanceof Error ? cause : new Error(String(cause));
-}
-var safeMcpDispatcher = new Agent({
-  autoSelectFamily: true,
-  connect: {
-    lookup: createSafeMcpLookup()
-  },
-  factory(origin, options) {
-    parseAndValidateMcpUrl(origin);
-    return new Pool(origin, options);
-  }
-});
-
-// src/mcp/connections.ts
-var CORE_CLIENT_VERSION = readCorePackageVersion();
-var mcp = {
-  stdio(options) {
-    return {
-      name: options.name,
-      async connect() {
-        const { name: _name, ...server } = options;
-        const client = createSdkClient();
-        await client.connect(asSdkTransport(new StdioClientTransport(server)));
-        return client;
-      }
-    };
-  },
-  http(options) {
-    return {
-      name: options.name,
-      async connect() {
-        assertNoCustomMcpFetch(options.transport?.fetch);
-        const url = parseAndValidateMcpUrl(options.url);
-        const client = createSdkClient();
-        await client.connect(
-          asSdkTransport(
-            new StreamableHTTPClientTransport(url, {
-              ...options.transport,
-              fetch: createSafeMcpFetch()
-            })
-          )
-        );
-        return client;
-      }
-    };
-  },
-  sse(options) {
-    return {
-      name: options.name,
-      async connect() {
-        assertNoCustomMcpFetch(options.transport?.fetch);
-        const url = parseAndValidateMcpUrl(options.url);
-        const client = createSdkClient();
-        await client.connect(
-          asSdkTransport(
-            new SSEClientTransport(url, {
-              ...options.transport,
-              fetch: createSafeMcpFetch()
-            })
-          )
-        );
-        return client;
-      }
-    };
-  }
-};
-function assertNoCustomMcpFetch(fetch) {
-  if (fetch !== void 0) {
-    throw new Error(
-      "Custom MCP transport fetch implementations are not allowed because they can bypass SSRF protection"
-    );
-  }
-}
-function createSdkClient() {
-  return new Client({
-    name: "@anvia/core",
-    version: CORE_CLIENT_VERSION
-  });
-}
-function readCorePackageVersion() {
-  try {
-    const packageJson = JSON.parse(
-      readFileSync(new URL("../../package.json", import.meta.url), "utf8")
-    );
-    return typeof packageJson.version === "string" ? packageJson.version : "0.0.0";
-  } catch {
-    return "0.0.0";
-  }
-}
-function asSdkTransport(transport) {
-  return transport;
-}
+  isMcpTool
+} from "../chunk-J6LVLV6P.js";
 export {
-  connectMcp,
-  mcp
+  isMcpTool
 };
 //# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/mcp/result.ts","../../src/mcp/tool.ts","../../src/mcp/connect.ts","../../src/mcp/connections.ts","../../src/mcp/url-safety.ts"],"sourcesContent":["import { isRecord } from \"../internal/record\";\nimport type { McpToolCallContent, McpToolCallResult } from \"./types\";\n\nexport function createCallToolParams(\n  name: string,\n  args: unknown,\n): { name: string; arguments?: Record<string, unknown> } {\n  if (args === null || args === undefined) {\n    return { name };\n  }\n\n  if (!isRecord(args)) {\n    throw new Error(\"MCP tool arguments must be a JSON object\");\n  }\n\n  return { name, arguments: args };\n}\n\nexport function mapMcpToolResult(result: McpToolCallResult): string {\n  if (\"toolResult\" in result) {\n    return serializeMcpValue(result.toolResult);\n  }\n\n  if (result.isError === true) {\n    throw new Error(mcpErrorMessage(result.content));\n  }\n\n  return result.content.map(mapMcpContent).join(\"\");\n}\n\nfunction mcpErrorMessage(content: McpToolCallContent[]): string {\n  const text = content\n    .map((item) => (item.type === \"text\" ? item.text : undefined))\n    .filter((item): item is string => item !== undefined)\n    .join(\"\\n\");\n\n  return text === \"\" ? \"MCP tool returned an error\" : text;\n}\n\nfunction mapMcpContent(content: McpToolCallContent): string {\n  if (content.type === \"text\") {\n    return content.text;\n  }\n\n  if (content.type === \"image\") {\n    return `data:${content.mimeType};base64,${content.data}`;\n  }\n\n  if (content.type === \"resource\") {\n    const mimeType =\n      content.resource.mimeType === undefined ? \"\" : `data:${content.resource.mimeType};`;\n    if (\"text\" in content.resource) {\n      return `${mimeType}${content.resource.uri}:${content.resource.text}`;\n    }\n\n    return `${mimeType}${content.resource.uri}:${content.resource.blob}`;\n  }\n\n  throw new Error(`Unsupported MCP tool result content: ${serializeMcpValue(content)}`);\n}\n\nfunction serializeMcpValue(value: unknown): string {\n  if (typeof value === \"string\") {\n    return value;\n  }\n\n  const serialized = JSON.stringify(value);\n  return serialized === undefined ? String(value) : serialized;\n}\n","import type { ToolDefinition } from \"../completion/index\";\nimport type { Tool } from \"../tool/index\";\nimport { createCallToolParams, mapMcpToolResult } from \"./result\";\nimport type { McpClient, McpToolDefinition } from \"./types\";\n\nconst MCP_TOOL_METADATA_KEY = Symbol.for(\"anvia.mcp.tool.metadata\");\n\nexport function createMcpTool(\n  definition: McpToolDefinition,\n  client: McpClient,\n  serverName?: string,\n): Tool {\n  const tool: Tool = {\n    name: definition.name,\n    definition(): ToolDefinition {\n      return {\n        name: definition.name,\n        description: definition.description ?? \"\",\n        parameters: definition.inputSchema,\n      };\n    },\n    async call(args): Promise<string> {\n      const result = await client.callTool(createCallToolParams(definition.name, args));\n      return mapMcpToolResult(result);\n    },\n  };\n  if (serverName !== undefined) {\n    Object.defineProperty(tool, MCP_TOOL_METADATA_KEY, {\n      value: { serverName },\n      enumerable: false,\n    });\n  }\n  return tool;\n}\n","import { createMcpTool } from \"./tool\";\nimport type { McpConnection, McpServer } from \"./types\";\n\nexport async function connectMcp(connection: McpConnection): Promise<McpServer> {\n  const client = await connection.connect();\n  let tools: Awaited<ReturnType<typeof client.listTools>>[\"tools\"];\n  try {\n    ({ tools } = await client.listTools());\n  } catch (error) {\n    try {\n      await client.close();\n    } catch {\n      // Preserve the initialization failure so callers see the actionable MCP error.\n    }\n    throw error;\n  }\n\n  return {\n    name: connection.name,\n    tools: tools.map((tool) => createMcpTool(tool, client, connection.name)),\n    close: () => client.close(),\n  };\n}\n","import { readFileSync } from \"node:fs\";\nimport { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport { SSEClientTransport } from \"@modelcontextprotocol/sdk/client/sse.js\";\nimport { StdioClientTransport } from \"@modelcontextprotocol/sdk/client/stdio.js\";\nimport { StreamableHTTPClientTransport } from \"@modelcontextprotocol/sdk/client/streamableHttp.js\";\nimport type {\n  McpClient,\n  McpConnection,\n  McpHttpOptions,\n  McpSseOptions,\n  McpStdioOptions,\n} from \"./types\";\nimport { createSafeMcpFetch, parseAndValidateMcpUrl } from \"./url-safety\";\n\nconst CORE_CLIENT_VERSION = readCorePackageVersion();\n\nexport const mcp = {\n  stdio(options: McpStdioOptions): McpConnection {\n    return {\n      name: options.name,\n      async connect(): Promise<McpClient> {\n        const { name: _name, ...server } = options;\n        const client = createSdkClient();\n        await client.connect(asSdkTransport(new StdioClientTransport(server)));\n        return client as McpClient;\n      },\n    };\n  },\n\n  http(options: McpHttpOptions): McpConnection {\n    return {\n      name: options.name,\n      async connect(): Promise<McpClient> {\n        assertNoCustomMcpFetch(options.transport?.fetch);\n        const url = parseAndValidateMcpUrl(options.url);\n        const client = createSdkClient();\n        await client.connect(\n          asSdkTransport(\n            new StreamableHTTPClientTransport(url, {\n              ...options.transport,\n              fetch: createSafeMcpFetch(),\n            }),\n          ),\n        );\n        return client as McpClient;\n      },\n    };\n  },\n\n  sse(options: McpSseOptions): McpConnection {\n    return {\n      name: options.name,\n      async connect(): Promise<McpClient> {\n        assertNoCustomMcpFetch(options.transport?.fetch);\n        const url = parseAndValidateMcpUrl(options.url);\n        const client = createSdkClient();\n        await client.connect(\n          asSdkTransport(\n            new SSEClientTransport(url, {\n              ...options.transport,\n              fetch: createSafeMcpFetch(),\n            }),\n          ),\n        );\n        return client as McpClient;\n      },\n    };\n  },\n};\n\nfunction assertNoCustomMcpFetch(fetch: unknown): void {\n  if (fetch !== undefined) {\n    throw new Error(\n      \"Custom MCP transport fetch implementations are not allowed because they can bypass SSRF protection\",\n    );\n  }\n}\n\nfunction createSdkClient(): Client {\n  return new Client({\n    name: \"@anvia/core\",\n    version: CORE_CLIENT_VERSION,\n  });\n}\n\nfunction readCorePackageVersion(): string {\n  try {\n    const packageJson = JSON.parse(\n      readFileSync(new URL(\"../../package.json\", import.meta.url), \"utf8\"),\n    ) as { version?: unknown };\n    return typeof packageJson.version === \"string\" ? packageJson.version : \"0.0.0\";\n  } catch {\n    return \"0.0.0\";\n  }\n}\n\nfunction asSdkTransport(transport: unknown): Parameters<Client[\"connect\"]>[0] {\n  return transport as Parameters<Client[\"connect\"]>[0];\n}\n","import type { LookupAddress } from \"node:dns\";\nimport { lookup } from \"node:dns/promises\";\nimport type { LookupFunction } from \"node:net\";\nimport { BlockList, isIP } from \"node:net\";\nimport type { StreamableHTTPClientTransportOptions } from \"@modelcontextprotocol/sdk/client/streamableHttp.js\";\nimport { Agent, Pool, fetch as undiciFetch } from \"undici\";\n\ntype FetchLike = NonNullable<StreamableHTTPClientTransportOptions[\"fetch\"]>;\n\nexport type McpAddressResolver = (hostname: string) => Promise<LookupAddress[]>;\n\nconst blockedIpv4Addresses = new BlockList();\nconst blockedIpv6Addresses = new BlockList();\n\nfor (const [network, prefix] of [\n  [\"0.0.0.0\", 8],\n  [\"10.0.0.0\", 8],\n  [\"100.64.0.0\", 10],\n  [\"127.0.0.0\", 8],\n  [\"169.254.0.0\", 16],\n  [\"172.16.0.0\", 12],\n  [\"192.0.0.0\", 24],\n  [\"192.0.2.0\", 24],\n  [\"192.88.99.0\", 24],\n  [\"192.168.0.0\", 16],\n  [\"198.18.0.0\", 15],\n  [\"198.51.100.0\", 24],\n  [\"203.0.113.0\", 24],\n  [\"224.0.0.0\", 4],\n  [\"240.0.0.0\", 4],\n] as const) {\n  blockedIpv4Addresses.addSubnet(network, prefix, \"ipv4\");\n}\n\nfor (const [network, prefix] of [\n  [\"::\", 96],\n  [\"::ffff:0:0\", 96],\n  [\"64:ff9b::\", 96],\n  [\"64:ff9b:1::\", 48],\n  [\"100::\", 64],\n  [\"2001::\", 32],\n  [\"2001:2::\", 48],\n  [\"2001:10::\", 28],\n  [\"2001:20::\", 28],\n  [\"2001:db8::\", 32],\n  [\"2002::\", 16],\n  [\"fc00::\", 7],\n  [\"fe80::\", 10],\n  [\"fec0::\", 10],\n  [\"ff00::\", 8],\n] as const) {\n  blockedIpv6Addresses.addSubnet(network, prefix, \"ipv6\");\n}\n\nconst defaultAddressResolver: McpAddressResolver = (hostname) =>\n  lookup(hostname, { all: true, verbatim: true });\n\nexport function parseAndValidateMcpUrl(url: string | URL): URL {\n  let parsed: URL;\n  try {\n    parsed = new URL(url);\n  } catch {\n    throw new Error(`Invalid MCP URL: ${url}`);\n  }\n\n  if (parsed.protocol !== \"http:\" && parsed.protocol !== \"https:\") {\n    throw new Error(`MCP URL blocked: only HTTP(S) URLs are allowed (${parsed.protocol})`);\n  }\n\n  validateMcpHostname(parsed.hostname);\n  return parsed;\n}\n\nexport async function resolveAndValidateMcpHostname(\n  hostname: string,\n  resolveAddresses: McpAddressResolver = defaultAddressResolver,\n): Promise<LookupAddress[]> {\n  const normalizedHostname = normalizeHostname(hostname);\n  validateMcpHostname(normalizedHostname);\n\n  const family = isIP(normalizedHostname);\n  if (family !== 0) {\n    return [{ address: normalizedHostname, family }];\n  }\n\n  let addresses: LookupAddress[];\n  try {\n    addresses = await resolveAddresses(normalizedHostname);\n  } catch (cause) {\n    throw new Error(`Unable to resolve MCP URL hostname (${normalizedHostname})`, { cause });\n  }\n\n  if (addresses.length === 0) {\n    throw new Error(`Unable to resolve MCP URL hostname (${normalizedHostname})`);\n  }\n\n  for (const { address } of addresses) {\n    validateMcpHostname(address);\n  }\n\n  return addresses;\n}\n\nexport function createSafeMcpLookup(\n  resolveAddresses: McpAddressResolver = defaultAddressResolver,\n): LookupFunction {\n  return (hostname, options, callback) => {\n    void resolveAndValidateMcpHostname(hostname, resolveAddresses).then(\n      (addresses) => {\n        const requestedFamily = normalizeRequestedFamily(options.family);\n        const matchingAddresses =\n          requestedFamily === 0\n            ? addresses\n            : addresses.filter(({ family }) => family === requestedFamily);\n\n        if (matchingAddresses.length === 0) {\n          const error = new Error(`No matching address family for MCP URL (${hostname})`);\n          Object.assign(error, { code: \"EAI_ADDRFAMILY\" });\n          callback(error, []);\n          return;\n        }\n\n        if (options.all) {\n          callback(null, matchingAddresses);\n          return;\n        }\n\n        const address = matchingAddresses[0];\n        if (!address) {\n          callback(new Error(`Unable to resolve MCP URL hostname (${hostname})`), []);\n          return;\n        }\n        callback(null, address.address, address.family);\n      },\n      (cause: unknown) => {\n        callback(asError(cause), []);\n      },\n    );\n  };\n}\n\nexport function createSafeMcpFetch(): FetchLike {\n  return (url, init) => {\n    parseAndValidateMcpUrl(url);\n    return undiciFetch(url as Parameters<typeof undiciFetch>[0], {\n      ...(init as Parameters<typeof undiciFetch>[1]),\n      dispatcher: safeMcpDispatcher,\n    }) as ReturnType<FetchLike>;\n  };\n}\n\nfunction validateMcpHostname(hostname: string): void {\n  const normalizedHostname = normalizeHostname(hostname);\n\n  if (normalizedHostname === \"localhost\" || normalizedHostname.endsWith(\".localhost\")) {\n    throw new Error(`MCP URL blocked: localhost not allowed (${normalizedHostname})`);\n  }\n\n  const family = isIP(normalizedHostname);\n  if (family === 0) {\n    return;\n  }\n\n  if (\n    (family === 4 && normalizedHostname.startsWith(\"127.\")) ||\n    (family === 6 && normalizedHostname === \"::1\")\n  ) {\n    throw new Error(`MCP URL blocked: localhost not allowed (${normalizedHostname})`);\n  }\n\n  if (normalizedHostname === \"169.254.169.254\" || normalizedHostname === \"fd00:ec2::254\") {\n    throw new Error(`MCP URL blocked: cloud metadata endpoint not allowed (${normalizedHostname})`);\n  }\n\n  if (\n    (family === 4 && blockedIpv4Addresses.check(normalizedHostname, \"ipv4\")) ||\n    (family === 6 && blockedIpv6Addresses.check(normalizedHostname, \"ipv6\"))\n  ) {\n    const range = family === 4 ? \"IP\" : \"IPv6\";\n    throw new Error(`MCP URL blocked: private ${range} range not allowed (${normalizedHostname})`);\n  }\n}\n\nfunction normalizeHostname(hostname: string): string {\n  const withoutBrackets =\n    hostname.startsWith(\"[\") && hostname.endsWith(\"]\") ? hostname.slice(1, -1) : hostname;\n  return withoutBrackets.toLowerCase().replace(/\\.+$/, \"\");\n}\n\nfunction normalizeRequestedFamily(family: number | string | undefined): 0 | 4 | 6 {\n  if (family === 4 || family === \"IPv4\") {\n    return 4;\n  }\n  if (family === 6 || family === \"IPv6\") {\n    return 6;\n  }\n  return 0;\n}\n\nfunction asError(cause: unknown): Error {\n  return cause instanceof Error ? cause : new Error(String(cause));\n}\n\nconst safeMcpDispatcher = new Agent({\n  autoSelectFamily: true,\n  connect: {\n    lookup: createSafeMcpLookup(),\n  },\n  factory(origin, options) {\n    parseAndValidateMcpUrl(origin);\n    return new Pool(origin, options as Pool.Options);\n  },\n});\n"],"mappings":"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","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/memory/index.d.ts

@@ -1,8 +1,22 @@
-export { M as MemoryCompactionConflictError, a as MemoryCompactionError, c as createSummaryMemoryCompactor, i as isMemoryCompactionSummary } from '../errors-2moLDuuN.js';
-import { n as MemoryOptions, o as ResolvedMemoryOptions } from '../types-BrLbKnEz.js';
-export { p as MemoryAppendInput, M as MemoryCompactionCommitInput, a as MemoryCompactionCommitResult, b as MemoryCompactionOptions, c as MemoryCompactionSnapshot, d as MemoryCompactionStore, e as MemoryCompactor, f as MemoryCompactorInput, g as MemoryCompactorResult, q as MemoryContext, h as MemoryConversation, i as MemoryConversationListOptions, j as MemoryConversationMessage, k as MemoryConversationSummary, r as MemoryErrorInput, l as MemoryInspector, s as MemoryRegistration, t as MemorySavePolicy, m as MemoryStore, R as ResolvedMemoryCompactionOptions, u as SessionOptions, S as SummaryMemoryCompactorOptions } from '../types-BrLbKnEz.js';
-import '../types-G12i56s2.js';
+import { M as Message, U as Usage } from '../types-DgvozfPc.js';
+import { a as CreateSummaryMemoryCompactorOptions, m as MemoryCompactor, f as MemoryCompactionMessage, C as CreateMemoryScopeKeyOptions } from '../types-DKOXVTcq.js';
+export { M as MemoryAppendOptions, b as MemoryClearOptions, c as MemoryCompactionCapability, d as MemoryCompactionConflictRetryOptions, e as MemoryCompactionInfo, g as MemoryCompactionMetadata, h as MemoryCompactionOptions, i as MemoryCompactionReplacePrefixOptions, j as MemoryCompactionReplacePrefixResult, k as MemoryCompactionSnapshot, l as MemoryCompactionSnapshotOptions, n as MemoryCompactorInput, o as MemoryCompactorResult, p as MemoryConversation, q as MemoryConversationGetOptions, r as MemoryConversationListOptions, s as MemoryConversationMessage, t as MemoryConversationSummary, u as MemoryErrorOptions, v as MemoryInspector, w as MemoryLoadOptions, x as MemoryOptions, y as MemorySavePolicy, z as MemoryScope, A as MemoryScopeKeyOptions, B as MemoryScopeKeyResolver, D as MemoryStore } from '../types-DKOXVTcq.js';
+import '../model-call-options-CZkSw_xN.js';
+import '../retry-CjvSlKGW.js';
 
-declare function resolveMemoryOptions(options?: MemoryOptions): ResolvedMemoryOptions;
+declare function createSummaryMemoryCompactor(options: CreateSummaryMemoryCompactorOptions): MemoryCompactor;
+declare function isMemoryCompactionMessage(message: Message): message is MemoryCompactionMessage;
 
-export { MemoryOptions, ResolvedMemoryOptions, resolveMemoryOptions };
+declare class MemoryCompactionError extends Error {
+    readonly usage: Usage | undefined;
+    constructor(message: string, options?: ErrorOptions & {
+        usage?: Usage | undefined;
+    });
+}
+declare class MemoryCompactionConflictError extends MemoryCompactionError {
+    constructor(attempts: number, usage?: Usage);
+}
+
+declare function createMemoryScopeKey(options: CreateMemoryScopeKeyOptions): string;
+
+export { CreateMemoryScopeKeyOptions, CreateSummaryMemoryCompactorOptions, MemoryCompactionConflictError, MemoryCompactionError, MemoryCompactionMessage, MemoryCompactor, createMemoryScopeKey, createSummaryMemoryCompactor, isMemoryCompactionMessage };

package/dist/memory/index.js

@@ -1,21 +1,22 @@
-import "../chunk-XWUC7CIT.js";
 import {
-  resolveMemoryOptions
-} from "../chunk-UQX6EXWG.js";
+  createMemoryScopeKey
+} from "../chunk-QOUPWOGW.js";
 import {
   MemoryCompactionConflictError,
   MemoryCompactionError,
   createSummaryMemoryCompactor,
-  isMemoryCompactionSummary
-} from "../chunk-MRQLEK2B.js";
-import "../chunk-MC3CCKEB.js";
-import "../chunk-ADH7NNCS.js";
-import "../chunk-WQKHFADH.js";
+  isMemoryCompactionMessage
+} from "../chunk-5C6B6ZRH.js";
+import "../chunk-7PHMK7W4.js";
+import "../chunk-7JLAIN6E.js";
+import "../chunk-QGX73TSQ.js";
+import "../chunk-3XQGVDU5.js";
+import "../chunk-3RWESPUG.js";
 export {
   MemoryCompactionConflictError,
   MemoryCompactionError,
+  createMemoryScopeKey,
   createSummaryMemoryCompactor,
-  isMemoryCompactionSummary,
-  resolveMemoryOptions
+  isMemoryCompactionMessage
 };
 //# sourceMappingURL=index.js.map

package/dist/middleware-kcF8AusP.d.ts

@@ -0,0 +1,59 @@
+import { f as CompletionRequest, g as CompletionResponse, p as JsonValue, y as ToolResultContentPart } from './types-DgvozfPc.js';
+import { M as MaybePromise } from './type-utils-CtHVDRn_.js';
+
+type CompletionRequestMiddlewareArgs = {
+    turn: number;
+    request: CompletionRequest;
+    originalRequest: CompletionRequest;
+};
+type CompletionRequestMiddlewareResult = {
+    request: CompletionRequest;
+} | undefined;
+type CompletionResponseMiddlewareArgs<RawResponse = unknown> = {
+    turn: number;
+    request: CompletionRequest;
+    response: CompletionResponse<RawResponse>;
+    originalResponse: CompletionResponse<RawResponse>;
+};
+type CompletionResponseMiddlewareResult<RawResponse = unknown> = {
+    response: CompletionResponse<RawResponse>;
+} | undefined;
+type ToolInputMiddlewareArgs = {
+    toolName: string;
+    args: string;
+    originalArgs: string;
+    turn: number;
+    toolCallId?: string | undefined;
+    internalCallId: string;
+};
+type ToolInputMiddlewareResult = {
+    args: JsonValue | string;
+} | undefined;
+type ToolResultMiddlewareArgs = {
+    toolName: string;
+    args: string;
+    result: string;
+    originalResult: string;
+    structuredResult?: readonly ToolResultContentPart[] | undefined;
+    originalStructuredResult?: readonly ToolResultContentPart[] | undefined;
+    turn: number;
+    toolCallId?: string | undefined;
+    internalCallId: string;
+};
+type ToolOutputMiddlewareArgs = ToolResultMiddlewareArgs;
+type ToolOutputMiddlewareResult = string | Readonly<{
+    result: string;
+    structuredResult?: never;
+}> | Readonly<{
+    structuredResult: readonly ToolResultContentPart[];
+    result?: never;
+}> | undefined;
+interface AgentMiddleware<RawResponse = unknown> {
+    onCompletionRequest?(args: CompletionRequestMiddlewareArgs): MaybePromise<CompletionRequestMiddlewareResult>;
+    onCompletionResponse?(args: CompletionResponseMiddlewareArgs<RawResponse>): MaybePromise<CompletionResponseMiddlewareResult<RawResponse>>;
+    onToolInput?(args: ToolInputMiddlewareArgs): MaybePromise<ToolInputMiddlewareResult>;
+    onToolOutput?(args: ToolOutputMiddlewareArgs): MaybePromise<ToolOutputMiddlewareResult>;
+}
+declare function createMiddleware<RawResponse = unknown>(middleware: AgentMiddleware<RawResponse>): AgentMiddleware<RawResponse>;
+
+export { type AgentMiddleware as A, type CompletionRequestMiddlewareArgs as C, type ToolInputMiddlewareArgs as T, type CompletionRequestMiddlewareResult as a, type CompletionResponseMiddlewareArgs as b, type CompletionResponseMiddlewareResult as c, type ToolInputMiddlewareResult as d, type ToolOutputMiddlewareArgs as e, type ToolOutputMiddlewareResult as f, type ToolResultMiddlewareArgs as g, createMiddleware as h };

package/dist/model-call-options-CZkSw_xN.d.ts

@@ -0,0 +1,6 @@
+/** Options that control one provider model invocation without becoming request payload data. */
+type ModelCallOptions = {
+    abortSignal?: AbortSignal | undefined;
+};
+
+export type { ModelCallOptions as M };

package/dist/model-listing/index.d.ts

@@ -24,7 +24,9 @@ type ModelList = {
     data: ListedModel[];
 };
 interface ModelListingClient {
-    listModels(): Promise<ModelList>;
+    listModels(options?: {
+        abortSignal?: AbortSignal | undefined;
+    }): Promise<ModelList>;
 }
 
 export { type ListedModel, type ModelId, type ModelList, type ModelListingClient, ModelListingError };

package/dist/observability/index.d.ts

@@ -1,4 +1,23 @@
-export { m as AgentGenerationEndArgs, n as AgentGenerationErrorArgs, o as AgentGenerationModelInfo, p as AgentGenerationObserver, q as AgentGenerationStartArgs, r as AgentGenerationUpdateArgs, i as AgentObserver, k as AgentObserverRegistration, s as AgentRunEndArgs, t as AgentRunErrorArgs, u as AgentRunEventArgs, v as AgentRunObserver, w as AgentRunPromptRef, x as AgentRunStartArgs, y as AgentToolEndArgs, z as AgentToolErrorArgs, B as AgentToolObserver, C as AgentToolStartArgs, D as AgentToolStreamEventArgs, E as AgentTraceInfo, j as AgentTraceOptions, O as ObserveOptions, F as createObserver } from '../index-BxSbmOMr.js';
-import '../types-G12i56s2.js';
-import '../guardrails/index.js';
-import '../tool-Cohdv5GC.js';
+export { x as AgentGenerationEndArgs, y as AgentGenerationErrorArgs, z as AgentGenerationModelInfo, B as AgentGenerationObserver, C as AgentGenerationStartArgs, D as AgentGenerationUpdateArgs, E as AgentObservabilityOptions, F as AgentObserver, G as AgentObserverErrorPolicy, H as AgentObserverMap, I as AgentObserverTraceInfo, J as AgentRunEndArgs, K as AgentRunErrorArgs, L as AgentRunEventArgs, M as AgentRunObserver, N as AgentRunPromptRef, O as AgentRunStartArgs, P as AgentToolEndArgs, Q as AgentToolErrorArgs, R as AgentToolObserver, S as AgentToolStartArgs, T as AgentToolStreamEventArgs, U as AgentToolSuspendedArgs, V as AgentTraceInfo, W as AgentTraceOptions } from '../types-Sue2hb_L.js';
+import '../agent/interactions/index.js';
+import 'zod';
+import '../types-DgvozfPc.js';
+import '../model-call-options-CZkSw_xN.js';
+import '../retry-CjvSlKGW.js';
+import '../types-DhkodEft.js';
+import '../type-utils-CtHVDRn_.js';
+import '../types-DKOXVTcq.js';
+import '../tool-BpqpoRSE.js';
+import '../middleware-kcF8AusP.js';
+
+type AgentObserverFailure = {
+    readonly observer: string;
+    readonly error: unknown;
+};
+declare class AgentObserverDispatchError extends AggregateError {
+    readonly phase: string;
+    readonly failures: readonly AgentObserverFailure[];
+    constructor(phase: string, failures: readonly AgentObserverFailure[]);
+}
+
+export { AgentObserverDispatchError };

package/dist/observability/index.js

@@ -1,8 +1,13 @@
-// src/observability/types.ts
-function createObserver(observer) {
-  return observer;
-}
+import {
+  AgentObserverDispatchError
+} from "../chunk-6BBOCFHV.js";
+import "../chunk-D4PACGPA.js";
+import "../chunk-7PHMK7W4.js";
+import "../chunk-7JLAIN6E.js";
+import "../chunk-QGX73TSQ.js";
+import "../chunk-3XQGVDU5.js";
+import "../chunk-3RWESPUG.js";
 export {
-  createObserver
+  AgentObserverDispatchError
 };
 //# sourceMappingURL=index.js.map

package/dist/observability/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/observability/types.ts"],"sourcesContent":["import type {\n  CompletionModelCapabilities,\n  CompletionRequest,\n  CompletionResponse,\n  CompletionSource,\n  JsonObject,\n  JsonValue,\n  Message,\n  ProviderToolCall,\n  ToolCall,\n  ToolDefinition,\n  ToolResultContent,\n  Usage,\n} from \"../completion\";\nimport type { AgentDeltaEvent } from \"../request/types\";\nimport type { ToolCallStreamEvent } from \"../tool\";\n\nexport type AgentTraceInfo = {\n  traceId?: string | undefined;\n  observationId?: string | undefined;\n};\n\nexport type AgentTraceOptions = {\n  name?: string | undefined;\n  userId?: string | undefined;\n  sessionId?: string | undefined;\n  metadata?: Record<string, unknown> | undefined;\n  tags?: string[] | undefined;\n  version?: string | undefined;\n  traceId?: string | undefined;\n  failOnObserverError?: boolean | undefined;\n  promptRef?: AgentRunPromptRef | undefined;\n};\n\nexport type AgentRunPromptRef = {\n  name: string;\n  version?: number | undefined;\n};\n\nexport type AgentRunStartArgs = {\n  agentName?: string | undefined;\n  agentDescription?: string | undefined;\n  instructions?: string | undefined;\n  trace?: AgentTraceOptions | undefined;\n  prompt: Message;\n  promptRef?: AgentRunPromptRef | undefined;\n  history: Message[];\n  maxTurns: number;\n};\n\nexport type AgentRunEndArgs = {\n  output: string;\n  usage: Usage;\n  messages: Message[];\n  sources?: CompletionSource[] | undefined;\n  providerToolCalls?: ProviderToolCall[] | undefined;\n};\n\nexport type AgentRunErrorArgs = {\n  error: unknown;\n  usage: Usage;\n  messages: Message[];\n};\n\nexport type AgentGenerationModelInfo = {\n  provider: string;\n  defaultModel: string;\n  capabilities?: CompletionModelCapabilities | undefined;\n};\n\nexport type AgentGenerationStartArgs = {\n  turn: number;\n  request: CompletionRequest;\n  providerRequest?: JsonObject | undefined;\n  modelInfo?: AgentGenerationModelInfo | undefined;\n};\n\nexport type AgentGenerationEndArgs<RawResponse = unknown> = {\n  turn: number;\n  response: CompletionResponse<RawResponse>;\n  firstDeltaMs?: number | undefined;\n};\n\nexport type AgentGenerationErrorArgs = {\n  turn: number;\n  error: unknown;\n};\n\nexport type AgentGenerationUpdateArgs = {\n  turn: number;\n  delta: AgentDeltaEvent;\n};\n\nexport type AgentRunEventArgs = {\n  name: string;\n  attributes?: Record<string, JsonValue | undefined> | undefined;\n  level?: \"DEFAULT\" | \"WARNING\" | \"ERROR\" | undefined;\n  timestamp?: Date | string | undefined;\n};\n\nexport type AgentToolStartArgs = {\n  turn: number;\n  toolCall: ToolCall;\n  toolName: string;\n  args: string;\n  internalCallId: string;\n  toolCallId?: string | undefined;\n  toolDefinition?: ToolDefinition | undefined;\n  toolMetadata?: JsonObject | undefined;\n};\n\nexport type AgentToolEndArgs = AgentToolStartArgs & {\n  result: string;\n  structuredResult?: ToolResultContent[] | undefined;\n  skipped: boolean;\n};\n\nexport type AgentToolErrorArgs = AgentToolStartArgs & {\n  error: unknown;\n};\n\nexport type AgentToolStreamEventArgs = AgentToolStartArgs & {\n  event: ToolCallStreamEvent;\n};\n\nexport interface AgentGenerationObserver {\n  end(args: AgentGenerationEndArgs): void | Promise<void>;\n  error?(args: AgentGenerationErrorArgs): void | Promise<void>;\n  update?(args: AgentGenerationUpdateArgs): void | Promise<void>;\n}\n\nexport interface AgentToolObserver {\n  streamEvent?(args: AgentToolStreamEventArgs): void | Promise<void>;\n  end(args: AgentToolEndArgs): void | Promise<void>;\n  error?(args: AgentToolErrorArgs): void | Promise<void>;\n}\n\nexport interface AgentRunObserver {\n  readonly trace?: AgentTraceInfo | undefined;\n  startGeneration?(\n    args: AgentGenerationStartArgs,\n  ): AgentGenerationObserver | undefined | Promise<AgentGenerationObserver | undefined>;\n  startTool?(\n    args: AgentToolStartArgs,\n  ): AgentToolObserver | undefined | Promise<AgentToolObserver | undefined>;\n  end(args: AgentRunEndArgs): void | Promise<void>;\n  error?(args: AgentRunErrorArgs): void | Promise<void>;\n  event?(args: AgentRunEventArgs): void | Promise<void>;\n}\n\nexport interface AgentObserver {\n  startRun(\n    args: AgentRunStartArgs,\n  ): AgentRunObserver | undefined | Promise<AgentRunObserver | undefined>;\n  flush?(): void | Promise<void>;\n  shutdown?(): void | Promise<void>;\n}\n\nexport type AgentObserverRegistration = {\n  observer: AgentObserver;\n  failOnObserverError?: boolean | undefined;\n};\n\nexport type ObserveOptions = {\n  failOnObserverError?: boolean | undefined;\n};\n\nexport function createObserver(observer: AgentObserver): AgentObserver {\n  return observer;\n}\n"],"mappings":";AAuKO,SAAS,eAAe,UAAwC;AACrE,SAAO;AACT;","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}