@vercel/factory 0.0.13 → 0.0.15

package/dist/api-contracts.mjs

@@ -0,0 +1,118 @@
+import { changeIdSchema, repositoryIdSchema, taskIdSchema } from "./schema/id.mjs";
+import { repositorySlugSchema } from "./schema/repository.mjs";
+import { agentRouteBindingSchema } from "./schema/agent-route.mjs";
+import { executionReferenceSchema, taskSchema } from "./schema/task.mjs";
+import { hasMessageContent, imageAttachmentsSchema } from "./image-input.mjs";
+import { agentSessionIdSchema, agentSessionMessageSchema, agentSessionSchema } from "./schema/session.mjs";
+import { z } from "zod";
+//#region src/api-contracts.ts
+/** Validates an agent exposed by the operator API. */
+const apiAgentSchema = z.strictObject({
+	id: z.string().regex(/^[a-z][a-z0-9-]{0,31}$/u).describe("Agent name used for discovery, filtering, and session creation when allowed."),
+	description: z.string().describe("What this agent does."),
+	route: agentRouteBindingSchema.optional().describe("Exact registered specialist route; absent for conversations."),
+	canStart: z.boolean().describe("Whether an operator may start this agent directly through the session API."),
+	requiresRepository: z.boolean().describe("Whether creation requires a configured repository."),
+	requiresChange: z.boolean().describe("Whether creation requires an existing change ID.")
+});
+/** Validates an idempotent request to create an operator session. */
+const createSessionRequestSchema = z.strictObject({
+	operationId: z.string().trim().min(1).max(200).describe("Client-generated idempotency key; retain when retrying creation."),
+	agent: apiAgentSchema.shape.id,
+	repository: repositorySlugSchema.optional().describe("Configured owner/repo slug."),
+	changeId: changeIdSchema.optional().describe("Existing change to review, verify, or continue."),
+	message: agentSessionMessageSchema,
+	attachments: imageAttachmentsSchema.optional().describe("Uploaded images accompanying this message.")
+}).refine(hasMessageContent, "Enter a message or attach an image");
+/** Validates a message sent to an existing session with optimistic execution matching. */
+const sendSessionMessageRequestSchema = z.strictObject({
+	message: agentSessionMessageSchema,
+	attachments: imageAttachmentsSchema.optional().describe("Uploaded images accompanying this message."),
+	operationId: z.string().trim().min(1).max(200).optional().describe("Required for a follow-up after completion; retain unchanged for retries."),
+	turnPolicy: z.enum(["steer", "queue"]).default("steer").describe("Whether an active turn is steered immediately or the message is queued."),
+	executionId: z.string().min(1).nullable().describe("Observed execution ID; stale writes are rejected.")
+}).refine(hasMessageContent, "Enter a message or attach an image");
+const sessionInputResponseBase = { requestId: z.string().min(1).describe("Pending provider input request ID.") };
+/** Validates an option selection or freeform answer to one provider input request. */
+const sessionInputResponseSchema = z.union([z.strictObject({
+	...sessionInputResponseBase,
+	optionId: z.string().min(1).describe("Selected option ID."),
+	text: z.never().optional().describe("Absent for an option selection.")
+}), z.strictObject({
+	...sessionInputResponseBase,
+	optionId: z.never().optional().describe("Absent for a freeform answer."),
+	text: z.string().min(1).describe("Freeform answer text.")
+})]);
+/** Validates responses submitted to pending provider input requests. */
+const submitSessionInputRequestSchema = z.strictObject({
+	executionId: z.string().min(1).describe("Observed provider session ID; stale input responses are rejected."),
+	inputResponses: z.array(sessionInputResponseSchema).min(1).readonly().describe("Responses to pending human-input requests.")
+});
+/** Validates an execution-aware session control request. */
+const controlSessionRequestSchema = z.strictObject({
+	executionId: z.string().min(1).optional().describe("Observed provider session ID; guards against a replaced execution."),
+	turnId: z.string().min(1).optional().describe("Observed turn ID for cooperative interruption.")
+});
+/** Validates an authenticated answer to a workflow question. */
+const answerSessionQuestionRequestSchema = z.strictObject({
+	questionId: taskIdSchema.describe("Question Task belonging to this operator session."),
+	answer: z.string().min(1).max(16e3).describe("Authenticated immutable human answer.")
+});
+/** Validates the current operator-facing projection of a Factory session. */
+const sessionViewSchema = z.strictObject({
+	session: agentSessionSchema.describe("Durable interaction binding."),
+	task: taskSchema.nullable().describe("Current task state, if workflow-backed."),
+	dependencyTaskIds: z.array(taskIdSchema).readonly().optional().describe("Read-only current Task dependencies projected from its authoritative task graph."),
+	execution: executionReferenceSchema.nullable().describe("Current execution; may change after recovery."),
+	activeAgent: z.string().optional().describe("Agent executing the selected work in this conversation."),
+	source: z.string().optional().describe("Original trigger of automatically started work."),
+	prUrl: z.string().optional().describe("Pull request associated with the conversation."),
+	attention: z.enum([
+		"question",
+		"failed",
+		"stalled",
+		"review",
+		"conversation"
+	]).optional().describe("Current human action: answer a question, inspect failed or stalled work, review a ready Change, or continue an external conversation."),
+	canFollowUp: z.boolean().optional().describe("Whether completed work can start a budgeted discussion in this conversation."),
+	hasWorkflowFailure: z.boolean().optional().describe("Whether delegated workflow work has failed, independently of a pending question."),
+	canCancel: z.boolean().optional().describe("Whether cancellation is available for the conversation or its delegated workflow work."),
+	history: z.array(z.strictObject({
+		taskId: taskIdSchema.optional().describe("Task owning this execution, if any."),
+		agent: z.string().describe("Agent that owns the provider execution."),
+		message: z.string().describe("Initial request displayed for this execution."),
+		attachments: imageAttachmentsSchema.optional().describe("Images accompanying this execution's initial user request."),
+		execution: executionReferenceSchema.describe("Authorized provider execution to replay.")
+	})).readonly().optional().describe("Earlier executions, in conversation order, including replacement attempts."),
+	relatedTasks: z.array(taskSchema).readonly().optional().describe("Work linked to this conversation, including specialist delegations."),
+	question: taskSchema.nullable().describe("Open Factory question requiring an authenticated answer.")
+});
+/** Validates a cursor-paginated page of operator-facing sessions. */
+const sessionPageSchema = z.strictObject({
+	sessions: z.array(sessionViewSchema).readonly().describe("Sessions in this page."),
+	nextCursor: agentSessionIdSchema.nullable().default(null).describe("Session ID that starts the next page, or null after the final page."),
+	totalCount: z.number().int().nonnegative().optional().describe("Total matching sessions when explicitly requested.")
+});
+/** Validates one configured repository exposed by the operator API. */
+const repositorySummarySchema = z.strictObject({
+	id: repositoryIdSchema.describe("Stable configured repository identifier."),
+	slug: repositorySlugSchema.describe("Configured owner/repository slug.")
+});
+/** Validates repository slugs and their stable identifiers. */
+const repositoryDetailsSchema = z.strictObject({
+	repositories: z.array(repositorySlugSchema).readonly().describe("Configured owner/repository slugs."),
+	details: z.array(repositorySummarySchema).readonly().default([]).describe("Stable identifiers and slugs for configured repositories.")
+});
+/** Validates a locally retained follow-up awaiting confirmed API acceptance. */
+const pendingFollowUpSchema = z.strictObject({
+	sessionId: agentSessionIdSchema.describe("Conversation containing this follow-up."),
+	operationId: z.string().min(1).max(200).describe("Stable operation id retained until acceptance is confirmed."),
+	executionId: z.string().nullable().describe("Execution observed before sending, or null before execution starts."),
+	message: agentSessionMessageSchema,
+	attachments: imageAttachmentsSchema.optional().describe("Uploaded images accompanying this message."),
+	turnPolicy: z.enum(["steer", "queue"]).describe("Requested turn policy.")
+}).refine(hasMessageContent, "Enter a message or attach an image");
+//#endregion
+export { answerSessionQuestionRequestSchema, apiAgentSchema, controlSessionRequestSchema, createSessionRequestSchema, pendingFollowUpSchema, repositoryDetailsSchema, repositorySummarySchema, sendSessionMessageRequestSchema, sessionInputResponseSchema, sessionPageSchema, sessionViewSchema, submitSessionInputRequestSchema };
+
+//# sourceMappingURL=api-contracts.mjs.map

