@vercel/factory 0.0.13 → 0.0.15

package/dist/schema/agent-route.d.mts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+//#region src/schema/agent-route.d.ts
+/** Validates an exact agent-route identity used for lookup and persisted recovery. */
+declare const agentRouteBindingSchema: z.core.$ZodBranded<z.ZodObject<{
+  id: z.ZodString;
+  version: z.ZodNumber;
+}, z.core.$strict>, "AgentRouteBinding", "out">;
+/** Exact identifier and version selecting one registered agent route. */
+type AgentRouteBinding<Id extends string = string, Version extends number = number> = z.infer<typeof agentRouteBindingSchema> & {
+  readonly id: Id;
+  readonly version: Version;
+};
+/** Plain identifier and version accepted when constructing an agent-route binding. */
+interface AgentRouteBindingInput<Id extends string = string, Version extends number = number> {
+  readonly id: Id;
+  readonly version: Version;
+}
+/** Validates and brands an exact agent-route binding while preserving literal identity. */
+declare function parseAgentRouteBinding<const Input extends AgentRouteBindingInput>(input: Input): AgentRouteBinding<Input["id"], Input["version"]>;
+//#endregion
+export { AgentRouteBinding, AgentRouteBindingInput, agentRouteBindingSchema, parseAgentRouteBinding };
+//# sourceMappingURL=agent-route.d.mts.map

package/dist/schema/agent-route.mjs

@@ -0,0 +1,15 @@
+import { z } from "zod";
+//#region src/schema/agent-route.ts
+/** Validates an exact agent-route identity used for lookup and persisted recovery. */
+const agentRouteBindingSchema = z.strictObject({
+	id: z.string().regex(/^[a-z][a-z0-9-]{0,63}$/u).describe("Stable route identifier selected by a workflow."),
+	version: z.number().int().positive().describe("Exact positive version of the selected route.")
+}).describe("Exact agent-route identity; lookup never defaults or selects a latest version.").brand();
+/** Validates and brands an exact agent-route binding while preserving literal identity. */
+function parseAgentRouteBinding(input) {
+	return agentRouteBindingSchema.parse(input);
+}
+//#endregion
+export { agentRouteBindingSchema, parseAgentRouteBinding };
+
+//# sourceMappingURL=agent-route.mjs.map

package/dist/schema/agent-route.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-route.mjs","names":[],"sources":["../../src/schema/agent-route.ts"],"sourcesContent":["import { z } from \"zod\";\n\n/** Validates an exact agent-route identity used for lookup and persisted recovery. */\nexport const agentRouteBindingSchema = z\n  .strictObject({\n    id: z\n      .string()\n      .regex(/^[a-z][a-z0-9-]{0,63}$/u)\n      .describe(\"Stable route identifier selected by a workflow.\"),\n    version: z.number().int().positive().describe(\"Exact positive version of the selected route.\"),\n  })\n  .describe(\"Exact agent-route identity; lookup never defaults or selects a latest version.\")\n  .brand<\"AgentRouteBinding\">();\n\n/** Exact identifier and version selecting one registered agent route. */\nexport type AgentRouteBinding<\n  Id extends string = string,\n  Version extends number = number,\n> = z.infer<typeof agentRouteBindingSchema> & {\n  readonly id: Id;\n  readonly version: Version;\n};\n\n/** Plain identifier and version accepted when constructing an agent-route binding. */\nexport interface AgentRouteBindingInput<\n  Id extends string = string,\n  Version extends number = number,\n> {\n  readonly id: Id;\n  readonly version: Version;\n}\n\n/** Validates and brands an exact agent-route binding while preserving literal identity. */\nexport function parseAgentRouteBinding<const Input extends AgentRouteBindingInput>(\n  input: Input,\n): AgentRouteBinding<Input[\"id\"], Input[\"version\"]> {\n  return agentRouteBindingSchema.parse(input) as AgentRouteBinding<Input[\"id\"], Input[\"version\"]>;\n}\n"],"mappings":";;;AAGA,MAAa,0BAA0B,EACpC,aAAa;CACZ,IAAI,EACD,OAAO,CAAC,CACR,MAAM,yBAAyB,CAAC,CAChC,SAAS,iDAAiD;CAC7D,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,+CAA+C;AAC/F,CAAC,CAAC,CACD,SAAS,gFAAgF,CAAC,CAC1F,MAA2B;;AAqB9B,SAAgB,uBACd,OACkD;CAClD,OAAO,wBAAwB,MAAM,KAAK;AAC5C"}

package/dist/schema/answer.d.mts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+//#region src/schema/answer.d.ts
+/** Validates an immutable authenticated answer to a workflow QuestionTask. */
+declare const answerEventSchema: z.ZodObject<{
+  schemaVersion: z.ZodLiteral<1>;
+  id: z.ZodType<`ans_${string}`, string, z.core.$ZodTypeInternals<`ans_${string}`, string>>;
+  questionTaskId: z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>;
+  parentTaskId: z.ZodOptional<z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>>;
+  repositoryIds: z.ZodReadonly<z.ZodTuple<[z.ZodType<`repo_${string}`, string, z.core.$ZodTypeInternals<`repo_${string}`, string>>], z.ZodType<`repo_${string}`, string, z.core.$ZodTypeInternals<`repo_${string}`, string>>>>;
+  replyTo: z.ZodObject<{
+    channel: z.ZodString;
+    address: z.ZodString;
+  }, z.core.$strict>;
+  question: z.ZodString;
+  answer: z.ZodString;
+  answeredBy: z.ZodString;
+  recordedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+/** Immutable authenticated answer projected onto a question and its parent Task. */
+type AnswerEvent = z.infer<typeof answerEventSchema>;
+//#endregion
+export { AnswerEvent, answerEventSchema };
+//# sourceMappingURL=answer.d.mts.map

package/dist/schema/answer.mjs

@@ -0,0 +1,21 @@
+import { answerIdSchema, repositoryIdsSchema, taskIdSchema } from "./id.mjs";
+import { isoDateTimeSchema, replyToSchema, schemaVersionSchema } from "./common.mjs";
+import { z } from "zod";
+//#region src/schema/answer.ts
+/** Validates an immutable authenticated answer to a workflow QuestionTask. */
+const answerEventSchema = z.strictObject({
+	schemaVersion: schemaVersionSchema,
+	id: answerIdSchema,
+	questionTaskId: taskIdSchema,
+	parentTaskId: taskIdSchema.optional(),
+	repositoryIds: repositoryIdsSchema,
+	replyTo: replyToSchema,
+	question: z.string().min(1),
+	answer: z.string().min(1).max(4e3),
+	answeredBy: z.string().min(1),
+	recordedAt: isoDateTimeSchema
+});
+//#endregion
+export { answerEventSchema };
+
+//# sourceMappingURL=answer.mjs.map

package/dist/schema/answer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"answer.mjs","names":[],"sources":["../../src/schema/answer.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { isoDateTimeSchema, replyToSchema, schemaVersionSchema } from \"./common\";\nimport { answerIdSchema, repositoryIdsSchema, taskIdSchema } from \"./id\";\n\n/** Validates an immutable authenticated answer to a workflow QuestionTask. */\nexport const answerEventSchema = z.strictObject({\n  schemaVersion: schemaVersionSchema,\n  id: answerIdSchema,\n  questionTaskId: taskIdSchema,\n  parentTaskId: taskIdSchema.optional(),\n  repositoryIds: repositoryIdsSchema,\n  replyTo: replyToSchema,\n  question: z.string().min(1),\n  answer: z.string().min(1).max(4000),\n  answeredBy: z.string().min(1),\n  recordedAt: isoDateTimeSchema,\n});\n\n/** Immutable authenticated answer projected onto a question and its parent Task. */\nexport type AnswerEvent = z.infer<typeof answerEventSchema>;\n"],"mappings":";;;;;AAKA,MAAa,oBAAoB,EAAE,aAAa;CAC9C,eAAe;CACf,IAAI;CACJ,gBAAgB;CAChB,cAAc,aAAa,SAAS;CACpC,eAAe;CACf,SAAS;CACT,UAAU,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;CAC1B,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAI;CAClC,YAAY,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;CAC5B,YAAY;AACd,CAAC"}

