@fungi.computer/workflows-wire 0.1.0 → 0.2.1

package/dist/index.d.ts

@@ -5,3 +5,4 @@ export * from "./run-contracts.js";
 export * from "./trigger-contracts.js";
 export * from "./published-definition.js";
 export * from "./workflow-repository.js";
+export * from "./repository-app-source.js";

package/dist/index.js

@@ -5,3 +5,4 @@ export * from "./run-contracts.js";
 export * from "./trigger-contracts.js";
 export * from "./published-definition.js";
 export * from "./workflow-repository.js";
+export * from "./repository-app-source.js";

package/dist/library-contracts.d.ts

@@ -1,4 +1,5 @@
 import * as z from "zod";
+/** Source Workflow and commit recorded when importing or forking a document. */
 export declare const provenanceSchema: z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
     kind: z.ZodLiteral<"import">;
     workflowId: z.ZodString;
@@ -15,6 +16,7 @@ export declare const provenanceSchema: z.ZodLazy<z.ZodUnion<readonly [z.ZodObjec
     workflowId: z.ZodString;
     commit: z.ZodString;
 }, z.core.$strict>]>>;
+/** Shared run request fields: identity, bindings, JSON input and optional delivery. */
 export declare const runBase: z.ZodObject<{
     requestId: z.ZodString;
     workflowId: z.ZodString;
@@ -27,6 +29,7 @@ export declare const runBase: z.ZodObject<{
         sessionId: z.ZodString;
     }, z.core.$strict>>;
 }, z.core.$strict>;
+/** Run request pinned to either a published version or an exact Git commit. */
 export declare const publishedRun: z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
     requestId: z.ZodString;
     workflowId: z.ZodString;
@@ -52,6 +55,7 @@ export declare const publishedRun: z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
     }, z.core.$strict>>;
     commit: z.ZodString;
 }, z.core.$strict>]>>;
+/** Wire document containing definition, node layout, provenance and commit. */
 export declare const document: z.ZodObject<{
     provenance: z.ZodOptional<z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
         kind: z.ZodLiteral<"import">;
@@ -76,7 +80,9 @@ export declare const document: z.ZodObject<{
     }, z.core.$strict>>;
     commit: z.ZodString;
 }, z.core.$strict>;
+/** Nonnegative revision used to fence draft replacements. */
 export declare const revisionSchema: z.ZodNumber;
+/** Editable document with a draft revision instead of a published commit. */
 export declare const draftDocument: z.ZodObject<{
     provenance: z.ZodOptional<z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
         kind: z.ZodLiteral<"import">;
@@ -101,6 +107,7 @@ export declare const draftDocument: z.ZodObject<{
     }, z.core.$strict>>;
     revision: z.ZodNumber;
 }, z.core.$strict>;
+/** Published document identified by Workflow, version, commit and content digest. */
 export declare const publishedDocument: z.ZodObject<{
     provenance: z.ZodOptional<z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
         kind: z.ZodLiteral<"import">;
@@ -132,6 +139,7 @@ export declare const publishedDocument: z.ZodObject<{
         readonly appReleaseKind: "Sha256Digest";
     }, string>>;
 }, z.core.$strict>;
+/** Draft save result, including revision conflict or validation issues. */
 export declare const saveReply: z.ZodUnion<readonly [z.ZodObject<{
     kind: z.ZodLiteral<"saved">;
     revision: z.ZodNumber;
@@ -173,6 +181,7 @@ export declare const saveReply: z.ZodUnion<readonly [z.ZodObject<{
         edge: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>>;
 }, z.core.$strict>]>;
+/** Share review listing Git access, write/external nodes and trigger configuration. */
 export declare const shareReview: z.ZodObject<{
     gitAccess: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
         binding: z.ZodLazy<z.ZodString>;
@@ -199,6 +208,7 @@ export declare const shareReview: z.ZodObject<{
     }, z.core.$strict>>;
     triggers: z.ZodArray<z.ZodJSONSchema>;
 }, z.core.$strict>;
+/** Import/fork result with the saved draft and review, or a typed refusal. */
 export declare const shareCopyReply: z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
     kind: z.ZodLiteral<"saved">;
     revision: z.ZodNumber;
@@ -277,6 +287,7 @@ export declare const shareCopyReply: z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<
         invalid_bundle: "invalid_bundle";
     }>;
 }, z.core.$strict>]>>;
