@wenathlan/saddle 1.8.7 → 1.8.9

package/dist/surfaces/targets.d.ts

@@ -0,0 +1,196 @@
+/**
+ * target profiles keep platform packaging open and describe capability boundaries.
+ */
+export declare const targetprofiles: Readonly<{
+    application: {
+        runtime: string;
+        entry: string;
+        capabilities: string[];
+        formats: string[];
+    };
+    computer: {
+        runtime: string;
+        entry: string;
+        capabilities: string[];
+        formats: string[];
+    };
+    desktopapp: {
+        runtime: string;
+        entry: string;
+        capabilities: string[];
+        formats: string[];
+    };
+    mobileapp: {
+        runtime: string;
+        entry: string;
+        capabilities: string[];
+        formats: string[];
+    };
+    android: {
+        runtime: string;
+        entry: string;
+        capabilities: string[];
+        formats: string[];
+    };
+    ios: {
+        runtime: string;
+        entry: string;
+        capabilities: string[];
+        formats: string[];
+    };
+    cli: {
+        runtime: string;
+        entry: string;
+        capabilities: string[];
+        formats: string[];
+    };
+    binary: {
+        runtime: string;
+        entry: string;
+        capabilities: string[];
+        formats: string[];
+    };
+    browser: {
+        runtime: string;
+        entry: string;
+        capabilities: string[];
+        formats: string[];
+    };
+    extension: {
+        runtime: string;
+        entry: string;
+        capabilities: string[];
+        formats: string[];
+    };
+    internet: {
+        runtime: string;
+        entry: string;
+        capabilities: string[];
+        formats: string[];
+    };
+    web: {
+        runtime: string;
+        entry: string;
+        capabilities: string[];
+        formats: string[];
+    };
+    libreoffice: {
+        runtime: string;
+        entry: string;
+        capabilities: string[];
+        formats: string[];
+    };
+    mcp: {
+        runtime: string;
+        entry: string;
+        capabilities: string[];
+        formats: string[];
+    };
+    vsix: {
+        runtime: string;
+        entry: string;
+        capabilities: string[];
+        formats: string[];
+    };
+    container: {
+        runtime: string;
+        entry: string;
+        capabilities: string[];
+        formats: string[];
+    };
+}>;
+/** Creates a surface target with caller supplied entry and capabilities. */
+export declare function targetmanifest(target: any, options?: {}): {
+    target: any;
+    runtime: any;
+    entry: any;
+    formats: any;
+    capabilities: any;
+    permissions: any;
+    metadata: any;
+};
+/** Returns all supported target profiles for documentation and tooling. */
+export declare function targetcatalog(): {
+    [k: string]: {
+        runtime: string;
+        entry: string;
+        formats: string[];
+        capabilities: string[];
+    } | {
+        runtime: string;
+        entry: string;
+        formats: string[];
+        capabilities: string[];
+    } | {
+        runtime: string;
+        entry: string;
+        formats: string[];
+        capabilities: string[];
+    } | {
+        runtime: string;
+        entry: string;
+        formats: string[];
+        capabilities: string[];
+    } | {
+        runtime: string;
+        entry: string;
+        formats: string[];
+        capabilities: string[];
+    } | {
+        runtime: string;
+        entry: string;
+        formats: string[];
+        capabilities: string[];
+    } | {
+        runtime: string;
+        entry: string;
+        formats: string[];
+        capabilities: string[];
+    } | {
+        runtime: string;
+        entry: string;
+        formats: string[];
+        capabilities: string[];
+    } | {
+        runtime: string;
+        entry: string;
+        formats: string[];
+        capabilities: string[];
+    } | {
+        runtime: string;
+        entry: string;
+        formats: string[];
+        capabilities: string[];
+    } | {
+        runtime: string;
+        entry: string;
+        formats: string[];
+        capabilities: string[];
+    } | {
+        runtime: string;
+        entry: string;
+        formats: string[];
+        capabilities: string[];
+    } | {
+        runtime: string;
+        entry: string;
+        formats: string[];
+        capabilities: string[];
+    } | {
+        runtime: string;
+        entry: string;
+        formats: string[];
+        capabilities: string[];
+    } | {
+        runtime: string;
+        entry: string;
+        formats: string[];
+        capabilities: string[];
+    } | {
+        runtime: string;
+        entry: string;
+        formats: string[];
+        capabilities: string[];
+    };
+};
+//# sourceMappingURL=targets.d.ts.map

