@nhtio/adk 0.1.0-master-e068b986 → 0.1.0-master-0c6d984f

package/batteries/tools/_shared.cjs

@@ -0,0 +1,157 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../../chunk-Ble4zEEl.js");
+const require_tool_registry = require("../../tool_registry-CKJPze3j.js");
+const require_spooled_artifact = require("../../spooled_artifact-DX8LLyUX.js");
+require("../../guards.cjs");
+require("../../spooled_artifact.cjs");
+//#region src/batteries/tools/_shared/index.ts
+/**
+* Resolve the configured headers (a static object or a sync/async resolver) for a single request.
+*
+* @param headers - The static header record, the resolver, or `undefined`.
+* @returns A fresh, owned copy of the resolved headers (`{}` when none supplied).
+*/
+var resolveHeaders = async (headers) => {
+	if (typeof headers === "function") return { ...await headers() };
+	return { ...headers ?? {} };
+};
+/** Unwrap a resolved value that may be a module namespace whose `default` is the constructor. */
+var unwrapDefault = (value) => {
+	if (require_tool_registry.isObject(value) && "default" in value) {
+		const def = value.default;
+		if (require_spooled_artifact.SpooledArtifact.isSpooledArtifactConstructor(def)) return def;
+	}
+	return value;
+};
+/**
+* Resolve an {@link ArtifactResolver} to the **sync** `() => SpooledArtifactCtor` that
+* `Tool.artifactConstructor` requires (the wrap-site and the construction-time validator both
+* invoke it synchronously, so an async resolver cannot be passed straight through).
+*
+* @remarks
+* A bare constructor is itself a function, so it is distinguished from a resolver via
+* `SpooledArtifact.isSpooledArtifactConstructor` (the same duck-typed guard the core validator
+* uses) rather than by arity. Async because a dynamic-import resolver must be awaited here.
+*
+* @param resolver - The artifact configuration. When `undefined`, callers should fall back to
+*   their own default (this function rejects `undefined` so the default lives with the caller).
+* @param onInvalid - Throws a battery-scoped error; receives a human-readable reason.
+* @returns A sync `() => SpooledArtifactCtor` suitable for `Tool.artifactConstructor`.
+*/
+var resolveArtifact = async (resolver, onInvalid) => {
+	if (require_spooled_artifact.SpooledArtifact.isSpooledArtifactConstructor(resolver)) {
+		const ctor = resolver;
+		return () => ctor;
+	}
+	if (typeof resolver !== "function") onInvalid("artifact must be a SpooledArtifact constructor or a resolver returning one");
+	let resolved;
+	try {
+		resolved = await resolver();
+	} catch (err) {
+		onInvalid(`artifact resolver threw: ${require_tool_registry.isError(err) ? err.message : String(err)}`);
+	}
+	resolved = unwrapDefault(resolved);
+	if (!require_spooled_artifact.SpooledArtifact.isSpooledArtifactConstructor(resolved)) onInvalid("artifact resolver did not resolve to a SpooledArtifact constructor");
+	const ctor = resolved;
+	return () => ctor;
+};
+/**
+* Synchronous {@link resolveArtifact}: accepts only the {@link SyncArtifactResolver} subset and
+* throws (via `onInvalid`) on an async resolver — a runtime guard for JS callers who bypass the
+* compile-time narrowing.
+*
+* @param resolver - A constructor or a sync resolver.
+* @param onInvalid - Throws a battery-scoped error; receives a human-readable reason.
+* @returns A sync `() => SpooledArtifactCtor` suitable for `Tool.artifactConstructor`.
+*/
+var resolveArtifactSync = (resolver, onInvalid) => {
+	if (require_spooled_artifact.SpooledArtifact.isSpooledArtifactConstructor(resolver)) {
+		const ctor = resolver;
+		return () => ctor;
+	}
+	if (typeof resolver !== "function") onInvalid("artifact must be a SpooledArtifact constructor or a resolver returning one");
+	let resolved;
+	try {
+		resolved = resolver();
+	} catch (err) {
+		onInvalid(`artifact resolver threw: ${require_tool_registry.isError(err) ? err.message : String(err)}`);
+	}
+	if (require_tool_registry.isInstanceOf(resolved, "Promise", Promise)) onInvalid("artifact resolver is async; use the async factory variant for dynamic-import resolvers");
+	resolved = unwrapDefault(resolved);
+	if (!require_spooled_artifact.SpooledArtifact.isSpooledArtifactConstructor(resolved)) onInvalid("artifact resolver did not resolve to a SpooledArtifact constructor");
+	const ctor = resolved;
+	return () => ctor;
+};
+/** Internal sentinel a short-circuiting input stage throws to unwind the pipeline immediately. */
+var SHORT_CIRCUIT = Symbol("adk.tools.shortCircuit");
+/** `true` when `value` is the short-circuit sentinel produced by {@link makeShortCircuit}. */
+var isShortCircuit = (value) => require_tool_registry.isObject(value) && value[SHORT_CIRCUIT] === true;
+/**
+* Build a `shortCircuit(result)` function for an input-pipeline context. Calling it throws the
+* internal sentinel, which {@link runInputPipeline} catches and converts into the verbatim result
+* (skipping the HTTP request entirely — e.g. a cache hit).
+*
+* @returns A function that, when called with a result string, throws the short-circuit sentinel.
+*/
+var makeShortCircuit = () => {
+	return (result) => {
+		throw {
+			[SHORT_CIRCUIT]: true,
+			result
+		};
+	};
+};
+/**
+* Run an input pipeline over `ctx`. Returns the short-circuit string when a stage short-circuited,
+* or `undefined` when the pipeline reached its terminal handler. A non-terminal pipeline (a stage
+* that neither called `next()` nor short-circuited) throws — the caller converts it to an
+* `Error:` string.
+*
+* @param mw - The `Middleware` instance holding the stages (a fresh `.runner()` is minted here).
+* @param ctx - The mutable input context handed to each stage.
+* @param label - Battery name, used in the non-terminal error message.
+* @returns The short-circuit result string, or `undefined` if the pipeline ran to completion.
+*/
+var runInputPipeline = async (mw, ctx, label) => {
+	let reached = false;
+	let caught;
+	await mw.runner().errorHandler(async (error) => {
+		caught = error;
+	}).finalHandler(async () => {
+		reached = true;
+	}).run((fn, next) => Promise.resolve(fn(ctx, next)));
+	if (caught !== void 0) {
+		if (isShortCircuit(caught)) return caught.result;
+		throw caught;
+	}
+	if (!reached) throw new Error(`${label} input pipeline did not call next() and did not short-circuit.`);
+};
+/**
+* Run an output pipeline over `ctx`; rethrow any stage error to the caller's try/catch. A
+* non-terminal pipeline (no `next()`) throws.
+*
+* @param mw - The `Middleware` instance holding the stages (a fresh `.runner()` is minted here).
+* @param ctx - The mutable output context handed to each stage.
+* @param label - Battery name, used in the non-terminal error message.
+*/
+var runOutputPipeline = async (mw, ctx, label) => {
+	let reached = false;
+	let caught;
+	await mw.runner().errorHandler(async (error) => {
+		caught = error;
+	}).finalHandler(async () => {
+		reached = true;
+	}).run((fn, next) => Promise.resolve(fn(ctx, next)));
+	if (caught !== void 0) throw caught;
+	if (!reached) throw new Error(`${label} output pipeline did not call next().`);
+};
+//#endregion
+exports.isShortCircuit = isShortCircuit;
+exports.makeShortCircuit = makeShortCircuit;
+exports.resolveArtifact = resolveArtifact;
+exports.resolveArtifactSync = resolveArtifactSync;
+exports.resolveHeaders = resolveHeaders;
+exports.runInputPipeline = runInputPipeline;
+exports.runOutputPipeline = runOutputPipeline;
+
+//# sourceMappingURL=_shared.cjs.map

