@vercel/factory 0.0.14 → 0.0.16

package/dist/schema/session.d.mts

@@ -0,0 +1,136 @@
+import { z } from "zod";
+//#region src/schema/session.d.ts
+/** Validates a stable Factory interaction identifier distinct from provider sessions. */
+declare const agentSessionIdSchema: z.ZodType<`ses_${string}`, string>;
+/** Stable Factory interaction identifier independent of provider session IDs. */
+type AgentSessionId = z.infer<typeof agentSessionIdSchema>;
+/** Base object fields used to decode current and legacy session snapshots. */
+declare const agentSessionBaseSchema: z.ZodObject<{
+  schemaVersion: z.ZodLiteral<1>;
+  id: z.ZodType<`ses_${string}`, string, z.core.$ZodTypeInternals<`ses_${string}`, string>>;
+  owner: z.ZodString;
+  agent: z.ZodString;
+  repositoryId: z.ZodOptional<z.ZodType<`repo_${string}`, string, z.core.$ZodTypeInternals<`repo_${string}`, string>>>;
+  route: z.ZodOptional<z.core.$ZodBranded<z.ZodObject<{
+    id: z.ZodString;
+    version: z.ZodNumber;
+  }, z.core.$strict>, "AgentRouteBinding", "out">>;
+  message: z.ZodString;
+  model: z.ZodOptional<z.ZodString>;
+  attachments: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+    id: z.ZodType<`img_${string}`, string, z.core.$ZodTypeInternals<`img_${string}`, string>>;
+    filename: z.ZodString;
+    mediaType: z.ZodEnum<{
+      "image/png": "image/png";
+      "image/jpeg": "image/jpeg";
+      "image/webp": "image/webp";
+    }>;
+    size: z.ZodNumber;
+  }, z.core.$strict>>>>;
+  changeId: z.ZodOptional<z.ZodType<`chg_${string}`, string, z.core.$ZodTypeInternals<`chg_${string}`, string>>>;
+  taskId: z.ZodOptional<z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>>;
+  attached: z.ZodOptional<z.ZodBoolean>;
+  continuations: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
+    operationId: z.ZodString;
+    taskId: z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>;
+    parentTaskId: z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>;
+    agent: z.ZodString;
+    message: z.ZodString;
+    attachments: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+      id: z.ZodType<`img_${string}`, string, z.core.$ZodTypeInternals<`img_${string}`, string>>;
+      filename: z.ZodString;
+      mediaType: z.ZodEnum<{
+        "image/png": "image/png";
+        "image/jpeg": "image/jpeg";
+        "image/webp": "image/webp";
+      }>;
+      size: z.ZodNumber;
+    }, z.core.$strict>>>>;
+    contextAttachments: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+      id: z.ZodType<`img_${string}`, string, z.core.$ZodTypeInternals<`img_${string}`, string>>;
+      filename: z.ZodString;
+      mediaType: z.ZodEnum<{
+        "image/png": "image/png";
+        "image/jpeg": "image/jpeg";
+        "image/webp": "image/webp";
+      }>;
+      size: z.ZodNumber;
+    }, z.core.$strict>>>>;
+    context: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodISODateTime;
+  }, z.core.$strict>>>>>;
+  execution: z.ZodOptional<z.ZodObject<{
+    provider: z.ZodString;
+    sessionId: z.ZodString;
+    environmentId: z.ZodOptional<z.ZodString>;
+    harness: z.ZodOptional<z.ZodString>;
+    traceId: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>>;
+  external: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
+    replyTo: z.ZodObject<{
+      channel: z.ZodString;
+      address: z.ZodString;
+    }, z.core.$strict>;
+    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>>>>;
+    url: z.ZodOptional<z.ZodURL>;
+  }, z.core.$strict>>>;
+  notifications: z.ZodDefault<z.ZodReadonly<z.ZodArray<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>>>>;
+  createdAt: z.ZodISODateTime;
+}, z.core.$strict>;
+type AgentSessionBase = Readonly<z.infer<typeof agentSessionBaseSchema>>;
+type BindingKeys = "taskId" | "execution" | "external" | "route" | "continuations";
+/** Durable session bound to workflow-owned Task work. */
+type TaskAgentSession = Readonly<Omit<AgentSessionBase, BindingKeys> & {
+  taskId: NonNullable<AgentSessionBase["taskId"]>;
+  execution?: never;
+  external?: never;
+  route?: AgentSessionBase["route"];
+  continuations?: AgentSessionBase["continuations"];
+}>;
+/** Durable internal conversation whose provider execution is stored directly. */
+type DirectAgentSession = Readonly<Omit<AgentSessionBase, BindingKeys> & {
+  taskId?: never;
+  execution?: AgentSessionBase["execution"];
+  external?: never;
+  route?: AgentSessionBase["route"];
+  continuations?: AgentSessionBase["continuations"];
+}>;
+/** Durable external conversation with a required direct provider execution. */
+type ExternalAgentSession = Readonly<Omit<AgentSessionBase, BindingKeys> & {
+  taskId?: never;
+  execution: NonNullable<AgentSessionBase["execution"]>;
+  external: NonNullable<AgentSessionBase["external"]>;
+  route?: never;
+  continuations?: never;
+}>;
+/** Durable interaction whose binding fields identify task, direct, or external ownership. */
+type AgentSession = TaskAgentSession | DirectAgentSession | ExternalAgentSession;
+/** Validates a persisted session and rejects contradictory task, execution, and external bindings. */
+declare const agentSessionSchema: z.ZodType<AgentSession>;
+//#endregion
+export { AgentSession, AgentSessionId, DirectAgentSession, ExternalAgentSession, TaskAgentSession, agentSessionBaseSchema, agentSessionIdSchema, agentSessionSchema };
+//# sourceMappingURL=session.d.mts.map

package/dist/schema/session.mjs