package/dist/schema/budget.d.mts

@@ -0,0 +1,38 @@
+import { z } from "zod";
+//#region src/schema/budget.d.ts
+/** UTC calendar month key in `YYYY-MM` form. */
+type BudgetMonth = `${number}-${"01" | "02" | "03" | "04" | "05" | "06" | "07" | "08" | "09" | "10" | "11" | "12"}`;
+/** Validates the UTC calendar month key used for a Factory budget. */
+declare const budgetMonthSchema: z.ZodType<BudgetMonth, string>;
+/** Validates Factory-wide, investigative, per-Task, and optional repository spending limits. */
+declare const budgetLimitsSchema: z.ZodReadonly<z.ZodObject<{
+  totalUsd: z.ZodNumber;
+  investigationUsd: z.ZodNumber;
+  perTaskReservationUsd: z.ZodNumber;
+  warningPercent: z.ZodNumber;
+  perRepositoryUsd: z.ZodOptional<z.ZodReadonly<z.ZodRecord<z.ZodType<`${string}/${string}`, string, z.core.$ZodTypeInternals<`${string}/${string}`, string>>, z.ZodNumber>>>;
+}, z.core.$strict>>;
+/** Validates one persisted monthly Factory budget and its emitted-notice state. */
+declare const budgetSchema: z.ZodReadonly<z.ZodObject<{
+  schemaVersion: z.ZodLiteral<1>;
+  factoryId: z.ZodType<`fac_${string}`, string, z.core.$ZodTypeInternals<`fac_${string}`, string>>;
+  month: z.ZodType<`${number}-01` | `${number}-02` | `${number}-03` | `${number}-04` | `${number}-05` | `${number}-06` | `${number}-07` | `${number}-08` | `${number}-09` | `${number}-10` | `${number}-11` | `${number}-12`, string, z.core.$ZodTypeInternals<`${number}-01` | `${number}-02` | `${number}-03` | `${number}-04` | `${number}-05` | `${number}-06` | `${number}-07` | `${number}-08` | `${number}-09` | `${number}-10` | `${number}-11` | `${number}-12`, string>>;
+  limits: z.ZodReadonly<z.ZodObject<{
+    totalUsd: z.ZodNumber;
+    investigationUsd: z.ZodNumber;
+    perTaskReservationUsd: z.ZodNumber;
+    warningPercent: z.ZodNumber;
+    perRepositoryUsd: z.ZodOptional<z.ZodReadonly<z.ZodRecord<z.ZodType<`${string}/${string}`, string, z.core.$ZodTypeInternals<`${string}/${string}`, string>>, z.ZodNumber>>>;
+  }, z.core.$strict>>;
+  notices: z.ZodReadonly<z.ZodObject<{
+    warningAt: z.ZodOptional<z.ZodISODateTime>;
+    exhaustedAt: z.ZodOptional<z.ZodISODateTime>;
+  }, z.core.$strict>>;
+}, z.core.$strict>>;
+/** Spending limits and warning threshold enforced for a monthly Factory budget. */
+type BudgetLimits = z.infer<typeof budgetLimitsSchema>;
+/** Persisted monthly Factory budget configuration and notice state. */
+type Budget = z.infer<typeof budgetSchema>;
+//#endregion
+export { Budget, BudgetLimits, BudgetMonth, budgetLimitsSchema, budgetMonthSchema, budgetSchema };
+//# sourceMappingURL=budget.d.mts.map

package/dist/schema/budget.mjs

@@ -0,0 +1,30 @@
+import { factoryIdSchema } from "./id.mjs";
+import { isoDateTimeSchema, schemaVersionSchema, usdSchema } from "./common.mjs";
+import { repositorySlugSchema } from "./repository.mjs";
+import { z } from "zod";
+//#region src/schema/budget.ts
+/** Validates the UTC calendar month key used for a Factory budget. */
+const budgetMonthSchema = z.string().regex(/^\d{4}-(0[1-9]|1[0-2])$/u, "Expected a UTC calendar month in YYYY-MM form");
+/** Validates Factory-wide, investigative, per-Task, and optional repository spending limits. */
+const budgetLimitsSchema = z.strictObject({
+	totalUsd: usdSchema,
+	investigationUsd: usdSchema,
+	perTaskReservationUsd: usdSchema,
+	warningPercent: z.number().int().min(1).max(100),
+	perRepositoryUsd: z.record(repositorySlugSchema, usdSchema).readonly().optional()
+}).readonly();
+/** Validates one persisted monthly Factory budget and its emitted-notice state. */
+const budgetSchema = z.strictObject({
+	schemaVersion: schemaVersionSchema,
+	factoryId: factoryIdSchema,
+	month: budgetMonthSchema,
+	limits: budgetLimitsSchema,
+	notices: z.strictObject({
+		warningAt: isoDateTimeSchema.optional(),
+		exhaustedAt: isoDateTimeSchema.optional()
+	}).readonly()
+}).readonly();
+//#endregion
+export { budgetLimitsSchema, budgetMonthSchema, budgetSchema };
+
+//# sourceMappingURL=budget.mjs.map