package/dist/surfaces/targets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.d.ts","sourceRoot":"","sources":["../../surfaces/targets.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,cAAc;;QACV,OAAO;QAAY,KAAK;QAAmB,YAAY;QAAoC,OAAO;;;QACrG,OAAO;QAAU,KAAK;QAAmB,YAAY;QAAmC,OAAO;;;QAC7F,OAAO;QAAY,KAAK;QAAmB,YAAY;QAAiC,OAAO;;;QAChG,OAAO;QAAa,KAAK;QAAmB,YAAY;QAAoC,OAAO;;;QACrG,OAAO;QAAa,KAAK;QAAmB,YAAY;QAAoC,OAAO;;;QACvG,OAAO;QAAS,KAAK;QAAmB,YAAY;QAAoC,OAAO;;;QAC/F,OAAO;QAAU,KAAK;QAAsB,YAAY;QAAoC,OAAO;;;QAChG,OAAO;QAAY,KAAK;QAAsB,YAAY;QAAmC,OAAO;;;QACnG,OAAO;QAAa,KAAK;QAAmB,YAAY;QAAoC,OAAO;;;QACjG,OAAO;QAAa,KAAK;QAA6B,YAAY;QAAqC,OAAO;;;QAC/G,OAAO;QAAY,KAAK;QAAmB,YAAY;QAAiC,OAAO;;;QACpG,OAAO;QAAa,KAAK;QAAgC,YAAY;QAA0B,OAAO;;;QAC9F,OAAO;QAAY,KAAK;QAAmB,YAAY;QAAuB,OAAO;;;QAC7F,OAAO;QAAY,KAAK;QAAwB,YAAY;QAAsB,OAAO;;;QACxF,OAAO;QAAY,KAAK;QAAmB,YAAY;QAA0B,OAAO;;;QACnF,OAAO;QAAU,KAAK;QAAmB,YAAY;QAAoC,OAAO;;EAC7G,CAAC;AAEH,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,MAAM,KAAA,EAAE,OAAO,KAAK;;;;;;;;EAAqZ;AAExc,2EAA2E;AAC3E,wBAAgB,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAmJ"}

package/dist/surfaces/targets.js

@@ -0,0 +1,27 @@
+/**
+ * target profiles keep platform packaging open and describe capability boundaries.
+ */
+export const targetprofiles = Object.freeze({
+    application: { runtime: "caller", entry: "dist/index.js", capabilities: ["memory", "storage", "network"], formats: ["zip", "tarball"] },
+    computer: { runtime: "node", entry: "dist/index.js", capabilities: ["memory", "storage", "runner"], formats: ["node", "bun", "deno", "singlefile"] },
+    desktopapp: { runtime: "caller", entry: "dist/index.js", capabilities: ["memory", "file", "visible"], formats: ["appimage", "deb", "rpm", "snap", "flatpak", "dmg", "pkg", "exe", "msi", "msix"] },
+    mobileapp: { runtime: "browser", entry: "dist/index.js", capabilities: ["memory", "network", "visible"], formats: ["apk", "aab", "ipa"] },
+    android: { runtime: "android", entry: "dist/index.js", capabilities: ["memory", "network", "visible"], formats: ["apk", "aab"] },
+    ios: { runtime: "ios", entry: "dist/index.js", capabilities: ["memory", "network", "visible"], formats: ["ipa"] },
+    cli: { runtime: "node", entry: "dist/cli/main.js", capabilities: ["memory", "storage", "network"], formats: ["node", "bun", "deno", "singlefile", "exe", "deb", "rpm"] },
+    binary: { runtime: "caller", entry: "dist/cli/main.js", capabilities: ["memory", "storage", "runner"], formats: ["sea", "singlefile", "wasm"] },
+    browser: { runtime: "browser", entry: "dist/index.js", capabilities: ["memory", "network", "visible"], formats: ["html", "pwa", "wasm"] },
+    extension: { runtime: "browser", entry: "dist/extension/index.js", capabilities: ["browser", "network", "visible"], formats: ["crx", "xpi", "safariextz"] },
+    internet: { runtime: "caller", entry: "dist/index.js", capabilities: ["network", "webhook", "api"], formats: ["http", "websocket", "grpc", "rest"] },
+    web: { runtime: "browser", entry: "web/dist/public/index.html", capabilities: ["network", "visible"], formats: ["html", "pwa", "ssg", "ssr", "wasm"] },
+    libreoffice: { runtime: "caller", entry: "dist/index.js", capabilities: ["file", "network"], formats: ["oxt", "zip"] },
+    mcp: { runtime: "caller", entry: "dist/mcp/server.js", capabilities: ["network", "api"], formats: ["stdio", "jsonrpc"] },
+    vsix: { runtime: "caller", entry: "dist/index.js", capabilities: ["network", "visible"], formats: ["vsix"] },
+    container: { runtime: "node", entry: "dist/index.js", capabilities: ["memory", "storage", "network"], formats: ["oci", "docker"] }
+});
+/** Creates a surface target with caller supplied entry and capabilities. */
+export function targetmanifest(target, options = {}) { const profile = targetprofiles[target]; if (!profile)
+    throw new TypeError(`unsupported target: ${target}`); return { target, runtime: options.runtime ?? profile.runtime, entry: options.entry ?? profile.entry, formats: options.formats ?? [...profile.formats], capabilities: options.capabilities ?? [...profile.capabilities], permissions: options.permissions ?? [], metadata: options.metadata ?? {} }; }
+/** Returns all supported target profiles for documentation and tooling. */
+export function targetcatalog() { return Object.fromEntries(Object.entries(targetprofiles).map(([key, value]) => [key, { ...value, capabilities: [...value.capabilities] }])); }
+//# sourceMappingURL=targets.js.map

