@fungi.computer/workflows-wire 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jamstack Consulting LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,45 @@
-# Temporary Holding Version
+# Workflow wire
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Workflow run and request IDs, plus the generic graph reply schemas (catalog,
+start, status, cancel, review, schedules and event triggers), live at the root.
+Hub and the Trellis App consume this package without an App-to-App dependency.
+
+## Packed consumer readiness
+
+Run `pnpm run build`, `pnpm run pack` and `pnpm run stranger` in this package.
+The maintained stranger proof installs only package tarballs into a fresh npm
+consumer, checks the exact shipped files, runs the public runtime fixture and
+compiles every JavaScript entrypoint with strict NodeNext and no library-check
+skip. This qualification does not publish npm releases or push a repository
+split.
+
+See [LICENSE](LICENSE) for the license and the package manifest for its public
+repository destination.
+
+## Quick start
+
+```ts
+import { workflowRunRequestIds } from "@fungi.computer/workflows-wire";
+
+const requestId = workflowRunRequestIds.request.generate();
+console.log(workflowRunRequestIds.request.parse(requestId).ok);
+```
+
+## Core concepts
+
+Identifiers and decoded wire values are data contracts. This package does not
+own workflow execution, App admission or run persistence.
+
+## Examples and checks
+
+The packed runtime fixture at `test/stranger/runtime.mjs` exercises the public
+API in a fresh consumer. Run `pnpm run stranger` after building the package.
+
+## Install
+
+Install the package tarball with npm. The manifest pins its runtime
+dependencies.
+
+## Contribute and license
+
+See [LICENSE](LICENSE) for the MIT terms.

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./run-ids.js";
+export * from "./outcomes.js";
+export * from "./library-contracts.js";
+export * from "./run-contracts.js";
+export * from "./trigger-contracts.js";
+export * from "./published-definition.js";
+export * from "./workflow-repository.js";

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from "./run-ids.js";
+export * from "./outcomes.js";
+export * from "./library-contracts.js";
+export * from "./run-contracts.js";
+export * from "./trigger-contracts.js";
+export * from "./published-definition.js";
+export * from "./workflow-repository.js";

package/dist/library-contracts.d.ts

