@wenathlan/saddle 1.8.7 → 1.8.9

package/dist/surfaces/adapters.d.ts

@@ -0,0 +1,97 @@
+/**
+ * surface adapters define caller-owned desktop and mobile operations without selecting a vendor runtime.
+ */
+/** Creates a transport-neutral adapter contract for a desktop or mobile surface. */
+export declare function surfaceadapter(options?: {}): {
+    target: string;
+    version: number;
+    capabilities: any[];
+    formats: any[];
+    operations: string[];
+    invoke: (operation: any, input: any, context?: {}) => Promise<{
+        target: string;
+        operation: string;
+        supported: boolean;
+        result: any;
+        ok?: undefined;
+        code?: undefined;
+        message?: undefined;
+    } | {
+        result?: undefined;
+        target: string;
+        operation: string;
+        supported: boolean;
+        ok: boolean;
+        code: string;
+        message: string;
+    }>;
+    status: () => {
+        target: string;
+        ready: boolean;
+        operations: string[];
+        capabilities: any[];
+    };
+};
+/** Creates a desktop adapter contract with caller-owned handlers. */
+export declare function desktopadapter(options?: {}): {
+    target: string;
+    version: number;
+    capabilities: any[];
+    formats: any[];
+    operations: string[];
+    invoke: (operation: any, input: any, context?: {}) => Promise<{
+        target: string;
+        operation: string;
+        supported: boolean;
+        result: any;
+        ok?: undefined;
+        code?: undefined;
+        message?: undefined;
+    } | {
+        result?: undefined;
+        target: string;
+        operation: string;
+        supported: boolean;
+        ok: boolean;
+        code: string;
+        message: string;
+    }>;
+    status: () => {
+        target: string;
+        ready: boolean;
+        operations: string[];
+        capabilities: any[];
+    };
+};
+/** Creates a mobile adapter contract with caller-owned handlers. */
+export declare function mobileadapter(options?: {}): {
+    target: string;
+    version: number;
+    capabilities: any[];
+    formats: any[];
+    operations: string[];
+    invoke: (operation: any, input: any, context?: {}) => Promise<{
+        target: string;
+        operation: string;
+        supported: boolean;
+        result: any;
+        ok?: undefined;
+        code?: undefined;
+        message?: undefined;
+    } | {
+        result?: undefined;
+        target: string;
+        operation: string;
+        supported: boolean;
+        ok: boolean;
+        code: string;
+        message: string;
+    }>;
+    status: () => {
+        target: string;
+        ready: boolean;
+        operations: string[];
+        capabilities: any[];
+    };
+};
+//# sourceMappingURL=adapters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../surfaces/adapters.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,OAAO,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+B1C;AAED,qEAAqE;AACrE,wBAAgB,cAAc,CAAC,OAAO,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAA+D;AAE1G,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,OAAO,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAA8D"}

package/dist/surfaces/adapters.js

@@ -0,0 +1,50 @@
+/**
+ * surface adapters define caller-owned desktop and mobile operations without selecting a vendor runtime.
+ */
+const profiles = Object.freeze({
+    desktop: { capabilities: ["window", "file", "notification"], formats: ["appimage", "dmg", "msi"] },
+    mobile: { capabilities: ["screen", "storage", "network"], formats: ["apk", "ipa"] }
+});
+/** Creates a transport-neutral adapter contract for a desktop or mobile surface. */
+export function surfaceadapter(options = {}) {
+    const target = String(options.target ?? "");
+    const profile = profiles[target];
+    if (!profile)
+        throw new TypeError(`unsupported surface adapter: ${target}`);
+    const operations = [...new Set(options.operations ?? ["open", "close", "invoke", "status"])]
+        .map((operation) => String(operation));
+    if (!operations.length || operations.some((operation) => !/^[a-z][a-z0-9]*$/.test(operation)))
+        throw new TypeError("surface adapter operations are invalid");
+    const handlers = { ...(options.handlers ?? {}) };
+    for (const [operation, handler] of Object.entries(handlers))
+        if (typeof handler !== "function")
+            throw new TypeError(`surface handler is not callable: ${operation}`);
+    async function invoke(operation, input, context = {}) {
+        const name = String(operation ?? "");
+        if (!operations.includes(name))
+            throw new TypeError(`unsupported surface operation: ${name}`);
+        const handler = handlers[name];
+        if (!handler)
+            return { target, operation: name, supported: false, result: undefined };
+        try {
+            return { target, operation: name, supported: true, result: await handler(input, context) };
+        }
+        catch (error) {
+            return { target, operation: name, supported: true, ok: false, code: String(error?.code ?? "SURFACE_OPERATION_FAILED"), message: String(error?.message ?? error) };
+        }
+    }
+    return {
+        target,
+        version: 1,
+        capabilities: [...(options.capabilities ?? profile.capabilities)],
+        formats: [...(options.formats ?? profile.formats)],
+        operations,
+        invoke,
+        status: () => ({ target, ready: true, operations: [...operations], capabilities: [...(options.capabilities ?? profile.capabilities)] })
+    };
+}
+/** Creates a desktop adapter contract with caller-owned handlers. */
+export function desktopadapter(options = {}) { return surfaceadapter({ ...options, target: "desktop" }); }
+/** Creates a mobile adapter contract with caller-owned handlers. */
+export function mobileadapter(options = {}) { return surfaceadapter({ ...options, target: "mobile" }); }
+//# sourceMappingURL=adapters.js.map