+/** Exported bundle bytes and digest, or a missing/oversized bundle result. */
 export declare const shareExportReply: z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
     bytes: z.ZodString;
     sha256: z.ZodString & z.ZodType<string & {
@@ -290,25 +301,31 @@ export declare const shareExportReply: z.ZodLazy<z.ZodUnion<readonly [z.ZodObjec
         too_large: "too_large";
     }>;
 }, z.core.$strict>]>>;
+/** Mint and validate identities for asynchronous Workflow publication attempts. */
 export declare const publicationIds: Readonly<{
     readonly publication: import("@fungi.computer/cairn/id").IdCodec<"workflow-publication", "publication", 1>;
 }>;
+/** Publication identity accepted by the maintained publication id family. */
 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>>>;
+/** Publication failure categories returned by the host. */
 export declare const publicationFailure: z.ZodEnum<{
     too_large: "too_large";
     git_conflict: "git_conflict";
     publication_failed: "publication_failed";
     access_changed: "access_changed";
 }>;
+/** Completed publication's exact commit and assigned version. */
 export declare const publicationComplete: z.ZodLazy<z.ZodObject<{
     kind: z.ZodLiteral<"published">;
     commit: z.ZodString;
     version: z.ZodNumber;
 }, z.core.$strict>>;
+/** Pending publication identified for subsequent status reads. */
 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>>;
+/** Failed publication and its typed failure reason. */
 export declare const publicationFailed: z.ZodLazy<z.ZodObject<{
     kind: z.ZodLiteral<"failed">;
     reason: z.ZodEnum<{
@@ -318,6 +335,7 @@ export declare const publicationFailed: z.ZodLazy<z.ZodObject<{
         access_changed: "access_changed";
     }>;
 }, z.core.$strict>>;
+/** Current publication outcome, including an unknown publication identity. */
 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>>>;
@@ -336,9 +354,11 @@ export declare const publicationStatus: z.ZodLazy<z.ZodUnion<readonly [z.ZodLazy
 }, z.core.$strict>>, z.ZodObject<{
     kind: z.ZodLiteral<"not_found">;
 }, z.core.$strict>]>>;
+/** Another publication attempt currently owns the publication operation. */
 export declare const publicationElsewhere: z.ZodLazy<z.ZodObject<{
     kind: z.ZodLiteral<"publishing_elsewhere">;
 }, z.core.$strict>>;
+/** Publication command result, including pending work, conflict or validation issues. */
 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<{
@@ -371,15 +391,18 @@ export declare const publishReply: z.ZodLazy<z.ZodUnion<readonly [z.ZodLazy<z.Zo
         edge: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>>;
 }, z.core.$strict>]>>;
+/** Published version with commit identity, commit time and commit message. */
 export declare const version: z.ZodObject<{
     version: z.ZodNumber;
     commit: z.ZodString;
     committedAt: z.ZodNumber;
     message: z.ZodString;
 }, z.core.$strict>;
+/** Identify one Workflow within the library. */
 export declare const workflow: z.ZodObject<{
     workflowId: z.ZodString;
 }, z.core.$strict>;
+/** Bounded library rows with draft revision and optional published reference. */
 export declare const listings: z.ZodLazy<z.ZodArray<z.ZodObject<{
     workflowId: z.ZodString;
     title: z.ZodString;
@@ -389,6 +412,7 @@ export declare const listings: z.ZodLazy<z.ZodArray<z.ZodObject<{
         version: z.ZodNullable<z.ZodNumber>;
     }, z.core.$strict>>;
 }, z.core.$strict>>>;
