@wenathlan/saddle 1.8.7 → 1.8.9

package/README.md

@@ -6,13 +6,13 @@
   <strong>Storage-backed jobs, scraping contracts and portable runners for Node.js.</strong><br/>
   <strong>Binary computing engine, agent browser, scraper and packager.</strong><br/>
   <a href="https://github.com/wenathlan/saddle/actions/workflows/ci.yml"><img src="https://github.com/wenathlan/saddle/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
-  <a href="https://github.com/wenathlan/saddle/releases/tag/v1.8.7"><img src="https://img.shields.io/badge/release-v1.8.7-d35d3d" alt="Release 1.8.7" /></a>
+  <a href="https://github.com/wenathlan/saddle/releases/tag/v1.8.9"><img src="https://img.shields.io/badge/release-v1.8.9-d35d3d" alt="Release 1.8.9" /></a>
   <a href="https://github.com/wenathlan/saddle/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-GPL--3.0-202a2f" alt="GPL 3.0 license" /></a>
 </p>
 
 > **Core idea:** storage is the durable side of the working set; the runner is replaceable; the artifact is the boundary. **Storage == Compute** means that the same bytes can be retained or processed according to an explicit usage flag.
 
-Saddle is a **JavaScript ESM engine** for jobs that move data between storage, a bounded working set, a caller-injected runner and durable artifacts. It is also a virtual machine published as a package: the caller can run it on GitHub Actions, Forgejo, Gitea, GitLab, Codeberg, Docker or another third-party compute surface. The engine does not require the operator's local machine, does not embed credentials and does not choose a mandatory cloud provider.
+Saddle is a **TypeScript-first ESM engine** compiled to JavaScript, declarations and source maps for jobs that move data between storage, a bounded working set, a caller-injected runner and durable artifacts. It is also a virtual machine published as a package: the caller can run it on GitHub Actions, Forgejo, Gitea, GitLab, Codeberg, Docker or another third-party compute surface. The engine does not require the operator's local machine, does not embed credentials and does not choose a mandatory cloud provider.
 
 The canonical JavaScript package is `@wenathlan/saddle`. GitHub Packages npm, Maven and GHCR use the `wenathlan` owner namespace; NuGet and RubyGems retain their ecosystem package names. Older `@devthink`, `@iakadion` and `io.devthink` references in archived documents are historical records, not current package identities.
 
@@ -36,7 +36,7 @@ console.log(context.summary);
 The deterministic examples and tests do not require network access or real credentials:
 
 ```bash
-node examples/publicapi.js
+node --import tsx examples/publicapi.ts
 npm test
 ```
 
@@ -78,7 +78,7 @@ The root entry point is transport-neutral. Node filesystem, HTTP server, persist
 
 ### Productization: one engine, many shells
 
-The same contracts can be surfaced as an npm library, CLI, binary, Manifest V3 browser extension, webhook server, MCP transport, workflow action, container image, Maven package, NuGet package or RubyGem. These surfaces are adapters around the engine; they are not separate sources of truth.
+The same contracts can be surfaced as an npm library, application archive, computer runtime, desktop installer, Android APK/AAB, iOS IPA, CLI, binary, browser package, Manifest V3 extension, web/PWA artifact, LibreOffice OXT, VSIX, webhook server, MCP transport, workflow action, container image, Maven package, NuGet package or RubyGem. These surfaces are declarative target plans and caller-owned adapters around the engine; they are not separate sources of truth.
 
 ## Public API
 
