@vercel/factory 0.0.14 → 0.0.16

package/dist/api-contracts.mjs

@@ -0,0 +1,119 @@
+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,
+	model: z.string().trim().min(1).max(200).optional().describe("Explicit supported model; absent uses the repository or application default."),
+	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: z.string().min(1).nullable().default(null).describe("Opaque cursor to pass unchanged for 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    model: z\n      .string()\n      .trim()\n      .min(1)\n      .max(200)\n      .optional()\n      .describe(\"Explicit supported model; absent uses the repository or application default.\"),\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: z\n    .string()\n    .min(1)\n    .nullable()\n    .default(null)\n    .describe(\"Opaque cursor to pass unchanged for 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"}