@byokit/openclaw 0.1.0

package/dist/generated/params.d.ts

@@ -0,0 +1,1717 @@
+export type AuditRunInspectParams = {
+    runId: string;
+    executionId?: never;
+    executionCursor?: string;
+    executionLimit?: number;
+    decisionCursor?: string;
+    decisionLimit?: number;
+} | {
+    runId?: never;
+    executionId: string;
+    executionCursor?: never;
+    executionLimit?: never;
+    decisionCursor?: string;
+    decisionLimit?: number;
+};
+export type BoardActionParams = {
+    ticket: string;
+    action: "cron.trigger";
+    jobId: string;
+} | {
+    ticket: string;
+    action: string;
+    params?: Record<string, unknown>;
+};
+export type BoardEventParams = {
+    sessionKey: string;
+    agentId?: string;
+    widget: string;
+    payload: unknown;
+} | {
+    ticket: string;
+    payload: unknown;
+};
+export type ChatEvent = {
+    runId: string;
+    sessionKey: string;
+    agentId?: string;
+    spawnedBy?: string;
+    seq: number;
+    state: "status";
+    phase: "preparing_workspace" | "naming_worktree" | "creating_worktree" | "running_setup" | "provisioning_environment" | "preparing_context" | "starting_model";
+} | {
+    runId: string;
+    sessionKey: string;
+    agentId?: string;
+    spawnedBy?: string;
+    seq: number;
+    state: "delta";
+    message?: unknown;
+    deltaText: string;
+    replace?: boolean;
+    usage?: unknown;
+} | {
+    runId: string;
+    sessionKey: string;
+    agentId?: string;
+    spawnedBy?: string;
+    seq: number;
+    state: "final";
+    message?: unknown;
+    usage?: unknown;
+    stopReason?: string;
+    yielded?: true;
+} | {
+    runId: string;
+    sessionKey: string;
+    agentId?: string;
+    spawnedBy?: string;
+    seq: number;
+    state: "aborted";
+    message?: unknown;
+    errorMessage?: string;
+    stopReason?: string;
+} | {
+    runId: string;
+    sessionKey: string;
+    agentId?: string;
+    spawnedBy?: string;
+    seq: number;
+    state: "error";
+    message?: unknown;
+    errorMessage?: string;
+    errorKind?: "refusal" | "timeout" | "rate_limit" | "context_length" | "unknown";
+    usage?: unknown;
+    stopReason?: string;
+};
+export type ConversationTurnResult = {
+    conversationRef: string;
+    channel: string;
+    messageId: string;
+    correlationPersisted: boolean;
+    status: "replied";
+    reply: {
+        conversationRef: string;
+        messageId: string;
+        replyToId?: string;
+        threadId?: string;
+        text: string;
+        timestamp: number;
+        transcriptArtifactId?: string;
+        transcriptMessageId?: string;
+    };
+} | {
+    conversationRef: string;
+    channel: string;
+    messageId: string;
+    correlationPersisted: boolean;
+    status: "timeout";
+} | {
+    conversationRef: string;
+    channel: string;
+    messageId?: string;
+    correlationPersisted: boolean;
+    status: "sent" | "queued" | "suppressed" | "unknown";
+    error: string;
+};
+export type CronAddResult = {
+    id: string;
+    declarationKey?: string;
+    displayName?: string;
+    owner?: {
+        agentId?: string;
+        sessionKey?: string;
+        accountId?: string;
+    };
+    scheduledToolPolicy?: {
+        version: 1;
+        mode: "trusted";
+    } | {
+        version: 1;
+        mode: "account";
+        ownerSessionKey: string;
+        ownerAccountId: string;
+    };
+    agentId?: string;
+    sessionKey?: string;
+    name: string;
+    description?: string;
+    enabled: boolean;
+    deleteAfterRun?: boolean;
+    createdAtMs: number;
+    updatedAtMs: number;
+    configRevision?: string;
+    schedule: {
+        kind: "at";
+        at: string;
+    } | {
+        kind: "every";
+        everyMs: number;
+        anchorMs?: number;
+    } | {
+        kind: "cron";
+        expr: string;
+        tz?: string;
+        staggerMs?: number;
+    } | {
+        kind: "on-exit";
+        command: string;
+        cwd?: string;
+    } | {
+        kind: "stream";
+        command: string[];
+        cwd?: string;
+        mode?: "line" | "match";
+        match?: string;
+        batchMs?: number;
+        maxBatchBytes?: number;
+    };
+    pacing?: {
+        min?: string;
+        max?: string;
+    };
+    trigger?: {
+        script: string;
+        once?: boolean;
+    };
+    sessionTarget: "main" | "isolated" | "current" | string;
+    wakeMode: "next-heartbeat" | "now";
+    payload: {
+        kind: "systemEvent";
+        text: string;
+        toolsAllow?: string[];
+        toolsAllowIsDefault?: boolean;
+    } | {
+        kind: "agentTurn";
+        message: string;
+        model?: string;
+        fallbacks?: string[];
+        thinking?: string;
+        timeoutSeconds?: number;
+        allowUnsafeExternalContent?: boolean;
+        lightContext?: boolean;
+        toolsAllow?: string[];
+        toolsAllowIsDefault?: boolean;
+    } | {
+        kind: "command";
+        argv: string[];
+        cwd?: string;
+        env?: Record<string, string>;
+        input?: string;
+        timeoutSeconds?: number;
+        noOutputTimeoutSeconds?: number;
+        outputMaxBytes?: number;
+        toolsAllow?: string[];
+        toolsAllowIsDefault?: boolean;
+    } | {
+        kind: "script";
+        script: string;
+        timeoutSeconds?: number;
+        toolBudget?: number;
+        toolsAllow?: string[];
+        toolsAllowIsDefault?: boolean;
+    } | {
+        kind: "heartbeat";
+    } | {
+        kind: "skillCollectionReview";
+    };
+    delivery?: {
+        mode: "none";
+        channel?: "last" | string;
+        threadId?: string | number;
+        accountId?: string;
+        bestEffort?: boolean;
+        failureDestination?: {
+            channel?: "last" | string;
+            to?: string;
+            accountId?: string;
+            mode?: "announce" | "webhook";
+        };
+        to?: string;
+    } | {
+        mode: "announce";
+        channel?: "last" | string;
+        threadId?: string | number;
+        accountId?: string;
+        bestEffort?: boolean;
+        failureDestination?: {
+            channel?: "last" | string;
+            to?: string;
+            accountId?: string;
+            mode?: "announce" | "webhook";
+        };
+        completionDestination?: {
+            mode: "webhook";
+            to: string;
+        };
+        to?: string;
+    } | {
+        mode: "webhook";
+        channel?: "last" | string;
+        threadId?: string | number;
+        accountId?: string;
+        bestEffort?: boolean;
+        failureDestination?: {
+            channel?: "last" | string;
+            to?: string;
+            accountId?: string;
+            mode?: "announce" | "webhook";
+        };
+        to: string;
+    };
+    failureAlert?: false | {
+        after?: number;
+        channel?: "last" | string;
+        to?: string;
+        cooldownMs?: number;
+        includeSkipped?: boolean;
+        mode?: "announce" | "webhook";
+        accountId?: string;
+    };
+    state: {
+        nextRunAtMs?: number;
+        scheduleActivatedAtMs?: number;
+        runningAtMs?: number;
+        lastRunAtMs?: number;
+        lastRunStatus?: "ok" | "error" | "skipped";
+        lastStatus?: "ok" | "error" | "skipped";
+        lastError?: string;
+        lastDiagnostics?: {
+            summary?: string;
+            entries: {
+                ts: number;
+                source: "cron-preflight" | "cron-setup" | "model-preflight" | "agent-run" | "tool" | "exec" | "delivery";
+                severity: "info" | "warn" | "error";
+                message: string;
+                toolName?: string;
+                exitCode?: number | null;
+                truncated?: boolean;
+            }[];
+        };
+        lastDiagnosticSummary?: string;
+        lastErrorReason?: "auth" | "auth_permanent" | "format" | "rate_limit" | "overloaded" | "billing" | "server_error" | "timeout" | "tls_certificate" | "context_overflow" | "model_not_found" | "session_expired" | "empty_response" | "no_error_details" | "unclassified" | "unknown";
+        lastDurationMs?: number;
+        consecutiveErrors?: number;
+        autoDisabled?: {
+            reason: "consecutive-failures" | "schedule-errors";
+            atMs: number;
+            consecutiveErrors: number;
+        };
+        consecutiveSkipped?: number;
+        lastDelivered?: boolean;
+        lastDeliveryStatus?: "delivered" | "not-delivered" | "unknown" | "not-requested";
+        lastDeliveryError?: string;
+        deliverySuppressionReason?: string;
+        lastFailureNotificationDelivered?: boolean;
+        lastFailureNotificationDeliveryStatus?: "delivered" | "not-delivered" | "unknown" | "not-requested";
+        lastFailureNotificationDeliveryError?: string;
+        lastFailureAlertAtMs?: number;
+        lastTriggerEvalAtMs?: number;
+        triggerEvalCount?: number;
+        lastTriggerFireAtMs?: number;
+        triggerState?: unknown;
+        streamStatus?: "starting" | "running" | "restarting" | "stopped" | "disabled" | "error";
+        streamError?: string;
+        streamConsecutiveFailures?: number;
+        streamRestartExhausted?: boolean;
+        streamSourceIdentity?: string;
+        streamDroppedBatches?: number;
+        streamCoalescedBatches?: number;
+        streamLastStartedAtMs?: number;
+        streamLastExitAtMs?: number;
+    };
+    nextRunAtMs?: number;
+    lastRunAtMs?: number;
+    lastRunStatus?: "ok" | "error" | "skipped";
+    lastRunError?: string;
+    lastDelivered?: boolean;
+    lastDeliveryStatus?: "delivered" | "not-delivered" | "unknown" | "not-requested";
+    lastDeliveryError?: string;
+    deliverySuppressionReason?: string;
+    lastFailureNotificationDelivered?: boolean;
+    lastFailureNotificationDeliveryStatus?: "delivered" | "not-delivered" | "unknown" | "not-requested";
+    lastFailureNotificationDeliveryError?: string;
+} | {
+    created: boolean;
+    updated?: boolean;
+    job: {
+        id: string;
+        declarationKey?: string;
+        displayName?: string;
+        owner?: {
+            agentId?: string;
+            sessionKey?: string;
+            accountId?: string;
+        };
+        scheduledToolPolicy?: {
+            version: 1;
+            mode: "trusted";
+        } | {
+            version: 1;
+            mode: "account";
+            ownerSessionKey: string;
+            ownerAccountId: string;
+        };
+        agentId?: string;
+        sessionKey?: string;
+        name: string;
+        description?: string;
+        enabled: boolean;
+        deleteAfterRun?: boolean;
+        createdAtMs: number;
+        updatedAtMs: number;
+        configRevision?: string;
+        schedule: {
+            kind: "at";
+            at: string;
+        } | {
+            kind: "every";
+            everyMs: number;
+            anchorMs?: number;
+        } | {
+            kind: "cron";
+            expr: string;
+            tz?: string;
+            staggerMs?: number;
+        } | {
+            kind: "on-exit";
+            command: string;
+            cwd?: string;
+        } | {
+            kind: "stream";
+            command: string[];
+            cwd?: string;
+            mode?: "line" | "match";
+            match?: string;
+            batchMs?: number;
+            maxBatchBytes?: number;
+        };
+        pacing?: {
+            min?: string;
+            max?: string;
+        };
+        trigger?: {
+            script: string;
+            once?: boolean;
+        };
+        sessionTarget: "main" | "isolated" | "current" | string;
+        wakeMode: "next-heartbeat" | "now";
+        payload: {
+            kind: "systemEvent";
+            text: string;
+            toolsAllow?: string[];
+            toolsAllowIsDefault?: boolean;
+        } | {
+            kind: "agentTurn";
+            message: string;
+            model?: string;
+            fallbacks?: string[];
+            thinking?: string;
+            timeoutSeconds?: number;
+            allowUnsafeExternalContent?: boolean;
+            lightContext?: boolean;
+            toolsAllow?: string[];
+            toolsAllowIsDefault?: boolean;
+        } | {
+            kind: "command";
+            argv: string[];
+            cwd?: string;
+            env?: Record<string, string>;
+            input?: string;
+            timeoutSeconds?: number;
+            noOutputTimeoutSeconds?: number;
+            outputMaxBytes?: number;
+            toolsAllow?: string[];
+            toolsAllowIsDefault?: boolean;
+        } | {
+            kind: "script";
+            script: string;
+            timeoutSeconds?: number;
+            toolBudget?: number;
+            toolsAllow?: string[];
+            toolsAllowIsDefault?: boolean;
+        } | {
+            kind: "heartbeat";
+        } | {
+            kind: "skillCollectionReview";
+        };
+        delivery?: {
+            mode: "none";
+            channel?: "last" | string;
+            threadId?: string | number;
+            accountId?: string;
+            bestEffort?: boolean;
+            failureDestination?: {
+                channel?: "last" | string;
+                to?: string;
+                accountId?: string;
+                mode?: "announce" | "webhook";
+            };
+            to?: string;
+        } | {
+            mode: "announce";
+            channel?: "last" | string;
+            threadId?: string | number;
+            accountId?: string;
+            bestEffort?: boolean;
+            failureDestination?: {
+                channel?: "last" | string;
+                to?: string;
+                accountId?: string;
+                mode?: "announce" | "webhook";
+            };
+            completionDestination?: {
+                mode: "webhook";
+                to: string;
+            };
+            to?: string;
+        } | {
+            mode: "webhook";
+            channel?: "last" | string;
+            threadId?: string | number;
+            accountId?: string;
+            bestEffort?: boolean;
+            failureDestination?: {
+                channel?: "last" | string;
+                to?: string;
+                accountId?: string;
+                mode?: "announce" | "webhook";
+            };
+            to: string;
+        };
+        failureAlert?: false | {
+            after?: number;
+            channel?: "last" | string;
+            to?: string;
+            cooldownMs?: number;
+            includeSkipped?: boolean;
+            mode?: "announce" | "webhook";
+            accountId?: string;
+        };
+        state: {
+            nextRunAtMs?: number;
+            scheduleActivatedAtMs?: number;
+            runningAtMs?: number;
+            lastRunAtMs?: number;
+            lastRunStatus?: "ok" | "error" | "skipped";
+            lastStatus?: "ok" | "error" | "skipped";
+            lastError?: string;
+            lastDiagnostics?: {
+                summary?: string;
+                entries: {
+                    ts: number;
+                    source: "cron-preflight" | "cron-setup" | "model-preflight" | "agent-run" | "tool" | "exec" | "delivery";
+                    severity: "info" | "warn" | "error";
+                    message: string;
+                    toolName?: string;
+                    exitCode?: number | null;
+                    truncated?: boolean;
+                }[];
+            };
+            lastDiagnosticSummary?: string;
+            lastErrorReason?: "auth" | "auth_permanent" | "format" | "rate_limit" | "overloaded" | "billing" | "server_error" | "timeout" | "tls_certificate" | "context_overflow" | "model_not_found" | "session_expired" | "empty_response" | "no_error_details" | "unclassified" | "unknown";
+            lastDurationMs?: number;
+            consecutiveErrors?: number;
+            autoDisabled?: {
+                reason: "consecutive-failures" | "schedule-errors";
+                atMs: number;
+                consecutiveErrors: number;
+            };
+            consecutiveSkipped?: number;
+            lastDelivered?: boolean;
+            lastDeliveryStatus?: "delivered" | "not-delivered" | "unknown" | "not-requested";
+            lastDeliveryError?: string;
+            deliverySuppressionReason?: string;
+            lastFailureNotificationDelivered?: boolean;
+            lastFailureNotificationDeliveryStatus?: "delivered" | "not-delivered" | "unknown" | "not-requested";
+            lastFailureNotificationDeliveryError?: string;
+            lastFailureAlertAtMs?: number;
+            lastTriggerEvalAtMs?: number;
+            triggerEvalCount?: number;
+            lastTriggerFireAtMs?: number;
+            triggerState?: unknown;
+            streamStatus?: "starting" | "running" | "restarting" | "stopped" | "disabled" | "error";
+            streamError?: string;
+            streamConsecutiveFailures?: number;
+            streamRestartExhausted?: boolean;
+            streamSourceIdentity?: string;
+            streamDroppedBatches?: number;
+            streamCoalescedBatches?: number;
+            streamLastStartedAtMs?: number;
+            streamLastExitAtMs?: number;
+        };
+        nextRunAtMs?: number;
+        lastRunAtMs?: number;
+        lastRunStatus?: "ok" | "error" | "skipped";
+        lastRunError?: string;
+        lastDelivered?: boolean;
+        lastDeliveryStatus?: "delivered" | "not-delivered" | "unknown" | "not-requested";
+        lastDeliveryError?: string;
+        deliverySuppressionReason?: string;
+        lastFailureNotificationDelivered?: boolean;
+        lastFailureNotificationDeliveryStatus?: "delivered" | "not-delivered" | "unknown" | "not-requested";
+        lastFailureNotificationDeliveryError?: string;
+    };
+};
+export type CronGetParams = {
+    id: string;
+} | {
+    jobId: string;
+};
+export type CronRemoveParams = {
+    id: string;
+} | {
+    jobId: string;
+};
+export type CronRunParams = {
+    id: string;
+    mode?: "due" | "force" | "if-enabled";
+    expectedProcessInstanceId?: string;
+} | {
+    jobId: string;
+    mode?: "due" | "force" | "if-enabled";
+    expectedProcessInstanceId?: string;
+};
+export type CronScratchGetParams = {
+    id: string;
+} | {
+    jobId: string;
+};
+export type CronScratchSetParams = {
+    id: string;
+    content: string | null;
+    expectedRevision?: number;
+} | {
+    jobId: string;
+    content: string | null;
+    expectedRevision?: number;
+};
+export type CronScratchSetResult = {
+    ok: true;
+    scratch: {
+        content: string;
+        revision: number;
+        updatedAtMs: number;
+    } | null;
+    currentRevision: number;
+    maxBytes: number;
+} | {
+    ok: false;
+    reason: "revision-conflict";
+    currentRevision: number;
+};
+export type CronUpdateParams = {
+    id: string;
+    patch: {
+        name?: string;
+        displayName?: string | null;
+        agentId?: string | null;
+        sessionKey?: string | null;
+        description?: string;
+        enabled?: boolean;
+        deleteAfterRun?: boolean;
+        schedule?: {
+            kind: "at";
+            at: string;
+        } | {
+            kind: "every";
+            everyMs: number;
+            anchorMs?: number;
+        } | {
+            kind: "cron";
+            expr: string;
+            tz?: string;
+            staggerMs?: number;
+        } | {
+            kind: "on-exit";
+            command: string;
+            cwd?: string;
+        } | {
+            kind: "stream";
+            command: string[];
+            cwd?: string;
+            mode?: "line" | "match";
+            match?: string;
+            batchMs?: number;
+            maxBatchBytes?: number;
+        };
+        pacing?: {
+            min?: string;
+            max?: string;
+        } | null;
+        trigger?: {
+            script: string;
+            once?: boolean;
+        } | null;
+        sessionTarget?: "main" | "isolated" | "current" | string;
+        wakeMode?: "next-heartbeat" | "now";
+        payload?: {
+            kind: "systemEvent";
+            text?: string;
+            toolsAllow?: string[] | null;
+            toolsAllowIsDefault?: boolean;
+        } | {
+            kind: "agentTurn";
+            message?: string;
+            model?: string | null;
+            fallbacks?: string[] | null;
+            thinking?: string | null;
+            timeoutSeconds?: number;
+            allowUnsafeExternalContent?: boolean;
+            lightContext?: boolean;
+            toolsAllow?: string[] | null;
+            toolsAllowIsDefault?: boolean;
+        } | {
+            kind: "command";
+            argv?: string[];
+            cwd?: string;
+            env?: Record<string, string>;
+            input?: string;
+            timeoutSeconds?: number;
+            noOutputTimeoutSeconds?: number;
+            outputMaxBytes?: number;
+            toolsAllow?: string[] | null;
+            toolsAllowIsDefault?: boolean;
+        } | {
+            kind: "script";
+            script?: string;
+            timeoutSeconds?: number;
+            toolBudget?: number;
+            toolsAllow?: string[] | null;
+            toolsAllowIsDefault?: boolean;
+        };
+        delivery?: {
+            mode?: "none" | "announce" | "webhook";
+            channel?: "last" | string | null;
+            threadId?: string | number | null;
+            accountId?: string | null;
+            bestEffort?: boolean;
+            failureDestination?: {
+                channel?: "last" | string | null;
+                to?: string | null;
+                accountId?: string | null;
+                mode?: "announce" | "webhook" | null;
+            } | null;
+            completionDestination?: {
+                mode: "webhook";
+                to: string;
+            } | null;
+            to?: string | null;
+        };
+        failureAlert?: false | {
+            after?: number | null;
+            channel?: "last" | string | null;
+            to?: string | null;
+            cooldownMs?: number | null;
+            includeSkipped?: boolean | null;
+            mode?: "announce" | "webhook" | null;
+            accountId?: string | null;
+        } | null;
+        state?: {
+            nextRunAtMs?: number;
+            runningAtMs?: number;
+            lastRunAtMs?: number;
+            lastRunStatus?: "ok" | "error" | "skipped";
+            lastStatus?: "ok" | "error" | "skipped";
+            lastError?: string;
+            lastErrorReason?: "auth" | "auth_permanent" | "format" | "rate_limit" | "overloaded" | "billing" | "server_error" | "timeout" | "tls_certificate" | "context_overflow" | "model_not_found" | "session_expired" | "empty_response" | "no_error_details" | "unclassified" | "unknown";
+            lastDurationMs?: number;
+            consecutiveErrors?: number;
+            consecutiveSkipped?: number;
+            lastDelivered?: boolean;
+            lastDeliveryStatus?: "delivered" | "not-delivered" | "unknown" | "not-requested";
+            lastDeliveryError?: string;
+            lastFailureNotificationDelivered?: boolean;
+            lastFailureNotificationDeliveryStatus?: "delivered" | "not-delivered" | "unknown" | "not-requested";
+            lastFailureNotificationDeliveryError?: string;
+            lastFailureAlertAtMs?: number;
+            lastTriggerEvalAtMs?: number;
+            triggerEvalCount?: number;
+            lastTriggerFireAtMs?: number;
+            triggerState?: unknown;
+            streamStatus?: "starting" | "running" | "restarting" | "stopped" | "disabled" | "error";
+            streamError?: string;
+            streamConsecutiveFailures?: number;
+            streamRestartExhausted?: boolean;
+            streamDroppedBatches?: number;
+            streamCoalescedBatches?: number;
+            streamLastStartedAtMs?: number;
+            streamLastExitAtMs?: number;
+        };
+    };
+    expectedConfigRevision?: string;
+} | {
+    jobId: string;
+    patch: {
+        name?: string;
+        displayName?: string | null;
+        agentId?: string | null;
+        sessionKey?: string | null;
+        description?: string;
+        enabled?: boolean;
+        deleteAfterRun?: boolean;
+        schedule?: {
+            kind: "at";
+            at: string;
+        } | {
+            kind: "every";
+            everyMs: number;
+            anchorMs?: number;
+        } | {
+            kind: "cron";
+            expr: string;
+            tz?: string;
+            staggerMs?: number;
+        } | {
+            kind: "on-exit";
+            command: string;
+            cwd?: string;
+        } | {
+            kind: "stream";
+            command: string[];
+            cwd?: string;
+            mode?: "line" | "match";
+            match?: string;
+            batchMs?: number;
+            maxBatchBytes?: number;
+        };
+        pacing?: {
+            min?: string;
+            max?: string;
+        } | null;
+        trigger?: {
+            script: string;
+            once?: boolean;
+        } | null;
+        sessionTarget?: "main" | "isolated" | "current" | string;
+        wakeMode?: "next-heartbeat" | "now";
+        payload?: {
+            kind: "systemEvent";
+            text?: string;
+            toolsAllow?: string[] | null;
+            toolsAllowIsDefault?: boolean;
+        } | {
+            kind: "agentTurn";
+            message?: string;
+            model?: string | null;
+            fallbacks?: string[] | null;
+            thinking?: string | null;
+            timeoutSeconds?: number;
+            allowUnsafeExternalContent?: boolean;
+            lightContext?: boolean;
+            toolsAllow?: string[] | null;
+            toolsAllowIsDefault?: boolean;
+        } | {
+            kind: "command";
+            argv?: string[];
+            cwd?: string;
+            env?: Record<string, string>;
+            input?: string;
+            timeoutSeconds?: number;
+            noOutputTimeoutSeconds?: number;
+            outputMaxBytes?: number;
+            toolsAllow?: string[] | null;
+            toolsAllowIsDefault?: boolean;
+        } | {
+            kind: "script";
+            script?: string;
+            timeoutSeconds?: number;
+            toolBudget?: number;
+            toolsAllow?: string[] | null;
+            toolsAllowIsDefault?: boolean;
+        };
+        delivery?: {
+            mode?: "none" | "announce" | "webhook";
+            channel?: "last" | string | null;
+            threadId?: string | number | null;
+            accountId?: string | null;
+            bestEffort?: boolean;
+            failureDestination?: {
+                channel?: "last" | string | null;
+                to?: string | null;
+                accountId?: string | null;
+                mode?: "announce" | "webhook" | null;
+            } | null;
+            completionDestination?: {
+                mode: "webhook";
+                to: string;
+            } | null;
+            to?: string | null;
+        };
+        failureAlert?: false | {
+            after?: number | null;
+            channel?: "last" | string | null;
+            to?: string | null;
+            cooldownMs?: number | null;
+            includeSkipped?: boolean | null;
+            mode?: "announce" | "webhook" | null;
+            accountId?: string | null;
+        } | null;
+        state?: {
+            nextRunAtMs?: number;
+            runningAtMs?: number;
+            lastRunAtMs?: number;
+            lastRunStatus?: "ok" | "error" | "skipped";
+            lastStatus?: "ok" | "error" | "skipped";
+            lastError?: string;
+            lastErrorReason?: "auth" | "auth_permanent" | "format" | "rate_limit" | "overloaded" | "billing" | "server_error" | "timeout" | "tls_certificate" | "context_overflow" | "model_not_found" | "session_expired" | "empty_response" | "no_error_details" | "unclassified" | "unknown";
+            lastDurationMs?: number;
+            consecutiveErrors?: number;
+            consecutiveSkipped?: number;
+            lastDelivered?: boolean;
+            lastDeliveryStatus?: "delivered" | "not-delivered" | "unknown" | "not-requested";
+            lastDeliveryError?: string;
+            lastFailureNotificationDelivered?: boolean;
+            lastFailureNotificationDeliveryStatus?: "delivered" | "not-delivered" | "unknown" | "not-requested";
+            lastFailureNotificationDeliveryError?: string;
+            lastFailureAlertAtMs?: number;
+            lastTriggerEvalAtMs?: number;
+            triggerEvalCount?: number;
+            lastTriggerFireAtMs?: number;
+            triggerState?: unknown;
+            streamStatus?: "starting" | "running" | "restarting" | "stopped" | "disabled" | "error";
+            streamError?: string;
+            streamConsecutiveFailures?: number;
+            streamRestartExhausted?: boolean;
+            streamDroppedBatches?: number;
+            streamCoalescedBatches?: number;
+            streamLastStartedAtMs?: number;
+            streamLastExitAtMs?: number;
+        };
+    };
+    expectedConfigRevision?: string;
+};
+export type DesktopObserveParams = {
+    source: {
+        kind: "host";
+    };
+    control?: boolean;
+    credentials?: {
+        username?: string;
+        password?: string;
+    };
+} | {
+    source: {
+        kind: "environment";
+        environmentId: string;
+    };
+    control?: boolean;
+} | {
+    source: {
+        kind: "node";
+        nodeId: string;
+    };
+    control?: boolean;
+    credentials?: {
+        username?: string;
+        password?: string;
+    };
+};
+export type ExecApprovalsNodeSetParams = {
+    nodeId: string;
+    file: {
+        version: 1;
+        socket?: {
+            path?: string;
+            token?: string;
+        };
+        defaults?: {
+            security?: string;
+            ask?: string;
+            askFallback?: string;
+            autoAllowSkills?: boolean;
+        };
+        agents?: Record<string, {
+            security?: string;
+            ask?: string;
+            askFallback?: string;
+            autoAllowSkills?: boolean;
+            allowlist?: {
+                id?: string;
+                pattern: string;
+                source?: "allow-always";
+                commandText?: string;
+                argPattern?: string;
+                lastUsedAt?: number;
+                lastUsedCommand?: string;
+                lastResolvedPath?: string;
+            }[];
+        }>;
+    };
+    native?: never;
+    baseHash?: string;
+} | {
+    nodeId: string;
+    file?: never;
+    native: {
+        defaultAction?: "allow" | "deny" | "prompt";
+        rules: {
+            pattern: string;
+            action: "allow" | "deny" | "prompt";
+            shells?: string[];
+            description?: string;
+            enabled?: boolean;
+        }[];
+    };
+    baseHash: string;
+};
+export type GatewaySuspendPrepareResult = {
+    status: "busy";
+    reason: "active-work" | "gateway-draining";
+    retryAfterMs: number;
+    activeCount: number;
+    blockers: {
+        kind: "queue" | "reply" | "embedded-run" | "background-exec" | "cron-run" | "task" | "root-request" | "session-admission" | "session-mutation" | "chat-run" | "queued-turn" | "terminal-persistence" | "terminal-session";
+        count: number;
+        message: string;
+        task?: {
+            taskId: string;
+            status: "running";
+            runtime: "subagent" | "acp" | "cli" | "cron";
+            runId?: string;
+            label?: string;
+            title?: string;
+        };
+    }[];
+} | {
+    status: "draining";
+    suspensionId: string;
+    expiresAtMs: number;
+    retryAfterMs: number;
+    activeCount: number;
+    blockers: {
+        kind: "queue" | "reply" | "embedded-run" | "background-exec" | "cron-run" | "task" | "root-request" | "session-admission" | "session-mutation" | "chat-run" | "queued-turn" | "terminal-persistence" | "terminal-session";
+        count: number;
+        message: string;
+        task?: {
+            taskId: string;
+            status: "running";
+            runtime: "subagent" | "acp" | "cli" | "cron";
+            runId?: string;
+            label?: string;
+            title?: string;
+        };
+    }[];
+} | {
+    status: "ready";
+    suspensionId: string;
+    expiresAtMs: number;
+    activeCount: number;
+    blockers: {
+        kind: "queue" | "reply" | "embedded-run" | "background-exec" | "cron-run" | "task" | "root-request" | "session-admission" | "session-mutation" | "chat-run" | "queued-turn" | "terminal-persistence" | "terminal-session";
+        count: number;
+        message: string;
+        task?: {
+            taskId: string;
+            status: "running";
+            runtime: "subagent" | "acp" | "cli" | "cron";
+            runId?: string;
+            label?: string;
+            title?: string;
+        };
+    }[];
+};
+export type GatewaySuspendStatusResult = {
+    status: "running";
+} | {
+    status: "draining";
+    expiresAtMs: number;
+    retryAfterMs: number;
+    activeCount: number;
+    blockers: {
+        kind: "queue" | "reply" | "embedded-run" | "background-exec" | "cron-run" | "task" | "root-request" | "session-admission" | "session-mutation" | "chat-run" | "queued-turn" | "terminal-persistence" | "terminal-session";
+        count: number;
+        message: string;
+        task?: {
+            taskId: string;
+            status: "running";
+            runtime: "subagent" | "acp" | "cli" | "cron";
+            runId?: string;
+            label?: string;
+            title?: string;
+        };
+    }[];
+} | {
+    status: "ready";
+    expiresAtMs: number;
+};
+export type PluginsInstallParams = {
+    source: "clawhub";
+    packageName: string;
+    version?: string;
+    acknowledgeInstallPolicyWarning?: true;
+    acknowledgeCapabilities?: {
+        reviewToken: string;
+    };
+} | {
+    source: "official";
+    pluginId: string;
+    acknowledgeInstallPolicyWarning?: true;
+    acknowledgeCapabilities?: {
+        reviewToken: string;
+    };
+};
+export type PluginsSessionActionResult = {
+    ok: true;
+    result?: unknown;
+    continueAgent?: boolean;
+    reply?: unknown;
+} | {
+    ok: false;
+    error: string;
+    code?: string;
+    details?: unknown;
+};
+export type QuestionResolveParams = {
+    id: string;
+    answers: {
+        answers: Record<string, string[]>;
+    };
+    secretStoreAllowedHosts?: string[];
+    resolvedBy?: string;
+} | {
+    id: string;
+    cancel: true;
+    resolvedBy?: string;
+};
+export type QuestionResolveResult = {
+    status: "answered";
+    answers: {
+        answers: Record<string, string[]>;
+    };
+} | {
+    status: "cancelled";
+};
+export type QuestionResolvedEvent = {
+    id: string;
+    status: "answered";
+    answers: {
+        answers: Record<string, string[]>;
+    };
+} | {
+    id: string;
+    status: "cancelled";
+} | {
+    id: string;
+    status: "expired";
+};
+export type QuestionWaitAnswerResult = {
+    status: "pending";
+} | {
+    status: "answered";
+    answers: {
+        answers: Record<string, string[]>;
+    };
+} | {
+    status: "cancelled";
+} | {
+    status: "expired";
+};
+export type SessionApprovalEvent = {
+    sessionKey: string;
+    sourceSessionKey?: string;
+    updatedAtMs: number;
+    phase: "pending";
+    approval: {
+        id: string;
+        urlPath: string;
+        createdAtMs: number;
+        expiresAtMs: number;
+        presentation: {
+            kind: "exec";
+            commandText: string;
+            commandPreview?: string | null;
+            warningText?: string | null;
+            host?: string | null;
+            nodeId?: string | null;
+            agentId?: string | null;
+            scope?: {
+                kind: "message-send";
+                target: string;
+                recipientCount: number;
+                recipients?: string[];
+                audience?: "internal" | "external";
+            } | {
+                kind: "payment";
+                amount: string;
+                currency: string;
+                target: string;
+            } | {
+                kind: "external-post";
+                target: string;
+                visibility: "public" | "restricted";
+            } | {
+                kind: "standing-grant";
+                automation: string;
+                command: string;
+                expiresInDays?: number;
+            };
+            allowedDecisions: ("allow-once" | "allow-always" | "deny")[];
+        } | {
+            kind: "plugin";
+            title: string;
+            description: string;
+            detail?: string;
+            severity: "info" | "warning" | "critical";
+            pluginId?: string | null;
+            toolName?: string | null;
+            agentId?: string | null;
+            scope?: {
+                kind: "message-send";
+                target: string;
+                recipientCount: number;
+                recipients?: string[];
+                audience?: "internal" | "external";
+            } | {
+                kind: "payment";
+                amount: string;
+                currency: string;
+                target: string;
+            } | {
+                kind: "external-post";
+                target: string;
+                visibility: "public" | "restricted";
+            } | {
+                kind: "standing-grant";
+                automation: string;
+                command: string;
+                expiresInDays?: number;
+            };
+            allowedDecisions: ("allow-once" | "allow-always" | "deny")[];
+        } | {
+            kind: "system-agent";
+            title: string;
+            description: string;
+            proposalHash: string;
+            agentId?: string | null;
+            allowedDecisions: ["allow-once", "deny"];
+        };
+        status: "pending";
+        sourceSessionKey?: string;
+    };
+} | {
+    sessionKey: string;
+    sourceSessionKey?: string;
+    updatedAtMs: number;
+    phase: "terminal";
+    approval: {
+        id: string;
+        urlPath: string;
+        createdAtMs: number;
+        expiresAtMs: number;
+        presentation: {
+            kind: "exec";
+            commandText: string;
+            commandPreview?: string | null;
+            warningText?: string | null;
+            host?: string | null;
+            nodeId?: string | null;
+            agentId?: string | null;
+            scope?: {
+                kind: "message-send";
+                target: string;
+                recipientCount: number;
+                recipients?: string[];
+                audience?: "internal" | "external";
+            } | {
+                kind: "payment";
+                amount: string;
+                currency: string;
+                target: string;
+            } | {
+                kind: "external-post";
+                target: string;
+                visibility: "public" | "restricted";
+            } | {
+                kind: "standing-grant";
+                automation: string;
+                command: string;
+                expiresInDays?: number;
+            };
+            allowedDecisions: ("allow-once" | "allow-always" | "deny")[];
+        } | {
+            kind: "plugin";
+            title: string;
+            description: string;
+            detail?: string;
+            severity: "info" | "warning" | "critical";
+            pluginId?: string | null;
+            toolName?: string | null;
+            agentId?: string | null;
+            scope?: {
+                kind: "message-send";
+                target: string;
+                recipientCount: number;
+                recipients?: string[];
+                audience?: "internal" | "external";
+            } | {
+                kind: "payment";
+                amount: string;
+                currency: string;
+                target: string;
+            } | {
+                kind: "external-post";
+                target: string;
+                visibility: "public" | "restricted";
+            } | {
+                kind: "standing-grant";
+                automation: string;
+                command: string;
+                expiresInDays?: number;
+            };
+            allowedDecisions: ("allow-once" | "allow-always" | "deny")[];
+        } | {
+            kind: "system-agent";
+            title: string;
+            description: string;
+            proposalHash: string;
+            agentId?: string | null;
+            allowedDecisions: ["allow-once", "deny"];
+        };
+        resolvedAtMs: number;
+        source?: {
+            agentId?: string;
+            sessionKey?: string;
+        };
+        resolver?: {
+            kind: "device" | "channel" | "runtime" | "system";
+            id?: string;
+        };
+        status: "allowed";
+        decision: "allow-once" | "allow-always";
+        reason: "user";
+    } | {
+        id: string;
+        urlPath: string;
+        createdAtMs: number;
+        expiresAtMs: number;
+        presentation: {
+            kind: "exec";
+            commandText: string;
+            commandPreview?: string | null;
+            warningText?: string | null;
+            host?: string | null;
+            nodeId?: string | null;
+            agentId?: string | null;
+            scope?: {
+                kind: "message-send";
+                target: string;
+                recipientCount: number;
+                recipients?: string[];
+                audience?: "internal" | "external";
+            } | {
+                kind: "payment";
+                amount: string;
+                currency: string;
+                target: string;
+            } | {
+                kind: "external-post";
+                target: string;
+                visibility: "public" | "restricted";
+            } | {
+                kind: "standing-grant";
+                automation: string;
+                command: string;
+                expiresInDays?: number;
+            };
+            allowedDecisions: ("allow-once" | "allow-always" | "deny")[];
+        } | {
+            kind: "plugin";
+            title: string;
+            description: string;
+            detail?: string;
+            severity: "info" | "warning" | "critical";
+            pluginId?: string | null;
+            toolName?: string | null;
+            agentId?: string | null;
+            scope?: {
+                kind: "message-send";
+                target: string;
+                recipientCount: number;
+                recipients?: string[];
+                audience?: "internal" | "external";
+            } | {
+                kind: "payment";
+                amount: string;
+                currency: string;
+                target: string;
+            } | {
+                kind: "external-post";
+                target: string;
+                visibility: "public" | "restricted";
+            } | {
+                kind: "standing-grant";
+                automation: string;
+                command: string;
+                expiresInDays?: number;
+            };
+            allowedDecisions: ("allow-once" | "allow-always" | "deny")[];
+        } | {
+            kind: "system-agent";
+            title: string;
+            description: string;
+            proposalHash: string;
+            agentId?: string | null;
+            allowedDecisions: ["allow-once", "deny"];
+        };
+        resolvedAtMs: number;
+        source?: {
+            agentId?: string;
+            sessionKey?: string;
+        };
+        resolver?: {
+            kind: "device" | "channel" | "runtime" | "system";
+            id?: string;
+        };
+        status: "denied";
+        decision: "deny";
+        reason: "user" | "malformed-verdict" | "no-route" | "storage-corrupt";
+    } | {
+        id: string;
+        urlPath: string;
+        createdAtMs: number;
+        expiresAtMs: number;
+        presentation: {
+            kind: "exec";
+            commandText: string;
+            commandPreview?: string | null;
+            warningText?: string | null;
+            host?: string | null;
+            nodeId?: string | null;
+            agentId?: string | null;
+            scope?: {
+                kind: "message-send";
+                target: string;
+                recipientCount: number;
+                recipients?: string[];
+                audience?: "internal" | "external";
+            } | {
+                kind: "payment";
+                amount: string;
+                currency: string;
+                target: string;
+            } | {
+                kind: "external-post";
+                target: string;
+                visibility: "public" | "restricted";
+            } | {
+                kind: "standing-grant";
+                automation: string;
+                command: string;
+                expiresInDays?: number;
+            };
+            allowedDecisions: ("allow-once" | "allow-always" | "deny")[];
+        } | {
+            kind: "plugin";
+            title: string;
+            description: string;
+            detail?: string;
+            severity: "info" | "warning" | "critical";
+            pluginId?: string | null;
+            toolName?: string | null;
+            agentId?: string | null;
+            scope?: {
+                kind: "message-send";
+                target: string;
+                recipientCount: number;
+                recipients?: string[];
+                audience?: "internal" | "external";
+            } | {
+                kind: "payment";
+                amount: string;
+                currency: string;
+                target: string;
+            } | {
+                kind: "external-post";
+                target: string;
+                visibility: "public" | "restricted";
+            } | {
+                kind: "standing-grant";
+                automation: string;
+                command: string;
+                expiresInDays?: number;
+            };
+            allowedDecisions: ("allow-once" | "allow-always" | "deny")[];
+        } | {
+            kind: "system-agent";
+            title: string;
+            description: string;
+            proposalHash: string;
+            agentId?: string | null;
+            allowedDecisions: ["allow-once", "deny"];
+        };
+        resolvedAtMs: number;
+        source?: {
+            agentId?: string;
+            sessionKey?: string;
+        };
+        resolver?: {
+            kind: "device" | "channel" | "runtime" | "system";
+            id?: string;
+        };
+        status: "expired";
+        reason: "timeout";
+    } | {
+        id: string;
+        urlPath: string;
+        createdAtMs: number;
+        expiresAtMs: number;
+        presentation: {
+            kind: "exec";
+            commandText: string;
+            commandPreview?: string | null;
+            warningText?: string | null;
+            host?: string | null;
+            nodeId?: string | null;
+            agentId?: string | null;
+            scope?: {
+                kind: "message-send";
+                target: string;
+                recipientCount: number;
+                recipients?: string[];
+                audience?: "internal" | "external";
+            } | {
+                kind: "payment";
+                amount: string;
+                currency: string;
+                target: string;
+            } | {
+                kind: "external-post";
+                target: string;
+                visibility: "public" | "restricted";
+            } | {
+                kind: "standing-grant";
+                automation: string;
+                command: string;
+                expiresInDays?: number;
+            };
+            allowedDecisions: ("allow-once" | "allow-always" | "deny")[];
+        } | {
+            kind: "plugin";
+            title: string;
+            description: string;
+            detail?: string;
+            severity: "info" | "warning" | "critical";
+            pluginId?: string | null;
+            toolName?: string | null;
+            agentId?: string | null;
+            scope?: {
+                kind: "message-send";
+                target: string;
+                recipientCount: number;
+                recipients?: string[];
+                audience?: "internal" | "external";
+            } | {
+                kind: "payment";
+                amount: string;
+                currency: string;
+                target: string;
+            } | {
+                kind: "external-post";
+                target: string;
+                visibility: "public" | "restricted";
+            } | {
+                kind: "standing-grant";
+                automation: string;
+                command: string;
+                expiresInDays?: number;
+            };
+            allowedDecisions: ("allow-once" | "allow-always" | "deny")[];
+        } | {
+            kind: "system-agent";
+            title: string;
+            description: string;
+            proposalHash: string;
+            agentId?: string | null;
+            allowedDecisions: ["allow-once", "deny"];
+        };
+        resolvedAtMs: number;
+        source?: {
+            agentId?: string;
+            sessionKey?: string;
+        };
+        resolver?: {
+            kind: "device" | "channel" | "runtime" | "system";
+            id?: string;
+        };
+        status: "cancelled";
+        reason: "run-aborted" | "gateway-restart";
+    };
+};
+export type SessionsDispatchParams = {
+    key: string;
+    agentId?: string;
+    profileId: string;
+    deviceId?: never;
+    autoDevice?: never;
+    machineClass?: string;
+} | {
+    key: string;
+    agentId?: string;
+    profileId?: never;
+    deviceId: string;
+    autoDevice?: never;
+    machineClass?: never;
+} | {
+    key: string;
+    agentId?: string;
+    profileId?: never;
+    deviceId?: never;
+    autoDevice: true;
+    machineClass?: never;
+} | {
+    key: string;
+    agentId?: string;
+    profileId?: never;
+    deviceId?: never;
+    autoDevice?: never;
+    machineClass?: never;
+};
+export type SessionsGoalUpdateParams = {
+    sessionKey: string;
+    agentId?: string;
+    sessionId?: string;
+    goalId: string;
+    operationId: string;
+    issuedAtMs: number;
+    action: "edit";
+    objective: string;
+} | {
+    sessionKey: string;
+    agentId?: string;
+    sessionId?: string;
+    goalId: string;
+    operationId: string;
+    issuedAtMs: number;
+    action: "pause" | "resume" | "complete" | "block";
+    note?: string;
+};
+export type SessionsResolveResult = {
+    ok: true;
+    key: string;
+    agentId: string;
+    displayName?: string;
+    boardFace?: "chat" | "dashboard";
+} | {
+    ok: false;
+    candidates?: {
+        key: string;
+        agentId: string;
+        displayName?: string;
+        boardFace?: "chat" | "dashboard";
+    }[];
+};
+export type SkillsInstallParams = {
+    agentId?: string;
+    name: string;
+    installId: string;
+    dangerouslyForceUnsafeInstall?: boolean;
+    timeoutMs?: number;
+} | {
+    agentId?: string;
+    source: "clawhub";
+    slug: string;
+    version?: string;
+    force?: boolean;
+    timeoutMs?: number;
+} | {
+    agentId?: string;
+    source: "upload";
+    uploadId: string;
+    slug: string;
+    force?: boolean;
+    sha256?: string;
+    timeoutMs?: number;
+};
+export type SkillsUpdateParams = {
+    skillKey: string;
+    enabled?: boolean;
+    apiKey?: string;
+    env?: Record<string, string>;
+} | {
+    agentId?: string;
+    source: "clawhub";
+    slug?: string;
+    all?: boolean;
+    force?: boolean;
+};
+export type SystemAgentSetupVerifyResult = {
+    ok: true;
+    modelRef: string;
+    latencyMs: number;
+} | {
+    ok: false;
+    status: "auth" | "rate_limit" | "billing" | "timeout" | "format" | "unavailable" | "unknown";
+    error: string;
+};
+export type TalkClientCreateResult = {
+    provider: string;
+    transport: "webrtc";
+    voiceSessionId: string;
+    clientSecret: string;
+    offerUrl?: string;
+    offerHeaders?: Record<string, string>;
+    model?: string;
+    voice?: string;
+    expiresAt?: number;
+    clientControl?: {
+        owner: "gateway";
+    };
+} | {
+    provider: string;
+    transport: "provider-websocket";
+    voiceSessionId: string;
+    protocol: string;
+    clientSecret: string;
+    websocketUrl: string;
+    audio: {
+        inputEncoding: "pcm16" | "g711_ulaw";
+        inputSampleRateHz: number;
+        outputEncoding: "pcm16" | "g711_ulaw";
+        outputSampleRateHz: number;
+    };
+    initialMessage?: unknown;
+    model?: string;
+    voice?: string;
+    expiresAt?: number;
+} | {
+    provider: string;
+    transport: "gateway-relay";
+    voiceSessionId?: string;
+    relaySessionId: string;
+    audio: {
+        inputEncoding: "pcm16" | "g711_ulaw";
+        inputSampleRateHz: number;
+        outputEncoding: "pcm16" | "g711_ulaw";
+        outputSampleRateHz: number;
+    };
+    model?: string;
+    voice?: string;
+    expiresAt?: number;
+} | {
+    provider: string;
+    transport: "managed-room";
+    voiceSessionId?: string;
+    roomUrl: string;
+    token?: string;
+    model?: string;
+    voice?: string;
+    expiresAt?: number;
+};
+export type TaskSuggestionEvent = {
+    action: "created";
+    suggestion: {
+        id: string;
+        title: string;
+        prompt: string;
+        tldr: string;
+        cwd: string;
+        sessionKey: string;
+        agentId?: string;
+        createdAt: number;
+    };
+} | {
+    action: "resolved";
+    taskId: string;
+    resolution: "dismissed" | "accepted" | "expired";
+};