@wenathlan/saddle 2.0.154 → 2.0.159

package/dist/automation.d.ts

@@ -1,425 +0,0 @@
-/**
- * automation.ts — workflow, bot and surface automation contracts.
- *
- * This file is the v2.0.0 grand-merge consolidation of the former nested
- * folders of the repository (automation) into the single
- * root-level domain file of the saddle family standard: one optimized
- * TypeScript file per correlated domain, ordinal sections, JSDoc on every
- * block, intra-domain imports dissolved, cross-domain imports rewritten to
- * ./<domain>.js. Every capability of every source file is preserved here;
- * the pure re-export barrels (none in this domain) folded their surface into this file directly.
- */
-/**
- * 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;
-    errors?: undefined;
-    inputs?: undefined;
-    requestid?: undefined;
-} | {
-    matched: boolean;
-    type: string;
-    reason: string;
-    errors: any[];
-    inputs?: undefined;
-    requestid?: undefined;
-} | {
-    reason?: undefined;
-    errors?: undefined;
-    matched: boolean;
-    type: string;
-    inputs: {};
-    requestid: any;
-};
-/** Validates and normalizes caller-supplied workflow inputs against a manifest schema. */
-export declare function validateworkflowinputs(manifest: any, values?: {}): {
-    valid: boolean;
-    values: {};
-    errors: 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;
-        errors?: undefined;
-        inputs?: undefined;
-        requestid?: undefined;
-    } | {
-        matched: boolean;
-        type: string;
-        reason: string;
-        errors: any[];
-        inputs?: undefined;
-        requestid?: undefined;
-    } | {
-        reason?: undefined;
-        errors?: undefined;
-        matched: boolean;
-        type: string;
-        inputs: {};
-        requestid: any;
-    };
-    list: () => any[];
-};
-/**
- * command permissions keep bot actions explicit and platform neutral.
- */
-/** Creates a command guard from caller supplied command and scope policies. */
-export declare function commandguard(options?: {}): {
-    check: (input?: {}) => {
-        allowed: boolean;
-        command: string;
-        missing: any;
-        platform: any;
-    };
-};
-/**
- * command parsing keeps the bot surface serializable and platform neutral.
- */
-export declare function parsecommand(input: any): {
-    command: any;
-    flags: {};
-};
-/**
- * platform adapters expose only the operations a bot needs.
- */
-export declare function platformadapter(methods: any): any;
-/**
- * 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;
-    inputs: 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;
-};
-/**
- * workflow templates use explicit environment names and keep provider secrets external.
- */
-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;
-/**
- * workflow registry stores generated manifests and templates for later dispatch.
- */
-export declare function workflowregistry(): {
-    register(manifest: any): any;
-    get(name: any): any;
-    render(name: any, forge: any): any;
-    list(): any[];
-};
-/**
- * saddlebot unifies commands without owning a platform credential or scheduler.
- */
-export declare function saddlebot(options?: {}): {
-    register(name: any, adapter: any): any;
-    start(): Promise<{
-        status: string;
-        startedat: any;
-        commands: number;
-        adapters: string[];
-        tasks: any[];
-    }>;
-    stop(): Promise<{
-        status: string;
-        startedat: any;
-        commands: number;
-        adapters: string[];
-        tasks: any[];
-    }>;
-    executecommand: (input: any, context?: {}) => Promise<any>;
-    handlewebhook(platform: any, event: any): Promise<any>;
-    scheduletask(name: any, task: any, delay: any): any;
-    getstatus: () => {
-        status: string;
-        startedat: any;
-        commands: number;
-        adapters: string[];
-        tasks: any[];
-    };
-};
-/**
- * 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>;
-/**
- * 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;
-/** 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[];
-    };
-};
-/**
- * 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[];
-    };
-};
-/**
- * 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;
-};
-/**
- * application surface requirements describe Mini App, DNS, and bridge needs without owning credentials or infrastructure.
- */
-/** Creates a Mini App plan that requires caller-owned origin and validation. */
-export declare function miniappplan(input?: {}): Readonly<{
-    version: 1;
-    origin: any;
-    validation: string;
-    capabilities: readonly string[];
-    state: "caller-validates";
-    provider: string;
-}>;
-/** Creates a DNS and HTTPS requirement record without a registrar or DNS operation. */
-export declare function dnsplan(input?: {}): Readonly<{
-    version: 1;
-    hostname: string;
-    dnssec: boolean;
-    https: boolean;
-    owner: string;
-    state: "caller-configures";
-    operations: readonly string[];
-}>;
-/** Maps declared application surfaces without selecting a runtime vendor. */
-export declare function applicationbridge(input?: {}): Readonly<{
-    version: 1;
-    surfaces: any;
-    state: "caller-connects";
-}>;