@anvia/core 0.26.0 → 1.0.0-rc.1

package/dist/chunk-6WGGTJE6.js

@@ -0,0 +1,139 @@
+import {
+  InMemoryVectorStore,
+  createTool
+} from "./chunk-R2LJSQUW.js";
+import {
+  embedDocuments
+} from "./chunk-DZ3CKYTH.js";
+
+// src/internal/vector-search-options.ts
+function assertPositiveSearchLimit(value, name = "topK") {
+  if (!Number.isSafeInteger(value) || value <= 0) {
+    throw new RangeError(`${name} must be a positive safe integer.`);
+  }
+  return value;
+}
+function assertFiniteSearchThreshold(value, name = "threshold") {
+  if (value !== void 0 && !Number.isFinite(value)) {
+    throw new RangeError(`${name} must be a finite number.`);
+  }
+  return value;
+}
+
+// src/tool/dynamic-tools.ts
+async function embedTools(model, tools, options = {}) {
+  const toolList = dedupeTools(tools);
+  const definitions = await Promise.all(
+    toolList.map(async (tool) => ({ tool, definition: await tool.definition("") }))
+  );
+  const documents = definitions.map(({ tool, definition }) => {
+    const content = options.content?.(tool, definition) ?? defaultToolEmbeddingText(definition);
+    const texts = Array.isArray(content) ? content : [content];
+    const metadata = options.metadata?.(tool, definition);
+    const document = {
+      toolName: tool.name,
+      definition,
+      text: texts.join("\n")
+    };
+    if (metadata !== void 0) {
+      document.metadata = metadata;
+    }
+    return { tool, document, texts, metadata };
+  });
+  return embedDocuments(model, documents, {
+    id: (item) => item.tool.name,
+    content: (item) => item.texts,
+    metadata: (item) => item.metadata,
+    concurrency: options.concurrency
+  }).then(
+    (embedded) => embedded.map((item) => ({
+      ...item,
+      document: item.document.document
+    }))
+  );
+}
+async function createToolIndex(model, tools, options) {
+  assertPositiveSearchLimit(options.topK);
+  assertFiniteSearchThreshold(options.threshold);
+  const toolList = dedupeTools(tools);
+  const embedded = await embedTools(model, toolList, options);
+  const index = InMemoryVectorStore.fromDocuments(embedded).index(model);
+  return new ToolSearchIndex(index, toolList, options);
+}
+function isToolIndex(value) {
+  if (typeof value !== "object" || value === null) {
+    return false;
+  }
+  const candidate = value;
+  return candidate.kind === "tool-index" && Array.isArray(candidate.tools) && typeof candidate.topK === "number" && typeof candidate.search === "function" && typeof candidate.searchIds === "function" && typeof candidate.asTool === "function";
+}
+var ToolSearchIndex = class {
+  constructor(index, tools, options) {
+    this.index = index;
+    this.tools = Object.freeze([...tools]);
+    this.topK = options.topK;
+    this.threshold = options.threshold;
+    this.filter = options.filter;
+    if (index.inspect !== void 0) {
+      this.inspect = (request) => index.inspect?.(request);
+    }
+  }
+  index;
+  kind = "tool-index";
+  tools;
+  topK;
+  threshold;
+  filter;
+  inspect;
+  search(request) {
+    return this.index.search(request);
+  }
+  searchIds(request) {
+    return this.index.searchIds(request);
+  }
+  asTool(options) {
+    return this.index.asTool(options);
+  }
+};
+function dedupeTools(tools) {
+  const byName = /* @__PURE__ */ new Map();
+  for (const tool of tools) {
+    byName.set(tool.name, tool);
+  }
+  return [...byName.values()];
+}
+function defaultToolEmbeddingText(definition) {
+  return [definition.name, definition.description, JSON.stringify(definition.parameters)];
+}
+
+// src/tool/middleware.ts
+function createMiddleware(middleware) {
+  return middleware;
+}
+
+// src/tool/think-tool.ts
+import { z } from "zod";
+var defaultThinkToolDescription = "Use this tool to record a thought while reasoning through a complex task. It does not retrieve information, store memory, or change external state.";
+var thinkToolInput = z.object({
+  thought: z.string().describe("A thought to record while reasoning through a task.")
+});
+function createThinkTool(options = {}) {
+  return createTool({
+    name: options.name ?? "think",
+    description: options.description ?? defaultThinkToolDescription,
+    inputSchema: thinkToolInput,
+    outputSchema: z.string(),
+    execute: (args) => args.thought
+  });
+}
+
+export {
+  assertPositiveSearchLimit,
+  assertFiniteSearchThreshold,
+  embedTools,
+  createToolIndex,
+  isToolIndex,
+  createMiddleware,
+  createThinkTool
+};
+//# sourceMappingURL=chunk-6WGGTJE6.js.map