package/dist/api-contracts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-contracts.mjs","names":[],"sources":["../src/api-contracts.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { hasMessageContent, imageAttachmentsSchema, type ImageAttachment } from \"./image-input\";\nimport {\n  changeIdSchema,\n  repositoryIdSchema,\n  taskIdSchema,\n  type ChangeId,\n  type TaskId,\n} from \"./schema/id\";\nimport { repositorySlugSchema, type RepositorySlug } from \"./schema/repository\";\nimport {\n  agentRouteBindingSchema,\n  type AgentRouteBinding,\n  type AgentRouteBindingInput,\n} from \"./schema/agent-route\";\nimport {\n  agentSessionIdSchema,\n  agentSessionMessageSchema,\n  agentSessionSchema,\n} from \"./schema/session\";\nimport { taskSchema, executionReferenceSchema } from \"./schema/task\";\n\n/** Validates an agent exposed by the operator API. */\nexport const apiAgentSchema = z.strictObject({\n  id: z\n    .string()\n    .regex(/^[a-z][a-z0-9-]{0,31}$/u)\n    .describe(\"Agent name used for discovery, filtering, and session creation when allowed.\"),\n  description: z.string().describe(\"What this agent does.\"),\n  route: agentRouteBindingSchema\n    .optional()\n    .describe(\"Exact registered specialist route; absent for conversations.\"),\n  canStart: z\n    .boolean()\n    .describe(\"Whether an operator may start this agent directly through the session API.\"),\n  requiresRepository: z.boolean().describe(\"Whether creation requires a configured repository.\"),\n  requiresChange: z.boolean().describe(\"Whether creation requires an existing change ID.\"),\n});\n/** An agent exposed for operator discovery, filtering, or session creation. */\nexport type ApiAgent = Readonly<\n  Omit<z.infer<typeof apiAgentSchema>, \"route\"> & {\n    readonly route?: AgentRouteBinding;\n  }\n>;\n\n/** Caller input for exposing an agent through the operator API before validation and branding. */\nexport interface ApiAgentInput {\n  readonly id: string;\n  readonly description: string;\n  readonly route?: AgentRouteBindingInput;\n  readonly canStart: boolean;\n  readonly requiresRepository: boolean;\n  readonly requiresChange: boolean;\n}\n\n/** Validates an idempotent request to create an operator session. */\nexport const createSessionRequestSchema = z\n  .strictObject({\n    operationId: z\n      .string()\n      .trim()\n      .min(1)\n      .max(200)\n      .describe(\"Client-generated idempotency key; retain when retrying creation.\"),\n    agent: apiAgentSchema.shape.id,\n    repository: repositorySlugSchema.optional().describe(\"Configured owner/repo slug.\"),\n    changeId: changeIdSchema.optional().describe(\"Existing change to review, verify, or continue.\"),\n    message: agentSessionMessageSchema,\n    attachments: imageAttachmentsSchema\n      .optional()\n      .describe(\"Uploaded images accompanying this message.\"),\n  })\n  .refine(hasMessageContent, \"Enter a message or attach an image\");\n/** An idempotent request to create an operator session. */\nexport type CreateSessionRequest = Readonly<\n  Omit<z.input<typeof createSessionRequestSchema>, \"attachments\" | \"repository\" | \"changeId\">\n> & {\n  readonly repository?: RepositorySlug;\n  readonly changeId?: ChangeId;\n  readonly attachments?: readonly ImageAttachment[];\n};\n\n/** Validates a message sent to an existing session with optimistic execution matching. */\nexport const sendSessionMessageRequestSchema = z\n  .strictObject({\n    message: agentSessionMessageSchema,\n    attachments: imageAttachmentsSchema\n      .optional()\n      .describe(\"Uploaded images accompanying this message.\"),\n    operationId: z\n      .string()\n      .trim()\n      .min(1)\n      .max(200)\n      .optional()\n      .describe(\"Required for a follow-up after completion; retain unchanged for retries.\"),\n    turnPolicy: z\n      .enum([\"steer\", \"queue\"])\n      .default(\"steer\")\n      .describe(\"Whether an active turn is steered immediately or the message is queued.\"),\n    executionId: z\n      .string()\n      .min(1)\n      .nullable()\n      .describe(\"Observed execution ID; stale writes are rejected.\"),\n  })\n  .refine(hasMessageContent, \"Enter a message or attach an image\");\n\n/** Message sent to an existing session with optimistic execution matching. */\nexport type SendSessionMessageRequest = Readonly<\n  Omit<z.input<typeof sendSessionMessageRequestSchema>, \"attachments\">\n> & {\n  readonly attachments?: readonly ImageAttachment[];\n};\n\nconst sessionInputResponseBase = {\n  requestId: z.string().min(1).describe(\"Pending provider input request ID.\"),\n};\n\n/** Validates an option selection or freeform answer to one provider input request. */\nexport const sessionInputResponseSchema = z.union([\n  z.strictObject({\n    ...sessionInputResponseBase,\n    optionId: z.string().min(1).describe(\"Selected option ID.\"),\n    text: z.never().optional().describe(\"Absent for an option selection.\"),\n  }),\n  z.strictObject({\n    ...sessionInputResponseBase,\n    optionId: z.never().optional().describe(\"Absent for a freeform answer.\"),\n    text: z.string().min(1).describe(\"Freeform answer text.\"),\n  }),\n]);\n/** A response to one pending provider input request. */\nexport type SessionInputResponse = Readonly<z.input<typeof sessionInputResponseSchema>>;\n\n/** Validates responses submitted to pending provider input requests. */\nexport const submitSessionInputRequestSchema = z.strictObject({\n  executionId: z\n    .string()\n    .min(1)\n    .describe(\"Observed provider session ID; stale input responses are rejected.\"),\n  inputResponses: z\n    .array(sessionInputResponseSchema)\n    .min(1)\n    .readonly()\n    .describe(\"Responses to pending human-input requests.\"),\n});\n/** Responses submitted to pending provider input requests. */\nexport interface SubmitSessionInputRequest {\n  readonly executionId: string;\n  readonly inputResponses: readonly SessionInputResponse[];\n}\n\n/** Validates an execution-aware session control request. */\nexport const controlSessionRequestSchema = z.strictObject({\n  executionId: z\n    .string()\n    .min(1)\n    .optional()\n    .describe(\"Observed provider session ID; guards against a replaced execution.\"),\n  turnId: z.string().min(1).optional().describe(\"Observed turn ID for cooperative interruption.\"),\n});\n/** Execution and turn observed before requesting a session control operation. */\nexport type ControlSessionRequest = Readonly<z.input<typeof controlSessionRequestSchema>>;\n\n/** Validates an authenticated answer to a workflow question. */\nexport const answerSessionQuestionRequestSchema = z.strictObject({\n  questionId: taskIdSchema.describe(\"Question Task belonging to this operator session.\"),\n  answer: z.string().min(1).max(16000).describe(\"Authenticated immutable human answer.\"),\n});\n/** Authenticated answer to a workflow question in a session. */\nexport interface AnswerSessionQuestionRequest {\n  readonly questionId: TaskId;\n  readonly answer: string;\n}\n\n/** Validates the current operator-facing projection of a Factory session. */\nexport const sessionViewSchema = z.strictObject({\n  session: agentSessionSchema.describe(\"Durable interaction binding.\"),\n  task: taskSchema.nullable().describe(\"Current task state, if workflow-backed.\"),\n  dependencyTaskIds: z\n    .array(taskIdSchema)\n    .readonly()\n    .optional()\n    .describe(\"Read-only current Task dependencies projected from its authoritative task graph.\"),\n  execution: executionReferenceSchema\n    .nullable()\n    .describe(\"Current execution; may change after recovery.\"),\n  activeAgent: z\n    .string()\n    .optional()\n    .describe(\"Agent executing the selected work in this conversation.\"),\n  source: z.string().optional().describe(\"Original trigger of automatically started work.\"),\n  prUrl: z.string().optional().describe(\"Pull request associated with the conversation.\"),\n  attention: z\n    .enum([\"question\", \"failed\", \"stalled\", \"review\", \"conversation\"])\n    .optional()\n    .describe(\n      \"Current human action: answer a question, inspect failed or stalled work, review a ready Change, or continue an external conversation.\",\n    ),\n  canFollowUp: z\n    .boolean()\n    .optional()\n    .describe(\"Whether completed work can start a budgeted discussion in this conversation.\"),\n  hasWorkflowFailure: z\n    .boolean()\n    .optional()\n    .describe(\"Whether delegated workflow work has failed, independently of a pending question.\"),\n  canCancel: z\n    .boolean()\n    .optional()\n    .describe(\n      \"Whether cancellation is available for the conversation or its delegated workflow work.\",\n    ),\n  history: z\n    .array(\n      z.strictObject({\n        taskId: taskIdSchema.optional().describe(\"Task owning this execution, if any.\"),\n        agent: z.string().describe(\"Agent that owns the provider execution.\"),\n        message: z.string().describe(\"Initial request displayed for this execution.\"),\n        attachments: imageAttachmentsSchema\n          .optional()\n          .describe(\"Images accompanying this execution's initial user request.\"),\n        execution: executionReferenceSchema.describe(\"Authorized provider execution to replay.\"),\n      }),\n    )\n    .readonly()\n    .optional()\n    .describe(\"Earlier executions, in conversation order, including replacement attempts.\"),\n  relatedTasks: z\n    .array(taskSchema)\n    .readonly()\n    .optional()\n    .describe(\"Work linked to this conversation, including specialist delegations.\"),\n  question: taskSchema\n    .nullable()\n    .describe(\"Open Factory question requiring an authenticated answer.\"),\n});\n/** The current operator-facing projection of a Factory session. */\nexport type SessionView = z.infer<typeof sessionViewSchema>;\n\n/** Validates a cursor-paginated page of operator-facing sessions. */\nexport const sessionPageSchema = z.strictObject({\n  sessions: z.array(sessionViewSchema).readonly().describe(\"Sessions in this page.\"),\n  nextCursor: agentSessionIdSchema\n    .nullable()\n    .default(null)\n    .describe(\"Session ID that starts the next page, or null after the final page.\"),\n  totalCount: z\n    .number()\n    .int()\n    .nonnegative()\n    .optional()\n    .describe(\"Total matching sessions when explicitly requested.\"),\n});\n/** Cursor-paginated operator-facing sessions. */\nexport type SessionPage = z.infer<typeof sessionPageSchema>;\n\n/** Validates one configured repository exposed by the operator API. */\nexport const repositorySummarySchema = z.strictObject({\n  id: repositoryIdSchema.describe(\"Stable configured repository identifier.\"),\n  slug: repositorySlugSchema.describe(\"Configured owner/repository slug.\"),\n});\n/** Configured repository exposed by the operator API. */\nexport type RepositorySummary = z.infer<typeof repositorySummarySchema>;\n\n/** Validates repository slugs and their stable identifiers. */\nexport const repositoryDetailsSchema = z.strictObject({\n  repositories: z\n    .array(repositorySlugSchema)\n    .readonly()\n    .describe(\"Configured owner/repository slugs.\"),\n  details: z\n    .array(repositorySummarySchema)\n    .readonly()\n    .default([])\n    .describe(\"Stable identifiers and slugs for configured repositories.\"),\n});\n/** Repository slugs and their stable configured identifiers. */\nexport type RepositoryDetails = z.infer<typeof repositoryDetailsSchema>;\n\n/** Validates a locally retained follow-up awaiting confirmed API acceptance. */\nexport const pendingFollowUpSchema = z\n  .strictObject({\n    sessionId: agentSessionIdSchema.describe(\"Conversation containing this follow-up.\"),\n    operationId: z\n      .string()\n      .min(1)\n      .max(200)\n      .describe(\"Stable operation id retained until acceptance is confirmed.\"),\n    executionId: z\n      .string()\n      .nullable()\n      .describe(\"Execution observed before sending, or null before execution starts.\"),\n    message: agentSessionMessageSchema,\n    attachments: imageAttachmentsSchema\n      .optional()\n      .describe(\"Uploaded images accompanying this message.\"),\n    turnPolicy: z.enum([\"steer\", \"queue\"]).describe(\"Requested turn policy.\"),\n  })\n  .refine(hasMessageContent, \"Enter a message or attach an image\");\n/** A locally retained follow-up awaiting confirmed API acceptance. */\nexport type PendingFollowUp = Readonly<\n  Omit<z.output<typeof pendingFollowUpSchema>, \"attachments\">\n> & {\n  readonly attachments?: readonly ImageAttachment[];\n};\n"],"mappings":"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"}

