@fungi.computer/oyster 0.0.0-stage → 0.1.0

package/dist/standalone/workflow-host.d.ts

@@ -0,0 +1,931 @@
+import * as S from "effect/Schema";
+import { type Catalog, type DispatchResult, type NodeAdmissionResult, type NodeCall, type NodeEvent } from "@fungi.computer/braid";
+import { type OysterHost } from "../host.js";
+import { type InvocationFacts } from "../invocation.js";
+import type { AppMethodCallContext } from "@fungi.computer/puffball/app-method-runtime";
+import type { WatchdogSqliteOwner } from "@fungi.computer/watchdog";
+import { type GraphStartRequest, type WorkflowCatalogEntry, type WorkflowRunAuthority, type WorkflowGitPassNode, type WorkflowRunDelivery } from "@fungi.computer/braid/runtime";
+import { type AppEventFact } from "@fungi.computer/puffball/app-event-facts";
+export type StandaloneWorkflowHost = Pick<OysterHost, "installations" | "artifacts" | "instances" | "computerId" | "git" | "capabilities" | "keys">;
+type CatalogMethodSummary = Readonly<{
+    pending?: true;
+    description: string;
+    effect: Catalog[string]["methods"][string]["effect"];
+    approval: Catalog[string]["methods"][string]["approval"];
+    requires: Catalog[string]["methods"][string]["requires"];
+    digest: string;
+}>;
+type CatalogEventSummary = Readonly<{
+    description: string;
+    digest: string;
+}>;
+/** The standalone host's installation admission, above the portable engine. */
+export declare function createStandaloneWorkflowHost(owner: WatchdogSqliteOwner, host: StandaloneWorkflowHost, options: Readonly<{
+    authority(libraryInstallationId: string): WorkflowRunAuthority;
+    /** Whether this member may have run endings reported to the Agent Session. */
+    admitDelivery(memberId: string, delivery: WorkflowRunDelivery): Promise<boolean>;
+}>): {
+    store: {
+        read: (runId: string) => import("@fungi.computer/braid/runtime").GraphRun | null;
+        list(filter: {
+            installationId: string;
+            actorId?: string;
+            workflowId?: string;
+        }): readonly (import("@fungi.computer/braid/runtime").GraphRun & {
+            startedAt: number;
+        })[];
+        active(): readonly import("@fungi.computer/braid/runtime").GraphRun[];
+        outcome(runId: string): "active" | "terminal" | "cancelled" | null;
+        markTerminal(runId: string, outcome?: "terminal" | "cancelled"): void;
+        startCompiled: (input: import("@fungi.computer/braid/runtime").GraphRun) => "started" | "replay" | "conflict";
+        start(input: import("@fungi.computer/braid/runtime").GraphRun): Promise<"started" | "replay" | "conflict">;
+        recordEvent(input: NodeEvent): void;
+        events(runId: string): readonly NodeEvent[];
+        openReview(input: import("@fungi.computer/braid").GraphReview): number;
+        reviews(runId: string): {
+            review: {
+                readonly show: readonly S.Json[];
+                readonly title: string;
+                readonly timeout: number;
+                readonly runId: string;
+                readonly nodeId: string;
+                readonly reviewers: "runner" | "owners";
+                readonly iteration: string;
+                readonly instanceId: string;
+                readonly eventType: string;
+                readonly choices?: readonly string[];
+            };
+            status: "closed" | "pending" | "answered" | "delivered" | "timed_out";
+            openedAt: number;
+            expiresAt: number;
+        }[];
+        answerReview(key: Pick<import("@fungi.computer/braid").GraphReview, "runId" | "nodeId" | "iteration">, answer: {
+            readonly approved: boolean;
+        } | {
+            readonly choice: string;
+            readonly note?: string | undefined;
+        }, reviewer: import("@fungi.computer/braid/runtime").GraphReviewer): "accepted" | "denied" | "not_waiting" | "invalid";
+        pendingReviewDeliveries(runId: string): readonly import("@fungi.computer/braid/runtime").ReviewDelivery[];
+        markReviewDelivered(delivery: import("@fungi.computer/braid/runtime").ReviewDelivery): void;
+    };
+    caller: (runId: string) => AppMethodCallContext;
+    admitLibrary: (installationId: string, operation: string) => Promise<{
+        installation: Readonly<{
+            installationId: string;
+            instanceId: import("../index.js").InstanceId | null;
+            appId: import("@fungi.computer/puffball").AppId;
+            release: {
+                readonly releaseId: import("@fungi.computer/puffball").ReleaseId;
+                readonly appId: import("@fungi.computer/puffball").AppId;
+                readonly artifact: {
+                    readonly artifactRef: import("@fungi.computer/puffball").ArtifactRef;
+                    readonly artifactDigest: import("@fungi.computer/puffball").Sha256Digest;
+                    readonly provenance: {
+                        readonly sourceRevision: import("@fungi.computer/puffball").SourceRevision;
+                        readonly sourceTreeDigest: import("@fungi.computer/puffball").Sha256Digest;
+                        readonly buildRecipeDigest: import("@fungi.computer/puffball").Sha256Digest;
+                    };
+                };
+            };
+            releasePin: "pinned" | "floating";
+            authorityVersion: number;
+            status: "enabled" | "disabled" | "deleted";
+            visibility: "private" | "public";
+            declaredOperationsDigest: import("@fungi.computer/puffball").Sha256Digest;
+            approvedGrants: readonly Readonly<{
+                capability: "agent.list" | "agent.manage" | "agent.rename" | "agent.toolPolicy" | "agent.read" | "agent.send" | "computer.list" | "computer.readFile" | "computer.writeFile" | "computer.execute" | "llm.generation" | "media.generation" | "games:servers" | "git.repository" | "apps.open" | "apps.call" | "app.storage" | "app.events.emit" | "team.workbenchHost" | "marketplace.browse" | "marketplace.purchase" | "workflow.run" | "workflow.publish" | "workflow.arm" | "world" | "channels.read" | "channels.personal.manage";
+                capabilityApproved: true;
+                operations: readonly string[];
+                resources: "tenant-scope" | readonly Readonly<{
+                    kind: string;
+                    id: string;
+                }>[];
+            }>[];
+            approval: Readonly<{
+                by: {
+                    kind: "member";
+                    memberId: string;
+                } | {
+                    kind: "agent";
+                    agentId: string;
+                } | {
+                    kind: "team-key";
+                    keyId: string;
+                };
+                at: number;
+                authorityVersion: number;
+            }> | null;
+            approvedAnonymousMethods: readonly Readonly<{
+                name: string;
+                digest: import("@fungi.computer/puffball").Sha256Digest;
+            }>[];
+            anonymousApproval: Readonly<{
+                by: {
+                    kind: "member";
+                    memberId: string;
+                } | {
+                    kind: "agent";
+                    agentId: string;
+                } | {
+                    kind: "team-key";
+                    keyId: string;
+                };
+                at: number;
+                authorityVersion: number;
+            }> | null;
+        }>;
+        verified: Readonly<{
+            release: import("@fungi.computer/puffball").Release;
+            build: import("@fungi.computer/puffball/app").AppBuild;
+            api: import("@fungi.computer/puffball").AppApi | null;
+            declaration: import("@fungi.computer/puffball").AppDeclaration | null;
+            ui: Readonly<{
+                kind: "html";
+                artifactRef: import("@fungi.computer/puffball").ArtifactRef;
+                digest: import("@fungi.computer/puffball").Sha256Digest;
+            }> | Readonly<{
+                kind: "assets";
+                build: import("@fungi.computer/puffball/assets").AssetBuild;
+            }> | null;
+            backend: Readonly<{
+                artifactRef: import("@fungi.computer/puffball").ArtifactRef;
+                digest: import("@fungi.computer/puffball").Sha256Digest;
+            }> | null;
+        }>;
+    }>;
+    admitInvocation: (raw: InvocationFacts, operation: string) => Promise<{
+        libraryId: string;
+        context: {
+            computerId: string | null;
+            actor: {
+                kind: "member";
+                memberId: string;
+            } | {
+                kind: "agent";
+                agentId: string;
+            } | {
+                kind: "team-key";
+                keyId: string;
+            };
+            backgroundLane?: string | undefined;
+            backgroundOrigin?: {
+                method: string;
+                seal: string;
+            } | undefined;
+            role?: "member" | "owner" | undefined;
+            soleMember?: true | undefined;
+            workflow?: {
+                workflowId: string;
+                runId: string;
+                nodeId: string;
+                armedBy: {
+                    kind: "member";
+                    memberId: string;
+                } | {
+                    kind: "agent";
+                    agentId: string;
+                } | {
+                    kind: "team-key";
+                    keyId: string;
+                };
+            } | undefined;
+            idempotencyKey?: string | undefined;
+        };
+        installationAuthority: {
+            selection: {
+                readonly instanceId: import("../index.js").InstanceId;
+                readonly owner: {
+                    readonly kind: "installation" | "deployment";
+                    readonly id: string;
+                };
+                readonly appId: import("@fungi.computer/puffball").AppId;
+                readonly releaseId: import("@fungi.computer/puffball").ReleaseId;
+                readonly authorityVersion: number;
+            };
+            artifactDigest: import("@fungi.computer/puffball").Sha256Digest;
+        };
+        installation: Readonly<{
+            installationId: string;
+            instanceId: import("../index.js").InstanceId | null;
+            appId: import("@fungi.computer/puffball").AppId;
+            release: {
+                readonly releaseId: import("@fungi.computer/puffball").ReleaseId;
+                readonly appId: import("@fungi.computer/puffball").AppId;
+                readonly artifact: {
+                    readonly artifactRef: import("@fungi.computer/puffball").ArtifactRef;
+                    readonly artifactDigest: import("@fungi.computer/puffball").Sha256Digest;
+                    readonly provenance: {
+                        readonly sourceRevision: import("@fungi.computer/puffball").SourceRevision;
+                        readonly sourceTreeDigest: import("@fungi.computer/puffball").Sha256Digest;
+                        readonly buildRecipeDigest: import("@fungi.computer/puffball").Sha256Digest;
+                    };
+                };
+            };
+            releasePin: "pinned" | "floating";
+            authorityVersion: number;
+            status: "enabled" | "disabled" | "deleted";
+            visibility: "private" | "public";
+            declaredOperationsDigest: import("@fungi.computer/puffball").Sha256Digest;
+            approvedGrants: readonly Readonly<{
+                capability: "agent.list" | "agent.manage" | "agent.rename" | "agent.toolPolicy" | "agent.read" | "agent.send" | "computer.list" | "computer.readFile" | "computer.writeFile" | "computer.execute" | "llm.generation" | "media.generation" | "games:servers" | "git.repository" | "apps.open" | "apps.call" | "app.storage" | "app.events.emit" | "team.workbenchHost" | "marketplace.browse" | "marketplace.purchase" | "workflow.run" | "workflow.publish" | "workflow.arm" | "world" | "channels.read" | "channels.personal.manage";
+                capabilityApproved: true;
+                operations: readonly string[];
+                resources: "tenant-scope" | readonly Readonly<{
+                    kind: string;
+                    id: string;
+                }>[];
+            }>[];
+            approval: Readonly<{
+                by: {
+                    kind: "member";
+                    memberId: string;
+                } | {
+                    kind: "agent";
+                    agentId: string;
+                } | {
+                    kind: "team-key";
+                    keyId: string;
+                };
+                at: number;
+                authorityVersion: number;
+            }> | null;
+            approvedAnonymousMethods: readonly Readonly<{
+                name: string;
+                digest: import("@fungi.computer/puffball").Sha256Digest;
+            }>[];
+            anonymousApproval: Readonly<{
+                by: {
+                    kind: "member";
+                    memberId: string;
+                } | {
+                    kind: "agent";
+                    agentId: string;
+                } | {
+                    kind: "team-key";
+                    keyId: string;
+                };
+                at: number;
+                authorityVersion: number;
+            }> | null;
+        }>;
+        verified: Readonly<{
+            release: import("@fungi.computer/puffball").Release;
+            build: import("@fungi.computer/puffball/app").AppBuild;
+            api: import("@fungi.computer/puffball").AppApi | null;
+            declaration: import("@fungi.computer/puffball").AppDeclaration | null;
+            ui: Readonly<{
+                kind: "html";
+                artifactRef: import("@fungi.computer/puffball").ArtifactRef;
+                digest: import("@fungi.computer/puffball").Sha256Digest;
+            }> | Readonly<{
+                kind: "assets";
+                build: import("@fungi.computer/puffball/assets").AssetBuild;
+            }> | null;
+            backend: Readonly<{
+                artifactRef: import("@fungi.computer/puffball").ArtifactRef;
+                digest: import("@fungi.computer/puffball").Sha256Digest;
+            }> | null;
+        }>;
+    }>;
+    triggerAuthority: (installationId: string) => Promise<{
+        installation: Readonly<{
+            installationId: string;
+            instanceId: import("../index.js").InstanceId | null;
+            appId: import("@fungi.computer/puffball").AppId;
+            release: {
+                readonly releaseId: import("@fungi.computer/puffball").ReleaseId;
+                readonly appId: import("@fungi.computer/puffball").AppId;
+                readonly artifact: {
+                    readonly artifactRef: import("@fungi.computer/puffball").ArtifactRef;
+                    readonly artifactDigest: import("@fungi.computer/puffball").Sha256Digest;
+                    readonly provenance: {
+                        readonly sourceRevision: import("@fungi.computer/puffball").SourceRevision;
+                        readonly sourceTreeDigest: import("@fungi.computer/puffball").Sha256Digest;
+                        readonly buildRecipeDigest: import("@fungi.computer/puffball").Sha256Digest;
+                    };
+                };
+            };
+            releasePin: "pinned" | "floating";
+            authorityVersion: number;
+            status: "enabled" | "disabled" | "deleted";
+            visibility: "private" | "public";
+            declaredOperationsDigest: import("@fungi.computer/puffball").Sha256Digest;
+            approvedGrants: readonly Readonly<{
+                capability: "agent.list" | "agent.manage" | "agent.rename" | "agent.toolPolicy" | "agent.read" | "agent.send" | "computer.list" | "computer.readFile" | "computer.writeFile" | "computer.execute" | "llm.generation" | "media.generation" | "games:servers" | "git.repository" | "apps.open" | "apps.call" | "app.storage" | "app.events.emit" | "team.workbenchHost" | "marketplace.browse" | "marketplace.purchase" | "workflow.run" | "workflow.publish" | "workflow.arm" | "world" | "channels.read" | "channels.personal.manage";
+                capabilityApproved: true;
+                operations: readonly string[];
+                resources: "tenant-scope" | readonly Readonly<{
+                    kind: string;
+                    id: string;
+                }>[];
+            }>[];
+            approval: Readonly<{
+                by: {
+                    kind: "member";
+                    memberId: string;
+                } | {
+                    kind: "agent";
+                    agentId: string;
+                } | {
+                    kind: "team-key";
+                    keyId: string;
+                };
+                at: number;
+                authorityVersion: number;
+            }> | null;
+            approvedAnonymousMethods: readonly Readonly<{
+                name: string;
+                digest: import("@fungi.computer/puffball").Sha256Digest;
+            }>[];
+            anonymousApproval: Readonly<{
+                by: {
+                    kind: "member";
+                    memberId: string;
+                } | {
+                    kind: "agent";
+                    agentId: string;
+                } | {
+                    kind: "team-key";
+                    keyId: string;
+                };
+                at: number;
+                authorityVersion: number;
+            }> | null;
+        }>;
+        pin: {
+            selection: {
+                readonly instanceId: import("../index.js").InstanceId;
+                readonly owner: {
+                    readonly kind: "installation" | "deployment";
+                    readonly id: string;
+                };
+                readonly appId: import("@fungi.computer/puffball").AppId;
+                readonly releaseId: import("@fungi.computer/puffball").ReleaseId;
+                readonly authorityVersion: number;
+            };
+            artifactDigest: import("@fungi.computer/puffball").Sha256Digest;
+        };
+    }>;
+    admitEventFact: (raw: AppEventFact) => Promise<AppEventFact>;
+    gitNode: (idempotencyKey: string) => WorkflowGitPassNode | null;
+    /** A finished run's Git steps can no longer be named by a pass mint. */
+    forgetGitNodes(runId: string): void;
+    /** Trigger runs act as the owner who armed them on their pinned Computer. */
+    recordTriggerCaller(runId: string, memberId: string, computerId: string | null): void;
+    catalog: (facts: InvocationFacts, input?: Readonly<{
+        installationId?: string | undefined;
+    }>) => Promise<Readonly<{
+        error: "too_large";
+    }> | Readonly<{
+        apps: readonly Readonly<{
+            installationId: string;
+            appId: string;
+            displayName: string;
+            icon?: string;
+            capabilities?: WorkflowCatalogEntry["capabilities"];
+            workflowPublishGranted: boolean;
+            workflowRunGranted: boolean;
+            methods: Readonly<Record<string, CatalogMethodSummary>>;
+            events?: Readonly<Record<string, CatalogEventSummary>>;
+        }>[];
+    }> | {
+        app: Readonly<{
+            installationId: string;
+            appId: string;
+            displayName: string;
+            icon?: string;
+            capabilities?: import("@fungi.computer/braid/runtime").RunCeiling["nodes"][number]["capabilities"];
+            workflowPublishGranted?: boolean;
+            workflowRunGranted?: boolean;
+            methods: Catalog[string]["methods"];
+            events?: NonNullable<Catalog[string]["events"]>;
+        }>;
+    } | {
+        error: "not_found";
+    }>;
+    catalogForLibrary: {
+        (library: Awaited<ReturnType<(installationId: string) => Promise<{
+            installation: Readonly<{
+                installationId: string;
+                instanceId: import("../index.js").InstanceId | null;
+                appId: import("@fungi.computer/puffball").AppId;
+                release: {
+                    readonly releaseId: import("@fungi.computer/puffball").ReleaseId;
+                    readonly appId: import("@fungi.computer/puffball").AppId;
+                    readonly artifact: {
+                        readonly artifactRef: import("@fungi.computer/puffball").ArtifactRef;
+                        readonly artifactDigest: import("@fungi.computer/puffball").Sha256Digest;
+                        readonly provenance: {
+                            readonly sourceRevision: import("@fungi.computer/puffball").SourceRevision;
+                            readonly sourceTreeDigest: import("@fungi.computer/puffball").Sha256Digest;
+                            readonly buildRecipeDigest: import("@fungi.computer/puffball").Sha256Digest;
+                        };
+                    };
+                };
+                releasePin: "pinned" | "floating";
+                authorityVersion: number;
+                status: "enabled" | "disabled" | "deleted";
+                visibility: "private" | "public";
+                declaredOperationsDigest: import("@fungi.computer/puffball").Sha256Digest;
+                approvedGrants: readonly Readonly<{
+                    capability: "agent.list" | "agent.manage" | "agent.rename" | "agent.toolPolicy" | "agent.read" | "agent.send" | "computer.list" | "computer.readFile" | "computer.writeFile" | "computer.execute" | "llm.generation" | "media.generation" | "games:servers" | "git.repository" | "apps.open" | "apps.call" | "app.storage" | "app.events.emit" | "team.workbenchHost" | "marketplace.browse" | "marketplace.purchase" | "workflow.run" | "workflow.publish" | "workflow.arm" | "world" | "channels.read" | "channels.personal.manage";
+                    capabilityApproved: true;
+                    operations: readonly string[];
+                    resources: "tenant-scope" | readonly Readonly<{
+                        kind: string;
+                        id: string;
+                    }>[];
+                }>[];
+                approval: Readonly<{
+                    by: {
+                        kind: "member";
+                        memberId: string;
+                    } | {
+                        kind: "agent";
+                        agentId: string;
+                    } | {
+                        kind: "team-key";
+                        keyId: string;
+                    };
+                    at: number;
+                    authorityVersion: number;
+                }> | null;
+                approvedAnonymousMethods: readonly Readonly<{
+                    name: string;
+                    digest: import("@fungi.computer/puffball").Sha256Digest;
+                }>[];
+                anonymousApproval: Readonly<{
+                    by: {
+                        kind: "member";
+                        memberId: string;
+                    } | {
+                        kind: "agent";
+                        agentId: string;
+                    } | {
+                        kind: "team-key";
+                        keyId: string;
+                    };
+                    at: number;
+                    authorityVersion: number;
+                }> | null;
+            }>;
+            verified: Readonly<{
+                release: import("@fungi.computer/puffball").Release;
+                build: import("@fungi.computer/puffball/app").AppBuild;
+                api: import("@fungi.computer/puffball").AppApi | null;
+                declaration: import("@fungi.computer/puffball").AppDeclaration | null;
+                ui: Readonly<{
+                    kind: "html";
+                    artifactRef: import("@fungi.computer/puffball").ArtifactRef;
+                    digest: import("@fungi.computer/puffball").Sha256Digest;
+                }> | Readonly<{
+                    kind: "assets";
+                    build: import("@fungi.computer/puffball/assets").AssetBuild;
+                }> | null;
+                backend: Readonly<{
+                    artifactRef: import("@fungi.computer/puffball").ArtifactRef;
+                    digest: import("@fungi.computer/puffball").Sha256Digest;
+                }> | null;
+            }>;
+        }>>>): Promise<Readonly<{
+            error: "too_large";
+        }> | Readonly<{
+            apps: readonly Readonly<{
+                installationId: string;
+                appId: string;
+                displayName: string;
+                icon?: string;
+                capabilities?: WorkflowCatalogEntry["capabilities"];
+                workflowPublishGranted: boolean;
+                workflowRunGranted: boolean;
+                methods: Readonly<Record<string, CatalogMethodSummary>>;
+                events?: Readonly<Record<string, CatalogEventSummary>>;
+            }>[];
+        }>>;
+        (library: Awaited<ReturnType<(installationId: string) => Promise<{
+            installation: Readonly<{
+                installationId: string;
+                instanceId: import("../index.js").InstanceId | null;
+                appId: import("@fungi.computer/puffball").AppId;
+                release: {
+                    readonly releaseId: import("@fungi.computer/puffball").ReleaseId;
+                    readonly appId: import("@fungi.computer/puffball").AppId;
+                    readonly artifact: {
+                        readonly artifactRef: import("@fungi.computer/puffball").ArtifactRef;
+                        readonly artifactDigest: import("@fungi.computer/puffball").Sha256Digest;
+                        readonly provenance: {
+                            readonly sourceRevision: import("@fungi.computer/puffball").SourceRevision;
+                            readonly sourceTreeDigest: import("@fungi.computer/puffball").Sha256Digest;
+                            readonly buildRecipeDigest: import("@fungi.computer/puffball").Sha256Digest;
+                        };
+                    };
+                };
+                releasePin: "pinned" | "floating";
+                authorityVersion: number;
+                status: "enabled" | "disabled" | "deleted";
+                visibility: "private" | "public";
+                declaredOperationsDigest: import("@fungi.computer/puffball").Sha256Digest;
+                approvedGrants: readonly Readonly<{
+                    capability: "agent.list" | "agent.manage" | "agent.rename" | "agent.toolPolicy" | "agent.read" | "agent.send" | "computer.list" | "computer.readFile" | "computer.writeFile" | "computer.execute" | "llm.generation" | "media.generation" | "games:servers" | "git.repository" | "apps.open" | "apps.call" | "app.storage" | "app.events.emit" | "team.workbenchHost" | "marketplace.browse" | "marketplace.purchase" | "workflow.run" | "workflow.publish" | "workflow.arm" | "world" | "channels.read" | "channels.personal.manage";
+                    capabilityApproved: true;
+                    operations: readonly string[];
+                    resources: "tenant-scope" | readonly Readonly<{
+                        kind: string;
+                        id: string;
+                    }>[];
+                }>[];
+                approval: Readonly<{
+                    by: {
+                        kind: "member";
+                        memberId: string;
+                    } | {
+                        kind: "agent";
+                        agentId: string;
+                    } | {
+                        kind: "team-key";
+                        keyId: string;
+                    };
+                    at: number;
+                    authorityVersion: number;
+                }> | null;
+                approvedAnonymousMethods: readonly Readonly<{
+                    name: string;
+                    digest: import("@fungi.computer/puffball").Sha256Digest;
+                }>[];
+                anonymousApproval: Readonly<{
+                    by: {
+                        kind: "member";
+                        memberId: string;
+                    } | {
+                        kind: "agent";
+                        agentId: string;
+                    } | {
+                        kind: "team-key";
+                        keyId: string;
+                    };
+                    at: number;
+                    authorityVersion: number;
+                }> | null;
+            }>;
+            verified: Readonly<{
+                release: import("@fungi.computer/puffball").Release;
+                build: import("@fungi.computer/puffball/app").AppBuild;
+                api: import("@fungi.computer/puffball").AppApi | null;
+                declaration: import("@fungi.computer/puffball").AppDeclaration | null;
+                ui: Readonly<{
+                    kind: "html";
+                    artifactRef: import("@fungi.computer/puffball").ArtifactRef;
+                    digest: import("@fungi.computer/puffball").Sha256Digest;
+                }> | Readonly<{
+                    kind: "assets";
+                    build: import("@fungi.computer/puffball/assets").AssetBuild;
+                }> | null;
+                backend: Readonly<{
+                    artifactRef: import("@fungi.computer/puffball").ArtifactRef;
+                    digest: import("@fungi.computer/puffball").Sha256Digest;
+                }> | null;
+            }>;
+        }>>>, scope: Readonly<{
+            installationIds: readonly string[];
+        }> | Readonly<{
+            full: true;
+        }>): Promise<Readonly<{
+            apps: readonly WorkflowCatalogEntry[];
+        }>>;
+    };
+    prepare(facts: InvocationFacts, raw: GraphStartRequest): Promise<(Readonly<{
+        apps: readonly WorkflowCatalogEntry[];
+    }> & Record<"error", unknown>) | Readonly<{
+        kind: "invalid";
+        issues: readonly import("@fungi.computer/braid").Issue[];
+    }> | {
+        error: "not_granted";
+        kind?: undefined;
+        runId?: undefined;
+        planDigest?: undefined;
+    } | {
+        error: "invalid_publication";
+        kind?: undefined;
+        runId?: undefined;
+        planDigest?: undefined;
+    } | {
+        error: "invalid_input";
+        kind?: undefined;
+        runId?: undefined;
+        planDigest?: undefined;
+    } | {
+        kind: "conflict" | "replay" | "started";
+        runId: string;
+        planDigest: string;
+        readonly error?: undefined;
+    }>;
+    loadRun(libraryId: string, runId: string): Promise<{
+        plan: {
+            readonly planDigest: string;
+            readonly definition: {
+                readonly format: "fungi.workflow/v1";
+                readonly output: {
+                    readonly [x: string]: {
+                        readonly node: string;
+                        readonly port: string;
+                    };
+                };
+                readonly input: {
+                    readonly [x: string]: S.Json;
+                };
+                readonly title: string;
+                readonly apps: {
+                    readonly [x: string]: {
+                        readonly appId: string;
+                        readonly role?: string | undefined;
+                    };
+                };
+                readonly nodes: readonly ({
+                    readonly id: string;
+                    readonly kind: "code";
+                    readonly source: string;
+                    readonly input: {
+                        readonly [x: string]: S.Json;
+                    };
+                    readonly output: {
+                        readonly [x: string]: S.Json;
+                    };
+                    readonly values: {
+                        readonly [x: string]: import("@fungi.computer/braid").Mapping;
+                    };
+                } | {
+                    readonly values: {
+                        readonly [x: string]: import("@fungi.computer/braid").Mapping;
+                    };
+                    readonly method: string;
+                    readonly kind: "app";
+                    readonly id: string;
+                    readonly app: string;
+                    readonly methodDigest: string;
+                    readonly retry?: {
+                        readonly attempts: number;
+                    } | undefined;
+                    readonly gitAccess?: {
+                        binding: string;
+                        repository: string;
+                        branches: string[];
+                    } | {
+                        binding: string;
+                        repository: string;
+                        access: "read";
+                    } | undefined;
+                } | {
+                    readonly kind: "review";
+                    readonly id: string;
+                    readonly title: string;
+                    readonly reviewers: "runner" | "owners";
+                    readonly show: readonly {
+                        readonly node: string;
+                        readonly port: string;
+                    }[];
+                    readonly timeout: number;
+                    readonly choices?: readonly {
+                        readonly id: string;
+                        readonly label: string;
+                    }[] | undefined;
+                } | {
+                    readonly id: string;
+                    readonly kind: "condition";
+                    readonly test: import("@fungi.computer/braid").Predicate;
+                } | {
+                    readonly id: string;
+                    readonly kind: "map";
+                    readonly over: {
+                        readonly node: string;
+                        readonly port: string;
+                    };
+                    readonly body: string;
+                    readonly concurrency: number;
+                    readonly maxItems: number;
+                } | {
+                    readonly id: string;
+                    readonly kind: "repeat";
+                    readonly body: string;
+                    readonly maxRounds: number;
+                    readonly until: import("@fungi.computer/braid").Predicate;
+                } | {
+                    readonly id: string;
+                    readonly kind: "wait";
+                    readonly for: number;
+                } | {
+                    readonly id: string;
+                    readonly kind: "transform";
+                    readonly fields: {
+                        readonly [x: string]: import("@fungi.computer/braid").Mapping;
+                    };
+                })[];
+                readonly edges: readonly {
+                    readonly from: {
+                        readonly node: string;
+                        readonly port: string;
+                    };
+                    readonly to: {
+                        readonly node: string;
+                        readonly port: string;
+                    };
+                }[];
+                readonly description?: string | undefined;
+                readonly subgraphs?: {
+                    readonly [x: string]: {
+                        readonly input: {
+                            readonly [x: string]: S.Json;
+                        };
+                        readonly nodes: readonly ({
+                            readonly id: string;
+                            readonly kind: "code";
+                            readonly source: string;
+                            readonly input: {
+                                readonly [x: string]: S.Json;
+                            };
+                            readonly output: {
+                                readonly [x: string]: S.Json;
+                            };
+                            readonly values: {
+                                readonly [x: string]: import("@fungi.computer/braid").Mapping;
+                            };
+                        } | {
+                            readonly values: {
+                                readonly [x: string]: import("@fungi.computer/braid").Mapping;
+                            };
+                            readonly method: string;
+                            readonly kind: "app";
+                            readonly id: string;
+                            readonly app: string;
+                            readonly methodDigest: string;
+                            readonly retry?: {
+                                readonly attempts: number;
+                            } | undefined;
+                            readonly gitAccess?: {
+                                binding: string;
+                                repository: string;
+                                branches: string[];
+                            } | {
+                                binding: string;
+                                repository: string;
+                                access: "read";
+                            } | undefined;
+                        } | {
+                            readonly kind: "review";
+                            readonly id: string;
+                            readonly title: string;
+                            readonly reviewers: "runner" | "owners";
+                            readonly show: readonly {
+                                readonly node: string;
+                                readonly port: string;
+                            }[];
+                            readonly timeout: number;
+                            readonly choices?: readonly {
+                                readonly id: string;
+                                readonly label: string;
+                            }[] | undefined;
+                        } | {
+                            readonly id: string;
+                            readonly kind: "condition";
+                            readonly test: import("@fungi.computer/braid").Predicate;
+                        } | {
+                            readonly id: string;
+                            readonly kind: "map";
+                            readonly over: {
+                                readonly node: string;
+                                readonly port: string;
+                            };
+                            readonly body: string;
+                            readonly concurrency: number;
+                            readonly maxItems: number;
+                        } | {
+                            readonly id: string;
+                            readonly kind: "repeat";
+                            readonly body: string;
+                            readonly maxRounds: number;
+                            readonly until: import("@fungi.computer/braid").Predicate;
+                        } | {
+                            readonly id: string;
+                            readonly kind: "wait";
+                            readonly for: number;
+                        } | {
+                            readonly id: string;
+                            readonly kind: "transform";
+                            readonly fields: {
+                                readonly [x: string]: import("@fungi.computer/braid").Mapping;
+                            };
+                        })[];
+                        readonly edges: readonly {
+                            readonly from: {
+                                readonly node: string;
+                                readonly port: string;
+                            };
+                            readonly to: {
+                                readonly node: string;
+                                readonly port: string;
+                            };
+                        }[];
+                        readonly output: {
+                            readonly [x: string]: {
+                                readonly node: string;
+                                readonly port: string;
+                            };
+                        };
+                    };
+                } | undefined;
+                readonly triggers?: readonly ({
+                    readonly id: string;
+                    readonly on: "webhook";
+                    readonly when?: import("@fungi.computer/braid").Predicate | undefined;
+                    readonly input?: {
+                        readonly [x: string]: import("@fungi.computer/braid").Mapping;
+                    } | undefined;
+                    readonly title?: string | undefined;
+                } | {
+                    readonly id: string;
+                    readonly on: "schedule";
+                    readonly cron: {
+                        readonly expression: string;
+                        readonly timeZone: string;
+                    };
+                    readonly input?: {
+                        readonly [x: string]: import("@fungi.computer/braid").Mapping;
+                    } | undefined;
+                    readonly title?: string | undefined;
+                } | {
+                    readonly id: string;
+                    readonly event: string;
+                    readonly on: "event";
+                    readonly app: string;
+                    readonly eventDigest: string;
+                    readonly repository?: import("@fungi.computer/braid").Mapping | undefined;
+                    readonly when?: import("@fungi.computer/braid").Predicate | undefined;
+                    readonly input?: {
+                        readonly [x: string]: import("@fungi.computer/braid").Mapping;
+                    } | undefined;
+                    readonly title?: string | undefined;
+                })[] | undefined;
+            };
+            readonly catalog: {
+                readonly [x: string]: {
+                    readonly methods: {
+                        readonly [x: string]: {
+                            readonly digest: string;
+                            readonly output: {
+                                readonly [x: string]: S.Json;
+                            };
+                            readonly input: {
+                                readonly [x: string]: S.Json;
+                            };
+                            readonly approval: "none" | "queue" | "simulate";
+                            readonly description: string;
+                            readonly effect: "read" | "write" | "external";
+                            readonly requires: readonly string[];
+                            readonly pending?: true | undefined;
+                        };
+                    };
+                    readonly events?: {
+                        readonly [x: string]: {
+                            readonly digest: string;
+                            readonly description: string;
+                            readonly payload: {
+                                readonly [x: string]: S.Json;
+                            };
+                        };
+                    } | undefined;
+                };
+            };
+            readonly bindings: {
+                readonly [x: string]: {
+                    kind: "team-source";
+                } | {
+                    appId: string;
+                    installationId: string;
+                };
+            };
+            readonly estimatedSteps: number;
+            readonly requiredBindings: readonly {
+                readonly method: string;
+                readonly installationId: string;
+                readonly output: {
+                    readonly [x: string]: S.Json;
+                };
+                readonly input: {
+                    readonly [x: string]: S.Json;
+                };
+                readonly approval: "none" | "queue" | "simulate";
+                readonly description: string;
+                readonly effect: "read" | "write" | "external";
+                readonly requires: readonly string[];
+                readonly app: string;
+                readonly pending?: true | undefined;
+            }[];
+        };
+        input: {
+            readonly [x: string]: S.Json;
+        };
+    }>;
+    /** Live member, Computer and library run grant, before every node kind. */
+    beforeNode(raw: NodeEvent): Promise<NodeAdmissionResult>;
+    dispatch(call: NodeCall): Promise<DispatchResult>;
+};
+export {};