package/dist/surfaces/targets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.js","sourceRoot":"","sources":["../../surfaces/targets.ts"],"names":[],"mappings":"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"}

package/dist/webhook/delivery.d.ts

@@ -0,0 +1,18 @@
+/**
+ * webhook delivery tracks attempts and dead letters without choosing a queue vendor.
+ */
+/** Creates a sequential delivery queue with retryable failure handling. */
+export declare function deliveryqueue(options?: {}): {
+    deliver: (input: {}, handler: any) => Promise<{
+        id: string;
+        status: string;
+        attempts: number;
+        createdat: number;
+        event: any;
+        metadata: any;
+    }>;
+    get(id: any): any;
+    list(): any[];
+    deadletters(): any[];
+};
+//# sourceMappingURL=delivery.d.ts.map

package/dist/webhook/delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery.d.ts","sourceRoot":"","sources":["../../webhook/delivery.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,OAAO,KAAK;;;;;;;;;;;;EAoBzC"}

package/dist/webhook/delivery.js

@@ -0,0 +1,36 @@
+/**
+ * webhook delivery tracks attempts and dead letters without choosing a queue vendor.
+ */
+/** Creates a sequential delivery queue with retryable failure handling. */
+export function deliveryqueue(options = {}) {
+    const maxattempts = Number(options.maxattempts ?? 3);
+    const records = new Map();
+    const dead = [];
+    async function deliver(input = {}, handler) {
+        if (typeof handler !== "function")
+            throw new TypeError("delivery handler must be a function");
+        const id = String(input.id ?? `delivery${Date.now().toString(36)}${records.size}`);
+        const record = { id, status: "pending", attempts: 0, createdat: Date.now(), event: input.event, metadata: { ...(input.metadata ?? {}) } };
+        records.set(id, record);
+        while (record.attempts < maxattempts) {
+            record.attempts += 1;
+            try {
+                record.result = await handler(input.event, input);
+                record.status = "delivered";
+                record.updatedat = Date.now();
+                return { ...record };
+            }
+            catch (error) {
+                record.error = { code: String(error.code ?? "DELIVERY_FAILED"), message: String(error.message ?? error), retryable: Boolean(error.retryable) };
+                if (!error.retryable)
+                    break;
+            }
+        }
+        record.status = "dead";
+        dead.push({ ...record });
+        record.updatedat = Date.now();
+        return { ...record };
+    }
+    return { deliver, get(id) { return records.get(String(id)); }, list() { return [...records.values()].map((record) => ({ ...record })); }, deadletters() { return dead.map((record) => ({ ...record })); } };
+}
+//# sourceMappingURL=delivery.js.map