package/dist/schema/budget.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.mjs","names":[],"sources":["../../src/schema/budget.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { isoDateTimeSchema, schemaVersionSchema, usdSchema } from \"./common\";\nimport { factoryIdSchema } from \"./id\";\nimport { repositorySlugSchema } from \"./repository\";\n\n/** UTC calendar month key in `YYYY-MM` form. */\nexport type BudgetMonth = `${number}-${\n  | \"01\"\n  | \"02\"\n  | \"03\"\n  | \"04\"\n  | \"05\"\n  | \"06\"\n  | \"07\"\n  | \"08\"\n  | \"09\"\n  | \"10\"\n  | \"11\"\n  | \"12\"}`;\n\n/** Validates the UTC calendar month key used for a Factory budget. */\nexport const budgetMonthSchema = z\n  .string()\n  .regex(/^\\d{4}-(0[1-9]|1[0-2])$/u, \"Expected a UTC calendar month in YYYY-MM form\") as z.ZodType<\n  BudgetMonth,\n  string\n>;\n\n/** Validates Factory-wide, investigative, per-Task, and optional repository spending limits. */\nexport const budgetLimitsSchema = z\n  .strictObject({\n    totalUsd: usdSchema,\n    investigationUsd: usdSchema,\n    perTaskReservationUsd: usdSchema,\n    warningPercent: z.number().int().min(1).max(100),\n    perRepositoryUsd: z.record(repositorySlugSchema, usdSchema).readonly().optional(),\n  })\n  .readonly();\n\n/** Validates one persisted monthly Factory budget and its emitted-notice state. */\nexport const budgetSchema = z\n  .strictObject({\n    schemaVersion: schemaVersionSchema,\n    factoryId: factoryIdSchema,\n    month: budgetMonthSchema,\n    limits: budgetLimitsSchema,\n    notices: z\n      .strictObject({\n        warningAt: isoDateTimeSchema.optional(),\n        exhaustedAt: isoDateTimeSchema.optional(),\n      })\n      .readonly(),\n  })\n  .readonly();\n\n/** Spending limits and warning threshold enforced for a monthly Factory budget. */\nexport type BudgetLimits = z.infer<typeof budgetLimitsSchema>;\n/** Persisted monthly Factory budget configuration and notice state. */\nexport type Budget = z.infer<typeof budgetSchema>;\n"],"mappings":";;;;;;AAqBA,MAAa,oBAAoB,EAC9B,OAAO,CAAC,CACR,MAAM,4BAA4B,+CAA+C;;AAMpF,MAAa,qBAAqB,EAC/B,aAAa;CACZ,UAAU;CACV,kBAAkB;CAClB,uBAAuB;CACvB,gBAAgB,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG;CAC/C,kBAAkB,EAAE,OAAO,sBAAsB,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;AAClF,CAAC,CAAC,CACD,SAAS;;AAGZ,MAAa,eAAe,EACzB,aAAa;CACZ,eAAe;CACf,WAAW;CACX,OAAO;CACP,QAAQ;CACR,SAAS,EACN,aAAa;EACZ,WAAW,kBAAkB,SAAS;EACtC,aAAa,kBAAkB,SAAS;CAC1C,CAAC,CAAC,CACD,SAAS;AACd,CAAC,CAAC,CACD,SAAS"}

package/dist/schema/catalog.mjs

@@ -0,0 +1,72 @@
+import { isoDateTimeSchema, replyToSchema, schemaVersionSchema } from "./common.mjs";
+import { externalSessionSchema, storedSessionSchema } from "./stored-session.mjs";
+import { changeSchema } from "./change.mjs";
+import { storedTaskSchema } from "./stored-task.mjs";
+import { z } from "zod";
+//#region src/schema/catalog.ts
+const shardSchema = z.string().regex(/^[0-9a-f]$/u);
+const sourceVersionSchema = z.number().int().positive();
+const repairSchema = z.strictObject({
+	id: z.string().min(1),
+	sourceVersion: sourceVersionSchema
+});
+/** Validates one fixed shard of the recoverable Task discovery index. */
+const taskCatalogSchema = z.strictObject({
+	schemaVersion: schemaVersionSchema,
+	id: z.templateLiteral(["tasks-", shardSchema]),
+	entries: z.array(z.strictObject({
+		sourceVersion: sourceVersionSchema,
+		value: storedTaskSchema
+	})),
+	repairs: z.array(repairSchema).default([]),
+	updatedAt: isoDateTimeSchema
+});
+/** Validates one fixed shard of the recoverable Change discovery index. */
+const changeCatalogSchema = z.strictObject({
+	schemaVersion: schemaVersionSchema,
+	id: z.templateLiteral(["changes-", shardSchema]),
+	entries: z.array(z.strictObject({
+		sourceVersion: sourceVersionSchema,
+		value: changeSchema
+	})),
+	repairs: z.array(repairSchema).default([]),
+	updatedAt: isoDateTimeSchema
+});
+/** Validates one fixed shard of the recoverable operator-session discovery index. */
+const sessionCatalogSchema = z.strictObject({
+	schemaVersion: schemaVersionSchema,
+	id: z.templateLiteral(["sessions-", shardSchema]),
+	entries: z.array(z.strictObject({
+		sourceVersion: sourceVersionSchema,
+		value: storedSessionSchema
+	})),
+	repairs: z.array(repairSchema).default([]),
+	updatedAt: isoDateTimeSchema
+});
+/** Validates one fixed shard of the external-conversation discovery index. */
+const externalSessionCatalogSchema = z.strictObject({
+	schemaVersion: schemaVersionSchema,
+	id: z.templateLiteral(["external-sessions-", shardSchema]),
+	entries: z.array(z.strictObject({
+		sourceVersion: sourceVersionSchema,
+		value: externalSessionSchema
+	})),
+	repairs: z.array(repairSchema).default([]),
+	updatedAt: isoDateTimeSchema
+});
+/** Validates the directly addressed Task index for one reply destination. */
+const taskRouteSchema = z.strictObject({
+	schemaVersion: schemaVersionSchema,
+	id: z.string().regex(/^task-route_[a-z0-9]{6,64}$/u),
+	replyTo: replyToSchema,
+	entries: z.array(z.strictObject({
+		sourceVersion: sourceVersionSchema,
+		value: storedTaskSchema
+	})),
+	repairs: z.array(repairSchema).default([]),
+	updatedAt: isoDateTimeSchema
+});
+//#endregion
+export { changeCatalogSchema, externalSessionCatalogSchema, sessionCatalogSchema, taskCatalogSchema, taskRouteSchema };
+
+//# sourceMappingURL=catalog.mjs.map