@@ -0,0 +1,54 @@
+import { changeIdSchema, repositoryIdSchema, repositoryIdsSchema, taskIdSchema } from "./id.mjs";
+import { isoDateTimeSchema, replyToSchema, schemaVersionSchema } from "./common.mjs";
+import { agentRouteBindingSchema } from "./agent-route.mjs";
+import { executionReferenceSchema } from "./task.mjs";
+import { hasMessageContent, imageAttachmentsSchema } from "../image-input.mjs";
+import { communicationEventSchema } from "./communication.mjs";
+import { z } from "zod";
+//#region src/schema/session.ts
+/** Validates a stable Factory interaction identifier distinct from provider sessions. */
+const agentSessionIdSchema = z.string().regex(/^ses_[a-z0-9]{6,64}$/u, "Expected ses_ followed by 6 to 64 lowercase letters or digits").describe("Stable Factory interaction ID; independent of provider session IDs.");
+/** Validates the initial human request retained by a Factory session. */
+const agentSessionMessageSchema = z.string().max(16e3).describe("Initial request, retained for idempotent admission and recovery.");
+const continuationSchema = z.strictObject({
+	operationId: z.string().min(1).max(200).describe("Idempotency key for this follow-up."),
+	taskId: taskIdSchema.describe("Budgeted investigation answering this follow-up."),
+	parentTaskId: taskIdSchema.describe("Earlier work being discussed."),
+	agent: z.string().min(1).describe("Conversation agent handling this follow-up."),
+	message: z.string().max(16e3).describe("Operator's follow-up request."),
+	attachments: imageAttachmentsSchema.optional().describe("Images accompanying this follow-up."),
+	contextAttachments: imageAttachmentsSchema.optional().describe("Earlier images selected with the cached conversation context."),
+	context: z.string().max(8e4).optional().describe("Bounded conversation context captured before launch and retained for recovery."),
+	createdAt: isoDateTimeSchema
+}).refine(hasMessageContent, "Enter a message or attach an image").readonly();
+const externalConversationSchema = z.strictObject({
+	replyTo: replyToSchema.describe("Original external conversation destination; never rewritten by the console."),
+	repositoryIds: repositoryIdsSchema.describe("Repositories authorized for this external conversation."),
+	url: z.url({ protocol: /^https$/u }).optional().describe("HTTPS link to the original conversation.")
+}).readonly();
+/** Base object fields used to decode current and legacy session snapshots. */
+const agentSessionBaseSchema = z.strictObject({
+	schemaVersion: schemaVersionSchema,
+	id: agentSessionIdSchema,
+	owner: z.string().min(1).describe("Authenticated principal owning this interaction."),
+	agent: z.string().regex(/^[a-z][a-z0-9-]{0,31}$/u).describe("Selected application agent."),
+	repositoryId: repositoryIdSchema.optional().describe("Configured repository selected for this interaction."),
+	route: agentRouteBindingSchema.optional().describe("Exact specialist route selected when this session was admitted."),
+	message: agentSessionMessageSchema,
+	model: z.string().trim().min(1).max(200).optional().describe("Opaque model selected at admission; unchanged by later repository defaults."),
+	attachments: imageAttachmentsSchema.optional().describe("Images accompanying the initial request."),
+	changeId: changeIdSchema.optional().describe("Existing change selected for this work."),
+	taskId: taskIdSchema.optional().describe("Workflow-owned task and authoritative execution binding."),
+	attached: z.boolean().optional().describe("Operator view of existing work that preserves its original origin and reply destination."),
+	continuations: z.array(continuationSchema).readonly().optional().describe("Ordered immutable follow-up intents, each with separate work and usage."),
+	execution: executionReferenceSchema.optional().describe("Provider reference for taskless conversations only."),
+	external: externalConversationSchema.optional().describe("Read-only projection of an externally admitted taskless conversation."),
+	notifications: z.array(communicationEventSchema).readonly().default([]).describe("Durable connector deliveries, deduplicated by eventId."),
+	createdAt: isoDateTimeSchema
+});
+/** Validates a persisted session and rejects contradictory task, execution, and external bindings. */
+const agentSessionSchema = agentSessionBaseSchema.refine(hasMessageContent, "Enter a message or attach an image").refine((session) => session.taskId === void 0 || session.execution === void 0, "A session binds either a task or a conversation execution").refine((session) => session.external === void 0 || session.execution !== void 0 && session.taskId === void 0 && session.continuations === void 0 && session.route === void 0, "An external conversation requires an execution and cannot bind a Task, route, or continuations");
+//#endregion
+export { agentSessionBaseSchema, agentSessionIdSchema, agentSessionMessageSchema, agentSessionSchema };
+
+//# sourceMappingURL=session.mjs.map