package/dist/api-images.d.mts

@@ -0,0 +1,30 @@
+import { ImageAttachment } from "./image-input.mjs";
+import { FactoryStores } from "./store/engine.mjs";
+//#region src/api-images.d.ts
+/** Minimal image-store operations required to resolve stored attachments. */
+interface ResolveImageMessageStores {
+  readonly images: Pick<FactoryStores["images"], "get" | "validate">;
+}
+/** Identifies the owner, text, and stored attachments for one Eve message. */
+interface ResolveImageMessageInput {
+  readonly owner: string;
+  readonly message: string;
+  readonly attachments?: readonly ImageAttachment[];
+}
+/** One text or stored-image part in a resolved Eve message. */
+type ResolvedImageMessagePart = Readonly<{
+  type: "text";
+  text: string;
+}> | Readonly<{
+  type: "file";
+  filename: string;
+  mediaType: ImageAttachment["mediaType"];
+  data: `data:${ImageAttachment["mediaType"]};base64,${string}`;
+}>;
+/** Eve-compatible message text or parts after stored image references are resolved. */
+type ResolvedImageMessage = string | readonly ResolvedImageMessagePart[];
+/** Resolve authorized stored image references into an Eve-compatible message. */
+declare function resolveImageMessage(stores: ResolveImageMessageStores, input: ResolveImageMessageInput): Promise<ResolvedImageMessage>;
+//#endregion
+export { ResolveImageMessageInput, ResolveImageMessageStores, ResolvedImageMessage, ResolvedImageMessagePart, resolveImageMessage };
+//# sourceMappingURL=api-images.d.mts.map

