@lloyal-labs/rig 2.0.1 → 3.0.0

package/dist/spine-render.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Spine + per-spawn preamble assembly.
+ *
+ * Two pure render functions. Both pull bytes from `protocol.ts`
+ * constants rather than inlining literals — the codified protocol
+ * has exactly one source of truth.
+ *
+ * ## `renderSpine`
+ *
+ * Assembles the Level-1 shared-prefix system prompt. **Carries no
+ * free-form prose surface**: framework-owned literal strings +
+ * grammar-sanitized app catalog metadata. No `supplementaryContent`
+ * parameter, no per-app prose argument.
+ *
+ * Output structure:
+ *
+ * ```
+ * <FRAMEWORK_INTRO>
+ *
+ * # Protocols
+ *
+ * <CATALOG_ENTRY for each app, in registration order>
+ *
+ * <TOOL_SELECTION_RULE>
+ * ```
+ *
+ * App `examples.eta` content goes through `renderAgentPreamble` into
+ * per-spawn preambles, never into this output.
+ *
+ * ## `renderAgentPreamble`
+ *
+ * The *only* place the framework emits the boundary marker.
+ * Called once per spawn with the assigned app's templates only — no
+ * other app's `skill.eta` / `examples.eta` enters this rendering, which
+ * is what makes per-spawn isolation a framework invariant rather than
+ * a convention.
+ *
+ * @packageDocumentation
+ * @category Protocol
+ */
+import type { App, AgentRenderCtx } from '@lloyal-labs/lloyal-agents';
+/**
+ * Arguments for {@link renderSpine}. `apps` order is observable to
+ * the model — catalog entries emit in registration order; harness
+ * registration order is the input order here.
+ */
+export interface RenderSpineOptions {
+    /**
+     * Registered apps to compose into the catalog. Pass
+     * `registry.enabled()` from {@link AppRegistryCtx}, or any
+     * subset/ordering the harness wants reflected in the spine.
+     */
+    apps: readonly App[];
+}
+/**
+ * Render the shared-spine system prompt.
+ *
+ * The output has a fixed shape across pool sizes and pool composition
+ * — the only variability is the per-app catalog block, sourced from
+ * each app's `manifest.protocol`. No app prose; no harness prose.
+ *
+ * The returned string is intended for `SpineOptions.systemPrompt` in
+ * `withSpine(...)`; tool schemas pass through `SpineOptions.tools =
+ * apps.flatMap(a => a.tools)` separately and are decoded into KV at
+ * spine prefill.
+ */
+export declare function renderSpine(opts: RenderSpineOptions): string;
+/**
+ * Render the per-spawn preamble for a single agent assigned to
+ * `app`. The framework calls this when constructing a spawn's
+ * user-role message; the output is the *only* place the boundary
+ * marker bytes appear at runtime.
+ *
+ * Output:
+ *
+ * ```
+ * <BOUNDARY_MARKER(app.manifest.protocol.name)>
+ * <renderTemplate(app.skill, params)>
+ *
+ * <renderTemplate(app.examples, examplesParams)>   // if app.examples is defined
+ * ```
+ *
+ * `app.manifest.protocol.name` is grammar-restricted at `defineApp`
+ * time: matches `[a-z][a-z0-9_-]{1,63}`, so it cannot
+ * break the markdown bold or inject newlines into the marker bytes.
+ *
+ * `app.examples` (if present) receives an extended render context
+ * carrying the protocol `name` and `tools[]` in addition to the
+ * standard {@link AgentRenderCtx} fields, allowing discipline content
+ * to reference the protocol identity directly.
+ *
+ * `params` accepts app-specific render data beyond {@link AgentRenderCtx}
+ * (e.g. a corpus app merges its `source.promptData()` to supply `it.toc`).
+ * Extra keys are spread into the Eta render data unchanged.
+ */
+export declare function renderAgentPreamble(app: App, params: AgentRenderCtx & Record<string, unknown>): string;
+//# sourceMappingURL=spine-render.d.ts.map