package/dist/schema/session.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.mjs","names":[],"sources":["../../src/schema/session.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { hasMessageContent, imageAttachmentsSchema } from \"../image-input\";\nimport { communicationEventSchema } from \"./communication\";\nimport { isoDateTimeSchema, replyToSchema, schemaVersionSchema } from \"./common\";\nimport { changeIdSchema, repositoryIdSchema, repositoryIdsSchema, taskIdSchema } from \"./id\";\nimport { agentRouteBindingSchema } from \"./agent-route\";\nimport { executionReferenceSchema } from \"./task\";\n\n/** Validates a stable Factory interaction identifier distinct from provider sessions. */\nexport const agentSessionIdSchema = z\n  .string()\n  .regex(/^ses_[a-z0-9]{6,64}$/u, \"Expected ses_ followed by 6 to 64 lowercase letters or digits\")\n  .describe(\"Stable Factory interaction ID; independent of provider session IDs.\") as z.ZodType<\n  `ses_${string}`,\n  string\n>;\n/** Stable Factory interaction identifier independent of provider session IDs. */\nexport type AgentSessionId = z.infer<typeof agentSessionIdSchema>;\n\n/** Validates the initial human request retained by a Factory session. */\nexport const agentSessionMessageSchema = z\n  .string()\n  .max(16000)\n  .describe(\"Initial request, retained for idempotent admission and recovery.\");\n\nconst continuationSchema = z\n  .strictObject({\n    operationId: z.string().min(1).max(200).describe(\"Idempotency key for this follow-up.\"),\n    taskId: taskIdSchema.describe(\"Budgeted investigation answering this follow-up.\"),\n    parentTaskId: taskIdSchema.describe(\"Earlier work being discussed.\"),\n    agent: z.string().min(1).describe(\"Conversation agent handling this follow-up.\"),\n    message: z.string().max(16000).describe(\"Operator's follow-up request.\"),\n    attachments: imageAttachmentsSchema.optional().describe(\"Images accompanying this follow-up.\"),\n    contextAttachments: imageAttachmentsSchema\n      .optional()\n      .describe(\"Earlier images selected with the cached conversation context.\"),\n    context: z\n      .string()\n      .max(80000)\n      .optional()\n      .describe(\"Bounded conversation context captured before launch and retained for recovery.\"),\n    createdAt: isoDateTimeSchema,\n  })\n  .refine(hasMessageContent, \"Enter a message or attach an image\")\n  .readonly();\n\nconst externalConversationSchema = z\n  .strictObject({\n    replyTo: replyToSchema.describe(\n      \"Original external conversation destination; never rewritten by the console.\",\n    ),\n    repositoryIds: repositoryIdsSchema.describe(\n      \"Repositories authorized for this external conversation.\",\n    ),\n    url: z\n      .url({ protocol: /^https$/u })\n      .optional()\n      .describe(\"HTTPS link to the original conversation.\"),\n  })\n  .readonly();\n\n/** Base object fields used to decode current and legacy session snapshots. */\nexport const agentSessionBaseSchema = z.strictObject({\n  schemaVersion: schemaVersionSchema,\n  id: agentSessionIdSchema,\n  owner: z.string().min(1).describe(\"Authenticated principal owning this interaction.\"),\n  agent: z\n    .string()\n    .regex(/^[a-z][a-z0-9-]{0,31}$/u)\n    .describe(\"Selected application agent.\"),\n  repositoryId: repositoryIdSchema\n    .optional()\n    .describe(\"Configured repository selected for this interaction.\"),\n  route: agentRouteBindingSchema\n    .optional()\n    .describe(\"Exact specialist route selected when this session was admitted.\"),\n  message: agentSessionMessageSchema,\n  model: z\n    .string()\n    .trim()\n    .min(1)\n    .max(200)\n    .optional()\n    .describe(\"Opaque model selected at admission; unchanged by later repository defaults.\"),\n  attachments: imageAttachmentsSchema\n    .optional()\n    .describe(\"Images accompanying the initial request.\"),\n  changeId: changeIdSchema.optional().describe(\"Existing change selected for this work.\"),\n  taskId: taskIdSchema\n    .optional()\n    .describe(\"Workflow-owned task and authoritative execution binding.\"),\n  attached: z\n    .boolean()\n    .optional()\n    .describe(\n      \"Operator view of existing work that preserves its original origin and reply destination.\",\n    ),\n  continuations: z\n    .array(continuationSchema)\n    .readonly()\n    .optional()\n    .describe(\"Ordered immutable follow-up intents, each with separate work and usage.\"),\n  execution: executionReferenceSchema\n    .optional()\n    .describe(\"Provider reference for taskless conversations only.\"),\n  external: externalConversationSchema\n    .optional()\n    .describe(\"Read-only projection of an externally admitted taskless conversation.\"),\n  notifications: z\n    .array(communicationEventSchema)\n    .readonly()\n    .default([])\n    .describe(\"Durable connector deliveries, deduplicated by eventId.\"),\n  createdAt: isoDateTimeSchema,\n});\n\ntype AgentSessionBase = Readonly<z.infer<typeof agentSessionBaseSchema>>;\ntype BindingKeys = \"taskId\" | \"execution\" | \"external\" | \"route\" | \"continuations\";\n\n/** Durable session bound to workflow-owned Task work. */\nexport type TaskAgentSession = Readonly<\n  Omit<AgentSessionBase, BindingKeys> & {\n    taskId: NonNullable<AgentSessionBase[\"taskId\"]>;\n    execution?: never;\n    external?: never;\n    route?: AgentSessionBase[\"route\"];\n    continuations?: AgentSessionBase[\"continuations\"];\n  }\n>;\n\n/** Durable internal conversation whose provider execution is stored directly. */\nexport type DirectAgentSession = Readonly<\n  Omit<AgentSessionBase, BindingKeys> & {\n    taskId?: never;\n    execution?: AgentSessionBase[\"execution\"];\n    external?: never;\n    route?: AgentSessionBase[\"route\"];\n    continuations?: AgentSessionBase[\"continuations\"];\n  }\n>;\n\n/** Durable external conversation with a required direct provider execution. */\nexport type ExternalAgentSession = Readonly<\n  Omit<AgentSessionBase, BindingKeys> & {\n    taskId?: never;\n    execution: NonNullable<AgentSessionBase[\"execution\"]>;\n    external: NonNullable<AgentSessionBase[\"external\"]>;\n    route?: never;\n    continuations?: never;\n  }\n>;\n\n/** Durable interaction whose binding fields identify task, direct, or external ownership. */\nexport type AgentSession = TaskAgentSession | DirectAgentSession | ExternalAgentSession;\n\n/** Validates a persisted session and rejects contradictory task, execution, and external bindings. */\nexport const agentSessionSchema = agentSessionBaseSchema\n  .refine(hasMessageContent, \"Enter a message or attach an image\")\n  .refine(\n    (session) => session.taskId === undefined || session.execution === undefined,\n    \"A session binds either a task or a conversation execution\",\n  )\n  .refine(\n    (session) =>\n      session.external === undefined ||\n      (session.execution !== undefined &&\n        session.taskId === undefined &&\n        session.continuations === undefined &&\n        session.route === undefined),\n    \"An external conversation requires an execution and cannot bind a Task, route, or continuations\",\n  ) as z.ZodType<AgentSession>;\n"],"mappings":";;;;;;;;;AASA,MAAa,uBAAuB,EACjC,OAAO,CAAC,CACR,MAAM,yBAAyB,+DAA+D,CAAC,CAC/F,SAAS,qEAAqE;;AAQjF,MAAa,4BAA4B,EACtC,OAAO,CAAC,CACR,IAAI,IAAK,CAAC,CACV,SAAS,kEAAkE;AAE9E,MAAM,qBAAqB,EACxB,aAAa;CACZ,aAAa,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,SAAS,qCAAqC;CACtF,QAAQ,aAAa,SAAS,kDAAkD;CAChF,cAAc,aAAa,SAAS,+BAA+B;CACnE,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,6CAA6C;CAC/E,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,IAAK,CAAC,CAAC,SAAS,+BAA+B;CACvE,aAAa,uBAAuB,SAAS,CAAC,CAAC,SAAS,qCAAqC;CAC7F,oBAAoB,uBACjB,SAAS,CAAC,CACV,SAAS,+DAA+D;CAC3E,SAAS,EACN,OAAO,CAAC,CACR,IAAI,GAAK,CAAC,CACV,SAAS,CAAC,CACV,SAAS,gFAAgF;CAC5F,WAAW;AACb,CAAC,CAAC,CACD,OAAO,mBAAmB,oCAAoC,CAAC,CAC/D,SAAS;AAEZ,MAAM,6BAA6B,EAChC,aAAa;CACZ,SAAS,cAAc,SACrB,6EACF;CACA,eAAe,oBAAoB,SACjC,yDACF;CACA,KAAK,EACF,IAAI,EAAE,UAAU,WAAW,CAAC,CAAC,CAC7B,SAAS,CAAC,CACV,SAAS,0CAA0C;AACxD,CAAC,CAAC,CACD,SAAS;;AAGZ,MAAa,yBAAyB,EAAE,aAAa;CACnD,eAAe;CACf,IAAI;CACJ,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,kDAAkD;CACpF,OAAO,EACJ,OAAO,CAAC,CACR,MAAM,yBAAyB,CAAC,CAChC,SAAS,6BAA6B;CACzC,cAAc,mBACX,SAAS,CAAC,CACV,SAAS,sDAAsD;CAClE,OAAO,wBACJ,SAAS,CAAC,CACV,SAAS,iEAAiE;CAC7E,SAAS;CACT,OAAO,EACJ,OAAO,CAAC,CACR,KAAK,CAAC,CACN,IAAI,CAAC,CAAC,CACN,IAAI,GAAG,CAAC,CACR,SAAS,CAAC,CACV,SAAS,6EAA6E;CACzF,aAAa,uBACV,SAAS,CAAC,CACV,SAAS,0CAA0C;CACtD,UAAU,eAAe,SAAS,CAAC,CAAC,SAAS,yCAAyC;CACtF,QAAQ,aACL,SAAS,CAAC,CACV,SAAS,0DAA0D;CACtE,UAAU,EACP,QAAQ,CAAC,CACT,SAAS,CAAC,CACV,SACC,0FACF;CACF,eAAe,EACZ,MAAM,kBAAkB,CAAC,CACzB,SAAS,CAAC,CACV,SAAS,CAAC,CACV,SAAS,yEAAyE;CACrF,WAAW,yBACR,SAAS,CAAC,CACV,SAAS,qDAAqD;CACjE,UAAU,2BACP,SAAS,CAAC,CACV,SAAS,uEAAuE;CACnF,eAAe,EACZ,MAAM,wBAAwB,CAAC,CAC/B,SAAS,CAAC,CACV,QAAQ,CAAC,CAAC,CAAC,CACX,SAAS,wDAAwD;CACpE,WAAW;AACb,CAAC;;AA0CD,MAAa,qBAAqB,uBAC/B,OAAO,mBAAmB,oCAAoC,CAAC,CAC/D,QACE,YAAY,QAAQ,WAAW,KAAA,KAAa,QAAQ,cAAc,KAAA,GACnE,2DACF,CAAC,CACA,QACE,YACC,QAAQ,aAAa,KAAA,KACpB,QAAQ,cAAc,KAAA,KACrB,QAAQ,WAAW,KAAA,KACnB,QAAQ,kBAAkB,KAAA,KAC1B,QAAQ,UAAU,KAAA,GACtB,gGACF"}