@@ -102,14 +102,14 @@ The complete export map is documented in [`docs/libraryapi.md`](docs/libraryapi.
 
 ## Browser extension
 
-The extension is a pure JavaScript Manifest V3 reference surface in [`extension/`](extension/). It contains a popup, service worker, isolated content bridge, read-only page-world `pagefacts` boundary, snapshot diffs and persisted window/tab/frame context for explicit resume.
+The extension is a TypeScript-first Manifest V3 reference surface in [`extension/`](extension/). Its source is compiled into a stable JavaScript unpacked artifact and contains a popup, service worker, isolated content bridge, read-only page-world `pagefacts` boundary, snapshot diffs and persisted window/tab/frame context for explicit resume.
 
 ```bash
-# load the unpacked extension from chrome://extensions
-ls extension/manifest.json extension/worker.js extension/content.js extension/popup.html
-
-# build an isolated artifact using the version supplied by the caller or release tag
+# build an isolated JavaScript artifact using the version supplied by the caller or release tag
 npm run extension:build -- --output build/extension
+
+# load build/extension from chrome://extensions
+ls build/extension/manifest.json build/extension/worker.js build/extension/content.js build/extension/popup.html
 ```
 
 The base permission set is `activeTab`, `scripting` and `storage`. It does not request broad host permissions, cookies, `webRequest`, debugger access or arbitrary page code execution. Optional host escalation remains caller-owned. Releases attach `saddle-extension-<version>.zip`; cross-browser profiles remain adapter work.
@@ -127,7 +127,7 @@ The base permission set is `activeTab`, `scripting` and `storage`. It does not r
 | Failure | retry, circuit breaker, idempotency and resume are configurable |
 | Releases | version comes from the `vX.Y.Z` tag and must match `package.json` |
 
-Version 1.8.7 also removes the obsolete nested `scrape` package manifests and lockfile that generated a separate stale dependency graph. The dependency-free JavaScript scrape contracts remain in `scrape/`. The root lockfile is regenerated and CI runs `npm audit --audit-level=high` plus dependency review for pull requests. See [`docs/securityaudit-1.8.7.md`](docs/securityaudit-1.8.7.md) for the baseline and remediation record.
+Version 1.8.9 makes the active source TypeScript-first, compiles it into ignored `dist/`, and keeps public JavaScript package paths stable. It also adds declarative target plans for mobile, desktop, browser, binary and document-extension formats. The dynamic debug collector is intentionally an unchecked browser boundary because it monkey-patches browser APIs; the rest of the web surface remains strictly typechecked. See [`docs/reorganization-1.8.9.md`](docs/reorganization-1.8.9.md), [`docs/toolchainresearch-1.8.9.md`](docs/toolchainresearch-1.8.9.md) and [`docs/securityaudit-1.8.7.md`](docs/securityaudit-1.8.7.md).
 
 ## Package surfaces and release automation
 
@@ -153,7 +153,7 @@ npm run web:check
 VITE_BASE_PATH=/saddle npm run web:build:pages
 ```
 
-Small public configuration and visual assets live under `web/public/`. The development collector is `web/public/debugcollector.js` and uses `/debuglogs`; it is not part of the production build. The obsolete `web/public/__manus__` directory is intentionally absent.
+Small public configuration and visual assets live under `web/public/`. The development collector is TypeScript source at `web/lib/debugcollector.ts`, injected only in development, and uses `/debuglogs`; it is not part of the production build. The obsolete `web/public/__manus__` directory is intentionally absent.
 
 ## Development and release gates
 
@@ -173,25 +173,25 @@ The engine test suite is deterministic and does not require real credentials or
 ## Repository map
 
 ```text
-core/          errors, events, identifiers and hashing
+core/          engine errors, scrape error taxonomy, events, identifiers and hashing
 domain/        jobs, artifacts, sessions and providers
 memory/        working-set bridge, modes, objects and transforms
 storage/       local, chunked, remote and file-hosting adapters
-scrape/        dependency-free robots, cache, extraction, schema and normalization contracts
-crawl/         URL normalization, crawler and persistent frontier
+scrape/        robots, cache, extraction, schema, normalization and grouped crawl contracts
 queue/         queue, idempotency, saga and recovery
 browser/       fingerprint, session, agent and Playwright adapter contracts
 extension/     Manifest V3 reference surface and packager
 protocol/      JSON, NDJSON, SSE and block serializers
 workflow/      manifests, templates and registry contracts
-packager/      package and publication plans
 release/       checksums, SBOM and provenance metadata
-web/           root-based static marketing site
+runtime/       engine orchestration, capability detection, worker and grouped retry context
+packager/      dist, binary, container and multi-target artifact plans
+web/           root-based static marketing site with TypeScript React source
 tests/         deterministic engine and extension coverage
 docs/          architecture, API, security, release and registry notes
 ```
 
-The engine remains pure JavaScript ESM with JSDoc comments in English. The web surface is TypeScript/React, while the published library has no TypeScript build requirement and no hardcoded host, port or credential.
+The engine is TypeScript-first ESM with English JSDoc comments and a generated JavaScript `dist/` publication surface. The web surface is TypeScript/React, and no source or generated artifact hardcodes a host, port or credential.
 
 ## Historical documentation
 
@@ -199,7 +199,7 @@ Earlier README snapshots remain in `docs/plans/README.md`, `docs/talks9/README.m
 
 ## Current scope
 
-Version 1.8.7 extends the 1.8.6 engine with dependency remediation, explicit security gates, base-aware Pages assets, removal of the obsolete public debug directory and consolidated documentation. Browser binaries, provider credentials, n8n host registration, persistent databases, captcha solvers and production deployment remain caller-selected adapters. Future work should extend contracts without coupling the core to one forge, registry, browser or storage vendor.
+Version 1.8.9 extends the 1.8.8 engine with TypeScript-first source conversion, dist-only compilation, target-plan manifests and web source consolidation. Browser binaries, provider credentials, n8n host registration, persistent databases, captcha solvers and production deployment remain caller-selected adapters. Future work should extend contracts without coupling the core to one forge, registry, browser or storage vendor.
 
 ## License
 

package/dist/adapters/forge.d.ts

@@ -0,0 +1,17 @@
+export declare function forgeadapter(options?: {}): {
+    kind: any;
+    health(path?: string): Promise<{
+        ok: any;
+        status: any;
+    }>;
+    dispatch(spec: any): Promise<{
+        accepted: any;
+        status: any;
+        body: any;
+    }>;
+    upload(spec: any): Promise<{
+        accepted: any;
+        status: any;
+    }>;
+};
+//# sourceMappingURL=forge.d.ts.map

package/dist/adapters/forge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forge.d.ts","sourceRoot":"","sources":["../../adapters/forge.ts"],"names":[],"mappings":"AAKA,wBAAgB,YAAY,CAAC,OAAO,KAAK;;;;;;;;;;;;;;;EAUxC"}

package/dist/adapters/forge.js

@@ -0,0 +1,19 @@
+/**
+ * forge adapter defines the common dispatch and artifact surface for compatible forges.
+ */
+import { transport } from "./transport.js";
+export function forgeadapter(options = {}) {
+    if (!options.baseurl || typeof options.token !== "function")
+        throw new TypeError("forge adapter requires baseurl and token function");
+    const client = transport({ fetcher: options.fetcher, attempts: options.attempts, timeout: options.timeout });
+    async function call(path, init = {}) { const token = await options.token(); return client.request(new URL(path, options.baseurl), { ...init, headers: { authorization: `Bearer ${token}`, accept: "application/json", ...(init.headers ?? {}) } }); }
+    return {
+        kind: options.kind ?? "forge",
+        async health(path = "/") { const response = await call(path); return { ok: response.ok, status: response.status }; },
+        async dispatch(spec) { if (!spec?.path || !spec.ref)
+            throw new TypeError("forge dispatch requires path and ref"); const response = await call(spec.path, { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify({ ref: spec.ref, inputs: spec.inputs ?? {} }) }); return { accepted: response.ok, status: response.status, body: response.json ? await response.json() : undefined }; },
+        async upload(spec) { if (!spec?.path || !spec.data)
+            throw new TypeError("forge upload requires path and data"); const response = await call(spec.path, { method: "PUT", headers: { "content-type": spec.contenttype ?? "application/octet-stream" }, body: spec.data }); return { accepted: response.ok, status: response.status }; }
+    };
+}
+//# sourceMappingURL=forge.js.map

package/dist/adapters/forge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forge.js","sourceRoot":"","sources":["../../adapters/forge.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,MAAM,UAAU,YAAY,CAAC,OAAO,GAAG,EAAE;IACvC,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,UAAU;QAAE,MAAM,IAAI,SAAS,CAAC,mDAAmD,CAAC,CAAC;IACtI,MAAM,MAAM,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7G,KAAK,UAAU,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,IAAI,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,KAAK,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACrP,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,OAAO;QAC7B,KAAK,CAAC,MAAM,CAAC,IAAI,GAAG,GAAG,IAAI,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACpH,KAAK,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,SAAS,CAAC,sCAAsC,CAAC,CAAC,CAAC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QACxZ,KAAK,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,SAAS,CAAC,qCAAqC,CAAC,CAAC,CAAC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,IAAI,CAAC,WAAW,IAAI,0BAA0B,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;KACtU,CAAC;AACJ,CAAC"}

package/dist/adapters/forgejo.d.ts

@@ -0,0 +1,49 @@
+export declare function forgejoadapter(options?: {}): {
+    kind: any;
+    health(path?: string): Promise<{
+        ok: any;
+        status: any;
+    }>;
+    dispatch(spec: any): Promise<{
+        accepted: any;
+        status: any;
+        body: any;
+    }>;
+    upload(spec: any): Promise<{
+        accepted: any;
+        status: any;
+    }>;
+};
+export declare function giteaadapter(options?: {}): {
+    kind: any;
+    health(path?: string): Promise<{
+        ok: any;
+        status: any;
+    }>;
+    dispatch(spec: any): Promise<{
+        accepted: any;
+        status: any;
+        body: any;
+    }>;
+    upload(spec: any): Promise<{
+        accepted: any;
+        status: any;
+    }>;
+};
+export declare function codebergadapter(options?: {}): {
+    kind: any;
+    health(path?: string): Promise<{
+        ok: any;
+        status: any;
+    }>;
+    dispatch(spec: any): Promise<{
+        accepted: any;
+        status: any;
+        body: any;
+    }>;
+    upload(spec: any): Promise<{
+        accepted: any;
+        status: any;
+    }>;
+};
+//# sourceMappingURL=forgejo.d.ts.map

package/dist/adapters/forgejo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forgejo.d.ts","sourceRoot":"","sources":["../../adapters/forgejo.ts"],"names":[],"mappings":"AAKA,wBAAgB,cAAc,CAAC,OAAO,KAAK;;;;;;;;;;;;;;;EAA2D;AACtG,wBAAgB,YAAY,CAAC,OAAO,KAAK;;;;;;;;;;;;;;;EAAyD;AAClG,wBAAgB,eAAe,CAAC,OAAO,KAAK;;;;;;;;;;;;;;;EAA4D"}

package/{adapters → dist/adapters}/forgejo.js

@@ -2,7 +2,7 @@
  * forgejo and gitea can reuse the open forge contract with a caller supplied base url.
  */
 import { forgeadapter } from "./forge.js";
-
 export function forgejoadapter(options = {}) { return forgeadapter({ ...options, kind: "forgejo" }); }
 export function giteaadapter(options = {}) { return forgeadapter({ ...options, kind: "gitea" }); }
 export function codebergadapter(options = {}) { return forgeadapter({ ...options, kind: "codeberg" }); }
+//# sourceMappingURL=forgejo.js.map

package/dist/adapters/forgejo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forgejo.js","sourceRoot":"","sources":["../../adapters/forgejo.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,UAAU,cAAc,CAAC,OAAO,GAAG,EAAE,IAAI,OAAO,YAAY,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;AACtG,MAAM,UAAU,YAAY,CAAC,OAAO,GAAG,EAAE,IAAI,OAAO,YAAY,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;AAClG,MAAM,UAAU,eAAe,CAAC,OAAO,GAAG,EAAE,IAAI,OAAO,YAAY,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC"}

package/dist/adapters/github.d.ts

@@ -0,0 +1,12 @@
+export declare function githubadapter(options?: {}): {
+    health(): Promise<{
+        ok: any;
+        status: any;
+    }>;
+    dispatch(owner: any, repository: any, workflow: any, input?: {}): Promise<{
+        accepted: boolean;
+        status: any;
+    }>;
+    run(owner: any, repository: any, runid: any): Promise<any>;
+};
+//# sourceMappingURL=github.d.ts.map

package/dist/adapters/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../adapters/github.ts"],"names":[],"mappings":"AAKA,wBAAgB,aAAa,CAAC,OAAO,KAAK;;;;;;;;;;EAazC"}

package/dist/adapters/github.js

@@ -0,0 +1,20 @@
+/**
+ * github adapter uses caller supplied credentials and base url configuration.
+ */
+import { transport } from "./transport.js";
+export function githubadapter(options = {}) {
+    if (!options.baseurl || typeof options.token !== "function")
+        throw new TypeError("github adapter requires baseurl and token function");
+    const client = transport({ fetcher: options.fetcher, attempts: options.attempts, timeout: options.timeout });
+    async function call(path, init = {}) {
+        const token = await options.token();
+        const headers = { accept: "application/vnd.github+json", authorization: `Bearer ${token}`, "x-github-api-version": options.apiversion ?? "2022-11-28", ...(init.headers ?? {}) };
+        return client.request(new URL(path, options.baseurl), { ...init, headers });
+    }
+    return {
+        async health() { const response = await call("/rate_limit"); return { ok: response.ok, status: response.status }; },
+        async dispatch(owner, repository, workflow, input = {}) { const response = await call(`/repos/${owner}/${repository}/actions/workflows/${workflow}/dispatches`, { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify({ ref: input.ref ?? "main", inputs: input.inputs ?? {} }) }); return { accepted: response.status === 204, status: response.status }; },
+        async run(owner, repository, runid) { const response = await call(`/repos/${owner}/${repository}/actions/runs/${runid}`); return response.json(); }
+    };
+}
+//# sourceMappingURL=github.js.map

package/dist/adapters/github.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.js","sourceRoot":"","sources":["../../adapters/github.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,MAAM,UAAU,aAAa,CAAC,OAAO,GAAG,EAAE;IACxC,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,UAAU;QAAE,MAAM,IAAI,SAAS,CAAC,oDAAoD,CAAC,CAAC;IACvI,MAAM,MAAM,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7G,KAAK,UAAU,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE;QACjC,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,EAAE,MAAM,EAAE,6BAA6B,EAAE,aAAa,EAAE,UAAU,KAAK,EAAE,EAAE,sBAAsB,EAAE,OAAO,CAAC,UAAU,IAAI,YAAY,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;QACjL,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO;QACL,KAAK,CAAC,MAAM,KAAK,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACnH,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,GAAG,EAAE,IAAI,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,KAAK,IAAI,UAAU,sBAAsB,QAAQ,aAAa,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC9X,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,IAAI,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,KAAK,IAAI,UAAU,iBAAiB,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;KACpJ,CAAC;AACJ,CAAC"}

package/dist/adapters/gitlab.d.ts

@@ -0,0 +1,17 @@
+export declare function gitlabadapter(options?: {}): {
+    kind: any;
+    health(path?: string): Promise<{
+        ok: any;
+        status: any;
+    }>;
+    upload(spec: any): Promise<{
+        accepted: any;
+        status: any;
+    }>;
+    dispatch(spec: any): Promise<{
+        accepted: any;
+        status: any;
+        body: any;
+    }>;
+};
+//# sourceMappingURL=gitlab.d.ts.map

package/dist/adapters/gitlab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitlab.d.ts","sourceRoot":"","sources":["../../adapters/gitlab.ts"],"names":[],"mappings":"AAKA,wBAAgB,aAAa,CAAC,OAAO,KAAK;;;;;;;;;;;;;;;EAIzC"}

package/dist/adapters/gitlab.js

@@ -0,0 +1,10 @@
+/**
+ * gitlab adapter keeps project addressing and token ownership outside the package.
+ */
+import { forgeadapter } from "./forge.js";
+export function gitlabadapter(options = {}) {
+    const project = encodeURIComponent(options.project ?? "");
+    const base = forgeadapter({ ...options, kind: "gitlab" });
+    return { ...base, async dispatch(spec) { return base.dispatch({ ...spec, path: spec.path ?? `/api/v4/projects/${project}/pipeline` }); } };
+}
+//# sourceMappingURL=gitlab.js.map

package/dist/adapters/gitlab.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitlab.js","sourceRoot":"","sources":["../../adapters/gitlab.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,UAAU,aAAa,CAAC,OAAO,GAAG,EAAE;IACxC,MAAM,OAAO,GAAG,kBAAkB,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,YAAY,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC1D,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,oBAAoB,OAAO,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC7I,CAAC"}

package/dist/adapters/huggingface.d.ts

@@ -0,0 +1,17 @@
+export declare function huggingfaceadapter(options?: {}): {
+    kind: any;
+    health(path?: string): Promise<{
+        ok: any;
+        status: any;
+    }>;
+    dispatch(spec: any): Promise<{
+        accepted: any;
+        status: any;
+        body: any;
+    }>;
+    upload(spec: any): Promise<{
+        accepted: any;
+        status: any;
+    }>;
+};
+//# sourceMappingURL=huggingface.d.ts.map

package/dist/adapters/huggingface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"huggingface.d.ts","sourceRoot":"","sources":["../../adapters/huggingface.ts"],"names":[],"mappings":"AAKA,wBAAgB,kBAAkB,CAAC,OAAO,KAAK;;;;;;;;;;;;;;;EAA+D"}