package/dist/surfaces/adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../../surfaces/adapters.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7B,OAAO,EAAE,EAAE,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,OAAO,EAAE,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE;IAClG,MAAM,EAAE,EAAE,YAAY,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE;CACpF,CAAC,CAAC;AAEH,oFAAoF;AACpF,MAAM,UAAU,cAAc,CAAC,OAAO,GAAG,EAAE;IACzC,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,SAAS,CAAC,gCAAgC,MAAM,EAAE,CAAC,CAAC;IAC5E,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;SACzF,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;IACzC,IAAI,CAAC,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,wCAAwC,CAAC,CAAC;IAC7J,MAAM,QAAQ,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,CAAC;IACjD,KAAK,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC;QAAE,IAAI,OAAO,OAAO,KAAK,UAAU;YAAE,MAAM,IAAI,SAAS,CAAC,oCAAoC,SAAS,EAAE,CAAC,CAAC;IAErK,KAAK,UAAU,MAAM,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,EAAE;QAClD,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QACrC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,kCAAkC,IAAI,EAAE,CAAC,CAAC;QAC9F,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QACtF,IAAI,CAAC;YACH,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC;QAC7F,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,IAAI,0BAA0B,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,KAAK,CAAC,EAAE,CAAC;QACpK,CAAC;IACH,CAAC;IAED,OAAO;QACL,MAAM;QACN,OAAO,EAAE,CAAC;QACV,YAAY,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;QACjE,OAAO,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;QAClD,UAAU;QACV,MAAM;QACN,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,GAAG,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;KACxI,CAAC;AACJ,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,cAAc,CAAC,OAAO,GAAG,EAAE,IAAI,OAAO,cAAc,CAAC,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;AAE1G,oEAAoE;AACpE,MAAM,UAAU,aAAa,CAAC,OAAO,GAAG,EAAE,IAAI,OAAO,cAAc,CAAC,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC"}

package/dist/surfaces/controls.d.ts

@@ -0,0 +1,18 @@
+/**
+ * control surfaces provide an operator contract for jobs, sessions, storage, runners, permissions, logs and artifacts.
+ */
+export declare const controlresources: readonly string[];
+export declare const controloperations: readonly string[];
+/** Creates a caller-owned operator surface with resource handlers and optional audit recording. */
+export declare function controlsurface(options?: {}): {
+    version: number;
+    resources: string[];
+    operations: string[];
+    execute: (request?: {}) => Promise<any>;
+    describe: () => {
+        version: number;
+        resources: string[];
+        configured: string[];
+    };
+};
+//# sourceMappingURL=controls.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"controls.d.ts","sourceRoot":"","sources":["../../surfaces/controls.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,gBAAgB,mBAAgG,CAAC;AAC9H,eAAO,MAAM,iBAAiB,mBAA2F,CAAC;AAE1H,mGAAmG;AACnG,wBAAgB,cAAc,CAAC,OAAO,KAAK;;;;;;QAqB8E,OAAO;QAAK,SAAS;QAAyB,UAAU;;EAChL"}

package/dist/surfaces/controls.js