package/dist/chunk-6WGGTJE6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/internal/vector-search-options.ts","../src/tool/dynamic-tools.ts","../src/tool/middleware.ts","../src/tool/think-tool.ts"],"sourcesContent":["export function assertPositiveSearchLimit(value: number, name = \"topK\"): number {\n  if (!Number.isSafeInteger(value) || value <= 0) {\n    throw new RangeError(`${name} must be a positive safe integer.`);\n  }\n  return value;\n}\n\nexport function assertFiniteSearchThreshold(\n  value: number | undefined,\n  name = \"threshold\",\n): number | undefined {\n  if (value !== undefined && !Number.isFinite(value)) {\n    throw new RangeError(`${name} must be a finite number.`);\n  }\n  return value;\n}\n","import type { ToolDefinition } from \"../completion\";\nimport type { EmbeddedDocument, EmbeddingModel, VectorMetadata } from \"../embeddings\";\nimport { embedDocuments } from \"../embeddings\";\nimport {\n  assertFiniteSearchThreshold,\n  assertPositiveSearchLimit,\n} from \"../internal/vector-search-options\";\nimport type {\n  VectorFilter,\n  VectorInspectPage,\n  VectorInspectRequest,\n  VectorSearchResult,\n  VectorSearchToolOptions,\n} from \"../vector-store\";\nimport {\n  InMemoryVectorStore,\n  type VectorSearchIndex,\n  type VectorSearchRequest,\n} from \"../vector-store\";\nimport type { AnyTool, Tool } from \"./tool\";\n\nexport type ToolSearchDocument<Metadata extends VectorMetadata = VectorMetadata> = {\n  toolName: string;\n  definition: ToolDefinition;\n  text: string;\n  metadata?: Metadata | undefined;\n};\n\nexport type EmbedToolsOptions<Metadata extends VectorMetadata = VectorMetadata> = {\n  content?: ((tool: AnyTool, definition: ToolDefinition) => string | string[]) | undefined;\n  metadata?: ((tool: AnyTool, definition: ToolDefinition) => Metadata | undefined) | undefined;\n  concurrency?: number | undefined;\n};\n\nexport type CreateToolIndexOptions<Metadata extends VectorMetadata = VectorMetadata> =\n  EmbedToolsOptions<Metadata> & {\n    topK: number;\n    threshold?: number | undefined;\n    filter?: VectorFilter | undefined;\n  };\n\nexport interface ToolIndex<Metadata extends VectorMetadata = VectorMetadata>\n  extends VectorSearchIndex<ToolSearchDocument<Metadata>, Metadata> {\n  readonly kind: \"tool-index\";\n  readonly tools: readonly AnyTool[];\n  readonly topK: number;\n  readonly threshold?: number | undefined;\n  readonly filter?: VectorFilter | undefined;\n}\n\nexport async function embedTools<Metadata extends VectorMetadata = VectorMetadata>(\n  model: EmbeddingModel,\n  tools: readonly AnyTool[],\n  options: EmbedToolsOptions<Metadata> = {},\n): Promise<Array<EmbeddedDocument<ToolSearchDocument<Metadata>, Metadata>>> {\n  const toolList = dedupeTools(tools);\n  const definitions = await Promise.all(\n    toolList.map(async (tool) => ({ tool, definition: await tool.definition(\"\") })),\n  );\n  const documents = definitions.map(({ tool, definition }) => {\n    const content = options.content?.(tool, definition) ?? defaultToolEmbeddingText(definition);\n    const texts = Array.isArray(content) ? content : [content];\n    const metadata = options.metadata?.(tool, definition);\n    const document: ToolSearchDocument<Metadata> = {\n      toolName: tool.name,\n      definition,\n      text: texts.join(\"\\n\"),\n    };\n    if (metadata !== undefined) {\n      document.metadata = metadata;\n    }\n    return { tool, document, texts, metadata };\n  });\n\n  return embedDocuments(model, documents, {\n    id: (item) => item.tool.name,\n    content: (item) => item.texts,\n    metadata: (item) => item.metadata,\n    concurrency: options.concurrency,\n  }).then((embedded) =>\n    embedded.map((item) => ({\n      ...item,\n      document: item.document.document,\n    })),\n  );\n}\n\nexport async function createToolIndex<Metadata extends VectorMetadata = VectorMetadata>(\n  model: EmbeddingModel,\n  tools: readonly AnyTool[],\n  options: CreateToolIndexOptions<Metadata>,\n): Promise<ToolIndex<Metadata>> {\n  assertPositiveSearchLimit(options.topK);\n  assertFiniteSearchThreshold(options.threshold);\n  const toolList = dedupeTools(tools);\n  const embedded = await embedTools(model, toolList, options);\n  const index = InMemoryVectorStore.fromDocuments(embedded).index(model);\n  return new ToolSearchIndex(index, toolList, options);\n}\n\nexport function isToolIndex(value: unknown): value is ToolIndex {\n  if (typeof value !== \"object\" || value === null) {\n    return false;\n  }\n  const candidate = value as {\n    kind?: unknown;\n    tools?: unknown;\n    topK?: unknown;\n    search?: unknown;\n    searchIds?: unknown;\n    asTool?: unknown;\n  };\n  return (\n    candidate.kind === \"tool-index\" &&\n    Array.isArray(candidate.tools) &&\n    typeof candidate.topK === \"number\" &&\n    typeof candidate.search === \"function\" &&\n    typeof candidate.searchIds === \"function\" &&\n    typeof candidate.asTool === \"function\"\n  );\n}\n\nclass ToolSearchIndex<Metadata extends VectorMetadata> implements ToolIndex<Metadata> {\n  readonly kind = \"tool-index\" as const;\n  readonly tools: readonly AnyTool[];\n  readonly topK: number;\n  readonly threshold: number | undefined;\n  readonly filter: VectorFilter | undefined;\n  readonly inspect?: (\n    request: VectorInspectRequest,\n  ) => Promise<VectorInspectPage<ToolSearchDocument<Metadata>, Metadata>>;\n\n  constructor(\n    private readonly index: VectorSearchIndex<ToolSearchDocument<Metadata>, Metadata>,\n    tools: readonly AnyTool[],\n    options: CreateToolIndexOptions<Metadata>,\n  ) {\n    this.tools = Object.freeze([...tools]);\n    this.topK = options.topK;\n    this.threshold = options.threshold;\n    this.filter = options.filter;\n    if (index.inspect !== undefined) {\n      this.inspect = (request) =>\n        index.inspect?.(request) as Promise<\n          VectorInspectPage<ToolSearchDocument<Metadata>, Metadata>\n        >;\n    }\n  }\n\n  search(\n    request: VectorSearchRequest,\n  ): Promise<Array<VectorSearchResult<ToolSearchDocument<Metadata>, Metadata>>> {\n    return this.index.search(request);\n  }\n\n  searchIds(request: VectorSearchRequest): Promise<Array<{ score: number; id: string }>> {\n    return this.index.searchIds(request);\n  }\n\n  asTool(options: VectorSearchToolOptions): Tool<{ query: string; topK?: number }, unknown> {\n    return this.index.asTool(options);\n  }\n}\n\nfunction dedupeTools(tools: readonly AnyTool[]): AnyTool[] {\n  const byName = new Map<string, AnyTool>();\n  for (const tool of tools) {\n    byName.set(tool.name, tool);\n  }\n  return [...byName.values()];\n}\n\nfunction defaultToolEmbeddingText(definition: ToolDefinition): string[] {\n  return [definition.name, definition.description, JSON.stringify(definition.parameters)];\n}\n","import type {\n  CompletionRequest,\n  CompletionResponse,\n  JsonValue,\n  ToolResultContent,\n} from \"../completion\";\nimport type { MaybePromise } from \"../internal/type-utils\";\n\nexport type CompletionRequestMiddlewareArgs = {\n  turn: number;\n  request: CompletionRequest;\n  originalRequest: CompletionRequest;\n};\n\nexport type CompletionRequestMiddlewareResult =\n  | {\n      request: CompletionRequest;\n    }\n  | undefined;\n\nexport type CompletionResponseMiddlewareArgs<RawResponse = unknown> = {\n  turn: number;\n  request: CompletionRequest;\n  response: CompletionResponse<RawResponse>;\n  originalResponse: CompletionResponse<RawResponse>;\n};\n\nexport type CompletionResponseMiddlewareResult<RawResponse = unknown> =\n  | {\n      response: CompletionResponse<RawResponse>;\n    }\n  | undefined;\n\nexport type ToolInputMiddlewareArgs = {\n  toolName: string;\n  args: string;\n  originalArgs: string;\n  turn: number;\n  toolCallId?: string | undefined;\n  internalCallId: string;\n};\n\nexport type ToolInputMiddlewareResult =\n  | {\n      args: JsonValue | string;\n    }\n  | undefined;\n\nexport type ToolResultMiddlewareArgs = {\n  toolName: string;\n  args: string;\n  result: string;\n  originalResult: string;\n  structuredResult?: ToolResultContent[] | undefined;\n  originalStructuredResult?: ToolResultContent[] | undefined;\n  turn: number;\n  toolCallId?: string | undefined;\n  internalCallId: string;\n};\n\nexport type ToolOutputMiddlewareArgs = ToolResultMiddlewareArgs;\n\nexport type ToolOutputMiddlewareResult =\n  | string\n  | {\n      result?: string | undefined;\n      structuredResult?: ToolResultContent[] | undefined;\n    }\n  | undefined;\n\nexport interface AgentMiddleware<RawResponse = unknown> {\n  onCompletionRequest?(\n    args: CompletionRequestMiddlewareArgs,\n  ): MaybePromise<CompletionRequestMiddlewareResult>;\n  onCompletionResponse?(\n    args: CompletionResponseMiddlewareArgs<RawResponse>,\n  ): MaybePromise<CompletionResponseMiddlewareResult<RawResponse>>;\n  onToolInput?(args: ToolInputMiddlewareArgs): MaybePromise<ToolInputMiddlewareResult>;\n  onToolOutput?(args: ToolOutputMiddlewareArgs): MaybePromise<ToolOutputMiddlewareResult>;\n}\n\nexport function createMiddleware<RawResponse = unknown>(\n  middleware: AgentMiddleware<RawResponse>,\n): AgentMiddleware<RawResponse> {\n  return middleware;\n}\n","import { z } from \"zod\";\nimport { createTool } from \"./create-tool\";\n\nconst defaultThinkToolDescription =\n  \"Use this tool to record a thought while reasoning through a complex task. It does not retrieve information, store memory, or change external state.\";\n\nconst thinkToolInput = z.object({\n  thought: z.string().describe(\"A thought to record while reasoning through a task.\"),\n});\n\nexport type CreateThinkToolOptions = {\n  name?: string;\n  description?: string;\n};\n\nexport function createThinkTool(options: CreateThinkToolOptions = {}) {\n  return createTool({\n    name: options.name ?? \"think\",\n    description: options.description ?? defaultThinkToolDescription,\n    inputSchema: thinkToolInput,\n    outputSchema: z.string(),\n    execute: (args) => args.thought,\n  });\n}\n"],"mappings":";;;;;;;;;AAAO,SAAS,0BAA0B,OAAe,OAAO,QAAgB;AAC9E,MAAI,CAAC,OAAO,cAAc,KAAK,KAAK,SAAS,GAAG;AAC9C,UAAM,IAAI,WAAW,GAAG,IAAI,mCAAmC;AAAA,EACjE;AACA,SAAO;AACT;AAEO,SAAS,4BACd,OACA,OAAO,aACa;AACpB,MAAI,UAAU,UAAa,CAAC,OAAO,SAAS,KAAK,GAAG;AAClD,UAAM,IAAI,WAAW,GAAG,IAAI,2BAA2B;AAAA,EACzD;AACA,SAAO;AACT;;;ACmCA,eAAsB,WACpB,OACA,OACA,UAAuC,CAAC,GACkC;AAC1E,QAAM,WAAW,YAAY,KAAK;AAClC,QAAM,cAAc,MAAM,QAAQ;AAAA,IAChC,SAAS,IAAI,OAAO,UAAU,EAAE,MAAM,YAAY,MAAM,KAAK,WAAW,EAAE,EAAE,EAAE;AAAA,EAChF;AACA,QAAM,YAAY,YAAY,IAAI,CAAC,EAAE,MAAM,WAAW,MAAM;AAC1D,UAAM,UAAU,QAAQ,UAAU,MAAM,UAAU,KAAK,yBAAyB,UAAU;AAC1F,UAAM,QAAQ,MAAM,QAAQ,OAAO,IAAI,UAAU,CAAC,OAAO;AACzD,UAAM,WAAW,QAAQ,WAAW,MAAM,UAAU;AACpD,UAAM,WAAyC;AAAA,MAC7C,UAAU,KAAK;AAAA,MACf;AAAA,MACA,MAAM,MAAM,KAAK,IAAI;AAAA,IACvB;AACA,QAAI,aAAa,QAAW;AAC1B,eAAS,WAAW;AAAA,IACtB;AACA,WAAO,EAAE,MAAM,UAAU,OAAO,SAAS;AAAA,EAC3C,CAAC;AAED,SAAO,eAAe,OAAO,WAAW;AAAA,IACtC,IAAI,CAAC,SAAS,KAAK,KAAK;AAAA,IACxB,SAAS,CAAC,SAAS,KAAK;AAAA,IACxB,UAAU,CAAC,SAAS,KAAK;AAAA,IACzB,aAAa,QAAQ;AAAA,EACvB,CAAC,EAAE;AAAA,IAAK,CAAC,aACP,SAAS,IAAI,CAAC,UAAU;AAAA,MACtB,GAAG;AAAA,MACH,UAAU,KAAK,SAAS;AAAA,IAC1B,EAAE;AAAA,EACJ;AACF;AAEA,eAAsB,gBACpB,OACA,OACA,SAC8B;AAC9B,4BAA0B,QAAQ,IAAI;AACtC,8BAA4B,QAAQ,SAAS;AAC7C,QAAM,WAAW,YAAY,KAAK;AAClC,QAAM,WAAW,MAAM,WAAW,OAAO,UAAU,OAAO;AAC1D,QAAM,QAAQ,oBAAoB,cAAc,QAAQ,EAAE,MAAM,KAAK;AACrE,SAAO,IAAI,gBAAgB,OAAO,UAAU,OAAO;AACrD;AAEO,SAAS,YAAY,OAAoC;AAC9D,MAAI,OAAO,UAAU,YAAY,UAAU,MAAM;AAC/C,WAAO;AAAA,EACT;AACA,QAAM,YAAY;AAQlB,SACE,UAAU,SAAS,gBACnB,MAAM,QAAQ,UAAU,KAAK,KAC7B,OAAO,UAAU,SAAS,YAC1B,OAAO,UAAU,WAAW,cAC5B,OAAO,UAAU,cAAc,cAC/B,OAAO,UAAU,WAAW;AAEhC;AAEA,IAAM,kBAAN,MAAsF;AAAA,EAUpF,YACmB,OACjB,OACA,SACA;AAHiB;AAIjB,SAAK,QAAQ,OAAO,OAAO,CAAC,GAAG,KAAK,CAAC;AACrC,SAAK,OAAO,QAAQ;AACpB,SAAK,YAAY,QAAQ;AACzB,SAAK,SAAS,QAAQ;AACtB,QAAI,MAAM,YAAY,QAAW;AAC/B,WAAK,UAAU,CAAC,YACd,MAAM,UAAU,OAAO;AAAA,IAG3B;AAAA,EACF;AAAA,EAdmB;AAAA,EAVV,OAAO;AAAA,EACP;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAqBT,OACE,SAC4E;AAC5E,WAAO,KAAK,MAAM,OAAO,OAAO;AAAA,EAClC;AAAA,EAEA,UAAU,SAA6E;AACrF,WAAO,KAAK,MAAM,UAAU,OAAO;AAAA,EACrC;AAAA,EAEA,OAAO,SAAmF;AACxF,WAAO,KAAK,MAAM,OAAO,OAAO;AAAA,EAClC;AACF;AAEA,SAAS,YAAY,OAAsC;AACzD,QAAM,SAAS,oBAAI,IAAqB;AACxC,aAAW,QAAQ,OAAO;AACxB,WAAO,IAAI,KAAK,MAAM,IAAI;AAAA,EAC5B;AACA,SAAO,CAAC,GAAG,OAAO,OAAO,CAAC;AAC5B;AAEA,SAAS,yBAAyB,YAAsC;AACtE,SAAO,CAAC,WAAW,MAAM,WAAW,aAAa,KAAK,UAAU,WAAW,UAAU,CAAC;AACxF;;;AC7FO,SAAS,iBACd,YAC8B;AAC9B,SAAO;AACT;;;ACrFA,SAAS,SAAS;AAGlB,IAAM,8BACJ;AAEF,IAAM,iBAAiB,EAAE,OAAO;AAAA,EAC9B,SAAS,EAAE,OAAO,EAAE,SAAS,qDAAqD;AACpF,CAAC;AAOM,SAAS,gBAAgB,UAAkC,CAAC,GAAG;AACpE,SAAO,WAAW;AAAA,IAChB,MAAM,QAAQ,QAAQ;AAAA,IACtB,aAAa,QAAQ,eAAe;AAAA,IACpC,aAAa;AAAA,IACb,cAAc,EAAE,OAAO;AAAA,IACvB,SAAS,CAAC,SAAS,KAAK;AAAA,EAC1B,CAAC;AACH;","names":[]}