package/batteries/tools/_shared.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"_shared.cjs","names":[],"sources":["../../../src/batteries/tools/_shared/index.ts"],"sourcesContent":["/**\n * Cross-battery helpers shared by the configured HTTP tool batteries (SearXNG, Scrapper, …).\n *\n * @module @nhtio/adk/batteries/tools/_shared\n *\n * @remarks\n * These are internal building blocks for the *factory-style* tool batteries — the ones that talk\n * to a configured HTTP instance behind custom auth and expose input/output middleware pipelines.\n * Rather than each battery carry its own copy, the common machinery lives here:\n *\n * - {@link resolveArtifact} / {@link resolveArtifactSync} — turn an {@link ArtifactResolver}\n *   (a constructor, a sync resolver, or an async / dynamic-import resolver) into the **sync**\n *   `() => SpooledArtifactConstructor` that `Tool.artifactConstructor` requires. Mirrors the vector\n *   battery's `resolveClientCtor`.\n * - {@link resolveHeaders} — collapse a static header object or a (sync/async) resolver into a\n *   plain header record for one request (refreshable-auth friendly).\n * - {@link runInputPipeline} / {@link runOutputPipeline} — the onion middleware runners (fresh\n *   runner per call, short-circuit + non-terminal detection), generic over the context type.\n *\n * This module imports harness primitives only through their specific subpath barrels\n * (`@nhtio/adk/spooled_artifact`, `@nhtio/adk/forge`, `@nhtio/adk/guards`) per the batteries\n * barrel-only rule.\n */\n\nimport { Middleware } from '@nhtio/middleware'\nimport { SpooledArtifact } from '@nhtio/adk/spooled_artifact'\nimport { isError, isObject, isInstanceOf } from '@nhtio/adk/guards'\nimport type { NextFn } from '@nhtio/middleware'\nimport type { SpooledArtifactConstructor } from '@nhtio/adk/forge'\n\n// ── Header resolution ────────────────────────────────────────────────────────\n\n/** A static set of request headers (used for custom instance authentication). */\nexport type ToolHeaders = Record<string, string>\n\n/**\n * A resolver returning request headers, sync or async. Use this form when the auth token is\n * refreshable — the resolver runs on every request, so a fresh token can be minted per call.\n */\nexport type ToolHeadersResolver = () => ToolHeaders | Promise<ToolHeaders>\n\n/**\n * Resolve the configured headers (a static object or a sync/async resolver) for a single request.\n *\n * @param headers - The static header record, the resolver, or `undefined`.\n * @returns A fresh, owned copy of the resolved headers (`{}` when none supplied).\n */\nexport const resolveHeaders = async (\n  headers: ToolHeaders | ToolHeadersResolver | undefined\n): Promise<ToolHeaders> => {\n  if (typeof headers === 'function') return { ...(await headers()) }\n  return { ...(headers ?? {}) }\n}\n\n// ── Artifact resolver ────────────────────────────────────────────────────────\n\n/** Convenience alias for the spooled-artifact constructor a tool wraps its output in. */\nexport type SpooledArtifactCtor = SpooledArtifactConstructor\n\n/**\n * The artifact configuration accepted by a factory: a constructor, a sync resolver, or an async /\n * dynamic-import resolver (which may yield a module namespace whose `default` is the constructor).\n *\n * @remarks\n * Mirrors the vector battery's `client` resolver and `Tool.artifactConstructor`'s indirection. The\n * async form lets a consumer `() => import('@nhtio/adk/spooled_artifact').then(m => m.SpooledMarkdownArtifact)`\n * so the artifact class never enters their static module graph.\n */\nexport type ArtifactResolver =\n  | SpooledArtifactCtor\n  | (() => SpooledArtifactCtor | { default: SpooledArtifactCtor })\n  | (() => Promise<SpooledArtifactCtor | { default: SpooledArtifactCtor }>)\n\n/** The sync subset of {@link ArtifactResolver} — a constructor or a sync resolver (no Promise). */\nexport type SyncArtifactResolver =\n  | SpooledArtifactCtor\n  | (() => SpooledArtifactCtor | { default: SpooledArtifactCtor })\n\n/** Unwrap a resolved value that may be a module namespace whose `default` is the constructor. */\nconst unwrapDefault = (value: unknown): unknown => {\n  if (isObject(value) && 'default' in value) {\n    const def = (value as { default?: unknown }).default\n    if (SpooledArtifact.isSpooledArtifactConstructor(def)) return def\n  }\n  return value\n}\n\n/**\n * Resolve an {@link ArtifactResolver} to the **sync** `() => SpooledArtifactCtor` that\n * `Tool.artifactConstructor` requires (the wrap-site and the construction-time validator both\n * invoke it synchronously, so an async resolver cannot be passed straight through).\n *\n * @remarks\n * A bare constructor is itself a function, so it is distinguished from a resolver via\n * `SpooledArtifact.isSpooledArtifactConstructor` (the same duck-typed guard the core validator\n * uses) rather than by arity. Async because a dynamic-import resolver must be awaited here.\n *\n * @param resolver - The artifact configuration. When `undefined`, callers should fall back to\n *   their own default (this function rejects `undefined` so the default lives with the caller).\n * @param onInvalid - Throws a battery-scoped error; receives a human-readable reason.\n * @returns A sync `() => SpooledArtifactCtor` suitable for `Tool.artifactConstructor`.\n */\nexport const resolveArtifact = async (\n  resolver: ArtifactResolver,\n  onInvalid: (reason: string) => never\n): Promise<() => SpooledArtifactCtor> => {\n  // A constructor: hand back a thunk that returns it.\n  if (SpooledArtifact.isSpooledArtifactConstructor(resolver)) {\n    const ctor = resolver\n    return () => ctor\n  }\n  // Otherwise it must be a resolver function.\n  if (typeof resolver !== 'function') {\n    onInvalid('artifact must be a SpooledArtifact constructor or a resolver returning one')\n  }\n  let resolved: unknown\n  try {\n    resolved = await (resolver as () => unknown)()\n  } catch (err) {\n    onInvalid(`artifact resolver threw: ${isError(err) ? err.message : String(err)}`)\n  }\n  resolved = unwrapDefault(resolved)\n  if (!SpooledArtifact.isSpooledArtifactConstructor(resolved)) {\n    onInvalid('artifact resolver did not resolve to a SpooledArtifact constructor')\n  }\n  const ctor = resolved as SpooledArtifactCtor\n  return () => ctor\n}\n\n/**\n * Synchronous {@link resolveArtifact}: accepts only the {@link SyncArtifactResolver} subset and\n * throws (via `onInvalid`) on an async resolver — a runtime guard for JS callers who bypass the\n * compile-time narrowing.\n *\n * @param resolver - A constructor or a sync resolver.\n * @param onInvalid - Throws a battery-scoped error; receives a human-readable reason.\n * @returns A sync `() => SpooledArtifactCtor` suitable for `Tool.artifactConstructor`.\n */\nexport const resolveArtifactSync = (\n  resolver: SyncArtifactResolver,\n  onInvalid: (reason: string) => never\n): (() => SpooledArtifactCtor) => {\n  if (SpooledArtifact.isSpooledArtifactConstructor(resolver)) {\n    const ctor = resolver\n    return () => ctor\n  }\n  if (typeof resolver !== 'function') {\n    onInvalid('artifact must be a SpooledArtifact constructor or a resolver returning one')\n  }\n  let resolved: unknown\n  try {\n    resolved = (resolver as () => unknown)()\n  } catch (err) {\n    onInvalid(`artifact resolver threw: ${isError(err) ? err.message : String(err)}`)\n  }\n  if (isInstanceOf(resolved, 'Promise', Promise)) {\n    onInvalid(\n      'artifact resolver is async; use the async factory variant for dynamic-import resolvers'\n    )\n  }\n  resolved = unwrapDefault(resolved)\n  if (!SpooledArtifact.isSpooledArtifactConstructor(resolved)) {\n    onInvalid('artifact resolver did not resolve to a SpooledArtifact constructor')\n  }\n  const ctor = resolved as SpooledArtifactCtor\n  return () => ctor\n}\n\n// ── Middleware pipeline runners ──────────────────────────────────────────────\n\n/** Internal sentinel a short-circuiting input stage throws to unwind the pipeline immediately. */\nconst SHORT_CIRCUIT = Symbol('adk.tools.shortCircuit')\n\ninterface ShortCircuitSignal {\n  [SHORT_CIRCUIT]: true\n  result: string\n}\n\n/** `true` when `value` is the short-circuit sentinel produced by {@link makeShortCircuit}. */\nexport const isShortCircuit = (value: unknown): value is { result: string } =>\n  isObject(value) && (value as Record<symbol, unknown>)[SHORT_CIRCUIT] === true\n\n/**\n * Build a `shortCircuit(result)` function for an input-pipeline context. Calling it throws the\n * internal sentinel, which {@link runInputPipeline} catches and converts into the verbatim result\n * (skipping the HTTP request entirely — e.g. a cache hit).\n *\n * @returns A function that, when called with a result string, throws the short-circuit sentinel.\n */\nexport const makeShortCircuit = (): ((result: string) => never) => {\n  return (result: string): never => {\n    const signal: ShortCircuitSignal = { [SHORT_CIRCUIT]: true, result }\n    throw signal\n  }\n}\n\n/** A generic onion middleware stage over a mutable context `C`. */\nexport type MiddlewareFn<C> = (ctx: C, next: NextFn) => void | Promise<void>\n\n/**\n * Run an input pipeline over `ctx`. Returns the short-circuit string when a stage short-circuited,\n * or `undefined` when the pipeline reached its terminal handler. A non-terminal pipeline (a stage\n * that neither called `next()` nor short-circuited) throws — the caller converts it to an\n * `Error:` string.\n *\n * @param mw - The `Middleware` instance holding the stages (a fresh `.runner()` is minted here).\n * @param ctx - The mutable input context handed to each stage.\n * @param label - Battery name, used in the non-terminal error message.\n * @returns The short-circuit result string, or `undefined` if the pipeline ran to completion.\n */\nexport const runInputPipeline = async <C>(\n  mw: Middleware<MiddlewareFn<C>>,\n  ctx: C,\n  label: string\n): Promise<string | undefined> => {\n  let reached = false\n  let caught: unknown\n  await mw\n    .runner()\n    .errorHandler(async (error: unknown) => {\n      caught = error\n    })\n    .finalHandler(async () => {\n      reached = true\n    })\n    .run((fn, next) => Promise.resolve(fn(ctx, next)))\n\n  if (caught !== undefined) {\n    if (isShortCircuit(caught)) return caught.result\n    throw caught\n  }\n  if (!reached) {\n    throw new Error(`${label} input pipeline did not call next() and did not short-circuit.`)\n  }\n  return undefined\n}\n\n/**\n * Run an output pipeline over `ctx`; rethrow any stage error to the caller's try/catch. A\n * non-terminal pipeline (no `next()`) throws.\n *\n * @param mw - The `Middleware` instance holding the stages (a fresh `.runner()` is minted here).\n * @param ctx - The mutable output context handed to each stage.\n * @param label - Battery name, used in the non-terminal error message.\n */\nexport const runOutputPipeline = async <C>(\n  mw: Middleware<MiddlewareFn<C>>,\n  ctx: C,\n  label: string\n): Promise<void> => {\n  let reached = false\n  let caught: unknown\n  await mw\n    .runner()\n    .errorHandler(async (error: unknown) => {\n      caught = error\n    })\n    .finalHandler(async () => {\n      reached = true\n    })\n    .run((fn, next) => Promise.resolve(fn(ctx, next)))\n\n  if (caught !== undefined) throw caught\n  if (!reached) throw new Error(`${label} output pipeline did not call next().`)\n}\n"],"mappings":";;;;;;;;;;;;;AA+CA,IAAa,iBAAiB,OAC5B,YACyB;CACzB,IAAI,OAAO,YAAY,YAAY,OAAO,EAAE,GAAI,MAAM,QAAQ,EAAG;CACjE,OAAO,EAAE,GAAI,WAAW,CAAC,EAAG;AAC9B;;AA2BA,IAAM,iBAAiB,UAA4B;CACjD,IAAI,sBAAA,SAAS,KAAK,KAAK,aAAa,OAAO;EACzC,MAAM,MAAO,MAAgC;EAC7C,IAAI,yBAAA,gBAAgB,6BAA6B,GAAG,GAAG,OAAO;CAChE;CACA,OAAO;AACT;;;;;;;;;;;;;;;;AAiBA,IAAa,kBAAkB,OAC7B,UACA,cACuC;CAEvC,IAAI,yBAAA,gBAAgB,6BAA6B,QAAQ,GAAG;EAC1D,MAAM,OAAO;EACb,aAAa;CACf;CAEA,IAAI,OAAO,aAAa,YACtB,UAAU,4EAA4E;CAExF,IAAI;CACJ,IAAI;EACF,WAAW,MAAO,SAA2B;CAC/C,SAAS,KAAK;EACZ,UAAU,4BAA4B,sBAAA,QAAQ,GAAG,IAAI,IAAI,UAAU,OAAO,GAAG,GAAG;CAClF;CACA,WAAW,cAAc,QAAQ;CACjC,IAAI,CAAC,yBAAA,gBAAgB,6BAA6B,QAAQ,GACxD,UAAU,oEAAoE;CAEhF,MAAM,OAAO;CACb,aAAa;AACf;;;;;;;;;;AAWA,IAAa,uBACX,UACA,cACgC;CAChC,IAAI,yBAAA,gBAAgB,6BAA6B,QAAQ,GAAG;EAC1D,MAAM,OAAO;EACb,aAAa;CACf;CACA,IAAI,OAAO,aAAa,YACtB,UAAU,4EAA4E;CAExF,IAAI;CACJ,IAAI;EACF,WAAY,SAA2B;CACzC,SAAS,KAAK;EACZ,UAAU,4BAA4B,sBAAA,QAAQ,GAAG,IAAI,IAAI,UAAU,OAAO,GAAG,GAAG;CAClF;CACA,IAAI,sBAAA,aAAa,UAAU,WAAW,OAAO,GAC3C,UACE,wFACF;CAEF,WAAW,cAAc,QAAQ;CACjC,IAAI,CAAC,yBAAA,gBAAgB,6BAA6B,QAAQ,GACxD,UAAU,oEAAoE;CAEhF,MAAM,OAAO;CACb,aAAa;AACf;;AAKA,IAAM,gBAAgB,OAAO,wBAAwB;;AAQrD,IAAa,kBAAkB,UAC7B,sBAAA,SAAS,KAAK,KAAM,MAAkC,mBAAmB;;;;;;;;AAS3E,IAAa,yBAAsD;CACjE,QAAQ,WAA0B;EAEhC,MAAM;IADgC,gBAAgB;GAAM;EACtD;CACR;AACF;;;;;;;;;;;;AAgBA,IAAa,mBAAmB,OAC9B,IACA,KACA,UACgC;CAChC,IAAI,UAAU;CACd,IAAI;CACJ,MAAM,GACH,OAAO,EACP,aAAa,OAAO,UAAmB;EACtC,SAAS;CACX,CAAC,EACA,aAAa,YAAY;EACxB,UAAU;CACZ,CAAC,EACA,KAAK,IAAI,SAAS,QAAQ,QAAQ,GAAG,KAAK,IAAI,CAAC,CAAC;CAEnD,IAAI,WAAW,KAAA,GAAW;EACxB,IAAI,eAAe,MAAM,GAAG,OAAO,OAAO;EAC1C,MAAM;CACR;CACA,IAAI,CAAC,SACH,MAAM,IAAI,MAAM,GAAG,MAAM,+DAA+D;AAG5F;;;;;;;;;AAUA,IAAa,oBAAoB,OAC/B,IACA,KACA,UACkB;CAClB,IAAI,UAAU;CACd,IAAI;CACJ,MAAM,GACH,OAAO,EACP,aAAa,OAAO,UAAmB;EACtC,SAAS;CACX,CAAC,EACA,aAAa,YAAY;EACxB,UAAU;CACZ,CAAC,EACA,KAAK,IAAI,SAAS,QAAQ,QAAQ,GAAG,KAAK,IAAI,CAAC,CAAC;CAEnD,IAAI,WAAW,KAAA,GAAW,MAAM;CAChC,IAAI,CAAC,SAAS,MAAM,IAAI,MAAM,GAAG,MAAM,sCAAsC;AAC/E"}