@@ -0,0 +1,45 @@
+/**
+ * control surfaces provide an operator contract for jobs, sessions, storage, runners, permissions, logs and artifacts.
+ */
+export const controlresources = Object.freeze(["jobs", "sessions", "storage", "runners", "permissions", "logs", "artifacts"]);
+export const controloperations = Object.freeze(["list", "get", "create", "update", "cancel", "retry", "delete", "check"]);
+/** Creates a caller-owned operator surface with resource handlers and optional audit recording. */
+export function controlsurface(options = {}) {
+    const adapters = { ...(options.adapters ?? {}) };
+    const audit = options.audit;
+    if (audit !== undefined && typeof audit !== "function")
+        throw new TypeError("control audit must be callable");
+    for (const resource of Object.keys(adapters))
+        if (!controlresources.includes(resource) || !adapters[resource] || typeof adapters[resource] !== "object")
+            throw new TypeError(`unsupported control resource: ${resource}`);
+    async function execute(request = {}) {
+        const resource = String(request.resource ?? "");
+        const operation = String(request.operation ?? "");
+        if (!controlresources.includes(resource) || !controloperations.includes(operation))
+            throw new TypeError("control request is invalid");
+        const handler = adapters[resource]?.[operation];
+        const context = { requestid: String(request.requestid ?? `control${Date.now().toString(36)}`), resource, operation };
+        if (typeof handler !== "function")
+            return respond({ ok: false, code: "UNSUPPORTED_CONTROL", message: `${resource}.${operation} is not configured`, context, audit });
+        try {
+            const result = await handler(request.input ?? {}, context);
+            return respond({ ok: true, result, context, audit });
+        }
+        catch (error) {
+            return respond({ ok: false, code: String(error?.code ?? "CONTROL_FAILED"), message: String(error?.message ?? error), context, audit });
+        }
+    }
+    return { version: 1, resources: [...controlresources], operations: [...controloperations], execute, describe: () => ({ version: 1, resources: [...controlresources], configured: Object.keys(adapters).filter((resource) => controlresources.includes(resource)) }) };
+}
+async function respond({ ok, result, code, message, context, audit }) {
+    const response = { version: 1, ok, ...context, ...(ok ? { result } : { code, message }) };
+    if (audit)
+        try {
+            await audit(response);
+        }
+        catch (error) {
+            response.auditerror = String(error?.message ?? error);
+        }
+    return response;
+}
+//# sourceMappingURL=controls.js.map

package/dist/surfaces/controls.js.map

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

package/dist/surfaces/manifest.d.ts

@@ -0,0 +1,68 @@
+/**
+ * surface manifests describe repackaging targets without adding target code to the engine.
+ */
+export declare const surfaces: readonly string[];
+export declare const surfaceformats: Readonly<{
+    library: readonly string[];
+    application: readonly string[];
+    computer: readonly string[];
+    desktop: readonly string[];
+    mobile: readonly string[];
+    browser: readonly string[];
+    extension: readonly string[];
+    cli: readonly string[];
+    binary: readonly string[];
+    web: readonly string[];
+    internet: readonly string[];
+    libreoffice: readonly string[];
+    mcp: readonly string[];
+    vsix: readonly string[];
+    container: readonly string[];
+    n8n: readonly string[];
+}>;
+export declare function surfacemanifest(options?: {}): {
+    target: any;
+    name: any;
+    entry: any;
+    runtime: any;
+    formats: any[];
+    permissions: any;
+    capabilities: any;
+    metadata: any;
+};
+/** Creates a desktop surface manifest with caller-selected packaging formats. */
+export declare function desktopmanifest(options?: {}): {
+    target: any;
+    name: any;
+    entry: any;
+    runtime: any;
+    formats: any[];
+    permissions: any;
+    capabilities: any;
+    metadata: any;
+};
+/** Creates a mobile surface manifest with caller-selected packaging formats. */
+export declare function mobilemanifest(options?: {}): {
+    target: any;
+    name: any;
+    entry: any;
+    runtime: any;
+    formats: any[];
+    permissions: any;
+    capabilities: any;
+    metadata: any;
+};
+/** Creates a caller-owned target manifest for any supported surface. */
+export declare function applicationmanifest(options?: {}): {
+    target: any;
+    name: any;
+    entry: any;
+    runtime: any;
+    formats: any[];
+    permissions: any;
+    capabilities: any;
+    metadata: any;
+};
+/** Describes installation without performing a package or platform mutation. */
+export declare function surfacebundle(manifest: any): any;
+//# sourceMappingURL=manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../surfaces/manifest.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,QAAQ,mBAA2L,CAAC;AAEjN,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;EAiBzB,CAAC;AAEH,wBAAgB,eAAe,CAAC,OAAO,KAAK;;;;;;;;;EAI3C;AAED,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,OAAO,KAAK;;;;;;;;;EAAoH;AAEhK,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,OAAO,KAAK;;;;;;;;;EAAkH;AAE7J,wEAAwE;AACxE,wBAAgB,mBAAmB,CAAC,OAAO,KAAK;;;;;;;;;EAAsF;AAEtI,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,QAAQ,KAAA,OAIrC"}