package/dist/chunk-A3UBYTJT.js

@@ -0,0 +1,157 @@
+// src/retry.ts
+var DEFAULT_MAX_ATTEMPTS = 3;
+var DEFAULT_INITIAL_DELAY_MS = 100;
+var DEFAULT_MAX_DELAY_MS = 1e3;
+var MAX_TIMER_DELAY_MS = 2147483647;
+var RETRYABLE_STATUS_CODES = /* @__PURE__ */ new Set([408, 409, 425, 429]);
+var RETRYABLE_NUMERIC_ERROR_CODES = /* @__PURE__ */ new Set([4, 8, 14]);
+var RETRYABLE_ERROR_NAMES = /* @__PURE__ */ new Set([
+  "APIConnectionError",
+  "APIConnectionTimeoutError",
+  "TimeoutError"
+]);
+var RETRYABLE_ERROR_CODES = /* @__PURE__ */ new Set([
+  "DEADLINE_EXCEEDED",
+  "EAI_AGAIN",
+  "ECONNREFUSED",
+  "ECONNRESET",
+  "EHOSTUNREACH",
+  "ENETDOWN",
+  "ENETUNREACH",
+  "EPIPE",
+  "ETIMEDOUT",
+  "RESOURCE_EXHAUSTED",
+  "UNAVAILABLE",
+  "UND_ERR_CONNECT_TIMEOUT",
+  "UND_ERR_HEADERS_TIMEOUT",
+  "UND_ERR_SOCKET"
+]);
+function resolveRetryOptions(options) {
+  const maxAttempts = options.maxAttempts ?? DEFAULT_MAX_ATTEMPTS;
+  const initialDelayMs = options.initialDelayMs ?? DEFAULT_INITIAL_DELAY_MS;
+  const maxDelayMs = options.maxDelayMs ?? DEFAULT_MAX_DELAY_MS;
+  if (!Number.isSafeInteger(maxAttempts) || maxAttempts < 1) {
+    throw new RangeError("Retry maxAttempts must be a positive integer.");
+  }
+  assertDelay(initialDelayMs, "initialDelayMs");
+  assertDelay(maxDelayMs, "maxDelayMs");
+  if (maxDelayMs < initialDelayMs) {
+    throw new RangeError("Retry maxDelayMs must be greater than or equal to initialDelayMs.");
+  }
+  if (options.shouldRetry !== void 0 && typeof options.shouldRetry !== "function") {
+    throw new TypeError("Retry shouldRetry must be a function.");
+  }
+  return {
+    maxAttempts,
+    initialDelayMs,
+    maxDelayMs,
+    shouldRetry: options.shouldRetry ?? defaultShouldRetry
+  };
+}
+function retryDelayMs(options, failedAttempt) {
+  const exponentialDelay = options.initialDelayMs * 2 ** (failedAttempt - 1);
+  const cappedDelay = Math.min(options.maxDelayMs, exponentialDelay);
+  return Math.random() * cappedDelay;
+}
+function retryErrorAttributes(error) {
+  const errors = errorChain(error);
+  const errorName = errors.map((candidate) => stringProperty(candidate, "name")).find((value) => value !== void 0);
+  const statusCode = firstStatusCode(errors);
+  const errorCode = errors.map((candidate) => errorCodeProperty(candidate)).find((value) => value !== void 0);
+  return { errorName, statusCode, errorCode };
+}
+async function waitForRetry(delayMs) {
+  if (delayMs === 0) return;
+  await new Promise((resolve) => setTimeout(resolve, delayMs));
+}
+function retryOptionsForFailure(options, context) {
+  if (options === void 0 || context.attempt >= options.maxAttempts) return void 0;
+  return options.shouldRetry({ ...context, maxAttempts: options.maxAttempts }) ? options : void 0;
+}
+async function runWithRetries(operation, options, context) {
+  let attempt = 1;
+  while (true) {
+    try {
+      return await operation();
+    } catch (error) {
+      const retryOptions = retryOptionsForFailure(options, { error, attempt, ...context });
+      if (retryOptions === void 0) throw error;
+      await waitForRetry(retryDelayMs(retryOptions, attempt));
+      attempt += 1;
+    }
+  }
+}
+function defaultShouldRetry(context) {
+  const errors = errorChain(context.error);
+  if (errors.some((error) => stringProperty(error, "name") === "AbortError")) return false;
+  const statusCode = firstStatusCode(errors);
+  if (statusCode !== void 0) {
+    return RETRYABLE_STATUS_CODES.has(statusCode) || statusCode >= 500 && statusCode <= 599;
+  }
+  return errors.some((error) => {
+    const name = stringProperty(error, "name");
+    if (name !== void 0 && RETRYABLE_ERROR_NAMES.has(name)) return true;
+    const code = stringProperty(error, "code")?.toUpperCase();
+    if (code !== void 0 && RETRYABLE_ERROR_CODES.has(code)) return true;
+    const numericCode = numberProperty(error, "code");
+    return numericCode !== void 0 && RETRYABLE_NUMERIC_ERROR_CODES.has(numericCode);
+  });
+}
+function firstStatusCode(errors) {
+  for (const error of errors) {
+    const status = numberProperty(error, "status");
+    if (status !== void 0 && status >= 100 && status <= 599) return status;
+    const statusCode = numberProperty(error, "statusCode");
+    if (statusCode !== void 0 && statusCode >= 100 && statusCode <= 599) return statusCode;
+    const code = numberProperty(error, "code");
+    if (code !== void 0 && code >= 100 && code <= 599) return code;
+  }
+  return void 0;
+}
+function errorChain(error) {
+  const errors = [];
+  const seen = /* @__PURE__ */ new Set();
+  let current = error;
+  while (isObject(current) && !seen.has(current)) {
+    seen.add(current);
+    errors.push(current);
+    current = property(current, "cause");
+  }
+  return errors;
+}
+function assertDelay(value, name) {
+  if (!Number.isFinite(value) || value < 0 || value > MAX_TIMER_DELAY_MS) {
+    throw new RangeError(`Retry ${name} must be between 0 and ${MAX_TIMER_DELAY_MS} milliseconds.`);
+  }
+}
+function numberProperty(value, name) {
+  const candidate = property(value, name);
+  return typeof candidate === "number" && Number.isFinite(candidate) ? candidate : void 0;
+}
+function stringProperty(value, name) {
+  const candidate = property(value, name);
+  return typeof candidate === "string" && candidate.length > 0 ? candidate : void 0;
+}
+function errorCodeProperty(value) {
+  return stringProperty(value, "code") ?? numberProperty(value, "code");
+}
+function property(value, name) {
+  try {
+    return value[name];
+  } catch {
+    return void 0;
+  }
+}
+function isObject(value) {
+  return typeof value === "object" && value !== null;
+}
+
+export {
+  resolveRetryOptions,
+  retryDelayMs,
+  retryErrorAttributes,
+  waitForRetry,
+  retryOptionsForFailure,
+  runWithRetries
+};
+//# sourceMappingURL=chunk-A3UBYTJT.js.map

