@vercel/factory 0.0.17 → 0.0.18

package/dist/schema/session-summary.mjs

@@ -0,0 +1,68 @@
+import { taskIdSchema } from "./id.mjs";
+import { executionReferenceSchema, taskSchema } from "./task.mjs";
+import { agentSessionBaseSchema } from "./session.mjs";
+import { z } from "zod";
+//#region src/schema/session-summary.ts
+/** Conversation-wide operator status derived from current work and human-action gates. */
+const conversationStatusSchema = z.enum([
+	"working",
+	"delegated",
+	"verifying",
+	"needs_input",
+	"awaiting_approval",
+	"ready",
+	"failed",
+	"stalled"
+]);
+/** Compact Task fields needed to render a conversation card, without execution inputs or outputs. */
+const sessionTaskSummarySchema = z.object(taskSchema.shape).pick({
+	id: true,
+	kind: true,
+	state: true,
+	rootTaskId: true,
+	parentTaskId: true,
+	repositoryIds: true,
+	replyTo: true,
+	approval: true,
+	attempt: true,
+	changeId: true,
+	createdAt: true,
+	updatedAt: true,
+	needsHumanAction: true,
+	stalledReason: true
+}).strip().extend({ work: z.object({
+	title: z.string().max(256),
+	route: taskSchema.shape.work.shape.route
+}).describe("Display title and exact route; excludes input and output.") });
+/** A conversation card deliberately excludes canonical Task bodies, histories, and transcript content. */
+const conversationSummarySchema = z.object({
+	session: agentSessionBaseSchema.strip().extend({ message: z.string().max(256).describe("Truncated initial request for display.") }).describe("Compact conversation binding; fetch the session for the complete request."),
+	task: sessionTaskSummarySchema.nullable().describe("Selected Task display state."),
+	question: z.object(taskSchema.shape).pick({
+		id: true,
+		updatedAt: true,
+		question: true
+	}).strip().nullable().describe("Current validated workflow question."),
+	execution: executionReferenceSchema.nullable().describe("Current provider execution."),
+	activeAgent: z.string().optional().describe("Current executing agent."),
+	source: z.string().optional().describe("Automatic work origin."),
+	prUrl: z.string().optional().describe("Associated pull request."),
+	attention: z.enum([
+		"question",
+		"failed",
+		"stalled",
+		"review",
+		"conversation"
+	]).optional().describe("Deduplicated conversation attention reason."),
+	status: conversationStatusSchema.optional().describe("Current conversation-wide work and human-action status."),
+	statusRevision: z.string().length(64).optional().describe("Opaque revision that changes when status-relevant conversation work changes."),
+	hasWorkflowFailure: z.boolean().optional().describe("Delegated workflow failure."),
+	canCancel: z.boolean().optional().describe("Whether this conversation has cancellable work."),
+	canFollowUp: z.boolean().optional().describe("Whether follow-up discussion is configured."),
+	dependencyTaskIds: z.array(taskIdSchema).readonly().optional().describe("Current graph dependencies."),
+	relatedTasks: z.array(sessionTaskSummarySchema).readonly().optional().describe("Optional bounded related Task summaries.")
+});
+//#endregion
+export { conversationStatusSchema, conversationSummarySchema, sessionTaskSummarySchema };
+
+//# sourceMappingURL=session-summary.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-summary.mjs","names":[],"sources":["../../src/schema/session-summary.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { agentSessionBaseSchema } from \"./session\";\nimport { taskSchema, executionReferenceSchema } from \"./task\";\nimport { taskIdSchema } from \"./id\";\n\n/** Conversation-wide operator status derived from current work and human-action gates. */\nexport const conversationStatusSchema = z.enum([\n  \"working\",\n  \"delegated\",\n  \"verifying\",\n  \"needs_input\",\n  \"awaiting_approval\",\n  \"ready\",\n  \"failed\",\n  \"stalled\",\n]);\n/** Conversation-wide operator status, independent of provider transcript vocabulary. */\nexport type ConversationStatus = z.infer<typeof conversationStatusSchema>;\n\n/** Compact Task fields needed to render a conversation card, without execution inputs or outputs. */\nexport const sessionTaskSummarySchema = z\n  .object(taskSchema.shape)\n  .pick({\n    id: true,\n    kind: true,\n    state: true,\n    rootTaskId: true,\n    parentTaskId: true,\n    repositoryIds: true,\n    replyTo: true,\n    approval: true,\n    attempt: true,\n    changeId: true,\n    createdAt: true,\n    updatedAt: true,\n    needsHumanAction: true,\n    stalledReason: true,\n  })\n  .strip()\n  .extend({\n    work: z\n      .object({ title: z.string().max(256), route: taskSchema.shape.work.shape.route })\n      .describe(\"Display title and exact route; excludes input and output.\"),\n  });\n/** Compact Task state on an operator conversation card. */\nexport type SessionTaskSummary = z.infer<typeof sessionTaskSummarySchema>;\n\n/** A conversation card deliberately excludes canonical Task bodies, histories, and transcript content. */\nexport const conversationSummarySchema = z.object({\n  session: agentSessionBaseSchema\n    .strip()\n    .extend({\n      message: z.string().max(256).describe(\"Truncated initial request for display.\"),\n    })\n    .describe(\"Compact conversation binding; fetch the session for the complete request.\"),\n  task: sessionTaskSummarySchema.nullable().describe(\"Selected Task display state.\"),\n  question: z\n    .object(taskSchema.shape)\n    .pick({ id: true, updatedAt: true, question: true })\n    .strip()\n    .nullable()\n    .describe(\"Current validated workflow question.\"),\n  execution: executionReferenceSchema.nullable().describe(\"Current provider execution.\"),\n  activeAgent: z.string().optional().describe(\"Current executing agent.\"),\n  source: z.string().optional().describe(\"Automatic work origin.\"),\n  prUrl: z.string().optional().describe(\"Associated pull request.\"),\n  attention: z\n    .enum([\"question\", \"failed\", \"stalled\", \"review\", \"conversation\"])\n    .optional()\n    .describe(\"Deduplicated conversation attention reason.\"),\n  status: conversationStatusSchema\n    .optional()\n    .describe(\"Current conversation-wide work and human-action status.\"),\n  statusRevision: z\n    .string()\n    .length(64)\n    .optional()\n    .describe(\"Opaque revision that changes when status-relevant conversation work changes.\"),\n  hasWorkflowFailure: z.boolean().optional().describe(\"Delegated workflow failure.\"),\n  canCancel: z.boolean().optional().describe(\"Whether this conversation has cancellable work.\"),\n  canFollowUp: z.boolean().optional().describe(\"Whether follow-up discussion is configured.\"),\n  dependencyTaskIds: z\n    .array(taskIdSchema)\n    .readonly()\n    .optional()\n    .describe(\"Current graph dependencies.\"),\n  relatedTasks: z\n    .array(sessionTaskSummarySchema)\n    .readonly()\n    .optional()\n    .describe(\"Optional bounded related Task summaries.\"),\n});\n/** Stored conversation card before request-time operator enrichment. */\nexport type ConversationSummary = z.infer<typeof conversationSummarySchema>;\n"],"mappings":";;;;;;AAMA,MAAa,2BAA2B,EAAE,KAAK;CAC7C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;AAKD,MAAa,2BAA2B,EACrC,OAAO,WAAW,KAAK,CAAC,CACxB,KAAK;CACJ,IAAI;CACJ,MAAM;CACN,OAAO;CACP,YAAY;CACZ,cAAc;CACd,eAAe;CACf,SAAS;CACT,UAAU;CACV,SAAS;CACT,UAAU;CACV,WAAW;CACX,WAAW;CACX,kBAAkB;CAClB,eAAe;AACjB,CAAC,CAAC,CACD,MAAM,CAAC,CACP,OAAO,EACN,MAAM,EACH,OAAO;CAAE,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,GAAG;CAAG,OAAO,WAAW,MAAM,KAAK,MAAM;AAAM,CAAC,CAAC,CAChF,SAAS,2DAA2D,EACzE,CAAC;;AAKH,MAAa,4BAA4B,EAAE,OAAO;CAChD,SAAS,uBACN,MAAM,CAAC,CACP,OAAO,EACN,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,SAAS,wCAAwC,EAChF,CAAC,CAAC,CACD,SAAS,2EAA2E;CACvF,MAAM,yBAAyB,SAAS,CAAC,CAAC,SAAS,8BAA8B;CACjF,UAAU,EACP,OAAO,WAAW,KAAK,CAAC,CACxB,KAAK;EAAE,IAAI;EAAM,WAAW;EAAM,UAAU;CAAK,CAAC,CAAC,CACnD,MAAM,CAAC,CACP,SAAS,CAAC,CACV,SAAS,sCAAsC;CAClD,WAAW,yBAAyB,SAAS,CAAC,CAAC,SAAS,6BAA6B;CACrF,aAAa,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,0BAA0B;CACtE,QAAQ,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,wBAAwB;CAC/D,OAAO,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,0BAA0B;CAChE,WAAW,EACR,KAAK;EAAC;EAAY;EAAU;EAAW;EAAU;CAAc,CAAC,CAAC,CACjE,SAAS,CAAC,CACV,SAAS,6CAA6C;CACzD,QAAQ,yBACL,SAAS,CAAC,CACV,SAAS,yDAAyD;CACrE,gBAAgB,EACb,OAAO,CAAC,CACR,OAAO,EAAE,CAAC,CACV,SAAS,CAAC,CACV,SAAS,8EAA8E;CAC1F,oBAAoB,EAAE,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,6BAA6B;CACjF,WAAW,EAAE,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,iDAAiD;CAC5F,aAAa,EAAE,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,6CAA6C;CAC1F,mBAAmB,EAChB,MAAM,YAAY,CAAC,CACnB,SAAS,CAAC,CACV,SAAS,CAAC,CACV,SAAS,6BAA6B;CACzC,cAAc,EACX,MAAM,wBAAwB,CAAC,CAC/B,SAAS,CAAC,CACV,SAAS,CAAC,CACV,SAAS,0CAA0C;AACxD,CAAC"}