package/{adapters → dist/adapters}/huggingface.js

@@ -2,5 +2,5 @@
  * hugging face storage remains an explicit adapter with caller supplied repository path.
  */
 import { forgeadapter } from "./forge.js";
-
 export function huggingfaceadapter(options = {}) { return forgeadapter({ ...options, kind: "huggingface" }); }
+//# sourceMappingURL=huggingface.js.map

package/dist/adapters/huggingface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"huggingface.js","sourceRoot":"","sources":["../../adapters/huggingface.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,UAAU,kBAAkB,CAAC,OAAO,GAAG,EAAE,IAAI,OAAO,YAAY,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC"}

package/dist/adapters/socket.d.ts

@@ -0,0 +1,11 @@
+/**
+ * socket adapter keeps realtime optional and accepts a caller supplied websocket constructor.
+ */
+export declare function socketadapter(options?: {}): {
+    connect(url: any, protocols: any): {
+        socket: any;
+        send(value: any): void;
+        close(code: any, reason: any): void;
+    };
+};
+//# sourceMappingURL=socket.d.ts.map

package/dist/adapters/socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../adapters/socket.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,KAAK;;;;;;EAUzC"}

package/dist/adapters/socket.js

@@ -0,0 +1,17 @@
+/**
+ * socket adapter keeps realtime optional and accepts a caller supplied websocket constructor.
+ */
+export function socketadapter(options = {}) {
+    const websocket = options.websocket ?? globalThis.WebSocket;
+    if (!websocket)
+        throw new Error("websocket implementation is required");
+    return {
+        connect(url, protocols) {
+            if (!url)
+                throw new TypeError("socket url is required");
+            const socket = new websocket(url, protocols);
+            return { socket, send(value) { socket.send(typeof value === "string" ? value : JSON.stringify(value)); }, close(code, reason) { socket.close(code, reason); } };
+        }
+    };
+}
+//# sourceMappingURL=socket.js.map