package/dist/surfaces/manifest.js

@@ -0,0 +1,42 @@
+/**
+ * surface manifests describe repackaging targets without adding target code to the engine.
+ */
+export const surfaces = Object.freeze(["application", "computer", "browser", "extension", "desktop", "mobile", "cli", "binary", "web", "internet", "libreoffice", "mcp", "vsix", "container", "n8n", "library"]);
+export const surfaceformats = Object.freeze({
+    library: Object.freeze(["npm", "github", "maven", "nuget", "rubygems", "oci", "tarball"]),
+    application: Object.freeze(["zip", "tarball"]),
+    computer: Object.freeze(["node", "bun", "deno", "singlefile"]),
+    desktop: Object.freeze(["appimage", "deb", "rpm", "snap", "flatpak", "dmg", "pkg", "exe", "msi", "msix"]),
+    mobile: Object.freeze(["apk", "aab", "ipa"]),
+    browser: Object.freeze(["html", "pwa", "wasm"]),
+    extension: Object.freeze(["crx", "xpi", "safariextz"]),
+    cli: Object.freeze(["node", "bun", "deno", "singlefile", "exe", "deb", "rpm"]),
+    binary: Object.freeze(["sea", "singlefile", "wasm"]),
+    web: Object.freeze(["html", "pwa", "ssg", "ssr", "wasm"]),
+    internet: Object.freeze(["http", "websocket", "grpc", "rest"]),
+    libreoffice: Object.freeze(["oxt", "zip"]),
+    mcp: Object.freeze(["stdio", "jsonrpc"]),
+    vsix: Object.freeze(["vsix"]),
+    container: Object.freeze(["oci", "docker"]),
+    n8n: Object.freeze(["node", "json"])
+});
+export function surfacemanifest(options = {}) {
+    const target = options.target ?? "library";
+    if (!surfaces.includes(target))
+        throw new TypeError(`unsupported surface: ${target}`);
+    return { target, name: options.name ?? "saddle", entry: options.entry ?? "dist/index.js", runtime: options.runtime ?? "caller", formats: [...(options.formats ?? surfaceformats[target] ?? [])], permissions: options.permissions ?? [], capabilities: options.capabilities ?? ["memory", "scrape", "workflow"], metadata: options.metadata ?? {} };
+}
+/** Creates a desktop surface manifest with caller-selected packaging formats. */
+export function desktopmanifest(options = {}) { return surfacemanifest({ ...options, target: "desktop", formats: options.formats ?? surfaceformats.desktop }); }
+/** Creates a mobile surface manifest with caller-selected packaging formats. */
+export function mobilemanifest(options = {}) { return surfacemanifest({ ...options, target: "mobile", formats: options.formats ?? surfaceformats.mobile }); }
+/** Creates a caller-owned target manifest for any supported surface. */
+export function applicationmanifest(options = {}) { return surfacemanifest({ ...options, target: options.target ?? "application" }); }
+/** Describes installation without performing a package or platform mutation. */
+export function surfacebundle(manifest) {
+    if (!manifest?.target || !surfaces.includes(manifest.target))
+        throw new TypeError("surface bundle requires a valid manifest");
+    const install = { n8n: "n8n import", browser: "import by url", extension: "load unpacked", desktop: "caller desktop bundle", mobile: "caller mobile bundle" }[manifest.target] ?? "npm install";
+    return { ...manifest, files: [...new Set([manifest.entry, ...(manifest.files ?? [])])], install };
+}
+//# sourceMappingURL=manifest.js.map

package/dist/surfaces/manifest.js.map

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

package/dist/surfaces/n8n.d.ts