package/dist/schema/catalog.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.mjs","names":[],"sources":["../../src/schema/catalog.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { isoDateTimeSchema, replyToSchema, schemaVersionSchema } from \"./common\";\nimport { changeSchema } from \"./change\";\nimport { externalSessionSchema, storedSessionSchema } from \"./stored-session\";\nimport { storedTaskSchema } from \"./stored-task\";\n\nconst shardSchema = z.string().regex(/^[0-9a-f]$/u);\nconst sourceVersionSchema = z.number().int().positive();\nconst repairSchema = z.strictObject({\n  id: z.string().min(1),\n  sourceVersion: sourceVersionSchema,\n});\n\n/** Validates one fixed shard of the recoverable Task discovery index. */\nexport const taskCatalogSchema = z.strictObject({\n  schemaVersion: schemaVersionSchema,\n  id: z.templateLiteral([\"tasks-\", shardSchema]),\n  entries: z.array(z.strictObject({ sourceVersion: sourceVersionSchema, value: storedTaskSchema })),\n  repairs: z.array(repairSchema).default([]),\n  updatedAt: isoDateTimeSchema,\n});\n\n/** Validates one fixed shard of the recoverable Change discovery index. */\nexport const changeCatalogSchema = z.strictObject({\n  schemaVersion: schemaVersionSchema,\n  id: z.templateLiteral([\"changes-\", shardSchema]),\n  entries: z.array(z.strictObject({ sourceVersion: sourceVersionSchema, value: changeSchema })),\n  repairs: z.array(repairSchema).default([]),\n  updatedAt: isoDateTimeSchema,\n});\n\n/** Validates one fixed shard of the recoverable operator-session discovery index. */\nexport const sessionCatalogSchema = z.strictObject({\n  schemaVersion: schemaVersionSchema,\n  id: z.templateLiteral([\"sessions-\", shardSchema]),\n  entries: z.array(\n    z.strictObject({ sourceVersion: sourceVersionSchema, value: storedSessionSchema }),\n  ),\n  repairs: z.array(repairSchema).default([]),\n  updatedAt: isoDateTimeSchema,\n});\n\n/** Validates one fixed shard of the external-conversation discovery index. */\nexport const externalSessionCatalogSchema = z.strictObject({\n  schemaVersion: schemaVersionSchema,\n  id: z.templateLiteral([\"external-sessions-\", shardSchema]),\n  entries: z.array(\n    z.strictObject({ sourceVersion: sourceVersionSchema, value: externalSessionSchema }),\n  ),\n  repairs: z.array(repairSchema).default([]),\n  updatedAt: isoDateTimeSchema,\n});\n\n/** Validates the directly addressed Task index for one reply destination. */\nexport const taskRouteSchema = z.strictObject({\n  schemaVersion: schemaVersionSchema,\n  id: z.string().regex(/^task-route_[a-z0-9]{6,64}$/u),\n  replyTo: replyToSchema,\n  entries: z.array(z.strictObject({ sourceVersion: sourceVersionSchema, value: storedTaskSchema })),\n  repairs: z.array(repairSchema).default([]),\n  updatedAt: isoDateTimeSchema,\n});\n"],"mappings":";;;;;;AAMA,MAAM,cAAc,EAAE,OAAO,CAAC,CAAC,MAAM,aAAa;AAClD,MAAM,sBAAsB,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS;AACtD,MAAM,eAAe,EAAE,aAAa;CAClC,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;CACpB,eAAe;AACjB,CAAC;;AAGD,MAAa,oBAAoB,EAAE,aAAa;CAC9C,eAAe;CACf,IAAI,EAAE,gBAAgB,CAAC,UAAU,WAAW,CAAC;CAC7C,SAAS,EAAE,MAAM,EAAE,aAAa;EAAE,eAAe;EAAqB,OAAO;CAAiB,CAAC,CAAC;CAChG,SAAS,EAAE,MAAM,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC;CACzC,WAAW;AACb,CAAC;;AAGD,MAAa,sBAAsB,EAAE,aAAa;CAChD,eAAe;CACf,IAAI,EAAE,gBAAgB,CAAC,YAAY,WAAW,CAAC;CAC/C,SAAS,EAAE,MAAM,EAAE,aAAa;EAAE,eAAe;EAAqB,OAAO;CAAa,CAAC,CAAC;CAC5F,SAAS,EAAE,MAAM,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC;CACzC,WAAW;AACb,CAAC;;AAGD,MAAa,uBAAuB,EAAE,aAAa;CACjD,eAAe;CACf,IAAI,EAAE,gBAAgB,CAAC,aAAa,WAAW,CAAC;CAChD,SAAS,EAAE,MACT,EAAE,aAAa;EAAE,eAAe;EAAqB,OAAO;CAAoB,CAAC,CACnF;CACA,SAAS,EAAE,MAAM,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC;CACzC,WAAW;AACb,CAAC;;AAGD,MAAa,+BAA+B,EAAE,aAAa;CACzD,eAAe;CACf,IAAI,EAAE,gBAAgB,CAAC,sBAAsB,WAAW,CAAC;CACzD,SAAS,EAAE,MACT,EAAE,aAAa;EAAE,eAAe;EAAqB,OAAO;CAAsB,CAAC,CACrF;CACA,SAAS,EAAE,MAAM,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC;CACzC,WAAW;AACb,CAAC;;AAGD,MAAa,kBAAkB,EAAE,aAAa;CAC5C,eAAe;CACf,IAAI,EAAE,OAAO,CAAC,CAAC,MAAM,8BAA8B;CACnD,SAAS;CACT,SAAS,EAAE,MAAM,EAAE,aAAa;EAAE,eAAe;EAAqB,OAAO;CAAiB,CAAC,CAAC;CAChG,SAAS,EAAE,MAAM,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC;CACzC,WAAW;AACb,CAAC"}

package/dist/schema/change.d.mts