package/dist/spine-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spine-render.d.ts","sourceRoot":"","sources":["../src/spine-render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAGH,OAAO,KAAK,EACV,GAAG,EACH,cAAc,EAIf,MAAM,4BAA4B,CAAC;AAQpC;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,IAAI,EAAE,SAAS,GAAG,EAAE,CAAC;CACtB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAkB5D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/C,MAAM,CAeR"}

package/dist/spine-render.js

@@ -0,0 +1,121 @@
+"use strict";
+/**
+ * Spine + per-spawn preamble assembly.
+ *
+ * Two pure render functions. Both pull bytes from `protocol.ts`
+ * constants rather than inlining literals — the codified protocol
+ * has exactly one source of truth.
+ *
+ * ## `renderSpine`
+ *
+ * Assembles the Level-1 shared-prefix system prompt. **Carries no
+ * free-form prose surface**: framework-owned literal strings +
+ * grammar-sanitized app catalog metadata. No `supplementaryContent`
+ * parameter, no per-app prose argument.
+ *
+ * Output structure:
+ *
+ * ```
+ * <FRAMEWORK_INTRO>
+ *
+ * # Protocols
+ *
+ * <CATALOG_ENTRY for each app, in registration order>
+ *
+ * <TOOL_SELECTION_RULE>
+ * ```
+ *
+ * App `examples.eta` content goes through `renderAgentPreamble` into
+ * per-spawn preambles, never into this output.
+ *
+ * ## `renderAgentPreamble`
+ *
+ * The *only* place the framework emits the boundary marker.
+ * Called once per spawn with the assigned app's templates only — no
+ * other app's `skill.eta` / `examples.eta` enters this rendering, which
+ * is what makes per-spawn isolation a framework invariant rather than
+ * a convention.
+ *
+ * @packageDocumentation
+ * @category Protocol
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderSpine = renderSpine;
+exports.renderAgentPreamble = renderAgentPreamble;
+const lloyal_agents_1 = require("@lloyal-labs/lloyal-agents");
+const protocol_1 = require("./protocol");
+/**
+ * Render the shared-spine system prompt.
+ *
+ * The output has a fixed shape across pool sizes and pool composition
+ * — the only variability is the per-app catalog block, sourced from
+ * each app's `manifest.protocol`. No app prose; no harness prose.
+ *
+ * The returned string is intended for `SpineOptions.systemPrompt` in
+ * `withSpine(...)`; tool schemas pass through `SpineOptions.tools =
+ * apps.flatMap(a => a.tools)` separately and are decoded into KV at
+ * spine prefill.
+ */
+function renderSpine(opts) {
+    const catalogBlocks = opts.apps
+        .map((app) => (0, protocol_1.CATALOG_ENTRY)(app.manifest.protocol.name, [...app.manifest.protocol.tools], app.manifest.protocol.useWhen))
+        .join('\n');
+    return (protocol_1.FRAMEWORK_INTRO +
+        '\n\n# Protocols\n\n' +
+        catalogBlocks +
+        '\n' +
+        protocol_1.TOOL_SELECTION_RULE);
+}
+/**
+ * Render the per-spawn preamble for a single agent assigned to
+ * `app`. The framework calls this when constructing a spawn's
+ * user-role message; the output is the *only* place the boundary
+ * marker bytes appear at runtime.
+ *
+ * Output:
+ *
+ * ```
+ * <BOUNDARY_MARKER(app.manifest.protocol.name)>
+ * <renderTemplate(app.skill, params)>
+ *
+ * <renderTemplate(app.examples, examplesParams)>   // if app.examples is defined
+ * ```
+ *
+ * `app.manifest.protocol.name` is grammar-restricted at `defineApp`
+ * time: matches `[a-z][a-z0-9_-]{1,63}`, so it cannot
+ * break the markdown bold or inject newlines into the marker bytes.
+ *
+ * `app.examples` (if present) receives an extended render context
+ * carrying the protocol `name` and `tools[]` in addition to the
+ * standard {@link AgentRenderCtx} fields, allowing discipline content
+ * to reference the protocol identity directly.
+ *
+ * `params` accepts app-specific render data beyond {@link AgentRenderCtx}
+ * (e.g. a corpus app merges its `source.promptData()` to supply `it.toc`).
+ * Extra keys are spread into the Eta render data unchanged.
+ */
+function renderAgentPreamble(app, params) {
+    const marker = (0, protocol_1.BOUNDARY_MARKER)(app.manifest.protocol.name);
+    const body = renderSkillBody(app.skill, params);
+    if (!app.examples) {
+        return marker + body;
+    }
+    const examplesParams = {
+        ...params,
+        name: app.manifest.protocol.name,
+        tools: app.manifest.protocol.tools,
+    };
+    const examples = renderExamples(app.examples, examplesParams);
+    return marker + body + '\n\n' + examples;
+}
+function renderSkillBody(skill, params) {
+    return typeof skill === 'function'
+        ? skill(params)
+        : (0, lloyal_agents_1.renderTemplate)(skill, params);
+}
+function renderExamples(examples, params) {
+    return typeof examples === 'function'
+        ? examples(params)
+        : (0, lloyal_agents_1.renderTemplate)(examples, params);
+}
+//# sourceMappingURL=spine-render.js.map