@@ -0,0 +1,25 @@
+/**
+ * n8n node metadata keeps workflow automation as a packaging surface.
+ */
+export declare function n8nnode(options?: {}): {
+    name: any;
+    displayname: any;
+    description: any;
+    version: number;
+    inputs: any;
+    outputs: any;
+    triggers: any[];
+    actions: any[];
+    properties: any;
+};
+export declare const n8ntriggers: readonly string[];
+export declare const n8nactions: readonly string[];
+/** Matches an incoming event against the trigger declarations of a node. */
+export declare function n8nmatch(node: any, event?: {}): {
+    matched: boolean;
+    type: string;
+    requestid: any;
+};
+/** Executes a declared n8n action through a caller-owned handler. */
+export declare function n8nexecute(node: any, input: any, handler: any): Promise<any>;
+//# sourceMappingURL=n8n.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"n8n.d.ts","sourceRoot":"","sources":["../../surfaces/n8n.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,KAAK;;;;;;;;;;EAInC;AAED,eAAO,MAAM,WAAW,mBAAqF,CAAC;AAC9G,eAAO,MAAM,UAAU,mBAAgG,CAAC;AAExH,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,IAAI,KAAA,EAAE,KAAK,KAAK;;;;EAAwL;AAEjO,qEAAqE;AACrE,wBAAsB,UAAU,CAAC,IAAI,KAAA,EAAE,KAAK,KAAA,EAAE,OAAO,KAAA,gBAKpD"}

package/dist/surfaces/n8n.js

@@ -0,0 +1,31 @@
+/**
+ * n8n node metadata keeps workflow automation as a packaging surface.
+ */
+export function n8nnode(options = {}) {
+    const triggers = normalize(options.triggers ?? n8ntriggers);
+    const actions = normalize(options.actions ?? n8nactions);
+    return { name: options.name ?? "saddle", displayname: options.displayname ?? "Saddle", description: options.description ?? "Saddle engine operation", version: 1, inputs: options.inputs ?? ["main"], outputs: options.outputs ?? ["main"], triggers, actions, properties: options.properties ?? [{ displayname: "trigger", name: "trigger", type: "options", options: triggers.map((value) => ({ name: value, value })) }, { displayname: "command", name: "command", type: "options", options: actions.map((value) => ({ name: value, value })), default: "status" }] };
+}
+export const n8ntriggers = Object.freeze(["manual", "dispatch", "webhook", "schedule", "retry", "heartbeat"]);
+export const n8nactions = Object.freeze(["status", "scrape", "crawl", "extract", "batch", "browser", "memory", "sync"]);
+/** Matches an incoming event against the trigger declarations of a node. */
+export function n8nmatch(node, event = {}) { const type = String(event.type ?? "manual"); return { matched: Boolean(node?.triggers?.includes(type)), type, requestid: event.requestid ?? `${node?.name ?? "saddle"}/${type}` }; }
+/** Executes a declared n8n action through a caller-owned handler. */
+export async function n8nexecute(node, input, handler) {
+    if (typeof handler !== "function")
+        throw new TypeError("n8n handler is required");
+    const action = String(input?.action ?? input?.command ?? "status");
+    if (!node?.actions?.includes(action))
+        throw new TypeError(`unsupported n8n action: ${action}`);
+    try {
+        return await handler({ node, input: { ...(input ?? {}), action } });
+    }
+    catch (error) {
+        const failure = new Error(`n8n action failed: ${error?.message ?? error}`, { cause: error });
+        failure.code = String(error?.code ?? "N8N_ACTION_FAILED");
+        throw failure;
+    }
+}
+function normalize(values) { const list = Array.isArray(values) ? values : [values]; if (!list.length || list.some((value) => typeof value !== "string" || !value))
+    throw new TypeError("n8n declarations are invalid"); return [...new Set(list)]; }
+//# sourceMappingURL=n8n.js.map

package/dist/surfaces/n8n.js.map

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

package/dist/surfaces/operations.d.ts