@@ -0,0 +1,117 @@
+import { z } from "zod";
+//#region src/schema/change.d.ts
+/** Validates the shared ordinal scale used for risk and confidence. */
+declare const changeLevelSchema: z.ZodEnum<{
+  low: "low";
+  medium: "medium";
+  high: "high";
+}>;
+/** Validates the durable lifecycle state of a pull-request Change. */
+declare const changeStateSchema: z.ZodEnum<{
+  verifying: "verifying";
+  ready: "ready";
+  merged: "merged";
+  deployed: "deployed";
+  rolled_out: "rolled_out";
+  rolled_back: "rolled_back";
+  closed: "closed";
+}>;
+/** Validates the verification evidence used to assess a Change. */
+declare const changeEvidenceSchema: z.ZodObject<{
+  reproVerified: z.ZodBoolean;
+  testsAdded: z.ZodNumber;
+  checksGreen: z.ZodBoolean;
+  attackPassed: z.ZodBoolean;
+  scopeMatches: z.ZodBoolean;
+  previewUrl: z.ZodOptional<z.ZodURL>;
+}, z.core.$strict>;
+/** Validates a persisted human-visible pull-request Change and its trust evidence. */
+declare const changeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  state: z.ZodEnum<{
+    verifying: "verifying";
+    ready: "ready";
+    closed: "closed";
+  }>;
+  decidedBy: z.ZodOptional<z.ZodString>;
+  schemaVersion: z.ZodLiteral<1>;
+  id: z.ZodType<`chg_${string}`, string, z.core.$ZodTypeInternals<`chg_${string}`, string>>;
+  repositoryId: z.ZodType<`repo_${string}`, string, z.core.$ZodTypeInternals<`repo_${string}`, string>>;
+  taskId: z.ZodOptional<z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>>;
+  groupId: z.ZodOptional<z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>>;
+  prNumber: z.ZodNumber;
+  prUrl: z.ZodURL;
+  author: z.ZodString;
+  risk: z.ZodEnum<{
+    low: "low";
+    medium: "medium";
+    high: "high";
+  }>;
+  confidence: z.ZodEnum<{
+    low: "low";
+    medium: "medium";
+    high: "high";
+  }>;
+  evidence: z.ZodObject<{
+    reproVerified: z.ZodBoolean;
+    testsAdded: z.ZodNumber;
+    checksGreen: z.ZodBoolean;
+    attackPassed: z.ZodBoolean;
+    scopeMatches: z.ZodBoolean;
+    previewUrl: z.ZodOptional<z.ZodURL>;
+  }, z.core.$strict>;
+  mergeSha: z.ZodOptional<z.ZodString>;
+  createdAt: z.ZodISODateTime;
+  updatedAt: z.ZodISODateTime;
+}, z.core.$strict>, z.ZodObject<{
+  state: z.ZodEnum<{
+    merged: "merged";
+    deployed: "deployed";
+    rolled_out: "rolled_out";
+    rolled_back: "rolled_back";
+  }>;
+  decidedBy: z.ZodString;
+  schemaVersion: z.ZodLiteral<1>;
+  id: z.ZodType<`chg_${string}`, string, z.core.$ZodTypeInternals<`chg_${string}`, string>>;
+  repositoryId: z.ZodType<`repo_${string}`, string, z.core.$ZodTypeInternals<`repo_${string}`, string>>;
+  taskId: z.ZodOptional<z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>>;
+  groupId: z.ZodOptional<z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>>;
+  prNumber: z.ZodNumber;
+  prUrl: z.ZodURL;
+  author: z.ZodString;
+  risk: z.ZodEnum<{
+    low: "low";
+    medium: "medium";
+    high: "high";
+  }>;
+  confidence: z.ZodEnum<{
+    low: "low";
+    medium: "medium";
+    high: "high";
+  }>;
+  evidence: z.ZodObject<{
+    reproVerified: z.ZodBoolean;
+    testsAdded: z.ZodNumber;
+    checksGreen: z.ZodBoolean;
+    attackPassed: z.ZodBoolean;
+    scopeMatches: z.ZodBoolean;
+    previewUrl: z.ZodOptional<z.ZodURL>;
+  }, z.core.$strict>;
+  mergeSha: z.ZodOptional<z.ZodString>;
+  createdAt: z.ZodISODateTime;
+  updatedAt: z.ZodISODateTime;
+}, z.core.$strict>], "state">;
+/** Shared low-to-high ordinal value used for risk and confidence. */
+type ChangeLevel = z.infer<typeof changeLevelSchema>;
+/** Durable lifecycle state of a human-visible pull-request Change. */
+type ChangeState = z.infer<typeof changeStateSchema>;
+/** Verification facts supporting the risk and confidence assigned to a Change. */
+type ChangeEvidence = z.infer<typeof changeEvidenceSchema>;
+/** Persisted pull-request Change tracked independently from the Tasks that produced it. */
+type Change = z.infer<typeof changeSchema>;
+/** Change read model narrowed to one exact lifecycle state. */
+type ChangeInState<State extends ChangeState> = Change & {
+  readonly state: State;
+};
+//#endregion
+export { Change, ChangeEvidence, ChangeInState, ChangeLevel, ChangeState, changeEvidenceSchema, changeLevelSchema, changeSchema, changeStateSchema };
+//# sourceMappingURL=change.d.mts.map

package/dist/schema/change.mjs

@@ -0,0 +1,68 @@
+import { changeIdSchema, repositoryIdSchema, taskIdSchema } from "./id.mjs";
+import { isoDateTimeSchema, schemaVersionSchema } from "./common.mjs";
+import { z } from "zod";
+//#region src/schema/change.ts
+/** Validates the shared ordinal scale used for risk and confidence. */
+const changeLevelSchema = z.enum([
+	"low",
+	"medium",
+	"high"
+]);
+/** Validates the durable lifecycle state of a pull-request Change. */
+const changeStateSchema = z.enum([
+	"verifying",
+	"ready",
+	"merged",
+	"deployed",
+	"rolled_out",
+	"rolled_back",
+	"closed"
+]);
+/** Validates the verification evidence used to assess a Change. */
+const changeEvidenceSchema = z.strictObject({
+	reproVerified: z.boolean(),
+	testsAdded: z.number().int().min(0),
+	checksGreen: z.boolean(),
+	attackPassed: z.boolean(),
+	scopeMatches: z.boolean(),
+	previewUrl: z.url().optional()
+});
+const changeFields = {
+	schemaVersion: schemaVersionSchema,
+	id: changeIdSchema,
+	repositoryId: repositoryIdSchema,
+	taskId: taskIdSchema.optional(),
+	groupId: taskIdSchema.optional(),
+	prNumber: z.number().int().min(1),
+	prUrl: z.url(),
+	author: z.string().min(1),
+	risk: changeLevelSchema,
+	confidence: changeLevelSchema,
+	evidence: changeEvidenceSchema,
+	mergeSha: z.string().regex(/^[0-9a-f]{40}$/).optional().describe("Merge commit sha recorded when the pull request merges, matched against production deployments."),
+	createdAt: isoDateTimeSchema,
+	updatedAt: isoDateTimeSchema
+};
+/** Validates a persisted human-visible pull-request Change and its trust evidence. */
+const changeSchema = z.discriminatedUnion("state", [z.strictObject({
+	...changeFields,
+	state: z.enum([
+		"verifying",
+		"ready",
+		"closed"
+	]),
+	decidedBy: z.string().min(1).optional()
+}), z.strictObject({
+	...changeFields,
+	state: z.enum([
+		"merged",
+		"deployed",
+		"rolled_out",
+		"rolled_back"
+	]),
+	decidedBy: z.string().min(1)
+})]);
+//#endregion
+export { changeEvidenceSchema, changeLevelSchema, changeSchema, changeStateSchema };
+
+//# sourceMappingURL=change.mjs.map