package/dist/api-images.mjs

@@ -0,0 +1,28 @@
+import { imageAttachmentsSchema, imagePartFilename } from "./image-input.mjs";
+//#region src/api-images.ts
+/** Resolve authorized stored image references into an Eve-compatible message. */
+async function resolveImageMessage(stores, input) {
+	const { owner, message, attachments = [] } = input;
+	imageAttachmentsSchema.parse(attachments);
+	await stores.images.validate(owner, attachments);
+	if (attachments.length === 0) return message;
+	const files = await Promise.all(attachments.map(async (attachment) => {
+		const image = await stores.images.get(owner, attachment.id);
+		if (!image) throw new Error("Image is unavailable");
+		const data = `data:${image.mediaType};base64,${image.base64}`;
+		return {
+			type: "file",
+			filename: imagePartFilename(image),
+			mediaType: image.mediaType,
+			data
+		};
+	}));
+	return [...message ? [{
+		type: "text",
+		text: message
+	}] : [], ...files];
+}
+//#endregion
+export { resolveImageMessage };
+
+//# sourceMappingURL=api-images.mjs.map

package/dist/api-images.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-images.mjs","names":[],"sources":["../src/api-images.ts"],"sourcesContent":["import type { FactoryStores } from \"./store/engine\";\nimport { imageAttachmentsSchema, imagePartFilename, type ImageAttachment } from \"./image-input\";\n\n/** Minimal image-store operations required to resolve stored attachments. */\nexport interface ResolveImageMessageStores {\n  readonly images: Pick<FactoryStores[\"images\"], \"get\" | \"validate\">;\n}\n\n/** Identifies the owner, text, and stored attachments for one Eve message. */\nexport interface ResolveImageMessageInput {\n  readonly owner: string;\n  readonly message: string;\n  readonly attachments?: readonly ImageAttachment[];\n}\n\n/** One text or stored-image part in a resolved Eve message. */\nexport type ResolvedImageMessagePart =\n  | Readonly<{ type: \"text\"; text: string }>\n  | Readonly<{\n      type: \"file\";\n      filename: string;\n      mediaType: ImageAttachment[\"mediaType\"];\n      data: `data:${ImageAttachment[\"mediaType\"]};base64,${string}`;\n    }>;\n\n/** Eve-compatible message text or parts after stored image references are resolved. */\nexport type ResolvedImageMessage = string | readonly ResolvedImageMessagePart[];\n\n/** Resolve authorized stored image references into an Eve-compatible message. */\nexport async function resolveImageMessage(\n  stores: ResolveImageMessageStores,\n  input: ResolveImageMessageInput,\n): Promise<ResolvedImageMessage> {\n  const { owner, message, attachments = [] } = input;\n  imageAttachmentsSchema.parse(attachments);\n  await stores.images.validate(owner, attachments);\n  if (attachments.length === 0) return message;\n  const files = await Promise.all(\n    attachments.map(async (attachment) => {\n      const image = await stores.images.get(owner, attachment.id);\n      if (!image) throw new Error(\"Image is unavailable\");\n      const data: `data:${ImageAttachment[\"mediaType\"]};base64,${string}` = `data:${image.mediaType};base64,${image.base64}`;\n      return {\n        type: \"file\" as const,\n        filename: imagePartFilename(image),\n        mediaType: image.mediaType,\n        data,\n      };\n    }),\n  );\n  return [...(message ? [{ type: \"text\" as const, text: message }] : []), ...files];\n}\n"],"mappings":";;;AA6BA,eAAsB,oBACpB,QACA,OAC+B;CAC/B,MAAM,EAAE,OAAO,SAAS,cAAc,CAAC,MAAM;CAC7C,uBAAuB,MAAM,WAAW;CACxC,MAAM,OAAO,OAAO,SAAS,OAAO,WAAW;CAC/C,IAAI,YAAY,WAAW,GAAG,OAAO;CACrC,MAAM,QAAQ,MAAM,QAAQ,IAC1B,YAAY,IAAI,OAAO,eAAe;EACpC,MAAM,QAAQ,MAAM,OAAO,OAAO,IAAI,OAAO,WAAW,EAAE;EAC1D,IAAI,CAAC,OAAO,MAAM,IAAI,MAAM,sBAAsB;EAClD,MAAM,OAAgE,QAAQ,MAAM,UAAU,UAAU,MAAM;EAC9G,OAAO;GACL,MAAM;GACN,UAAU,kBAAkB,KAAK;GACjC,WAAW,MAAM;GACjB;EACF;CACF,CAAC,CACH;CACA,OAAO,CAAC,GAAI,UAAU,CAAC;EAAE,MAAM;EAAiB,MAAM;CAAQ,CAAC,IAAI,CAAC,GAAI,GAAG,KAAK;AAClF"}

