@anvia/core 1.0.0-rc.1 → 1.0.0-rc.2

package/dist/chunk-BEYBU7VJ.js

@@ -0,0 +1,53 @@
+import {
+  resolveRetryOptions,
+  runWithRetries,
+  throwIfAborted
+} from "./chunk-FN7HLLAZ.js";
+
+// src/image-generation/generate-image.ts
+async function generateImage(options) {
+  assertNonEmptyString(options.prompt, "Image prompt");
+  throwIfAborted(options.abortSignal);
+  const width = options.width ?? 1024;
+  const height = options.height ?? 1024;
+  assertPositiveInteger(width, "Image width");
+  assertPositiveInteger(height, "Image height");
+  const request = { prompt: options.prompt, width, height };
+  if (options.providerOptions !== void 0) request.providerOptions = options.providerOptions;
+  const result = await runWithRetries(
+    () => {
+      throwIfAborted(options.abortSignal);
+      return options.model.imageGeneration(
+        request,
+        modelCallOptions(options.abortSignal)
+      );
+    },
+    resolveRetries(options.retries),
+    { streaming: false, abortSignal: options.abortSignal }
+  );
+  if (!Array.isArray(result.images) || result.images.length === 0) {
+    throw new Error("The image generation model returned no images.");
+  }
+  return result;
+}
+function resolveRetries(setting) {
+  return setting === void 0 || setting === false ? void 0 : resolveRetryOptions(setting);
+}
+function modelCallOptions(abortSignal) {
+  return abortSignal === void 0 ? void 0 : { abortSignal };
+}
+function assertNonEmptyString(value, name) {
+  if (typeof value !== "string" || value.trim().length === 0) {
+    throw new TypeError(`${name} must be a non-empty string.`);
+  }
+}
+function assertPositiveInteger(value, name) {
+  if (!Number.isSafeInteger(value) || value < 1) {
+    throw new RangeError(`${name} must be a positive integer.`);
+  }
+}
+
+export {
+  generateImage
+};
+//# sourceMappingURL=chunk-BEYBU7VJ.js.map

package/dist/chunk-BEYBU7VJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/image-generation/generate-image.ts"],"sourcesContent":["import type { JsonObject } from \"../completion/types\";\nimport { throwIfAborted } from \"../internal/abort\";\nimport type { ModelCallOptions } from \"../model-call-options\";\nimport {\n  type ResolvedRetryOptions,\n  type RetrySetting,\n  resolveRetryOptions,\n  runWithRetries,\n} from \"../retry\";\nimport type { ImageGenerationModel, ImageGenerationRequest, ImageGenerationResult } from \"./types\";\n\nexport type GenerateImageOptions<Model extends ImageGenerationModel = ImageGenerationModel> = {\n  model: Model;\n  prompt: string;\n  width?: number | undefined;\n  height?: number | undefined;\n  providerOptions?: JsonObject | undefined;\n  retries?: RetrySetting | undefined;\n  abortSignal?: AbortSignal | undefined;\n};\n\ntype RawResponseOf<Model> =\n  Model extends ImageGenerationModel<infer RawResponse> ? RawResponse : unknown;\n\nexport async function generateImage<Model extends ImageGenerationModel>(\n  options: GenerateImageOptions<Model>,\n): Promise<ImageGenerationResult<RawResponseOf<Model>>> {\n  assertNonEmptyString(options.prompt, \"Image prompt\");\n  throwIfAborted(options.abortSignal);\n  const width = options.width ?? 1024;\n  const height = options.height ?? 1024;\n  assertPositiveInteger(width, \"Image width\");\n  assertPositiveInteger(height, \"Image height\");\n\n  const request: ImageGenerationRequest = { prompt: options.prompt, width, height };\n  if (options.providerOptions !== undefined) request.providerOptions = options.providerOptions;\n  const result = await runWithRetries(\n    () => {\n      throwIfAborted(options.abortSignal);\n      return options.model.imageGeneration(\n        request,\n        modelCallOptions(options.abortSignal),\n      ) as Promise<ImageGenerationResult<RawResponseOf<Model>>>;\n    },\n    resolveRetries(options.retries),\n    { streaming: false, abortSignal: options.abortSignal },\n  );\n  if (!Array.isArray(result.images) || result.images.length === 0) {\n    throw new Error(\"The image generation model returned no images.\");\n  }\n  return result;\n}\n\nfunction resolveRetries(setting: RetrySetting | undefined): ResolvedRetryOptions | undefined {\n  return setting === undefined || setting === false ? undefined : resolveRetryOptions(setting);\n}\n\nfunction modelCallOptions(abortSignal: AbortSignal | undefined): ModelCallOptions | undefined {\n  return abortSignal === undefined ? undefined : { abortSignal };\n}\n\nfunction assertNonEmptyString(value: string, name: string): void {\n  if (typeof value !== \"string\" || value.trim().length === 0) {\n    throw new TypeError(`${name} must be a non-empty string.`);\n  }\n}\n\nfunction assertPositiveInteger(value: number, name: string): void {\n  if (!Number.isSafeInteger(value) || value < 1) {\n    throw new RangeError(`${name} must be a positive integer.`);\n  }\n}\n"],"mappings":";;;;;;;AAwBA,eAAsB,cACpB,SACsD;AACtD,uBAAqB,QAAQ,QAAQ,cAAc;AACnD,iBAAe,QAAQ,WAAW;AAClC,QAAM,QAAQ,QAAQ,SAAS;AAC/B,QAAM,SAAS,QAAQ,UAAU;AACjC,wBAAsB,OAAO,aAAa;AAC1C,wBAAsB,QAAQ,cAAc;AAE5C,QAAM,UAAkC,EAAE,QAAQ,QAAQ,QAAQ,OAAO,OAAO;AAChF,MAAI,QAAQ,oBAAoB,OAAW,SAAQ,kBAAkB,QAAQ;AAC7E,QAAM,SAAS,MAAM;AAAA,IACnB,MAAM;AACJ,qBAAe,QAAQ,WAAW;AAClC,aAAO,QAAQ,MAAM;AAAA,QACnB;AAAA,QACA,iBAAiB,QAAQ,WAAW;AAAA,MACtC;AAAA,IACF;AAAA,IACA,eAAe,QAAQ,OAAO;AAAA,IAC9B,EAAE,WAAW,OAAO,aAAa,QAAQ,YAAY;AAAA,EACvD;AACA,MAAI,CAAC,MAAM,QAAQ,OAAO,MAAM,KAAK,OAAO,OAAO,WAAW,GAAG;AAC/D,UAAM,IAAI,MAAM,gDAAgD;AAAA,EAClE;AACA,SAAO;AACT;AAEA,SAAS,eAAe,SAAqE;AAC3F,SAAO,YAAY,UAAa,YAAY,QAAQ,SAAY,oBAAoB,OAAO;AAC7F;AAEA,SAAS,iBAAiB,aAAoE;AAC5F,SAAO,gBAAgB,SAAY,SAAY,EAAE,YAAY;AAC/D;AAEA,SAAS,qBAAqB,OAAe,MAAoB;AAC/D,MAAI,OAAO,UAAU,YAAY,MAAM,KAAK,EAAE,WAAW,GAAG;AAC1D,UAAM,IAAI,UAAU,GAAG,IAAI,8BAA8B;AAAA,EAC3D;AACF;AAEA,SAAS,sBAAsB,OAAe,MAAoB;AAChE,MAAI,CAAC,OAAO,cAAc,KAAK,KAAK,QAAQ,GAAG;AAC7C,UAAM,IAAI,WAAW,GAAG,IAAI,8BAA8B;AAAA,EAC5D;AACF;","names":[]}