package/dist/adapters/socket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.js","sourceRoot":"","sources":["../../adapters/socket.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAAO,GAAG,EAAE;IACxC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,UAAU,CAAC,SAAS,CAAC;IAC5D,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IACxE,OAAO;QACL,OAAO,CAAC,GAAG,EAAE,SAAS;YACpB,IAAI,CAAC,GAAG;gBAAE,MAAM,IAAI,SAAS,CAAC,wBAAwB,CAAC,CAAC;YACxD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAC7C,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAClK,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/adapters/transport.d.ts

@@ -0,0 +1,7 @@
+/**
+ * transport centralizes timeout retry and jitter without choosing a host or vendor.
+ */
+export declare function transport(options?: {}): {
+    request: (url: any, init?: {}) => Promise<any>;
+};
+//# sourceMappingURL=transport.d.ts.map

package/dist/adapters/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../adapters/transport.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,KAAK;;EAuBrC"}

package/dist/adapters/transport.js

@@ -0,0 +1,36 @@
+/**
+ * transport centralizes timeout retry and jitter without choosing a host or vendor.
+ */
+export function transport(options = {}) {
+    const fetcher = options.fetcher ?? fetch;
+    const attempts = options.attempts ?? 3;
+    const timeout = options.timeout ?? 30000;
+    const retrycodes = new Set(options.retrycodes ?? [408, 409, 429, 500, 502, 503, 504]);
+    async function request(url, init = {}) {
+        let last;
+        for (let attempt = 0; attempt < attempts; attempt += 1) {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), timeout);
+            try {
+                const response = await fetcher(url, { ...init, signal: init.signal ?? controller.signal });
+                if (response.ok || !retrycodes.has(response.status) || attempt === attempts - 1)
+                    return response;
+                last = new Error(`request failed with ${response.status}`);
+            }
+            catch (error) {
+                last = error;
+                if (attempt === attempts - 1)
+                    throw error;
+            }
+            finally {
+                clearTimeout(timer);
+            }
+            await delay(backoff(options, attempt));
+        }
+        throw last ?? new Error("request failed");
+    }
+    return { request };
+}
+function backoff(options, attempt) { const base = options.backoff ?? 250; const jitter = options.jitter ?? 0; return base * 2 ** attempt + Math.floor(Math.random() * jitter); }
+function delay(milliseconds) { return new Promise((resolve) => setTimeout(resolve, milliseconds)); }
+//# sourceMappingURL=transport.js.map