package/dist/api-task-graph.mjs

@@ -0,0 +1,57 @@
+import { agentSessionIdSchema } from "./schema/session.mjs";
+//#region src/api-task-graph.ts
+var TaskGraphAccessError = class extends Error {
+	status;
+	constructor(status, message) {
+		super(message);
+		this.status = status;
+	}
+};
+async function readSessionGraph(options, session) {
+	const { stores } = options;
+	if (!session.taskId) return {
+		rootTaskId: null,
+		nodes: []
+	};
+	const bound = await stores.tasks.get(session.taskId);
+	if (!bound) throw new TaskGraphAccessError(409, "The entrypoint Task is unavailable; refresh the graph.");
+	const graph = await stores.graphs.get(bound.rootTaskId);
+	if (!graph || !graph.nodes.some((node) => node.taskId === bound.id)) throw new TaskGraphAccessError(409, "The Task graph is unavailable; refresh to retry.");
+	const nodes = [];
+	const repositories = /* @__PURE__ */ new Map();
+	const sessions = /* @__PURE__ */ new Map();
+	for (let start = 0; start < graph.nodes.length; start += 16) nodes.push(...await Promise.all(graph.nodes.slice(start, start + 16).map(async (node) => {
+		const task = await stores.tasks.get(node.taskId);
+		if (!task || task.rootTaskId !== graph.rootTaskId || task.parentTaskId !== node.parentTaskId) throw new TaskGraphAccessError(409, "Task graph membership is incomplete; refresh to retry.");
+		for (const id of task.repositoryIds) {
+			if (!repositories.has(id)) repositories.set(id, stores.repositories.get(id).then((repo) => Boolean(repo?.enabled && options.repositories.includes(repo.slug))));
+			if (!await repositories.get(id)) throw new TaskGraphAccessError(403, "The graph includes a repository that is no longer enabled and configured.");
+		}
+		let context = session;
+		if (task.replyTo.channel === "api") {
+			if (!sessions.has(task.replyTo.address)) sessions.set(task.replyTo.address, stores.sessions.get(agentSessionIdSchema.parse(task.replyTo.address)));
+			const owned = await sessions.get(task.replyTo.address);
+			if (!owned || owned.owner !== session.owner) throw new TaskGraphAccessError(404, "Task graph not found");
+			context = owned;
+		} else if (task.origin.operator !== session.owner && !await options.canAccessTask?.({ id: session.owner }, task)) throw new TaskGraphAccessError(404, "Task graph not found");
+		const binding = task.work.route;
+		const route = binding ? options.routes.get(binding) : void 0;
+		const continuation = context.continuations?.find((item) => item.taskId === task.id);
+		const candidate = route?.agent ?? (binding?.id === "conversation" && binding.version === 1 && continuation?.agent === options.continuationAgent ? options.continuationAgent : void 0);
+		const agent = candidate && options.agents.some((item) => item.id === candidate) ? candidate : null;
+		return {
+			task,
+			dependencyTaskIds: node.dependencies,
+			session: context,
+			agent
+		};
+	})));
+	return {
+		rootTaskId: graph.rootTaskId,
+		nodes
+	};
+}
+//#endregion
+export { TaskGraphAccessError, readSessionGraph };
+
+//# sourceMappingURL=api-task-graph.mjs.map