package/dist/webhook/delivery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery.js","sourceRoot":"","sources":["../../webhook/delivery.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,2EAA2E;AAC3E,MAAM,UAAU,aAAa,CAAC,OAAO,GAAG,EAAE;IACxC,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;IAC1B,MAAM,IAAI,GAAG,EAAE,CAAC;IAChB,KAAK,UAAU,OAAO,CAAC,KAAK,GAAG,EAAE,EAAE,OAAO;QACxC,IAAI,OAAO,OAAO,KAAK,UAAU;YAAE,MAAM,IAAI,SAAS,CAAC,qCAAqC,CAAC,CAAC;QAC9F,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,WAAW,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QACnF,MAAM,MAAM,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1I,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACxB,OAAO,MAAM,CAAC,QAAQ,GAAG,WAAW,EAAE,CAAC;YACrC,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC;YACrB,IAAI,CAAC;gBAAC,MAAM,CAAC,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;gBAAC,MAAM,CAAC,MAAM,GAAG,WAAW,CAAC;gBAAC,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAAC,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC;YAAC,CAAC;YAC5I,OAAO,KAAK,EAAE,CAAC;gBAAC,MAAM,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,iBAAiB,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;gBAAC,IAAI,CAAC,KAAK,CAAC,SAAS;oBAAE,MAAM;YAAC,CAAC;QAChM,CAAC;QACD,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;QACvB,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QACzB,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC9B,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC;IACvB,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,IAAI,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,KAAK,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,KAAK,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC9M,CAAC"}

package/dist/webhook/receiver.d.ts

@@ -0,0 +1,26 @@
+export declare function webhookreceiver(options?: {}): {
+    receive(input?: {}): Promise<{
+        accepted: boolean;
+        status: number;
+        reason: string;
+        duplicate?: undefined;
+        deliveryid?: undefined;
+        result?: undefined;
+    } | {
+        reason?: undefined;
+        accepted: boolean;
+        status: number;
+        duplicate: boolean;
+        deliveryid?: undefined;
+        result?: undefined;
+    } | {
+        reason?: undefined;
+        duplicate?: undefined;
+        accepted: boolean;
+        status: number;
+        deliveryid: any;
+        result: any;
+    }>;
+    deliveries(): unknown[];
+};
+//# sourceMappingURL=receiver.d.ts.map

package/dist/webhook/receiver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receiver.d.ts","sourceRoot":"","sources":["../../webhook/receiver.ts"],"names":[],"mappings":"AAKA,wBAAgB,eAAe,CAAC,OAAO,KAAK;IAIlC,OAAO;;;;;;;;;;;;;;;;;;;;;;IAQb,UAAU;EAEb"}

package/dist/webhook/receiver.js

@@ -0,0 +1,24 @@
+/**
+ * webhook receiver validates signatures before dispatch and drops duplicate delivery ids.
+ */
+import { webhookverify } from "./signature.js";
+export function webhookreceiver(options = {}) {
+    if (typeof options.secret !== "string" || typeof options.handle !== "function")
+        throw new TypeError("webhook receiver requires secret and handler");
+    const deliveries = new Set();
+    return {
+        async receive(input = {}) {
+            if (!webhookverify(input.body, input.signature, options.secret))
+                return { accepted: false, status: 401, reason: "invalid signature" };
+            const id = input.deliveryid ?? input.eventid;
+            if (id && deliveries.has(id))
+                return { accepted: false, status: 200, duplicate: true };
+            if (id)
+                deliveries.add(id);
+            const result = await options.handle(input.event, input.body);
+            return { accepted: true, status: 202, deliveryid: id, result };
+        },
+        deliveries() { return [...deliveries]; }
+    };
+}
+//# sourceMappingURL=receiver.js.map

package/dist/webhook/receiver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"receiver.js","sourceRoot":"","sources":["../../webhook/receiver.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,UAAU,eAAe,CAAC,OAAO,GAAG,EAAE;IAC1C,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,UAAU;QAAE,MAAM,IAAI,SAAS,CAAC,8CAA8C,CAAC,CAAC;IACpJ,MAAM,UAAU,GAAG,IAAI,GAAG,EAAE,CAAC;IAC7B,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,KAAK,GAAG,EAAE;YACtB,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC;gBAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;YACtI,MAAM,EAAE,GAAG,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,OAAO,CAAC;YAC7C,IAAI,EAAE,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;YACvF,IAAI,EAAE;gBAAE,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC3B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAC7D,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;QACjE,CAAC;QACD,UAAU,KAAK,OAAO,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;KACzC,CAAC;AACJ,CAAC"}

package/dist/webhook/signature.d.ts