package/dist/schema/signal.d.mts

@@ -0,0 +1,105 @@
+import { z } from "zod";
+//#region src/schema/signal.d.ts
+/** Sources used by the standard connectors. Any vocabulary value is valid. */
+declare const standardSignalSources: readonly ["github_issue", "github_pr", "github_pr_comment", "slack", "human", "github_ci_failure", "vercel_deploy_failure", "security_scan", "investigation", "api"];
+/** Standard Signal sources with support for caller-defined connector values. */
+type SignalSource = (typeof standardSignalSources)[number] | (string & Record<never, never>);
+/** Validates the open vocabulary naming what produced an inbound Signal. */
+declare const signalSourceSchema: z.ZodType<SignalSource>;
+/** Validates the one-time triage decision recorded for a Signal. */
+declare const signalOutcomeSchema: z.ZodEnum<{
+  pending: "pending";
+  accepted: "accepted";
+  duplicate: "duplicate";
+  unactionable: "unactionable";
+  low_confidence: "low_confidence";
+  ignored: "ignored";
+}>;
+/** Validates the latest durable Foreman triage attempt. */
+declare const signalTriageSchema: z.ZodObject<{
+  attempt: z.ZodNumber;
+  state: z.ZodEnum<{
+    running: "running";
+    blocked: "blocked";
+    uncertain: "uncertain";
+  }>;
+  by: z.ZodString;
+  startedAt: z.ZodISODateTime;
+  updatedAt: z.ZodISODateTime;
+  sessionId: z.ZodOptional<z.ZodString>;
+  failure: z.ZodOptional<z.ZodEnum<{
+    cancelled: "cancelled";
+    billing_verification_required: "billing_verification_required";
+    provider_failed: "provider_failed";
+    no_decision: "no_decision";
+    launch_unconfirmed: "launch_unconfirmed";
+  }>>;
+}, z.core.$strict>;
+/** Latest durable pre-task triage attempt. */
+type SignalTriage = z.infer<typeof signalTriageSchema>;
+/** Validates a persisted, normalized, and still-untrusted inbound Signal. */
+declare const signalRecordSchema: z.ZodObject<{
+  schemaVersion: z.ZodLiteral<1>;
+  id: z.ZodType<`sig_${string}`, string, z.core.$ZodTypeInternals<`sig_${string}`, string>>;
+  repositoryId: z.ZodType<`repo_${string}`, string, z.core.$ZodTypeInternals<`repo_${string}`, string>>;
+  source: z.ZodType<SignalSource, unknown, z.core.$ZodTypeInternals<SignalSource, unknown>>;
+  deliveryId: z.ZodString;
+  replyTo: z.ZodObject<{
+    channel: z.ZodString;
+    address: z.ZodString;
+  }, z.core.$strict>;
+  payload: z.ZodUnknown;
+  receivedAt: z.ZodISODateTime;
+  outcome: z.ZodEnum<{
+    pending: "pending";
+    accepted: "accepted";
+    duplicate: "duplicate";
+    unactionable: "unactionable";
+    low_confidence: "low_confidence";
+    ignored: "ignored";
+  }>;
+  triage: z.ZodOptional<z.ZodObject<{
+    attempt: z.ZodNumber;
+    state: z.ZodEnum<{
+      running: "running";
+      blocked: "blocked";
+      uncertain: "uncertain";
+    }>;
+    by: z.ZodString;
+    startedAt: z.ZodISODateTime;
+    updatedAt: z.ZodISODateTime;
+    sessionId: z.ZodOptional<z.ZodString>;
+    failure: z.ZodOptional<z.ZodEnum<{
+      cancelled: "cancelled";
+      billing_verification_required: "billing_verification_required";
+      provider_failed: "provider_failed";
+      no_decision: "no_decision";
+      launch_unconfirmed: "launch_unconfirmed";
+    }>>;
+  }, z.core.$strict>>;
+  detail: z.ZodOptional<z.ZodString>;
+  reason: z.ZodOptional<z.ZodString>;
+  decidedAt: z.ZodOptional<z.ZodISODateTime>;
+}, z.core.$strict>;
+/** Triage disposition that determines whether a Signal starts work. */
+type SignalOutcome = z.infer<typeof signalOutcomeSchema>;
+type SignalRecord = z.infer<typeof signalRecordSchema>;
+type SignalDecisionFields = "outcome" | "decidedAt";
+type SchemaWithOutput<Schema extends z.ZodType, Output> = Omit<Schema, keyof z.ZodType> & z.ZodType<Output, z.input<Schema>>;
+/** Persisted normalized input that has not received a triage decision. */
+type PendingSignal = Omit<SignalRecord, SignalDecisionFields> & {
+  outcome: "pending";
+  decidedAt?: never;
+};
+/** Persisted normalized input carrying its completed triage decision time. */
+type DecidedSignal = Omit<SignalRecord, SignalDecisionFields> & {
+  outcome: Exclude<SignalOutcome, "pending">;
+  decidedAt: string;
+};
+/** Persisted normalized input awaiting or carrying a workflow triage decision. */
+type Signal = PendingSignal | DecidedSignal;
+/** Validates a persisted, normalized, and still-untrusted inbound Signal. */
+declare const signalSchema: SchemaWithOutput<typeof signalRecordSchema, Signal>;
+//#endregion
+export { DecidedSignal, PendingSignal, Signal, SignalOutcome, SignalSource, SignalTriage, signalOutcomeSchema, signalSchema, signalSourceSchema, signalTriageSchema, standardSignalSources };
+//# sourceMappingURL=signal.d.mts.map

package/dist/schema/signal.mjs