@@ -0,0 +1,32 @@
+/**
+ * operations describe bounded telemetry, retention, recovery and threat boundaries without selecting storage or telemetry vendors.
+ */
+export declare const operationmetrics: readonly string[];
+/** Binds the standard operational metric names to an injected metric collector. */
+export declare function operationsmetrics(options?: {}): {
+    names: string[];
+    record: (name: any, value?: number, labels?: {}) => any;
+    snapshot: () => any;
+};
+/** Creates a deterministic retention policy for caller-owned records. */
+export declare function retentionpolicy(options?: {}): {
+    days: number;
+    maxbytes: number;
+    cutoff(now?: number): number;
+    keeps(record: any, now?: number): boolean;
+};
+/** Defines caller-owned backup and restore functions with explicit capability errors. */
+export declare function backupplan(options?: {}): {
+    version: number;
+    backup: (input: any) => Promise<any>;
+    restore: (input: any) => Promise<any>;
+};
+/** Records the security boundary and prevents the core from claiming threat coverage it does not own. */
+export declare function threatmodel(options?: {}): {
+    version: number;
+    boundaries: unknown[];
+    owner: any;
+    controls: unknown[];
+    disclaimer: string;
+};
+//# sourceMappingURL=operations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../surfaces/operations.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,gBAAgB,mBAAqG,CAAC;AAEnI,mFAAmF;AACnF,wBAAgB,iBAAiB,CAAC,OAAO,KAAK;;;;EAQ7C;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,OAAO,KAAK;;;;;EAK3C;AAED,yFAAyF;AACzF,wBAAgB,UAAU,CAAC,OAAO,KAAK;;;;EAItC;AAED,yGAAyG;AACzG,wBAAgB,WAAW,CAAC,OAAO,KAAK;;;;;;EAIvC"}

package/dist/surfaces/operations.js

@@ -0,0 +1,53 @@
+/**
+ * operations describe bounded telemetry, retention, recovery and threat boundaries without selecting storage or telemetry vendors.
+ */
+export const operationmetrics = Object.freeze(["latency", "retries", "queuedepth", "runnerselection", "storagebytes", "failures"]);
+/** Binds the standard operational metric names to an injected metric collector. */
+export function operationsmetrics(options = {}) {
+    const collector = options.collector;
+    if (!collector || typeof collector.count !== "function" || typeof collector.observe !== "function" || typeof collector.snapshot !== "function")
+        throw new TypeError("operations metrics requires a collector");
+    function record(name, value = 1, labels = {}) {
+        if (!operationmetrics.includes(name))
+            throw new TypeError(`unsupported operation metric: ${name}`);
+        return name === "latency" ? collector.observe(name, value, labels) : collector.count(name, value, labels);
+    }
+    return { names: [...operationmetrics], record, snapshot: () => collector.snapshot() };
+}
+/** Creates a deterministic retention policy for caller-owned records. */
+export function retentionpolicy(options = {}) {
+    const days = Number(options.days ?? 30);
+    const maxbytes = Number(options.maxbytes ?? Number.POSITIVE_INFINITY);
+    if (!Number.isFinite(days) || days < 0 || !Number.isFinite(maxbytes) || maxbytes < 0)
+        throw new TypeError("retention policy limits are invalid");
+    return { days, maxbytes, cutoff(now = Date.now()) { return Number(now) - days * 86400000; }, keeps(record, now = Date.now()) { return Number(record?.updatedat ?? record?.createdat ?? 0) >= this.cutoff(now) && Number(record?.bytes ?? 0) <= maxbytes; } };
+}
+/** Defines caller-owned backup and restore functions with explicit capability errors. */
+export function backupplan(options = {}) {
+    const backup = options.backup;
+    const restore = options.restore;
+    return { version: 1, backup: async (input) => execute(backup, input, "backup"), restore: async (input) => execute(restore, input, "restore") };
+}
+/** Records the security boundary and prevents the core from claiming threat coverage it does not own. */
+export function threatmodel(options = {}) {
+    const boundaries = [...new Set((options.boundaries ?? ["credentials", "network", "permissions", "persistence"]).map(String))];
+    if (!boundaries.length)
+        throw new TypeError("threat model requires boundaries");
+    return { version: 1, boundaries, owner: options.owner ?? "caller", controls: [...new Set((options.controls ?? []).map(String))], disclaimer: "The caller remains responsible for deployment, credentials, service terms and abuse response." };
+}
+async function execute(handler, input, name) {
+    if (typeof handler !== "function") {
+        const error = new Error(`${name} handler is not configured`);
+        error.code = "UNSUPPORTED_OPERATION";
+        throw error;
+    }
+    try {
+        return await handler(input);
+    }
+    catch (error) {
+        const failure = new Error(`${name} failed: ${error?.message ?? error}`, { cause: error });
+        failure.code = String(error?.code ?? "OPERATION_FAILED");
+        throw failure;
+    }
+}
+//# sourceMappingURL=operations.js.map

package/dist/surfaces/operations.js.map

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