package/dist/spine-render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spine-render.js","sourceRoot":"","sources":["../src/spine-render.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;;AA2CH,kCAkBC;AA8BD,kDAkBC;AA3GD,8DAA4D;AAQ5D,yCAKoB;AAgBpB;;;;;;;;;;;GAWG;AACH,SAAgB,WAAW,CAAC,IAAwB;IAClD,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI;SAC5B,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CACX,IAAA,wBAAa,EACX,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAC1B,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAChC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAC9B,CACF;SACA,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO,CACL,0BAAe;QACf,qBAAqB;QACrB,aAAa;QACb,IAAI;QACJ,8BAAmB,CACpB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,SAAgB,mBAAmB,CACjC,GAAQ,EACR,MAAgD;IAEhD,MAAM,MAAM,GAAG,IAAA,0BAAe,EAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAEhD,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAClB,OAAO,MAAM,GAAG,IAAI,CAAC;IACvB,CAAC;IAED,MAAM,cAAc,GAAsB;QACxC,GAAG,MAAM;QACT,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI;QAChC,KAAK,EAAE,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK;KACnC,CAAC;IACF,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC9D,OAAO,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,QAAQ,CAAC;AAC3C,CAAC;AAED,SAAS,eAAe,CACtB,KAA+B,EAC/B,MAAsB;IAEtB,OAAO,OAAO,KAAK,KAAK,UAAU;QAChC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;QACf,CAAC,CAAC,IAAA,8BAAc,EAAC,KAAK,EAAE,MAA4C,CAAC,CAAC;AAC1E,CAAC;AAED,SAAS,cAAc,CACrB,QAAqC,EACrC,MAAyB;IAEzB,OAAO,OAAO,QAAQ,KAAK,UAAU;QACnC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;QAClB,CAAC,CAAC,IAAA,8BAAc,EAAC,QAAQ,EAAE,MAA4C,CAAC,CAAC;AAC7E,CAAC"}

package/dist/tools/delegate.js