package/batteries/tools/_shared.mjs

@@ -0,0 +1,149 @@
+import { c as isObject, o as isError, s as isInstanceOf } from "../../tool_registry-791Vrjtf.mjs";
+import { t as SpooledArtifact } from "../../spooled_artifact-7eePq7JA.mjs";
+import "../../guards.mjs";
+import "../../spooled_artifact.mjs";
+//#region src/batteries/tools/_shared/index.ts
+/**
+* Resolve the configured headers (a static object or a sync/async resolver) for a single request.
+*
+* @param headers - The static header record, the resolver, or `undefined`.
+* @returns A fresh, owned copy of the resolved headers (`{}` when none supplied).
+*/
+var resolveHeaders = async (headers) => {
+	if (typeof headers === "function") return { ...await headers() };
+	return { ...headers ?? {} };
+};
+/** Unwrap a resolved value that may be a module namespace whose `default` is the constructor. */
+var unwrapDefault = (value) => {
+	if (isObject(value) && "default" in value) {
+		const def = value.default;
+		if (SpooledArtifact.isSpooledArtifactConstructor(def)) return def;
+	}
+	return value;
+};
+/**
+* Resolve an {@link ArtifactResolver} to the **sync** `() => SpooledArtifactCtor` that
+* `Tool.artifactConstructor` requires (the wrap-site and the construction-time validator both
+* invoke it synchronously, so an async resolver cannot be passed straight through).
+*
+* @remarks
+* A bare constructor is itself a function, so it is distinguished from a resolver via
+* `SpooledArtifact.isSpooledArtifactConstructor` (the same duck-typed guard the core validator
+* uses) rather than by arity. Async because a dynamic-import resolver must be awaited here.
+*
+* @param resolver - The artifact configuration. When `undefined`, callers should fall back to
+*   their own default (this function rejects `undefined` so the default lives with the caller).
+* @param onInvalid - Throws a battery-scoped error; receives a human-readable reason.
+* @returns A sync `() => SpooledArtifactCtor` suitable for `Tool.artifactConstructor`.
+*/
+var resolveArtifact = async (resolver, onInvalid) => {
+	if (SpooledArtifact.isSpooledArtifactConstructor(resolver)) {
+		const ctor = resolver;
+		return () => ctor;
+	}
+	if (typeof resolver !== "function") onInvalid("artifact must be a SpooledArtifact constructor or a resolver returning one");
+	let resolved;
+	try {
+		resolved = await resolver();
+	} catch (err) {
+		onInvalid(`artifact resolver threw: ${isError(err) ? err.message : String(err)}`);
+	}
+	resolved = unwrapDefault(resolved);
+	if (!SpooledArtifact.isSpooledArtifactConstructor(resolved)) onInvalid("artifact resolver did not resolve to a SpooledArtifact constructor");
+	const ctor = resolved;
+	return () => ctor;
+};
+/**
+* Synchronous {@link resolveArtifact}: accepts only the {@link SyncArtifactResolver} subset and
+* throws (via `onInvalid`) on an async resolver — a runtime guard for JS callers who bypass the
+* compile-time narrowing.
+*
+* @param resolver - A constructor or a sync resolver.
+* @param onInvalid - Throws a battery-scoped error; receives a human-readable reason.
+* @returns A sync `() => SpooledArtifactCtor` suitable for `Tool.artifactConstructor`.
+*/
+var resolveArtifactSync = (resolver, onInvalid) => {
+	if (SpooledArtifact.isSpooledArtifactConstructor(resolver)) {
+		const ctor = resolver;
+		return () => ctor;
+	}
+	if (typeof resolver !== "function") onInvalid("artifact must be a SpooledArtifact constructor or a resolver returning one");
+	let resolved;
+	try {
+		resolved = resolver();
+	} catch (err) {
+		onInvalid(`artifact resolver threw: ${isError(err) ? err.message : String(err)}`);
+	}
+	if (isInstanceOf(resolved, "Promise", Promise)) onInvalid("artifact resolver is async; use the async factory variant for dynamic-import resolvers");
+	resolved = unwrapDefault(resolved);
+	if (!SpooledArtifact.isSpooledArtifactConstructor(resolved)) onInvalid("artifact resolver did not resolve to a SpooledArtifact constructor");
+	const ctor = resolved;
+	return () => ctor;
+};
+/** Internal sentinel a short-circuiting input stage throws to unwind the pipeline immediately. */
+var SHORT_CIRCUIT = Symbol("adk.tools.shortCircuit");
+/** `true` when `value` is the short-circuit sentinel produced by {@link makeShortCircuit}. */
+var isShortCircuit = (value) => isObject(value) && value[SHORT_CIRCUIT] === true;
+/**
+* Build a `shortCircuit(result)` function for an input-pipeline context. Calling it throws the
+* internal sentinel, which {@link runInputPipeline} catches and converts into the verbatim result
+* (skipping the HTTP request entirely — e.g. a cache hit).
+*
+* @returns A function that, when called with a result string, throws the short-circuit sentinel.
+*/
+var makeShortCircuit = () => {
+	return (result) => {
+		throw {
+			[SHORT_CIRCUIT]: true,
+			result
+		};
+	};
+};
+/**
+* Run an input pipeline over `ctx`. Returns the short-circuit string when a stage short-circuited,
+* or `undefined` when the pipeline reached its terminal handler. A non-terminal pipeline (a stage
+* that neither called `next()` nor short-circuited) throws — the caller converts it to an
+* `Error:` string.
+*
+* @param mw - The `Middleware` instance holding the stages (a fresh `.runner()` is minted here).
+* @param ctx - The mutable input context handed to each stage.
+* @param label - Battery name, used in the non-terminal error message.
+* @returns The short-circuit result string, or `undefined` if the pipeline ran to completion.
+*/
+var runInputPipeline = async (mw, ctx, label) => {
+	let reached = false;
+	let caught;
+	await mw.runner().errorHandler(async (error) => {
+		caught = error;
+	}).finalHandler(async () => {
+		reached = true;
+	}).run((fn, next) => Promise.resolve(fn(ctx, next)));
+	if (caught !== void 0) {
+		if (isShortCircuit(caught)) return caught.result;
+		throw caught;
+	}
+	if (!reached) throw new Error(`${label} input pipeline did not call next() and did not short-circuit.`);
+};
+/**
+* Run an output pipeline over `ctx`; rethrow any stage error to the caller's try/catch. A
+* non-terminal pipeline (no `next()`) throws.
+*
+* @param mw - The `Middleware` instance holding the stages (a fresh `.runner()` is minted here).
+* @param ctx - The mutable output context handed to each stage.
+* @param label - Battery name, used in the non-terminal error message.
+*/
+var runOutputPipeline = async (mw, ctx, label) => {
+	let reached = false;
+	let caught;
+	await mw.runner().errorHandler(async (error) => {
+		caught = error;
+	}).finalHandler(async () => {
+		reached = true;
+	}).run((fn, next) => Promise.resolve(fn(ctx, next)));
+	if (caught !== void 0) throw caught;
+	if (!reached) throw new Error(`${label} output pipeline did not call next().`);
+};
+//#endregion
+export { isShortCircuit, makeShortCircuit, resolveArtifact, resolveArtifactSync, resolveHeaders, runInputPipeline, runOutputPipeline };
+
+//# sourceMappingURL=_shared.mjs.map