@@ -0,0 +1,501 @@
+import * as z from "zod";
+export declare const provenanceSchema: z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
+    kind: z.ZodLiteral<"import">;
+    workflowId: z.ZodString;
+    version: z.ZodNumber;
+    commit: z.ZodString;
+    sha256: z.ZodString & z.ZodType<string & {
+        readonly appReleaseKind: "Sha256Digest";
+    }, string, z.core.$ZodTypeInternals<string & {
+        readonly appReleaseKind: "Sha256Digest";
+    }, string>>;
+    origin: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"fork">;
+    workflowId: z.ZodString;
+    commit: z.ZodString;
+}, z.core.$strict>]>>;
+export declare const runBase: z.ZodObject<{
+    requestId: z.ZodString;
+    workflowId: z.ZodString;
+    bindings: z.ZodRecord<z.ZodLazy<z.ZodString>, z.ZodUnion<readonly [z.ZodString, z.ZodLazy<z.ZodObject<{
+        kind: z.ZodLiteral<"team-source">;
+    }, z.core.$strict>>]>>;
+    input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+    delivery: z.ZodOptional<z.ZodObject<{
+        agentId: z.ZodString;
+        sessionId: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const publishedRun: z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
+    requestId: z.ZodString;
+    workflowId: z.ZodString;
+    bindings: z.ZodRecord<z.ZodLazy<z.ZodString>, z.ZodUnion<readonly [z.ZodString, z.ZodLazy<z.ZodObject<{
+        kind: z.ZodLiteral<"team-source">;
+    }, z.core.$strict>>]>>;
+    input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+    delivery: z.ZodOptional<z.ZodObject<{
+        agentId: z.ZodString;
+        sessionId: z.ZodString;
+    }, z.core.$strict>>;
+    version: z.ZodNumber;
+}, z.core.$strict>, z.ZodObject<{
+    requestId: z.ZodString;
+    workflowId: z.ZodString;
+    bindings: z.ZodRecord<z.ZodLazy<z.ZodString>, z.ZodUnion<readonly [z.ZodString, z.ZodLazy<z.ZodObject<{
+        kind: z.ZodLiteral<"team-source">;
+    }, z.core.$strict>>]>>;
+    input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+    delivery: z.ZodOptional<z.ZodObject<{
+        agentId: z.ZodString;
+        sessionId: z.ZodString;
+    }, z.core.$strict>>;
+    commit: z.ZodString;
+}, z.core.$strict>]>>;
+export declare const document: z.ZodObject<{
+    provenance: z.ZodOptional<z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
+        kind: z.ZodLiteral<"import">;
+        workflowId: z.ZodString;
+        version: z.ZodNumber;
+        commit: z.ZodString;
+        sha256: z.ZodString & z.ZodType<string & {
+            readonly appReleaseKind: "Sha256Digest";
+        }, string, z.core.$ZodTypeInternals<string & {
+            readonly appReleaseKind: "Sha256Digest";
+        }, string>>;
+        origin: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"fork">;
+        workflowId: z.ZodString;
+        commit: z.ZodString;
+    }, z.core.$strict>]>>>;
+    definition: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+    layout: z.ZodRecord<z.ZodString, z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strict>>;
+    commit: z.ZodString;
+}, z.core.$strict>;
+export declare const revisionSchema: z.ZodNumber;
+export declare const draftDocument: z.ZodObject<{
+    provenance: z.ZodOptional<z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
+        kind: z.ZodLiteral<"import">;
+        workflowId: z.ZodString;
+        version: z.ZodNumber;
+        commit: z.ZodString;
+        sha256: z.ZodString & z.ZodType<string & {
+            readonly appReleaseKind: "Sha256Digest";
+        }, string, z.core.$ZodTypeInternals<string & {
+            readonly appReleaseKind: "Sha256Digest";
+        }, string>>;
+        origin: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"fork">;
+        workflowId: z.ZodString;
+        commit: z.ZodString;
+    }, z.core.$strict>]>>>;
+    definition: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+    layout: z.ZodRecord<z.ZodString, z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strict>>;
+    revision: z.ZodNumber;
+}, z.core.$strict>;
+export declare const publishedDocument: z.ZodObject<{
+    provenance: z.ZodOptional<z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
+        kind: z.ZodLiteral<"import">;
+        workflowId: z.ZodString;
+        version: z.ZodNumber;
+        commit: z.ZodString;
+        sha256: z.ZodString & z.ZodType<string & {
+            readonly appReleaseKind: "Sha256Digest";
+        }, string, z.core.$ZodTypeInternals<string & {
+            readonly appReleaseKind: "Sha256Digest";
+        }, string>>;
+        origin: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"fork">;
+        workflowId: z.ZodString;
+        commit: z.ZodString;
+    }, z.core.$strict>]>>>;
+    definition: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+    layout: z.ZodRecord<z.ZodString, z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strict>>;
+    commit: z.ZodString;
+    workflowId: z.ZodString;
+    version: z.ZodNumber;
+    digest: z.ZodString & z.ZodType<string & {
+        readonly appReleaseKind: "Sha256Digest";
+    }, string, z.core.$ZodTypeInternals<string & {
+        readonly appReleaseKind: "Sha256Digest";
+    }, string>>;
+}, z.core.$strict>;
+export declare const saveReply: z.ZodUnion<readonly [z.ZodObject<{
+    kind: z.ZodLiteral<"saved">;
+    revision: z.ZodNumber;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"conflict">;
+    current: z.ZodNullable<z.ZodObject<{
+        provenance: z.ZodOptional<z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
+            kind: z.ZodLiteral<"import">;
+            workflowId: z.ZodString;
+            version: z.ZodNumber;
+            commit: z.ZodString;
+            sha256: z.ZodString & z.ZodType<string & {
+                readonly appReleaseKind: "Sha256Digest";
+            }, string, z.core.$ZodTypeInternals<string & {
+                readonly appReleaseKind: "Sha256Digest";
+            }, string>>;
+            origin: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"fork">;
+            workflowId: z.ZodString;
+            commit: z.ZodString;
+        }, z.core.$strict>]>>>;
+        definition: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+        layout: z.ZodRecord<z.ZodString, z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strict>>;
+        revision: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"invalid">;
+    issues: z.ZodArray<z.ZodLazy<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        graph: z.ZodOptional<z.ZodString>;
+        node: z.ZodOptional<z.ZodString>;
+        trigger: z.ZodOptional<z.ZodString>;
+        port: z.ZodOptional<z.ZodString>;
+        edge: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+}, z.core.$strict>]>;
+export declare const shareReview: z.ZodObject<{
+    gitAccess: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        binding: z.ZodLazy<z.ZodString>;
+        repository: z.ZodString;
+        branches: z.ZodLazy<z.ZodArray<z.ZodString>>;
+        graph: z.ZodString;
+        node: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        binding: z.ZodLazy<z.ZodString>;
+        repository: z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"$trigger.repository">]>;
+        access: z.ZodLiteral<"read">;
+        graph: z.ZodString;
+        node: z.ZodString;
+    }, z.core.$strict>]>>;
+    writeNodes: z.ZodArray<z.ZodObject<{
+        graph: z.ZodString;
+        node: z.ZodString;
+        appId: z.ZodString;
+        method: z.ZodString;
+        effect: z.ZodEnum<{
+            write: "write";
+            external: "external";
+        }>;
+    }, z.core.$strict>>;
+    triggers: z.ZodArray<z.ZodJSONSchema>;
+}, z.core.$strict>;
+export declare const shareCopyReply: z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
+    kind: z.ZodLiteral<"saved">;
+    revision: z.ZodNumber;
+    title: z.ZodString;
+    review: z.ZodObject<{
+        gitAccess: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            binding: z.ZodLazy<z.ZodString>;
+            repository: z.ZodString;
+            branches: z.ZodLazy<z.ZodArray<z.ZodString>>;
+            graph: z.ZodString;
+            node: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            binding: z.ZodLazy<z.ZodString>;
+            repository: z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"$trigger.repository">]>;
+            access: z.ZodLiteral<"read">;
+            graph: z.ZodString;
+            node: z.ZodString;
+        }, z.core.$strict>]>>;
+        writeNodes: z.ZodArray<z.ZodObject<{
+            graph: z.ZodString;
+            node: z.ZodString;
+            appId: z.ZodString;
+            method: z.ZodString;
+            effect: z.ZodEnum<{
+                write: "write";
+                external: "external";
+            }>;
+        }, z.core.$strict>>;
+        triggers: z.ZodArray<z.ZodJSONSchema>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"conflict">;
+    current: z.ZodNullable<z.ZodObject<{
+        provenance: z.ZodOptional<z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
+            kind: z.ZodLiteral<"import">;
+            workflowId: z.ZodString;
+            version: z.ZodNumber;
+            commit: z.ZodString;
+            sha256: z.ZodString & z.ZodType<string & {
+                readonly appReleaseKind: "Sha256Digest";
+            }, string, z.core.$ZodTypeInternals<string & {
+                readonly appReleaseKind: "Sha256Digest";
+            }, string>>;
+            origin: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"fork">;
+            workflowId: z.ZodString;
+            commit: z.ZodString;
+        }, z.core.$strict>]>>>;
+        definition: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+        layout: z.ZodRecord<z.ZodString, z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strict>>;
+        revision: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"invalid">;
+    issues: z.ZodArray<z.ZodLazy<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        graph: z.ZodOptional<z.ZodString>;
+        node: z.ZodOptional<z.ZodString>;
+        trigger: z.ZodOptional<z.ZodString>;
+        port: z.ZodOptional<z.ZodString>;
+        edge: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"missing_apps">;
+    appIds: z.ZodArray<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodEnum<{
+        not_found: "not_found";
+        too_large: "too_large";
+        digest_mismatch: "digest_mismatch";
+        invalid_bundle: "invalid_bundle";
+    }>;
+}, z.core.$strict>]>>;
+export declare const shareExportReply: z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
+    bytes: z.ZodString;
+    sha256: z.ZodString & z.ZodType<string & {
+        readonly appReleaseKind: "Sha256Digest";
+    }, string, z.core.$ZodTypeInternals<string & {
+        readonly appReleaseKind: "Sha256Digest";
+    }, string>>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodEnum<{
+        not_found: "not_found";
+        too_large: "too_large";
+    }>;
+}, z.core.$strict>]>>;
+export declare const publicationIds: Readonly<{
+    readonly publication: import("@fungi.computer/cairn/id").IdCodec<"workflow-publication", "publication", 1>;
+}>;
+export declare const publicationIdSchema: z.ZodLazy<z.ZodString & z.ZodType<import("@fungi.computer/cairn/id").CairnId<"workflow-publication", "publication", 1>, string, z.core.$ZodTypeInternals<import("@fungi.computer/cairn/id").CairnId<"workflow-publication", "publication", 1>, string>>>;
+export declare const publicationFailure: z.ZodEnum<{
+    too_large: "too_large";
+    git_conflict: "git_conflict";
+    publication_failed: "publication_failed";
+    access_changed: "access_changed";
+}>;
+export declare const publicationComplete: z.ZodLazy<z.ZodObject<{
+    kind: z.ZodLiteral<"published">;
+    commit: z.ZodString;
+    version: z.ZodNumber;
+}, z.core.$strict>>;
+export declare const publicationPending: z.ZodLazy<z.ZodObject<{
+    kind: z.ZodLiteral<"publishing">;
+    publicationId: z.ZodLazy<z.ZodString & z.ZodType<import("@fungi.computer/cairn/id").CairnId<"workflow-publication", "publication", 1>, string, z.core.$ZodTypeInternals<import("@fungi.computer/cairn/id").CairnId<"workflow-publication", "publication", 1>, string>>>;
+}, z.core.$strict>>;
+export declare const publicationFailed: z.ZodLazy<z.ZodObject<{
+    kind: z.ZodLiteral<"failed">;
+    reason: z.ZodEnum<{
+        too_large: "too_large";
+        git_conflict: "git_conflict";
+        publication_failed: "publication_failed";
+        access_changed: "access_changed";
+    }>;
+}, z.core.$strict>>;
+export declare const publicationStatus: z.ZodLazy<z.ZodUnion<readonly [z.ZodLazy<z.ZodObject<{
+    kind: z.ZodLiteral<"publishing">;
+    publicationId: z.ZodLazy<z.ZodString & z.ZodType<import("@fungi.computer/cairn/id").CairnId<"workflow-publication", "publication", 1>, string, z.core.$ZodTypeInternals<import("@fungi.computer/cairn/id").CairnId<"workflow-publication", "publication", 1>, string>>>;
+}, z.core.$strict>>, z.ZodLazy<z.ZodObject<{
+    kind: z.ZodLiteral<"published">;
+    commit: z.ZodString;
+    version: z.ZodNumber;
+}, z.core.$strict>>, z.ZodLazy<z.ZodObject<{
+    kind: z.ZodLiteral<"failed">;
+    reason: z.ZodEnum<{
+        too_large: "too_large";
+        git_conflict: "git_conflict";
+        publication_failed: "publication_failed";
+        access_changed: "access_changed";
+    }>;
+}, z.core.$strict>>, z.ZodObject<{
+    kind: z.ZodLiteral<"not_found">;
+}, z.core.$strict>]>>;
+export declare const publicationElsewhere: z.ZodLazy<z.ZodObject<{
+    kind: z.ZodLiteral<"publishing_elsewhere">;
+}, z.core.$strict>>;
+export declare const publishReply: z.ZodLazy<z.ZodUnion<readonly [z.ZodLazy<z.ZodObject<{
+    kind: z.ZodLiteral<"publishing_elsewhere">;
+}, z.core.$strict>>, z.ZodLazy<z.ZodObject<{
+    kind: z.ZodLiteral<"published">;
+    commit: z.ZodString;
+    version: z.ZodNumber;
+}, z.core.$strict>>, z.ZodLazy<z.ZodObject<{
+    kind: z.ZodLiteral<"publishing">;
+    publicationId: z.ZodLazy<z.ZodString & z.ZodType<import("@fungi.computer/cairn/id").CairnId<"workflow-publication", "publication", 1>, string, z.core.$ZodTypeInternals<import("@fungi.computer/cairn/id").CairnId<"workflow-publication", "publication", 1>, string>>>;
+}, z.core.$strict>>, z.ZodLazy<z.ZodObject<{
+    kind: z.ZodLiteral<"failed">;
+    reason: z.ZodEnum<{
+        too_large: "too_large";
+        git_conflict: "git_conflict";
+        publication_failed: "publication_failed";
+        access_changed: "access_changed";
+    }>;
+}, z.core.$strict>>, z.ZodObject<{
+    kind: z.ZodLiteral<"conflict">;
+    head: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"invalid">;
+    issues: z.ZodArray<z.ZodLazy<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        graph: z.ZodOptional<z.ZodString>;
+        node: z.ZodOptional<z.ZodString>;
+        trigger: z.ZodOptional<z.ZodString>;
+        port: z.ZodOptional<z.ZodString>;
+        edge: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+}, z.core.$strict>]>>;
+export declare const version: z.ZodObject<{
+    version: z.ZodNumber;
+    commit: z.ZodString;
+    committedAt: z.ZodNumber;
+    message: z.ZodString;
+}, z.core.$strict>;
+export declare const workflow: z.ZodObject<{
+    workflowId: z.ZodString;
+}, z.core.$strict>;
+export declare const listings: z.ZodLazy<z.ZodArray<z.ZodObject<{
+    workflowId: z.ZodString;
+    title: z.ZodString;
+    draftRevision: z.ZodNullable<z.ZodNumber>;
+    published: z.ZodNullable<z.ZodObject<{
+        commit: z.ZodString;
+        version: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>>;
+}, z.core.$strict>>>;
+export declare const history: z.ZodArray<z.ZodObject<{
+    message: z.ZodString;
+    commit: z.ZodString;
+    committedAt: z.ZodNumber;
+}, z.core.$strict>>;
+/** A missing index is not an empty Git repository; only write paths reconstruct it. */
+export declare const libraryPageInput: z.ZodLazy<z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+    after: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>>;
+export declare const libraryPage: z.ZodLazy<z.ZodObject<{
+    items: z.ZodLazy<z.ZodArray<z.ZodObject<{
+        workflowId: z.ZodString;
+        title: z.ZodString;
+        draftRevision: z.ZodNullable<z.ZodNumber>;
+        published: z.ZodNullable<z.ZodObject<{
+            commit: z.ZodString;
+            version: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>>;
+    next: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>>;
+export declare const libraryListing: z.ZodLazy<z.ZodUnion<readonly [z.ZodLazy<z.ZodObject<{
+    items: z.ZodLazy<z.ZodArray<z.ZodObject<{
+        workflowId: z.ZodString;
+        title: z.ZodString;
+        draftRevision: z.ZodNullable<z.ZodNumber>;
+        published: z.ZodNullable<z.ZodObject<{
+            commit: z.ZodString;
+            version: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>>;
+    next: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>>, z.ZodObject<{
+    kind: z.ZodLiteral<"unindexed">;
+}, z.core.$strict>]>>;
+/** A missing screen copy needs an explicit foreground rebuild, never a hidden Git read. */
+export declare const rebuilding: z.ZodLazy<z.ZodObject<{
+    kind: z.ZodLiteral<"rebuilding">;
+}, z.core.$strict>>;
+export declare const documentRead: z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
+    provenance: z.ZodOptional<z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
+        kind: z.ZodLiteral<"import">;
+        workflowId: z.ZodString;
+        version: z.ZodNumber;
+        commit: z.ZodString;
+        sha256: z.ZodString & z.ZodType<string & {
+            readonly appReleaseKind: "Sha256Digest";
+        }, string, z.core.$ZodTypeInternals<string & {
+            readonly appReleaseKind: "Sha256Digest";
+        }, string>>;
+        origin: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"fork">;
+        workflowId: z.ZodString;
+        commit: z.ZodString;
+    }, z.core.$strict>]>>>;
+    definition: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+    layout: z.ZodRecord<z.ZodString, z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strict>>;
+    revision: z.ZodNumber;
+}, z.core.$strict>, z.ZodObject<{
+    provenance: z.ZodOptional<z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
+        kind: z.ZodLiteral<"import">;
+        workflowId: z.ZodString;
+        version: z.ZodNumber;
+        commit: z.ZodString;
+        sha256: z.ZodString & z.ZodType<string & {
+            readonly appReleaseKind: "Sha256Digest";
+        }, string, z.core.$ZodTypeInternals<string & {
+            readonly appReleaseKind: "Sha256Digest";
+        }, string>>;
+        origin: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"fork">;
+        workflowId: z.ZodString;
+        commit: z.ZodString;
+    }, z.core.$strict>]>>>;
+    definition: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+    layout: z.ZodRecord<z.ZodString, z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strict>>;
+    commit: z.ZodString;
+}, z.core.$strict>, z.ZodNull, z.ZodLazy<z.ZodObject<{
+    kind: z.ZodLiteral<"rebuilding">;
+}, z.core.$strict>>]>>;
+export declare const versionsRead: z.ZodLazy<z.ZodUnion<readonly [z.ZodArray<z.ZodObject<{
+    version: z.ZodNumber;
+    commit: z.ZodString;
+    committedAt: z.ZodNumber;
+    message: z.ZodString;
+}, z.core.$strict>>, z.ZodLazy<z.ZodObject<{
+    kind: z.ZodLiteral<"rebuilding">;
+}, z.core.$strict>>]>>;
+export declare const rebuildCopiesInput: z.ZodLazy<z.ZodObject<{
+    cursor: z.ZodNullable<z.ZodString>;
+    target: z.ZodOptional<z.ZodObject<{
+        workflowId: z.ZodString;
+        at: z.ZodObject<{
+            commit: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+}, z.core.$strict>>;
+export declare const rebuildCopiesReply: z.ZodLazy<z.ZodObject<{
+    done: z.ZodBoolean;
+    cursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>>;