@@ -0,0 +1,3 @@
+export declare function webhooksig(payload: any, secret: any): string;
+export declare function webhookverify(payload: any, signature: any, secret: any): boolean;
+//# sourceMappingURL=signature.d.ts.map

package/dist/webhook/signature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signature.d.ts","sourceRoot":"","sources":["../../webhook/signature.ts"],"names":[],"mappings":"AAKA,wBAAgB,UAAU,CAAC,OAAO,KAAA,EAAE,MAAM,KAAA,UAAiG;AAC3I,wBAAgB,aAAa,CAAC,OAAO,KAAA,EAAE,SAAS,KAAA,EAAE,MAAM,KAAA,WAAuE"}

package/{webhook → dist/webhook}/signature.js

@@ -2,6 +2,6 @@
  * webhook signatures use hmac sha256 and keep secrets outside serialized events.
  */
 import { constanttimeequal, hmacsha256 } from "../core/hash.js";
-
 export function webhooksig(payload, secret) { return hmacsha256(typeof payload === "string" ? payload : JSON.stringify(payload), secret); }
 export function webhookverify(payload, signature, secret) { return constanttimeequal(webhooksig(payload, secret), signature); }
+//# sourceMappingURL=signature.js.map

package/dist/webhook/signature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signature.js","sourceRoot":"","sources":["../../webhook/signature.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEhE,MAAM,UAAU,UAAU,CAAC,OAAO,EAAE,MAAM,IAAI,OAAO,UAAU,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;AAC3I,MAAM,UAAU,aAAa,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,OAAO,iBAAiB,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC"}

package/dist/workflow/manifest.d.ts

@@ -0,0 +1,21 @@
+/**
+ * workflow manifests describe the same job surface for different forge runtimes.
+ */
+export declare const forgeprofiles: readonly string[];
+export declare function workflowmanifest(options?: {}): {
+    name: any;
+    command: any;
+    trigger: any;
+    platforms: any;
+    environment: any;
+    artifacts: any;
+    timeoutminutes: any;
+    publicrunner: any;
+};
+export declare function workflowinputs(manifest: any): {
+    name: any;
+    command: any;
+    timeoutminutes: any;
+    artifacts: any;
+};
+//# sourceMappingURL=manifest.d.ts.map

package/dist/workflow/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../workflow/manifest.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,aAAa,mBAAwE,CAAC;AAEnG,wBAAgB,gBAAgB,CAAC,OAAO,KAAK;IAGzC,IAAI;IACJ,OAAO;IACP,OAAO;IACP,SAAS;IACT,WAAW;IACX,SAAS;IACT,cAAc;IACd,YAAY;EAEf;AAED,wBAAgB,cAAc,CAAC,QAAQ,KAAA;IAAa,IAAI;IAAiB,OAAO;IAAoB,cAAc;IAA2B,SAAS;EAAmC"}

package/dist/workflow/manifest.js

@@ -0,0 +1,20 @@
+/**
+ * workflow manifests describe the same job surface for different forge runtimes.
+ */
+export const forgeprofiles = Object.freeze(["github", "forgejo", "gitea", "woodpecker", "gitlab"]);
+export function workflowmanifest(options = {}) {
+    if (!options.name || !options.command)
+        throw new TypeError("workflow manifest requires name and command");
+    return {
+        name: options.name,
+        command: options.command,
+        trigger: options.trigger ?? ["manual", "dispatch"],
+        platforms: options.platforms ?? forgeprofiles,
+        environment: options.environment ?? {},
+        artifacts: options.artifacts ?? ["results/**"],
+        timeoutminutes: options.timeoutminutes ?? 30,
+        publicrunner: options.publicrunner ?? true
+    };
+}
+export function workflowinputs(manifest) { return { name: manifest.name, command: manifest.command, timeoutminutes: manifest.timeoutminutes, artifacts: manifest.artifacts.join(",") }; }
+//# sourceMappingURL=manifest.js.map

package/dist/workflow/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../workflow/manifest.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEnG,MAAM,UAAU,gBAAgB,CAAC,OAAO,GAAG,EAAE;IAC3C,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO;QAAE,MAAM,IAAI,SAAS,CAAC,6CAA6C,CAAC,CAAC;IAC1G,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC;QAClD,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,aAAa;QAC7C,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE;QACtC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,CAAC,YAAY,CAAC;QAC9C,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,EAAE;QAC5C,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,IAAI;KAC3C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAAQ,IAAI,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,QAAQ,CAAC,cAAc,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC"}