package/dist/chunk-CWM7B2OO.js

@@ -0,0 +1,315 @@
+import {
+  Usage
+} from "./chunk-KR3RCCHJ.js";
+
+// src/observability/snapshot.ts
+function observerSnapshot(value) {
+  if (containsError(value, /* @__PURE__ */ new WeakSet())) {
+    return cloneObserverFallback(value, /* @__PURE__ */ new WeakMap());
+  }
+  try {
+    return globalThis.structuredClone(value);
+  } catch {
+    return cloneObserverFallback(value, /* @__PURE__ */ new WeakMap());
+  }
+}
+function cloneObserverFallback(value, seen) {
+  if (typeof value !== "object" || value === null) {
+    return value;
+  }
+  const existing = seen.get(value);
+  if (existing !== void 0) {
+    return existing;
+  }
+  if (Array.isArray(value)) {
+    const clone2 = [];
+    seen.set(value, clone2);
+    clone2.push(...value.map((item) => cloneObserverFallback(item, seen)));
+    return clone2;
+  }
+  if (value instanceof Date) {
+    return new Date(value.getTime());
+  }
+  if (value instanceof Error) {
+    const clone2 = Object.create(Object.getPrototypeOf(value));
+    seen.set(value, clone2);
+    Object.defineProperties(clone2, {
+      name: { configurable: true, writable: true, value: value.name },
+      message: { configurable: true, writable: true, value: value.message }
+    });
+    if (value.stack !== void 0) {
+      Object.defineProperty(clone2, "stack", {
+        configurable: true,
+        writable: true,
+        value: value.stack
+      });
+    }
+    if (value.cause !== void 0) {
+      Object.defineProperty(clone2, "cause", {
+        configurable: true,
+        writable: true,
+        value: cloneObserverFallback(value.cause, seen)
+      });
+    }
+    for (const key of Object.getOwnPropertyNames(value)) {
+      if (key === "name" || key === "message" || key === "stack" || key === "cause") continue;
+      const descriptor = Object.getOwnPropertyDescriptor(value, key);
+      if (descriptor === void 0) continue;
+      if ("value" in descriptor) {
+        descriptor.value = cloneObserverFallback(descriptor.value, seen);
+      }
+      Object.defineProperty(clone2, key, descriptor);
+    }
+    return clone2;
+  }
+  if (Object.getPrototypeOf(value) !== Object.prototype) {
+    return value;
+  }
+  const clone = {};
+  seen.set(value, clone);
+  for (const [key, item] of Object.entries(value)) {
+    clone[key] = cloneObserverFallback(item, seen);
+  }
+  return clone;
+}
+function containsError(value, seen) {
+  if (typeof value !== "object" || value === null) return false;
+  if (value instanceof Error) return true;
+  if (seen.has(value)) return false;
+  seen.add(value);
+  if (Array.isArray(value)) {
+    return value.some((item) => containsError(item, seen));
+  }
+  if (Object.getPrototypeOf(value) !== Object.prototype) return false;
+  return Object.values(value).some((item) => containsError(item, seen));
+}
+
+// src/observability/group.ts
+var AgentObserverDispatchError = class extends AggregateError {
+  phase;
+  failures;
+  constructor(phase, failures) {
+    super(
+      failures.map((failure) => failure.error),
+      `Agent observer ${phase} failed for ${failures.map((failure) => failure.observer).join(", ")}.`
+    );
+    this.name = "AgentObserverDispatchError";
+    this.phase = phase;
+    this.failures = Object.freeze([...failures]);
+  }
+};
+async function startAgentRunObservers(observers, args, options) {
+  const runObservers = [];
+  const failures = [];
+  for (const [name, observer] of Object.entries(observers)) {
+    try {
+      const runObserver = await observer.startRun(observerSnapshot(args));
+      if (runObserver !== void 0) {
+        runObservers.push({ name, observer: runObserver, terminal: false });
+      }
+    } catch (error) {
+      failures.push({ observer: name, error });
+    }
+  }
+  if (options.errorPolicy === "throw" && failures.length > 0) {
+    const startupError = new AgentObserverDispatchError("startRun", failures);
+    const cleanupFailures = await terminateObservers(
+      runObservers,
+      (observer) => observer.error?.(
+        observerSnapshot({
+          error: startupError,
+          usage: Usage.empty(),
+          messages: [...args.history, args.prompt]
+        })
+      )
+    );
+    throw new AgentObserverDispatchError("startRun", [...failures, ...cleanupFailures]);
+  }
+  return new ActiveAgentRunObservers(runObservers, options);
+}
+var ActiveAgentRunObservers = class {
+  constructor(runObservers, options) {
+    this.runObservers = runObservers;
+    this.options = options;
+    const primary = options.primaryTrace === void 0 ? void 0 : runObservers.find((entry) => entry.name === options.primaryTrace);
+    this.trace = primary?.observer.trace === void 0 ? void 0 : Object.freeze({ observer: primary.name, ...primary.observer.trace });
+  }
+  runObservers;
+  options;
+  trace;
+  async startGeneration(args) {
+    const generationObservers = [];
+    const failures = [];
+    for (const entry of this.runObservers) {
+      if (entry.observer.startGeneration === void 0) continue;
+      try {
+        const observer = await entry.observer.startGeneration(observerSnapshot(args));
+        if (observer !== void 0) {
+          generationObservers.push({ name: entry.name, observer, terminal: false });
+        }
+      } catch (error) {
+        failures.push({ observer: entry.name, error });
+      }
+    }
+    if (this.options.errorPolicy === "throw" && failures.length > 0) {
+      const startupError = new AgentObserverDispatchError("startGeneration", failures);
+      const cleanupFailures = await terminateObservers(
+        generationObservers,
+        (observer) => observer.error?.(observerSnapshot({ turn: args.turn, error: startupError }))
+      );
+      throw new AgentObserverDispatchError("startGeneration", [...failures, ...cleanupFailures]);
+    }
+    return new ActiveGenerationObservers(generationObservers, this.options.errorPolicy);
+  }
+  async startTool(args) {
+    const toolObservers = [];
+    const failures = [];
+    for (const entry of this.runObservers) {
+      if (entry.observer.startTool === void 0) continue;
+      try {
+        const observer = await entry.observer.startTool(observerSnapshot(args));
+        if (observer !== void 0) {
+          toolObservers.push({ name: entry.name, observer, terminal: false });
+        }
+      } catch (error) {
+        failures.push({ observer: entry.name, error });
+      }
+    }
+    if (this.options.errorPolicy === "throw" && failures.length > 0) {
+      const startupError = new AgentObserverDispatchError("startTool", failures);
+      const cleanupFailures = await terminateObservers(
+        toolObservers,
+        (observer) => observer.error?.(observerSnapshot({ ...args, error: startupError }))
+      );
+      throw new AgentObserverDispatchError("startTool", [...failures, ...cleanupFailures]);
+    }
+    return new ActiveToolObservers(toolObservers, this.options.errorPolicy);
+  }
+  async end(args) {
+    await dispatchTerminalObservers(
+      this.runObservers,
+      "end",
+      (observer) => observer.end(observerSnapshot(args)),
+      this.options.errorPolicy
+    );
+  }
+  async error(args) {
+    await dispatchTerminalObservers(
+      this.runObservers,
+      "error",
+      (observer) => observer.error?.(observerSnapshot(args)),
+      "ignore"
+    );
+  }
+  async event(args) {
+    await dispatchObservers(
+      this.runObservers,
+      "event",
+      (observer) => observer.event?.(observerSnapshot(args)),
+      this.options.errorPolicy
+    );
+  }
+};
+var ActiveGenerationObservers = class {
+  constructor(observers, errorPolicy) {
+    this.observers = observers;
+    this.errorPolicy = errorPolicy;
+  }
+  observers;
+  errorPolicy;
+  async end(args) {
+    await dispatchTerminalObservers(
+      this.observers,
+      "generation.end",
+      (observer) => observer.end(observerSnapshot(args)),
+      this.errorPolicy
+    );
+  }
+  async error(args) {
+    await dispatchTerminalObservers(
+      this.observers,
+      "generation.error",
+      (observer) => observer.error?.(observerSnapshot(args)),
+      "ignore"
+    );
+  }
+  async update(args) {
+    await dispatchObservers(
+      this.observers,
+      "generation.update",
+      (observer) => observer.update?.(observerSnapshot(args)),
+      this.errorPolicy
+    );
+  }
+};
+var ActiveToolObservers = class {
+  constructor(observers, errorPolicy) {
+    this.observers = observers;
+    this.errorPolicy = errorPolicy;
+  }
+  observers;
+  errorPolicy;
+  async streamEvent(args) {
+    await dispatchObservers(
+      this.observers,
+      "tool.streamEvent",
+      (observer) => observer.streamEvent?.(observerSnapshot(args)),
+      this.errorPolicy
+    );
+  }
+  async end(args) {
+    await dispatchTerminalObservers(
+      this.observers,
+      "tool.end",
+      (observer) => observer.end(observerSnapshot(args)),
+      this.errorPolicy
+    );
+  }
+  async error(args) {
+    await dispatchTerminalObservers(
+      this.observers,
+      "tool.error",
+      (observer) => observer.error?.(observerSnapshot(args)),
+      "ignore"
+    );
+  }
+};
+async function dispatchObservers(observers, phase, dispatch, errorPolicy) {
+  const failures = [];
+  for (const entry of observers) {
+    try {
+      await dispatch(entry.observer);
+    } catch (error) {
+      failures.push({ observer: entry.name, error });
+    }
+  }
+  throwObserverFailures(phase, failures, errorPolicy);
+}
+async function dispatchTerminalObservers(observers, phase, dispatch, errorPolicy) {
+  const failures = await terminateObservers(observers, dispatch);
+  throwObserverFailures(phase, failures, errorPolicy);
+}
+async function terminateObservers(observers, dispatch) {
+  const failures = [];
+  for (const entry of observers) {
+    if (entry.terminal) continue;
+    entry.terminal = true;
+    try {
+      await dispatch(entry.observer);
+    } catch (error) {
+      failures.push({ observer: entry.name, error });
+    }
+  }
+  return failures;
+}
+function throwObserverFailures(phase, failures, errorPolicy) {
+  if (errorPolicy === "throw" && failures.length > 0) {
+    throw new AgentObserverDispatchError(phase, failures);
+  }
+}
+
+export {
+  AgentObserverDispatchError,
+  startAgentRunObservers
+};
+//# sourceMappingURL=chunk-CWM7B2OO.js.map