package/batteries/tools/_shared.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"_shared.mjs","names":[],"sources":["../../../src/batteries/tools/_shared/index.ts"],"sourcesContent":["/**\n * Cross-battery helpers shared by the configured HTTP tool batteries (SearXNG, Scrapper, …).\n *\n * @module @nhtio/adk/batteries/tools/_shared\n *\n * @remarks\n * These are internal building blocks for the *factory-style* tool batteries — the ones that talk\n * to a configured HTTP instance behind custom auth and expose input/output middleware pipelines.\n * Rather than each battery carry its own copy, the common machinery lives here:\n *\n * - {@link resolveArtifact} / {@link resolveArtifactSync} — turn an {@link ArtifactResolver}\n *   (a constructor, a sync resolver, or an async / dynamic-import resolver) into the **sync**\n *   `() => SpooledArtifactConstructor` that `Tool.artifactConstructor` requires. Mirrors the vector\n *   battery's `resolveClientCtor`.\n * - {@link resolveHeaders} — collapse a static header object or a (sync/async) resolver into a\n *   plain header record for one request (refreshable-auth friendly).\n * - {@link runInputPipeline} / {@link runOutputPipeline} — the onion middleware runners (fresh\n *   runner per call, short-circuit + non-terminal detection), generic over the context type.\n *\n * This module imports harness primitives only through their specific subpath barrels\n * (`@nhtio/adk/spooled_artifact`, `@nhtio/adk/forge`, `@nhtio/adk/guards`) per the batteries\n * barrel-only rule.\n */\n\nimport { Middleware } from '@nhtio/middleware'\nimport { SpooledArtifact } from '@nhtio/adk/spooled_artifact'\nimport { isError, isObject, isInstanceOf } from '@nhtio/adk/guards'\nimport type { NextFn } from '@nhtio/middleware'\nimport type { SpooledArtifactConstructor } from '@nhtio/adk/forge'\n\n// ── Header resolution ────────────────────────────────────────────────────────\n\n/** A static set of request headers (used for custom instance authentication). */\nexport type ToolHeaders = Record<string, string>\n\n/**\n * A resolver returning request headers, sync or async. Use this form when the auth token is\n * refreshable — the resolver runs on every request, so a fresh token can be minted per call.\n */\nexport type ToolHeadersResolver = () => ToolHeaders | Promise<ToolHeaders>\n\n/**\n * Resolve the configured headers (a static object or a sync/async resolver) for a single request.\n *\n * @param headers - The static header record, the resolver, or `undefined`.\n * @returns A fresh, owned copy of the resolved headers (`{}` when none supplied).\n */\nexport const resolveHeaders = async (\n  headers: ToolHeaders | ToolHeadersResolver | undefined\n): Promise<ToolHeaders> => {\n  if (typeof headers === 'function') return { ...(await headers()) }\n  return { ...(headers ?? {}) }\n}\n\n// ── Artifact resolver ────────────────────────────────────────────────────────\n\n/** Convenience alias for the spooled-artifact constructor a tool wraps its output in. */\nexport type SpooledArtifactCtor = SpooledArtifactConstructor\n\n/**\n * The artifact configuration accepted by a factory: a constructor, a sync resolver, or an async /\n * dynamic-import resolver (which may yield a module namespace whose `default` is the constructor).\n *\n * @remarks\n * Mirrors the vector battery's `client` resolver and `Tool.artifactConstructor`'s indirection. The\n * async form lets a consumer `() => import('@nhtio/adk/spooled_artifact').then(m => m.SpooledMarkdownArtifact)`\n * so the artifact class never enters their static module graph.\n */\nexport type ArtifactResolver =\n  | SpooledArtifactCtor\n  | (() => SpooledArtifactCtor | { default: SpooledArtifactCtor })\n  | (() => Promise<SpooledArtifactCtor | { default: SpooledArtifactCtor }>)\n\n/** The sync subset of {@link ArtifactResolver} — a constructor or a sync resolver (no Promise). */\nexport type SyncArtifactResolver =\n  | SpooledArtifactCtor\n  | (() => SpooledArtifactCtor | { default: SpooledArtifactCtor })\n\n/** Unwrap a resolved value that may be a module namespace whose `default` is the constructor. */\nconst unwrapDefault = (value: unknown): unknown => {\n  if (isObject(value) && 'default' in value) {\n    const def = (value as { default?: unknown }).default\n    if (SpooledArtifact.isSpooledArtifactConstructor(def)) return def\n  }\n  return value\n}\n\n/**\n * Resolve an {@link ArtifactResolver} to the **sync** `() => SpooledArtifactCtor` that\n * `Tool.artifactConstructor` requires (the wrap-site and the construction-time validator both\n * invoke it synchronously, so an async resolver cannot be passed straight through).\n *\n * @remarks\n * A bare constructor is itself a function, so it is distinguished from a resolver via\n * `SpooledArtifact.isSpooledArtifactConstructor` (the same duck-typed guard the core validator\n * uses) rather than by arity. Async because a dynamic-import resolver must be awaited here.\n *\n * @param resolver - The artifact configuration. When `undefined`, callers should fall back to\n *   their own default (this function rejects `undefined` so the default lives with the caller).\n * @param onInvalid - Throws a battery-scoped error; receives a human-readable reason.\n * @returns A sync `() => SpooledArtifactCtor` suitable for `Tool.artifactConstructor`.\n */\nexport const resolveArtifact = async (\n  resolver: ArtifactResolver,\n  onInvalid: (reason: string) => never\n): Promise<() => SpooledArtifactCtor> => {\n  // A constructor: hand back a thunk that returns it.\n  if (SpooledArtifact.isSpooledArtifactConstructor(resolver)) {\n    const ctor = resolver\n    return () => ctor\n  }\n  // Otherwise it must be a resolver function.\n  if (typeof resolver !== 'function') {\n    onInvalid('artifact must be a SpooledArtifact constructor or a resolver returning one')\n  }\n  let resolved: unknown\n  try {\n    resolved = await (resolver as () => unknown)()\n  } catch (err) {\n    onInvalid(`artifact resolver threw: ${isError(err) ? err.message : String(err)}`)\n  }\n  resolved = unwrapDefault(resolved)\n  if (!SpooledArtifact.isSpooledArtifactConstructor(resolved)) {\n    onInvalid('artifact resolver did not resolve to a SpooledArtifact constructor')\n  }\n  const ctor = resolved as SpooledArtifactCtor\n  return () => ctor\n}\n\n/**\n * Synchronous {@link resolveArtifact}: accepts only the {@link SyncArtifactResolver} subset and\n * throws (via `onInvalid`) on an async resolver — a runtime guard for JS callers who bypass the\n * compile-time narrowing.\n *\n * @param resolver - A constructor or a sync resolver.\n * @param onInvalid - Throws a battery-scoped error; receives a human-readable reason.\n * @returns A sync `() => SpooledArtifactCtor` suitable for `Tool.artifactConstructor`.\n */\nexport const resolveArtifactSync = (\n  resolver: SyncArtifactResolver,\n  onInvalid: (reason: string) => never\n): (() => SpooledArtifactCtor) => {\n  if (SpooledArtifact.isSpooledArtifactConstructor(resolver)) {\n    const ctor = resolver\n    return () => ctor\n  }\n  if (typeof resolver !== 'function') {\n    onInvalid('artifact must be a SpooledArtifact constructor or a resolver returning one')\n  }\n  let resolved: unknown\n  try {\n    resolved = (resolver as () => unknown)()\n  } catch (err) {\n    onInvalid(`artifact resolver threw: ${isError(err) ? err.message : String(err)}`)\n  }\n  if (isInstanceOf(resolved, 'Promise', Promise)) {\n    onInvalid(\n      'artifact resolver is async; use the async factory variant for dynamic-import resolvers'\n    )\n  }\n  resolved = unwrapDefault(resolved)\n  if (!SpooledArtifact.isSpooledArtifactConstructor(resolved)) {\n    onInvalid('artifact resolver did not resolve to a SpooledArtifact constructor')\n  }\n  const ctor = resolved as SpooledArtifactCtor\n  return () => ctor\n}\n\n// ── Middleware pipeline runners ──────────────────────────────────────────────\n\n/** Internal sentinel a short-circuiting input stage throws to unwind the pipeline immediately. */\nconst SHORT_CIRCUIT = Symbol('adk.tools.shortCircuit')\n\ninterface ShortCircuitSignal {\n  [SHORT_CIRCUIT]: true\n  result: string\n}\n\n/** `true` when `value` is the short-circuit sentinel produced by {@link makeShortCircuit}. */\nexport const isShortCircuit = (value: unknown): value is { result: string } =>\n  isObject(value) && (value as Record<symbol, unknown>)[SHORT_CIRCUIT] === true\n\n/**\n * Build a `shortCircuit(result)` function for an input-pipeline context. Calling it throws the\n * internal sentinel, which {@link runInputPipeline} catches and converts into the verbatim result\n * (skipping the HTTP request entirely — e.g. a cache hit).\n *\n * @returns A function that, when called with a result string, throws the short-circuit sentinel.\n */\nexport const makeShortCircuit = (): ((result: string) => never) => {\n  return (result: string): never => {\n    const signal: ShortCircuitSignal = { [SHORT_CIRCUIT]: true, result }\n    throw signal\n  }\n}\n\n/** A generic onion middleware stage over a mutable context `C`. */\nexport type MiddlewareFn<C> = (ctx: C, next: NextFn) => void | Promise<void>\n\n/**\n * Run an input pipeline over `ctx`. Returns the short-circuit string when a stage short-circuited,\n * or `undefined` when the pipeline reached its terminal handler. A non-terminal pipeline (a stage\n * that neither called `next()` nor short-circuited) throws — the caller converts it to an\n * `Error:` string.\n *\n * @param mw - The `Middleware` instance holding the stages (a fresh `.runner()` is minted here).\n * @param ctx - The mutable input context handed to each stage.\n * @param label - Battery name, used in the non-terminal error message.\n * @returns The short-circuit result string, or `undefined` if the pipeline ran to completion.\n */\nexport const runInputPipeline = async <C>(\n  mw: Middleware<MiddlewareFn<C>>,\n  ctx: C,\n  label: string\n): Promise<string | undefined> => {\n  let reached = false\n  let caught: unknown\n  await mw\n    .runner()\n    .errorHandler(async (error: unknown) => {\n      caught = error\n    })\n    .finalHandler(async () => {\n      reached = true\n    })\n    .run((fn, next) => Promise.resolve(fn(ctx, next)))\n\n  if (caught !== undefined) {\n    if (isShortCircuit(caught)) return caught.result\n    throw caught\n  }\n  if (!reached) {\n    throw new Error(`${label} input pipeline did not call next() and did not short-circuit.`)\n  }\n  return undefined\n}\n\n/**\n * Run an output pipeline over `ctx`; rethrow any stage error to the caller's try/catch. A\n * non-terminal pipeline (no `next()`) throws.\n *\n * @param mw - The `Middleware` instance holding the stages (a fresh `.runner()` is minted here).\n * @param ctx - The mutable output context handed to each stage.\n * @param label - Battery name, used in the non-terminal error message.\n */\nexport const runOutputPipeline = async <C>(\n  mw: Middleware<MiddlewareFn<C>>,\n  ctx: C,\n  label: string\n): Promise<void> => {\n  let reached = false\n  let caught: unknown\n  await mw\n    .runner()\n    .errorHandler(async (error: unknown) => {\n      caught = error\n    })\n    .finalHandler(async () => {\n      reached = true\n    })\n    .run((fn, next) => Promise.resolve(fn(ctx, next)))\n\n  if (caught !== undefined) throw caught\n  if (!reached) throw new Error(`${label} output pipeline did not call next().`)\n}\n"],"mappings":";;;;;;;;;;;AA+CA,IAAa,iBAAiB,OAC5B,YACyB;CACzB,IAAI,OAAO,YAAY,YAAY,OAAO,EAAE,GAAI,MAAM,QAAQ,EAAG;CACjE,OAAO,EAAE,GAAI,WAAW,CAAC,EAAG;AAC9B;;AA2BA,IAAM,iBAAiB,UAA4B;CACjD,IAAI,SAAS,KAAK,KAAK,aAAa,OAAO;EACzC,MAAM,MAAO,MAAgC;EAC7C,IAAI,gBAAgB,6BAA6B,GAAG,GAAG,OAAO;CAChE;CACA,OAAO;AACT;;;;;;;;;;;;;;;;AAiBA,IAAa,kBAAkB,OAC7B,UACA,cACuC;CAEvC,IAAI,gBAAgB,6BAA6B,QAAQ,GAAG;EAC1D,MAAM,OAAO;EACb,aAAa;CACf;CAEA,IAAI,OAAO,aAAa,YACtB,UAAU,4EAA4E;CAExF,IAAI;CACJ,IAAI;EACF,WAAW,MAAO,SAA2B;CAC/C,SAAS,KAAK;EACZ,UAAU,4BAA4B,QAAQ,GAAG,IAAI,IAAI,UAAU,OAAO,GAAG,GAAG;CAClF;CACA,WAAW,cAAc,QAAQ;CACjC,IAAI,CAAC,gBAAgB,6BAA6B,QAAQ,GACxD,UAAU,oEAAoE;CAEhF,MAAM,OAAO;CACb,aAAa;AACf;;;;;;;;;;AAWA,IAAa,uBACX,UACA,cACgC;CAChC,IAAI,gBAAgB,6BAA6B,QAAQ,GAAG;EAC1D,MAAM,OAAO;EACb,aAAa;CACf;CACA,IAAI,OAAO,aAAa,YACtB,UAAU,4EAA4E;CAExF,IAAI;CACJ,IAAI;EACF,WAAY,SAA2B;CACzC,SAAS,KAAK;EACZ,UAAU,4BAA4B,QAAQ,GAAG,IAAI,IAAI,UAAU,OAAO,GAAG,GAAG;CAClF;CACA,IAAI,aAAa,UAAU,WAAW,OAAO,GAC3C,UACE,wFACF;CAEF,WAAW,cAAc,QAAQ;CACjC,IAAI,CAAC,gBAAgB,6BAA6B,QAAQ,GACxD,UAAU,oEAAoE;CAEhF,MAAM,OAAO;CACb,aAAa;AACf;;AAKA,IAAM,gBAAgB,OAAO,wBAAwB;;AAQrD,IAAa,kBAAkB,UAC7B,SAAS,KAAK,KAAM,MAAkC,mBAAmB;;;;;;;;AAS3E,IAAa,yBAAsD;CACjE,QAAQ,WAA0B;EAEhC,MAAM;IADgC,gBAAgB;GAAM;EACtD;CACR;AACF;;;;;;;;;;;;AAgBA,IAAa,mBAAmB,OAC9B,IACA,KACA,UACgC;CAChC,IAAI,UAAU;CACd,IAAI;CACJ,MAAM,GACH,OAAO,EACP,aAAa,OAAO,UAAmB;EACtC,SAAS;CACX,CAAC,EACA,aAAa,YAAY;EACxB,UAAU;CACZ,CAAC,EACA,KAAK,IAAI,SAAS,QAAQ,QAAQ,GAAG,KAAK,IAAI,CAAC,CAAC;CAEnD,IAAI,WAAW,KAAA,GAAW;EACxB,IAAI,eAAe,MAAM,GAAG,OAAO,OAAO;EAC1C,MAAM;CACR;CACA,IAAI,CAAC,SACH,MAAM,IAAI,MAAM,GAAG,MAAM,+DAA+D;AAG5F;;;;;;;;;AAUA,IAAa,oBAAoB,OAC/B,IACA,KACA,UACkB;CAClB,IAAI,UAAU;CACd,IAAI;CACJ,MAAM,GACH,OAAO,EACP,aAAa,OAAO,UAAmB;EACtC,SAAS;CACX,CAAC,EACA,aAAa,YAAY;EACxB,UAAU;CACZ,CAAC,EACA,KAAK,IAAI,SAAS,QAAQ,QAAQ,GAAG,KAAK,IAAI,CAAC,CAAC;CAEnD,IAAI,WAAW,KAAA,GAAW,MAAM;CAChC,IAAI,CAAC,SAAS,MAAM,IAAI,MAAM,GAAG,MAAM,sCAAsC;AAC/E"}