@@ -0,0 +1,81 @@
+import { repositoryIdSchema, signalIdSchema } from "./id.mjs";
+import { isoDateTimeSchema, replyToSchema, schemaVersionSchema, vocabularySchema } from "./common.mjs";
+import { z } from "zod";
+//#region src/schema/signal.ts
+/** Sources used by the standard connectors. Any vocabulary value is valid. */
+const standardSignalSources = [
+	"github_issue",
+	"github_pr",
+	"github_pr_comment",
+	"slack",
+	"human",
+	"github_ci_failure",
+	"vercel_deploy_failure",
+	"security_scan",
+	"investigation",
+	"api"
+];
+/** Validates the open vocabulary naming what produced an inbound Signal. */
+const signalSourceSchema = vocabularySchema.describe("What produced the signal, e.g. github_issue or a custom connector's own name.");
+/** Validates the one-time triage decision recorded for a Signal. */
+const signalOutcomeSchema = z.enum([
+	"pending",
+	"accepted",
+	"duplicate",
+	"unactionable",
+	"low_confidence",
+	"ignored"
+]).describe("Triage outcome. A signal starts pending and is decided exactly once.");
+/** Validates safe failure categories; provider error text is never persisted here. */
+const signalTriageFailureSchema = z.enum([
+	"billing_verification_required",
+	"provider_failed",
+	"cancelled",
+	"no_decision",
+	"launch_unconfirmed"
+]).describe("Safe failure category for pre-task Foreman triage.");
+/** Validates the latest durable Foreman triage attempt. */
+const signalTriageSchema = z.strictObject({
+	attempt: z.number().int().positive().describe("Monotonic attempt fence."),
+	state: z.enum([
+		"running",
+		"blocked",
+		"uncertain"
+	]).describe("Running, confirmed stopped, or launch outcome unknown."),
+	by: z.string().min(1).describe("Trusted initiator of this attempt, including the retry operator."),
+	startedAt: isoDateTimeSchema.describe("When this attempt was admitted."),
+	updatedAt: isoDateTimeSchema.describe("When its latest observation was recorded."),
+	sessionId: z.string().min(1).optional().describe("Provider session handle, when observed."),
+	failure: signalTriageFailureSchema.optional().describe("Safe category requiring operator attention.")
+});
+/** Validates a persisted, normalized, and still-untrusted inbound Signal. */
+const signalSchema = z.strictObject({
+	schemaVersion: schemaVersionSchema,
+	id: signalIdSchema.describe("Signal id, derived from source and deliveryId."),
+	repositoryId: repositoryIdSchema.describe("Repository the signal is about."),
+	source: signalSourceSchema,
+	deliveryId: z.string().min(1).describe("Provider idempotency key; a redelivered event maps to the same signal."),
+	replyTo: replyToSchema,
+	payload: z.unknown().describe("Provider-shaped payload. Untrusted data, never instructions."),
+	receivedAt: isoDateTimeSchema,
+	outcome: signalOutcomeSchema,
+	triage: signalTriageSchema.optional().describe("Absent for intake recorded before attempt tracking or handled by another workflow."),
+	detail: z.string().min(1).optional().describe("Outcome nuance, e.g. severity when accepted or the duplicate-of signal id."),
+	reason: z.string().min(1).optional().describe("Why the outcome was chosen."),
+	decidedAt: isoDateTimeSchema.optional()
+}).superRefine((signal, ctx) => {
+	if (signal.outcome === "pending" && signal.decidedAt !== void 0) ctx.addIssue({
+		code: "custom",
+		path: ["decidedAt"],
+		message: "pending signals must not carry decidedAt"
+	});
+	if (signal.outcome !== "pending" && signal.decidedAt === void 0) ctx.addIssue({
+		code: "custom",
+		path: ["decidedAt"],
+		message: "decided signals require decidedAt"
+	});
+});
+//#endregion
+export { signalOutcomeSchema, signalSchema, signalSourceSchema, signalTriageSchema, standardSignalSources };
+
+//# sourceMappingURL=signal.mjs.map