package/dist/api-task-graph.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-task-graph.mjs","names":[],"sources":["../src/api-task-graph.ts"],"sourcesContent":["import type { FactoryApiOptions } from \"./api\";\nimport { agentSessionIdSchema, type AgentSession } from \"./schema/session\";\nimport type { Task } from \"./schema/task\";\nimport type { TaskId } from \"./schema/id\";\n\nexport class TaskGraphAccessError extends Error {\n  constructor(\n    readonly status: number,\n    message: string,\n  ) {\n    super(message);\n  }\n}\n\nexport async function readSessionGraph(options: FactoryApiOptions, session: AgentSession) {\n  const { stores } = options;\n  if (!session.taskId) return { rootTaskId: null, nodes: [] };\n  const bound = await stores.tasks.get(session.taskId);\n  if (!bound)\n    throw new TaskGraphAccessError(409, \"The entrypoint Task is unavailable; refresh the graph.\");\n  const graph = await stores.graphs.get(bound.rootTaskId);\n  if (!graph || !graph.nodes.some((node) => node.taskId === bound.id))\n    throw new TaskGraphAccessError(409, \"The Task graph is unavailable; refresh to retry.\");\n  const nodes: {\n    task: Task;\n    dependencyTaskIds: readonly TaskId[];\n    session: AgentSession;\n    agent: string | null;\n  }[] = [];\n  const repositories = new Map<string, Promise<boolean>>();\n  const sessions = new Map<string, Promise<AgentSession | null>>();\n  // Bound fan-out: a graph contains at most 256 directly addressed Tasks.\n  for (let start = 0; start < graph.nodes.length; start += 16) {\n    nodes.push(\n      ...(await Promise.all(\n        graph.nodes.slice(start, start + 16).map(async (node) => {\n          const task = await stores.tasks.get(node.taskId);\n          if (\n            !task ||\n            task.rootTaskId !== graph.rootTaskId ||\n            task.parentTaskId !== node.parentTaskId\n          )\n            throw new TaskGraphAccessError(\n              409,\n              \"Task graph membership is incomplete; refresh to retry.\",\n            );\n          for (const id of task.repositoryIds) {\n            if (!repositories.has(id))\n              repositories.set(\n                id,\n                stores.repositories\n                  .get(id)\n                  .then((repo) =>\n                    Boolean(repo?.enabled && options.repositories.includes(repo.slug)),\n                  ),\n              );\n            if (!(await repositories.get(id)))\n              throw new TaskGraphAccessError(\n                403,\n                \"The graph includes a repository that is no longer enabled and configured.\",\n              );\n          }\n          let context: AgentSession = session;\n          if (task.replyTo.channel === \"api\") {\n            if (!sessions.has(task.replyTo.address))\n              sessions.set(\n                task.replyTo.address,\n                stores.sessions.get(agentSessionIdSchema.parse(task.replyTo.address)),\n              );\n            const owned = await sessions.get(task.replyTo.address);\n            if (!owned || owned.owner !== session.owner)\n              throw new TaskGraphAccessError(404, \"Task graph not found\");\n            context = owned;\n          } else if (\n            task.origin.operator !== session.owner &&\n            !(await options.canAccessTask?.({ id: session.owner }, task))\n          ) {\n            throw new TaskGraphAccessError(404, \"Task graph not found\");\n          }\n          const binding = task.work.route;\n          const route = binding ? options.routes.get(binding) : undefined;\n          const continuation = context.continuations?.find((item) => item.taskId === task.id);\n          const candidate =\n            route?.agent ??\n            (binding?.id === \"conversation\" &&\n            binding.version === 1 &&\n            continuation?.agent === options.continuationAgent\n              ? options.continuationAgent\n              : undefined);\n          const agent =\n            candidate && options.agents.some((item) => item.id === candidate) ? candidate : null;\n          return { task, dependencyTaskIds: node.dependencies, session: context, agent };\n        }),\n      )),\n    );\n  }\n  return { rootTaskId: graph.rootTaskId, nodes };\n}\n"],"mappings":";;AAKA,IAAa,uBAAb,cAA0C,MAAM;CAEnC;CADX,YACE,QACA,SACA;EACA,MAAM,OAAO;EAHJ,KAAA,SAAA;CAIX;AACF;AAEA,eAAsB,iBAAiB,SAA4B,SAAuB;CACxF,MAAM,EAAE,WAAW;CACnB,IAAI,CAAC,QAAQ,QAAQ,OAAO;EAAE,YAAY;EAAM,OAAO,CAAC;CAAE;CAC1D,MAAM,QAAQ,MAAM,OAAO,MAAM,IAAI,QAAQ,MAAM;CACnD,IAAI,CAAC,OACH,MAAM,IAAI,qBAAqB,KAAK,wDAAwD;CAC9F,MAAM,QAAQ,MAAM,OAAO,OAAO,IAAI,MAAM,UAAU;CACtD,IAAI,CAAC,SAAS,CAAC,MAAM,MAAM,MAAM,SAAS,KAAK,WAAW,MAAM,EAAE,GAChE,MAAM,IAAI,qBAAqB,KAAK,kDAAkD;CACxF,MAAM,QAKA,CAAC;CACP,MAAM,+BAAe,IAAI,IAA8B;CACvD,MAAM,2BAAW,IAAI,IAA0C;CAE/D,KAAK,IAAI,QAAQ,GAAG,QAAQ,MAAM,MAAM,QAAQ,SAAS,IACvD,MAAM,KACJ,GAAI,MAAM,QAAQ,IAChB,MAAM,MAAM,MAAM,OAAO,QAAQ,EAAE,CAAC,CAAC,IAAI,OAAO,SAAS;EACvD,MAAM,OAAO,MAAM,OAAO,MAAM,IAAI,KAAK,MAAM;EAC/C,IACE,CAAC,QACD,KAAK,eAAe,MAAM,cAC1B,KAAK,iBAAiB,KAAK,cAE3B,MAAM,IAAI,qBACR,KACA,wDACF;EACF,KAAK,MAAM,MAAM,KAAK,eAAe;GACnC,IAAI,CAAC,aAAa,IAAI,EAAE,GACtB,aAAa,IACX,IACA,OAAO,aACJ,IAAI,EAAE,CAAC,CACP,MAAM,SACL,QAAQ,MAAM,WAAW,QAAQ,aAAa,SAAS,KAAK,IAAI,CAAC,CACnE,CACJ;GACF,IAAI,CAAE,MAAM,aAAa,IAAI,EAAE,GAC7B,MAAM,IAAI,qBACR,KACA,2EACF;EACJ;EACA,IAAI,UAAwB;EAC5B,IAAI,KAAK,QAAQ,YAAY,OAAO;GAClC,IAAI,CAAC,SAAS,IAAI,KAAK,QAAQ,OAAO,GACpC,SAAS,IACP,KAAK,QAAQ,SACb,OAAO,SAAS,IAAI,qBAAqB,MAAM,KAAK,QAAQ,OAAO,CAAC,CACtE;GACF,MAAM,QAAQ,MAAM,SAAS,IAAI,KAAK,QAAQ,OAAO;GACrD,IAAI,CAAC,SAAS,MAAM,UAAU,QAAQ,OACpC,MAAM,IAAI,qBAAqB,KAAK,sBAAsB;GAC5D,UAAU;EACZ,OAAO,IACL,KAAK,OAAO,aAAa,QAAQ,SACjC,CAAE,MAAM,QAAQ,gBAAgB,EAAE,IAAI,QAAQ,MAAM,GAAG,IAAI,GAE3D,MAAM,IAAI,qBAAqB,KAAK,sBAAsB;EAE5D,MAAM,UAAU,KAAK,KAAK;EAC1B,MAAM,QAAQ,UAAU,QAAQ,OAAO,IAAI,OAAO,IAAI,KAAA;EACtD,MAAM,eAAe,QAAQ,eAAe,MAAM,SAAS,KAAK,WAAW,KAAK,EAAE;EAClF,MAAM,YACJ,OAAO,UACN,SAAS,OAAO,kBACjB,QAAQ,YAAY,KACpB,cAAc,UAAU,QAAQ,oBAC5B,QAAQ,oBACR,KAAA;EACN,MAAM,QACJ,aAAa,QAAQ,OAAO,MAAM,SAAS,KAAK,OAAO,SAAS,IAAI,YAAY;EAClF,OAAO;GAAE;GAAM,mBAAmB,KAAK;GAAc,SAAS;GAAS;EAAM;CAC/E,CAAC,CACH,CACF;CAEF,OAAO;EAAE,YAAY,MAAM;EAAY;CAAM;AAC/C"}