package/dist/chunk-CWM7B2OO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/observability/snapshot.ts","../src/observability/group.ts"],"sourcesContent":["export function observerSnapshot<T>(value: T): T {\n  if (containsError(value, new WeakSet<object>())) {\n    return cloneObserverFallback(value, new WeakMap<object, object>());\n  }\n  try {\n    return globalThis.structuredClone(value);\n  } catch {\n    return cloneObserverFallback(value, new WeakMap<object, object>());\n  }\n}\n\nfunction cloneObserverFallback<T>(value: T, seen: WeakMap<object, object>): T {\n  if (typeof value !== \"object\" || value === null) {\n    return value;\n  }\n  const existing = seen.get(value);\n  if (existing !== undefined) {\n    return existing as T;\n  }\n  if (Array.isArray(value)) {\n    const clone: unknown[] = [];\n    seen.set(value, clone);\n    clone.push(...value.map((item) => cloneObserverFallback(item, seen)));\n    return clone as T;\n  }\n  if (value instanceof Date) {\n    return new Date(value.getTime()) as T;\n  }\n  if (value instanceof Error) {\n    const clone = Object.create(Object.getPrototypeOf(value)) as Error;\n    seen.set(value, clone);\n    Object.defineProperties(clone, {\n      name: { configurable: true, writable: true, value: value.name },\n      message: { configurable: true, writable: true, value: value.message },\n    });\n    if (value.stack !== undefined) {\n      Object.defineProperty(clone, \"stack\", {\n        configurable: true,\n        writable: true,\n        value: value.stack,\n      });\n    }\n    if (value.cause !== undefined) {\n      Object.defineProperty(clone, \"cause\", {\n        configurable: true,\n        writable: true,\n        value: cloneObserverFallback(value.cause, seen),\n      });\n    }\n    for (const key of Object.getOwnPropertyNames(value)) {\n      if (key === \"name\" || key === \"message\" || key === \"stack\" || key === \"cause\") continue;\n      const descriptor = Object.getOwnPropertyDescriptor(value, key);\n      if (descriptor === undefined) continue;\n      if (\"value\" in descriptor) {\n        descriptor.value = cloneObserverFallback(descriptor.value, seen);\n      }\n      Object.defineProperty(clone, key, descriptor);\n    }\n    return clone as T;\n  }\n  if (Object.getPrototypeOf(value) !== Object.prototype) {\n    return value;\n  }\n  const clone: Record<string, unknown> = {};\n  seen.set(value, clone);\n  for (const [key, item] of Object.entries(value)) {\n    clone[key] = cloneObserverFallback(item, seen);\n  }\n  return clone as T;\n}\n\nfunction containsError(value: unknown, seen: WeakSet<object>): boolean {\n  if (typeof value !== \"object\" || value === null) return false;\n  if (value instanceof Error) return true;\n  if (seen.has(value)) return false;\n  seen.add(value);\n  if (Array.isArray(value)) {\n    return value.some((item) => containsError(item, seen));\n  }\n  if (Object.getPrototypeOf(value) !== Object.prototype) return false;\n  return Object.values(value).some((item) => containsError(item, seen));\n}\n","import { Usage } from \"../completion\";\nimport { observerSnapshot } from \"./snapshot\";\nimport type {\n  AgentGenerationEndArgs,\n  AgentGenerationErrorArgs,\n  AgentGenerationObserver,\n  AgentGenerationStartArgs,\n  AgentGenerationUpdateArgs,\n  AgentObserverErrorPolicy,\n  AgentObserverMap,\n  AgentRunEndArgs,\n  AgentRunErrorArgs,\n  AgentRunEventArgs,\n  AgentRunObserver,\n  AgentRunStartArgs,\n  AgentToolEndArgs,\n  AgentToolErrorArgs,\n  AgentToolObserver,\n  AgentToolStartArgs,\n  AgentToolStreamEventArgs,\n  AgentTraceInfo,\n} from \"./types\";\n\nexport type AgentObserverFailure = {\n  readonly observer: string;\n  readonly error: unknown;\n};\n\nexport class AgentObserverDispatchError extends AggregateError {\n  readonly phase: string;\n  readonly failures: readonly AgentObserverFailure[];\n\n  constructor(phase: string, failures: readonly AgentObserverFailure[]) {\n    super(\n      failures.map((failure) => failure.error),\n      `Agent observer ${phase} failed for ${failures.map((failure) => failure.observer).join(\", \")}.`,\n    );\n    this.name = \"AgentObserverDispatchError\";\n    this.phase = phase;\n    this.failures = Object.freeze([...failures]);\n  }\n}\n\ntype NamedObserver<T> = {\n  readonly name: string;\n  readonly observer: T;\n};\n\ntype ActiveNamedObserver<T> = NamedObserver<T> & {\n  terminal: boolean;\n};\n\nexport async function startAgentRunObservers(\n  observers: AgentObserverMap,\n  args: AgentRunStartArgs,\n  options: {\n    readonly primaryTrace?: string | undefined;\n    readonly errorPolicy: AgentObserverErrorPolicy;\n  },\n): Promise<ActiveAgentRunObservers> {\n  const runObservers: ActiveNamedObserver<AgentRunObserver>[] = [];\n  const failures: AgentObserverFailure[] = [];\n  for (const [name, observer] of Object.entries(observers)) {\n    try {\n      const runObserver = await observer.startRun(observerSnapshot(args));\n      if (runObserver !== undefined) {\n        runObservers.push({ name, observer: runObserver, terminal: false });\n      }\n    } catch (error) {\n      failures.push({ observer: name, error });\n    }\n  }\n  if (options.errorPolicy === \"throw\" && failures.length > 0) {\n    const startupError = new AgentObserverDispatchError(\"startRun\", failures);\n    const cleanupFailures = await terminateObservers(runObservers, (observer) =>\n      observer.error?.(\n        observerSnapshot({\n          error: startupError,\n          usage: Usage.empty(),\n          messages: [...args.history, args.prompt],\n        }),\n      ),\n    );\n    throw new AgentObserverDispatchError(\"startRun\", [...failures, ...cleanupFailures]);\n  }\n  return new ActiveAgentRunObservers(runObservers, options);\n}\n\nexport class ActiveAgentRunObservers {\n  readonly trace: AgentTraceInfo | undefined;\n\n  constructor(\n    private readonly runObservers: readonly ActiveNamedObserver<AgentRunObserver>[],\n    private readonly options: {\n      readonly primaryTrace?: string | undefined;\n      readonly errorPolicy: AgentObserverErrorPolicy;\n    },\n  ) {\n    const primary =\n      options.primaryTrace === undefined\n        ? undefined\n        : runObservers.find((entry) => entry.name === options.primaryTrace);\n    this.trace =\n      primary?.observer.trace === undefined\n        ? undefined\n        : Object.freeze({ observer: primary.name, ...primary.observer.trace });\n  }\n\n  async startGeneration(args: AgentGenerationStartArgs): Promise<ActiveGenerationObservers> {\n    const generationObservers: ActiveNamedObserver<AgentGenerationObserver>[] = [];\n    const failures: AgentObserverFailure[] = [];\n    for (const entry of this.runObservers) {\n      if (entry.observer.startGeneration === undefined) continue;\n      try {\n        const observer = await entry.observer.startGeneration(observerSnapshot(args));\n        if (observer !== undefined) {\n          generationObservers.push({ name: entry.name, observer, terminal: false });\n        }\n      } catch (error) {\n        failures.push({ observer: entry.name, error });\n      }\n    }\n    if (this.options.errorPolicy === \"throw\" && failures.length > 0) {\n      const startupError = new AgentObserverDispatchError(\"startGeneration\", failures);\n      const cleanupFailures = await terminateObservers(generationObservers, (observer) =>\n        observer.error?.(observerSnapshot({ turn: args.turn, error: startupError })),\n      );\n      throw new AgentObserverDispatchError(\"startGeneration\", [...failures, ...cleanupFailures]);\n    }\n    return new ActiveGenerationObservers(generationObservers, this.options.errorPolicy);\n  }\n\n  async startTool(args: AgentToolStartArgs): Promise<ActiveToolObservers> {\n    const toolObservers: ActiveNamedObserver<AgentToolObserver>[] = [];\n    const failures: AgentObserverFailure[] = [];\n    for (const entry of this.runObservers) {\n      if (entry.observer.startTool === undefined) continue;\n      try {\n        const observer = await entry.observer.startTool(observerSnapshot(args));\n        if (observer !== undefined) {\n          toolObservers.push({ name: entry.name, observer, terminal: false });\n        }\n      } catch (error) {\n        failures.push({ observer: entry.name, error });\n      }\n    }\n    if (this.options.errorPolicy === \"throw\" && failures.length > 0) {\n      const startupError = new AgentObserverDispatchError(\"startTool\", failures);\n      const cleanupFailures = await terminateObservers(toolObservers, (observer) =>\n        observer.error?.(observerSnapshot({ ...args, error: startupError })),\n      );\n      throw new AgentObserverDispatchError(\"startTool\", [...failures, ...cleanupFailures]);\n    }\n    return new ActiveToolObservers(toolObservers, this.options.errorPolicy);\n  }\n\n  async end(args: AgentRunEndArgs): Promise<void> {\n    await dispatchTerminalObservers(\n      this.runObservers,\n      \"end\",\n      (observer) => observer.end(observerSnapshot(args)),\n      this.options.errorPolicy,\n    );\n  }\n\n  async error(args: AgentRunErrorArgs): Promise<void> {\n    await dispatchTerminalObservers(\n      this.runObservers,\n      \"error\",\n      (observer) => observer.error?.(observerSnapshot(args)),\n      \"ignore\",\n    );\n  }\n\n  async event(args: AgentRunEventArgs): Promise<void> {\n    await dispatchObservers(\n      this.runObservers,\n      \"event\",\n      (observer) => observer.event?.(observerSnapshot(args)),\n      this.options.errorPolicy,\n    );\n  }\n}\n\nexport class ActiveGenerationObservers {\n  constructor(\n    private readonly observers: readonly ActiveNamedObserver<AgentGenerationObserver>[],\n    private readonly errorPolicy: AgentObserverErrorPolicy,\n  ) {}\n\n  async end(args: AgentGenerationEndArgs): Promise<void> {\n    await dispatchTerminalObservers(\n      this.observers,\n      \"generation.end\",\n      (observer) => observer.end(observerSnapshot(args)),\n      this.errorPolicy,\n    );\n  }\n\n  async error(args: AgentGenerationErrorArgs): Promise<void> {\n    await dispatchTerminalObservers(\n      this.observers,\n      \"generation.error\",\n      (observer) => observer.error?.(observerSnapshot(args)),\n      \"ignore\",\n    );\n  }\n\n  async update(args: AgentGenerationUpdateArgs): Promise<void> {\n    await dispatchObservers(\n      this.observers,\n      \"generation.update\",\n      (observer) => observer.update?.(observerSnapshot(args)),\n      this.errorPolicy,\n    );\n  }\n}\n\nexport class ActiveToolObservers {\n  constructor(\n    private readonly observers: readonly ActiveNamedObserver<AgentToolObserver>[],\n    private readonly errorPolicy: AgentObserverErrorPolicy,\n  ) {}\n\n  async streamEvent(args: AgentToolStreamEventArgs): Promise<void> {\n    await dispatchObservers(\n      this.observers,\n      \"tool.streamEvent\",\n      (observer) => observer.streamEvent?.(observerSnapshot(args)),\n      this.errorPolicy,\n    );\n  }\n\n  async end(args: AgentToolEndArgs): Promise<void> {\n    await dispatchTerminalObservers(\n      this.observers,\n      \"tool.end\",\n      (observer) => observer.end(observerSnapshot(args)),\n      this.errorPolicy,\n    );\n  }\n\n  async error(args: AgentToolErrorArgs): Promise<void> {\n    await dispatchTerminalObservers(\n      this.observers,\n      \"tool.error\",\n      (observer) => observer.error?.(observerSnapshot(args)),\n      \"ignore\",\n    );\n  }\n}\n\nasync function dispatchObservers<T>(\n  observers: readonly NamedObserver<T>[],\n  phase: string,\n  dispatch: (observer: T) => void | Promise<void> | undefined,\n  errorPolicy: AgentObserverErrorPolicy,\n): Promise<void> {\n  const failures: AgentObserverFailure[] = [];\n  for (const entry of observers) {\n    try {\n      await dispatch(entry.observer);\n    } catch (error) {\n      failures.push({ observer: entry.name, error });\n    }\n  }\n  throwObserverFailures(phase, failures, errorPolicy);\n}\n\nasync function dispatchTerminalObservers<T>(\n  observers: readonly ActiveNamedObserver<T>[],\n  phase: string,\n  dispatch: (observer: T) => void | Promise<void> | undefined,\n  errorPolicy: AgentObserverErrorPolicy,\n): Promise<void> {\n  const failures = await terminateObservers(observers, dispatch);\n  throwObserverFailures(phase, failures, errorPolicy);\n}\n\nasync function terminateObservers<T>(\n  observers: readonly ActiveNamedObserver<T>[],\n  dispatch: (observer: T) => void | Promise<void> | undefined,\n): Promise<AgentObserverFailure[]> {\n  const failures: AgentObserverFailure[] = [];\n  for (const entry of observers) {\n    if (entry.terminal) continue;\n    entry.terminal = true;\n    try {\n      await dispatch(entry.observer);\n    } catch (error) {\n      failures.push({ observer: entry.name, error });\n    }\n  }\n  return failures;\n}\n\nfunction throwObserverFailures(\n  phase: string,\n  failures: readonly AgentObserverFailure[],\n  errorPolicy: AgentObserverErrorPolicy,\n): void {\n  if (errorPolicy === \"throw\" && failures.length > 0) {\n    throw new AgentObserverDispatchError(phase, failures);\n  }\n}\n"],"mappings":"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","names":["clone"]}