package/dist/chunk-A3UBYTJT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/retry.ts"],"sourcesContent":["import type { JsonValue } from \"./completion/types\";\n\nexport type RetryContext = {\n  error: unknown;\n  attempt: number;\n  maxAttempts: number;\n  streaming: boolean;\n  turn?: number | undefined;\n};\n\nexport type RetryOptions = {\n  maxAttempts?: number | undefined;\n  initialDelayMs?: number | undefined;\n  maxDelayMs?: number | undefined;\n  shouldRetry?: ((context: RetryContext) => boolean) | undefined;\n};\n\nexport type ResolvedRetryOptions = {\n  maxAttempts: number;\n  initialDelayMs: number;\n  maxDelayMs: number;\n  shouldRetry: (context: RetryContext) => boolean;\n};\n\nconst DEFAULT_MAX_ATTEMPTS = 3;\nconst DEFAULT_INITIAL_DELAY_MS = 100;\nconst DEFAULT_MAX_DELAY_MS = 1_000;\nconst MAX_TIMER_DELAY_MS = 2_147_483_647;\n\nconst RETRYABLE_STATUS_CODES = new Set([408, 409, 425, 429]);\nconst RETRYABLE_NUMERIC_ERROR_CODES = new Set([4, 8, 14]);\nconst RETRYABLE_ERROR_NAMES = new Set([\n  \"APIConnectionError\",\n  \"APIConnectionTimeoutError\",\n  \"TimeoutError\",\n]);\nconst RETRYABLE_ERROR_CODES = new Set([\n  \"DEADLINE_EXCEEDED\",\n  \"EAI_AGAIN\",\n  \"ECONNREFUSED\",\n  \"ECONNRESET\",\n  \"EHOSTUNREACH\",\n  \"ENETDOWN\",\n  \"ENETUNREACH\",\n  \"EPIPE\",\n  \"ETIMEDOUT\",\n  \"RESOURCE_EXHAUSTED\",\n  \"UNAVAILABLE\",\n  \"UND_ERR_CONNECT_TIMEOUT\",\n  \"UND_ERR_HEADERS_TIMEOUT\",\n  \"UND_ERR_SOCKET\",\n]);\n\nexport function resolveRetryOptions(options: RetryOptions): ResolvedRetryOptions {\n  const maxAttempts = options.maxAttempts ?? DEFAULT_MAX_ATTEMPTS;\n  const initialDelayMs = options.initialDelayMs ?? DEFAULT_INITIAL_DELAY_MS;\n  const maxDelayMs = options.maxDelayMs ?? DEFAULT_MAX_DELAY_MS;\n\n  if (!Number.isSafeInteger(maxAttempts) || maxAttempts < 1) {\n    throw new RangeError(\"Retry maxAttempts must be a positive integer.\");\n  }\n  assertDelay(initialDelayMs, \"initialDelayMs\");\n  assertDelay(maxDelayMs, \"maxDelayMs\");\n  if (maxDelayMs < initialDelayMs) {\n    throw new RangeError(\"Retry maxDelayMs must be greater than or equal to initialDelayMs.\");\n  }\n  if (options.shouldRetry !== undefined && typeof options.shouldRetry !== \"function\") {\n    throw new TypeError(\"Retry shouldRetry must be a function.\");\n  }\n\n  return {\n    maxAttempts,\n    initialDelayMs,\n    maxDelayMs,\n    shouldRetry: options.shouldRetry ?? defaultShouldRetry,\n  };\n}\n\nexport function retryDelayMs(options: ResolvedRetryOptions, failedAttempt: number): number {\n  const exponentialDelay = options.initialDelayMs * 2 ** (failedAttempt - 1);\n  const cappedDelay = Math.min(options.maxDelayMs, exponentialDelay);\n  return Math.random() * cappedDelay;\n}\n\nexport function retryErrorAttributes(error: unknown): Record<string, JsonValue | undefined> {\n  const errors = errorChain(error);\n  const errorName = errors\n    .map((candidate) => stringProperty(candidate, \"name\"))\n    .find((value) => value !== undefined);\n  const statusCode = firstStatusCode(errors);\n  const errorCode = errors\n    .map((candidate) => errorCodeProperty(candidate))\n    .find((value) => value !== undefined);\n\n  return { errorName, statusCode, errorCode };\n}\n\nexport async function waitForRetry(delayMs: number): Promise<void> {\n  if (delayMs === 0) return;\n  await new Promise<void>((resolve) => setTimeout(resolve, delayMs));\n}\n\nexport function retryOptionsForFailure(\n  options: ResolvedRetryOptions | undefined,\n  context: Omit<RetryContext, \"maxAttempts\">,\n): ResolvedRetryOptions | undefined {\n  if (options === undefined || context.attempt >= options.maxAttempts) return undefined;\n  return options.shouldRetry({ ...context, maxAttempts: options.maxAttempts })\n    ? options\n    : undefined;\n}\n\nexport async function runWithRetries<T>(\n  operation: () => Promise<T>,\n  options: ResolvedRetryOptions | undefined,\n  context: { streaming: boolean; turn?: number | undefined },\n): Promise<T> {\n  let attempt = 1;\n  while (true) {\n    try {\n      return await operation();\n    } catch (error) {\n      const retryOptions = retryOptionsForFailure(options, { error, attempt, ...context });\n      if (retryOptions === undefined) throw error;\n      await waitForRetry(retryDelayMs(retryOptions, attempt));\n      attempt += 1;\n    }\n  }\n}\n\nfunction defaultShouldRetry(context: RetryContext): boolean {\n  const errors = errorChain(context.error);\n  if (errors.some((error) => stringProperty(error, \"name\") === \"AbortError\")) return false;\n\n  const statusCode = firstStatusCode(errors);\n  if (statusCode !== undefined) {\n    return RETRYABLE_STATUS_CODES.has(statusCode) || (statusCode >= 500 && statusCode <= 599);\n  }\n\n  return errors.some((error) => {\n    const name = stringProperty(error, \"name\");\n    if (name !== undefined && RETRYABLE_ERROR_NAMES.has(name)) return true;\n    const code = stringProperty(error, \"code\")?.toUpperCase();\n    if (code !== undefined && RETRYABLE_ERROR_CODES.has(code)) return true;\n    const numericCode = numberProperty(error, \"code\");\n    return numericCode !== undefined && RETRYABLE_NUMERIC_ERROR_CODES.has(numericCode);\n  });\n}\n\nfunction firstStatusCode(errors: Record<string, unknown>[]): number | undefined {\n  for (const error of errors) {\n    const status = numberProperty(error, \"status\");\n    if (status !== undefined && status >= 100 && status <= 599) return status;\n    const statusCode = numberProperty(error, \"statusCode\");\n    if (statusCode !== undefined && statusCode >= 100 && statusCode <= 599) return statusCode;\n    const code = numberProperty(error, \"code\");\n    if (code !== undefined && code >= 100 && code <= 599) return code;\n  }\n  return undefined;\n}\n\nfunction errorChain(error: unknown): Record<string, unknown>[] {\n  const errors: Record<string, unknown>[] = [];\n  const seen = new Set<object>();\n  let current = error;\n  while (isObject(current) && !seen.has(current)) {\n    seen.add(current);\n    errors.push(current);\n    current = property(current, \"cause\");\n  }\n  return errors;\n}\n\nfunction assertDelay(value: number, name: string): void {\n  if (!Number.isFinite(value) || value < 0 || value > MAX_TIMER_DELAY_MS) {\n    throw new RangeError(`Retry ${name} must be between 0 and ${MAX_TIMER_DELAY_MS} milliseconds.`);\n  }\n}\n\nfunction numberProperty(value: Record<string, unknown>, name: string): number | undefined {\n  const candidate = property(value, name);\n  return typeof candidate === \"number\" && Number.isFinite(candidate) ? candidate : undefined;\n}\n\nfunction stringProperty(value: Record<string, unknown>, name: string): string | undefined {\n  const candidate = property(value, name);\n  return typeof candidate === \"string\" && candidate.length > 0 ? candidate : undefined;\n}\n\nfunction errorCodeProperty(value: Record<string, unknown>): string | number | undefined {\n  return stringProperty(value, \"code\") ?? numberProperty(value, \"code\");\n}\n\nfunction property(value: Record<string, unknown>, name: string): unknown {\n  try {\n    return value[name];\n  } catch {\n    return undefined;\n  }\n}\n\nfunction isObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-NCPN4SJR.js → chunk-DMPUP4R3.js}