package/dist/schema/change.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"change.mjs","names":[],"sources":["../../src/schema/change.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { isoDateTimeSchema, schemaVersionSchema } from \"./common\";\nimport { changeIdSchema, repositoryIdSchema, taskIdSchema } from \"./id\";\n\n/** Validates the shared ordinal scale used for risk and confidence. */\nexport const changeLevelSchema = z.enum([\"low\", \"medium\", \"high\"]);\n\n/** Validates the durable lifecycle state of a pull-request Change. */\nexport const changeStateSchema = z.enum([\n  \"verifying\",\n  \"ready\",\n  \"merged\",\n  \"deployed\",\n  \"rolled_out\",\n  \"rolled_back\",\n  \"closed\",\n]);\n\n/** Validates the verification evidence used to assess a Change. */\nexport const changeEvidenceSchema = z.strictObject({\n  reproVerified: z.boolean(),\n  testsAdded: z.number().int().min(0),\n  checksGreen: z.boolean(),\n  attackPassed: z.boolean(),\n  scopeMatches: z.boolean(),\n  previewUrl: z.url().optional(),\n});\n\nconst changeFields = {\n  schemaVersion: schemaVersionSchema,\n  id: changeIdSchema,\n  repositoryId: repositoryIdSchema,\n  taskId: taskIdSchema.optional(),\n  groupId: taskIdSchema.optional(),\n  prNumber: z.number().int().min(1),\n  prUrl: z.url(),\n  author: z.string().min(1),\n  risk: changeLevelSchema,\n  confidence: changeLevelSchema,\n  evidence: changeEvidenceSchema,\n  mergeSha: z\n    .string()\n    .regex(/^[0-9a-f]{40}$/)\n    .optional()\n    .describe(\n      \"Merge commit sha recorded when the pull request merges, matched against production deployments.\",\n    ),\n  createdAt: isoDateTimeSchema,\n  updatedAt: isoDateTimeSchema,\n} as const;\n\n/** Validates a persisted human-visible pull-request Change and its trust evidence. */\nexport const changeSchema = z.discriminatedUnion(\"state\", [\n  z.strictObject({\n    ...changeFields,\n    state: z.enum([\"verifying\", \"ready\", \"closed\"]),\n    decidedBy: z.string().min(1).optional(),\n  }),\n  z.strictObject({\n    ...changeFields,\n    state: z.enum([\"merged\", \"deployed\", \"rolled_out\", \"rolled_back\"]),\n    decidedBy: z.string().min(1),\n  }),\n]);\n\n/** Shared low-to-high ordinal value used for risk and confidence. */\nexport type ChangeLevel = z.infer<typeof changeLevelSchema>;\n/** Durable lifecycle state of a human-visible pull-request Change. */\nexport type ChangeState = z.infer<typeof changeStateSchema>;\n/** Verification facts supporting the risk and confidence assigned to a Change. */\nexport type ChangeEvidence = z.infer<typeof changeEvidenceSchema>;\n/** Persisted pull-request Change tracked independently from the Tasks that produced it. */\nexport type Change = z.infer<typeof changeSchema>;\n/** Change read model narrowed to one exact lifecycle state. */\nexport type ChangeInState<State extends ChangeState> = Change & { readonly state: State };\n"],"mappings":";;;;;AAKA,MAAa,oBAAoB,EAAE,KAAK;CAAC;CAAO;CAAU;AAAM,CAAC;;AAGjE,MAAa,oBAAoB,EAAE,KAAK;CACtC;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;AAGD,MAAa,uBAAuB,EAAE,aAAa;CACjD,eAAe,EAAE,QAAQ;CACzB,YAAY,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;CAClC,aAAa,EAAE,QAAQ;CACvB,cAAc,EAAE,QAAQ;CACxB,cAAc,EAAE,QAAQ;CACxB,YAAY,EAAE,IAAI,CAAC,CAAC,SAAS;AAC/B,CAAC;AAED,MAAM,eAAe;CACnB,eAAe;CACf,IAAI;CACJ,cAAc;CACd,QAAQ,aAAa,SAAS;CAC9B,SAAS,aAAa,SAAS;CAC/B,UAAU,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;CAChC,OAAO,EAAE,IAAI;CACb,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;CACxB,MAAM;CACN,YAAY;CACZ,UAAU;CACV,UAAU,EACP,OAAO,CAAC,CACR,MAAM,gBAAgB,CAAC,CACvB,SAAS,CAAC,CACV,SACC,iGACF;CACF,WAAW;CACX,WAAW;AACb;;AAGA,MAAa,eAAe,EAAE,mBAAmB,SAAS,CACxD,EAAE,aAAa;CACb,GAAG;CACH,OAAO,EAAE,KAAK;EAAC;EAAa;EAAS;CAAQ,CAAC;CAC9C,WAAW,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;AACxC,CAAC,GACD,EAAE,aAAa;CACb,GAAG;CACH,OAAO,EAAE,KAAK;EAAC;EAAU;EAAY;EAAc;CAAa,CAAC;CACjE,WAAW,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;AAC7B,CAAC,CACH,CAAC"}

package/dist/schema/common.d.mts

@@ -0,0 +1,33 @@
+import { z } from "zod";
+//#region src/schema/common.d.ts
+/** Clock returning a validated UTC ISO-8601 timestamp string. */
+type IsoDateTimeClock = () => string;
+/** Clock returning a Date for calendar and elapsed-time policy decisions. */
+type DateClock = () => Date;
+/** Monotonic-style clock returning elapsed milliseconds as a number. */
+type MillisecondClock = () => number;
+/** Value supplied synchronously or through a Promise. */
+type MaybePromise<Value> = Value | Promise<Value>;
+/** Version written into every persisted Factory entity snapshot. */
+declare const SCHEMA_VERSION = 1;
+/** Validates the schema version supported by this package release. */
+declare const schemaVersionSchema: z.ZodLiteral<1>;
+/** Validates UTC timestamps serialized in ISO 8601 form. */
+declare const isoDateTimeSchema: z.ZodISODateTime;
+/** Validates a finite, nonnegative monetary amount denominated in US dollars. */
+declare const usdSchema: z.ZodNumber;
+/**
+ * Open vocabulary value. Standard values ship as exported constants; custom
+ * values matching the pattern are equally valid.
+ */
+declare const vocabularySchema: z.ZodString;
+/** Validates a connector-neutral destination for workflow replies. */
+declare const replyToSchema: z.ZodObject<{
+  channel: z.ZodString;
+  address: z.ZodString;
+}, z.core.$strict>;
+/** Connector-neutral destination that preserves where a workflow should reply. */
+type ReplyTo = z.infer<typeof replyToSchema>;
+//#endregion
+export { DateClock, IsoDateTimeClock, MaybePromise, MillisecondClock, ReplyTo, SCHEMA_VERSION, isoDateTimeSchema, replyToSchema, schemaVersionSchema, usdSchema, vocabularySchema };
+//# sourceMappingURL=common.d.mts.map