package/batteries/tools/color.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../chunk-Ble4zEEl.js");
-const require_tool = require("../../tool-DjUJeSzk.js");
-require("../../common-Do0PmqEC.js");
+const require_tool = require("../../tool-D5WGVIcI.js");
+require("../../common-DZl3ADJs.js");
 let _nhtio_validation = require("@nhtio/validation");
 //#region src/batteries/tools/color/index.ts
 /**

package/batteries/tools/color.mjs

@@ -1,5 +1,5 @@
-import { t as Tool } from "../../tool-DMvZFz9h.mjs";
-import "../../common-DwyIhf5B.mjs";
+import { t as Tool } from "../../tool-wMYMVl60.mjs";
+import "../../common-DYDUi99O.mjs";
 import { validator } from "@nhtio/validation";
 //#region src/batteries/tools/color/index.ts
 /**

package/batteries/tools/comparison.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../chunk-Ble4zEEl.js");
-const require_tool_registry = require("../../tool_registry-C5wfDxaq.js");
-const require_tool = require("../../tool-DjUJeSzk.js");
-require("../../common-Do0PmqEC.js");
+const require_tool_registry = require("../../tool_registry-CKJPze3j.js");
+const require_tool = require("../../tool-D5WGVIcI.js");
+require("../../common-DZl3ADJs.js");
 require("../../guards.cjs");
 let _nhtio_validation = require("@nhtio/validation");
 //#region src/batteries/tools/comparison/index.ts

package/batteries/tools/comparison.mjs

@@ -1,6 +1,6 @@
-import { o as isError } from "../../tool_registry-BuMKln6b.mjs";
-import { t as Tool } from "../../tool-DMvZFz9h.mjs";
-import "../../common-DwyIhf5B.mjs";
+import { o as isError } from "../../tool_registry-791Vrjtf.mjs";
+import { t as Tool } from "../../tool-wMYMVl60.mjs";
+import "../../common-DYDUi99O.mjs";
 import "../../guards.mjs";
 import { validator } from "@nhtio/validation";
 //#region src/batteries/tools/comparison/index.ts

package/batteries/tools/data_structure.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../chunk-Ble4zEEl.js");
-const require_tool_registry = require("../../tool_registry-C5wfDxaq.js");
-const require_tool = require("../../tool-DjUJeSzk.js");
-require("../../common-Do0PmqEC.js");
+const require_tool_registry = require("../../tool_registry-CKJPze3j.js");
+const require_tool = require("../../tool-D5WGVIcI.js");
+require("../../common-DZl3ADJs.js");
 require("../../guards.cjs");
 const require_lib_helpers_bignum = require("../../lib/helpers/bignum.cjs");
 let _nhtio_validation = require("@nhtio/validation");

package/batteries/tools/data_structure.mjs

@@ -1,6 +1,6 @@
-import { c as isObject, o as isError } from "../../tool_registry-BuMKln6b.mjs";
-import { t as Tool } from "../../tool-DMvZFz9h.mjs";
-import "../../common-DwyIhf5B.mjs";
+import { c as isObject, o as isError } from "../../tool_registry-791Vrjtf.mjs";
+import { t as Tool } from "../../tool-wMYMVl60.mjs";
+import "../../common-DYDUi99O.mjs";
 import "../../guards.mjs";
 import { bigMean, bigSum, bigToNumber, formatBig } from "../../lib/helpers/bignum.mjs";
 import { validator } from "@nhtio/validation";

package/batteries/tools/datetime_extended.cjs

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("../../chunk-Ble4zEEl.js");
-const require_tool = require("../../tool-DjUJeSzk.js");
-require("../../common-Do0PmqEC.js");
-let luxon = require("luxon");
+const require_tool = require("../../tool-D5WGVIcI.js");
+require("../../common-DZl3ADJs.js");
 let _nhtio_validation = require("@nhtio/validation");
+let luxon = require("luxon");
 let chrono_node = require("chrono-node");
 chrono_node = require_chunk.__toESM(chrono_node);
 //#region src/batteries/tools/datetime_extended/index.ts

package/batteries/tools/datetime_extended.mjs

@@ -1,7 +1,7 @@
-import { t as Tool } from "../../tool-DMvZFz9h.mjs";
-import "../../common-DwyIhf5B.mjs";
-import { DateTime, IANAZone } from "luxon";
+import { t as Tool } from "../../tool-wMYMVl60.mjs";
+import "../../common-DYDUi99O.mjs";
 import { validator } from "@nhtio/validation";
+import { DateTime, IANAZone } from "luxon";
 import * as chrono from "chrono-node";
 //#region src/batteries/tools/datetime_extended/index.ts
 /**

package/batteries/tools/datetime_math.cjs

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../chunk-Ble4zEEl.js");
-const require_tool = require("../../tool-DjUJeSzk.js");
-require("../../common-Do0PmqEC.js");
-let luxon = require("luxon");
+const require_tool = require("../../tool-D5WGVIcI.js");
+require("../../common-DZl3ADJs.js");
 let _nhtio_validation = require("@nhtio/validation");
+let luxon = require("luxon");
 //#region src/batteries/tools/datetime_math/index.ts
 /**
 * Pre-constructed tools for ISO datetime arithmetic, differences, and timezone-aware formatting.

package/batteries/tools/datetime_math.mjs

@@ -1,7 +1,7 @@
-import { t as Tool } from "../../tool-DMvZFz9h.mjs";
-import "../../common-DwyIhf5B.mjs";
-import { DateTime, Duration, IANAZone } from "luxon";
+import { t as Tool } from "../../tool-wMYMVl60.mjs";
+import "../../common-DYDUi99O.mjs";
 import { validator } from "@nhtio/validation";
+import { DateTime, Duration, IANAZone } from "luxon";
 //#region src/batteries/tools/datetime_math/index.ts
 /**
 * Pre-constructed tools for ISO datetime arithmetic, differences, and timezone-aware formatting.

package/batteries/tools/encoding.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../chunk-Ble4zEEl.js");
-const require_tool_registry = require("../../tool_registry-C5wfDxaq.js");
-const require_tool = require("../../tool-DjUJeSzk.js");
-require("../../common-Do0PmqEC.js");
+const require_tool_registry = require("../../tool_registry-CKJPze3j.js");
+const require_tool = require("../../tool-D5WGVIcI.js");
+require("../../common-DZl3ADJs.js");
 require("../../guards.cjs");
 let _nhtio_validation = require("@nhtio/validation");
 //#region src/batteries/tools/encoding/index.ts

package/batteries/tools/encoding.mjs

@@ -1,6 +1,6 @@
-import { o as isError } from "../../tool_registry-BuMKln6b.mjs";
-import { t as Tool } from "../../tool-DMvZFz9h.mjs";
-import "../../common-DwyIhf5B.mjs";
+import { o as isError } from "../../tool_registry-791Vrjtf.mjs";
+import { t as Tool } from "../../tool-wMYMVl60.mjs";
+import "../../common-DYDUi99O.mjs";
 import "../../guards.mjs";
 import { validator } from "@nhtio/validation";
 //#region src/batteries/tools/encoding/index.ts

package/batteries/tools/formatting.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../chunk-Ble4zEEl.js");
-const require_tool_registry = require("../../tool_registry-C5wfDxaq.js");
-const require_tool = require("../../tool-DjUJeSzk.js");
-require("../../common-Do0PmqEC.js");
+const require_tool_registry = require("../../tool_registry-CKJPze3j.js");
+const require_tool = require("../../tool-D5WGVIcI.js");
+require("../../common-DZl3ADJs.js");
 require("../../guards.cjs");
 let _nhtio_validation = require("@nhtio/validation");
 //#region src/batteries/tools/formatting/index.ts

package/batteries/tools/formatting.mjs

@@ -1,6 +1,6 @@
-import { o as isError } from "../../tool_registry-BuMKln6b.mjs";
-import { t as Tool } from "../../tool-DMvZFz9h.mjs";
-import "../../common-DwyIhf5B.mjs";
+import { o as isError } from "../../tool_registry-791Vrjtf.mjs";
+import { t as Tool } from "../../tool-wMYMVl60.mjs";
+import "../../common-DYDUi99O.mjs";
 import "../../guards.mjs";
 import { validator } from "@nhtio/validation";
 //#region src/batteries/tools/formatting/index.ts

package/batteries/tools/geo_basics.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../chunk-Ble4zEEl.js");
-const require_tool = require("../../tool-DjUJeSzk.js");
-require("../../common-Do0PmqEC.js");
+const require_tool = require("../../tool-D5WGVIcI.js");
+require("../../common-DZl3ADJs.js");
 let _nhtio_validation = require("@nhtio/validation");
 //#region src/batteries/tools/geo_basics/index.ts
 /**

package/batteries/tools/geo_basics.mjs

@@ -1,5 +1,5 @@
-import { t as Tool } from "../../tool-DMvZFz9h.mjs";
-import "../../common-DwyIhf5B.mjs";
+import { t as Tool } from "../../tool-wMYMVl60.mjs";
+import "../../common-DYDUi99O.mjs";
 import { validator } from "@nhtio/validation";
 //#region src/batteries/tools/geo_basics/index.ts
 /**

package/batteries/tools/index.d.ts

@@ -22,6 +22,7 @@ export * from "./math/index";
 export * from "./memory/index";
 export * from "./parsing/index";
 export * from "./retrievables/index";
+export * from "./scrapper/index";
 export * from "./searxng/index";
 export * from "./standing_instructions/index";
 export * from "./statistics/index";
@@ -29,5 +30,6 @@ export * from "./string_processing/index";
 export * from "./structured_data/index";
 export * from "./text_analysis/index";
 export * from "./text_comparison/index";
+export * from "./web_retrieval/index";
 export * from "./time/index";
 export * from "./unit_conversion/index";

package/batteries/tools/math.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("../../chunk-Ble4zEEl.js");
-const require_tool_registry = require("../../tool_registry-C5wfDxaq.js");
-const require_tool = require("../../tool-DjUJeSzk.js");
-require("../../common-Do0PmqEC.js");
+const require_tool_registry = require("../../tool_registry-CKJPze3j.js");
+const require_tool = require("../../tool-D5WGVIcI.js");
+require("../../common-DZl3ADJs.js");
 require("../../guards.cjs");
 let _nhtio_validation = require("@nhtio/validation");
 let mathjs = require("mathjs");

package/batteries/tools/math.mjs

@@ -1,6 +1,6 @@
-import { o as isError, s as isInstanceOf } from "../../tool_registry-BuMKln6b.mjs";
-import { t as Tool } from "../../tool-DMvZFz9h.mjs";
-import "../../common-DwyIhf5B.mjs";
+import { o as isError, s as isInstanceOf } from "../../tool_registry-791Vrjtf.mjs";
+import { t as Tool } from "../../tool-wMYMVl60.mjs";
+import "../../common-DYDUi99O.mjs";
 import "../../guards.mjs";
 import { validator } from "@nhtio/validation";
 import { all, create } from "mathjs";

package/batteries/tools/memory.cjs

@@ -1,14 +1,14 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../chunk-Ble4zEEl.js");
-const require_tool_registry = require("../../tool_registry-C5wfDxaq.js");
-const require_thought = require("../../thought-DhElxSkZ.js");
-const require_tool = require("../../tool-DjUJeSzk.js");
-require("../../common-Do0PmqEC.js");
-const require_spooled_markdown_artifact = require("../../spooled_markdown_artifact-DyevhaL6.js");
+const require_tool_registry = require("../../tool_registry-CKJPze3j.js");
+const require_thought = require("../../thought-DLwpF7MI.js");
+const require_tool = require("../../tool-D5WGVIcI.js");
+require("../../common-DZl3ADJs.js");
+const require_spooled_markdown_artifact = require("../../spooled_markdown_artifact-ClX72lek.js");
 require("../../guards.cjs");
+let _nhtio_validation = require("@nhtio/validation");
 let luxon = require("luxon");
 let uuid = require("uuid");
-let _nhtio_validation = require("@nhtio/validation");
 //#region src/batteries/tools/memory/index.ts
 /**
 * Pre-constructed CRUD tools for model-visible ADK memory management.