+/** Bounded Git history rows without a published-version number. */
 export declare const history: z.ZodArray<z.ZodObject<{
     message: z.ZodString;
     commit: z.ZodString;
@@ -399,6 +423,7 @@ export declare const libraryPageInput: z.ZodLazy<z.ZodObject<{
     limit: z.ZodDefault<z.ZodNumber>;
     after: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>>;
+/** One library page with an optional exclusive cursor for the next page. */
 export declare const libraryPage: z.ZodLazy<z.ZodObject<{
     items: z.ZodLazy<z.ZodArray<z.ZodObject<{
         workflowId: z.ZodString;
@@ -411,6 +436,7 @@ export declare const libraryPage: z.ZodLazy<z.ZodObject<{
     }, z.core.$strict>>>;
     next: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>>;
+/** Indexed library page, or an explicit indication that its index is missing. */
 export declare const libraryListing: z.ZodLazy<z.ZodUnion<readonly [z.ZodLazy<z.ZodObject<{
     items: z.ZodLazy<z.ZodArray<z.ZodObject<{
         workflowId: z.ZodString;
@@ -429,6 +455,7 @@ export declare const libraryListing: z.ZodLazy<z.ZodUnion<readonly [z.ZodLazy<z.
 export declare const rebuilding: z.ZodLazy<z.ZodObject<{
     kind: z.ZodLiteral<"rebuilding">;
 }, z.core.$strict>>;
+/** Draft/published document read, absence, or an explicit copy-rebuild state. */
 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">;
@@ -478,6 +505,7 @@ export declare const documentRead: z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
 }, z.core.$strict>, z.ZodNull, z.ZodLazy<z.ZodObject<{
     kind: z.ZodLiteral<"rebuilding">;
 }, z.core.$strict>>]>>;
+/** Published version rows, or an explicit copy-rebuild state. */
 export declare const versionsRead: z.ZodLazy<z.ZodUnion<readonly [z.ZodArray<z.ZodObject<{
     version: z.ZodNumber;
     commit: z.ZodString;
@@ -486,6 +514,7 @@ export declare const versionsRead: z.ZodLazy<z.ZodUnion<readonly [z.ZodArray<z.Z
 }, z.core.$strict>>, z.ZodLazy<z.ZodObject<{
     kind: z.ZodLiteral<"rebuilding">;
 }, z.core.$strict>>]>>;
+/** Bounded copy-rebuild continuation, optionally targeting one pinned document. */
 export declare const rebuildCopiesInput: z.ZodLazy<z.ZodObject<{
     cursor: z.ZodNullable<z.ZodString>;
     target: z.ZodOptional<z.ZodObject<{
@@ -495,6 +524,7 @@ export declare const rebuildCopiesInput: z.ZodLazy<z.ZodObject<{
         }, z.core.$strict>;
     }, z.core.$strict>>;
 }, z.core.$strict>>;
+/** Copy-rebuild progress and the cursor needed to continue unfinished work. */
 export declare const rebuildCopiesReply: z.ZodLazy<z.ZodObject<{
     done: z.ZodBoolean;
     cursor: z.ZodNullable<z.ZodString>;

package/dist/library-contracts.js

@@ -6,6 +6,7 @@ import { sha256DigestSchema } from "@fungi.computer/puffball/effect";
 import { gitAccessSchema, bindingsSelectionSchema, } from "@fungi.computer/braid/git-access";
 import { gitSha1Schema } from "@fungi.computer/puffball/git-representation";
 import { workflowIdSchema, workflowIssueSchema as issueSchema, } from "./outcomes.js";
+/** Source Workflow and commit recorded when importing or forking a document. */
 export const provenanceSchema = z.lazy(() => z.union([
     z.strictObject({
         kind: z.literal("import"),
@@ -22,6 +23,7 @@ export const provenanceSchema = z.lazy(() => z.union([
     }),
 ]));
 const identity = z.string().min(1).max(256);
+/** Shared run request fields: identity, bindings, JSON input and optional delivery. */
 export const runBase = z.strictObject({
     requestId: identity,
     workflowId: workflowIdSchema,
@@ -29,10 +31,12 @@ export const runBase = z.strictObject({
     input: z.record(z.string(), z.json()),
     delivery: runDeliverySchema.optional(),
 });
+/** Run request pinned to either a published version or an exact Git commit. */
 export const publishedRun = z.lazy(() => z.union([
     runBase.extend({ version: z.number().int().positive() }),
     runBase.extend({ commit: gitSha1Schema }),
 ]));
+/** Wire document containing definition, node layout, provenance and commit. */
 export const document = z.strictObject({
     provenance: provenanceSchema.optional(),
     definition: z.record(z.string(), z.json()),
@@ -43,15 +47,19 @@ const invalid = z.strictObject({
     kind: z.literal("invalid"),
     issues: z.array(issueSchema),
 });
+/** Nonnegative revision used to fence draft replacements. */
 export const revisionSchema = z.number().int().nonnegative();
+/** Editable document with a draft revision instead of a published commit. */
 export const draftDocument = document
     .omit({ commit: true })
     .extend({ revision: revisionSchema });
+/** Published document identified by Workflow, version, commit and content digest. */
 export const publishedDocument = document.extend({
     workflowId: workflowIdSchema,
     version: z.number().int().positive(),
     digest: z.string().refine(S.is(sha256DigestSchema)),
 });
+/** Draft save result, including revision conflict or validation issues. */
 export const saveReply = z.union([
     z.strictObject({ kind: z.literal("saved"), revision: revisionSchema }),
     z.strictObject({
@@ -61,6 +69,7 @@ export const saveReply = z.union([
     invalid,
 ]);
 const reviewedNode = { graph: z.string(), node: z.string() };
+/** Share review listing Git access, write/external nodes and trigger configuration. */
 export const shareReview = z.strictObject({
     gitAccess: z.array(z.union([
         gitAccessSchema.options[0].extend(reviewedNode),
@@ -76,6 +85,7 @@ export const shareReview = z.strictObject({
     // Definition decoding owns trigger grammar; this reply transports configuration only.
     triggers: z.array(z.json()),
 });
+/** Import/fork result with the saved draft and review, or a typed refusal. */
 export const shareCopyReply = z.lazy(() => z.union([
     z.strictObject({
         kind: z.literal("saved"),
@@ -98,6 +108,7 @@ export const shareCopyReply = z.lazy(() => z.union([
         ]),
     }),
 ]));
+/** Exported bundle bytes and digest, or a missing/oversized bundle result. */
 export const shareExportReply = z.lazy(() => z.union([
     z.strictObject({
         bytes: z.string(),
@@ -105,44 +116,53 @@ export const shareExportReply = z.lazy(() => z.union([
     }),
     z.strictObject({ kind: z.enum(["not_found", "too_large"]) }),
 ]));
+/** Mint and validate identities for asynchronous Workflow publication attempts. */
 export const publicationIds = defineIdFamily({
     family: "workflow-publication",
     version: 1,
     kinds: { publication: { prefix: "publication" } },
 });
+/** Publication identity accepted by the maintained publication id family. */
 export const publicationIdSchema = z.lazy(() => z
     .string()
     .min(1)
     .max(256)
     .refine((value) => publicationIds.publication.is(value)));
+/** Publication failure categories returned by the host. */
 export const publicationFailure = z.enum([
     "git_conflict",
     "publication_failed",
     "too_large",
     "access_changed",
 ]);
+/** Completed publication's exact commit and assigned version. */
 export const publicationComplete = z.lazy(() => z.strictObject({
     kind: z.literal("published"),
     commit: gitSha1Schema,
     version: z.number().int().positive(),
 }));
+/** Pending publication identified for subsequent status reads. */
 export const publicationPending = z.lazy(() => z.strictObject({
     kind: z.literal("publishing"),
     publicationId: publicationIdSchema,
 }));
+/** Failed publication and its typed failure reason. */
 export const publicationFailed = z.lazy(() => z.strictObject({
     kind: z.literal("failed"),
     reason: publicationFailure,
 }));
+/** Current publication outcome, including an unknown publication identity. */
 export const publicationStatus = z.lazy(() => z.union([
     publicationPending,
     publicationComplete,
     publicationFailed,
     z.strictObject({ kind: z.literal("not_found") }),
 ]));
+/** Another publication attempt currently owns the publication operation. */
 export const publicationElsewhere = z.lazy(() => z.strictObject({
     kind: z.literal("publishing_elsewhere"),
 }));
+/** Publication command result, including pending work, conflict or validation issues. */
 export const publishReply = z.lazy(() => z.union([
     publicationElsewhere,
     publicationComplete,
@@ -154,13 +174,16 @@ export const publishReply = z.lazy(() => z.union([
     }),
     invalid,
 ]));
+/** Published version with commit identity, commit time and commit message. */
 export const version = z.strictObject({
     version: z.number().int().positive(),
     commit: gitSha1Schema,
     committedAt: z.number(),
     message: z.string(),
 });
+/** Identify one Workflow within the library. */
 export const workflow = z.strictObject({ workflowId: workflowIdSchema });
+/** Bounded library rows with draft revision and optional published reference. */
 export const listings = z.lazy(() => z
     .array(z.strictObject({
     workflowId: workflowIdSchema,
@@ -174,21 +197,27 @@ export const listings = z.lazy(() => z
         .nullable(),
 }))
     .max(100));
+/** Bounded Git history rows without a published-version number. */
 export const history = z.array(version.omit({ version: true })).max(50);
 /** A missing index is not an empty Git repository; only write paths reconstruct it. */
 export const libraryPageInput = z.lazy(() => z.strictObject({
     limit: z.number().int().min(1).max(100).default(100),
     after: workflowIdSchema.optional(),
 }));
+/** One library page with an optional exclusive cursor for the next page. */
 export const libraryPage = z.lazy(() => z.strictObject({
     items: listings,
     next: workflowIdSchema.optional(),
 }));
+/** Indexed library page, or an explicit indication that its index is missing. */
 export const libraryListing = z.lazy(() => z.union([libraryPage, z.strictObject({ kind: z.literal("unindexed") })]));
 /** A missing screen copy needs an explicit foreground rebuild, never a hidden Git read. */
 export const rebuilding = z.lazy(() => z.strictObject({ kind: z.literal("rebuilding") }));
+/** Draft/published document read, absence, or an explicit copy-rebuild state. */
 export const documentRead = z.lazy(() => z.union([draftDocument, document, z.null(), rebuilding]));
+/** Published version rows, or an explicit copy-rebuild state. */
 export const versionsRead = z.lazy(() => z.union([z.array(version), rebuilding]));
+/** Bounded copy-rebuild continuation, optionally targeting one pinned document. */
 export const rebuildCopiesInput = z.lazy(() => z.strictObject({
     cursor: z.string().max(1024).nullable(),
     target: workflow
@@ -197,6 +226,7 @@ export const rebuildCopiesInput = z.lazy(() => z.strictObject({
     })
         .optional(),
 }));
+/** Copy-rebuild progress and the cursor needed to continue unfinished work. */
 export const rebuildCopiesReply = z.lazy(() => z.strictObject({
     done: z.boolean(),
     cursor: z.string().max(1024).nullable(),

package/dist/outcomes.d.ts

@@ -1,5 +1,7 @@
 import * as z from "zod";
+/** Lowercase Workflow slug used by library files and host commands. */
 export declare const workflowIdSchema: z.ZodString;
+/** Select the palette index, or one installation's complete port declarations. */
 export declare const catalogInputSchema: z.ZodLazy<z.ZodObject<{
     installationId: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>>;
@@ -31,6 +33,7 @@ export declare const catalogReplySchema: z.ZodLazy<z.ZodUnion<readonly [z.ZodObj
         displayName: z.ZodString;
         icon: z.ZodOptional<z.ZodString>;
         capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            approvals: "approvals";
             "agent.list": "agent.list";
             "agent.manage": "agent.manage";
             "agent.rename": "agent.rename";
@@ -72,6 +75,7 @@ export declare const catalogReplySchema: z.ZodLazy<z.ZodUnion<readonly [z.ZodObj
         displayName: z.ZodString;
         icon: z.ZodOptional<z.ZodString>;
         capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            approvals: "approvals";
             "agent.list": "agent.list";
             "agent.manage": "agent.manage";
             "agent.rename": "agent.rename";
@@ -107,6 +111,7 @@ export declare const catalogReplySchema: z.ZodLazy<z.ZodUnion<readonly [z.ZodObj
 }, z.core.$strict>, z.ZodObject<{
     error: z.ZodString;
 }, z.core.$strict>]>>;
+/** Validation issue with optional graph, node, trigger, port or edge location. */
 export declare const workflowIssueSchema: z.ZodLazy<z.ZodObject<{
     code: z.ZodString;
     message: z.ZodString;
@@ -116,6 +121,7 @@ export declare const workflowIssueSchema: z.ZodLazy<z.ZodObject<{
     port: z.ZodOptional<z.ZodString>;
     edge: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>>;
+/** Run admission result, including replay/conflict, invalid input or refusal. */
 export declare const runReply: z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
     kind: z.ZodEnum<{
         started: "started";
@@ -138,6 +144,7 @@ export declare const runReply: z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
 }, z.core.$strict>, z.ZodObject<{
     error: z.ZodString;
 }, z.core.$strict>]>>;
+/** Cancellation result, an already-terminal run, or an authority refusal. */
 export declare const cancelReplySchema: z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
     kind: z.ZodEnum<{
         cancelled: "cancelled";
@@ -149,11 +156,13 @@ export declare const cancelReplySchema: z.ZodLazy<z.ZodUnion<readonly [z.ZodObje
 }, z.core.$strict>, z.ZodObject<{
     error: z.ZodString;
 }, z.core.$strict>]>>;
+/** Lifecycle outcome reported for a Workflow run. */
 export declare const runOutcomeSchema: z.ZodEnum<{
     cancelled: "cancelled";
     terminal: "terminal";
     active: "active";
 }>;
+/** Bounded run status snapshot with events, reviews, output and error. */
 export declare const statusReply: z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
     runId: z.ZodString;
     planDigest: z.ZodString;
@@ -171,6 +180,7 @@ export declare const statusReply: z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
 }, z.core.$strict>, z.ZodObject<{
     error: z.ZodString;
 }, z.core.$strict>]>>;
+/** Result of answering a waiting run review, or an invocation refusal. */
 export declare const answerReviewReply: z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
     result: z.ZodEnum<{
         invalid: "invalid";
@@ -181,6 +191,7 @@ export declare const answerReviewReply: z.ZodLazy<z.ZodUnion<readonly [z.ZodObje
 }, z.core.$strict>, z.ZodObject<{
     error: z.ZodString;
 }, z.core.$strict>]>>;
+/** Schedule-trigger admission or its refusal details. */
 export declare const scheduleArmReplySchema: z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
     kind: z.ZodLiteral<"armed">;
     scheduleId: z.ZodString;
@@ -191,6 +202,7 @@ export declare const scheduleArmReplySchema: z.ZodLazy<z.ZodUnion<readonly [z.Zo
 }, z.core.$strict>, z.ZodObject<{
     error: z.ZodString;
 }, z.core.$strict>]>>;
+/** Trigger disarm result, including an absent trigger or denied invocation. */
 export declare const triggerDisarmReplySchema: z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
     kind: z.ZodEnum<{
         disarmed: "disarmed";
@@ -199,9 +211,11 @@ export declare const triggerDisarmReplySchema: z.ZodLazy<z.ZodUnion<readonly [z.
 }, z.core.$strict>, z.ZodObject<{
     error: z.ZodString;
 }, z.core.$strict>]>>;
+/** Visible schedule-trigger rows with their next due time and lifecycle state. */
 export declare const schedulesReplySchema: z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
     schedules: z.ZodArray<z.ZodObject<{
         scheduleId: z.ZodString;
+        installationId: z.ZodString;
         workflowId: z.ZodString;
         triggerId: z.ZodString;
         nextDueAt: z.ZodNumber;
@@ -216,6 +230,7 @@ export declare const schedulesReplySchema: z.ZodLazy<z.ZodUnion<readonly [z.ZodO
 }, z.core.$strict>, z.ZodObject<{
     error: z.ZodString;
 }, z.core.$strict>]>>;
+/** Origin category recorded for a run: manual, schedule, event, Agent or key. */
 export declare const workflowRunSourceSchema: z.ZodEnum<{
     manual: "manual";
     schedule: "schedule";
@@ -236,6 +251,7 @@ export declare const workflowRunInitiatedBySchema: z.ZodLazy<z.ZodUnion<readonly
     keyId: z.ZodString;
     grantorMemberId: z.ZodString;
 }, z.core.$strict>]>>;
+/** Bounded recent-run rows with their source, initiator and pinned commit. */
 export declare const runsReplySchema: z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
     runs: z.ZodArray<z.ZodObject<{
         runId: z.ZodString;
@@ -266,6 +282,7 @@ export declare const runsReplySchema: z.ZodLazy<z.ZodUnion<readonly [z.ZodObject
 }, z.core.$strict>, z.ZodObject<{
     error: z.ZodString;
 }, z.core.$strict>]>>;
+/** Event-trigger admission or its refusal details. */
 export declare const eventArmReplySchema: z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
     kind: z.ZodLiteral<"armed">;
     eventTriggerId: z.ZodString;
@@ -276,6 +293,7 @@ export declare const eventArmReplySchema: z.ZodLazy<z.ZodUnion<readonly [z.ZodOb
 }, z.core.$strict>, z.ZodObject<{
     error: z.ZodString;
 }, z.core.$strict>]>>;
+/** Visible event-trigger rows with emitter, event and current state. */
 export declare const eventTriggersReplySchema: z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
     eventTriggers: z.ZodArray<z.ZodObject<{
         eventTriggerId: z.ZodString;