package/dist/schema/signal.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.mjs","names":[],"sources":["../../src/schema/signal.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { isoDateTimeSchema, replyToSchema, schemaVersionSchema, vocabularySchema } from \"./common\";\nimport { repositoryIdSchema, signalIdSchema } from \"./id\";\n\n/** Sources used by the standard connectors. Any vocabulary value is valid. */\nexport const standardSignalSources = [\n  \"github_issue\",\n  \"github_pr\",\n  \"github_pr_comment\",\n  \"slack\",\n  \"human\",\n  \"github_ci_failure\",\n  \"vercel_deploy_failure\",\n  \"security_scan\",\n  \"investigation\",\n  \"api\",\n] as const;\n\n/** Standard Signal sources with support for caller-defined connector values. */\nexport type SignalSource = (typeof standardSignalSources)[number] | (string & Record<never, never>);\n\n/** Validates the open vocabulary naming what produced an inbound Signal. */\nexport const signalSourceSchema = vocabularySchema.describe(\n  \"What produced the signal, e.g. github_issue or a custom connector's own name.\",\n) as z.ZodType<SignalSource>;\n\n/** Validates the one-time triage decision recorded for a Signal. */\nexport const signalOutcomeSchema = z\n  .enum([\"pending\", \"accepted\", \"duplicate\", \"unactionable\", \"low_confidence\", \"ignored\"])\n  .describe(\"Triage outcome. A signal starts pending and is decided exactly once.\");\n\n/** Validates safe failure categories; provider error text is never persisted here. */\nconst signalTriageFailureSchema = z\n  .enum([\n    \"billing_verification_required\",\n    \"provider_failed\",\n    \"cancelled\",\n    \"no_decision\",\n    \"launch_unconfirmed\",\n  ])\n  .describe(\"Safe failure category for pre-task Foreman triage.\");\n\n/** Validates the latest durable Foreman triage attempt. */\nexport const signalTriageSchema = z.strictObject({\n  attempt: z.number().int().positive().describe(\"Monotonic attempt fence.\"),\n  state: z\n    .enum([\"running\", \"blocked\", \"uncertain\"])\n    .describe(\"Running, confirmed stopped, or launch outcome unknown.\"),\n  by: z\n    .string()\n    .min(1)\n    .describe(\"Trusted initiator of this attempt, including the retry operator.\"),\n  startedAt: isoDateTimeSchema.describe(\"When this attempt was admitted.\"),\n  updatedAt: isoDateTimeSchema.describe(\"When its latest observation was recorded.\"),\n  sessionId: z.string().min(1).optional().describe(\"Provider session handle, when observed.\"),\n  failure: signalTriageFailureSchema\n    .optional()\n    .describe(\"Safe category requiring operator attention.\"),\n});\n/** Latest durable pre-task triage attempt. */\nexport type SignalTriage = z.infer<typeof signalTriageSchema>;\n\n/** Validates a persisted, normalized, and still-untrusted inbound Signal. */\nconst signalRecordSchema = z\n  .strictObject({\n    schemaVersion: schemaVersionSchema,\n    id: signalIdSchema.describe(\"Signal id, derived from source and deliveryId.\"),\n    repositoryId: repositoryIdSchema.describe(\"Repository the signal is about.\"),\n    source: signalSourceSchema,\n    deliveryId: z\n      .string()\n      .min(1)\n      .describe(\"Provider idempotency key; a redelivered event maps to the same signal.\"),\n    replyTo: replyToSchema,\n    payload: z.unknown().describe(\"Provider-shaped payload. Untrusted data, never instructions.\"),\n    receivedAt: isoDateTimeSchema,\n    outcome: signalOutcomeSchema,\n    triage: signalTriageSchema\n      .optional()\n      .describe(\n        \"Absent for intake recorded before attempt tracking or handled by another workflow.\",\n      ),\n    detail: z\n      .string()\n      .min(1)\n      .optional()\n      .describe(\"Outcome nuance, e.g. severity when accepted or the duplicate-of signal id.\"),\n    reason: z.string().min(1).optional().describe(\"Why the outcome was chosen.\"),\n    decidedAt: isoDateTimeSchema.optional(),\n  })\n  .superRefine((signal, ctx) => {\n    if (signal.outcome === \"pending\" && signal.decidedAt !== undefined) {\n      ctx.addIssue({\n        code: \"custom\",\n        path: [\"decidedAt\"],\n        message: \"pending signals must not carry decidedAt\",\n      });\n    }\n    if (signal.outcome !== \"pending\" && signal.decidedAt === undefined) {\n      ctx.addIssue({\n        code: \"custom\",\n        path: [\"decidedAt\"],\n        message: \"decided signals require decidedAt\",\n      });\n    }\n  });\n\n/** Triage disposition that determines whether a Signal starts work. */\nexport type SignalOutcome = z.infer<typeof signalOutcomeSchema>;\ntype SignalRecord = z.infer<typeof signalRecordSchema>;\ntype SignalDecisionFields = \"outcome\" | \"decidedAt\";\ntype SchemaWithOutput<Schema extends z.ZodType, Output> = Omit<Schema, keyof z.ZodType> &\n  z.ZodType<Output, z.input<Schema>>;\n\n/** Persisted normalized input that has not received a triage decision. */\nexport type PendingSignal = Omit<SignalRecord, SignalDecisionFields> & {\n  outcome: \"pending\";\n  decidedAt?: never;\n};\n\n/** Persisted normalized input carrying its completed triage decision time. */\nexport type DecidedSignal = Omit<SignalRecord, SignalDecisionFields> & {\n  outcome: Exclude<SignalOutcome, \"pending\">;\n  decidedAt: string;\n};\n\n/** Persisted normalized input awaiting or carrying a workflow triage decision. */\nexport type Signal = PendingSignal | DecidedSignal;\n\n/** Validates a persisted, normalized, and still-untrusted inbound Signal. */\nexport const signalSchema = signalRecordSchema as SchemaWithOutput<\n  typeof signalRecordSchema,\n  Signal\n>;\n"],"mappings":";;;;;AAKA,MAAa,wBAAwB;CACnC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;;AAMA,MAAa,qBAAqB,iBAAiB,SACjD,+EACF;;AAGA,MAAa,sBAAsB,EAChC,KAAK;CAAC;CAAW;CAAY;CAAa;CAAgB;CAAkB;AAAS,CAAC,CAAC,CACvF,SAAS,sEAAsE;;AAGlF,MAAM,4BAA4B,EAC/B,KAAK;CACJ;CACA;CACA;CACA;CACA;AACF,CAAC,CAAC,CACD,SAAS,oDAAoD;;AAGhE,MAAa,qBAAqB,EAAE,aAAa;CAC/C,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,0BAA0B;CACxE,OAAO,EACJ,KAAK;EAAC;EAAW;EAAW;CAAW,CAAC,CAAC,CACzC,SAAS,wDAAwD;CACpE,IAAI,EACD,OAAO,CAAC,CACR,IAAI,CAAC,CAAC,CACN,SAAS,kEAAkE;CAC9E,WAAW,kBAAkB,SAAS,iCAAiC;CACvE,WAAW,kBAAkB,SAAS,2CAA2C;CACjF,WAAW,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,yCAAyC;CAC1F,SAAS,0BACN,SAAS,CAAC,CACV,SAAS,6CAA6C;AAC3D,CAAC;;AAwED,MAAa,eAnEc,EACxB,aAAa;CACZ,eAAe;CACf,IAAI,eAAe,SAAS,gDAAgD;CAC5E,cAAc,mBAAmB,SAAS,iCAAiC;CAC3E,QAAQ;CACR,YAAY,EACT,OAAO,CAAC,CACR,IAAI,CAAC,CAAC,CACN,SAAS,wEAAwE;CACpF,SAAS;CACT,SAAS,EAAE,QAAQ,CAAC,CAAC,SAAS,8DAA8D;CAC5F,YAAY;CACZ,SAAS;CACT,QAAQ,mBACL,SAAS,CAAC,CACV,SACC,oFACF;CACF,QAAQ,EACL,OAAO,CAAC,CACR,IAAI,CAAC,CAAC,CACN,SAAS,CAAC,CACV,SAAS,4EAA4E;CACxF,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,6BAA6B;CAC3E,WAAW,kBAAkB,SAAS;AACxC,CAAC,CAAC,CACD,aAAa,QAAQ,QAAQ;CAC5B,IAAI,OAAO,YAAY,aAAa,OAAO,cAAc,KAAA,GACvD,IAAI,SAAS;EACX,MAAM;EACN,MAAM,CAAC,WAAW;EAClB,SAAS;CACX,CAAC;CAEH,IAAI,OAAO,YAAY,aAAa,OAAO,cAAc,KAAA,GACvD,IAAI,SAAS;EACX,MAAM;EACN,MAAM,CAAC,WAAW;EAClB,SAAS;CACX,CAAC;AAEL,CAyB0B"}

package/dist/schema/slack-pr-notifications.d.mts