@@ -157,7 +157,7 @@ class DelegateTool extends lloyal_agents_1.Tool {
             ...(this._createPolicy ? { policy: this._createPolicy() } : {}),
             orchestrate: (0, lloyal_agents_1.parallel)(tasks.map(t => ({ systemPrompt: this._systemPrompt, content: t }))),
             parent: context?.branch,
-            pruneOnReport: opts.pruneOnReport ?? true,
+            pruneOnReturn: opts.pruneOnReturn ?? true,
             scorer: context?.scorer,
         });
         const result = {

package/dist/tools/index.d.ts

@@ -1,35 +1,39 @@
-import type { Toolkit } from '@lloyal-labs/lloyal-agents';
-import type { Resource, Chunk } from '../resources/types';
-import type { Reranker } from './types';
+/**
+ * Rig — framework-level tools, search providers, and shared types.
+ *
+ * **Framework tools (consumed by harnesses):**
+ * - {@link reportTool} / {@link ReportTool} — the standard terminal tool.
+ * - {@link DelegateTool} — delegation primitive for sub-agent spawning.
+ * - {@link PlanTool} — grammar-constrained query planner.
+ *
+ * **Search providers (consumed by apps' Source implementations):**
+ * - {@link TavilyProvider} — Tavily-backed web search.
+ * - {@link createKeylessSearchProvider} — keyless DuckDuckGo fallback.
+ *
+ * App-scoped Tool classes (`web_search`, `fetch_page`, `search`,
+ * `read_file`, `grep`) live in `@lloyal-labs/{web,corpus}-app`, not
+ * here — those are unit-of-distribution surfaces under the App
+ * protocol, installed via `harness.dev install`.
+ */
 import { ReportTool } from './report';
-export { WebSearchTool, TavilyProvider } from './web-search';
-export { FetchPageTool } from './fetch-page';
+export { TavilyProvider } from './web-search';
+export type { SearchProvider, SearchResult } from './web-search';
+export { createKeylessSearchProvider } from './keyless-search';
+export type { KeylessSearchOptions } from './keyless-search';
 export { ReportTool } from './report';
 export { DelegateTool } from './delegate';
 export type { DelegateToolOpts } from './delegate';
-export type { SearchProvider, SearchResult, Reranker, ScoredChunk, ScoredResult } from './types';
+export type { Reranker, ScoredChunk, ScoredResult } from './types';
 export { PlanTool, taskToContent } from './plan';
 export type { PlanResult, PlanIntent, PlanToolOpts, ResearchTask } from './plan';
 /**
- * Shared singleton {@link ReportTool} instance.
+ * Shared {@link ReportTool} instance — the conventional terminal tool.
  *
- * Re-used across toolkits since ReportTool is stateless.
+ * `ReportTool` is stateless, so one shared instance is reused across
+ * pools. Pass it as the `terminal` of `agentPool` / `useAgent`. For a
+ * custom description, construct your own via `new ReportTool({...})`.
  *
  * @category Rig
  */
 export declare const reportTool: ReportTool;
-/**
- * Build the standard corpus toolkit.
- *
- * Returns a {@link Toolkit} containing {@link SearchTool},
- * {@link ReadFileTool}, {@link GrepTool}, and {@link ReportTool}
- * wired to the provided resources, chunks, and reranker.
- *
- * @category Rig
- */
-export declare function createTools(opts: {
-    resources: Resource[];
-    chunks: Chunk[];
-    reranker: Reranker;
-}): Toolkit;
 //# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAIxC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACjG,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACjD,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEjF;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,YAAmB,CAAC;AAE3C;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAChC,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;CACpB,GAAG,OAAO,CAOV"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAC/D,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACjD,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEjF;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,YAAmB,CAAC"}

package/dist/tools/index.js

@@ -1,17 +1,28 @@
 "use strict";
+/**
+ * Rig — framework-level tools, search providers, and shared types.
+ *
+ * **Framework tools (consumed by harnesses):**
+ * - {@link reportTool} / {@link ReportTool} — the standard terminal tool.
+ * - {@link DelegateTool} — delegation primitive for sub-agent spawning.
+ * - {@link PlanTool} — grammar-constrained query planner.
+ *
+ * **Search providers (consumed by apps' Source implementations):**
+ * - {@link TavilyProvider} — Tavily-backed web search.
+ * - {@link createKeylessSearchProvider} — keyless DuckDuckGo fallback.
+ *
+ * App-scoped Tool classes (`web_search`, `fetch_page`, `search`,
+ * `read_file`, `grep`) live in `@lloyal-labs/{web,corpus}-app`, not
+ * here — those are unit-of-distribution surfaces under the App
+ * protocol, installed via `harness.dev install`.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.reportTool = exports.taskToContent = exports.PlanTool = exports.DelegateTool = exports.ReportTool = exports.FetchPageTool = exports.TavilyProvider = exports.WebSearchTool = void 0;
-exports.createTools = createTools;
-const lloyal_agents_1 = require("@lloyal-labs/lloyal-agents");
-const search_1 = require("./search");
-const read_file_1 = require("./read-file");
-const grep_1 = require("./grep");
+exports.reportTool = exports.taskToContent = exports.PlanTool = exports.DelegateTool = exports.ReportTool = exports.createKeylessSearchProvider = exports.TavilyProvider = void 0;
 const report_1 = require("./report");
 var web_search_1 = require("./web-search");
-Object.defineProperty(exports, "WebSearchTool", { enumerable: true, get: function () { return web_search_1.WebSearchTool; } });
 Object.defineProperty(exports, "TavilyProvider", { enumerable: true, get: function () { return web_search_1.TavilyProvider; } });
-var fetch_page_1 = require("./fetch-page");
-Object.defineProperty(exports, "FetchPageTool", { enumerable: true, get: function () { return fetch_page_1.FetchPageTool; } });
+var keyless_search_1 = require("./keyless-search");
+Object.defineProperty(exports, "createKeylessSearchProvider", { enumerable: true, get: function () { return keyless_search_1.createKeylessSearchProvider; } });
 var report_2 = require("./report");
 Object.defineProperty(exports, "ReportTool", { enumerable: true, get: function () { return report_2.ReportTool; } });
 var delegate_1 = require("./delegate");
@@ -20,28 +31,13 @@ var plan_1 = require("./plan");
 Object.defineProperty(exports, "PlanTool", { enumerable: true, get: function () { return plan_1.PlanTool; } });
 Object.defineProperty(exports, "taskToContent", { enumerable: true, get: function () { return plan_1.taskToContent; } });
 /**
- * Shared singleton {@link ReportTool} instance.
+ * Shared {@link ReportTool} instance — the conventional terminal tool.
  *
- * Re-used across toolkits since ReportTool is stateless.
+ * `ReportTool` is stateless, so one shared instance is reused across
+ * pools. Pass it as the `terminal` of `agentPool` / `useAgent`. For a
+ * custom description, construct your own via `new ReportTool({...})`.
  *
  * @category Rig
  */
 exports.reportTool = new report_1.ReportTool();
-/**
- * Build the standard corpus toolkit.
- *
- * Returns a {@link Toolkit} containing {@link SearchTool},
- * {@link ReadFileTool}, {@link GrepTool}, and {@link ReportTool}
- * wired to the provided resources, chunks, and reranker.
- *
- * @category Rig
- */
-function createTools(opts) {
-    return (0, lloyal_agents_1.createToolkit)([
-        new search_1.SearchTool(opts.chunks, opts.reranker),
-        new read_file_1.ReadFileTool(opts.resources),
-        new grep_1.GrepTool(opts.resources),
-        exports.reportTool,
-    ]);
-}
 //# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";;;AAoCA,kCAWC;AA/CD,8DAA2D;AAI3D,qCAAsC;AACtC,2CAA2C;AAC3C,iCAAkC;AAClC,qCAAsC;AAEtC,2CAA6D;AAApD,2GAAA,aAAa,OAAA;AAAE,4GAAA,cAAc,OAAA;AACtC,2CAA6C;AAApC,2GAAA,aAAa,OAAA;AACtB,mCAAsC;AAA7B,oGAAA,UAAU,OAAA;AACnB,uCAA0C;AAAjC,wGAAA,YAAY,OAAA;AAGrB,+BAAiD;AAAxC,gGAAA,QAAQ,OAAA;AAAE,qGAAA,aAAa,OAAA;AAGhC;;;;;;GAMG;AACU,QAAA,UAAU,GAAG,IAAI,mBAAU,EAAE,CAAC;AAE3C;;;;;;;;GAQG;AACH,SAAgB,WAAW,CAAC,IAI3B;IACC,OAAO,IAAA,6BAAa,EAAC;QACnB,IAAI,mBAAU,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC;QAC1C,IAAI,wBAAY,CAAC,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,eAAQ,CAAC,IAAI,CAAC,SAAS,CAAC;QAC5B,kBAAU;KACX,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;;AAEH,qCAAsC;AAEtC,2CAA8C;AAArC,4GAAA,cAAc,OAAA;AAEvB,mDAA+D;AAAtD,6HAAA,2BAA2B,OAAA;AAEpC,mCAAsC;AAA7B,oGAAA,UAAU,OAAA;AACnB,uCAA0C;AAAjC,wGAAA,YAAY,OAAA;AAGrB,+BAAiD;AAAxC,gGAAA,QAAQ,OAAA;AAAE,qGAAA,aAAa,OAAA;AAGhC;;;;;;;;GAQG;AACU,QAAA,UAAU,GAAG,IAAI,mBAAU,EAAE,CAAC"}

package/dist/tools/keyless-search.d.ts

@@ -0,0 +1,67 @@
+import type { Operation } from "effection";
+import type { SearchProvider } from "./types";
+/**
+ * Configuration for {@link createKeylessSearchProvider}.
+ *
+ * The defaults are tuned for residential-IP safety: ~1 request every 3–5 s
+ * to the primary engine. Lowering `paceBaseMs` below the default risks
+ * being blocked by DuckDuckGo. Setting it to zero throws at construction.
+ *
+ * @category Rig
+ */
+export interface KeylessSearchOptions {
+    /** Pacer base interval in ms between primary-engine requests. @default 3000 */
+    paceBaseMs?: number;
+    /** Pacer jitter added on top of base (uniform [0, paceJitterMs)). @default 2000 */
+    paceJitterMs?: number;
+    /** Consecutive hard failures before the breaker opens. @default 2 */
+    breakerThreshold?: number;
+    /** Ms the breaker stays open before allowing a half-open probe. @default 15000 */
+    breakerCooldownMs?: number;
+    /** Per-request timeout in ms (must stay below fetch-page's 10s ceiling). @default 8000 */
+    requestTimeoutMs?: number;
+    /** User-Agent header to send to the primary engine. */
+    userAgent?: string;
+    /**
+     * Sleep operation used by the pacer and timeout race. Defaults to
+     * effection's `sleep`. Tests inject a tick-driven mock for determinism.
+     */
+    sleepOp?: (ms: number) => Operation<void>;
+    /** Fetch implementation. Defaults to global `fetch`. Tests inject mocks. */
+    fetchImpl?: typeof fetch;
+}
+/**
+ * Create the keyless, in-process default {@link SearchProvider}.
+ *
+ * Two engines, primary with circuit-broken fallback:
+ *
+ * - **Primary**: DuckDuckGo HTML (`html.duckduckgo.com/html/`). Static,
+ *   no-JS endpoint. Paced behind a shared FIFO request limiter to avoid
+ *   triggering rate-limit responses on a residential IP. Wrapped in a
+ *   circuit breaker that opens on consecutive hard failures (403/429/
+ *   network/timeout) and recovers via a half-open probe after a cooldown.
+ *
+ * - **Fallback**: Marginalia public JSON API (`api2.marginalia-search.com`,
+ *   shared `public` API key via header). Independent niche index;
+ *   shared-key saturation surfaces as 503/429 and is treated as soft-empty.
+ *
+ * Returned results omit the `score` field by design — the upstream
+ * `WebSearchTool` exploit-mode ranking falls back cleanly to entailment-only
+ * when scores are absent, while a fabricated provider score would corrupt
+ * `min(providerScore, entailment)`.
+ *
+ * The provider is bound to the scope where this factory is yielded — the
+ * pacer's central tick loop is halted when that scope exits.
+ *
+ * @example
+ * ```ts
+ * yield* initAgents(ctx);
+ * const provider = yield* createKeylessSearchProvider();
+ * // Inject into an App factory (e.g. createWebApp) that constructs its
+ * // Source bound to the provider + reranker.
+ * ```
+ *
+ * @category Rig
+ */
+export declare function createKeylessSearchProvider(opts?: KeylessSearchOptions): Operation<SearchProvider>;
+//# sourceMappingURL=keyless-search.d.ts.map

package/dist/tools/keyless-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyless-search.d.ts","sourceRoot":"","sources":["../../src/tools/keyless-search.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,KAAK,EAAE,cAAc,EAAgB,MAAM,SAAS,CAAC;AAwB5D;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAoB;IACnC,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kFAAkF;IAClF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,0FAA0F;IAC1F,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,SAAS,CAAC,IAAI,CAAC,CAAC;IAC1C,4EAA4E;IAC5E,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AA0QD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,GAAE,oBAAyB,GAC9B,SAAS,CAAC,cAAc,CAAC,CA8I3B"}