package/dist/api.d.mts

@@ -0,0 +1,77 @@
+import { Signal } from "./schema/signal.mjs";
+import { Repository, RepositorySlug } from "./schema/repository.mjs";
+import { ExecutionReference, Task } from "./schema/task.mjs";
+import { AgentRouteRegistry } from "./agent-routes.mjs";
+import { ImageAttachment, imagePartFilename } from "./image-input.mjs";
+import { AgentSession, AgentSessionId, DirectAgentSession, ExternalAgentSession, TaskAgentSession, agentSessionIdSchema, agentSessionSchema } from "./schema/session.mjs";
+import { FactoryStores, ImageInputError, SessionConflictError } from "./store/engine.mjs";
+import { ApiPrincipal } from "./approval-contracts.mjs";
+import { ResolveImageMessageInput, ResolveImageMessageStores, ResolvedImageMessage, ResolvedImageMessagePart, resolveImageMessage } from "./api-images.mjs";
+import { DispatchBudget } from "./dispatch.mjs";
+import { UnavailableWorkspaceDiffInput, WorkspaceDiff, WorkspaceDiffFile, unavailableWorkspaceDiff, workspaceDiffFileSchema, workspaceDiffSchema } from "./workspace-diff.mjs";
+import { WorkspaceSnapshot, workspaceSnapshotSchema, workspaceSnapshotScript } from "./workspace-snapshot.mjs";
+import { WorkspaceBaseBlob, WorkspaceBaseEntry, WorkspaceDiffAssemblyOptions, assembleWorkspaceDiff } from "./workspace-diff-assembly.mjs";
+import { AnswerSessionQuestionRequest, ApiAgent, ApiAgentInput, ControlSessionRequest, CreateSessionRequest, RepositoryDetails, RepositorySummary, SendSessionMessageRequest, SessionInputResponse, SessionPage, SessionView, SubmitSessionInputRequest, answerSessionQuestionRequestSchema, apiAgentSchema, controlSessionRequestSchema, createSessionRequestSchema, repositoryDetailsSchema, repositorySummarySchema, sendSessionMessageRequestSchema, sessionInputResponseSchema, sessionPageSchema, sessionViewSchema, submitSessionInputRequestSchema } from "./api-contracts.mjs";
+//#region src/api.d.ts
+/** Identifies the session launch requested by the Factory HTTP API. */
+interface FactoryApiStartInput {
+  readonly session: AgentSession;
+  readonly task: Task | null;
+  readonly message: string;
+  readonly operationId: string;
+  readonly attachments?: readonly ImageAttachment[];
+}
+/** Identifies one request forwarded from the Factory API to an active execution. */
+interface FactoryApiForwardInput {
+  readonly session: AgentSession;
+  readonly execution: ExecutionReference;
+  readonly path: string;
+  readonly request: Request;
+}
+/** Identifies the active execution whose workspace diff the Factory API requests. */
+interface FactoryApiWorkspaceDiffInput {
+  readonly session: AgentSession;
+  readonly execution: ExecutionReference;
+  readonly signal: AbortSignal;
+}
+/** Application-owned dependencies and authorization policies for the Factory HTTP API. */
+interface FactoryApiOptions {
+  stores: FactoryStores;
+  agents: readonly ApiAgentInput[];
+  routes: AgentRouteRegistry;
+  repositories: readonly RepositorySlug[];
+  budget: DispatchBudget;
+  authenticate(request: Request): Promise<ApiPrincipal | Response>;
+  /** Exact provider-qualified actors allowed to read and decide approvals. Absent disables approval access. */
+  operators?: readonly string[];
+  /** Explicit operator policy for inspecting and controlling external work; absent denies access. */
+  canAccessTask?(operator: {
+    id: string;
+  }, task: Task): Promise<boolean>;
+  /** Exposed conversational agent used for separately budgeted follow-up investigations. */
+  continuationAgent?: string;
+  /** Application-owned launcher for an explicitly retried, stopped intake attempt. */
+  retryIntake?(signal: Signal, options: {
+    expectedAttempt: number;
+    by: string;
+  }): Promise<Signal>;
+  resumeTask?(task: Task): Promise<ExecutionReference>;
+  ensureRepository(slug: RepositorySlug): Promise<Repository>;
+  start(input: FactoryApiStartInput): Promise<ExecutionReference>;
+  forward(input: FactoryApiForwardInput): Promise<Response>;
+  workspaceDiff?(input: FactoryApiWorkspaceDiffInput): Promise<WorkspaceDiff>;
+  reportError?(error: unknown, context: {
+    method: string;
+    path: string;
+  }): void;
+}
+/** Authenticated Factory HTTP handler plus the launcher for durable continuation Tasks. */
+interface FactoryApi {
+  handle(request: Request): Promise<Response>;
+  startContinuation(task: Task): Promise<ExecutionReference>;
+}
+/** Creates the authenticated request handler for the public Factory HTTP API. */
+declare function createFactoryApi(options: FactoryApiOptions): FactoryApi;
+//#endregion
+export { type AgentSession, type AgentSessionId, type AnswerSessionQuestionRequest, type ApiAgent, type ApiAgentInput, type ApiPrincipal, type ControlSessionRequest, type CreateSessionRequest, type DirectAgentSession, type ExternalAgentSession, FactoryApi, FactoryApiForwardInput, FactoryApiOptions, FactoryApiStartInput, FactoryApiWorkspaceDiffInput, ImageInputError, type RepositoryDetails, type RepositorySummary, type ResolveImageMessageInput, type ResolveImageMessageStores, type ResolvedImageMessage, type ResolvedImageMessagePart, type SendSessionMessageRequest, SessionConflictError, type SessionInputResponse, type SessionPage, type SessionView, type SubmitSessionInputRequest, type TaskAgentSession, type UnavailableWorkspaceDiffInput, type WorkspaceBaseBlob, type WorkspaceBaseEntry, type WorkspaceDiff, type WorkspaceDiffAssemblyOptions, type WorkspaceDiffFile, type WorkspaceSnapshot, agentSessionIdSchema, agentSessionSchema, answerSessionQuestionRequestSchema, apiAgentSchema, assembleWorkspaceDiff, controlSessionRequestSchema, createFactoryApi, createSessionRequestSchema, imagePartFilename, repositoryDetailsSchema, repositorySummarySchema, resolveImageMessage, sendSessionMessageRequestSchema, sessionInputResponseSchema, sessionPageSchema, sessionViewSchema, submitSessionInputRequestSchema, unavailableWorkspaceDiff, workspaceDiffFileSchema, workspaceDiffSchema, workspaceSnapshotSchema, workspaceSnapshotScript };
+//# sourceMappingURL=api.d.mts.map