@@ -0,0 +1,12 @@
+import { z } from "zod";
+//#region src/schema/slack-pr-notifications.d.ts
+/** Validates the Slack destination and individual mentions for Factory-produced PR announcements. */
+declare const slackPrNotificationsSchema: z.ZodReadonly<z.ZodObject<{
+  channelId: z.ZodString;
+  mentionUserIds: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>>;
+/** Slack destination and individual mentions for Factory-produced PR announcements. */
+type SlackPrNotifications = z.infer<typeof slackPrNotificationsSchema>;
+//#endregion
+export { SlackPrNotifications, slackPrNotificationsSchema };
+//# sourceMappingURL=slack-pr-notifications.d.mts.map

package/dist/schema/slack-pr-notifications.mjs

@@ -0,0 +1,11 @@
+import { z } from "zod";
+//#region src/schema/slack-pr-notifications.ts
+/** Validates the Slack destination and individual mentions for Factory-produced PR announcements. */
+const slackPrNotificationsSchema = z.strictObject({
+	channelId: z.string().regex(/^[CG][A-Z0-9]+$/u).describe("Existing Slack channel for PR announcements."),
+	mentionUserIds: z.array(z.string().regex(/^[UW][A-Z0-9]+$/u)).min(1).max(10).readonly().refine((ids) => new Set(ids).size === ids.length, "Slack mention users must be unique.").describe("Slack users to mention when the factory opens a PR.")
+}).readonly();
+//#endregion
+export { slackPrNotificationsSchema };
+
+//# sourceMappingURL=slack-pr-notifications.mjs.map

package/dist/schema/slack-pr-notifications.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-pr-notifications.mjs","names":[],"sources":["../../src/schema/slack-pr-notifications.ts"],"sourcesContent":["import { z } from \"zod\";\n\n/** Validates the Slack destination and individual mentions for Factory-produced PR announcements. */\nexport const slackPrNotificationsSchema = z\n  .strictObject({\n    channelId: z\n      .string()\n      .regex(/^[CG][A-Z0-9]+$/u)\n      .describe(\"Existing Slack channel for PR announcements.\"),\n    mentionUserIds: z\n      .array(z.string().regex(/^[UW][A-Z0-9]+$/u))\n      .min(1)\n      .max(10)\n      .readonly()\n      .refine((ids) => new Set(ids).size === ids.length, \"Slack mention users must be unique.\")\n      .describe(\"Slack users to mention when the factory opens a PR.\"),\n  })\n  .readonly();\n\n/** Slack destination and individual mentions for Factory-produced PR announcements. */\nexport type SlackPrNotifications = z.infer<typeof slackPrNotificationsSchema>;\n"],"mappings":";;;AAGA,MAAa,6BAA6B,EACvC,aAAa;CACZ,WAAW,EACR,OAAO,CAAC,CACR,MAAM,kBAAkB,CAAC,CACzB,SAAS,8CAA8C;CAC1D,gBAAgB,EACb,MAAM,EAAE,OAAO,CAAC,CAAC,MAAM,kBAAkB,CAAC,CAAC,CAC3C,IAAI,CAAC,CAAC,CACN,IAAI,EAAE,CAAC,CACP,SAAS,CAAC,CACV,QAAQ,QAAQ,IAAI,IAAI,GAAG,CAAC,CAAC,SAAS,IAAI,QAAQ,qCAAqC,CAAC,CACxF,SAAS,qDAAqD;AACnE,CAAC,CAAC,CACD,SAAS"}

package/dist/schema/stored-session.mjs

@@ -0,0 +1,10 @@
+import { agentSessionSchema } from "./session.mjs";
+//#region src/schema/stored-session.ts
+/** Validates ordinary Factory-owned session records, excluding external projections. */
+const storedSessionSchema = agentSessionSchema.refine((session) => session.external === void 0, "External conversations belong only in externalSessions");
+/** Validates read-only descriptors of conversations admitted outside Factory. */
+const externalSessionSchema = agentSessionSchema.refine((session) => session.external !== void 0, "External session records require an external conversation descriptor");
+//#endregion
+export { externalSessionSchema, storedSessionSchema };
+
+//# sourceMappingURL=stored-session.mjs.map

package/dist/schema/stored-session.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"stored-session.mjs","names":[],"sources":["../../src/schema/stored-session.ts"],"sourcesContent":["import { agentSessionSchema } from \"./session\";\n\n/** Validates ordinary Factory-owned session records, excluding external projections. */\nexport const storedSessionSchema = agentSessionSchema.refine(\n  (session) => session.external === undefined,\n  \"External conversations belong only in externalSessions\",\n);\n\n/** Validates read-only descriptors of conversations admitted outside Factory. */\nexport const externalSessionSchema = agentSessionSchema.refine(\n  (session) => session.external !== undefined,\n  \"External session records require an external conversation descriptor\",\n);\n"],"mappings":";;;AAGA,MAAa,sBAAsB,mBAAmB,QACnD,YAAY,QAAQ,aAAa,KAAA,GAClC,wDACF;;AAGA,MAAa,wBAAwB,mBAAmB,QACrD,YAAY,QAAQ,aAAa,KAAA,GAClC,sEACF"}

package/dist/schema/stored-task.mjs

@@ -0,0 +1,20 @@
+import { taskSchema } from "./task.mjs";
+import { z } from "zod";
+//#region src/schema/stored-task.ts
+/**
+* Validates persisted Tasks while narrowly repairing legacy human-action text;
+* all required unified work and graph fields still validate without fallback.
+*/
+const storedTaskSchema = z.preprocess((value) => {
+	if (typeof value !== "object" || value === null || Array.isArray(value) || !("state" in value) || value.state !== "needs_human" || Object.hasOwn(value, "needsHumanAction")) return value;
+	const question = "question" in value ? value.question : void 0;
+	const text = typeof question === "object" && question !== null && "text" in question ? question.text : void 0;
+	return {
+		...value,
+		needsHumanAction: typeof text === "string" && text.trim() !== "" ? text.trim() : "This task entered needs_human before Factory recorded why; check its question and history for context."
+	};
+}, taskSchema);
+//#endregion
+export { storedTaskSchema };
+
+//# sourceMappingURL=stored-task.mjs.map

package/dist/schema/stored-task.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"stored-task.mjs","names":[],"sources":["../../src/schema/stored-task.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { taskSchema } from \"./task\";\n\n/**\n * Validates persisted Tasks while narrowly repairing legacy human-action text;\n * all required unified work and graph fields still validate without fallback.\n */\nexport const storedTaskSchema = z.preprocess((value) => {\n  if (\n    typeof value !== \"object\" ||\n    value === null ||\n    Array.isArray(value) ||\n    !(\"state\" in value) ||\n    value.state !== \"needs_human\" ||\n    Object.hasOwn(value, \"needsHumanAction\")\n  )\n    return value;\n  const question = \"question\" in value ? value.question : undefined;\n  const text =\n    typeof question === \"object\" && question !== null && \"text\" in question\n      ? question.text\n      : undefined;\n  return {\n    ...value,\n    needsHumanAction:\n      typeof text === \"string\" && text.trim() !== \"\"\n        ? text.trim()\n        : \"This task entered needs_human before Factory recorded why; check its question and history for context.\",\n  };\n}, taskSchema);\n"],"mappings":";;;;;;;AAOA,MAAa,mBAAmB,EAAE,YAAY,UAAU;CACtD,IACE,OAAO,UAAU,YACjB,UAAU,QACV,MAAM,QAAQ,KAAK,KACnB,EAAE,WAAW,UACb,MAAM,UAAU,iBAChB,OAAO,OAAO,OAAO,kBAAkB,GAEvC,OAAO;CACT,MAAM,WAAW,cAAc,QAAQ,MAAM,WAAW,KAAA;CACxD,MAAM,OACJ,OAAO,aAAa,YAAY,aAAa,QAAQ,UAAU,WAC3D,SAAS,OACT,KAAA;CACN,OAAO;EACL,GAAG;EACH,kBACE,OAAO,SAAS,YAAY,KAAK,KAAK,MAAM,KACxC,KAAK,KAAK,IACV;CACR;AACF,GAAG,UAAU"}

package/dist/schema/task-effect.d.mts