package/dist/adapters/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../adapters/transport.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,OAAO,GAAG,EAAE;IACpC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC;IACzC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC;IACzC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IACtF,KAAK,UAAU,OAAO,CAAC,GAAG,EAAE,IAAI,GAAG,EAAE;QACnC,IAAI,IAAI,CAAC;QACT,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,QAAQ,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;YACvD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;YAC5D,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC3F,IAAI,QAAQ,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,OAAO,KAAK,QAAQ,GAAG,CAAC;oBAAE,OAAO,QAAQ,CAAC;gBACjG,IAAI,GAAG,IAAI,KAAK,CAAC,uBAAuB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC7D,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,GAAG,KAAK,CAAC;gBACb,IAAI,OAAO,KAAK,QAAQ,GAAG,CAAC;oBAAE,MAAM,KAAK,CAAC;YAC5C,CAAC;oBAAS,CAAC;gBAAC,YAAY,CAAC,KAAK,CAAC,CAAC;YAAC,CAAC;YAClC,MAAM,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QACzC,CAAC;QACD,MAAM,IAAI,IAAI,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC;AAED,SAAS,OAAO,CAAC,OAAO,EAAE,OAAO,IAAI,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,IAAI,GAAG,CAAC,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,GAAG,CAAC,IAAI,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;AAChL,SAAS,KAAK,CAAC,YAAY,IAAI,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/ai/chunk.d.ts