package/dist/{id-DwCihQr4.mjs → schema/common.mjs}

@@ -1,31 +1,24 @@
 import { z } from "zod";
 //#region src/schema/common.ts
+/** Version written into every persisted Factory entity snapshot. */
 const SCHEMA_VERSION = 1;
+/** Validates the schema version supported by this package release. */
 const schemaVersionSchema = z.literal(1).describe("Version of the entity schema this row was written with.");
+/** Validates UTC timestamps serialized in ISO 8601 form. */
 const isoDateTimeSchema = z.iso.datetime().describe("UTC timestamp in ISO 8601 format, e.g. 2026-08-26T12:00:00Z.");
+/** Validates a finite, nonnegative monetary amount denominated in US dollars. */
 const usdSchema = z.number().finite().nonnegative().describe("Amount in US dollars.");
 /**
 * Open vocabulary value. Standard values ship as exported constants; custom
 * values matching the pattern are equally valid.
 */
 const vocabularySchema = z.string().regex(/^[a-z][a-z0-9_]{0,63}$/, "must be lowercase snake_case starting with a letter").describe("Lowercase snake_case name, e.g. github_issue or sentry_alert.");
+/** Validates a connector-neutral destination for workflow replies. */
 const replyToSchema = z.strictObject({
 	channel: z.string().min(1).describe("Connector that should carry replies, e.g. github or slack."),
 	address: z.string().min(1).describe("Connector-specific reply address, e.g. acme/web#41 or a Slack thread id.")
 });
 //#endregion
-//#region src/schema/id.ts
-function idSchema(prefix) {
-	return z.string().regex(new RegExp(`^${prefix}_[a-z0-9]{6,64}$`));
-}
-const factoryIdSchema = idSchema("fac");
-const repositoryIdSchema = idSchema("repo");
-const signalIdSchema = idSchema("sig");
-const taskIdSchema = idSchema("task");
-const changeIdSchema = idSchema("chg");
-const receiptIdSchema = idSchema("rcpt");
-const repositoryIdsSchema = z.array(repositoryIdSchema).min(1);
-//#endregion
-export { repositoryIdsSchema as a, SCHEMA_VERSION as c, schemaVersionSchema as d, usdSchema as f, repositoryIdSchema as i, isoDateTimeSchema as l, factoryIdSchema as n, signalIdSchema as o, vocabularySchema as p, receiptIdSchema as r, taskIdSchema as s, changeIdSchema as t, replyToSchema as u };
+export { SCHEMA_VERSION, isoDateTimeSchema, replyToSchema, schemaVersionSchema, usdSchema, vocabularySchema };
 
-//# sourceMappingURL=id-DwCihQr4.mjs.map
+//# sourceMappingURL=common.mjs.map

package/dist/schema/common.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.mjs","names":[],"sources":["../../src/schema/common.ts"],"sourcesContent":["import { z } from \"zod\";\n\n/** Clock returning a validated UTC ISO-8601 timestamp string. */\nexport type IsoDateTimeClock = () => string;\n/** Clock returning a Date for calendar and elapsed-time policy decisions. */\nexport type DateClock = () => Date;\n/** Monotonic-style clock returning elapsed milliseconds as a number. */\nexport type MillisecondClock = () => number;\n/** Value supplied synchronously or through a Promise. */\nexport type MaybePromise<Value> = Value | Promise<Value>;\n\n/** Version written into every persisted Factory entity snapshot. */\nexport const SCHEMA_VERSION = 1;\n\n/** Validates the schema version supported by this package release. */\nexport const schemaVersionSchema = z\n  .literal(SCHEMA_VERSION)\n  .describe(\"Version of the entity schema this row was written with.\");\n\n/** Validates UTC timestamps serialized in ISO 8601 form. */\nexport const isoDateTimeSchema = z.iso\n  .datetime()\n  .describe(\"UTC timestamp in ISO 8601 format, e.g. 2026-08-26T12:00:00Z.\");\n\n/** Validates a finite, nonnegative monetary amount denominated in US dollars. */\nexport const usdSchema = z.number().finite().nonnegative().describe(\"Amount in US dollars.\");\n\n/**\n * Open vocabulary value. Standard values ship as exported constants; custom\n * values matching the pattern are equally valid.\n */\nexport const vocabularySchema = z\n  .string()\n  .regex(/^[a-z][a-z0-9_]{0,63}$/, \"must be lowercase snake_case starting with a letter\")\n  .describe(\"Lowercase snake_case name, e.g. github_issue or sentry_alert.\");\n\n/** Validates a connector-neutral destination for workflow replies. */\nexport const replyToSchema = z.strictObject({\n  channel: z.string().min(1).describe(\"Connector that should carry replies, e.g. github or slack.\"),\n  address: z\n    .string()\n    .min(1)\n    .describe(\"Connector-specific reply address, e.g. acme/web#41 or a Slack thread id.\"),\n});\n\n/** Connector-neutral destination that preserves where a workflow should reply. */\nexport type ReplyTo = z.infer<typeof replyToSchema>;\n"],"mappings":";;;AAYA,MAAa,iBAAiB;;AAG9B,MAAa,sBAAsB,EAChC,QAAA,CAAsB,CAAC,CACvB,SAAS,yDAAyD;;AAGrE,MAAa,oBAAoB,EAAE,IAChC,SAAS,CAAC,CACV,SAAS,8DAA8D;;AAG1E,MAAa,YAAY,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,SAAS,uBAAuB;;;;;AAM3F,MAAa,mBAAmB,EAC7B,OAAO,CAAC,CACR,MAAM,0BAA0B,qDAAqD,CAAC,CACtF,SAAS,+DAA+D;;AAG3E,MAAa,gBAAgB,EAAE,aAAa;CAC1C,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,4DAA4D;CAChG,SAAS,EACN,OAAO,CAAC,CACR,IAAI,CAAC,CAAC,CACN,SAAS,0EAA0E;AACxF,CAAC"}