package/dist/{chunk-6WGGTJE6.js → chunk-D37WMSP6.js}

@@ -1,28 +1,17 @@
 import {
   InMemoryVectorStore,
-  createTool
-} from "./chunk-R2LJSQUW.js";
+  assertFiniteMinScore,
+  assertPositiveSearchLimit,
+  createTool,
+  retrieveDocuments
+} from "./chunk-77AIYARB.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;
-}
+} from "./chunk-FMHLROPQ.js";
 
 // src/tool/dynamic-tools.ts
-async function embedTools(model, tools, options = {}) {
-  const toolList = dedupeTools(tools);
+async function embedTools(options) {
+  const toolList = dedupeTools(options.tools);
   const definitions = await Promise.all(
     toolList.map(async (tool) => ({ tool, definition: await tool.definition("") }))
   );
@@ -33,73 +22,78 @@ async function embedTools(model, tools, options = {}) {
     const document = {
       toolName: tool.name,
       definition,
-      text: texts.join("\n")
+      text: texts.join("\n"),
+      ...metadata === void 0 ? {} : { metadata }
     };
-    if (metadata !== void 0) {
-      document.metadata = metadata;
-    }
     return { tool, document, texts, metadata };
   });
-  return embedDocuments(model, documents, {
+  const embedded = await embedDocuments({
+    model: options.model,
+    documents,
     id: (item) => item.tool.name,
     content: (item) => item.texts,
     metadata: (item) => item.metadata,
-    concurrency: options.concurrency
-  }).then(
-    (embedded) => embedded.map((item) => ({
+    concurrency: options.concurrency,
+    retries: options.retries,
+    abortSignal: options.abortSignal
+  });
+  return {
+    documents: embedded.documents.map((item) => ({
       ...item,
       document: item.document.document
     }))
-  );
+  };
 }
-async function createToolIndex(model, tools, options) {
+async function createToolIndex(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);
+  assertFiniteMinScore(options.minScore);
+  const tools = dedupeTools(options.tools);
+  const { documents } = await embedTools({ ...options, tools });
+  const store = InMemoryVectorStore.fromDocuments({ documents });
+  return new ToolSearchIndex(store, options.model, tools, options);
 }
 function isToolIndex(value) {
-  if (typeof value !== "object" || value === null) {
-    return false;
-  }
+  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";
+  return candidate.kind === "tool-index" && Array.isArray(candidate.tools) && typeof candidate.topK === "number" && typeof candidate.search === "function";
 }
 var ToolSearchIndex = class {
-  constructor(index, tools, options) {
-    this.index = index;
+  constructor(store, model, tools, options) {
+    this.store = store;
+    this.model = model;
+    this.options = options;
     this.tools = Object.freeze([...tools]);
     this.topK = options.topK;
-    this.threshold = options.threshold;
+    this.minScore = options.minScore;
     this.filter = options.filter;
-    if (index.inspect !== void 0) {
-      this.inspect = (request) => index.inspect?.(request);
-    }
   }
-  index;
+  store;
+  model;
+  options;
   kind = "tool-index";
   tools;
   topK;
-  threshold;
+  minScore;
   filter;
-  inspect;
-  search(request) {
-    return this.index.search(request);
+  search(options) {
+    return retrieveDocuments({
+      store: this.store,
+      model: this.model,
+      query: options.query,
+      topK: this.topK,
+      minScore: this.minScore,
+      filter: this.filter,
+      retries: this.options.retries,
+      abortSignal: options.abortSignal
+    });
   }
-  searchIds(request) {
-    return this.index.searchIds(request);
-  }
-  asTool(options) {
-    return this.index.asTool(options);
+  inspect(request) {
+    return this.store.inspect(request);
   }
 };
 function dedupeTools(tools) {
   const byName = /* @__PURE__ */ new Map();
-  for (const tool of tools) {
-    byName.set(tool.name, tool);
-  }
+  for (const tool of tools) byName.set(tool.name, tool);
   return [...byName.values()];
 }
 function defaultToolEmbeddingText(definition) {
@@ -128,12 +122,10 @@ function createThinkTool(options = {}) {
 }
 
 export {
-  assertPositiveSearchLimit,
-  assertFiniteSearchThreshold,
   embedTools,
   createToolIndex,
   isToolIndex,
   createMiddleware,
   createThinkTool
 };
-//# sourceMappingURL=chunk-6WGGTJE6.js.map
+//# sourceMappingURL=chunk-D37WMSP6.js.map

package/dist/chunk-D37WMSP6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tool/dynamic-tools.ts","../src/tool/middleware.ts","../src/tool/think-tool.ts"],"sourcesContent":["import type { ToolDefinition } from \"../completion\";\nimport type { EmbeddedDocument, EmbeddingModel, VectorMetadata } from \"../embeddings\";\nimport { embedDocuments } from \"../embeddings\";\nimport { assertFiniteMinScore, assertPositiveSearchLimit } from \"../internal/vector-search-options\";\nimport type { RetrySetting } from \"../retry\";\nimport {\n  InMemoryVectorStore,\n  retrieveDocuments,\n  type VectorFilter,\n  type VectorInspectPage,\n  type VectorInspectRequest,\n  type VectorSearchResult,\n} from \"../vector-store\";\nimport type { AnyTool } 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  model: EmbeddingModel;\n  tools: readonly AnyTool[];\n  content?: ((tool: AnyTool, definition: ToolDefinition) => string | string[]) | undefined;\n  metadata?: ((tool: AnyTool, definition: ToolDefinition) => Metadata | undefined) | undefined;\n  concurrency?: number | undefined;\n  retries?: RetrySetting | undefined;\n  abortSignal?: AbortSignal | undefined;\n};\n\nexport type CreateToolIndexOptions<Metadata extends VectorMetadata = VectorMetadata> =\n  EmbedToolsOptions<Metadata> & {\n    topK: number;\n    minScore?: number | undefined;\n    filter?: VectorFilter | undefined;\n  };\n\nexport interface ToolIndex<Metadata extends VectorMetadata = VectorMetadata> {\n  readonly kind: \"tool-index\";\n  readonly tools: readonly AnyTool[];\n  readonly topK: number;\n  readonly minScore?: number | undefined;\n  readonly filter?: VectorFilter | undefined;\n  search(options: {\n    query: string;\n    abortSignal?: AbortSignal | undefined;\n  }): Promise<Array<VectorSearchResult<ToolSearchDocument<Metadata>, Metadata>>>;\n  inspect?(\n    request: VectorInspectRequest,\n  ): Promise<VectorInspectPage<ToolSearchDocument<Metadata>, Metadata>>;\n}\n\nexport async function embedTools<Metadata extends VectorMetadata = VectorMetadata>(\n  options: EmbedToolsOptions<Metadata>,\n): Promise<{\n  documents: Array<EmbeddedDocument<ToolSearchDocument<Metadata>, Metadata>>;\n}> {\n  const toolList = dedupeTools(options.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      ...(metadata === undefined ? {} : { metadata }),\n    };\n    return { tool, document, texts, metadata };\n  });\n\n  const embedded = await embedDocuments({\n    model: options.model,\n    documents,\n    id: (item) => item.tool.name,\n    content: (item) => item.texts,\n    metadata: (item) => item.metadata,\n    concurrency: options.concurrency,\n    retries: options.retries,\n    abortSignal: options.abortSignal,\n  });\n  return {\n    documents: embedded.documents.map((item) => ({\n      ...item,\n      document: item.document.document,\n    })),\n  };\n}\n\nexport async function createToolIndex<Metadata extends VectorMetadata = VectorMetadata>(\n  options: CreateToolIndexOptions<Metadata>,\n): Promise<ToolIndex<Metadata>> {\n  assertPositiveSearchLimit(options.topK);\n  assertFiniteMinScore(options.minScore);\n  const tools = dedupeTools(options.tools);\n  const { documents } = await embedTools({ ...options, tools });\n  const store = InMemoryVectorStore.fromDocuments({ documents });\n  return new ToolSearchIndex(store, options.model, tools, options);\n}\n\nexport function isToolIndex(value: unknown): value is ToolIndex {\n  if (typeof value !== \"object\" || value === null) return false;\n  const candidate = value as {\n    kind?: unknown;\n    tools?: unknown;\n    topK?: unknown;\n    search?: 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  );\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 minScore: number | undefined;\n  readonly filter: VectorFilter | undefined;\n\n  constructor(\n    private readonly store: InMemoryVectorStore<ToolSearchDocument<Metadata>, Metadata>,\n    private readonly model: EmbeddingModel,\n    tools: readonly AnyTool[],\n    private readonly options: CreateToolIndexOptions<Metadata>,\n  ) {\n    this.tools = Object.freeze([...tools]);\n    this.topK = options.topK;\n    this.minScore = options.minScore;\n    this.filter = options.filter;\n  }\n\n  search(options: {\n    query: string;\n    abortSignal?: AbortSignal | undefined;\n  }): Promise<Array<VectorSearchResult<ToolSearchDocument<Metadata>, Metadata>>> {\n    return retrieveDocuments({\n      store: this.store,\n      model: this.model,\n      query: options.query,\n      topK: this.topK,\n      minScore: this.minScore,\n      filter: this.filter,\n      retries: this.options.retries,\n      abortSignal: options.abortSignal,\n    });\n  }\n\n  inspect(\n    request: VectorInspectRequest,\n  ): Promise<VectorInspectPage<ToolSearchDocument<Metadata>, Metadata>> {\n    return this.store.inspect(request);\n  }\n}\n\nfunction dedupeTools(tools: readonly AnyTool[]): AnyTool[] {\n  const byName = new Map<string, AnyTool>();\n  for (const tool of tools) byName.set(tool.name, tool);\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  ToolResultContentPart,\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?: readonly ToolResultContentPart[] | undefined;\n  originalStructuredResult?: readonly ToolResultContentPart[] | 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?: readonly ToolResultContentPart[] | 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":"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","names":[]}