@vercel/factory 0.0.17 → 0.0.19

package/dist/api-contracts.mjs

@@ -1,9 +1,13 @@
 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 { executionReferenceSchema, taskSchema, taskStateSchema } from "./schema/task.mjs";
 import { hasMessageContent, imageAttachmentsSchema } from "./image-input.mjs";
-import { agentSessionIdSchema, agentSessionMessageSchema, agentSessionSchema } from "./schema/session.mjs";
+import { findingSchema } from "./schema/finding.mjs";
+import { changeStateSchema } from "./schema/change.mjs";
+import { agentSessionIdSchema, agentSessionMessageSchema, agentSessionSchema, sessionContinuationSchema } from "./schema/session.mjs";
+import { communicationEventSchema } from "./schema/communication.mjs";
+import { conversationStatusSchema, conversationSummarySchema } from "./schema/session-summary.mjs";
 import { z } from "zod";
 //#region src/api-contracts.ts
 /** Validates an agent exposed by the operator API. */
@@ -59,15 +63,96 @@ 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 an operator conversation card with read-only finding metadata for approval work. */
+const sessionSummarySchema = conversationSummarySchema.extend({ finding: findingSchema.pick({
+	priority: true,
+	category: true
+}).nullable().optional().describe("Finding metadata resolved at read time for approval work; never persisted on the card.") });
+/** Validates the provider lifecycle reported for a pull request linked to a conversation. */
+const sessionPullRequestStateSchema = z.enum([
+	"draft",
+	"open",
+	"merged",
+	"closed"
+]);
+/** Validates one current pull-request status resolved from authorized conversation work. */
+const sessionPullRequestSchema = z.strictObject({
+	changeId: changeIdSchema.describe("Canonical Change represented by this pull request."),
+	repositoryId: repositoryIdSchema.describe("Configured repository containing the pull request."),
+	repository: repositorySlugSchema.describe("Display slug of the configured repository."),
+	number: z.number().int().positive().describe("Provider-owned pull-request number."),
+	url: z.url().describe("Provider URL for the pull request."),
+	state: sessionPullRequestStateSchema.nullable().describe("Current provider lifecycle, or null when no current observation is available."),
+	changeState: changeStateSchema.describe("Current durable Factory Change lifecycle."),
+	verification: z.enum([
+		"pending",
+		"passed",
+		"unknown"
+	]).describe("Factory verification state, kept separate from provider review state."),
+	reviewReadiness: z.enum([
+		"draft",
+		"not_ready",
+		"ready",
+		"complete",
+		"closed",
+		"unknown"
+	]).describe("Factory handoff readiness without implying provider approval or mergeability."),
+	sync: z.enum([
+		"fresh",
+		"stale",
+		"unavailable"
+	]).describe("Freshness of the provider status observation."),
+	observedAt: z.iso.datetime().optional().describe("Time the displayed provider state was last confirmed."),
+	checkedAt: z.iso.datetime().describe("Time the provider status was last checked or attempted."),
+	syncMessage: z.string().max(500).optional().describe("Safe explanation when current provider status could not be confirmed.")
+});
+/** Validates one concise delegated-task row in an operator conversation. */
+const sessionWorkTaskSchema = z.strictObject({
+	taskId: taskIdSchema.describe("Exact Task available in the work inspector."),
+	title: z.string().min(1).max(256).describe("Operator-facing Task title."),
+	agent: z.string().min(1).max(64).describe("Application agent assigned to this Task."),
+	state: taskStateSchema.describe("Current durable Task lifecycle."),
+	attempt: z.number().int().positive().describe("Current Task attempt.")
+});
+/** Validates the single final result presented for one completed conversation request. */
+const sessionWorkResultSchema = z.strictObject({
+	summary: z.string().trim().min(1).max(4e3).describe("Readable description of the completed work."),
+	verification: z.enum([
+		"passed",
+		"failed",
+		"not_required",
+		"unknown"
+	]).describe("Independent verification outcome, separate from pull-request lifecycle."),
+	remainingAction: z.string().trim().min(1).max(1e3).optional().describe("Concrete human action still required after completion, when any.")
+});
+/** Validates delegated progress and its optional final result, grouped by root request identity. */
+const sessionWorkGroupSchema = z.strictObject({
+	requestId: taskIdSchema.describe("Root Task identity used to group retries and child work."),
+	title: z.string().min(1).max(256).describe("Operator-facing root request title."),
+	agent: z.string().min(1).max(64).describe("Application agent assigned to the root request."),
+	state: taskStateSchema.describe("Aggregate durable state of the grouped request."),
+	tasks: z.array(sessionWorkTaskSchema).min(1).readonly().describe("Authorized Tasks belonging to this request."),
+	changeIds: z.array(changeIdSchema).readonly().default([]).describe("Changes produced by Tasks in this request."),
+	result: sessionWorkResultSchema.optional().describe("One final result, present only after required work reaches a terminal state.")
+});
 /** Validates the current operator-facing projection of a Factory session. */
 const sessionViewSchema = z.strictObject({
 	session: agentSessionSchema.describe("Durable interaction binding."),
+	continuation: sessionContinuationSchema.transform(({ context: _context, contextAttachments: _attachments, ...value }) => value).nullable().default(null).describe("Current follow-up request, without cached execution context."),
+	notifications: z.array(communicationEventSchema).readonly().default([]).describe("This page of delivered conversation notifications."),
+	notificationsNextCursor: z.string().nullable().default(null).describe("Continuation for older notifications."),
 	task: taskSchema.nullable().describe("Current task state, if workflow-backed."),
+	finding: findingSchema.nullable().optional().describe("Validated originating finding within the authorized Task and session repository scope."),
 	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."),
+	status: conversationStatusSchema.optional().describe("Current conversation-wide work and human-action status."),
+	statusRevision: z.string().length(64).optional().describe("Opaque revision for status-relevant conversation work."),
 	source: z.string().optional().describe("Original trigger of automatically started work."),
 	prUrl: z.string().optional().describe("Pull request associated with the conversation."),
+	pullRequests: z.array(sessionPullRequestSchema).readonly().default([]).describe("Current pull requests associated with authorized work in this conversation."),
+	pullRequestsTruncated: z.boolean().default(false).describe("Whether association discovery reached its configured work or result bound."),
+	workGroups: z.array(sessionWorkGroupSchema).readonly().default([]).describe("Delegated work grouped by request identity, with at most one final result per request."),
 	attention: z.enum([
 		"question",
 		"failed",
@@ -78,6 +163,8 @@ const sessionViewSchema = z.strictObject({
 	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."),
+	historyNextCursor: z.string().nullable().optional().describe("Continuation for earlier execution history."),
+	relatedTasksNextCursor: z.string().nullable().optional().describe("Continuation for additional related 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."),
@@ -90,7 +177,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."),
+	sessions: z.array(sessionSummarySchema).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.")
 });
@@ -114,6 +201,6 @@ const pendingFollowUpSchema = z.strictObject({
 	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 };
+export { answerSessionQuestionRequestSchema, apiAgentSchema, controlSessionRequestSchema, createSessionRequestSchema, pendingFollowUpSchema, repositoryDetailsSchema, repositorySummarySchema, sendSessionMessageRequestSchema, sessionInputResponseSchema, sessionPageSchema, sessionPullRequestSchema, sessionPullRequestStateSchema, sessionSummarySchema, sessionViewSchema, sessionWorkGroupSchema, sessionWorkResultSchema, sessionWorkTaskSchema, submitSessionInputRequestSchema };
 
 //# sourceMappingURL=api-contracts.mjs.map

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    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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"}
+{"version":3,"file":"api-contracts.mjs","names":[],"sources":["../src/api-contracts.ts"],"sourcesContent":["import { conversationStatusSchema, conversationSummarySchema } from \"./schema/session-summary\";\nimport { findingSchema } from \"./schema/finding\";\nimport { 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  sessionContinuationSchema,\n} from \"./schema/session\";\nimport { changeStateSchema } from \"./schema/change\";\nimport { communicationEventSchema } from \"./schema/communication\";\nimport { taskSchema, taskStateSchema, 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 an operator conversation card with read-only finding metadata for approval work. */\nexport const sessionSummarySchema = conversationSummarySchema.extend({\n  finding: findingSchema\n    .pick({ priority: true, category: true })\n    .nullable()\n    .optional()\n    .describe(\n      \"Finding metadata resolved at read time for approval work; never persisted on the card.\",\n    ),\n});\n/** Compact operator conversation card; full finding evidence is available on SessionView. */\nexport type SessionSummary = z.infer<typeof sessionSummarySchema>;\n\n/** Validates the provider lifecycle reported for a pull request linked to a conversation. */\nexport const sessionPullRequestStateSchema = z.enum([\"draft\", \"open\", \"merged\", \"closed\"]);\n\n/** Validates one current pull-request status resolved from authorized conversation work. */\nexport const sessionPullRequestSchema = z.strictObject({\n  changeId: changeIdSchema.describe(\"Canonical Change represented by this pull request.\"),\n  repositoryId: repositoryIdSchema.describe(\"Configured repository containing the pull request.\"),\n  repository: repositorySlugSchema.describe(\"Display slug of the configured repository.\"),\n  number: z.number().int().positive().describe(\"Provider-owned pull-request number.\"),\n  url: z.url().describe(\"Provider URL for the pull request.\"),\n  state: sessionPullRequestStateSchema\n    .nullable()\n    .describe(\"Current provider lifecycle, or null when no current observation is available.\"),\n  changeState: changeStateSchema.describe(\"Current durable Factory Change lifecycle.\"),\n  verification: z\n    .enum([\"pending\", \"passed\", \"unknown\"])\n    .describe(\"Factory verification state, kept separate from provider review state.\"),\n  reviewReadiness: z\n    .enum([\"draft\", \"not_ready\", \"ready\", \"complete\", \"closed\", \"unknown\"])\n    .describe(\"Factory handoff readiness without implying provider approval or mergeability.\"),\n  sync: z\n    .enum([\"fresh\", \"stale\", \"unavailable\"])\n    .describe(\"Freshness of the provider status observation.\"),\n  observedAt: z.iso\n    .datetime()\n    .optional()\n    .describe(\"Time the displayed provider state was last confirmed.\"),\n  checkedAt: z.iso.datetime().describe(\"Time the provider status was last checked or attempted.\"),\n  syncMessage: z\n    .string()\n    .max(500)\n    .optional()\n    .describe(\"Safe explanation when current provider status could not be confirmed.\"),\n});\n/** Current provider and Factory lifecycle of a pull request linked to a conversation. */\nexport type SessionPullRequest = z.infer<typeof sessionPullRequestSchema>;\n\n/** Validates one concise delegated-task row in an operator conversation. */\nexport const sessionWorkTaskSchema = z.strictObject({\n  taskId: taskIdSchema.describe(\"Exact Task available in the work inspector.\"),\n  title: z.string().min(1).max(256).describe(\"Operator-facing Task title.\"),\n  agent: z.string().min(1).max(64).describe(\"Application agent assigned to this Task.\"),\n  state: taskStateSchema.describe(\"Current durable Task lifecycle.\"),\n  attempt: z.number().int().positive().describe(\"Current Task attempt.\"),\n});\n/** Concise delegated-task progress shown inside a conversation work group. */\nexport type SessionWorkTask = z.infer<typeof sessionWorkTaskSchema>;\n\n/** Validates the single final result presented for one completed conversation request. */\nexport const sessionWorkResultSchema = z.strictObject({\n  summary: z\n    .string()\n    .trim()\n    .min(1)\n    .max(4000)\n    .describe(\"Readable description of the completed work.\"),\n  verification: z\n    .enum([\"passed\", \"failed\", \"not_required\", \"unknown\"])\n    .describe(\"Independent verification outcome, separate from pull-request lifecycle.\"),\n  remainingAction: z\n    .string()\n    .trim()\n    .min(1)\n    .max(1000)\n    .optional()\n    .describe(\"Concrete human action still required after completion, when any.\"),\n});\n/** One application-presented final result derived from validated workflow completion. */\nexport type SessionWorkResult = z.infer<typeof sessionWorkResultSchema>;\n\n/** Validates delegated progress and its optional final result, grouped by root request identity. */\nexport const sessionWorkGroupSchema = z.strictObject({\n  requestId: taskIdSchema.describe(\"Root Task identity used to group retries and child work.\"),\n  title: z.string().min(1).max(256).describe(\"Operator-facing root request title.\"),\n  agent: z.string().min(1).max(64).describe(\"Application agent assigned to the root request.\"),\n  state: taskStateSchema.describe(\"Aggregate durable state of the grouped request.\"),\n  tasks: z\n    .array(sessionWorkTaskSchema)\n    .min(1)\n    .readonly()\n    .describe(\"Authorized Tasks belonging to this request.\"),\n  changeIds: z\n    .array(changeIdSchema)\n    .readonly()\n    .default([])\n    .describe(\"Changes produced by Tasks in this request.\"),\n  result: sessionWorkResultSchema\n    .optional()\n    .describe(\"One final result, present only after required work reaches a terminal state.\"),\n});\n/** Delegated conversation work grouped by its stable root request identity. */\nexport type SessionWorkGroup = z.infer<typeof sessionWorkGroupSchema>;\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  continuation: sessionContinuationSchema\n    .transform(({ context: _context, contextAttachments: _attachments, ...value }) => value)\n    .nullable()\n    .default(null)\n    .describe(\"Current follow-up request, without cached execution context.\"),\n  notifications: z\n    .array(communicationEventSchema)\n    .readonly()\n    .default([])\n    .describe(\"This page of delivered conversation notifications.\"),\n  notificationsNextCursor: z\n    .string()\n    .nullable()\n    .default(null)\n    .describe(\"Continuation for older notifications.\"),\n  task: taskSchema.nullable().describe(\"Current task state, if workflow-backed.\"),\n  finding: findingSchema\n    .nullable()\n    .optional()\n    .describe(\n      \"Validated originating finding within the authorized Task and session repository scope.\",\n    ),\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  status: conversationStatusSchema\n    .optional()\n    .describe(\"Current conversation-wide work and human-action status.\"),\n  statusRevision: z\n    .string()\n    .length(64)\n    .optional()\n    .describe(\"Opaque revision for status-relevant conversation work.\"),\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  pullRequests: z\n    .array(sessionPullRequestSchema)\n    .readonly()\n    .default([])\n    .describe(\"Current pull requests associated with authorized work in this conversation.\"),\n  pullRequestsTruncated: z\n    .boolean()\n    .default(false)\n    .describe(\"Whether association discovery reached its configured work or result bound.\"),\n  workGroups: z\n    .array(sessionWorkGroupSchema)\n    .readonly()\n    .default([])\n    .describe(\n      \"Delegated work grouped by request identity, with at most one final result per request.\",\n    ),\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  historyNextCursor: z\n    .string()\n    .nullable()\n    .optional()\n    .describe(\"Continuation for earlier execution history.\"),\n  relatedTasksNextCursor: z\n    .string()\n    .nullable()\n    .optional()\n    .describe(\"Continuation for additional related work.\"),\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(sessionSummarySchema).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-task-graph.mjs

@@ -7,13 +7,22 @@ var TaskGraphAccessError = class extends Error {
 		this.status = status;
 	}
 };
-async function readSessionGraph(options, session) {
+async function readSessionGraph(options, session, taskId) {
 	const { stores } = options;
-	if (!session.taskId) return {
+	const entryId = taskId ?? session.taskId;
+	if (!entryId) return {
 		rootTaskId: null,
 		nodes: []
 	};
-	const bound = await stores.tasks.get(session.taskId);
+	const bound = await stores.tasks.get(entryId);
+	if (taskId && taskId !== session.taskId) {
+		const original = session.taskId ? await stores.tasks.get(session.taskId) : null;
+		const replyTo = session.external?.replyTo ?? {
+			channel: "api",
+			address: session.id
+		};
+		if (!bound || bound.rootTaskId !== original?.rootTaskId && (bound.replyTo.channel !== replyTo.channel || bound.replyTo.address !== replyTo.address)) throw new TaskGraphAccessError(404, "Task graph not found");
+	}
 	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.");
@@ -33,10 +42,10 @@ async function readSessionGraph(options, session) {
 			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");
+		} else if (task.origin.operator !== session.owner && !(options.canAccessTask ? await options.canAccessTask({ id: session.owner }, task) : options.sharedWorkspaceOwner === session.owner)) 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 continuation = await stores.sessions.getContinuation(context.id, 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 {

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

@@ -1 +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"}
+{"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(\n  options: FactoryApiOptions,\n  session: AgentSession,\n  taskId?: TaskId,\n) {\n  const { stores } = options;\n  const entryId = taskId ?? session.taskId;\n  if (!entryId) return { rootTaskId: null, nodes: [] };\n  const bound = await stores.tasks.get(entryId);\n  if (taskId && taskId !== session.taskId) {\n    const original = session.taskId ? await stores.tasks.get(session.taskId) : null;\n    const replyTo = session.external?.replyTo ?? { channel: \"api\", address: session.id };\n    if (\n      !bound ||\n      (bound.rootTaskId !== original?.rootTaskId &&\n        (bound.replyTo.channel !== replyTo.channel || bound.replyTo.address !== replyTo.address))\n    )\n      throw new TaskGraphAccessError(404, \"Task graph not found\");\n  }\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            !(options.canAccessTask\n              ? await options.canAccessTask({ id: session.owner }, task)\n              : options.sharedWorkspaceOwner === session.owner)\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 = await stores.sessions.getContinuation(context.id, 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,iBACpB,SACA,SACA,QACA;CACA,MAAM,EAAE,WAAW;CACnB,MAAM,UAAU,UAAU,QAAQ;CAClC,IAAI,CAAC,SAAS,OAAO;EAAE,YAAY;EAAM,OAAO,CAAC;CAAE;CACnD,MAAM,QAAQ,MAAM,OAAO,MAAM,IAAI,OAAO;CAC5C,IAAI,UAAU,WAAW,QAAQ,QAAQ;EACvC,MAAM,WAAW,QAAQ,SAAS,MAAM,OAAO,MAAM,IAAI,QAAQ,MAAM,IAAI;EAC3E,MAAM,UAAU,QAAQ,UAAU,WAAW;GAAE,SAAS;GAAO,SAAS,QAAQ;EAAG;EACnF,IACE,CAAC,SACA,MAAM,eAAe,UAAU,eAC7B,MAAM,QAAQ,YAAY,QAAQ,WAAW,MAAM,QAAQ,YAAY,QAAQ,UAElF,MAAM,IAAI,qBAAqB,KAAK,sBAAsB;CAC9D;CACA,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,EAAE,QAAQ,gBACN,MAAM,QAAQ,cAAc,EAAE,IAAI,QAAQ,MAAM,GAAG,IAAI,IACvD,QAAQ,yBAAyB,QAAQ,QAE7C,MAAM,IAAI,qBAAqB,KAAK,sBAAsB;EAE5D,MAAM,UAAU,KAAK,KAAK;EAC1B,MAAM,QAAQ,UAAU,QAAQ,OAAO,IAAI,OAAO,IAAI,KAAA;EACtD,MAAM,eAAe,MAAM,OAAO,SAAS,gBAAgB,QAAQ,IAAI,KAAK,EAAE;EAC9E,MAAM,YACJ,OAAO,UACN,SAAS,OAAO,kBACjB,QAAQ,YAAY,KACpB,cAAc,UAAU,QAAQ,oBAC5B,QAAQ,oBACR,KAAA;EACN,MAAM,QACJ,aAAa,QAAQ,OAAO,MAAM,SAAS,KAAK,OAAO,SAAS,IAAI,YAAY;EAClF,OAAO;GAAE;GAAM,mBAAmB,KAAK;GAAc,SAAS;GAAS;EAAM;CAC/E,CAAC,CACH,CACF;CAEF,OAAO;EAAE,YAAY,MAAM;EAAY;CAAM;AAC/C"}

package/dist/api.d.mts

@@ -1,23 +1,26 @@
+import { ExecutionReference, Task } from "./schema/task.mjs";
+import { AgentRouteRegistry } from "./agent-routes.mjs";
+import { ImageAttachment, imagePartFilename } from "./image-input.mjs";
+import { AgentSession, AgentSessionId, DirectAgentSession, ExternalAgentSession, TaskAgentSession, agentSessionIdSchema, agentSessionSchema } from "./schema/session.mjs";
+import { Change } from "./schema/change.mjs";
+import { Repository, RepositorySlug } from "./schema/repository.mjs";
+import { Signal } from "./schema/signal.mjs";
+import { FactoryStores, ImageInputError, SessionConflictError } from "./store/engine.mjs";
+import { ApprovalStore } from "./store/approvals.mjs";
+import { ConversationStore } from "./store/conversations.mjs";
 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";
-import { AgentRouteRegistry } from "./agent-routes.mjs";
-import { ImageAttachment, imagePartFilename } from "./image-input.mjs";
-import { AgentSession, AgentSessionId, DirectAgentSession, ExternalAgentSession, TaskAgentSession, agentSessionIdSchema, agentSessionSchema } from "./schema/session.mjs";
-import { FactoryStores, ImageInputError, SessionConflictError } from "./store/engine.mjs";
 import { ApiPrincipal } from "./approval-contracts.mjs";
 import { ResolveImageMessageInput, ResolveImageMessageStores, ResolvedImageMessage, ResolvedImageMessagePart, resolveImageMessage } from "./api-images.mjs";
 import { DispatchBudget } from "./dispatch.mjs";
 import { UnavailableWorkspaceDiffInput, WorkspaceDiff, WorkspaceDiffFile, unavailableWorkspaceDiff, workspaceDiffFileSchema, workspaceDiffSchema } from "./workspace-diff.mjs";
 import { WorkspaceSnapshot, workspaceSnapshotSchema, workspaceSnapshotScript } from "./workspace-snapshot.mjs";
 import { WorkspaceBaseBlob, WorkspaceBaseEntry, WorkspaceDiffAssemblyOptions, assembleWorkspaceDiff } from "./workspace-diff-assembly.mjs";
-import { AnswerSessionQuestionRequest, ApiAgent, ApiAgentInput, ControlSessionRequest, CreateSessionRequest, RepositoryDetails, RepositorySummary, SendSessionMessageRequest, SessionInputResponse, SessionPage, SessionView, SubmitSessionInputRequest, answerSessionQuestionRequestSchema, apiAgentSchema, controlSessionRequestSchema, createSessionRequestSchema, repositoryDetailsSchema, repositorySummarySchema, sendSessionMessageRequestSchema, sessionInputResponseSchema, sessionPageSchema, sessionViewSchema, submitSessionInputRequestSchema } from "./api-contracts.mjs";
+import { AnswerSessionQuestionRequest, ApiAgent, ApiAgentInput, ControlSessionRequest, CreateSessionRequest, RepositoryDetails, RepositorySummary, SendSessionMessageRequest, SessionInputResponse, SessionPage, SessionPullRequest, SessionView, SessionWorkGroup, SessionWorkResult, SessionWorkTask, SubmitSessionInputRequest, answerSessionQuestionRequestSchema, apiAgentSchema, controlSessionRequestSchema, createSessionRequestSchema, repositoryDetailsSchema, repositorySummarySchema, sendSessionMessageRequestSchema, sessionInputResponseSchema, sessionPageSchema, sessionPullRequestSchema, sessionPullRequestStateSchema, sessionViewSchema, sessionWorkGroupSchema, sessionWorkResultSchema, sessionWorkTaskSchema, submitSessionInputRequestSchema } from "./api-contracts.mjs";
 //#region src/api.d.ts
 /** Identifies the session launch requested by the Factory HTTP API. */
 interface FactoryApiStartInput {
@@ -57,6 +60,36 @@ interface FactoryApiSessionPreviewsInput {
   readonly tasks: readonly Task[];
   readonly signal: AbortSignal;
 }
+/** Authorized Change and repository supplied to an application pull-request status reader. */
+interface FactoryApiPullRequestStatusTarget {
+  readonly change: Change;
+  readonly repository: Repository;
+}
+/** Authorized pull requests supplied to an application-owned provider status reader. */
+interface FactoryApiPullRequestStatusInput {
+  readonly pullRequests: readonly FactoryApiPullRequestStatusTarget[];
+  readonly signal: AbortSignal;
+}
+/** Current provider observation returned by an application pull-request status reader. */
+interface FactoryApiPullRequestStatus {
+  readonly changeId: Change["id"];
+  readonly state: SessionPullRequest["state"];
+  readonly sync: SessionPullRequest["sync"];
+  readonly checkedAt: string;
+  readonly observedAt?: string;
+  readonly syncMessage?: string;
+}
+/** Authorized terminal request supplied to an application-owned conversation result presenter. */
+interface FactoryApiSessionWorkPresentationInput {
+  /** Root Task that identifies the operator request. */
+  readonly root: Task;
+  /** Authorized root and child Task snapshots in the presented request. */
+  readonly tasks: readonly Task[];
+  /** Current pull requests produced by those Tasks. */
+  readonly pullRequests: readonly SessionPullRequest[];
+}
+/** Application adapter that turns validated terminal workflow output into one readable result. */
+type FactoryApiSessionWorkPresenter = (input: FactoryApiSessionWorkPresentationInput) => Promise<SessionWorkResult | null>;
 /** 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. */
@@ -71,7 +104,12 @@ interface FactoryApiOptions {
   agentModels?: readonly AgentModelConfig[];
   /** Explicit policy for saving shared repository defaults; absent denies mutations. */
   canEditModelDefaults?(principal: ApiPrincipal, repository: Repository): Promise<boolean>;
-  stores: FactoryStores;
+  stores: FactoryStores & {
+    readonly conversations: ConversationStore;
+    readonly approvals: ApprovalStore;
+  };
+  /** Explicit shared workspace grants list visibility to all configured-repository work in this owner scope. */
+  sharedWorkspaceOwner?: string;
   agents: readonly ApiAgentInput[];
   routes: AgentRouteRegistry;
   repositories: readonly RepositorySlug[];
@@ -79,7 +117,9 @@ interface FactoryApiOptions {
   authenticate(request: Request): Promise<ApiPrincipal | Response>;
   /** Exact provider-qualified actors allowed to read and decide approvals. Absent disables approval access. */
   operators?: readonly string[];
-  /** Explicit operator policy for inspecting and controlling external work; absent denies access. */
+  /** Additional external-work policy. Without a shared workspace, absence denies Task access.
+   * Custom predicates are checked on each bounded page; exact listing totals are omitted.
+   */
   canAccessTask?(operator: {
     id: string;
   }, task: Task): Promise<boolean>;
@@ -91,6 +131,7 @@ interface FactoryApiOptions {
     by: string;
   }): Promise<Signal>;
   resumeTask?(task: Task): Promise<ExecutionReference>;
+  /** Admits configured identity during first discovery or creation; must tolerate concurrent calls. */
   ensureRepository(slug: RepositorySlug): Promise<Repository>;
   start(input: FactoryApiStartInput): Promise<ExecutionReference>;
   forward(input: FactoryApiForwardInput): Promise<Response>;
@@ -98,6 +139,12 @@ interface FactoryApiOptions {
   sessionReview?(input: FactoryApiSessionReviewInput): Promise<SessionReview>;
   /** Optional read-only preview reader; owns source selection, link access, expiry, and limits. */
   sessionPreviews?(input: FactoryApiSessionPreviewsInput): Promise<SessionPreviews>;
+  /** Optional provider status reader; may reconcile objective lifecycle observations into application state. */
+  pullRequestStatuses?(input: FactoryApiPullRequestStatusInput): Promise<readonly FactoryApiPullRequestStatus[]>;
+  /** Maximum associated pull requests resolved for one conversation. Defaults to 50, maximum 100. */
+  maxSessionPullRequests?: number;
+  /** Optional application presenter for one final result after a request and its child work finish. */
+  presentSessionWork?: FactoryApiSessionWorkPresenter;
   /** Optional external attention reader; owns caller authorization, sources, caching, and limits. */
   inboxActivity?(input: FactoryApiInboxActivityInput): Promise<InboxActivity>;
   workspaceDiff?(input: FactoryApiWorkspaceDiffInput): Promise<WorkspaceDiff>;
@@ -116,5 +163,5 @@ interface FactoryApi {
 /** Creates the authenticated request handler for the public Factory HTTP API. */
 declare function createFactoryApi(options: FactoryApiOptions): FactoryApi;
 //#endregion
-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 };
+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, FactoryApiPullRequestStatus, FactoryApiPullRequestStatusInput, FactoryApiPullRequestStatusTarget, FactoryApiSessionPreviewsInput, FactoryApiSessionReviewInput, FactoryApiSessionWorkPresentationInput, FactoryApiSessionWorkPresenter, 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 SessionPullRequest, type SessionReview, type SessionReviewCheck, type SessionReviewIssue, type SessionReviewScreenshot, type SessionView, type SessionWorkGroup, type SessionWorkResult, type SessionWorkTask, 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, sessionPullRequestSchema, sessionPullRequestStateSchema, sessionReviewCheckSchema, sessionReviewIssueSchema, sessionReviewSchema, sessionReviewScreenshotSchema, sessionViewSchema, sessionWorkGroupSchema, sessionWorkResultSchema, sessionWorkTaskSchema, submitSessionInputRequestSchema, unavailableWorkspaceDiff, updateModelDefaultsSchema, workspaceDiffFileSchema, workspaceDiffSchema, workspaceFileContentSchema, workspaceFileEntrySchema, workspaceFilesRequestSchema, workspaceFilesSchema, workspaceGitFilesScript, workspacePathSchema, workspaceSnapshotSchema, workspaceSnapshotScript };
 //# sourceMappingURL=api.d.mts.map