package/dist/schema/communication.d.mts

@@ -0,0 +1,52 @@
+import { z } from "zod";
+//#region src/schema/communication.d.ts
+/** Standard connector-neutral outcomes understood by communication presenters. */
+declare const communicationOutcomes: readonly ["accepted", "started", "succeeded", "failed", "cancelled", "needs_human", "question", "digest", "rolled_back", "budget_warning", "budget_exhausted", "message"];
+/** Validates the bounded outcome vocabulary of an outbound communication event. */
+declare const communicationOutcomeSchema: z.ZodEnum<{
+  message: "message";
+  succeeded: "succeeded";
+  failed: "failed";
+  needs_human: "needs_human";
+  cancelled: "cancelled";
+  accepted: "accepted";
+  question: "question";
+  rolled_back: "rolled_back";
+  started: "started";
+  digest: "digest";
+  budget_warning: "budget_warning";
+  budget_exhausted: "budget_exhausted";
+}>;
+/** Validates a connector-neutral event queued for delivery to its original destination. */
+declare const communicationEventSchema: z.ZodObject<{
+  eventId: z.ZodString;
+  repositoryIds: z.ZodReadonly<z.ZodTuple<[z.ZodType<`repo_${string}`, string, z.core.$ZodTypeInternals<`repo_${string}`, string>>], z.ZodType<`repo_${string}`, string, z.core.$ZodTypeInternals<`repo_${string}`, string>>>>;
+  taskId: z.ZodOptional<z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>>;
+  changeId: z.ZodOptional<z.ZodType<`chg_${string}`, string, z.core.$ZodTypeInternals<`chg_${string}`, string>>>;
+  replyTo: z.ZodObject<{
+    channel: z.ZodString;
+    address: z.ZodString;
+  }, z.core.$strict>;
+  outcome: z.ZodEnum<{
+    message: "message";
+    succeeded: "succeeded";
+    failed: "failed";
+    needs_human: "needs_human";
+    cancelled: "cancelled";
+    accepted: "accepted";
+    question: "question";
+    rolled_back: "rolled_back";
+    started: "started";
+    digest: "digest";
+    budget_warning: "budget_warning";
+    budget_exhausted: "budget_exhausted";
+  }>;
+  data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strict>;
+/** Outcome category used by connector renderers to present a workflow event. */
+type CommunicationOutcome = z.infer<typeof communicationOutcomeSchema>;
+/** Connector-neutral outbound workflow event with a stable delivery identity. */
+type CommunicationEvent = z.infer<typeof communicationEventSchema>;
+//#endregion
+export { CommunicationEvent, CommunicationOutcome, communicationEventSchema, communicationOutcomeSchema, communicationOutcomes };
+//# sourceMappingURL=communication.d.mts.map

package/dist/schema/communication.mjs

@@ -0,0 +1,35 @@
+import { changeIdSchema, repositoryIdsSchema, taskIdSchema } from "./id.mjs";
+import { replyToSchema } from "./common.mjs";
+import { z } from "zod";
+//#region src/schema/communication.ts
+/** Standard connector-neutral outcomes understood by communication presenters. */
+const communicationOutcomes = [
+	"accepted",
+	"started",
+	"succeeded",
+	"failed",
+	"cancelled",
+	"needs_human",
+	"question",
+	"digest",
+	"rolled_back",
+	"budget_warning",
+	"budget_exhausted",
+	"message"
+];
+/** Validates the bounded outcome vocabulary of an outbound communication event. */
+const communicationOutcomeSchema = z.enum(communicationOutcomes).describe("Lifecycle outcome a connector should render and deliver.");
+/** Validates a connector-neutral event queued for delivery to its original destination. */
+const communicationEventSchema = z.strictObject({
+	eventId: z.string().min(1).describe("Stable idempotency key for this delivery."),
+	repositoryIds: repositoryIdsSchema,
+	taskId: taskIdSchema.optional(),
+	changeId: changeIdSchema.optional(),
+	replyTo: replyToSchema,
+	outcome: communicationOutcomeSchema,
+	data: z.record(z.string(), z.unknown()).describe("Outcome-specific connector payload.")
+});
+//#endregion
+export { communicationEventSchema, communicationOutcomeSchema, communicationOutcomes };
+
+//# sourceMappingURL=communication.mjs.map

package/dist/schema/communication.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"communication.mjs","names":[],"sources":["../../src/schema/communication.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { replyToSchema } from \"./common\";\nimport { changeIdSchema, repositoryIdsSchema, taskIdSchema } from \"./id\";\n\n/** Standard connector-neutral outcomes understood by communication presenters. */\nexport const communicationOutcomes = [\n  \"accepted\",\n  \"started\",\n  \"succeeded\",\n  \"failed\",\n  \"cancelled\",\n  \"needs_human\",\n  \"question\",\n  \"digest\",\n  \"rolled_back\",\n  \"budget_warning\",\n  \"budget_exhausted\",\n  \"message\",\n] as const;\n\n/** Validates the bounded outcome vocabulary of an outbound communication event. */\nexport const communicationOutcomeSchema = z\n  .enum(communicationOutcomes)\n  .describe(\"Lifecycle outcome a connector should render and deliver.\");\n\n/** Validates a connector-neutral event queued for delivery to its original destination. */\nexport const communicationEventSchema = z.strictObject({\n  eventId: z.string().min(1).describe(\"Stable idempotency key for this delivery.\"),\n  repositoryIds: repositoryIdsSchema,\n  taskId: taskIdSchema.optional(),\n  changeId: changeIdSchema.optional(),\n  replyTo: replyToSchema,\n  outcome: communicationOutcomeSchema,\n  data: z.record(z.string(), z.unknown()).describe(\"Outcome-specific connector payload.\"),\n});\n\n/** Outcome category used by connector renderers to present a workflow event. */\nexport type CommunicationOutcome = z.infer<typeof communicationOutcomeSchema>;\n/** Connector-neutral outbound workflow event with a stable delivery identity. */\nexport type CommunicationEvent = z.infer<typeof communicationEventSchema>;\n"],"mappings":";;;;;AAKA,MAAa,wBAAwB;CACnC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;;AAGA,MAAa,6BAA6B,EACvC,KAAK,qBAAqB,CAAC,CAC3B,SAAS,0DAA0D;;AAGtE,MAAa,2BAA2B,EAAE,aAAa;CACrD,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,2CAA2C;CAC/E,eAAe;CACf,QAAQ,aAAa,SAAS;CAC9B,UAAU,eAAe,SAAS;CAClC,SAAS;CACT,SAAS;CACT,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,qCAAqC;AACxF,CAAC"}