package/dist/schema/session.d.mts

@@ -4,6 +4,38 @@ import { z } from "zod";
 declare const agentSessionIdSchema: z.ZodType<`ses_${string}`, string>;
 /** Stable Factory interaction identifier independent of provider session IDs. */
 type AgentSessionId = z.infer<typeof agentSessionIdSchema>;
+/** Validates one separately stored, idempotent conversation follow-up. */
+declare const sessionContinuationSchema: 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>>;
+/** One durable follow-up intent, including its separately persisted recovery context. */
+type SessionContinuation = z.infer<typeof sessionContinuationSchema>;
 /** Base object fields used to decode current and legacy session snapshots. */
 declare const agentSessionBaseSchema: z.ZodObject<{
   schemaVersion: z.ZodLiteral<1>;
@@ -30,35 +62,7 @@ declare const agentSessionBaseSchema: z.ZodObject<{
   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>>>>>;
+  latestContinuationId: z.ZodOptional<z.ZodString>;
   execution: z.ZodOptional<z.ZodObject<{
     provider: z.ZodString;
     sessionId: z.ZodString;
@@ -74,42 +78,18 @@ declare const agentSessionBaseSchema: z.ZodObject<{
     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>>>>;
+  latestNotificationId: z.ZodOptional<z.ZodString>;
   createdAt: z.ZodISODateTime;
 }, z.core.$strict>;
 type AgentSessionBase = Readonly<z.infer<typeof agentSessionBaseSchema>>;
-type BindingKeys = "taskId" | "execution" | "external" | "route" | "continuations";
+type BindingKeys = "taskId" | "execution" | "external" | "route" | "latestContinuationId";
 /** 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"];
+  latestContinuationId?: AgentSessionBase["latestContinuationId"];
 }>;
 /** Durable internal conversation whose provider execution is stored directly. */
 type DirectAgentSession = Readonly<Omit<AgentSessionBase, BindingKeys> & {
@@ -117,7 +97,7 @@ type DirectAgentSession = Readonly<Omit<AgentSessionBase, BindingKeys> & {
   execution?: AgentSessionBase["execution"];
   external?: never;
   route?: AgentSessionBase["route"];
-  continuations?: AgentSessionBase["continuations"];
+  latestContinuationId?: AgentSessionBase["latestContinuationId"];
 }>;
 /** Durable external conversation with a required direct provider execution. */
 type ExternalAgentSession = Readonly<Omit<AgentSessionBase, BindingKeys> & {
@@ -125,12 +105,12 @@ type ExternalAgentSession = Readonly<Omit<AgentSessionBase, BindingKeys> & {
   execution: NonNullable<AgentSessionBase["execution"]>;
   external: NonNullable<AgentSessionBase["external"]>;
   route?: never;
-  continuations?: never;
+  latestContinuationId?: 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 };
+export { AgentSession, AgentSessionId, DirectAgentSession, ExternalAgentSession, SessionContinuation, TaskAgentSession, agentSessionBaseSchema, agentSessionIdSchema, agentSessionSchema, sessionContinuationSchema };
 //# sourceMappingURL=session.d.mts.map

package/dist/schema/session.mjs

@@ -3,14 +3,14 @@ import { isoDateTimeSchema, replyToSchema, schemaVersionSchema } from "./common.
 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({
+/** Validates one separately stored, idempotent conversation follow-up. */
+const sessionContinuationSchema = 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."),
@@ -40,15 +40,15 @@ const agentSessionBaseSchema = z.strictObject({
 	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."),
+	latestContinuationId: z.string().regex(/^scont_[a-f0-9]{32}$/u).optional().describe("Latest committed follow-up intent; earlier intents are separately paginated."),
 	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."),
+	latestNotificationId: z.string().regex(/^snotice_[a-f0-9]{32}$/u).optional().describe("Latest notification identity; notification bodies are separately paginated."),
 	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");
+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.latestContinuationId === 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 };
+export { agentSessionBaseSchema, agentSessionIdSchema, agentSessionMessageSchema, agentSessionSchema, sessionContinuationSchema };
 
 //# sourceMappingURL=session.mjs.map

package/dist/schema/session.mjs.map

@@ -1 +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"}
+{"version":3,"file":"session.mjs","names":[],"sources":["../../src/schema/session.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { hasMessageContent, imageAttachmentsSchema } from \"../image-input\";\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\n/** Validates one separately stored, idempotent conversation follow-up. */\nexport const sessionContinuationSchema = 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\n/** One durable follow-up intent, including its separately persisted recovery context. */\nexport type SessionContinuation = z.infer<typeof sessionContinuationSchema>;\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  latestContinuationId: z\n    .string()\n    .regex(/^scont_[a-f0-9]{32}$/u)\n    .optional()\n    .describe(\"Latest committed follow-up intent; earlier intents are separately paginated.\"),\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  latestNotificationId: z\n    .string()\n    .regex(/^snotice_[a-f0-9]{32}$/u)\n    .optional()\n    .describe(\"Latest notification identity; notification bodies are separately paginated.\"),\n  createdAt: isoDateTimeSchema,\n});\n\ntype AgentSessionBase = Readonly<z.infer<typeof agentSessionBaseSchema>>;\ntype BindingKeys = \"taskId\" | \"execution\" | \"external\" | \"route\" | \"latestContinuationId\";\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    latestContinuationId?: AgentSessionBase[\"latestContinuationId\"];\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    latestContinuationId?: AgentSessionBase[\"latestContinuationId\"];\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    latestContinuationId?: 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.latestContinuationId === 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":";;;;;;;;AAQA,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;;AAG9E,MAAa,4BAA4B,EACtC,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;AAKZ,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,sBAAsB,EACnB,OAAO,CAAC,CACR,MAAM,uBAAuB,CAAC,CAC9B,SAAS,CAAC,CACV,SAAS,8EAA8E;CAC1F,WAAW,yBACR,SAAS,CAAC,CACV,SAAS,qDAAqD;CACjE,UAAU,2BACP,SAAS,CAAC,CACV,SAAS,uEAAuE;CACnF,sBAAsB,EACnB,OAAO,CAAC,CACR,MAAM,yBAAyB,CAAC,CAChC,SAAS,CAAC,CACV,SAAS,6EAA6E;CACzF,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,yBAAyB,KAAA,KACjC,QAAQ,UAAU,KAAA,GACtB,gGACF"}