@vercel/factory 0.0.15 → 0.0.16

package/dist/api-contracts.mjs

@@ -19,6 +19,7 @@ const apiAgentSchema = z.strictObject({
 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,
@@ -90,7 +91,7 @@ const sessionViewSchema = z.strictObject({
 /** 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."),
+	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. */

package/dist/api-contracts.mjs.map

@@ -1 +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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"}
+{"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.d.mts

@@ -1,3 +1,9 @@
+import { InboxActivity, InboxActivityItem, inboxActivityItemSchema, inboxActivitySchema } from "./inbox-activity.mjs";
+import { AgentModelConfig, ModelSettings, UpdateModelDefaults, agentModelConfigSchema, modelSettingsSchema, updateModelDefaultsSchema } from "./model-settings.mjs";
+import { SessionPreview, SessionPreviews, sessionPreviewSchema, sessionPreviewsSchema } from "./session-previews.mjs";
+import { SessionReview, SessionReviewCheck, SessionReviewIssue, SessionReviewScreenshot, sessionReviewCheckSchema, sessionReviewIssueSchema, sessionReviewSchema, sessionReviewScreenshotSchema } from "./session-review.mjs";
+import { WorkspaceGitFilesOptions, workspaceGitFilesScript } from "./workspace-files-git.mjs";
+import { WorkspaceFileEntry, WorkspaceFiles, WorkspaceFilesRequest, workspaceFileContentSchema, workspaceFileEntrySchema, workspaceFilesRequestSchema, workspaceFilesSchema, workspacePathSchema } from "./workspace-files.mjs";
 import { Signal } from "./schema/signal.mjs";
 import { Repository, RepositorySlug } from "./schema/repository.mjs";
 import { ExecutionReference, Task } from "./schema/task.mjs";
@@ -28,14 +34,43 @@ interface FactoryApiForwardInput {
   readonly path: string;
   readonly request: Request;
 }
+/** Identifies a file inspection in an authorized execution workspace. */
+interface FactoryApiWorkspaceFilesInput extends FactoryApiWorkspaceDiffInput {
+  readonly query: WorkspaceFilesRequest;
+}
 /** Identifies the active execution whose workspace diff the Factory API requests. */
 interface FactoryApiWorkspaceDiffInput {
   readonly session: AgentSession;
   readonly execution: ExecutionReference;
   readonly signal: AbortSignal;
 }
+/** Authorized session projection supplied to an application-owned review reader. */
+interface FactoryApiSessionReviewInput {
+  readonly current: SessionView;
+  /** Authorized current Task snapshots, including delegated workflow-owned work. */
+  readonly tasks: readonly Task[];
+  readonly signal: AbortSignal;
+}
+/** Authorized work supplied to an application-owned preview reader. */
+interface FactoryApiSessionPreviewsInput {
+  readonly current: SessionView;
+  readonly tasks: readonly Task[];
+  readonly signal: AbortSignal;
+}
+/** Authenticated caller and repository scope supplied to an external activity reader. */
+interface FactoryApiInboxActivityInput {
+  /** Authenticated caller; the reader must apply its application's source access policy. */
+  readonly principal: ApiPrincipal;
+  /** Configured repositories that have not been disabled. Never expand this scope. */
+  readonly repositories: readonly RepositorySlug[];
+  readonly signal: AbortSignal;
+}
 /** Application-owned dependencies and authorization policies for the Factory HTTP API. */
 interface FactoryApiOptions {
+  /** Optional application-owned catalogs; the start adapter must honor each persisted model choice. */
+  agentModels?: readonly AgentModelConfig[];
+  /** Explicit policy for saving shared repository defaults; absent denies mutations. */
+  canEditModelDefaults?(principal: ApiPrincipal, repository: Repository): Promise<boolean>;
   stores: FactoryStores;
   agents: readonly ApiAgentInput[];
   routes: AgentRouteRegistry;
@@ -50,7 +85,7 @@ interface FactoryApiOptions {
   }, 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. */
+  /** Application-owned validation and launch for a stopped intake attempt, including supported Signal sources. */
   retryIntake?(signal: Signal, options: {
     expectedAttempt: number;
     by: string;
@@ -59,7 +94,15 @@ interface FactoryApiOptions {
   ensureRepository(slug: RepositorySlug): Promise<Repository>;
   start(input: FactoryApiStartInput): Promise<ExecutionReference>;
   forward(input: FactoryApiForwardInput): Promise<Response>;
+  /** Optional evidence reader; owns source selection, image access, and response limits. */
+  sessionReview?(input: FactoryApiSessionReviewInput): Promise<SessionReview>;
+  /** Optional read-only preview reader; owns source selection, link access, expiry, and limits. */
+  sessionPreviews?(input: FactoryApiSessionPreviewsInput): Promise<SessionPreviews>;
+  /** Optional external attention reader; owns caller authorization, sources, caching, and limits. */
+  inboxActivity?(input: FactoryApiInboxActivityInput): Promise<InboxActivity>;
   workspaceDiff?(input: FactoryApiWorkspaceDiffInput): Promise<WorkspaceDiff>;
+  /** Optional provider-neutral reader for files and directories at immutable revisions. */
+  workspaceFiles?(input: FactoryApiWorkspaceFilesInput): Promise<WorkspaceFiles>;
   reportError?(error: unknown, context: {
     method: string;
     path: string;
@@ -73,5 +116,5 @@ interface FactoryApi {
 /** 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 };
+export { type AgentModelConfig, type AgentSession, type AgentSessionId, type AnswerSessionQuestionRequest, type ApiAgent, type ApiAgentInput, type ApiPrincipal, type ControlSessionRequest, type CreateSessionRequest, type DirectAgentSession, type ExternalAgentSession, FactoryApi, FactoryApiForwardInput, FactoryApiInboxActivityInput, FactoryApiOptions, FactoryApiSessionPreviewsInput, FactoryApiSessionReviewInput, FactoryApiStartInput, FactoryApiWorkspaceDiffInput, FactoryApiWorkspaceFilesInput, ImageInputError, type InboxActivity, type InboxActivityItem, type ModelSettings, type RepositoryDetails, type RepositorySummary, type ResolveImageMessageInput, type ResolveImageMessageStores, type ResolvedImageMessage, type ResolvedImageMessagePart, type SendSessionMessageRequest, SessionConflictError, type SessionInputResponse, type SessionPage, type SessionPreview, type SessionPreviews, type SessionReview, type SessionReviewCheck, type SessionReviewIssue, type SessionReviewScreenshot, type SessionView, type SubmitSessionInputRequest, type TaskAgentSession, type UnavailableWorkspaceDiffInput, type UpdateModelDefaults, type WorkspaceBaseBlob, type WorkspaceBaseEntry, type WorkspaceDiff, type WorkspaceDiffAssemblyOptions, type WorkspaceDiffFile, type WorkspaceFileEntry, type WorkspaceFiles, type WorkspaceFilesRequest, type WorkspaceGitFilesOptions, type WorkspaceSnapshot, agentModelConfigSchema, agentSessionIdSchema, agentSessionSchema, answerSessionQuestionRequestSchema, apiAgentSchema, assembleWorkspaceDiff, controlSessionRequestSchema, createFactoryApi, createSessionRequestSchema, imagePartFilename, inboxActivityItemSchema, inboxActivitySchema, modelSettingsSchema, repositoryDetailsSchema, repositorySummarySchema, resolveImageMessage, sendSessionMessageRequestSchema, sessionInputResponseSchema, sessionPageSchema, sessionPreviewSchema, sessionPreviewsSchema, sessionReviewCheckSchema, sessionReviewIssueSchema, sessionReviewSchema, sessionReviewScreenshotSchema, sessionViewSchema, submitSessionInputRequestSchema, unavailableWorkspaceDiff, updateModelDefaultsSchema, workspaceDiffFileSchema, workspaceDiffSchema, workspaceFileContentSchema, workspaceFileEntrySchema, workspaceFilesRequestSchema, workspaceFilesSchema, workspaceGitFilesScript, workspacePathSchema, workspaceSnapshotSchema, workspaceSnapshotScript };
 //# sourceMappingURL=api.d.mts.map

package/dist/api.mjs

@@ -1,5 +1,6 @@
-import { signalIdSchema, taskIdSchema } from "./schema/id.mjs";
+import { repositoryIdSchema, signalIdSchema, taskIdSchema } from "./schema/id.mjs";
 import { repositorySlugSchema } from "./schema/repository.mjs";
+import { parseAgentRouteBinding } from "./schema/agent-route.mjs";
 import { taskStateSchema } from "./schema/task.mjs";
 import { InvalidTransitionError } from "./schema/transitions.mjs";
 import { readEvents } from "./client-events.mjs";
@@ -11,10 +12,16 @@ import { BudgetExhaustedError, DispatchRefusedError, dispatchTask } from "./disp
 import { ApprovalAccessError, createApprovalAccess } from "./approval-access.mjs";
 import { agentSessionIdSchema, agentSessionSchema } from "./schema/session.mjs";
 import { ApprovalError, ImageInputError, SessionConflictError } from "./store/engine.mjs";
+import { inboxActivityItemSchema, inboxActivitySchema } from "./inbox-activity.mjs";
+import { agentModelConfigSchema, modelSettingsSchema, updateModelDefaultsSchema } from "./model-settings.mjs";
+import { sessionPreviewSchema, sessionPreviewsSchema } from "./session-previews.mjs";
+import { sessionReviewCheckSchema, sessionReviewIssueSchema, sessionReviewSchema, sessionReviewScreenshotSchema } from "./session-review.mjs";
+import { workspaceFileContentSchema, workspaceFileEntrySchema, workspaceFilesRequestSchema, workspaceFilesSchema, workspacePathSchema } from "./workspace-files.mjs";
 import { intakeViewSchema, retryIntakeSchema } from "./intake-contracts.mjs";
 import { answerSessionQuestionRequestSchema, apiAgentSchema, controlSessionRequestSchema, createSessionRequestSchema, repositoryDetailsSchema, repositorySummarySchema, sendSessionMessageRequestSchema, sessionInputResponseSchema, sessionPageSchema, sessionViewSchema, submitSessionInputRequestSchema } from "./api-contracts.mjs";
 import { unavailableWorkspaceDiff, workspaceDiffFileSchema, workspaceDiffSchema } from "./workspace-diff.mjs";
 import { taskGraphViewSchema } from "./task-graph-view.mjs";
+import { workspaceGitFilesScript } from "./workspace-files-git.mjs";
 import { TaskGraphAccessError, readSessionGraph } from "./api-task-graph.mjs";
 import { resolveImageMessage } from "./api-images.mjs";
 import { workspaceSnapshotSchema, workspaceSnapshotScript } from "./workspace-snapshot.mjs";
@@ -41,6 +48,14 @@ function attention(task, change) {
 function createFactoryApi(options) {
 	const { stores } = options;
 	const agents = options.agents.map((agent) => apiAgentSchema.parse(agent));
+	const agentModels = (options.agentModels ?? []).map((entry) => agentModelConfigSchema.parse(entry));
+	if (new Set(agentModels.map((entry) => entry.agent)).size !== agentModels.length) throw new Error("Duplicate agent model catalog");
+	function selectModel(agent, requested, defaults) {
+		const catalog = agentModels.find((entry) => entry.agent === agent);
+		const model = requested ?? defaults?.[agent] ?? catalog?.defaultModel;
+		if (model !== void 0 && !catalog?.models.some((entry) => entry.id === model)) throw new ApiError(400, `Model is not available for ${agent}. Choose an advertised model.`);
+		return model;
+	}
 	if (new Set(agents.map((agent) => agent.id)).size !== agents.length) throw new Error("Duplicate API agent");
 	if (options.continuationAgent !== void 0 && !agents.some((agent) => agent.id === options.continuationAgent && agent.route === void 0 && agent.canStart)) throw new Error("continuationAgent must be a directly startable conversation agent");
 	for (const agent of agents) if (agent.route !== void 0 && options.routes.get(agent.route)?.agent !== agent.id) throw new Error(`API agent ${agent.id} must select one of its registered routes`);
@@ -413,6 +428,7 @@ function createFactoryApi(options) {
 	async function assertRepository(id) {
 		const repository = await stores.repositories.get(id);
 		if (repository === null || !repository.enabled || !options.repositories.includes(repository.slug)) throw new ApiError(403, "The session repository is no longer enabled and configured");
+		return repository;
 	}
 	async function owned(id, owner) {
 		const session = await stores.sessions.get(agentSessionIdSchema.parse(id));
@@ -479,13 +495,14 @@ function createFactoryApi(options) {
 		if (agent.requiresChange && input.changeId === void 0) throw new ApiError(400, `${agent.id} requires an existing changeId`);
 		const slug = input.repository === void 0 ? void 0 : repositorySlugSchema.parse(input.repository.toLowerCase());
 		if (slug !== void 0 && !options.repositories.includes(slug)) throw new ApiError(403, "Repository is not configured");
-		const repository = slug === void 0 ? void 0 : await options.ensureRepository(slug);
-		if (repository !== void 0) await assertRepository(repository.id);
+		const repository = slug === void 0 ? void 0 : await assertRepository((await options.ensureRepository(slug)).id);
 		if (input.changeId !== void 0) {
 			const change = await stores.changes.get(input.changeId);
 			if (change === null || change.repositoryId !== repository?.id) throw new ApiError(400, "changeId must identify a change in the selected repository");
 			if (change.state !== "verifying" && change.state !== "ready") throw new ApiError(409, "Change is no longer open for work");
 		}
+		const existing = await stores.sessions.getByOperation(owner, input.operationId);
+		const model = existing && input.model === void 0 ? existing.model : selectModel(agent.id, input.model, repository?.modelDefaults?.agents);
 		let session = await stores.sessions.create({
 			operationId: input.operationId,
 			owner,
@@ -494,6 +511,7 @@ function createFactoryApi(options) {
 			route: agent.route,
 			message: input.message,
 			changeId: input.changeId,
+			model,
 			...input.attachments?.length ? { attachments: input.attachments } : {}
 		});
 		if (agent.route !== void 0 && session.taskId === void 0) {
@@ -539,10 +557,57 @@ function createFactoryApi(options) {
 				changeId: input.changeId,
 				dedupeKey: `api:${session.id}`
 			});
+			if (session.model) await stores.tasks.pinModel(task.id, {
+				attempt: task.attempt,
+				model: session.model
+			});
 			session = await stores.sessions.bind(session.id, { taskId: task.id });
 		}
 		return json(await launch(session), 202);
 	}
+	/**
+	* Starts a deepsec security scan of a repository as a background Task,
+	* the same way `factory scan` does, or returns the already-active scan for
+	* that repository instead of starting a duplicate one.
+	*/
+	async function startSecurityScan(rawId, owner) {
+		const repositoryId = repositoryIdSchema.parse(rawId);
+		const repository = await stores.repositories.get(repositoryId);
+		if (!repository) throw new ApiError(404, "Repository not found");
+		await assertRepository(repositoryId);
+		const active = (await stores.tasks.list()).find((task) => task.kind === "security_scan" && task.repositoryIds.includes(repository.id) && ![
+			"succeeded",
+			"failed",
+			"cancelled"
+		].includes(task.state));
+		if (active) return json({
+			taskId: active.id,
+			reused: true
+		}, 202);
+		const route = options.routes.get(parseAgentRouteBinding({
+			id: "security-scan",
+			version: 1
+		}));
+		if (!route) throw new ApiError(409, "This factory has no security-scan route configured");
+		const task = await stores.tasks.create({
+			repositoryIds: [repository.id],
+			kind: "security_scan",
+			work: routeTaskWork({
+				route,
+				title: `Security scan of ${repository.slug}`,
+				input: { repositoryId: repository.id }
+			}),
+			origin: { operator: owner },
+			replyTo: {
+				channel: "factory",
+				address: repository.slug
+			}
+		});
+		return json({
+			taskId: task.id,
+			reused: false
+		}, 202);
+	}
 	async function continuationBrief(session, current, message, taskId) {
 		const continuation = session.continuations?.find((item) => item.taskId === taskId);
 		const saved = continuation?.context;
@@ -625,21 +690,22 @@ function createFactoryApi(options) {
 	}
 	async function materializedTranscript(session, task, agent, execution, signal) {
 		const cached = await stores.transcripts.get(execution);
-		if (cached !== null) return cached;
+		if (cached !== null && cached.state !== "running" && cached.state !== "connecting") return cached;
 		const transcript = new Transcript();
+		if (cached !== null) transcript.hydrate(cached);
 		const path = `/stream?${new URLSearchParams({
-			startIndex: "0",
+			startIndex: String(transcript.cursor),
 			includeTailIndex: "1"
 		})}`;
 		const response = await options.forward({
 			session: executionSession(session, task, agent),
 			execution,
 			path,
-			request: new Request("http://factory/transcript", { signal })
+			request: new Request("http://factory/transcript", { signal: AbortSignal.any([signal, AbortSignal.timeout(15e3)]) })
 		});
 		if (!response.ok || !response.body) {
 			await response.body?.cancel();
-			throw new ApiError(response.status || 502, "Execution transcript is unavailable");
+			throw new ApiError(response.status || 502, response.status === 404 ? "Execution transcript is unavailable on this deployment. It may belong to another deployment or have expired." : "Execution transcript is unavailable");
 		}
 		const tailValue = response.headers.get("x-eve-stream-tail-index");
 		const tail = tailValue === null ? NaN : Number(tailValue);
@@ -647,7 +713,11 @@ function createFactoryApi(options) {
 			await response.body.cancel();
 			throw new Error("Execution transcript did not include a valid durable cursor");
 		}
-		for await (const event of readEvents(response.body)) transcript.accept(event);
+		if (transcript.cursor <= tail) for await (const event of readEvents(response.body)) {
+			transcript.accept(event);
+			if (transcript.cursor === tail + 1) break;
+		}
+		else await response.body.cancel();
 		if (transcript.cursor !== tail + 1) throw new Error("Execution transcript closed before its durable cursor");
 		return stores.transcripts.put(execution, transcript.snapshot());
 	}
@@ -708,6 +778,28 @@ function createFactoryApi(options) {
 			const url = new URL(request.url);
 			const path = url.pathname.replace(/^\/api\/v1\/?/u, "").split("/").filter(Boolean);
 			const [resource, id, action] = path;
+			if (resource === "models" && path.length === 1 && ["GET", "POST"].includes(request.method)) {
+				const update = request.method === "POST" ? updateModelDefaultsSchema.parse(await body(request)) : null;
+				const slug = update?.repository ?? (url.searchParams.has("repository") ? repositorySlugSchema.parse(url.searchParams.get("repository")) : null);
+				if (slug && !options.repositories.includes(slug)) throw new ApiError(403, "Repository is not configured");
+				let repository = slug ? await assertRepository((await options.ensureRepository(slug)).id) : null;
+				const canEdit = repository !== null && agentModels.length > 0 && await options.canEditModelDefaults?.(auth, repository) === true;
+				if (update) {
+					if (!repository || !canEdit) throw new ApiError(403, "Saving model defaults requires an authorized operator");
+					for (const [agent, model] of Object.entries(update.defaults)) selectModel(agent, model);
+					repository = await stores.repositories.setModelDefaults(repository.id, {
+						expectedRevision: update.expectedRevision,
+						agents: update.defaults
+					});
+				}
+				return json(modelSettingsSchema.parse({
+					agents: agentModels,
+					repository: slug,
+					defaults: repository?.modelDefaults?.agents ?? {},
+					revision: repository?.modelDefaults?.revision ?? 0,
+					canEdit
+				}));
+			}
 			if (path.length > 3) throw new ApiError(404, "API route not found");
 			if (resource === "intake") {
 				if (!auth.actor || !(options.operators ?? []).includes(auth.actor)) throw new ApiError(403, "Intake requires an individually authenticated configured operator");
@@ -739,7 +831,7 @@ function createFactoryApi(options) {
 					if (!signal || !allowed.has(signal.repositoryId)) throw new ApiError(404, "Intake not found");
 					const input = retryIntakeSchema.parse(await body(request));
 					if (signal.outcome !== "pending" || signal.triage?.state !== "blocked" || signal.triage.attempt !== input.expectedAttempt || tasks.some((task) => task.origin.signalId === signal.id)) throw new ApiError(409, "Only the observed blocked attempt with no linked task can be retried; refresh intake");
-					if (!options.retryIntake || signal.source !== "github_issue") throw new ApiError(409, "This factory has no retry launcher for this intake source");
+					if (!options.retryIntake) throw new ApiError(409, "This factory has no retry launcher for this intake source");
 					return json(view(await options.retryIntake(signal, {
 						...input,
 						by: auth.actor
@@ -765,6 +857,7 @@ function createFactoryApi(options) {
 					input: await body(request)
 				}));
 			}
+			if (resource === "repositories" && id && action === "security-scan" && request.method === "POST") return await startSecurityScan(id, auth.id);
 			if (resource === "images") {
 				if (request.method === "POST" && path.length === 1) {
 					const input = imageUploadSchema.parse(await body(request, 4 * Math.ceil(MAX_IMAGE_BYTES / 3) + 2048));
@@ -785,6 +878,33 @@ function createFactoryApi(options) {
 				throw new ApiError(404, "API route not found");
 			}
 			if (request.method === "GET" && path.length === 1) {
+				if (resource === "inbox-activity") {
+					if (!options.inboxActivity) return json({
+						state: "unavailable",
+						capturedAt: (/* @__PURE__ */ new Date()).toISOString(),
+						reason: "External activity is not configured."
+					});
+					const allowedRepositories = async () => {
+						const disabled = new Set((await stores.repositories.list()).filter((repo) => !repo.enabled).map((repo) => repo.slug));
+						return options.repositories.filter((slug) => !disabled.has(slug));
+					};
+					const repositories = await allowedRepositories();
+					const result = inboxActivitySchema.parse(await options.inboxActivity({
+						principal: auth,
+						repositories,
+						signal: request.signal
+					}));
+					if (result.state === "ready") {
+						const allowed = new Set(await allowedRepositories());
+						const ids = /* @__PURE__ */ new Set();
+						for (const item of result.items) {
+							if (!repositories.includes(item.repository) || !allowed.has(item.repository)) throw new ApiError(403, "Activity repository is not available");
+							if (ids.has(item.id)) throw new ApiError(502, "Activity contains duplicate identities");
+							ids.add(item.id);
+						}
+					}
+					return json(result);
+				}
 				if (resource === "agents") return json({ agents });
 				if (resource === "repositories") return json({
 					repositories: options.repositories,
@@ -863,6 +983,75 @@ function createFactoryApi(options) {
 				if (latest?.execution?.sessionId !== execution.sessionId || latest.execution.provider !== execution.provider) throw new ApiError(409, "Execution changed; refresh the graph.");
 				return json(snapshot);
 			}
+			if (request.method === "GET" && (action === "review" || action === "previews")) {
+				const current = await view(session, void 0, "summary");
+				const executionId = current.execution?.sessionId ?? null;
+				if (url.searchParams.get("executionId") !== (executionId ?? "")) throw new ApiError(409, "Execution changed; refresh the session before reviewing work");
+				const reader = action === "review" ? options.sessionReview : options.sessionPreviews;
+				if (!reader) return json({
+					state: "unavailable",
+					executionId,
+					capturedAt: (/* @__PURE__ */ new Date()).toISOString(),
+					reason: action === "review" ? "Review evidence is not configured for this factory." : "Live previews are not configured for this factory."
+				});
+				const reviewTasks = async (value) => {
+					const delegated = value.session.external ? [] : workflowTasks(value.session, await stores.tasks.forReplyTo({
+						channel: "api",
+						address: value.session.id
+					}));
+					return [...new Map([
+						...value.task ? [value.task] : [],
+						...value.relatedTasks ?? [],
+						...delegated
+					].map((task) => [task.id, task])).values()].sort((a, b) => a.createdAt.localeCompare(b.createdAt) || a.id.localeCompare(b.id));
+				};
+				const tasks = await reviewTasks(current);
+				const identity = (value, work) => JSON.stringify([
+					value.execution,
+					value.task?.id,
+					work.map((task) => [
+						task.id,
+						task.attempt,
+						task.execution,
+						task.changeId,
+						task.repositoryIds
+					])
+				]);
+				const result = (action === "review" ? sessionReviewSchema : sessionPreviewsSchema).parse(await reader({
+					current,
+					tasks,
+					signal: request.signal
+				}));
+				const latest = await view(await owned(id, auth.id), void 0, "summary");
+				if (identity(current, tasks) !== identity(latest, await reviewTasks(latest))) throw new ApiError(409, "Execution changed; refresh the session before reviewing work");
+				if (result.executionId !== executionId) throw new Error("Review reader returned a different execution");
+				return json(result);
+			}
+			if (request.method === "GET" && action === "files") {
+				const query = workspaceFilesRequestSchema.parse({
+					path: url.searchParams.get("path") ?? "",
+					...url.searchParams.has("revision") ? { revision: url.searchParams.get("revision") } : {}
+				});
+				const current = await view(session, void 0, "summary");
+				const execution = current.execution;
+				if (url.searchParams.get("executionId") !== (execution?.sessionId ?? "")) throw new ApiError(409, "Execution changed; refresh the session before browsing files");
+				if (!execution || !options.workspaceFiles) return json({
+					state: "unavailable",
+					path: query.path,
+					executionId: execution?.sessionId ?? null,
+					reason: execution ? "File browsing is not configured for this factory." : "The workspace is not available yet."
+				});
+				const result = workspaceFilesSchema.parse(await options.workspaceFiles({
+					session: executionSession(session, current.task),
+					execution,
+					query,
+					signal: request.signal
+				}));
+				const latest = (await view(await stores.sessions.get(session.id) ?? session, void 0, "summary")).execution;
+				if (latest?.sessionId !== execution.sessionId || latest.provider !== execution.provider) throw new ApiError(409, "Execution changed; refresh the session before browsing files");
+				if (result.executionId !== execution.sessionId || result.path !== query.path || result.state !== "unavailable" && query.revision !== void 0 && result.revision !== query.revision) throw new Error("File inspection returned a different execution, path, or revision");
+				return json(result);
+			}
 			if (request.method === "GET" && action === "diff") {
 				const current = await view(session, void 0, "summary");
 				const execution = current.execution;
@@ -1082,6 +1271,6 @@ async function body(request, limit = 64e3) {
 	}
 }
 //#endregion
-export { ImageInputError, SessionConflictError, agentSessionIdSchema, agentSessionSchema, answerSessionQuestionRequestSchema, apiAgentSchema, assembleWorkspaceDiff, controlSessionRequestSchema, createFactoryApi, createSessionRequestSchema, imagePartFilename, repositoryDetailsSchema, repositorySummarySchema, resolveImageMessage, sendSessionMessageRequestSchema, sessionInputResponseSchema, sessionPageSchema, sessionViewSchema, submitSessionInputRequestSchema, unavailableWorkspaceDiff, workspaceDiffFileSchema, workspaceDiffSchema, workspaceSnapshotSchema, workspaceSnapshotScript };
+export { ImageInputError, SessionConflictError, agentModelConfigSchema, agentSessionIdSchema, agentSessionSchema, answerSessionQuestionRequestSchema, apiAgentSchema, assembleWorkspaceDiff, controlSessionRequestSchema, createFactoryApi, createSessionRequestSchema, imagePartFilename, inboxActivityItemSchema, inboxActivitySchema, modelSettingsSchema, repositoryDetailsSchema, repositorySummarySchema, resolveImageMessage, sendSessionMessageRequestSchema, sessionInputResponseSchema, sessionPageSchema, sessionPreviewSchema, sessionPreviewsSchema, sessionReviewCheckSchema, sessionReviewIssueSchema, sessionReviewSchema, sessionReviewScreenshotSchema, sessionViewSchema, submitSessionInputRequestSchema, unavailableWorkspaceDiff, updateModelDefaultsSchema, workspaceDiffFileSchema, workspaceDiffSchema, workspaceFileContentSchema, workspaceFileEntrySchema, workspaceFilesRequestSchema, workspaceFilesSchema, workspaceGitFilesScript, workspacePathSchema, workspaceSnapshotSchema, workspaceSnapshotScript };
 
 //# sourceMappingURL=api.mjs.map