package/dist/workflow/registry.d.ts

@@ -0,0 +1,7 @@
+export declare function workflowregistry(): {
+    register(manifest: any): any;
+    get(name: any): any;
+    render(name: any, forge: any): any;
+    list(): any[];
+};
+//# sourceMappingURL=registry.d.ts.map

package/dist/workflow/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../workflow/registry.ts"],"names":[],"mappings":"AAMA,wBAAgB,gBAAgB;;;;;EAS/B"}

package/dist/workflow/registry.js

@@ -0,0 +1,18 @@
+/**
+ * workflow registry stores generated manifests and templates for later dispatch.
+ */
+import { forgeprofiles } from "./manifest.js";
+import { forgejoworkflow, giteaworkflow, githubworkflow, gitlabworkflow, woodpeckerworkflow } from "./templates.js";
+export function workflowregistry() {
+    const manifests = new Map();
+    const renderers = { github: githubworkflow, forgejo: forgejoworkflow, gitea: giteaworkflow, woodpecker: woodpeckerworkflow, gitlab: gitlabworkflow };
+    return {
+        register(manifest) { manifests.set(manifest.name, manifest); return manifest; },
+        get(name) { return manifests.get(name) ?? null; },
+        render(name, forge) { if (!renderers[forge] || !forgeprofiles.includes(forge))
+            throw new TypeError(`unsupported forge: ${forge}`); const manifest = manifests.get(name); if (!manifest)
+            throw new Error(`workflow not found: ${name}`); return renderers[forge](manifest); },
+        list() { return [...manifests.values()]; }
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/workflow/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../workflow/registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,SAAS,GAAG,IAAI,GAAG,EAAE,CAAC;IAC5B,MAAM,SAAS,GAAG,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IACrJ,OAAO;QACL,QAAQ,CAAC,QAAQ,IAAI,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC;QAC/E,GAAG,CAAC,IAAI,IAAI,OAAO,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;QACjD,MAAM,CAAC,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,sBAAsB,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC5Q,IAAI,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;KAC3C,CAAC;AACJ,CAAC"}

package/dist/workflow/templates.d.ts

@@ -0,0 +1,6 @@
+export declare function githubworkflow(manifest: any): string;
+export declare function forgejoworkflow(manifest: any): string;
+export declare function giteaworkflow(manifest: any): string;
+export declare function woodpeckerworkflow(manifest: any): string;
+export declare function gitlabworkflow(manifest: any): string;
+//# sourceMappingURL=templates.d.ts.map

package/dist/workflow/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../workflow/templates.ts"],"names":[],"mappings":"AAKA,wBAAgB,cAAc,CAAC,QAAQ,KAAA,UAGtC;AAED,wBAAgB,eAAe,CAAC,QAAQ,KAAA,UAAkD;AAC1F,wBAAgB,aAAa,CAAC,QAAQ,KAAA,UAAgD;AACtF,wBAAgB,kBAAkB,CAAC,QAAQ,KAAA,UAC1C;AACD,wBAAgB,cAAc,CAAC,QAAQ,KAAA,UAA2P"}

package/dist/workflow/templates.js

@@ -0,0 +1,18 @@
+/**
+ * workflow templates use explicit environment names and keep provider secrets external.
+ */
+import { workflowinputs } from "./manifest.js";
+export function githubworkflow(manifest) {
+    const input = workflowinputs(manifest);
+    return `name: ${manifest.name}\non:\n  workflow_dispatch:\n    inputs:\n      jobid:\n        required: true\n        type: string\n      command:\n        required: true\n        type: string\n        default: ${manifest.command}\n  repository_dispatch:\n    types: [saddle-job]\npermissions:\n  contents: read\njobs:\n  process:\n    runs-on: ubuntu-latest\n    timeout-minutes: ${input.timeoutminutes}\n    steps:\n      - uses: actions/checkout@v4\n      - uses: actions/setup-node@v4\n        with:\n          node-version: 26.7.0\n      - run: npm ci\n      - run: \${{ github.event.inputs.command || '${manifest.command}' }}\n        env:\n          SBOT_JOB_ID: \${{ github.event.inputs.jobid || github.event.client_payload.jobid }}\n      - uses: actions/upload-artifact@v4\n        with:\n          name: saddle-results\n          path: ${manifest.artifacts.join("\n            ")}\n          if-no-files-found: ignore\n`;
+}
+export function forgejoworkflow(manifest) { return genericworkflow(manifest, "forgejo"); }
+export function giteaworkflow(manifest) { return genericworkflow(manifest, "gitea"); }
+export function woodpeckerworkflow(manifest) {
+    return `when:\n  - event: push\n  - event: manual\nsteps:\n  process:\n    image: node:26.7.0\n    commands:\n      - npm ci\n      - ${manifest.command}\n`;
+}
+export function gitlabworkflow(manifest) { return `stages:\n  - process\nprocess:\n  stage: process\n  image: node:26.7.0\n  script:\n    - npm ci\n    - ${manifest.command}\n  artifacts:\n    when: always\n    paths:\n${manifest.artifacts.map((item) => `      - ${item}`).join("\n")}\n`; }
+function genericworkflow(manifest, name) {
+    return `name: ${manifest.name}\non:\n  workflow_dispatch:\njobs:\n  process:\n    runs-on: ubuntu-latest\n    timeout-minutes: ${manifest.timeoutminutes}\n    steps:\n      - uses: actions/checkout@v4\n      - uses: actions/setup-node@v4\n        with:\n          node-version: 26.7.0\n      - run: npm ci\n      - run: ${manifest.command}\n`;
+}
+//# sourceMappingURL=templates.js.map

package/dist/workflow/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../workflow/templates.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,UAAU,cAAc,CAAC,QAAQ;IACrC,MAAM,KAAK,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IACvC,OAAO,SAAS,QAAQ,CAAC,IAAI,wLAAwL,QAAQ,CAAC,OAAO,0JAA0J,KAAK,CAAC,cAAc,+MAA+M,QAAQ,CAAC,OAAO,+NAA+N,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,gBAAgB,CAAC,yCAAyC,CAAC;AACt6B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAQ,IAAI,OAAO,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;AAC1F,MAAM,UAAU,aAAa,CAAC,QAAQ,IAAI,OAAO,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AACtF,MAAM,UAAU,kBAAkB,CAAC,QAAQ;IAAI,OAAO,iIAAiI,QAAQ,CAAC,OAAO,IAAI,CAAC;AAC5M,CAAC;AACD,MAAM,UAAU,cAAc,CAAC,QAAQ,IAAI,OAAO,0GAA0G,QAAQ,CAAC,OAAO,iDAAiD,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAElS,SAAS,eAAe,CAAC,QAAQ,EAAE,IAAI;IAAI,OAAO,SAAS,QAAQ,CAAC,IAAI,oGAAoG,QAAQ,CAAC,cAAc,0KAA0K,QAAQ,CAAC,OAAO,IAAI,CAAC;AAClY,CAAC"}

package/dist/workflow/triggers.d.ts

@@ -0,0 +1,36 @@
+/**
+ * workflow triggers normalize manual, event, schedule and retry starts without binding a forge.
+ */
+export declare const triggernames: readonly string[];
+/** Validates and normalizes a trigger declaration. */
+export declare function workflowtriggers(value?: string[]): string[];
+/** Matches a workflow trigger against an incoming event without executing it. */
+export declare function triggermatch(manifest: any, event?: {}): {
+    matched: boolean;
+    type: string;
+    reason: string;
+    requestid?: undefined;
+} | {
+    reason?: undefined;
+    matched: boolean;
+    type: string;
+    requestid: any;
+};
+/** Keeps trigger declarations and produces deterministic matching results. */
+export declare function triggerregistry(): {
+    register: (manifest: any) => any;
+    get: (name: any) => any;
+    match: (name: any, event: any) => {
+        matched: boolean;
+        type: string;
+        reason: string;
+        requestid?: undefined;
+    } | {
+        reason?: undefined;
+        matched: boolean;
+        type: string;
+        requestid: any;
+    };
+    list: () => any[];
+};
+//# sourceMappingURL=triggers.d.ts.map

package/dist/workflow/triggers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.d.ts","sourceRoot":"","sources":["../../workflow/triggers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,YAAY,mBAAqF,CAAC;AAE/G,sDAAsD;AACtD,wBAAgB,gBAAgB,CAAC,KAAK,WAAa,YAIlD;AAED,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,QAAQ,KAAA,EAAE,KAAK,KAAK;;;;;;;;;;EAMhD;AAED,8EAA8E;AAC9E,wBAAgB,eAAe;;;;;;;;;;;;;;;EAO9B"}

package/dist/workflow/triggers.js

@@ -0,0 +1,33 @@
+/**
+ * workflow triggers normalize manual, event, schedule and retry starts without binding a forge.
+ */
+export const triggernames = Object.freeze(["manual", "dispatch", "webhook", "schedule", "retry", "heartbeat"]);
+/** Validates and normalizes a trigger declaration. */
+export function workflowtriggers(value = ["manual"]) {
+    const list = Array.isArray(value) ? value : [value];
+    if (list.length === 0 || list.some((name) => !triggernames.includes(name)))
+        throw new TypeError("workflow trigger is unsupported");
+    return [...new Set(list)];
+}
+/** Matches a workflow trigger against an incoming event without executing it. */
+export function triggermatch(manifest, event = {}) {
+    const triggers = workflowtriggers(manifest?.trigger);
+    const type = String(event.type ?? "manual");
+    if (!triggers.includes(type))
+        return { matched: false, type, reason: "trigger-not-declared" };
+    if (type === "schedule" && event.at !== undefined && Number(event.at) > Date.now())
+        return { matched: false, type, reason: "not-due" };
+    return { matched: true, type, requestid: event.requestid ?? `${manifest.name}/${type}/${event.id ?? Date.now()}` };
+}
+/** Keeps trigger declarations and produces deterministic matching results. */
+export function triggerregistry() {
+    const values = new Map();
+    function register(manifest) { if (!manifest?.name)
+        throw new TypeError("trigger manifest requires name"); const normalized = { ...manifest, trigger: workflowtriggers(manifest.trigger) }; values.set(normalized.name, normalized); return normalized; }
+    function get(name) { return values.get(name); }
+    function match(name, event) { const manifest = get(name); if (!manifest)
+        throw new Error(`workflow not found: ${name}`); return triggermatch(manifest, event); }
+    function list() { return [...values.values()].map((manifest) => ({ ...manifest, trigger: [...manifest.trigger] })); }
+    return { register, get, match, list };
+}
+//# sourceMappingURL=triggers.js.map

package/dist/workflow/triggers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.js","sourceRoot":"","sources":["../../workflow/triggers.ts"],"names":[],"mappings":"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"}

package/docs/enginearchitecture.md

@@ -12,17 +12,18 @@ The project has no `src` folder. The root is the map of the engine.
 
 | folder | responsibility |
 |---|---|
-| `core` | errors, ids, clock, events, and tracing primitives |
+| `core` | engine errors, scrape error taxonomy, ids, events, and hashing primitives |
 | `domain` | jobs, sessions, artifacts, providers, and runtime records |
 | `storage` | storage adapter contract, local backend, and checksums |
 | `memory` | working set preparation, sync, and cleanup |
 | `runners` | provider factories and deterministic scheduling |
-| `runtime` | engine orchestration and output encoding |
+| `runtime` | engine orchestration, capability detection, worker boundary, retry and circuit context |
+| `scrape` | single page extraction, response normalization, robots policy and grouped crawl context |
 | `cli` | explicit command surface with local error handling |
 | `tests` | local deterministic tests without credentials |
 | `examples` | small runnable integration examples |
 
-All internal file names are lowercase and contain no underscore or hyphen. Related logic stays grouped and each module remains small enough to reason about in isolation.
+All internal file names are lowercase and contain no underscore or hyphen. Related logic stays grouped and each module remains small enough to reason about in isolation. Version 1.8.9 uses TypeScript source at the root and groups crawl URL normalization, traversal, frontier budgets and persistence in `scrape/crawl.ts`; it does not merge distinct storage cache, job queue or browser session contracts merely because they use similar words.
 
 ## public contracts
 
@@ -64,7 +65,7 @@ The same contracts support paired modes. A mode can exist without its pair, and
 | browser | headless job definition | capture and replay adapter |
 | network | local deterministic job | remote provider and storage adapter |
 
-The first cut implements library, cli, binary entry point, internal memory, and internal file. The other modes are extension points, not hardcoded promises.
+The first cut implements library, CLI, binary entry point, internal memory, and internal file. The other modes are extension points and declarative target plans, not hardcoded platform promises. Version 1.8.9 preserves this boundary while compiling the active engine to ignored `dist/` output.
 
 ## infrastructure rules