@@ -6,7 +6,7 @@ import {
 } from "./chunk-YK4WAAS4.js";
 import {
   createTool
-} from "./chunk-MELYDKWQ.js";
+} from "./chunk-R2LJSQUW.js";
 
 // src/skills/instructions.ts
 function skillInstructions(skills) {
@@ -52,10 +52,10 @@ function createSkillTools(skills) {
       createTool({
         name: "get_skill_instructions",
         description: "Load the full SKILL.md instructions for an Agent Skill.",
-        input: z.object({
+        inputSchema: z.object({
           skillName: z.string().describe("The name of the skill to load.")
         }),
-        output: z.string(),
+        outputSchema: z.string(),
         execute: ({ skillName }) => registry.get(skillName).instructions
       })
     ),
@@ -63,11 +63,11 @@ function createSkillTools(skills) {
       createTool({
         name: "get_skill_reference",
         description: "Read a reference file from an Agent Skill.",
-        input: z.object({
+        inputSchema: z.object({
           skillName: z.string().describe("The name of the skill."),
           referencePath: z.string().describe("A path listed in the skill references.")
         }),
-        output: z.string(),
+        outputSchema: z.string(),
         execute: ({ skillName, referencePath }) => registry.readReference(skillName, referencePath)
       })
     ),
@@ -75,11 +75,11 @@ function createSkillTools(skills) {
       createTool({
         name: "get_skill_script",
         description: "Read a script file from an Agent Skill.",
-        input: z.object({
+        inputSchema: z.object({
           skillName: z.string().describe("The name of the skill."),
           scriptPath: z.string().describe("A path listed in the skill scripts.")
         }),
-        output: z.string(),
+        outputSchema: z.string(),
         execute: ({ skillName, scriptPath }) => registry.readScript(skillName, scriptPath)
       })
     ),
@@ -87,13 +87,13 @@ function createSkillTools(skills) {
       createTool({
         name: "run_skill_script",
         description: "Execute a script from an Agent Skill with optional arguments.",
-        input: z.object({
+        inputSchema: z.object({
           skillName: z.string().describe("The name of the skill."),
           scriptPath: z.string().describe("A path listed in the skill scripts."),
           args: z.array(z.string()).optional().describe("Arguments passed to the script."),
           timeoutMs: z.number().int().positive().optional().describe("Execution timeout in ms.")
         }),
-        output: z.string(),
+        outputSchema: z.string(),
         execute: ({ skillName, scriptPath, args = [], timeoutMs = DEFAULT_TIMEOUT_MS }) => registry.runScript(skillName, scriptPath, args, timeoutMs)
       })
     )
@@ -395,4 +395,4 @@ export {
   SkillValidationError,
   skill
 };
-//# sourceMappingURL=chunk-NCPN4SJR.js.map
+//# sourceMappingURL=chunk-DMPUP4R3.js.map

package/dist/chunk-DMPUP4R3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/skills/instructions.ts","../src/skills/tools.ts","../src/skills/load.ts","../src/skills/local.ts","../src/skills/types.ts"],"sourcesContent":["import type { Skill } from \"./types\";\n\nexport function skillInstructions(skills: Skill[]): string {\n  if (skills.length === 0) {\n    return \"\";\n  }\n\n  return [\n    \"You have access to Agent Skills.\",\n    \"Skills are compact capability packages. Use the skill tools to load full instructions, references, or scripts only when a skill is relevant.\",\n    \"\",\n    \"Available skills:\",\n    ...skills.map(formatSkill),\n    \"\",\n    \"Skill tools:\",\n    \"- get_skill_instructions: load full SKILL.md guidance for a skill.\",\n    \"- get_skill_reference: read a reference file from a skill.\",\n    \"- get_skill_script: read a script file from a skill.\",\n    \"- run_skill_script: execute a script from a skill with arguments.\",\n  ].join(\"\\n\");\n}\n\nfunction formatSkill(skill: Skill): string {\n  const lines = [`- ${skill.name}: ${skill.description}`];\n  if (skill.references.length > 0) {\n    lines.push(`  references: ${skill.references.join(\", \")}`);\n  }\n  if (skill.scripts.length > 0) {\n    lines.push(`  scripts: ${skill.scripts.join(\", \")}`);\n  }\n  return lines.join(\"\\n\");\n}\n","import { spawn } from \"node:child_process\";\nimport { readFile } from \"node:fs/promises\";\nimport { isAbsolute, relative, resolve } from \"node:path\";\nimport { z } from \"zod\";\nimport { type AnyTool, createTool } from \"../tool\";\nimport { markSkillTool } from \"../tool/skill-tool-marker\";\nimport type { Skill } from \"./types\";\n\nconst DEFAULT_TIMEOUT_MS = 30_000;\nconst MAX_OUTPUT_CHARS = 20_000;\n\nexport function createSkillTools(skills: Skill[]): AnyTool[] {\n  const registry = new SkillRegistry(skills);\n\n  return [\n    markSkillTool(\n      createTool({\n        name: \"get_skill_instructions\",\n        description: \"Load the full SKILL.md instructions for an Agent Skill.\",\n        inputSchema: z.object({\n          skillName: z.string().describe(\"The name of the skill to load.\"),\n        }),\n        outputSchema: z.string(),\n        execute: ({ skillName }) => registry.get(skillName).instructions,\n      }),\n    ),\n    markSkillTool(\n      createTool({\n        name: \"get_skill_reference\",\n        description: \"Read a reference file from an Agent Skill.\",\n        inputSchema: z.object({\n          skillName: z.string().describe(\"The name of the skill.\"),\n          referencePath: z.string().describe(\"A path listed in the skill references.\"),\n        }),\n        outputSchema: z.string(),\n        execute: ({ skillName, referencePath }) => registry.readReference(skillName, referencePath),\n      }),\n    ),\n    markSkillTool(\n      createTool({\n        name: \"get_skill_script\",\n        description: \"Read a script file from an Agent Skill.\",\n        inputSchema: z.object({\n          skillName: z.string().describe(\"The name of the skill.\"),\n          scriptPath: z.string().describe(\"A path listed in the skill scripts.\"),\n        }),\n        outputSchema: z.string(),\n        execute: ({ skillName, scriptPath }) => registry.readScript(skillName, scriptPath),\n      }),\n    ),\n    markSkillTool(\n      createTool({\n        name: \"run_skill_script\",\n        description: \"Execute a script from an Agent Skill with optional arguments.\",\n        inputSchema: z.object({\n          skillName: z.string().describe(\"The name of the skill.\"),\n          scriptPath: z.string().describe(\"A path listed in the skill scripts.\"),\n          args: z.array(z.string()).optional().describe(\"Arguments passed to the script.\"),\n          timeoutMs: z.number().int().positive().optional().describe(\"Execution timeout in ms.\"),\n        }),\n        outputSchema: z.string(),\n        execute: ({ skillName, scriptPath, args = [], timeoutMs = DEFAULT_TIMEOUT_MS }) =>\n          registry.runScript(skillName, scriptPath, args, timeoutMs),\n      }),\n    ),\n  ];\n}\n\nclass SkillRegistry {\n  private readonly skills = new Map<string, Skill>();\n\n  constructor(skills: Skill[]) {\n    for (const skill of skills) {\n      this.skills.set(skill.name, skill);\n    }\n  }\n\n  get(skillName: string): Skill {\n    const skill = this.skills.get(skillName);\n    if (skill === undefined) {\n      throw new Error(`Skill not found: ${skillName}`);\n    }\n    return skill;\n  }\n\n  async readReference(skillName: string, referencePath: string): Promise<string> {\n    const skill = this.get(skillName);\n    const path = this.resolveContainedPath(skill, \"references\", referencePath);\n    if (!skill.references.includes(referencePath)) {\n      throw new Error(`Skill reference not found: ${skillName}/${referencePath}`);\n    }\n    return readFile(path, \"utf8\");\n  }\n\n  async readScript(skillName: string, scriptPath: string): Promise<string> {\n    const skill = this.get(skillName);\n    const path = this.resolveContainedPath(skill, \"scripts\", scriptPath);\n    if (!skill.scripts.includes(scriptPath)) {\n      throw new Error(`Skill script not found: ${skillName}/${scriptPath}`);\n    }\n    return readFile(path, \"utf8\");\n  }\n\n  async runScript(\n    skillName: string,\n    scriptPath: string,\n    args: string[],\n    timeoutMs: number,\n  ): Promise<string> {\n    const skill = this.get(skillName);\n    const script = this.resolveContainedPath(skill, \"scripts\", scriptPath);\n    if (!skill.scripts.includes(scriptPath)) {\n      throw new Error(`Skill script not found: ${skillName}/${scriptPath}`);\n    }\n    return runExecutable(script, args, skill.directory, timeoutMs);\n  }\n\n  private resolveContainedPath(\n    skill: Skill,\n    section: \"references\" | \"scripts\",\n    requestedPath: string,\n  ): string {\n    if (requestedPath.length === 0 || isAbsolute(requestedPath)) {\n      throw new Error(`Invalid skill path: ${requestedPath}`);\n    }\n\n    const root = resolve(skill.directory, section);\n    const resolved = resolve(root, requestedPath);\n    const rel = relative(root, resolved);\n    if (rel === \"..\" || rel.startsWith(`..${\"/\"}`) || rel.startsWith(`..${\"\\\\\"}`)) {\n      throw new Error(`Invalid skill path: ${requestedPath}`);\n    }\n\n    return resolved;\n  }\n}\n\nfunction runExecutable(\n  command: string,\n  args: string[],\n  cwd: string,\n  timeoutMs: number,\n): Promise<string> {\n  return new Promise((resolvePromise, reject) => {\n    const child = spawn(command, args, {\n      cwd,\n      shell: false,\n      stdio: [\"ignore\", \"pipe\", \"pipe\"],\n    });\n\n    let stdout = \"\";\n    let stderr = \"\";\n    let timedOut = false;\n    const timeout = setTimeout(() => {\n      timedOut = true;\n      child.kill();\n    }, timeoutMs);\n\n    child.stdout.setEncoding(\"utf8\");\n    child.stderr.setEncoding(\"utf8\");\n    child.stdout.on(\"data\", (chunk) => {\n      stdout = appendLimited(stdout, chunk);\n    });\n    child.stderr.on(\"data\", (chunk) => {\n      stderr = appendLimited(stderr, chunk);\n    });\n    child.on(\"error\", (error) => {\n      clearTimeout(timeout);\n      reject(error);\n    });\n    child.on(\"close\", (code, signal) => {\n      clearTimeout(timeout);\n      if (timedOut) {\n        reject(new Error(`Skill script timed out after ${timeoutMs}ms`));\n        return;\n      }\n\n      const output = formatProcessOutput(stdout, stderr);\n      if (code !== 0) {\n        reject(new Error(`Skill script exited with code ${code ?? \"unknown\"}: ${output}`));\n        return;\n      }\n      if (signal !== null) {\n        reject(new Error(`Skill script exited with signal ${signal}: ${output}`));\n        return;\n      }\n\n      resolvePromise(output);\n    });\n  });\n}\n\nfunction formatProcessOutput(stdout: string, stderr: string): string {\n  const parts: string[] = [];\n  if (stdout.length > 0) {\n    parts.push(`stdout:\\n${stdout}`);\n  }\n  if (stderr.length > 0) {\n    parts.push(`stderr:\\n${stderr}`);\n  }\n  return parts.length === 0 ? \"\" : parts.join(\"\\n\\n\");\n}\n\nfunction appendLimited(current: string, chunk: string): string {\n  const next = current + chunk;\n  if (next.length <= MAX_OUTPUT_CHARS) {\n    return next;\n  }\n  return `${next.slice(0, MAX_OUTPUT_CHARS)}\\n[truncated]`;\n}\n","import { skillInstructions } from \"./instructions\";\nimport { createSkillTools } from \"./tools\";\nimport type { Skill, SkillLoader, SkillSet } from \"./types\";\n\nexport async function loadSkills(loaders: SkillLoader | SkillLoader[]): Promise<SkillSet> {\n  const ordered = Array.isArray(loaders) ? loaders : [loaders];\n  const byName = new Map<string, Skill>();\n\n  for (const loader of ordered) {\n    for (const loaded of await loader.load()) {\n      byName.delete(loaded.name);\n      byName.set(loaded.name, loaded);\n    }\n  }\n\n  const skills = [...byName.values()];\n  return {\n    skills,\n    instructions: skillInstructions(skills),\n    tools: skills.length === 0 ? [] : createSkillTools(skills),\n  };\n}\n","import { readdir, readFile, stat } from \"node:fs/promises\";\nimport { basename, join, relative, resolve, sep } from \"node:path\";\nimport { parse as parseYaml } from \"yaml\";\nimport { isRecord } from \"../internal/record\";\nimport type { Skill, SkillLoader, SkillValidationIssue } from \"./types\";\nimport { SkillValidationError } from \"./types\";\n\ntype SkillFrontmatter = {\n  name?: unknown;\n  description?: unknown;\n  license?: unknown;\n  metadata?: unknown;\n};\n\nconst NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;\nconst MAX_NAME_LENGTH = 64;\nconst MAX_DESCRIPTION_LENGTH = 1024;\n\nexport const skill = {\n  local(path: string): SkillLoader {\n    return {\n      load: () => loadLocalSkills(path),\n    };\n  },\n};\n\nasync function loadLocalSkills(path: string): Promise<Skill[]> {\n  const root = resolve(path);\n  if (await hasSkillFile(root)) {\n    return [await readSkill(root)];\n  }\n\n  const entries = await readdir(root, { withFileTypes: true });\n  const skills: Skill[] = [];\n  for (const entry of entries) {\n    if (!entry.isDirectory()) {\n      continue;\n    }\n    const directory = join(root, entry.name);\n    if (await hasSkillFile(directory)) {\n      skills.push(await readSkill(directory));\n    }\n  }\n  return skills;\n}\n\nasync function hasSkillFile(directory: string): Promise<boolean> {\n  try {\n    const info = await stat(join(directory, \"SKILL.md\"));\n    return info.isFile();\n  } catch {\n    return false;\n  }\n}\n\nasync function readSkill(directory: string): Promise<Skill> {\n  const skillPath = join(directory, \"SKILL.md\");\n  const markdown = await readFile(skillPath, \"utf8\");\n  const parsed = parseSkillMarkdown(markdown, skillPath);\n  validateSkillFrontmatter(parsed.frontmatter, directory, skillPath);\n\n  const name = parsed.frontmatter.name as string;\n  const description = parsed.frontmatter.description as string;\n  const license =\n    typeof parsed.frontmatter.license === \"string\" ? parsed.frontmatter.license : undefined;\n  const metadata = isRecord(parsed.frontmatter.metadata) ? parsed.frontmatter.metadata : undefined;\n\n  return {\n    name,\n    description,\n    instructions: parsed.body.trim(),\n    directory,\n    references: await listRelativeFiles(join(directory, \"references\")),\n    scripts: await listRelativeFiles(join(directory, \"scripts\")),\n    license,\n    metadata,\n  };\n}\n\nfunction parseSkillMarkdown(\n  markdown: string,\n  path: string,\n): { frontmatter: SkillFrontmatter; body: string } {\n  if (!markdown.startsWith(\"---\\n\") && !markdown.startsWith(\"---\\r\\n\")) {\n    throw new SkillValidationError(\"Skill validation failed\", [\n      { path, message: \"SKILL.md must start with YAML frontmatter\" },\n    ]);\n  }\n\n  const newline = markdown.startsWith(\"---\\r\\n\") ? \"\\r\\n\" : \"\\n\";\n  const marker = `${newline}---${newline}`;\n  const end = markdown.indexOf(marker, 3);\n  if (end === -1) {\n    throw new SkillValidationError(\"Skill validation failed\", [\n      { path, message: \"SKILL.md frontmatter must end with ---\" },\n    ]);\n  }\n\n  const rawFrontmatter = markdown.slice(3 + newline.length, end);\n  const body = markdown.slice(end + marker.length);\n  const parsed = parseYaml(rawFrontmatter);\n  if (!isRecord(parsed)) {\n    throw new SkillValidationError(\"Skill validation failed\", [\n      { path, message: \"SKILL.md frontmatter must be a YAML object\" },\n    ]);\n  }\n\n  return { frontmatter: parsed, body };\n}\n\nfunction validateSkillFrontmatter(\n  frontmatter: SkillFrontmatter,\n  directory: string,\n  path: string,\n): void {\n  const issues: SkillValidationIssue[] = [];\n  const name = frontmatter.name;\n  const description = frontmatter.description;\n\n  if (typeof name !== \"string\" || name.length === 0) {\n    issues.push({ path, message: \"name is required\" });\n  } else {\n    if (name.length > MAX_NAME_LENGTH) {\n      issues.push({ path, message: `name must be at most ${MAX_NAME_LENGTH} characters` });\n    }\n    if (!NAME_PATTERN.test(name)) {\n      issues.push({\n        path,\n        message: \"name must contain lowercase letters, numbers, and hyphens only\",\n      });\n    }\n    if (basename(directory) !== name) {\n      issues.push({ path, message: \"name must match the skill directory name\" });\n    }\n  }\n\n  if (typeof description !== \"string\" || description.length === 0) {\n    issues.push({ path, message: \"description is required\" });\n  } else if (description.length > MAX_DESCRIPTION_LENGTH) {\n    issues.push({\n      path,\n      message: `description must be at most ${MAX_DESCRIPTION_LENGTH} characters`,\n    });\n  }\n\n  if (issues.length > 0) {\n    throw new SkillValidationError(\"Skill validation failed\", issues);\n  }\n}\n\nasync function listRelativeFiles(directory: string): Promise<string[]> {\n  try {\n    const info = await stat(directory);\n    if (!info.isDirectory()) {\n      return [];\n    }\n  } catch {\n    return [];\n  }\n\n  const files: string[] = [];\n  await collectFiles(directory, directory, files);\n  return files.sort();\n}\n\nasync function collectFiles(root: string, directory: string, files: string[]): Promise<void> {\n  const entries = await readdir(directory, { withFileTypes: true });\n  for (const entry of entries) {\n    const path = join(directory, entry.name);\n    if (entry.isDirectory()) {\n      await collectFiles(root, path, files);\n    } else if (entry.isFile()) {\n      files.push(toPortablePath(relative(root, path)));\n    }\n  }\n}\n\nfunction toPortablePath(path: string): string {\n  return sep === \"/\" ? path : path.split(sep).join(\"/\");\n}\n","import type { AnyTool } from \"../tool\";\n\nexport type Skill = {\n  readonly name: string;\n  readonly description: string;\n  readonly instructions: string;\n  readonly directory: string;\n  readonly references: string[];\n  readonly scripts: string[];\n  readonly license?: string | undefined;\n  readonly metadata?: Record<string, unknown> | undefined;\n};\n\nexport type SkillLoader = {\n  load(): Promise<Skill[]>;\n};\n\nexport type SkillSet = {\n  readonly skills: Skill[];\n  readonly tools: AnyTool[];\n  readonly instructions: string;\n};\n\nexport type SkillValidationIssue = {\n  path: string;\n  message: string;\n};\n\nexport class SkillValidationError extends Error {\n  readonly issues: SkillValidationIssue[];\n\n  constructor(message: string, issues: SkillValidationIssue[]) {\n    super(message);\n    this.name = \"SkillValidationError\";\n    this.issues = issues;\n  }\n}\n"],"mappings":"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","names":["skill","skill","readFile","relative","resolve","resolve","readFile","relative"]}

package/dist/{chunk-MNWK2USR.js → chunk-DZ3CKYTH.js}

@@ -1,7 +1,3 @@
-import {
-  mapWithConcurrency
-} from "./chunk-OIMLU4SF.js";
-
 // src/embeddings/distance.ts
 function dotProduct(left, right) {
   assertSameDimensions(left, right);
@@ -46,6 +42,33 @@ function assertSameDimensions(left, right) {
   }
 }
 
+// src/internal/concurrency.ts
+async function mapWithConcurrency(inputs, concurrency, mapper) {
+  if (!Number.isSafeInteger(concurrency) || concurrency <= 0) {
+    throw new RangeError("concurrency must be a positive safe integer.");
+  }
+  const limit = concurrency;
+  const results = new Array(inputs.length);
+  let nextIndex = 0;
+  let firstFailure;
+  async function worker() {
+    while (firstFailure === void 0 && nextIndex < inputs.length) {
+      const index = nextIndex;
+      nextIndex += 1;
+      try {
+        results[index] = await mapper(inputs[index]);
+      } catch (error) {
+        firstFailure ??= { error };
+      }
+    }
+  }
+  await Promise.all(Array.from({ length: Math.min(limit, inputs.length) }, () => worker()));
+  if (firstFailure !== void 0) {
+    throw firstFailure.error;
+  }
+  return results;
+}
+
 // src/embeddings/embed.ts
 async function embedText(model, text) {
   const embeddings = await embedTexts(model, [text]);
@@ -233,6 +256,7 @@ export {
   euclideanDistance,
   manhattanDistance,
   chebyshevDistance,
+  mapWithConcurrency,
   embedText,
   embedTexts,
   embedSparseTexts,
@@ -240,4 +264,4 @@ export {
   embedDocuments,
   embedHybridDocuments
 };
-//# sourceMappingURL=chunk-MNWK2USR.js.map
+//# sourceMappingURL=chunk-DZ3CKYTH.js.map

package/dist/chunk-DZ3CKYTH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/embeddings/distance.ts","../src/internal/concurrency.ts","../src/embeddings/embed.ts"],"sourcesContent":["export function dotProduct(left: number[], right: number[]): number {\n  assertSameDimensions(left, right);\n  return left.reduce((sum, value, index) => sum + value * (right[index] as number), 0);\n}\n\nexport function cosineSimilarity(left: number[], right: number[]): number {\n  assertSameDimensions(left, right);\n  const leftMagnitude = magnitude(left);\n  const rightMagnitude = magnitude(right);\n  if (leftMagnitude === 0 || rightMagnitude === 0) {\n    return 0;\n  }\n  return dotProduct(left, right) / (leftMagnitude * rightMagnitude);\n}\n\nexport function angularDistance(left: number[], right: number[]): number {\n  const similarity = Math.max(-1, Math.min(1, cosineSimilarity(left, right)));\n  return Math.acos(similarity) / Math.PI;\n}\n\nexport function euclideanDistance(left: number[], right: number[]): number {\n  assertSameDimensions(left, right);\n  return Math.sqrt(\n    left.reduce((sum, value, index) => sum + (value - (right[index] as number)) ** 2, 0),\n  );\n}\n\nexport function manhattanDistance(left: number[], right: number[]): number {\n  assertSameDimensions(left, right);\n  return left.reduce((sum, value, index) => sum + Math.abs(value - (right[index] as number)), 0);\n}\n\nexport function chebyshevDistance(left: number[], right: number[]): number {\n  assertSameDimensions(left, right);\n  return left.reduce(\n    (max, value, index) => Math.max(max, Math.abs(value - (right[index] as number))),\n    0,\n  );\n}\n\nfunction magnitude(vector: number[]): number {\n  return Math.sqrt(vector.reduce((sum, value) => sum + value ** 2, 0));\n}\n\nfunction assertSameDimensions(left: number[], right: number[]): void {\n  if (left.length !== right.length) {\n    throw new Error(`Vector dimension mismatch: ${left.length} !== ${right.length}`);\n  }\n}\n","export async function mapWithConcurrency<Input, Output>(\n  inputs: Input[],\n  concurrency: number,\n  mapper: (input: Input) => Promise<Output>,\n): Promise<Output[]> {\n  if (!Number.isSafeInteger(concurrency) || concurrency <= 0) {\n    throw new RangeError(\"concurrency must be a positive safe integer.\");\n  }\n  const limit = concurrency;\n  const results = new Array<Output>(inputs.length);\n  let nextIndex = 0;\n  let firstFailure: { error: unknown } | undefined;\n\n  async function worker(): Promise<void> {\n    while (firstFailure === undefined && nextIndex < inputs.length) {\n      const index = nextIndex;\n      nextIndex += 1;\n      try {\n        results[index] = await mapper(inputs[index] as Input);\n      } catch (error) {\n        firstFailure ??= { error };\n      }\n    }\n  }\n\n  await Promise.all(Array.from({ length: Math.min(limit, inputs.length) }, () => worker()));\n  if (firstFailure !== undefined) {\n    throw firstFailure.error;\n  }\n  return results;\n}\n","import { mapWithConcurrency } from \"../internal/concurrency\";\nimport type {\n  EmbedDocumentsOptions,\n  EmbeddedDocument,\n  Embedding,\n  EmbeddingModel,\n  EmbedHybridDocumentsOptions,\n  SparseEmbedding,\n  SparseEmbeddingModel,\n  VectorMetadata,\n} from \"./types\";\n\nexport async function embedText(model: EmbeddingModel, text: string): Promise<Embedding> {\n  const embeddings = await embedTexts(model, [text]);\n  const embedding = embeddings[0];\n  if (embedding === undefined) {\n    throw new Error(\"Embedding model returned no embeddings\");\n  }\n  return embedding;\n}\n\nexport async function embedTexts(model: EmbeddingModel, texts: string[]): Promise<Embedding[]> {\n  if (texts.length === 0) {\n    return [];\n  }\n\n  const maxBatchSize = Math.max(1, Math.trunc(model.maxBatchSize ?? texts.length));\n  const batches: string[][] = [];\n  for (let index = 0; index < texts.length; index += maxBatchSize) {\n    batches.push(texts.slice(index, index + maxBatchSize));\n  }\n\n  const results = await mapWithConcurrency(batches, 1, (batch) => model.embedTexts(batch));\n  const embeddings = results.flat();\n  if (embeddings.length !== texts.length) {\n    throw new Error(\n      `Embedding model returned ${embeddings.length} embeddings for ${texts.length} texts`,\n    );\n  }\n  return embeddings;\n}\n\nexport async function embedSparseTexts(\n  model: SparseEmbeddingModel,\n  texts: string[],\n): Promise<SparseEmbedding[]> {\n  if (texts.length === 0) {\n    return [];\n  }\n\n  const maxBatchSize = Math.max(1, Math.trunc(model.maxBatchSize ?? texts.length));\n  const batches: string[][] = [];\n  for (let index = 0; index < texts.length; index += maxBatchSize) {\n    batches.push(texts.slice(index, index + maxBatchSize));\n  }\n\n  const results = await mapWithConcurrency(batches, 1, (batch) => model.embedTexts(batch));\n  const embeddings = results.flat();\n  if (embeddings.length !== texts.length) {\n    throw new Error(\n      `Sparse embedding model returned ${embeddings.length} embeddings for ${texts.length} texts`,\n    );\n  }\n  return embeddings;\n}\n\nexport async function embedSparseQuery(\n  model: SparseEmbeddingModel,\n  query: string,\n): Promise<SparseEmbedding> {\n  return model.embedQuery(query);\n}\n\nexport async function embedDocuments<T, Metadata extends VectorMetadata = VectorMetadata>(\n  model: EmbeddingModel,\n  documents: T[],\n  options: EmbedDocumentsOptions<T, Metadata>,\n): Promise<Array<EmbeddedDocument<T, Metadata>>> {\n  const prepared = prepareDocuments(documents, options);\n\n  const flatTexts = prepared.flatMap((item, documentIndex) =>\n    item.texts.map((text) => ({ documentIndex, text })),\n  );\n  const embeddings = await mapWithConcurrency(\n    chunk(flatTexts, Math.max(1, Math.trunc(model.maxBatchSize ?? (flatTexts.length || 1)))),\n    Math.max(1, Math.trunc(options.concurrency ?? 1)),\n    async (batch) => {\n      const batchEmbeddings = await model.embedTexts(batch.map((item) => item.text));\n      if (batchEmbeddings.length !== batch.length) {\n        throw new Error(\n          `Embedding model returned ${batchEmbeddings.length} embeddings for ${batch.length} texts`,\n        );\n      }\n      return batch.map((item, index) => ({\n        documentIndex: item.documentIndex,\n        embedding: batchEmbeddings[index] as Embedding,\n      }));\n    },\n  );\n\n  const byDocument = new Map<number, Embedding[]>();\n  for (const item of embeddings.flat()) {\n    const list = byDocument.get(item.documentIndex) ?? [];\n    list.push(item.embedding);\n    byDocument.set(item.documentIndex, list);\n  }\n\n  return prepared.map((item, index) => {\n    const documentEmbeddings = byDocument.get(index) ?? [];\n    if (item.metadata === undefined) {\n      return { id: item.id, document: item.document, embeddings: documentEmbeddings };\n    }\n    return {\n      id: item.id,\n      document: item.document,\n      metadata: item.metadata,\n      embeddings: documentEmbeddings,\n    };\n  });\n}\n\nexport async function embedHybridDocuments<T, Metadata extends VectorMetadata = VectorMetadata>(\n  models: EmbedHybridDocumentsOptions,\n  documents: T[],\n  options: EmbedDocumentsOptions<T, Metadata>,\n): Promise<Array<EmbeddedDocument<T, Metadata>>> {\n  const prepared = prepareDocuments(documents, options);\n  const flatTexts = prepared.flatMap((item, documentIndex) =>\n    item.texts.map((text) => ({ documentIndex, text })),\n  );\n  const concurrency = Math.max(1, Math.trunc(options.concurrency ?? 1));\n\n  const denseBatches = chunk(\n    flatTexts,\n    Math.max(1, Math.trunc(models.dense.maxBatchSize ?? (flatTexts.length || 1))),\n  );\n  const sparseBatches = chunk(\n    flatTexts,\n    Math.max(1, Math.trunc(models.sparse.maxBatchSize ?? (flatTexts.length || 1))),\n  );\n\n  const [denseResults, sparseResults] = await Promise.all([\n    mapWithConcurrency(denseBatches, concurrency, async (batch) => {\n      const batchEmbeddings = await models.dense.embedTexts(batch.map((item) => item.text));\n      if (batchEmbeddings.length !== batch.length) {\n        throw new Error(\n          `Embedding model returned ${batchEmbeddings.length} embeddings for ${batch.length} texts`,\n        );\n      }\n      return batch.map((item, index) => ({\n        documentIndex: item.documentIndex,\n        embedding: batchEmbeddings[index] as Embedding,\n      }));\n    }),\n    mapWithConcurrency(sparseBatches, concurrency, async (batch) => {\n      const batchEmbeddings = await models.sparse.embedTexts(batch.map((item) => item.text));\n      if (batchEmbeddings.length !== batch.length) {\n        throw new Error(\n          `Sparse embedding model returned ${batchEmbeddings.length} embeddings for ${batch.length} texts`,\n        );\n      }\n      return batch.map((item, index) => ({\n        documentIndex: item.documentIndex,\n        embedding: batchEmbeddings[index] as SparseEmbedding,\n      }));\n    }),\n  ]);\n\n  const denseByDocument = new Map<number, Embedding[]>();\n  for (const item of denseResults.flat()) {\n    const list = denseByDocument.get(item.documentIndex) ?? [];\n    list.push(item.embedding);\n    denseByDocument.set(item.documentIndex, list);\n  }\n\n  const sparseByDocument = new Map<number, SparseEmbedding[]>();\n  for (const item of sparseResults.flat()) {\n    const list = sparseByDocument.get(item.documentIndex) ?? [];\n    list.push(item.embedding);\n    sparseByDocument.set(item.documentIndex, list);\n  }\n\n  return prepared.map((item, index) => {\n    const embeddings = denseByDocument.get(index) ?? [];\n    const sparseEmbeddings = sparseByDocument.get(index) ?? [];\n    if (embeddings.length !== sparseEmbeddings.length) {\n      throw new Error(\n        `Hybrid embedding produced ${embeddings.length} dense and ${sparseEmbeddings.length} sparse vectors for document ${item.id}`,\n      );\n    }\n    if (item.metadata === undefined) {\n      return { id: item.id, document: item.document, embeddings, sparseEmbeddings };\n    }\n    return {\n      id: item.id,\n      document: item.document,\n      metadata: item.metadata,\n      embeddings,\n      sparseEmbeddings,\n    };\n  });\n}\n\nfunction prepareDocuments<T, Metadata extends VectorMetadata>(\n  documents: T[],\n  options: EmbedDocumentsOptions<T, Metadata>,\n) {\n  return documents.map((document, index) => {\n    const content = options.content(document, index);\n    const texts = Array.isArray(content) ? content : [content];\n    return {\n      id: options.id?.(document, index) ?? `doc${index}`,\n      document,\n      metadata: options.metadata?.(document, index),\n      texts,\n    };\n  });\n}\n\nfunction chunk<T>(items: T[], size: number): T[][] {\n  const chunks: T[][] = [];\n  for (let index = 0; index < items.length; index += size) {\n    chunks.push(items.slice(index, index + size));\n  }\n  return chunks;\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-CWUJUSOS.js → chunk-FNQB2JEH.js}

@@ -288,4 +288,4 @@ export {
   runInputGuardrails,
   runOutputGuardrails
 };
-//# sourceMappingURL=chunk-CWUJUSOS.js.map
+//# sourceMappingURL=chunk-FNQB2JEH.js.map

package/dist/chunk-FNQB2JEH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/guardrails/index.ts"],"sourcesContent":["import type { JsonObject, Message, Usage } from \"../completion\";\nimport type { MaybePromise } from \"../internal/type-utils\";\n\nexport type GuardrailMode = \"enforce\" | \"observe\";\n\nexport type GuardrailBoundary = \"input\" | \"output\";\n\nexport type GuardrailRunContext = {\n  agentId: string;\n  runId: string;\n  sessionId?: string | undefined;\n  metadata?: JsonObject | undefined;\n};\n\nexport type GuardrailDecisionRecord = {\n  policyId: string;\n  guardrailId: string;\n  boundary: GuardrailBoundary;\n  mode: GuardrailMode;\n  action: GuardrailActionName;\n  applied: boolean;\n  reason?: string | undefined;\n  message?: string | undefined;\n  metadata?: JsonObject | undefined;\n  latencyMs: number;\n};\n\nexport type GuardrailActionName = \"allow\" | \"block\" | \"rewrite\" | \"error\";\n\nexport type GuardrailActionBase = {\n  reason?: string | undefined;\n  metadata?: JsonObject | undefined;\n};\n\nexport type GuardrailAllow = GuardrailActionBase & {\n  action: \"allow\";\n};\n\nexport type GuardrailBlock = GuardrailActionBase & {\n  action: \"block\";\n  reason: string;\n  message?: string | undefined;\n};\n\nexport type InputGuardrailRewrite = GuardrailActionBase & {\n  action: \"rewrite\";\n  prompt?: Message | undefined;\n  inputText?: string | undefined;\n};\n\nexport type OutputGuardrailRewrite = GuardrailActionBase & {\n  action: \"rewrite\";\n  outputText: string;\n};\n\nexport type InputGuardrailResult = GuardrailAllow | GuardrailBlock | InputGuardrailRewrite;\nexport type OutputGuardrailResult = GuardrailAllow | GuardrailBlock | OutputGuardrailRewrite;\n\nexport type GuardrailCommonActions = {\n  allow(options?: GuardrailActionBase): GuardrailAllow;\n  block(options: Omit<GuardrailBlock, \"action\">): GuardrailBlock;\n};\n\nexport type InputGuardrailActions = GuardrailCommonActions & {\n  rewrite(options: Omit<InputGuardrailRewrite, \"action\">): InputGuardrailRewrite;\n};\n\nexport type OutputGuardrailActions = GuardrailCommonActions & {\n  rewrite(options: Omit<OutputGuardrailRewrite, \"action\">): OutputGuardrailRewrite;\n};\n\nexport type InputGuardrailContext = {\n  prompt: Message;\n  history: Message[];\n  inputText: string;\n  run: GuardrailRunContext;\n};\n\nexport type OutputGuardrailContext = {\n  outputText: string;\n  messages: Message[];\n  usage: Usage;\n  run: GuardrailRunContext;\n};\n\nexport type InputGuardrail = {\n  id: string;\n  check(\n    context: InputGuardrailContext,\n    actions: InputGuardrailActions,\n  ): MaybePromise<InputGuardrailResult | undefined>;\n};\n\nexport type OutputGuardrail = {\n  id: string;\n  check(\n    context: OutputGuardrailContext,\n    actions: OutputGuardrailActions,\n  ): MaybePromise<OutputGuardrailResult | undefined>;\n};\n\nexport type GuardrailPolicy = {\n  id: string;\n  mode: GuardrailMode;\n  input: InputGuardrail[];\n  output: OutputGuardrail[];\n};\n\nexport type GuardrailPolicyOptions = {\n  id: string;\n  mode?: GuardrailMode | undefined;\n  input?: InputGuardrail[] | undefined;\n  output?: OutputGuardrail[] | undefined;\n};\n\nexport type GuardrailPolicyInput = GuardrailPolicy | GuardrailPolicy[];\n\nexport type InputGuardrailRunResult = {\n  prompt: Message;\n  inputText: string;\n  blocked: boolean;\n  message?: string | undefined;\n  decisions: GuardrailDecisionRecord[];\n};\n\nexport type OutputGuardrailRunResult = {\n  outputText: string;\n  blocked: boolean;\n  message?: string | undefined;\n  decisions: GuardrailDecisionRecord[];\n};\n\nexport function defineGuardrailPolicy(options: GuardrailPolicyOptions): GuardrailPolicy {\n  return {\n    id: options.id,\n    mode: options.mode ?? \"enforce\",\n    input: options.input ?? [],\n    output: options.output ?? [],\n  };\n}\n\nexport function defineInputGuardrail(guardrail: InputGuardrail): InputGuardrail {\n  return guardrail;\n}\n\nexport function defineOutputGuardrail(guardrail: OutputGuardrail): OutputGuardrail {\n  return guardrail;\n}\n\nexport function allow(options: GuardrailActionBase = {}): GuardrailAllow {\n  return { action: \"allow\", ...options };\n}\n\nexport function block(options: Omit<GuardrailBlock, \"action\">): GuardrailBlock {\n  return { action: \"block\", ...options };\n}\n\nexport const guardrails = {\n  blockText,\n  redactText,\n};\n\nexport function normalizeGuardrailPolicies(\n  policies: GuardrailPolicyInput | undefined,\n): GuardrailPolicy[] {\n  if (policies === undefined) {\n    return [];\n  }\n  return Array.isArray(policies) ? policies : [policies];\n}\n\nexport function appendGuardrailPolicies(\n  current: GuardrailPolicy[],\n  next: GuardrailPolicyInput,\n): GuardrailPolicy[] {\n  return [...current, ...normalizeGuardrailPolicies(next)];\n}\n\nexport function hasEnforcedOutputGuardrails(policies: GuardrailPolicy[]): boolean {\n  return policies.some((policy) => policy.mode === \"enforce\" && policy.output.length > 0);\n}\n\nexport async function runInputGuardrails(\n  policies: GuardrailPolicy[],\n  context: InputGuardrailContext,\n): Promise<InputGuardrailRunResult> {\n  let prompt = context.prompt;\n  let inputText = context.inputText;\n  const decisions: GuardrailDecisionRecord[] = [];\n\n  for (const policy of policies) {\n    for (const guardrail of policy.input) {\n      const currentContext = { ...context, prompt, inputText };\n      const result = await runGuardrail(policy, guardrail.id, \"input\", () =>\n        guardrail.check(currentContext, inputActions),\n      );\n      decisions.push(result.decision);\n\n      if (policy.mode === \"observe\") {\n        continue;\n      }\n      if (result.action.action === \"block\") {\n        return {\n          prompt,\n          inputText,\n          blocked: true,\n          message: result.action.message,\n          decisions,\n        };\n      }\n      if (result.action.action === \"rewrite\") {\n        if (result.action.prompt !== undefined) {\n          prompt = result.action.prompt;\n          inputText = textFromMessage(prompt);\n        } else if (result.action.inputText !== undefined) {\n          inputText = result.action.inputText;\n          prompt = rewriteMessageText(prompt, inputText);\n        }\n      }\n    }\n  }\n\n  return { prompt, inputText, blocked: false, decisions };\n}\n\nexport async function runOutputGuardrails(\n  policies: GuardrailPolicy[],\n  context: OutputGuardrailContext,\n): Promise<OutputGuardrailRunResult> {\n  let outputText = context.outputText;\n  const decisions: GuardrailDecisionRecord[] = [];\n\n  for (const policy of policies) {\n    for (const guardrail of policy.output) {\n      const currentContext = { ...context, outputText };\n      const result = await runGuardrail(policy, guardrail.id, \"output\", () =>\n        guardrail.check(currentContext, outputActions),\n      );\n      decisions.push(result.decision);\n\n      if (policy.mode === \"observe\") {\n        continue;\n      }\n      if (result.action.action === \"block\") {\n        return {\n          outputText,\n          blocked: true,\n          message: result.action.message,\n          decisions,\n        };\n      }\n      if (result.action.action === \"rewrite\") {\n        outputText = result.action.outputText;\n      }\n    }\n  }\n\n  return { outputText, blocked: false, decisions };\n}\n\ntype RunGuardrailResult<TAction extends { action: GuardrailActionName }> = {\n  action: TAction;\n  decision: GuardrailDecisionRecord;\n};\n\nasync function runGuardrail<TAction extends { action: GuardrailActionName } & GuardrailActionBase>(\n  policy: GuardrailPolicy,\n  guardrailId: string,\n  boundary: GuardrailBoundary,\n  run: () => MaybePromise<TAction | undefined>,\n): Promise<RunGuardrailResult<TAction | GuardrailAllow>> {\n  const startedAt = Date.now();\n  try {\n    const action = (await run()) ?? allow();\n    return {\n      action,\n      decision: decisionRecord({\n        policy,\n        guardrailId,\n        boundary,\n        action,\n        latencyMs: Date.now() - startedAt,\n      }),\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    if (policy.mode === \"observe\") {\n      return {\n        action: allow(),\n        decision: {\n          policyId: policy.id,\n          guardrailId,\n          boundary,\n          mode: policy.mode,\n          action: \"error\",\n          applied: false,\n          reason: message,\n          latencyMs: Date.now() - startedAt,\n        },\n      };\n    }\n    throw error;\n  }\n}\n\nfunction decisionRecord(args: {\n  policy: GuardrailPolicy;\n  guardrailId: string;\n  boundary: GuardrailBoundary;\n  action: GuardrailAllow | GuardrailBlock | ({ action: GuardrailActionName } & GuardrailActionBase);\n  latencyMs: number;\n}): GuardrailDecisionRecord {\n  const applied = args.policy.mode === \"enforce\" && args.action.action !== \"allow\";\n  const record: GuardrailDecisionRecord = {\n    policyId: args.policy.id,\n    guardrailId: args.guardrailId,\n    boundary: args.boundary,\n    mode: args.policy.mode,\n    action: args.action.action,\n    applied,\n    latencyMs: args.latencyMs,\n  };\n  if (args.action.reason !== undefined) record.reason = args.action.reason;\n  if (\"message\" in args.action && typeof args.action.message === \"string\") {\n    record.message = args.action.message;\n  }\n  if (args.action.metadata !== undefined) record.metadata = args.action.metadata;\n  return record;\n}\n\nconst commonActions: GuardrailCommonActions = {\n  allow,\n  block,\n};\n\nconst inputActions: InputGuardrailActions = {\n  ...commonActions,\n  rewrite(options) {\n    return { action: \"rewrite\", ...options };\n  },\n};\n\nconst outputActions: OutputGuardrailActions = {\n  ...commonActions,\n  rewrite(options) {\n    return { action: \"rewrite\", ...options };\n  },\n};\n\ntype TextPatternBoundary = \"input\" | \"output\";\n\ntype TextPatternGuardrailFor<Boundary extends TextPatternBoundary> = Boundary extends \"input\"\n  ? InputGuardrail\n  : OutputGuardrail;\n\ntype TextPatternGuardrailOptions<Boundary extends TextPatternBoundary = TextPatternBoundary> = {\n  id: string;\n  boundary: Boundary;\n  patterns: Array<string | RegExp>;\n  reason: string;\n  message?: string | undefined;\n};\n\ntype TextPatternRedactOptions<Boundary extends TextPatternBoundary = TextPatternBoundary> =\n  TextPatternGuardrailOptions<Boundary> & { replacement?: string | undefined };\n\nfunction blockText<Boundary extends TextPatternBoundary>(\n  options: TextPatternGuardrailOptions<Boundary>,\n): TextPatternGuardrailFor<Boundary> {\n  return textPatternGuardrail(options, \"block\");\n}\n\nfunction redactText<Boundary extends TextPatternBoundary>(\n  options: TextPatternRedactOptions<Boundary>,\n): TextPatternGuardrailFor<Boundary> {\n  return textPatternGuardrail(options, \"rewrite\");\n}\n\nfunction textPatternGuardrail<Boundary extends TextPatternBoundary>(\n  options: TextPatternRedactOptions<Boundary>,\n  action: \"block\" | \"rewrite\",\n): TextPatternGuardrailFor<Boundary> {\n  if (options.boundary === \"input\") {\n    return defineInputGuardrail({\n      id: options.id,\n      check(ctx, actions) {\n        return textPatternAction(ctx.inputText, options, action, (value) =>\n          actions.rewrite({ inputText: value, reason: options.reason }),\n        );\n      },\n    }) as TextPatternGuardrailFor<Boundary>;\n  }\n  return defineOutputGuardrail({\n    id: options.id,\n    check(ctx, actions) {\n      return textPatternAction(ctx.outputText, options, action, (value) =>\n        actions.rewrite({ outputText: value, reason: options.reason }),\n      );\n    },\n  }) as TextPatternGuardrailFor<Boundary>;\n}\n\nfunction textPatternAction<TRewrite>(\n  text: string,\n  options: TextPatternGuardrailOptions & { replacement?: string | undefined },\n  action: \"block\" | \"rewrite\",\n  rewrite: (value: string) => TRewrite,\n): GuardrailAllow | GuardrailBlock | TRewrite {\n  const matched = options.patterns.some((pattern) => textPatternMatches(text, pattern));\n  if (!matched) {\n    return allow();\n  }\n  if (action === \"block\") {\n    return block({\n      reason: options.reason,\n      message: options.message,\n    });\n  }\n  let current = text;\n  for (const pattern of options.patterns) {\n    current = replaceTextPattern(current, pattern, options.replacement ?? \"[redacted]\");\n  }\n  return rewrite(current);\n}\n\nfunction textPatternMatches(text: string, pattern: string | RegExp): boolean {\n  if (typeof pattern === \"string\") {\n    return text.includes(pattern);\n  }\n  pattern.lastIndex = 0;\n  const matched = pattern.test(text);\n  pattern.lastIndex = 0;\n  return matched;\n}\n\nfunction replaceTextPattern(text: string, pattern: string | RegExp, replacement: string): string {\n  if (typeof pattern === \"string\") {\n    return text.split(pattern).join(replacement);\n  }\n  pattern.lastIndex = 0;\n  const flags = pattern.flags.replace(\"y\", \"\");\n  const globalFlags = flags.includes(\"g\") ? flags : `${flags}g`;\n  return text.replace(new RegExp(pattern.source, globalFlags), replacement);\n}\n\nfunction textFromMessage(message: Message): string {\n  if (message.role === \"system\") {\n    return message.content;\n  }\n  return message.content\n    .flatMap((content) => {\n      if (content.type === \"text\") {\n        return [content.text];\n      }\n      if (content.type === \"document\" && content.source.type === \"text\") {\n        return [content.source.text];\n      }\n      return [];\n    })\n    .join(\"\\n\");\n}\n\nfunction rewriteMessageText(message: Message, text: string): Message {\n  if (message.role === \"system\") {\n    return { ...message, content: text };\n  }\n  if (message.role === \"user\") {\n    return {\n      ...message,\n      content: [\n        { type: \"text\", text },\n        ...message.content.filter(\n          (item) =>\n            item.type !== \"text\" && !(item.type === \"document\" && item.source.type === \"text\"),\n        ),\n      ],\n    };\n  }\n  if (message.role === \"assistant\") {\n    return { ...message, content: [{ type: \"text\", text }] };\n  }\n  return message;\n}\n"],"mappings":"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","names":[]}