@@ -0,0 +1,2 @@
+export declare function chunkmarkdown(markdown: any, options?: {}): any[];
+//# sourceMappingURL=chunk.d.ts.map

package/dist/ai/chunk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk.d.ts","sourceRoot":"","sources":["../../ai/chunk.ts"],"names":[],"mappings":"AAKA,wBAAgB,aAAa,CAAC,QAAQ,KAAA,EAAE,OAAO,KAAK,SAgBnD"}

package/dist/ai/chunk.js

@@ -0,0 +1,36 @@
+/**
+ * markdown chunking preserves heading paths and uses paragraph boundaries before hard cuts.
+ */
+import { estimatetokens } from "./tokens.js";
+export function chunkmarkdown(markdown, options = {}) {
+    const maxtokens = options.maxtokens ?? 512;
+    const overlap = options.overlaptokens ?? 50;
+    const lines = String(markdown ?? "").split(/\r?\n/);
+    const chunks = [];
+    let headingpath = [];
+    let buffer = [];
+    function flush() { if (!buffer.length)
+        return; const content = buffer.join("\n").trim(); if (content)
+        chunks.push({ content, headingpath: [...headingpath], tokencount: estimatetokens(content, options.model) }); buffer = []; }
+    for (const line of lines) {
+        const heading = line.match(/^(#{1,6})\s+(.+)$/);
+        if (heading) {
+            flush();
+            const level = heading[1].length;
+            headingpath = headingpath.slice(0, level - 1);
+            headingpath[level - 1] = heading[2].trim();
+            buffer.push(line);
+            continue;
+        }
+        buffer.push(line);
+        if (estimatetokens(buffer.join("\n"), options.model) > maxtokens) {
+            const last = buffer.pop();
+            flush();
+            const overlaptext = buffer.slice(-overlap).join("\n");
+            buffer = overlaptext ? [overlaptext, last] : [last];
+        }
+    }
+    flush();
+    return chunks.map((chunk, index) => ({ ...chunk, id: `chunk${index}` }));
+}
+//# sourceMappingURL=chunk.js.map

package/dist/ai/chunk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk.js","sourceRoot":"","sources":["../../ai/chunk.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,UAAU,aAAa,CAAC,QAAQ,EAAE,OAAO,GAAG,EAAE;IAClD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,GAAG,CAAC;IAC3C,MAAM,OAAO,GAAG,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC;IAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,EAAE,CAAC;IAClB,IAAI,WAAW,GAAG,EAAE,CAAC;IACrB,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,SAAS,KAAK,KAAK,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,CAAC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,OAAO;QAAE,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,GAAG,WAAW,CAAC,EAAE,UAAU,EAAE,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC;IACjO,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAChD,IAAI,OAAO,EAAE,CAAC;YAAC,KAAK,EAAE,CAAC;YAAC,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YAAC,WAAW,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;YAAC,WAAW,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAAC,SAAS;QAAC,CAAC;QAClL,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClB,IAAI,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,SAAS,EAAE,CAAC;YAAC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC;YAAC,KAAK,EAAE,CAAC;YAAC,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAAC,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAAC,CAAC;IACvN,CAAC;IACD,KAAK,EAAE,CAAC;IACR,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,QAAQ,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3E,CAAC"}

package/dist/ai/llmstxt.d.ts

@@ -0,0 +1,6 @@
+/**
+ * llms text generation creates compact absolute links for agent consumption.
+ */
+export declare function llmstxt(options?: {}): string;
+export declare function llmsfull(options?: {}): any;
+//# sourceMappingURL=llmstxt.d.ts.map

package/dist/ai/llmstxt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llmstxt.d.ts","sourceRoot":"","sources":["../../ai/llmstxt.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,KAAK,UAMnC;AAED,wBAAgB,QAAQ,CAAC,OAAO,KAAK,OAAgN"}

package/dist/ai/llmstxt.js

@@ -0,0 +1,12 @@
+/**
+ * llms text generation creates compact absolute links for agent consumption.
+ */
+export function llmstxt(options = {}) {
+    const title = options.title ?? "saddle";
+    const description = options.description ?? "binary computing engine and browser automation library";
+    const pages = (options.pages ?? []).filter((page) => page?.url && /^https:\/\//.test(page.url)).slice(0, options.limit ?? 100);
+    const lines = [`# ${title}`, `> ${description}`, "", "## pages", "", ...pages.map((page) => `- [${page.title ?? page.url}](${page.url}): ${(page.description ?? "").slice(0, 100)}`)];
+    return `${lines.join("\n")}\n`;
+}
+export function llmsfull(options = {}) { return (options.pages ?? []).filter((page) => page?.url && /^https:\/\//.test(page.url)).map((page) => `# ${page.title ?? page.url}\n\nsource: ${page.url}\n\n${page.content ?? ""}`).join("\n\n---\n\n"); }
+//# sourceMappingURL=llmstxt.js.map

package/dist/ai/llmstxt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llmstxt.js","sourceRoot":"","sources":["../../ai/llmstxt.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,OAAO,GAAG,EAAE;IAClC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,QAAQ,CAAC;IACxC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,wDAAwD,CAAC;IACpG,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC;IAC/H,MAAM,KAAK,GAAG,CAAC,KAAK,KAAK,EAAE,EAAE,KAAK,WAAW,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACtL,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAO,GAAG,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,eAAe,IAAI,CAAC,GAAG,OAAO,IAAI,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC"}

package/dist/ai/provenance.d.ts

@@ -0,0 +1,22 @@
+/**
+ * context provenance links retrieved chunks to source, query and transformation metadata.
+ */
+/** Creates a serializable retrieval record for an agent context result. */
+export declare function provenance(input?: {}): {
+    version: number;
+    source: any;
+    sourceurl: any;
+    documentid: any;
+    query: any;
+    retrievedat: number;
+    chunks: any;
+    metadata: any;
+};
+/** Merges provenance records while deduplicating chunk identifiers. */
+export declare function mergeprovenance(records?: any[]): {
+    version: number;
+    sources: any[];
+    chunks: any[];
+    mergedat: number;
+};
+//# sourceMappingURL=provenance.d.ts.map

package/dist/ai/provenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provenance.d.ts","sourceRoot":"","sources":["../../ai/provenance.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,KAAK,KAAK;IAE1B,OAAO;IAAK,MAAM;IAAmC,SAAS;IAAmB,UAAU;IAAoB,KAAK;IAAe,WAAW;IAA2C,MAAM;IAA6T,QAAQ;EAC9gB;AAED,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,OAAO,QAAK;;;;;EAM3C"}

package/dist/ai/provenance.js

@@ -0,0 +1,25 @@
+/**
+ * context provenance links retrieved chunks to source, query and transformation metadata.
+ */
+/** Creates a serializable retrieval record for an agent context result. */
+export function provenance(input = {}) {
+    if (!input.source && !input.sourceurl)
+        throw new TypeError("provenance requires a source");
+    return { version: 1, source: input.source ?? input.sourceurl, sourceurl: input.sourceurl, documentid: input.documentid, query: input.query, retrievedat: Number(input.retrievedat ?? Date.now()), chunks: Array.isArray(input.chunks) ? input.chunks.map((chunk, index) => ({ id: String(chunk.id ?? index), contenthash: chunk.contenthash, score: chunk.score === undefined ? undefined : Number(chunk.score), headingpath: chunk.headingpath, tokencount: chunk.tokencount, citation: chunk.citation ?? input.sourceurl })) : [], metadata: { ...(input.metadata ?? {}) } };
+}
+/** Merges provenance records while deduplicating chunk identifiers. */
+export function mergeprovenance(records = []) {
+    const valid = records.filter(Boolean);
+    const chunks = [];
+    const seen = new Set();
+    for (const record of valid)
+        for (const chunk of record.chunks ?? []) {
+            const key = `${record.documentid ?? record.source}:${chunk.id}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            chunks.push({ ...chunk, source: record.source, documentid: record.documentid });
+        }
+    return { version: 1, sources: [...new Set(valid.map((record) => record.source))], chunks, mergedat: Date.now() };
+}
+//# sourceMappingURL=provenance.js.map

package/dist/ai/provenance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provenance.js","sourceRoot":"","sources":["../../ai/provenance.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,2EAA2E;AAC3E,MAAM,UAAU,UAAU,CAAC,KAAK,GAAG,EAAE;IACnC,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS;QAAE,MAAM,IAAI,SAAS,CAAC,8BAA8B,CAAC,CAAC;IAC3F,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,KAAK,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;AACjjB,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,eAAe,CAAC,OAAO,GAAG,EAAE;IAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,EAAE,CAAC;IAClB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;IACvB,KAAK,MAAM,MAAM,IAAI,KAAK;QAAE,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;YAAC,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,MAAM,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;YAAC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS;YAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAAC,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QAAC,CAAC;IACtQ,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;AACnH,CAAC"}

package/dist/ai/rag.d.ts

@@ -0,0 +1,26 @@
+/**
+ * rag manifests connect chunks to embedding stores without forcing a vendor client.
+ */
+export declare function ragmanifest(input?: {}): Promise<{
+    documentid: string;
+    source: any;
+    chunks: any[];
+    embeddingmodel: any;
+    embeddingdimensions: any;
+    createdat: number;
+}>;
+export declare function vectorrecord(chunk: any, vector: any, options?: {}): {
+    id: string;
+    vector: any;
+    metadata: {
+        headingpath: any;
+        contenthash: any;
+        sourceurl: any;
+        tokencount: any;
+        contenttype: any;
+        language: any;
+        embeddingmodel: any;
+        embeddingdimensions: any;
+    };
+};
+//# sourceMappingURL=rag.d.ts.map