@vibesdotdev/runnable 0.0.0-stage → 1.0.0-rc.1

package/dist/client/client.d.ts

@@ -0,0 +1,1002 @@
+import type { RunnableDescription } from '../schemas/description.ts';
+import type { RunnableCatalogWatchSnapshot } from '../schemas/runs.ts';
+import { BaseRuntimeClient, type RuntimeClientDescriptor } from "@vibesdotdev/kernel/client";
+import { type KindContext } from "@vibesdotdev/kernel";
+import type { JsonObject, JsonValue } from "@vibesdotdev/kernel/schemas/json";
+import type { RunnableResolvedDescriptor, RunnableRole } from "../schemas/descriptors.ts";
+import type { EntityKind, Outcome } from "../schemas/outcome.ts";
+import type { RunHandle, RunnableImplementation, RunnableControlInput, RunnableStartInput, RunnableClientCreateRunOptions, RunnableRunOptions, RecordedOutcome, RunnableVisualizationQuery } from "../schemas/contracts/index.ts";
+import { type RunnableNativeExecution, type RunnableReadQuery, type RunnableWatchSnapshot, type RunnableWatchOptions } from "../schemas/runs.ts";
+export type { RunnableClientCreateRunOptions, RunnableRunOptions, RecordedOutcome, RunnableVisualizationQuery, RunnableClientRuntime } from '../schemas/contracts/index.ts';
+export type { RunnableWatchOptions } from '../schemas/runs.ts';
+export { getVibesRunnableClient } from './resolve.ts';
+/** The runtime's single Runnable client; collaborators retain its existing owner boundaries. */
+export declare class RunnableClient extends BaseRuntimeClient {
+    private readonly records;
+    private readonly native;
+    private readonly completion;
+    private readonly controlsOwner;
+    private readonly recorded;
+    private readonly tracking;
+    private readonly panels;
+    private readonly transport;
+    private readonly selection;
+    private readonly supervision;
+    constructor(descriptor?: RuntimeClientDescriptor, context?: KindContext, runtime?: import("@vibesdotdev/kernel").VibesRuntime);
+    protected onLoad(): Promise<void>;
+    get eventsUrl(): string;
+    createRun(options: RunnableClientCreateRunOptions): Promise<RunHandle>;
+    start(input: RunnableStartInput): Promise<import("../index.ts").RunnableStartResult>;
+    select(query: {
+        role: RunnableRole;
+        entity?: EntityKind;
+    }): Promise<RunnableResolvedDescriptor[]>;
+    run<O = JsonValue>(id: string, input: JsonObject, options?: RunnableRunOptions): Promise<Outcome<O>>;
+    runAll<O = JsonValue>(query: {
+        role: RunnableRole;
+        entity?: EntityKind;
+    }, input: JsonObject, options?: RunnableRunOptions): Promise<Outcome<O>[]>;
+    runBest<O = JsonValue>(query: {
+        role: RunnableRole;
+        entity?: EntityKind;
+    }, input: JsonObject, options?: RunnableRunOptions): Promise<Outcome<O>>;
+    runRecorded<O = JsonValue>(id: string, input: JsonObject, options?: RunnableRunOptions): Promise<RecordedOutcome<O>>;
+    recordNativeExecution(id: string, input: JsonValue, execute: RunnableImplementation['execute'], options?: RunnableRunOptions, nativeExecution?: RunnableNativeExecution): Promise<RecordedOutcome>;
+    recordPreparedExecution(runId: string, execute: RunnableImplementation['execute'], nativeExecution: RunnableNativeExecution, options?: {
+        signal?: AbortSignal;
+        held?: NonNullable<Awaited<ReturnType<RunnableClient['inputAdmission']>>>;
+    }): Promise<RecordedOutcome>;
+    describe(id: string, receive: (description: RunnableDescription) => void | Promise<void>): Promise<void>;
+    describe(id: string): Promise<RunnableDescription>;
+    inputAdmission(runId: string, expectedConfig?: JsonObject): Promise<{
+        record: {
+            id: string;
+            scope: string;
+            status: string;
+            runnableType: string;
+            runnableId: string;
+            config: JsonObject;
+            progress: number;
+            startedAt: number;
+            metadata: JsonObject;
+            inputDigest: string;
+            name?: string | undefined;
+            endedAt?: number | undefined;
+            parentRunId?: string | undefined;
+            outcome?: {
+                status: "done";
+                value: JsonValue;
+            } | {
+                status: "not-done";
+                reason: string;
+                value?: JsonValue | undefined;
+                failure?: {
+                    code: string;
+                    message: string;
+                    name?: string | undefined;
+                    reason?: string | undefined;
+                    retryable?: boolean | undefined;
+                    recoveryHint?: string | undefined;
+                    details?: JsonValue | undefined;
+                } | undefined;
+            } | {
+                status: "disputed";
+                why: string;
+                claims: {
+                    id: string;
+                    statement: string;
+                    quote: {
+                        link: {
+                            kind: string;
+                            id: string;
+                            source: string;
+                            role: string;
+                        };
+                        scope: string;
+                        revision: {
+                            scheme: string;
+                            value: string;
+                        };
+                        text: string;
+                        anchor?: {
+                            kind: "code";
+                            path: string;
+                            startLine: number;
+                            endLine: number;
+                        } | {
+                            kind: "region";
+                            start: number;
+                            end: number;
+                        } | {
+                            kind: "fragment";
+                            id: string;
+                        } | {
+                            kind: "heading";
+                            slug: string;
+                        } | undefined;
+                        freshness?: {
+                            modifiedAt?: string | undefined;
+                            stale?: boolean | undefined;
+                        } | undefined;
+                    };
+                    via: string[];
+                    stale?: boolean | undefined;
+                }[];
+            } | {
+                status: "skipped";
+                reason: string;
+                cause: {
+                    kind: "cancelled";
+                    provenance: JsonValue;
+                } | {
+                    kind: "explicit";
+                } | {
+                    kind: "dependency";
+                    blockedBy: string[];
+                };
+            } | undefined;
+            ref?: {
+                jobId?: string | undefined;
+                aiCallRunId?: string | undefined;
+                ciRunId?: string | undefined;
+                executionReference?: string | undefined;
+            } | undefined;
+            rankReason?: {
+                named: true;
+            } | {
+                coldStart: true;
+                cost: number;
+            } | undefined;
+            approval?: "approved" | "assumed" | undefined;
+            activity?: {
+                message: string;
+                ts: number;
+            } | undefined;
+        };
+        admission: {
+            version: 1;
+            runId: string;
+            runnableId: string;
+            inputDigest: string;
+            configDigest: string;
+            owner: {
+                kind: "runnable/runnable" | "runnable/executor";
+                id: string;
+            };
+            enclosingRunId?: string | undefined;
+            context?: JsonObject | undefined;
+        };
+    } | null>;
+    attachInputAdmission(runId: string, config: JsonObject, jobId: string, known?: NonNullable<Awaited<ReturnType<RunnableClient['inputAdmission']>>>): Promise<{
+        record: {
+            id: string;
+            scope: string;
+            status: string;
+            runnableType: string;
+            runnableId: string;
+            config: JsonObject;
+            progress: number;
+            startedAt: number;
+            metadata: JsonObject;
+            inputDigest: string;
+            name?: string | undefined;
+            endedAt?: number | undefined;
+            parentRunId?: string | undefined;
+            outcome?: {
+                status: "done";
+                value: JsonValue;
+            } | {
+                status: "not-done";
+                reason: string;
+                value?: JsonValue | undefined;
+                failure?: {
+                    code: string;
+                    message: string;
+                    name?: string | undefined;
+                    reason?: string | undefined;
+                    retryable?: boolean | undefined;
+                    recoveryHint?: string | undefined;
+                    details?: JsonValue | undefined;
+                } | undefined;
+            } | {
+                status: "disputed";
+                why: string;
+                claims: {
+                    id: string;
+                    statement: string;
+                    quote: {
+                        link: {
+                            kind: string;
+                            id: string;
+                            source: string;
+                            role: string;
+                        };
+                        scope: string;
+                        revision: {
+                            scheme: string;
+                            value: string;
+                        };
+                        text: string;
+                        anchor?: {
+                            kind: "code";
+                            path: string;
+                            startLine: number;
+                            endLine: number;
+                        } | {
+                            kind: "region";
+                            start: number;
+                            end: number;
+                        } | {
+                            kind: "fragment";
+                            id: string;
+                        } | {
+                            kind: "heading";
+                            slug: string;
+                        } | undefined;
+                        freshness?: {
+                            modifiedAt?: string | undefined;
+                            stale?: boolean | undefined;
+                        } | undefined;
+                    };
+                    via: string[];
+                    stale?: boolean | undefined;
+                }[];
+            } | {
+                status: "skipped";
+                reason: string;
+                cause: {
+                    kind: "cancelled";
+                    provenance: JsonValue;
+                } | {
+                    kind: "explicit";
+                } | {
+                    kind: "dependency";
+                    blockedBy: string[];
+                };
+            } | undefined;
+            ref?: {
+                jobId?: string | undefined;
+                aiCallRunId?: string | undefined;
+                ciRunId?: string | undefined;
+                executionReference?: string | undefined;
+            } | undefined;
+            rankReason?: {
+                named: true;
+            } | {
+                coldStart: true;
+                cost: number;
+            } | undefined;
+            approval?: "approved" | "assumed" | undefined;
+            activity?: {
+                message: string;
+                ts: number;
+            } | undefined;
+        };
+        admission: {
+            version: 1;
+            runId: string;
+            runnableId: string;
+            inputDigest: string;
+            configDigest: string;
+            owner: {
+                kind: "runnable/runnable" | "runnable/executor";
+                id: string;
+            };
+            enclosingRunId?: string | undefined;
+            context?: JsonObject | undefined;
+        };
+    }>;
+    attachHandle(runId: string): Promise<RunHandle>;
+    /** Append producer or caller evidence through this record’s admitted writer. */
+    appendEvent(runId: string, type: string, payload: JsonObject): Promise<void>;
+    scopeIdentity(): Promise<string>;
+    runs(input: RunnableReadQuery): Promise<{
+        id: string;
+        status: string;
+        runnableType: string;
+        startedAt: number;
+        config: JsonObject;
+        metadata: JsonObject;
+        runnableId: string;
+        name?: string | undefined;
+        progress?: number | undefined;
+        endedAt?: number | null | undefined;
+        hostId?: string | undefined;
+        scope?: string | undefined;
+        inputDigest?: string | undefined;
+        parentRunId?: string | undefined;
+        outcome?: {
+            status: "done";
+            value: JsonValue;
+        } | {
+            status: "not-done";
+            reason: string;
+            value?: JsonValue | undefined;
+            failure?: {
+                code: string;
+                message: string;
+                name?: string | undefined;
+                reason?: string | undefined;
+                retryable?: boolean | undefined;
+                recoveryHint?: string | undefined;
+                details?: JsonValue | undefined;
+            } | undefined;
+        } | {
+            status: "disputed";
+            why: string;
+            claims: {
+                id: string;
+                statement: string;
+                quote: {
+                    link: {
+                        kind: string;
+                        id: string;
+                        source: string;
+                        role: string;
+                    };
+                    scope: string;
+                    revision: {
+                        scheme: string;
+                        value: string;
+                    };
+                    text: string;
+                    anchor?: {
+                        kind: "code";
+                        path: string;
+                        startLine: number;
+                        endLine: number;
+                    } | {
+                        kind: "region";
+                        start: number;
+                        end: number;
+                    } | {
+                        kind: "fragment";
+                        id: string;
+                    } | {
+                        kind: "heading";
+                        slug: string;
+                    } | undefined;
+                    freshness?: {
+                        modifiedAt?: string | undefined;
+                        stale?: boolean | undefined;
+                    } | undefined;
+                };
+                via: string[];
+                stale?: boolean | undefined;
+            }[];
+        } | {
+            status: "skipped";
+            reason: string;
+            cause: {
+                kind: "cancelled";
+                provenance: JsonValue;
+            } | {
+                kind: "explicit";
+            } | {
+                kind: "dependency";
+                blockedBy: string[];
+            };
+        } | undefined;
+        resultMode?: "void" | "value" | "outcome" | undefined;
+        ref?: {
+            jobId?: string | undefined;
+            aiCallRunId?: string | undefined;
+            ciRunId?: string | undefined;
+            executionReference?: string | undefined;
+        } | undefined;
+        rankReason?: {
+            named: true;
+        } | {
+            coldStart: true;
+            cost: number;
+        } | undefined;
+        approval?: "approved" | "assumed" | undefined;
+        activity?: {
+            message: string;
+            ts: number;
+        } | undefined;
+        context?: {
+            kindLabel?: string | undefined;
+            title?: string | undefined;
+            subject?: string | undefined;
+            target?: string | undefined;
+            phase?: string | undefined;
+            paths?: string[] | undefined;
+        } | undefined;
+    }[]>;
+    record(input: string): Promise<{
+        id: string;
+        scope: string;
+        status: string;
+        runnableType: string;
+        runnableId: string;
+        config: JsonObject;
+        progress: number;
+        startedAt: number;
+        metadata: JsonObject;
+        inputDigest: string;
+        name?: string | undefined;
+        endedAt?: number | undefined;
+        parentRunId?: string | undefined;
+        outcome?: {
+            status: "done";
+            value: JsonValue;
+        } | {
+            status: "not-done";
+            reason: string;
+            value?: JsonValue | undefined;
+            failure?: {
+                code: string;
+                message: string;
+                name?: string | undefined;
+                reason?: string | undefined;
+                retryable?: boolean | undefined;
+                recoveryHint?: string | undefined;
+                details?: JsonValue | undefined;
+            } | undefined;
+        } | {
+            status: "disputed";
+            why: string;
+            claims: {
+                id: string;
+                statement: string;
+                quote: {
+                    link: {
+                        kind: string;
+                        id: string;
+                        source: string;
+                        role: string;
+                    };
+                    scope: string;
+                    revision: {
+                        scheme: string;
+                        value: string;
+                    };
+                    text: string;
+                    anchor?: {
+                        kind: "code";
+                        path: string;
+                        startLine: number;
+                        endLine: number;
+                    } | {
+                        kind: "region";
+                        start: number;
+                        end: number;
+                    } | {
+                        kind: "fragment";
+                        id: string;
+                    } | {
+                        kind: "heading";
+                        slug: string;
+                    } | undefined;
+                    freshness?: {
+                        modifiedAt?: string | undefined;
+                        stale?: boolean | undefined;
+                    } | undefined;
+                };
+                via: string[];
+                stale?: boolean | undefined;
+            }[];
+        } | {
+            status: "skipped";
+            reason: string;
+            cause: {
+                kind: "cancelled";
+                provenance: JsonValue;
+            } | {
+                kind: "explicit";
+            } | {
+                kind: "dependency";
+                blockedBy: string[];
+            };
+        } | undefined;
+        ref?: {
+            jobId?: string | undefined;
+            aiCallRunId?: string | undefined;
+            ciRunId?: string | undefined;
+            executionReference?: string | undefined;
+        } | undefined;
+        rankReason?: {
+            named: true;
+        } | {
+            coldStart: true;
+            cost: number;
+        } | undefined;
+        approval?: "approved" | "assumed" | undefined;
+        activity?: {
+            message: string;
+            ts: number;
+        } | undefined;
+    } | null>;
+    observeNativeExecution(runId: string): Promise<{
+        status: string;
+        terminal: boolean;
+        generation: number;
+        receipt: JsonObject;
+        receiptId: string;
+        outcome?: {
+            status: "done";
+            value: JsonValue;
+        } | {
+            status: "not-done";
+            reason: string;
+            value?: JsonValue | undefined;
+            failure?: {
+                code: string;
+                message: string;
+                name?: string | undefined;
+                reason?: string | undefined;
+                retryable?: boolean | undefined;
+                recoveryHint?: string | undefined;
+                details?: JsonValue | undefined;
+            } | undefined;
+        } | {
+            status: "disputed";
+            why: string;
+            claims: {
+                id: string;
+                statement: string;
+                quote: {
+                    link: {
+                        kind: string;
+                        id: string;
+                        source: string;
+                        role: string;
+                    };
+                    scope: string;
+                    revision: {
+                        scheme: string;
+                        value: string;
+                    };
+                    text: string;
+                    anchor?: {
+                        kind: "code";
+                        path: string;
+                        startLine: number;
+                        endLine: number;
+                    } | {
+                        kind: "region";
+                        start: number;
+                        end: number;
+                    } | {
+                        kind: "fragment";
+                        id: string;
+                    } | {
+                        kind: "heading";
+                        slug: string;
+                    } | undefined;
+                    freshness?: {
+                        modifiedAt?: string | undefined;
+                        stale?: boolean | undefined;
+                    } | undefined;
+                };
+                via: string[];
+                stale?: boolean | undefined;
+            }[];
+        } | {
+            status: "skipped";
+            reason: string;
+            cause: {
+                kind: "cancelled";
+                provenance: JsonValue;
+            } | {
+                kind: "explicit";
+            } | {
+                kind: "dependency";
+                blockedBy: string[];
+            };
+        } | undefined;
+        progress?: number | undefined;
+        endedAt?: number | undefined;
+    } | null>;
+    reconcileNativeExecution(runId: string): Promise<{
+        status: string;
+        terminal: boolean;
+        generation: number;
+        receipt: JsonObject;
+        receiptId: string;
+        outcome?: {
+            status: "done";
+            value: JsonValue;
+        } | {
+            status: "not-done";
+            reason: string;
+            value?: JsonValue | undefined;
+            failure?: {
+                code: string;
+                message: string;
+                name?: string | undefined;
+                reason?: string | undefined;
+                retryable?: boolean | undefined;
+                recoveryHint?: string | undefined;
+                details?: JsonValue | undefined;
+            } | undefined;
+        } | {
+            status: "disputed";
+            why: string;
+            claims: {
+                id: string;
+                statement: string;
+                quote: {
+                    link: {
+                        kind: string;
+                        id: string;
+                        source: string;
+                        role: string;
+                    };
+                    scope: string;
+                    revision: {
+                        scheme: string;
+                        value: string;
+                    };
+                    text: string;
+                    anchor?: {
+                        kind: "code";
+                        path: string;
+                        startLine: number;
+                        endLine: number;
+                    } | {
+                        kind: "region";
+                        start: number;
+                        end: number;
+                    } | {
+                        kind: "fragment";
+                        id: string;
+                    } | {
+                        kind: "heading";
+                        slug: string;
+                    } | undefined;
+                    freshness?: {
+                        modifiedAt?: string | undefined;
+                        stale?: boolean | undefined;
+                    } | undefined;
+                };
+                via: string[];
+                stale?: boolean | undefined;
+            }[];
+        } | {
+            status: "skipped";
+            reason: string;
+            cause: {
+                kind: "cancelled";
+                provenance: JsonValue;
+            } | {
+                kind: "explicit";
+            } | {
+                kind: "dependency";
+                blockedBy: string[];
+            };
+        } | undefined;
+        progress?: number | undefined;
+        endedAt?: number | undefined;
+    }>;
+    snapshot(runId: string): Promise<{
+        metrics: {
+            kind: "metric";
+            key: string;
+            value: number;
+            ts: number;
+            dimensions?: JsonObject | undefined;
+        }[];
+        logs: {
+            kind: "log";
+            level: "error" | "info" | "warn" | "debug";
+            message: string;
+            ts: number;
+            data?: JsonValue | undefined;
+        }[];
+        artifacts: {
+            kind: "artifact";
+            id: string;
+            artifactKind: string;
+            name: string;
+            mimeType: string;
+            ts: number;
+            version?: string | undefined;
+            sequenceNo?: number | undefined;
+            hash?: string | undefined;
+            size?: number | undefined;
+            path?: string | undefined;
+            data?: string | undefined;
+            metadata?: JsonObject | undefined;
+        }[];
+        run: {
+            id: string;
+            status: string;
+            runnableType: string;
+            startedAt: number;
+            config: JsonObject;
+            metadata: JsonObject;
+            runnableId: string;
+            name?: string | undefined;
+            progress?: number | undefined;
+            endedAt?: number | null | undefined;
+            hostId?: string | undefined;
+            scope?: string | undefined;
+            inputDigest?: string | undefined;
+            parentRunId?: string | undefined;
+            outcome?: {
+                status: "done";
+                value: JsonValue;
+            } | {
+                status: "not-done";
+                reason: string;
+                value?: JsonValue | undefined;
+                failure?: {
+                    code: string;
+                    message: string;
+                    name?: string | undefined;
+                    reason?: string | undefined;
+                    retryable?: boolean | undefined;
+                    recoveryHint?: string | undefined;
+                    details?: JsonValue | undefined;
+                } | undefined;
+            } | {
+                status: "disputed";
+                why: string;
+                claims: {
+                    id: string;
+                    statement: string;
+                    quote: {
+                        link: {
+                            kind: string;
+                            id: string;
+                            source: string;
+                            role: string;
+                        };
+                        scope: string;
+                        revision: {
+                            scheme: string;
+                            value: string;
+                        };
+                        text: string;
+                        anchor?: {
+                            kind: "code";
+                            path: string;
+                            startLine: number;
+                            endLine: number;
+                        } | {
+                            kind: "region";
+                            start: number;
+                            end: number;
+                        } | {
+                            kind: "fragment";
+                            id: string;
+                        } | {
+                            kind: "heading";
+                            slug: string;
+                        } | undefined;
+                        freshness?: {
+                            modifiedAt?: string | undefined;
+                            stale?: boolean | undefined;
+                        } | undefined;
+                    };
+                    via: string[];
+                    stale?: boolean | undefined;
+                }[];
+            } | {
+                status: "skipped";
+                reason: string;
+                cause: {
+                    kind: "cancelled";
+                    provenance: JsonValue;
+                } | {
+                    kind: "explicit";
+                } | {
+                    kind: "dependency";
+                    blockedBy: string[];
+                };
+            } | undefined;
+            resultMode?: "void" | "value" | "outcome" | undefined;
+            ref?: {
+                jobId?: string | undefined;
+                aiCallRunId?: string | undefined;
+                ciRunId?: string | undefined;
+                executionReference?: string | undefined;
+            } | undefined;
+            rankReason?: {
+                named: true;
+            } | {
+                coldStart: true;
+                cost: number;
+            } | undefined;
+            approval?: "approved" | "assumed" | undefined;
+            activity?: {
+                message: string;
+                ts: number;
+            } | undefined;
+            context?: {
+                kindLabel?: string | undefined;
+                title?: string | undefined;
+                subject?: string | undefined;
+                target?: string | undefined;
+                phase?: string | undefined;
+                paths?: string[] | undefined;
+            } | undefined;
+        };
+        children: {
+            id: string;
+            status: string;
+            runnableType: string;
+            startedAt: number;
+            config: JsonObject;
+            metadata: JsonObject;
+            runnableId: string;
+            name?: string | undefined;
+            progress?: number | undefined;
+            endedAt?: number | null | undefined;
+            hostId?: string | undefined;
+            scope?: string | undefined;
+            inputDigest?: string | undefined;
+            parentRunId?: string | undefined;
+            outcome?: {
+                status: "done";
+                value: JsonValue;
+            } | {
+                status: "not-done";
+                reason: string;
+                value?: JsonValue | undefined;
+                failure?: {
+                    code: string;
+                    message: string;
+                    name?: string | undefined;
+                    reason?: string | undefined;
+                    retryable?: boolean | undefined;
+                    recoveryHint?: string | undefined;
+                    details?: JsonValue | undefined;
+                } | undefined;
+            } | {
+                status: "disputed";
+                why: string;
+                claims: {
+                    id: string;
+                    statement: string;
+                    quote: {
+                        link: {
+                            kind: string;
+                            id: string;
+                            source: string;
+                            role: string;
+                        };
+                        scope: string;
+                        revision: {
+                            scheme: string;
+                            value: string;
+                        };
+                        text: string;
+                        anchor?: {
+                            kind: "code";
+                            path: string;
+                            startLine: number;
+                            endLine: number;
+                        } | {
+                            kind: "region";
+                            start: number;
+                            end: number;
+                        } | {
+                            kind: "fragment";
+                            id: string;
+                        } | {
+                            kind: "heading";
+                            slug: string;
+                        } | undefined;
+                        freshness?: {
+                            modifiedAt?: string | undefined;
+                            stale?: boolean | undefined;
+                        } | undefined;
+                    };
+                    via: string[];
+                    stale?: boolean | undefined;
+                }[];
+            } | {
+                status: "skipped";
+                reason: string;
+                cause: {
+                    kind: "cancelled";
+                    provenance: JsonValue;
+                } | {
+                    kind: "explicit";
+                } | {
+                    kind: "dependency";
+                    blockedBy: string[];
+                };
+            } | undefined;
+            resultMode?: "void" | "value" | "outcome" | undefined;
+            ref?: {
+                jobId?: string | undefined;
+                aiCallRunId?: string | undefined;
+                ciRunId?: string | undefined;
+                executionReference?: string | undefined;
+            } | undefined;
+            rankReason?: {
+                named: true;
+            } | {
+                coldStart: true;
+                cost: number;
+            } | undefined;
+            approval?: "approved" | "assumed" | undefined;
+            activity?: {
+                message: string;
+                ts: number;
+            } | undefined;
+            context?: {
+                kindLabel?: string | undefined;
+                title?: string | undefined;
+                subject?: string | undefined;
+                target?: string | undefined;
+                phase?: string | undefined;
+                paths?: string[] | undefined;
+            } | undefined;
+        }[];
+        observation?: {
+            message: string;
+            ts: number;
+            logIndex: number;
+            label?: string | undefined;
+        } | undefined;
+    }>;
+    watchCatalog(query: RunnableReadQuery, listener: (snapshot: RunnableCatalogWatchSnapshot) => void | Promise<void>, options?: RunnableWatchOptions['onError'] | Pick<RunnableWatchOptions, 'signal' | 'onError'>): Promise<() => Promise<void>>;
+    watch(query: RunnableReadQuery, listener: (snapshot: RunnableWatchSnapshot) => void | Promise<void>, options?: RunnableWatchOptions): Promise<() => Promise<void>>;
+    watch(query: RunnableReadQuery, listener: (snapshot: RunnableWatchSnapshot) => void | Promise<void>, onError?: RunnableWatchOptions['onError'], options?: Pick<RunnableWatchOptions, 'signal' | 'projection'>): Promise<() => Promise<void>>;
+    visualizations(query: RunnableVisualizationQuery): Promise<{
+        id: string;
+        kind: "runnable/visualization";
+        telemetryId: string;
+        name?: string | undefined;
+        description?: string | undefined;
+        tags?: string[] | undefined;
+        hardware?: string[] | undefined;
+        enabled?: boolean | undefined;
+        priority?: number | undefined;
+        capabilityId?: string | undefined;
+        requiredContext?: string[] | undefined;
+        optionalContext?: string[] | undefined;
+        config?: unknown;
+        retention?: string | {
+            reason: string;
+            maxAgeDays?: number | undefined;
+            maxEntries?: number | undefined;
+            maxBytes?: number | undefined;
+            cascadeFrom?: string | undefined;
+            ageField?: string | undefined;
+            enforcedBy?: string | undefined;
+        } | undefined;
+        panelType?: "table" | "bar_chart" | "line_chart" | "heatmap" | "gauge" | "lattice" | undefined;
+        componentRef?: {
+            id: string;
+            version: string;
+        } | undefined;
+        componentParams?: {
+            [x: string]: JsonValue;
+            bind?: {
+                metric: string;
+                dimensions?: JsonObject | undefined;
+            } | {
+                event: string;
+                fields?: string[] | undefined;
+            } | {
+                children: {
+                    x: string;
+                    y: string;
+                    value: string;
+                };
+            } | {
+                artifact: string;
+            } | undefined;
+            metric?: string | undefined;
+        } | {
+            bind: {
+                metric: string;
+            };
+            metric?: string | undefined;
+        } | undefined;
+    }[]>;
+    hydrateState(): Promise<void>;
+    getState(): Promise<import("../index.ts").GenericRunStateManager>;
+    controls(runId: string): Promise<("stop" | "pause" | "resume")[]>;
+    control(input: RunnableControlInput): Promise<boolean>;
+    isSupervised(runId: string): Promise<boolean>;
+    status(runId: string): Promise<import("../index.ts").RunnableSupervisorStatus>;
+}
+export default RunnableClient;
+//# sourceMappingURL=client.d.ts.map