@@ -0,0 +1,39 @@
+import { z } from "zod";
+//#region src/schema/task-effect.d.ts
+/** Validates the capability namespace and name identifying a Task-scoped effect. */
+declare const taskEffectKeySchema: z.ZodObject<{
+  namespace: z.ZodString;
+  name: z.ZodString;
+}, z.core.$strict>;
+/** Validates an opaque provider resource retained for effect reconciliation. */
+declare const taskEffectReferenceSchema: z.ZodObject<{
+  provider: z.ZodString;
+  resourceId: z.ZodString;
+  subject: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/** Validates durable recovery state for one Task-scoped external effect. */
+declare const taskEffectSchema: z.ZodObject<{
+  schemaVersion: z.ZodLiteral<1>;
+  taskId: z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>;
+  key: z.ZodObject<{
+    namespace: z.ZodString;
+    name: z.ZodString;
+  }, z.core.$strict>;
+  reference: z.ZodOptional<z.ZodObject<{
+    provider: z.ZodString;
+    resourceId: z.ZodString;
+    subject: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>>;
+  resolvedAt: z.ZodOptional<z.ZodISODateTime>;
+  createdAt: z.ZodISODateTime;
+  updatedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+/** Capability-owned namespaced identity of a Task-scoped effect. */
+type TaskEffectKey = z.infer<typeof taskEffectKeySchema>;
+/** Opaque provider resource handle retained for effect reconciliation. */
+type TaskEffectReference = z.infer<typeof taskEffectReferenceSchema>;
+/** Durable, CAS-protected recovery state for one external Task effect. */
+type TaskEffect = z.infer<typeof taskEffectSchema>;
+//#endregion
+export { TaskEffect, TaskEffectKey, TaskEffectReference, taskEffectKeySchema, taskEffectReferenceSchema, taskEffectSchema };
+//# sourceMappingURL=task-effect.d.mts.map

package/dist/schema/task-effect.mjs

@@ -0,0 +1,29 @@
+import { taskIdSchema } from "./id.mjs";
+import { isoDateTimeSchema, schemaVersionSchema, vocabularySchema } from "./common.mjs";
+import { z } from "zod";
+//#region src/schema/task-effect.ts
+/** Validates the capability namespace and name identifying a Task-scoped effect. */
+const taskEffectKeySchema = z.strictObject({
+	namespace: vocabularySchema.describe("Capability that owns this effect, e.g. software."),
+	name: vocabularySchema.describe("Effect name within the owning capability.")
+}).describe("Namespaced identity for one task-scoped external effect.");
+/** Validates an opaque provider resource retained for effect reconciliation. */
+const taskEffectReferenceSchema = z.strictObject({
+	provider: vocabularySchema.describe("External provider that owns the resource."),
+	resourceId: z.string().min(1).max(512).describe("Provider-side resource identity."),
+	subject: z.string().min(1).max(512).optional().describe("Provider-side subject or version the resource applies to.")
+}).describe("Opaque handle for an external resource created by an effect.");
+/** Validates durable recovery state for one Task-scoped external effect. */
+const taskEffectSchema = z.strictObject({
+	schemaVersion: schemaVersionSchema,
+	taskId: taskIdSchema,
+	key: taskEffectKeySchema,
+	reference: taskEffectReferenceSchema.optional(),
+	resolvedAt: isoDateTimeSchema.optional().describe("Write-once stamp showing that this effect needs no further reconciliation."),
+	createdAt: isoDateTimeSchema,
+	updatedAt: isoDateTimeSchema
+}).refine((effect) => effect.reference !== void 0 || effect.resolvedAt !== void 0, { message: "A task effect requires a reference or resolution stamp." });
+//#endregion
+export { taskEffectKeySchema, taskEffectReferenceSchema, taskEffectSchema };
+
+//# sourceMappingURL=task-effect.mjs.map

package/dist/schema/task-effect.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-effect.mjs","names":[],"sources":["../../src/schema/task-effect.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { isoDateTimeSchema, schemaVersionSchema, vocabularySchema } from \"./common\";\nimport { taskIdSchema } from \"./id\";\n\n/** Validates the capability namespace and name identifying a Task-scoped effect. */\nexport const taskEffectKeySchema = z\n  .strictObject({\n    namespace: vocabularySchema.describe(\"Capability that owns this effect, e.g. software.\"),\n    name: vocabularySchema.describe(\"Effect name within the owning capability.\"),\n  })\n  .describe(\"Namespaced identity for one task-scoped external effect.\");\n\n/** Validates an opaque provider resource retained for effect reconciliation. */\nexport const taskEffectReferenceSchema = z\n  .strictObject({\n    provider: vocabularySchema.describe(\"External provider that owns the resource.\"),\n    resourceId: z.string().min(1).max(512).describe(\"Provider-side resource identity.\"),\n    subject: z\n      .string()\n      .min(1)\n      .max(512)\n      .optional()\n      .describe(\"Provider-side subject or version the resource applies to.\"),\n  })\n  .describe(\"Opaque handle for an external resource created by an effect.\");\n\n/** Validates durable recovery state for one Task-scoped external effect. */\nexport const taskEffectSchema = z\n  .strictObject({\n    schemaVersion: schemaVersionSchema,\n    taskId: taskIdSchema,\n    key: taskEffectKeySchema,\n    reference: taskEffectReferenceSchema.optional(),\n    resolvedAt: isoDateTimeSchema\n      .optional()\n      .describe(\"Write-once stamp showing that this effect needs no further reconciliation.\"),\n    createdAt: isoDateTimeSchema,\n    updatedAt: isoDateTimeSchema,\n  })\n  .refine((effect) => effect.reference !== undefined || effect.resolvedAt !== undefined, {\n    message: \"A task effect requires a reference or resolution stamp.\",\n  });\n\n/** Capability-owned namespaced identity of a Task-scoped effect. */\nexport type TaskEffectKey = z.infer<typeof taskEffectKeySchema>;\n/** Opaque provider resource handle retained for effect reconciliation. */\nexport type TaskEffectReference = z.infer<typeof taskEffectReferenceSchema>;\n/** Durable, CAS-protected recovery state for one external Task effect. */\nexport type TaskEffect = z.infer<typeof taskEffectSchema>;\n"],"mappings":";;;;;AAKA,MAAa,sBAAsB,EAChC,aAAa;CACZ,WAAW,iBAAiB,SAAS,kDAAkD;CACvF,MAAM,iBAAiB,SAAS,2CAA2C;AAC7E,CAAC,CAAC,CACD,SAAS,0DAA0D;;AAGtE,MAAa,4BAA4B,EACtC,aAAa;CACZ,UAAU,iBAAiB,SAAS,2CAA2C;CAC/E,YAAY,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,SAAS,kCAAkC;CAClF,SAAS,EACN,OAAO,CAAC,CACR,IAAI,CAAC,CAAC,CACN,IAAI,GAAG,CAAC,CACR,SAAS,CAAC,CACV,SAAS,2DAA2D;AACzE,CAAC,CAAC,CACD,SAAS,8DAA8D;;AAG1E,MAAa,mBAAmB,EAC7B,aAAa;CACZ,eAAe;CACf,QAAQ;CACR,KAAK;CACL,WAAW,0BAA0B,SAAS;CAC9C,YAAY,kBACT,SAAS,CAAC,CACV,SAAS,4EAA4E;CACxF,WAAW;CACX,WAAW;AACb,CAAC,CAAC,CACD,QAAQ,WAAW,OAAO,cAAc,KAAA,KAAa,OAAO,eAAe,KAAA,GAAW,EACrF,SAAS,0DACX,CAAC"}