@vercel/factory 0.0.16 → 0.0.18

package/dist/client.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"client.mjs","names":[],"sources":["../src/client.ts"],"sourcesContent":["import { inboxActivitySchema, type InboxActivity } from \"./inbox-activity\";\nimport {\n  modelSettingsSchema,\n  updateModelDefaultsSchema,\n  type ModelSettings,\n  type UpdateModelDefaults,\n} from \"./model-settings\";\nexport {\n  agentModelConfigSchema,\n  modelSettingsSchema,\n  updateModelDefaultsSchema,\n} from \"./model-settings\";\nexport type { AgentModelConfig, ModelSettings, UpdateModelDefaults } from \"./model-settings\";\nexport { inboxActivitySchema, inboxActivityItemSchema } from \"./inbox-activity\";\nexport type { InboxActivity, InboxActivityItem } from \"./inbox-activity\";\nimport { sessionPreviewsSchema, type SessionPreviews } from \"./session-previews\";\nexport { sessionPreviewsSchema, sessionPreviewSchema } from \"./session-previews\";\nexport type { SessionPreviews, SessionPreview } from \"./session-previews\";\nimport { sessionReviewSchema, type SessionReview } from \"./session-review\";\nexport {\n  sessionReviewSchema,\n  sessionReviewCheckSchema,\n  sessionReviewScreenshotSchema,\n  sessionReviewIssueSchema,\n} from \"./session-review\";\nexport type {\n  SessionReview,\n  SessionReviewCheck,\n  SessionReviewScreenshot,\n  SessionReviewIssue,\n} from \"./session-review\";\nimport {\n  workspaceFilesRequestSchema,\n  workspaceFilesSchema,\n  type WorkspaceFiles,\n  type WorkspaceFilesRequest,\n} from \"./workspace-files\";\nexport {\n  workspacePathSchema,\n  workspaceFilesRequestSchema,\n  workspaceFileEntrySchema,\n  workspaceFileContentSchema,\n  workspaceFilesSchema,\n} from \"./workspace-files\";\nexport type { WorkspaceFilesRequest, WorkspaceFileEntry, WorkspaceFiles } from \"./workspace-files\";\nimport { intakePageSchema, intakeViewSchema, retryIntakeSchema } from \"./intake-contracts\";\nexport { describeIntake } from \"./intake-contracts\";\nexport type { IntakeView } from \"./intake-contracts\";\nimport {\n  approvalPageSchema,\n  approvalRequestSchema,\n  approvalViewSchema,\n  type ApprovalListOptions,\n  type ApprovalPage,\n  type ApprovalView,\n} from \"./approval-contracts\";\nexport type { ApprovalListOptions, ApprovalPage, ApprovalView } from \"./approval-contracts\";\nimport { z } from \"zod\";\nimport {\n  imageAttachmentSchema,\n  type ImageAttachment,\n  type ImageId,\n  type ImageUploadInput,\n} from \"./image-input\";\nexport {\n  MAX_IMAGE_BYTES,\n  MAX_IMAGES,\n  imageAttachmentSchema,\n  imageAttachmentsSchema,\n  imageIdSchema,\n} from \"./image-input\";\nexport type { ImageAttachment, ImageId, ImageUploadInput } from \"./image-input\";\nimport {\n  answerSessionQuestionRequestSchema,\n  apiAgentSchema,\n  controlSessionRequestSchema,\n  createSessionRequestSchema,\n  repositoryDetailsSchema,\n  sendSessionMessageRequestSchema,\n  sessionPageSchema,\n  sessionViewSchema,\n  submitSessionInputRequestSchema,\n  type AnswerSessionQuestionRequest,\n  type ApiAgent,\n  type ControlSessionRequest,\n  type CreateSessionRequest,\n  type RepositoryDetails,\n  type SendSessionMessageRequest,\n  type SessionPage,\n  type SessionView,\n  type SubmitSessionInputRequest,\n} from \"./api-contracts\";\nimport { changeSchema, type Change } from \"./schema/change\";\nimport type { MaybePromise } from \"./schema/common\";\nimport { taskIdSchema, type RepositoryId, type TaskId } from \"./schema/id\";\nimport { repositorySlugSchema, type RepositorySlug } from \"./schema/repository\";\nimport type { AgentSessionId } from \"./schema/session\";\nimport { workspaceDiffSchema, type WorkspaceDiff } from \"./workspace-diff\";\nimport { taskSchema, taskStateSchema, type Task } from \"./schema/task\";\nimport { taskGraphViewSchema, type TaskGraphView } from \"./task-graph-view\";\nimport { transcriptSnapshotSchema, type TranscriptSnapshot } from \"./schema/transcript\";\nexport type { TaskGraphView } from \"./task-graph-view\";\n\n/** All durable Task states in their schema-defined order. */\nexport const taskStates = Object.freeze([...taskStateSchema.options]);\n\n/** Filters and pagination accepted by the session-list API. */\nexport interface SessionListOptions {\n  readonly scope?: \"all\" | \"interactive\";\n  readonly detail?: \"full\" | \"summary\";\n  readonly limit?: number;\n  readonly cursor?: string;\n  readonly query?: string;\n  readonly repository?: RepositorySlug;\n  readonly agent?: string;\n  readonly source?: \"automatic\";\n  readonly state?: Task[\"state\"] | \"conversation\";\n  readonly attention?: boolean;\n  readonly topLevel?: boolean;\n  readonly includeTotal?: boolean;\n}\n\nexport type { WorkspaceDiff, WorkspaceDiffFile } from \"./workspace-diff\";\nexport { workspaceDiffFileSchema, workspaceDiffSchema } from \"./workspace-diff\";\nexport { agentSessionIdSchema, agentSessionSchema } from \"./schema/session\";\nexport type {\n  AgentSession,\n  AgentSessionId,\n  DirectAgentSession,\n  ExternalAgentSession,\n  TaskAgentSession,\n} from \"./schema/session\";\n\nexport {\n  answerSessionQuestionRequestSchema,\n  pendingFollowUpSchema,\n  apiAgentSchema,\n  controlSessionRequestSchema,\n  createSessionRequestSchema,\n  repositoryDetailsSchema,\n  repositorySummarySchema,\n  sendSessionMessageRequestSchema,\n  sessionInputResponseSchema,\n  sessionPageSchema,\n  sessionViewSchema,\n  submitSessionInputRequestSchema,\n} from \"./api-contracts\";\nexport type {\n  AnswerSessionQuestionRequest,\n  PendingFollowUp,\n  ApiAgent,\n  ControlSessionRequest,\n  CreateSessionRequest,\n  RepositoryDetails,\n  RepositorySummary,\n  SendSessionMessageRequest,\n  SessionInputResponse,\n  SessionPage,\n  SessionView,\n  SubmitSessionInputRequest,\n} from \"./api-contracts\";\nexport { readEvents, streamEventSchema, type StreamEvent } from \"./client-events\";\nexport {\n  Transcript,\n  type InputRequest,\n  type TranscriptBlock,\n  type ToolCall,\n  type TranscriptSnapshot,\n} from \"./client-transcript\";\nexport {\n  inputRequestSchema,\n  toolCallSchema,\n  transcriptBlockSchema,\n  transcriptSnapshotSchema,\n} from \"./schema/transcript\";\nexport {\n  followSessionStream,\n  type FollowSessionStreamOptions,\n  type SessionStreamClient,\n} from \"./client-stream\";\n\n/** An unsuccessful Factory API response surfaced by the browser-safe client. */\nexport class ApiError extends Error {\n  constructor(\n    readonly status: number,\n    message: string,\n    readonly actor?: string,\n  ) {\n    super(message);\n  }\n}\n\n/** Connection and request customization for {@link FactoryClient}. */\nexport interface FactoryClientOptions {\n  /**\n   * Canonical Factory origin. It must be HTTPS, except for HTTP loopback development, and cannot\n   * contain credentials, a path, query parameters, or a fragment.\n   */\n  readonly url: string;\n  /**\n   * Headers resolved immediately before every request, allowing short-lived authentication to be\n   * refreshed. Factory always sets `content-type` to `application/json` afterward.\n   */\n  readonly headers?: () => MaybePromise<HeadersInit>;\n  /** Fetch implementation used for every request; defaults to `globalThis.fetch`. */\n  readonly fetch?: typeof globalThis.fetch;\n}\n\n/** Identifies an uploaded image and optionally controls cancellation of its download. */\nexport interface GetImageOptions {\n  readonly id: ImageId;\n  readonly signal?: AbortSignal;\n}\n\n/** Identifies an operator session and the amount of detail to return. */\nexport interface GetSessionOptions {\n  readonly id: AgentSessionId;\n  readonly detail?: \"full\" | \"summary\";\n}\n\n/** Selects the observed execution whose review evidence should be read. */\nexport interface SessionReviewOptions {\n  readonly sessionId: AgentSessionId;\n  readonly executionId: string | null;\n  readonly signal?: AbortSignal;\n}\n\n/** Selects the observed execution whose preview links and instructions should be read. */\nexport interface SessionPreviewsOptions {\n  readonly sessionId: AgentSessionId;\n  readonly executionId: string | null;\n  readonly signal?: AbortSignal;\n}\n\n/** Identifies the operator session whose canonical task graph should be read. */\nexport interface GetSessionGraphOptions {\n  readonly id: AgentSessionId;\n  readonly signal?: AbortSignal;\n}\n\n/** Identifies an exact task execution transcript within an operator session. */\nexport interface GraphTranscriptOptions {\n  readonly sessionId: AgentSessionId;\n  readonly taskId: TaskId;\n  readonly executionId: string;\n  readonly signal?: AbortSignal;\n}\n\n/** Identifies a file or directory at an observed execution and optional immutable revision. */\nexport interface WorkspaceFilesOptions extends WorkspaceFilesRequest {\n  readonly sessionId: AgentSessionId;\n  readonly executionId: string | null;\n  readonly signal?: AbortSignal;\n}\n\n/** Identifies the execution whose committed workspace should be compared. */\nexport interface WorkspaceDiffOptions {\n  readonly sessionId: AgentSessionId;\n  readonly executionId: string | null;\n  readonly signal?: AbortSignal;\n}\n\n/** Identifies a materialized transcript response used by the stream follower. */\nexport interface SessionTranscriptRequest {\n  readonly sessionId: AgentSessionId;\n  readonly executionId: string;\n  readonly taskId?: TaskId;\n  readonly history?: boolean;\n  readonly signal: AbortSignal;\n}\n\n/** Identifies a cursor-addressed event stream used by the stream follower. */\nexport interface SessionEventStreamRequest {\n  readonly sessionId: AgentSessionId;\n  readonly executionId: string;\n  readonly cursor: number;\n  readonly taskId?: TaskId;\n  readonly signal: AbortSignal;\n}\n\n/**\n * Browser-safe typed client for the public Factory HTTP API.\n *\n * @remarks\n * Requests use same-origin credentials, bypass HTTP caches, and refuse redirects so authentication\n * redirects cannot be mistaken for API responses. When no caller signal is available, requests\n * time out after 30 seconds. Non-success responses throw {@link ApiError}; successful JSON bodies\n * are still validated against their public schemas before being returned.\n */\nexport class FactoryClient {\n  private readonly origin: string;\n  /**\n   * Creates a client for one canonical Factory origin without performing a request.\n   *\n   * @param options - Factory origin plus optional per-request headers and fetch implementation.\n   * @throws When `options.url` is not an HTTPS origin or an HTTP loopback origin.\n   */\n  constructor(private readonly options: FactoryClientOptions) {\n    const url = new URL(options.url);\n    if (\n      url.username ||\n      url.password ||\n      url.pathname !== \"/\" ||\n      url.search ||\n      url.hash ||\n      (url.protocol !== \"https:\" &&\n        !(url.protocol === \"http:\" && [\"localhost\", \"127.0.0.1\", \"[::1]\"].includes(url.hostname)))\n    ) {\n      throw new Error(\"Factory URL must be an HTTPS origin, or HTTP on loopback\");\n    }\n    this.origin = url.origin;\n  }\n\n  private async response(path: string, body?: unknown, signal?: AbortSignal): Promise<Response> {\n    const url = new URL(`/api/v1/${path}`, this.origin);\n    if (url.origin !== this.origin || !url.pathname.startsWith(\"/api/v1/\"))\n      throw new Error(\"Invalid Factory API path\");\n    const headers = new Headers(await this.options.headers?.());\n    headers.set(\"content-type\", \"application/json\");\n    const response = await (this.options.fetch ?? globalThis.fetch)(url.href, {\n      method: body === undefined ? \"GET\" : \"POST\",\n      headers,\n      ...(body === undefined ? {} : { body: JSON.stringify(body) }),\n      credentials: \"same-origin\",\n      cache: \"no-store\",\n      redirect: \"manual\",\n      signal: signal ?? AbortSignal.timeout(30_000),\n    });\n    if (response.type === \"opaqueredirect\" || [301, 302, 303, 307, 308].includes(response.status)) {\n      await response.body?.cancel();\n      throw new ApiError(\n        response.status,\n        `Factory at ${this.origin} returned a redirect. Reload to sign in, or set factory.url to the factory's canonical origin. Redirects are not followed.`,\n      );\n    }\n    if (!response.ok) {\n      const value: unknown = await response.json().catch(() => null);\n      const detail =\n        value !== null &&\n        typeof value === \"object\" &&\n        \"error\" in value &&\n        typeof value.error === \"string\"\n          ? value.error\n          : `HTTP ${response.status}`;\n      const actor =\n        value !== null &&\n        typeof value === \"object\" &&\n        \"actor\" in value &&\n        typeof value.actor === \"string\"\n          ? value.actor\n          : undefined;\n      throw new ApiError(\n        response.status,\n        response.status === 401\n          ? \"Authentication rejected. Reload to sign in, or run vercel login for the terminal client.\"\n          : detail,\n        actor,\n      );\n    }\n    return response;\n  }\n\n  /** Read authorized intake and pre-task triage failures. */\n  async intake(options: { repository?: string; cursor?: string; limit?: number } = {}) {\n    const query = new URLSearchParams();\n    for (const [key, value] of Object.entries(options))\n      if (value !== undefined) query.set(key, String(value));\n    return intakePageSchema.parse(await (await this.response(`intake?${query}`)).json());\n  }\n\n  /** Retry only the observed stopped attempt; concurrent or stale retries conflict. */\n  async retryIntake(id: string, expectedAttempt: number) {\n    return intakeViewSchema.parse(\n      await (\n        await this.response(\n          `intake/${encodeURIComponent(id)}/retry`,\n          retryIntakeSchema.parse({ expectedAttempt }),\n        )\n      ).json(),\n    );\n  }\n\n  /** Lists approval proposals visible to the authenticated operator. */\n  async listApprovals(options: ApprovalListOptions = {}): Promise<ApprovalPage> {\n    const query = new URLSearchParams(\n      Object.entries(options)\n        .filter(([, value]) => value !== undefined)\n        .map(([key, value]) => [key, String(value)]),\n    );\n    return approvalPageSchema.parse(await (await this.response(`approvals?${query}`)).json());\n  }\n  /** Reads one approval proposal by Task ID. */\n  async getApproval(id: TaskId): Promise<ApprovalView> {\n    return approvalViewSchema.parse(\n      await (await this.response(`tasks/${encodeURIComponent(id)}/approval`)).json(),\n    );\n  }\n  /** Approves one proposal, optionally recording an operator reason. */\n  async approveTask(id: TaskId, reason?: string): Promise<ApprovalView> {\n    return approvalViewSchema.parse(\n      await (\n        await this.response(\n          `tasks/${encodeURIComponent(id)}/approve`,\n          approvalRequestSchema.parse({ reason }),\n        )\n      ).json(),\n    );\n  }\n\n  /** Rejects one proposal with the required operator reason. */\n  async rejectTask(id: TaskId, reason: string): Promise<ApprovalView> {\n    return approvalViewSchema.parse(\n      await (\n        await this.response(\n          `tasks/${encodeURIComponent(id)}/reject`,\n          approvalRequestSchema.parse({ reason }),\n        )\n      ).json(),\n    );\n  }\n\n  /** Uploads one bounded image for use in a later message. */\n  async uploadImage(input: ImageUploadInput): Promise<ImageAttachment> {\n    return imageAttachmentSchema.parse(await (await this.response(\"images\", input)).json());\n  }\n  /** Downloads a previously uploaded image. */\n  async getImage(options: GetImageOptions): Promise<Blob> {\n    return (\n      await this.response(`images/${encodeURIComponent(options.id)}`, undefined, options.signal)\n    ).blob();\n  }\n\n  /** Lists agents exposed for operator session creation. */\n  async listAgents(): Promise<readonly ApiAgent[]> {\n    return z\n      .object({ agents: z.array(apiAgentSchema).readonly() })\n      .parse(await (await this.response(\"agents\")).json()).agents;\n  }\n  /** Reports whether the configured origin is the isolated local fixture runtime. */\n  async isLocalTestRuntime(): Promise<boolean> {\n    const response = await this.response(\"agents\");\n    const local = response.headers.get(\"x-factory-local-test\") === \"1\";\n    await response.body?.cancel();\n    return local;\n  }\n  /** Lists configured repository slugs. */\n  async listRepositories(): Promise<readonly RepositorySlug[]> {\n    return z\n      .object({ repositories: z.array(repositorySlugSchema).readonly() })\n      .parse(await (await this.response(\"repositories\")).json()).repositories;\n  }\n  /** Reads repository slugs together with their stable configured identifiers. */\n  async getRepositoryDetails(): Promise<RepositoryDetails> {\n    return repositoryDetailsSchema.parse(await (await this.response(\"repositories\")).json());\n  }\n  /** Lists open Changes, optionally scoped to one repository slug. */\n  async listChanges(repository?: RepositorySlug): Promise<readonly Change[]> {\n    return z\n      .object({ changes: z.array(changeSchema).readonly() })\n      .parse(\n        await (\n          await this.response(\n            repository === undefined\n              ? \"changes\"\n              : `changes?repository=${encodeURIComponent(repository)}`,\n          )\n        ).json(),\n      ).changes;\n  }\n  /** Lists canonical Tasks exposed by the operator API. */\n  async listTasks(): Promise<readonly Task[]> {\n    return z\n      .strictObject({ tasks: z.array(taskSchema).readonly() })\n      .parse(await (await this.response(\"tasks\")).json()).tasks;\n  }\n  /**\n   * Lists sessions matching the requested operator scope without pagination metadata.\n   *\n   * @param options - Optional scope and detail projection; both use their server defaults when omitted.\n   * @returns The first matching page's sessions. Use {@link getSessionPage} to follow cursors.\n   */\n  async listSessions(\n    options: Pick<SessionListOptions, \"scope\" | \"detail\"> = {},\n  ): Promise<readonly SessionView[]> {\n    return (await this.getSessionPage(options)).sessions;\n  }\n  /**\n   * Reads a filtered, cursor-paginated page of sessions.\n   *\n   * @param options - Filters, cursor, projection detail, and page limit sent to the API.\n   * @returns The validated page, including its continuation cursor and optional total count.\n   */\n  async getSessionPage(options: SessionListOptions = {}): Promise<SessionPage> {\n    const query = new URLSearchParams(\n      Object.entries(options)\n        .filter(([, value]) => value !== undefined)\n        .map(([key, value]) => [key, String(value)]),\n    ).toString();\n    return sessionPageSchema.parse(\n      await (await this.response(`sessions${query ? `?${query}` : \"\"}`)).json(),\n    );\n  }\n  /** Reads application-owned external work requiring operator attention. */\n  async getInboxActivity(): Promise<InboxActivity> {\n    return inboxActivitySchema.parse(await (await this.response(\"inbox-activity\")).json());\n  }\n  /** Reads application model choices and optional repository defaults. */\n  async getModelSettings(repository?: RepositorySlug): Promise<ModelSettings> {\n    const query = repository ? `?${new URLSearchParams({ repository })}` : \"\";\n    return modelSettingsSchema.parse(await (await this.response(`models${query}`)).json());\n  }\n  /** Saves repository defaults only when their observed revision still matches. */\n  async updateModelDefaults(input: UpdateModelDefaults): Promise<ModelSettings> {\n    return modelSettingsSchema.parse(\n      await (await this.response(\"models\", updateModelDefaultsSchema.parse(input))).json(),\n    );\n  }\n  /** Counts sessions that currently require operator attention. */\n  async getInboxCount(): Promise<number> {\n    return z\n      .object({ totalCount: z.number().int().nonnegative() })\n      .parse(\n        await (\n          await this.response(\n            \"sessions?scope=all&detail=summary&attention=true&includeTotal=true&limit=1\",\n          )\n        ).json(),\n      ).totalCount;\n  }\n  /** Reads a summary batch for the provided session IDs. */\n  async getSessionBatch(ids: readonly AgentSessionId[]): Promise<readonly SessionView[]> {\n    if (ids.length === 0) return [];\n    const query = new URLSearchParams({ ids: ids.join(\",\"), detail: \"summary\" });\n    return z\n      .object({ sessions: z.array(sessionViewSchema).readonly() })\n      .parse(await (await this.response(`sessions?${query}`)).json()).sessions;\n  }\n  /**\n   * Reads one operator session.\n   *\n   * @param options - Stable session ID and optional summary or full projection.\n   * @returns The current validated session view; it is a snapshot and does not follow live events.\n   */\n  async getSession(options: GetSessionOptions): Promise<SessionView> {\n    return sessionViewSchema.parse(\n      await (\n        await this.response(\n          `sessions/${encodeURIComponent(options.id)}${options.detail ? `?detail=${options.detail}` : \"\"}`,\n        )\n      ).json(),\n    );\n  }\n  /** Reads the canonical task graph projected for one session. */\n  async getSessionGraph(options: GetSessionGraphOptions): Promise<TaskGraphView> {\n    return taskGraphViewSchema.parse(\n      await (\n        await this.response(\n          `sessions/${encodeURIComponent(options.id)}/graph`,\n          undefined,\n          options.signal,\n        )\n      ).json(),\n    );\n  }\n  /** Reads the materialized transcript for one exact graph task execution. */\n  async getGraphTranscript(options: GraphTranscriptOptions): Promise<TranscriptSnapshot> {\n    const query = new URLSearchParams({\n      taskId: options.taskId,\n      executionId: options.executionId,\n    });\n    return transcriptSnapshotSchema.parse(\n      await (\n        await this.response(\n          `sessions/${encodeURIComponent(options.sessionId)}/graph-transcript?${query}`,\n          undefined,\n          options.signal,\n        )\n      ).json(),\n    );\n  }\n  /** Refreshes a session summary and reloads its history when the active execution changes. */\n  async refreshSession(previous: SessionView): Promise<SessionView> {\n    const current = await this.getSession({ id: previous.session.id, detail: \"summary\" });\n    if (\n      current.task?.id !== previous.task?.id ||\n      current.execution?.sessionId !== previous.execution?.sessionId ||\n      current.execution?.provider !== previous.execution?.provider\n    )\n      return this.getSession({ id: previous.session.id });\n    return { ...current, history: previous.history };\n  }\n  /** Reads application-owned previews without starting an agent, deployment, or server. */\n  async getSessionPreviews(options: SessionPreviewsOptions): Promise<SessionPreviews> {\n    return sessionPreviewsSchema.parse(\n      await (\n        await this.response(\n          `sessions/${encodeURIComponent(options.sessionId)}/previews?${new URLSearchParams({ executionId: options.executionId ?? \"\" })}`,\n          undefined,\n          options.signal,\n        )\n      ).json(),\n    );\n  }\n  /** Reads recorded checks, screenshots, and issues through the application's review reader. */\n  async getSessionReview(options: SessionReviewOptions): Promise<SessionReview> {\n    return sessionReviewSchema.parse(\n      await (\n        await this.response(\n          `sessions/${encodeURIComponent(options.sessionId)}/review?${new URLSearchParams({ executionId: options.executionId ?? \"\" })}`,\n          undefined,\n          options.signal,\n        )\n      ).json(),\n    );\n  }\n  /** Reads a directory or complete file through the factory's configured workspace adapter. */\n  async getWorkspaceFiles(options: WorkspaceFilesOptions): Promise<WorkspaceFiles> {\n    const query = workspaceFilesRequestSchema.parse({\n      path: options.path,\n      revision: options.revision,\n    });\n    const params = new URLSearchParams({\n      executionId: options.executionId ?? \"\",\n      path: query.path,\n    });\n    if (query.revision !== undefined) params.set(\"revision\", query.revision);\n    return workspaceFilesSchema.parse(\n      await (\n        await this.response(\n          `sessions/${encodeURIComponent(options.sessionId)}/files?${params}`,\n          undefined,\n          options.signal,\n        )\n      ).json(),\n    );\n  }\n  /** Reads the committed workspace comparison for one observed execution. */\n  async getWorkspaceDiff(options: WorkspaceDiffOptions): Promise<WorkspaceDiff> {\n    return workspaceDiffSchema.parse(\n      await (\n        await this.response(\n          `sessions/${encodeURIComponent(options.sessionId)}/diff?${new URLSearchParams({ executionId: options.executionId ?? \"\" })}`,\n          undefined,\n          options.signal,\n        )\n      ).json(),\n    );\n  }\n  /**\n   * Creates or recovers an idempotent conversational session.\n   *\n   * @remarks\n   * Retain `input.operationId` unchanged across ambiguous failures. Reusing it with identical input\n   * returns the original session; reusing it with different input is a conflict. The returned view\n   * means admission and any initial dispatch attempt finished, not that the agent's work completed.\n   *\n   * @param input - Agent, initial content, optional repository/change, and client idempotency key.\n   * @returns The admitted or recovered session snapshot.\n   */\n  async createSession(input: CreateSessionRequest): Promise<SessionView> {\n    return sessionViewSchema.parse(\n      await (await this.response(\"sessions\", createSessionRequestSchema.parse(input))).json(),\n    );\n  }\n\n  /** Creates or recovers idempotent workflow work through a specialist signal. */\n  async createSignal(input: CreateSessionRequest): Promise<SessionView> {\n    return sessionViewSchema.parse(\n      await (await this.response(\"signals\", createSessionRequestSchema.parse(input))).json(),\n    );\n  }\n\n  /** Starts a deepsec security scan of a repository, or returns its already-active scan. */\n  async runSecurityScan(repositoryId: RepositoryId): Promise<{ taskId: TaskId; reused: boolean }> {\n    return z\n      .strictObject({ taskId: taskIdSchema, reused: z.boolean() })\n      .parse(await (await this.response(`repositories/${repositoryId}/security-scan`, {})).json());\n  }\n\n  /**\n   * Sends a message to an existing session using optimistic execution matching.\n   *\n   * @remarks\n   * `input.executionId` must be the execution the caller observed, or `null` when none was active.\n   * A completed Task follow-up also requires an `operationId`, which must be retained for retries.\n   * Resolving means the API accepted the message; provider or follow-up work may still be running.\n   *\n   * @param id - Stable Factory session receiving the message.\n   * @param input - Message, observed execution, steering policy, attachments, and optional retry key.\n   * @returns Nothing after the API accepts the request.\n   */\n  async sendSessionMessage(id: AgentSessionId, input: SendSessionMessageRequest): Promise<void> {\n    const response = await this.response(\n      `sessions/${encodeURIComponent(id)}/messages`,\n      sendSessionMessageRequestSchema.parse(input),\n    );\n    await response.body?.cancel();\n  }\n\n  /**\n   * Submits responses to pending provider input requests.\n   *\n   * @param id - Stable Factory session whose provider requested input.\n   * @param input - Observed execution ID and one or more request-correlated responses.\n   * @returns Nothing after the API accepts the responses; stale execution IDs are rejected.\n   */\n  async submitSessionInput(id: AgentSessionId, input: SubmitSessionInputRequest): Promise<void> {\n    const response = await this.response(\n      `sessions/${encodeURIComponent(id)}/input`,\n      submitSessionInputRequestSchema.parse(input),\n    );\n    await response.body?.cancel();\n  }\n\n  /**\n   * Attempts to dispatch queued workflow work associated with a session.\n   *\n   * @param id - Stable Factory session whose current work should be dispatched.\n   * @returns The refreshed session after the bounded dispatch attempt, which may still be queued.\n   */\n  async dispatchSession(id: AgentSessionId): Promise<SessionView> {\n    return sessionViewSchema.parse(\n      await (await this.response(`sessions/${encodeURIComponent(id)}/dispatch`, {})).json(),\n    );\n  }\n\n  /** Answers a workflow question associated with a session. */\n  async answerSessionQuestion(\n    id: AgentSessionId,\n    input: AnswerSessionQuestionRequest,\n  ): Promise<SessionView> {\n    return sessionViewSchema.parse(\n      await (\n        await this.response(\n          `sessions/${encodeURIComponent(id)}/answer`,\n          answerSessionQuestionRequestSchema.parse(input),\n        )\n      ).json(),\n    );\n  }\n\n  /** Cooperatively interrupts the currently observed turn. */\n  async interruptSession(id: AgentSessionId, input: ControlSessionRequest = {}): Promise<void> {\n    return this.controlSession(id, \"interrupt\", input);\n  }\n\n  /** Cancels active workflow and provider work in a session. */\n  async cancelSession(id: AgentSessionId, input: ControlSessionRequest = {}): Promise<void> {\n    return this.controlSession(id, \"cancel\", input);\n  }\n\n  /** Compacts the provider context for a session. */\n  async compactSession(id: AgentSessionId, input: ControlSessionRequest = {}): Promise<void> {\n    return this.controlSession(id, \"compact\", input);\n  }\n\n  /** Clears the provider context for a session. */\n  async clearSession(id: AgentSessionId, input: ControlSessionRequest = {}): Promise<void> {\n    return this.controlSession(id, \"clear\", input);\n  }\n\n  /** Resets a session after cancelling its active work. */\n  async resetSession(id: AgentSessionId, input: ControlSessionRequest = {}): Promise<void> {\n    return this.controlSession(id, \"reset\", input);\n  }\n\n  /** Reads a materialized transcript as a raw HTTP response for incremental following. */\n  async getSessionTranscriptResponse(input: SessionTranscriptRequest): Promise<Response> {\n    const query = new URLSearchParams({ executionId: input.executionId });\n    if (input.history === true) query.set(\"history\", \"1\");\n    if (input.taskId !== undefined) query.set(\"taskId\", input.taskId);\n    return this.response(\n      `sessions/${encodeURIComponent(input.sessionId)}/${input.taskId ? \"graph-transcript\" : \"transcript\"}?${query}`,\n      undefined,\n      input.signal,\n    );\n  }\n\n  /** Opens a cursor-addressed session event stream as a raw HTTP response. */\n  async getSessionEventStreamResponse(input: SessionEventStreamRequest): Promise<Response> {\n    const query = new URLSearchParams({\n      executionId: input.executionId,\n      startIndex: String(input.cursor),\n    });\n    if (input.taskId !== undefined) query.set(\"taskId\", input.taskId);\n    return this.response(\n      `sessions/${encodeURIComponent(input.sessionId)}/${input.taskId ? \"graph-stream\" : \"stream\"}?${query}`,\n      undefined,\n      input.signal,\n    );\n  }\n\n  private async controlSession(\n    id: AgentSessionId,\n    action: \"interrupt\" | \"cancel\" | \"compact\" | \"clear\" | \"reset\",\n    input: ControlSessionRequest,\n  ): Promise<void> {\n    const response = await this.response(\n      `sessions/${encodeURIComponent(id)}/${action}`,\n      controlSessionRequestSchema.parse(input),\n    );\n    await response.body?.cancel();\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"client.mjs","names":[],"sources":["../src/client.ts"],"sourcesContent":["import { sessionSummarySchema, type SessionSummary } from \"./api-contracts\";\nexport { sessionSummarySchema } from \"./api-contracts\";\nexport { sessionTaskSummarySchema } from \"./schema/session-summary\";\nexport type { SessionSummary } from \"./api-contracts\";\nexport type { SessionTaskSummary } from \"./schema/session-summary\";\nimport { inboxActivitySchema, type InboxActivity } from \"./inbox-activity\";\nimport {\n  modelSettingsSchema,\n  updateModelDefaultsSchema,\n  type ModelSettings,\n  type UpdateModelDefaults,\n} from \"./model-settings\";\nexport {\n  agentModelConfigSchema,\n  modelSettingsSchema,\n  updateModelDefaultsSchema,\n} from \"./model-settings\";\nexport type { AgentModelConfig, ModelSettings, UpdateModelDefaults } from \"./model-settings\";\nexport { inboxActivitySchema, inboxActivityItemSchema } from \"./inbox-activity\";\nexport type { InboxActivity, InboxActivityItem } from \"./inbox-activity\";\nimport { sessionPreviewsSchema, type SessionPreviews } from \"./session-previews\";\nexport { sessionPreviewsSchema, sessionPreviewSchema } from \"./session-previews\";\nexport type { SessionPreviews, SessionPreview } from \"./session-previews\";\nimport { sessionReviewSchema, type SessionReview } from \"./session-review\";\nexport {\n  sessionReviewSchema,\n  sessionReviewCheckSchema,\n  sessionReviewScreenshotSchema,\n  sessionReviewIssueSchema,\n} from \"./session-review\";\nexport type {\n  SessionReview,\n  SessionReviewCheck,\n  SessionReviewScreenshot,\n  SessionReviewIssue,\n} from \"./session-review\";\nimport {\n  workspaceFilesRequestSchema,\n  workspaceFilesSchema,\n  type WorkspaceFiles,\n  type WorkspaceFilesRequest,\n} from \"./workspace-files\";\nexport {\n  workspacePathSchema,\n  workspaceFilesRequestSchema,\n  workspaceFileEntrySchema,\n  workspaceFileContentSchema,\n  workspaceFilesSchema,\n} from \"./workspace-files\";\nexport type { WorkspaceFilesRequest, WorkspaceFileEntry, WorkspaceFiles } from \"./workspace-files\";\nimport { intakePageSchema, intakeViewSchema, retryIntakeSchema } from \"./intake-contracts\";\nexport { describeIntake } from \"./intake-contracts\";\nexport type { IntakeView } from \"./intake-contracts\";\nimport {\n  approvalPageSchema,\n  approvalRequestSchema,\n  approvalViewSchema,\n  type ApprovalListOptions,\n  type ApprovalPage,\n  type ApprovalView,\n} from \"./approval-contracts\";\nexport type { ApprovalListOptions, ApprovalPage, ApprovalView } from \"./approval-contracts\";\nimport { z } from \"zod\";\nimport {\n  imageAttachmentSchema,\n  type ImageAttachment,\n  type ImageId,\n  type ImageUploadInput,\n} from \"./image-input\";\nexport {\n  MAX_IMAGE_BYTES,\n  MAX_IMAGES,\n  imageAttachmentSchema,\n  imageAttachmentsSchema,\n  imageIdSchema,\n} from \"./image-input\";\nexport type { ImageAttachment, ImageId, ImageUploadInput } from \"./image-input\";\nimport {\n  answerSessionQuestionRequestSchema,\n  apiAgentSchema,\n  controlSessionRequestSchema,\n  createSessionRequestSchema,\n  repositoryDetailsSchema,\n  sendSessionMessageRequestSchema,\n  sessionPageSchema,\n  sessionViewSchema,\n  submitSessionInputRequestSchema,\n  type AnswerSessionQuestionRequest,\n  type ApiAgent,\n  type ControlSessionRequest,\n  type CreateSessionRequest,\n  type RepositoryDetails,\n  type SendSessionMessageRequest,\n  type SessionPage,\n  type SessionView,\n  type SubmitSessionInputRequest,\n} from \"./api-contracts\";\nimport { changeSchema } from \"./schema/change\";\nimport type { MaybePromise } from \"./schema/common\";\nimport { taskIdSchema, type RepositoryId, type TaskId } from \"./schema/id\";\nimport { repositorySlugSchema, type RepositorySlug } from \"./schema/repository\";\nimport type { AgentSessionId } from \"./schema/session\";\nimport { workspaceDiffSchema, type WorkspaceDiff } from \"./workspace-diff\";\nimport { taskSchema, taskStateSchema, type Task } from \"./schema/task\";\nimport { taskGraphViewSchema, type TaskGraphView } from \"./task-graph-view\";\nimport {\n  transcriptBlockSchema,\n  transcriptPageSchema,\n  type TranscriptBlock,\n  type TranscriptPage,\n  type TranscriptSnapshot,\n} from \"./schema/transcript\";\nexport type { TaskGraphView } from \"./task-graph-view\";\n\n/** All durable Task states in their schema-defined order. */\nexport const taskStates = Object.freeze([...taskStateSchema.options]);\n\n/** Filters and pagination accepted by the session-list API. */\nexport interface SessionListOptions {\n  readonly scope?: \"all\" | \"interactive\";\n  readonly detail?: \"full\" | \"summary\";\n  readonly limit?: number;\n  readonly cursor?: string;\n  readonly query?: string;\n  readonly repository?: RepositorySlug;\n  readonly agent?: string;\n  readonly source?: \"automatic\";\n  readonly state?: Task[\"state\"] | \"conversation\";\n  readonly attention?: boolean;\n  readonly topLevel?: boolean;\n  readonly includeTotal?: boolean;\n}\n\nexport type { WorkspaceDiff, WorkspaceDiffFile } from \"./workspace-diff\";\nexport { workspaceDiffFileSchema, workspaceDiffSchema } from \"./workspace-diff\";\nexport { agentSessionIdSchema, agentSessionSchema } from \"./schema/session\";\nexport type {\n  AgentSession,\n  AgentSessionId,\n  DirectAgentSession,\n  ExternalAgentSession,\n  TaskAgentSession,\n} from \"./schema/session\";\n\nexport {\n  answerSessionQuestionRequestSchema,\n  pendingFollowUpSchema,\n  apiAgentSchema,\n  controlSessionRequestSchema,\n  createSessionRequestSchema,\n  repositoryDetailsSchema,\n  repositorySummarySchema,\n  sendSessionMessageRequestSchema,\n  sessionInputResponseSchema,\n  sessionPageSchema,\n  sessionPullRequestSchema,\n  sessionPullRequestStateSchema,\n  sessionWorkGroupSchema,\n  sessionWorkResultSchema,\n  sessionWorkTaskSchema,\n  sessionViewSchema,\n  submitSessionInputRequestSchema,\n} from \"./api-contracts\";\nexport type {\n  AnswerSessionQuestionRequest,\n  PendingFollowUp,\n  ApiAgent,\n  ControlSessionRequest,\n  CreateSessionRequest,\n  RepositoryDetails,\n  RepositorySummary,\n  SendSessionMessageRequest,\n  SessionInputResponse,\n  SessionPage,\n  SessionPullRequest,\n  SessionWorkGroup,\n  SessionWorkResult,\n  SessionWorkTask,\n  SessionView,\n  SubmitSessionInputRequest,\n} from \"./api-contracts\";\nexport { readEvents, streamEventSchema, type StreamEvent } from \"./client-events\";\nexport {\n  Transcript,\n  type InputRequest,\n  type TranscriptBlock,\n  type ToolCall,\n  type TranscriptSnapshot,\n  type TranscriptHistoryPage,\n} from \"./client-transcript\";\nexport {\n  inputRequestSchema,\n  toolCallSchema,\n  transcriptBlockSchema,\n  transcriptSnapshotSchema,\n  transcriptPageSchema,\n} from \"./schema/transcript\";\nexport type { TranscriptPage, TranscriptPageQuery } from \"./schema/transcript\";\nexport {\n  followSessionStream,\n  loadPreviousTranscriptPage,\n  expandTranscriptBlock,\n  type FollowSessionStreamOptions,\n  type SessionStreamClient,\n} from \"./client-stream\";\n\n/** An unsuccessful Factory API response surfaced by the browser-safe client. */\nexport class ApiError extends Error {\n  constructor(\n    readonly status: number,\n    message: string,\n    readonly actor?: string,\n  ) {\n    super(message);\n  }\n}\n\n/** Connection and request customization for {@link FactoryClient}. */\nexport interface FactoryClientOptions {\n  /**\n   * Canonical Factory origin. It must be HTTPS, except for HTTP loopback development, and cannot\n   * contain credentials, a path, query parameters, or a fragment.\n   */\n  readonly url: string;\n  /**\n   * Headers resolved immediately before every request, allowing short-lived authentication to be\n   * refreshed. Factory always sets `content-type` to `application/json` afterward.\n   */\n  readonly headers?: () => MaybePromise<HeadersInit>;\n  /** Fetch implementation used for every request; defaults to `globalThis.fetch`. */\n  readonly fetch?: typeof globalThis.fetch;\n}\n\n/** Identifies an uploaded image and optionally controls cancellation of its download. */\nexport interface GetImageOptions {\n  readonly id: ImageId;\n  readonly signal?: AbortSignal;\n}\n\n/** Identifies an operator session and the amount of detail to return. */\nexport interface GetSessionOptions {\n  readonly id: AgentSessionId;\n  readonly detail?: \"full\" | \"summary\";\n}\n\n/** Selects the observed execution whose review evidence should be read. */\nexport interface SessionReviewOptions {\n  readonly sessionId: AgentSessionId;\n  readonly executionId: string | null;\n  readonly signal?: AbortSignal;\n}\n\n/** Selects the observed execution whose preview links and instructions should be read. */\nexport interface SessionPreviewsOptions {\n  readonly sessionId: AgentSessionId;\n  readonly executionId: string | null;\n  readonly signal?: AbortSignal;\n}\n\n/** Identifies the operator session whose canonical task graph should be read. */\nexport interface GetSessionGraphOptions {\n  readonly id: AgentSessionId;\n  /** Selects a Task in the bound graph or work addressed to this conversation. */\n  readonly taskId?: TaskId;\n  readonly signal?: AbortSignal;\n}\n\n/** Identifies an exact task execution transcript within an operator session. */\nexport interface GraphTranscriptOptions {\n  readonly sessionId: AgentSessionId;\n  readonly taskId: TaskId;\n  readonly executionId: string;\n  readonly signal?: AbortSignal;\n}\n\n/** Identifies a file or directory at an observed execution and optional immutable revision. */\nexport interface WorkspaceFilesOptions extends WorkspaceFilesRequest {\n  readonly sessionId: AgentSessionId;\n  readonly executionId: string | null;\n  readonly signal?: AbortSignal;\n}\n\n/** Identifies the execution whose committed workspace should be compared. */\nexport interface WorkspaceDiffOptions {\n  readonly sessionId: AgentSessionId;\n  readonly executionId: string | null;\n  readonly signal?: AbortSignal;\n}\n\n/** Identifies a materialized transcript response used by the stream follower. */\nexport interface SessionTranscriptRequest {\n  readonly sessionId: AgentSessionId;\n  readonly executionId: string;\n  readonly taskId?: TaskId;\n  readonly history?: boolean;\n  readonly limit?: number;\n  readonly cursor?: string;\n  readonly blockId?: string;\n  readonly signal: AbortSignal;\n}\n\n/** Identifies a cursor-addressed event stream used by the stream follower. */\nexport interface SessionEventStreamRequest {\n  readonly sessionId: AgentSessionId;\n  readonly executionId: string;\n  readonly cursor: number;\n  readonly taskId?: TaskId;\n  readonly signal: AbortSignal;\n}\n\n/**\n * Browser-safe typed client for the public Factory HTTP API.\n *\n * @remarks\n * Requests use same-origin credentials, bypass HTTP caches, and refuse redirects so authentication\n * redirects cannot be mistaken for API responses. When no caller signal is available, requests\n * time out after 30 seconds. Non-success responses throw {@link ApiError}; successful JSON bodies\n * are still validated against their public schemas before being returned.\n */\nexport class FactoryClient {\n  private readonly origin: string;\n  /**\n   * Creates a client for one canonical Factory origin without performing a request.\n   *\n   * @param options - Factory origin plus optional per-request headers and fetch implementation.\n   * @throws When `options.url` is not an HTTPS origin or an HTTP loopback origin.\n   */\n  constructor(private readonly options: FactoryClientOptions) {\n    const url = new URL(options.url);\n    if (\n      url.username ||\n      url.password ||\n      url.pathname !== \"/\" ||\n      url.search ||\n      url.hash ||\n      (url.protocol !== \"https:\" &&\n        !(url.protocol === \"http:\" && [\"localhost\", \"127.0.0.1\", \"[::1]\"].includes(url.hostname)))\n    ) {\n      throw new Error(\"Factory URL must be an HTTPS origin, or HTTP on loopback\");\n    }\n    this.origin = url.origin;\n  }\n\n  private async response(path: string, body?: unknown, signal?: AbortSignal): Promise<Response> {\n    const url = new URL(`/api/v1/${path}`, this.origin);\n    if (url.origin !== this.origin || !url.pathname.startsWith(\"/api/v1/\"))\n      throw new Error(\"Invalid Factory API path\");\n    const headers = new Headers(await this.options.headers?.());\n    headers.set(\"content-type\", \"application/json\");\n    const response = await (this.options.fetch ?? globalThis.fetch)(url.href, {\n      method: body === undefined ? \"GET\" : \"POST\",\n      headers,\n      ...(body === undefined ? {} : { body: JSON.stringify(body) }),\n      credentials: \"same-origin\",\n      cache: \"no-store\",\n      redirect: \"manual\",\n      signal: signal ?? AbortSignal.timeout(30_000),\n    });\n    if (response.type === \"opaqueredirect\" || [301, 302, 303, 307, 308].includes(response.status)) {\n      await response.body?.cancel();\n      throw new ApiError(\n        response.status,\n        `Factory at ${this.origin} returned a redirect. Reload to sign in, or set factory.url to the factory's canonical origin. Redirects are not followed.`,\n      );\n    }\n    if (!response.ok) {\n      const value: unknown = await response.json().catch(() => null);\n      const detail =\n        value !== null &&\n        typeof value === \"object\" &&\n        \"error\" in value &&\n        typeof value.error === \"string\"\n          ? value.error\n          : `HTTP ${response.status}`;\n      const actor =\n        value !== null &&\n        typeof value === \"object\" &&\n        \"actor\" in value &&\n        typeof value.actor === \"string\"\n          ? value.actor\n          : undefined;\n      throw new ApiError(\n        response.status,\n        response.status === 401\n          ? \"Authentication rejected. Reload to sign in, or run vercel login for the terminal client.\"\n          : detail,\n        actor,\n      );\n    }\n    return response;\n  }\n\n  /** Read authorized intake and pre-task triage failures. */\n  async intake(options: { repository?: string; cursor?: string; limit?: number } = {}) {\n    const query = new URLSearchParams();\n    for (const [key, value] of Object.entries(options))\n      if (value !== undefined) query.set(key, String(value));\n    return intakePageSchema.parse(await (await this.response(`intake?${query}`)).json());\n  }\n\n  /** Retry only the observed stopped attempt; concurrent or stale retries conflict. */\n  async retryIntake(id: string, expectedAttempt: number) {\n    return intakeViewSchema.parse(\n      await (\n        await this.response(\n          `intake/${encodeURIComponent(id)}/retry`,\n          retryIntakeSchema.parse({ expectedAttempt }),\n        )\n      ).json(),\n    );\n  }\n\n  /** Lists approval proposals visible to the authenticated operator. */\n  async listApprovals(options: ApprovalListOptions = {}): Promise<ApprovalPage> {\n    const query = new URLSearchParams(\n      Object.entries(options)\n        .filter(([, value]) => value !== undefined)\n        .map(([key, value]) => [key, String(value)]),\n    );\n    return approvalPageSchema.parse(await (await this.response(`approvals?${query}`)).json());\n  }\n  /** Reads one approval proposal by Task ID. */\n  async getApproval(id: TaskId): Promise<ApprovalView> {\n    return approvalViewSchema.parse(\n      await (await this.response(`tasks/${encodeURIComponent(id)}/approval`)).json(),\n    );\n  }\n  /** Approves one proposal, optionally recording an operator reason. */\n  async approveTask(id: TaskId, reason?: string): Promise<ApprovalView> {\n    return approvalViewSchema.parse(\n      await (\n        await this.response(\n          `tasks/${encodeURIComponent(id)}/approve`,\n          approvalRequestSchema.parse({ reason }),\n        )\n      ).json(),\n    );\n  }\n\n  /** Rejects one proposal with the required operator reason. */\n  async rejectTask(id: TaskId, reason: string): Promise<ApprovalView> {\n    return approvalViewSchema.parse(\n      await (\n        await this.response(\n          `tasks/${encodeURIComponent(id)}/reject`,\n          approvalRequestSchema.parse({ reason }),\n        )\n      ).json(),\n    );\n  }\n\n  /** Uploads one bounded image for use in a later message. */\n  async uploadImage(input: ImageUploadInput): Promise<ImageAttachment> {\n    return imageAttachmentSchema.parse(await (await this.response(\"images\", input)).json());\n  }\n  /** Downloads a previously uploaded image. */\n  async getImage(options: GetImageOptions): Promise<Blob> {\n    return (\n      await this.response(`images/${encodeURIComponent(options.id)}`, undefined, options.signal)\n    ).blob();\n  }\n\n  /** Lists agents exposed for operator session creation. */\n  async listAgents(): Promise<readonly ApiAgent[]> {\n    return z\n      .object({ agents: z.array(apiAgentSchema).readonly() })\n      .parse(await (await this.response(\"agents\")).json()).agents;\n  }\n  /** Reports whether the configured origin is the isolated local fixture runtime. */\n  async isLocalTestRuntime(): Promise<boolean> {\n    const response = await this.response(\"agents\");\n    const local = response.headers.get(\"x-factory-local-test\") === \"1\";\n    await response.body?.cancel();\n    return local;\n  }\n  /** Lists configured repository slugs. */\n  async listRepositories(): Promise<readonly RepositorySlug[]> {\n    return z\n      .object({ repositories: z.array(repositorySlugSchema).readonly() })\n      .parse(await (await this.response(\"repositories\")).json()).repositories;\n  }\n  /** Reads repository slugs together with their stable configured identifiers. */\n  async getRepositoryDetails(): Promise<RepositoryDetails> {\n    return repositoryDetailsSchema.parse(await (await this.response(\"repositories\")).json());\n  }\n  /** Reads one bounded page of open Changes, optionally scoped to a repository. */\n  async getChangePage(\n    options: { repository?: RepositorySlug; limit?: number; cursor?: string } = {},\n  ) {\n    const query = new URLSearchParams(\n      Object.entries(options)\n        .filter(([, value]) => value !== undefined)\n        .map(([key, value]) => [key, String(value)]),\n    );\n    return z\n      .object({ changes: z.array(changeSchema).readonly(), nextCursor: z.string().nullable() })\n      .parse(await (await this.response(`changes?${query}`)).json());\n  }\n  /** Reads one bounded page of canonical Tasks authorized for the caller. */\n  async getTaskPage(options: { limit?: number; cursor?: string } = {}) {\n    const query = new URLSearchParams(\n      Object.entries(options)\n        .filter(([, value]) => value !== undefined)\n        .map(([key, value]) => [key, String(value)]),\n    );\n    return z\n      .object({ tasks: z.array(taskSchema).readonly(), nextCursor: z.string().nullable() })\n      .parse(await (await this.response(`tasks?${query}`)).json());\n  }\n  /**\n   * Lists sessions matching the requested operator scope without pagination metadata.\n   *\n   * @param options - Optional scope and detail projection; both use their server defaults when omitted.\n   * @returns The first matching page's sessions. Use {@link getSessionPage} to follow cursors.\n   */\n  async listSessions(\n    options: Pick<SessionListOptions, \"scope\" | \"detail\"> = {},\n  ): Promise<readonly SessionSummary[]> {\n    return (await this.getSessionPage(options)).sessions;\n  }\n  /**\n   * Reads a filtered, cursor-paginated page of sessions.\n   *\n   * @param options - Filters, cursor, projection detail, and page limit sent to the API.\n   * @returns The validated page, including its continuation cursor and optional total count.\n   */\n  async getSessionPage(options: SessionListOptions = {}): Promise<SessionPage> {\n    const query = new URLSearchParams(\n      Object.entries(options)\n        .filter(([, value]) => value !== undefined)\n        .map(([key, value]) => [key, String(value)]),\n    ).toString();\n    return sessionPageSchema.parse(\n      await (await this.response(`sessions${query ? `?${query}` : \"\"}`)).json(),\n    );\n  }\n  /** Reads application-owned external work requiring operator attention. */\n  async getInboxActivity(): Promise<InboxActivity> {\n    return inboxActivitySchema.parse(await (await this.response(\"inbox-activity\")).json());\n  }\n  /** Reads application model choices and optional repository defaults. */\n  async getModelSettings(repository?: RepositorySlug): Promise<ModelSettings> {\n    const query = repository ? `?${new URLSearchParams({ repository })}` : \"\";\n    return modelSettingsSchema.parse(await (await this.response(`models${query}`)).json());\n  }\n  /** Saves repository defaults only when their observed revision still matches. */\n  async updateModelDefaults(input: UpdateModelDefaults): Promise<ModelSettings> {\n    return modelSettingsSchema.parse(\n      await (await this.response(\"models\", updateModelDefaultsSchema.parse(input))).json(),\n    );\n  }\n  /** Counts sessions that currently require operator attention. */\n  async getInboxCount(): Promise<number> {\n    const result = z\n      .object({ totalCount: z.number().int().nonnegative().optional() })\n      .parse(\n        await (\n          await this.response(\n            \"sessions?scope=all&detail=summary&attention=true&includeTotal=true&limit=1\",\n          )\n        ).json(),\n      );\n    if (result.totalCount === undefined)\n      throw new Error(\"This factory's access policy does not provide an exact attention count\");\n    return result.totalCount;\n  }\n  /** Reads a summary batch for the provided session IDs. */\n  async getSessionBatch(ids: readonly AgentSessionId[]): Promise<readonly SessionSummary[]> {\n    if (ids.length === 0) return [];\n    const query = new URLSearchParams({ ids: ids.join(\",\"), detail: \"summary\" });\n    return z\n      .object({ sessions: z.array(sessionSummarySchema).readonly() })\n      .parse(await (await this.response(`sessions?${query}`)).json()).sessions;\n  }\n  /** Reads one earlier page of authorized provider executions. */\n  async getSessionHistory(\n    id: AgentSessionId,\n    options: { cursor?: string; signal?: AbortSignal } = {},\n  ) {\n    const query = new URLSearchParams({\n      limit: \"20\",\n      ...(options.cursor ? { cursor: options.cursor } : {}),\n    });\n    return z\n      .object({\n        items: sessionViewSchema.shape.history.unwrap(),\n        nextCursor: z.string().nullable(),\n      })\n      .parse(\n        await (\n          await this.response(\n            `sessions/${encodeURIComponent(id)}/history?${query}`,\n            undefined,\n            options.signal,\n          )\n        ).json(),\n      );\n  }\n  /** Reads one earlier page of delivered conversation notifications. */\n  async getSessionNotifications(\n    id: AgentSessionId,\n    options: { cursor?: string; signal?: AbortSignal } = {},\n  ) {\n    const query = new URLSearchParams({\n      limit: \"30\",\n      ...(options.cursor ? { cursor: options.cursor } : {}),\n    });\n    return z\n      .object({ items: sessionViewSchema.shape.notifications, nextCursor: z.string().nullable() })\n      .parse(\n        await (\n          await this.response(\n            `sessions/${encodeURIComponent(id)}/notifications?${query}`,\n            undefined,\n            options.signal,\n          )\n        ).json(),\n      );\n  }\n  /** Reads one bounded page of related Tasks authorized for this conversation. */\n  async getSessionRelatedTasks(\n    id: AgentSessionId,\n    options: { cursor?: string; signal?: AbortSignal } = {},\n  ) {\n    const query = new URLSearchParams({\n      limit: \"30\",\n      ...(options.cursor ? { cursor: options.cursor } : {}),\n    });\n    return z\n      .object({\n        items: sessionViewSchema.shape.relatedTasks.unwrap(),\n        nextCursor: z.string().nullable(),\n      })\n      .parse(\n        await (\n          await this.response(\n            `sessions/${encodeURIComponent(id)}/related-tasks?${query}`,\n            undefined,\n            options.signal,\n          )\n        ).json(),\n      );\n  }\n  /**\n   * Reads one operator session.\n   *\n   * @param options - Stable session ID and optional summary or full projection.\n   * @returns The current validated session view; it is a snapshot and does not follow live events.\n   */\n  async getSession(options: GetSessionOptions): Promise<SessionView> {\n    return sessionViewSchema.parse(\n      await (\n        await this.response(\n          `sessions/${encodeURIComponent(options.id)}${options.detail ? `?detail=${options.detail}` : \"\"}`,\n        )\n      ).json(),\n    );\n  }\n  /** Reads the canonical task graph projected for one session. */\n  async getSessionGraph(options: GetSessionGraphOptions): Promise<TaskGraphView> {\n    return taskGraphViewSchema.parse(\n      await (\n        await this.response(\n          `sessions/${encodeURIComponent(options.id)}/graph${options.taskId ? `?${new URLSearchParams({ taskId: options.taskId })}` : \"\"}`,\n          undefined,\n          options.signal,\n        )\n      ).json(),\n    );\n  }\n  /** Reads the materialized transcript for one exact graph task execution. */\n  async getGraphTranscript(options: GraphTranscriptOptions): Promise<TranscriptSnapshot> {\n    const query = new URLSearchParams({\n      taskId: options.taskId,\n      executionId: options.executionId,\n    });\n    return transcriptPageSchema.parse(\n      await (\n        await this.response(\n          `sessions/${encodeURIComponent(options.sessionId)}/graph-transcript?${query}`,\n          undefined,\n          options.signal,\n        )\n      ).json(),\n    ).snapshot;\n  }\n  /** Refreshes a session summary and reloads its history when the active execution changes. */\n  async refreshSession(previous: SessionView): Promise<SessionView> {\n    const current = await this.getSession({ id: previous.session.id, detail: \"summary\" });\n    if (\n      current.task?.id !== previous.task?.id ||\n      current.execution?.sessionId !== previous.execution?.sessionId ||\n      current.execution?.provider !== previous.execution?.provider\n    )\n      return this.getSession({ id: previous.session.id });\n    if (\n      current.session.latestNotificationId !== previous.session.latestNotificationId ||\n      current.task?.updatedAt !== previous.task?.updatedAt ||\n      current.statusRevision !== previous.statusRevision\n    ) {\n      const fresh = await this.getSession({ id: previous.session.id });\n      if (\n        fresh.task?.id !== previous.task?.id ||\n        fresh.execution?.sessionId !== previous.execution?.sessionId ||\n        fresh.execution?.provider !== previous.execution?.provider\n      )\n        return fresh;\n      return {\n        ...fresh,\n        history: [\n          ...new Map(\n            [...(previous.history ?? []), ...(fresh.history ?? [])].map((entry) => [\n              JSON.stringify(entry.execution),\n              entry,\n            ]),\n          ).values(),\n        ],\n        historyNextCursor:\n          (previous.history?.length ?? 0) > (fresh.history?.length ?? 0)\n            ? previous.historyNextCursor\n            : fresh.historyNextCursor,\n        notifications: [\n          ...new Map(\n            [...previous.notifications, ...fresh.notifications].map((entry) => [\n              entry.eventId,\n              entry,\n            ]),\n          ).values(),\n        ],\n        notificationsNextCursor:\n          previous.notifications.length > fresh.notifications.length\n            ? previous.notificationsNextCursor\n            : fresh.notificationsNextCursor,\n        relatedTasks: [\n          ...new Map(\n            [\n              ...(fresh.relatedTasks ?? []),\n              ...(previous.relatedTasks ?? []).filter(\n                (entry) => !fresh.relatedTasks?.some((current) => current.id === entry.id),\n              ),\n            ].map((entry) => [entry.id, entry]),\n          ).values(),\n        ],\n        relatedTasksNextCursor:\n          (previous.relatedTasks?.length ?? 0) > (fresh.relatedTasks?.length ?? 0)\n            ? previous.relatedTasksNextCursor\n            : fresh.relatedTasksNextCursor,\n      };\n    }\n    return {\n      ...current,\n      history: previous.history,\n      historyNextCursor: previous.historyNextCursor,\n      notifications: previous.notifications,\n      notificationsNextCursor: previous.notificationsNextCursor,\n      relatedTasks: previous.relatedTasks,\n      relatedTasksNextCursor: previous.relatedTasksNextCursor,\n    };\n  }\n  /** Reads application-owned previews without starting an agent, deployment, or server. */\n  async getSessionPreviews(options: SessionPreviewsOptions): Promise<SessionPreviews> {\n    return sessionPreviewsSchema.parse(\n      await (\n        await this.response(\n          `sessions/${encodeURIComponent(options.sessionId)}/previews?${new URLSearchParams({ executionId: options.executionId ?? \"\" })}`,\n          undefined,\n          options.signal,\n        )\n      ).json(),\n    );\n  }\n  /** Reads recorded checks, screenshots, and issues through the application's review reader. */\n  async getSessionReview(options: SessionReviewOptions): Promise<SessionReview> {\n    return sessionReviewSchema.parse(\n      await (\n        await this.response(\n          `sessions/${encodeURIComponent(options.sessionId)}/review?${new URLSearchParams({ executionId: options.executionId ?? \"\" })}`,\n          undefined,\n          options.signal,\n        )\n      ).json(),\n    );\n  }\n  /** Reads a directory or complete file through the factory's configured workspace adapter. */\n  async getWorkspaceFiles(options: WorkspaceFilesOptions): Promise<WorkspaceFiles> {\n    const query = workspaceFilesRequestSchema.parse({\n      path: options.path,\n      revision: options.revision,\n    });\n    const params = new URLSearchParams({\n      executionId: options.executionId ?? \"\",\n      path: query.path,\n    });\n    if (query.revision !== undefined) params.set(\"revision\", query.revision);\n    return workspaceFilesSchema.parse(\n      await (\n        await this.response(\n          `sessions/${encodeURIComponent(options.sessionId)}/files?${params}`,\n          undefined,\n          options.signal,\n        )\n      ).json(),\n    );\n  }\n  /** Reads the committed workspace comparison for one observed execution. */\n  async getWorkspaceDiff(options: WorkspaceDiffOptions): Promise<WorkspaceDiff> {\n    return workspaceDiffSchema.parse(\n      await (\n        await this.response(\n          `sessions/${encodeURIComponent(options.sessionId)}/diff?${new URLSearchParams({ executionId: options.executionId ?? \"\" })}`,\n          undefined,\n          options.signal,\n        )\n      ).json(),\n    );\n  }\n  /**\n   * Creates or recovers an idempotent conversational session.\n   *\n   * @remarks\n   * Retain `input.operationId` unchanged across ambiguous failures. Reusing it with identical input\n   * returns the original session; reusing it with different input is a conflict. The returned view\n   * means admission and any initial dispatch attempt finished, not that the agent's work completed.\n   *\n   * @param input - Agent, initial content, optional repository/change, and client idempotency key.\n   * @returns The admitted or recovered session snapshot.\n   */\n  async createSession(input: CreateSessionRequest): Promise<SessionView> {\n    return sessionViewSchema.parse(\n      await (await this.response(\"sessions\", createSessionRequestSchema.parse(input))).json(),\n    );\n  }\n\n  /** Creates or recovers idempotent workflow work through a specialist signal. */\n  async createSignal(input: CreateSessionRequest): Promise<SessionView> {\n    return sessionViewSchema.parse(\n      await (await this.response(\"signals\", createSessionRequestSchema.parse(input))).json(),\n    );\n  }\n\n  /** Starts a deepsec security scan of a repository, or returns its already-active scan. */\n  async runSecurityScan(repositoryId: RepositoryId): Promise<{ taskId: TaskId; reused: boolean }> {\n    return z\n      .strictObject({ taskId: taskIdSchema, reused: z.boolean() })\n      .parse(await (await this.response(`repositories/${repositoryId}/security-scan`, {})).json());\n  }\n\n  /**\n   * Sends a message to an existing session using optimistic execution matching.\n   *\n   * @remarks\n   * `input.executionId` must be the execution the caller observed, or `null` when none was active.\n   * A completed Task follow-up also requires an `operationId`, which must be retained for retries.\n   * Resolving means the API accepted the message; provider or follow-up work may still be running.\n   *\n   * @param id - Stable Factory session receiving the message.\n   * @param input - Message, observed execution, steering policy, attachments, and optional retry key.\n   * @returns Nothing after the API accepts the request.\n   */\n  async sendSessionMessage(id: AgentSessionId, input: SendSessionMessageRequest): Promise<void> {\n    const response = await this.response(\n      `sessions/${encodeURIComponent(id)}/messages`,\n      sendSessionMessageRequestSchema.parse(input),\n    );\n    await response.body?.cancel();\n  }\n\n  /**\n   * Submits responses to pending provider input requests.\n   *\n   * @param id - Stable Factory session whose provider requested input.\n   * @param input - Observed execution ID and one or more request-correlated responses.\n   * @returns Nothing after the API accepts the responses; stale execution IDs are rejected.\n   */\n  async submitSessionInput(id: AgentSessionId, input: SubmitSessionInputRequest): Promise<void> {\n    const response = await this.response(\n      `sessions/${encodeURIComponent(id)}/input`,\n      submitSessionInputRequestSchema.parse(input),\n    );\n    await response.body?.cancel();\n  }\n\n  /**\n   * Attempts to dispatch queued workflow work associated with a session.\n   *\n   * @param id - Stable Factory session whose current work should be dispatched.\n   * @returns The refreshed session after the bounded dispatch attempt, which may still be queued.\n   */\n  async dispatchSession(id: AgentSessionId): Promise<SessionView> {\n    return sessionViewSchema.parse(\n      await (await this.response(`sessions/${encodeURIComponent(id)}/dispatch`, {})).json(),\n    );\n  }\n\n  /** Answers a workflow question associated with a session. */\n  async answerSessionQuestion(\n    id: AgentSessionId,\n    input: AnswerSessionQuestionRequest,\n  ): Promise<SessionView> {\n    return sessionViewSchema.parse(\n      await (\n        await this.response(\n          `sessions/${encodeURIComponent(id)}/answer`,\n          answerSessionQuestionRequestSchema.parse(input),\n        )\n      ).json(),\n    );\n  }\n\n  /** Cooperatively interrupts the currently observed turn. */\n  async interruptSession(id: AgentSessionId, input: ControlSessionRequest = {}): Promise<void> {\n    return this.controlSession(id, \"interrupt\", input);\n  }\n\n  /** Cancels active workflow and provider work in a session. */\n  async cancelSession(id: AgentSessionId, input: ControlSessionRequest = {}): Promise<void> {\n    return this.controlSession(id, \"cancel\", input);\n  }\n\n  /** Compacts the provider context for a session. */\n  async compactSession(id: AgentSessionId, input: ControlSessionRequest = {}): Promise<void> {\n    return this.controlSession(id, \"compact\", input);\n  }\n\n  /** Clears the provider context for a session. */\n  async clearSession(id: AgentSessionId, input: ControlSessionRequest = {}): Promise<void> {\n    return this.controlSession(id, \"clear\", input);\n  }\n\n  /** Resets a session after cancelling its active work. */\n  async resetSession(id: AgentSessionId, input: ControlSessionRequest = {}): Promise<void> {\n    return this.controlSession(id, \"reset\", input);\n  }\n\n  /** Reads a materialized transcript as a raw HTTP response for incremental following. */\n  async getSessionTranscriptResponse(input: SessionTranscriptRequest): Promise<Response> {\n    const query = new URLSearchParams({ executionId: input.executionId });\n    if (input.history === true) query.set(\"history\", \"1\");\n    if (input.taskId !== undefined) query.set(\"taskId\", input.taskId);\n    if (input.limit !== undefined) query.set(\"limit\", String(input.limit));\n    if (input.cursor !== undefined) query.set(\"cursor\", input.cursor);\n    if (input.blockId !== undefined) query.set(\"blockId\", input.blockId);\n    return this.response(\n      `sessions/${encodeURIComponent(input.sessionId)}/${input.taskId ? \"graph-transcript\" : \"transcript\"}?${query}`,\n      undefined,\n      input.signal,\n    );\n  }\n\n  /** Reads one bounded page of saved transcript history from Factory storage. */\n  async getTranscriptPage(\n    input: Omit<SessionTranscriptRequest, \"blockId\">,\n  ): Promise<TranscriptPage> {\n    return transcriptPageSchema.parse(\n      await (await this.getSessionTranscriptResponse(input)).json(),\n    );\n  }\n\n  /** Expands one large transcript block after authorizing its session and execution. */\n  async getTranscriptBlock(\n    input: Omit<SessionTranscriptRequest, \"limit\" | \"cursor\"> & { readonly blockId: string },\n  ): Promise<TranscriptBlock> {\n    return transcriptBlockSchema.parse(\n      await (await this.getSessionTranscriptResponse(input)).json(),\n    );\n  }\n\n  /** Opens a cursor-addressed session event stream as a raw HTTP response. */\n  async getSessionEventStreamResponse(input: SessionEventStreamRequest): Promise<Response> {\n    const query = new URLSearchParams({\n      executionId: input.executionId,\n      startIndex: String(input.cursor),\n    });\n    if (input.taskId !== undefined) query.set(\"taskId\", input.taskId);\n    return this.response(\n      `sessions/${encodeURIComponent(input.sessionId)}/${input.taskId ? \"graph-stream\" : \"stream\"}?${query}`,\n      undefined,\n      input.signal,\n    );\n  }\n\n  private async controlSession(\n    id: AgentSessionId,\n    action: \"interrupt\" | \"cancel\" | \"compact\" | \"clear\" | \"reset\",\n    input: ControlSessionRequest,\n  ): Promise<void> {\n    const response = await this.response(\n      `sessions/${encodeURIComponent(id)}/${action}`,\n      controlSessionRequestSchema.parse(input),\n    );\n    await response.body?.cancel();\n  }\n}\n"],"mappings":"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"}

package/dist/code-review/contracts.d.mts

@@ -4,6 +4,7 @@ import { RepositorySlug } from "../schema/repository.mjs";
 /** A review result bound to the exact Task, Change, repository, pull request, and head commit. */
 interface CompletedReview {
   taskId: TaskId;
+  attempt: number;
   changeId: ChangeId;
   repository: RepositorySlug;
   pullRequestNumber: number;

package/dist/code-review/eve-post-review.d.mts

@@ -1,6 +1,6 @@
 import { ChangeId, TaskId } from "../schema/id.mjs";
-import { RepositorySlug } from "../schema/repository.mjs";
 import { Task, TaskState } from "../schema/task.mjs";
+import { RepositorySlug } from "../schema/repository.mjs";
 import { FactoryStores } from "../store/engine.mjs";
 import { CompletedReview, CompletedReviewFinding } from "./contracts.mjs";
 import { SubmittedPullRequestReview } from "../github.mjs";
@@ -17,10 +17,12 @@ interface GitHubPostReviewToolOptions {
   publishReviews?: boolean | ((task: Task) => boolean);
   onCompleted?: (completed: CompletedReview) => Promise<void>;
   onPublished?: (published: PublishedGitHubReview) => Promise<void>;
+  /** Pause an obsolete attempt and return true when the application will replace it. */
+  onStaleHead?: (task: Task) => Promise<boolean>;
   fetch?: typeof globalThis.fetch;
 }
 /** Machine-readable reason a code review could not be recorded. */
-type GitHubPostReviewFailureCode = "task_not_found" | "task_kind_mismatch" | "task_not_running" | "change_not_found" | "change_not_reviewable" | "repository_not_found" | "stale_pull_request_head";
+type GitHubPostReviewFailureCode = "task_not_found" | "task_kind_mismatch" | "task_not_running" | "change_not_found" | "change_not_reviewable" | "repository_not_found" | "stale_pull_request_head" | "review_refresh_pending";
 /** Outcome returned after validating, recording, and optionally publishing a code review. */
 type GitHubPostReviewResult = {
   readonly recorded: false;

package/dist/code-review/eve-post-review.mjs

@@ -99,6 +99,7 @@ function createGitHubPostReviewTool(input) {
 			});
 			const completed = {
 				taskId,
+				attempt: task.attempt,
 				changeId,
 				repository: repository.slug,
 				pullRequestNumber: change.prNumber,
@@ -131,6 +132,13 @@ function createGitHubPostReviewTool(input) {
 				}
 			} catch (error) {
 				if (!(error instanceof StalePullRequestHeadError)) throw error;
+				const current = await requireTaskExecution(stores, ctx, taskId);
+				if (await options.onStaleHead?.(current)) return {
+					recorded: false,
+					code: "review_refresh_pending",
+					reason: "The PR changed during review. End this turn; Factory will start a fresh attempt against its latest commit after recording usage.",
+					taskState: (await stores.tasks.get(taskId))?.state ?? current.state
+				};
 				const resolved = await stores.tasks.transition(taskId, "cancelled", {
 					expectFrom: "running",
 					expectAttempt: task.attempt,

package/dist/code-review/eve-post-review.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"eve-post-review.mjs","names":[],"sources":["../../src/code-review/eve-post-review.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport { defineTool, type ToolContext, type ToolDefinition } from \"eve/tools\";\nimport { z } from \"zod\";\nimport type { CompletedReview, CompletedReviewFinding } from \"../code-review/contracts\";\nimport type { PublishedGitHubReview } from \"../code-review/github-contracts\";\nimport { requireTaskExecution } from \"../eve/task-execution\";\nimport {\n  readPullRequestHead,\n  StalePullRequestHeadError,\n  submitPullRequestReview,\n  type PullRequestReviewComment,\n  type SubmittedPullRequestReview,\n} from \"../github\";\nimport { changeIdSchema, taskIdSchema, type ChangeId, type TaskId } from \"../schema/id\";\nimport type { RepositorySlug } from \"../schema/repository\";\nimport type { Task, TaskState } from \"../schema/task\";\nimport type { FactoryStores } from \"../store/engine\";\n\n/** Change, repository, and Task capabilities required by the review publication tool. */\nexport type GitHubPostReviewToolStores = Pick<FactoryStores, \"changes\" | \"repositories\" | \"tasks\">;\n\n/** Configures GitHub access, publication, and durable review-reporting callbacks. */\nexport interface GitHubPostReviewToolOptions {\n  stores: GitHubPostReviewToolStores;\n  tokenForRepository: (repository: RepositorySlug) => Promise<string>;\n  /** Whether to publish a GitHub review, optionally selected from the authenticated Task. Defaults to true. */\n  publishReviews?: boolean | ((task: Task) => boolean);\n  onCompleted?: (completed: CompletedReview) => Promise<void>;\n  onPublished?: (published: PublishedGitHubReview) => Promise<void>;\n  fetch?: typeof globalThis.fetch;\n}\n\n/** Machine-readable reason a code review could not be recorded. */\nexport type GitHubPostReviewFailureCode =\n  | \"task_not_found\"\n  | \"task_kind_mismatch\"\n  | \"task_not_running\"\n  | \"change_not_found\"\n  | \"change_not_reviewable\"\n  | \"repository_not_found\"\n  | \"stale_pull_request_head\";\n\n/** Outcome returned after validating, recording, and optionally publishing a code review. */\nexport type GitHubPostReviewResult =\n  | {\n      readonly recorded: false;\n      readonly code: GitHubPostReviewFailureCode;\n      readonly reason: string;\n      readonly taskState?: TaskState;\n      readonly verdict?: never;\n      readonly published?: never;\n      readonly review?: never;\n    }\n  | {\n      readonly recorded: true;\n      readonly verdict: CompletedReview[\"verdict\"];\n      readonly published: false;\n      readonly review?: never;\n      readonly taskState: \"succeeded\";\n    }\n  | {\n      readonly recorded: true;\n      readonly verdict: CompletedReview[\"verdict\"];\n      readonly published: true;\n      readonly review: SubmittedPullRequestReview;\n      readonly taskState: \"succeeded\";\n    };\n\n/** Inline review finding accepted before Factory assigns its stable fingerprint. */\nexport interface GitHubPostReviewCommentInput extends Pick<\n  CompletedReviewFinding,\n  \"path\" | \"startLine\" | \"line\" | \"body\"\n> {\n  key?: string;\n  title?: string;\n}\n\n/** Completed review supplied for validation, recording, and optional GitHub publication. */\nexport interface GitHubPostReviewInput {\n  taskId: TaskId;\n  changeId: ChangeId;\n  verdict: CompletedReview[\"verdict\"];\n  headSha: string;\n  comments: readonly GitHubPostReviewCommentInput[];\n}\n\n/** Eve outcome tool that records and optionally publishes one completed code review. */\nexport interface GitHubPostReviewTool extends ToolDefinition<\n  GitHubPostReviewInput,\n  GitHubPostReviewResult\n> {\n  execute(input: GitHubPostReviewInput, ctx: ToolContext): Promise<GitHubPostReviewResult>;\n}\n\nconst reviewCommentSchema = z\n  .strictObject({\n    key: z\n      .string()\n      .min(1)\n      .max(80)\n      .regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/)\n      .optional()\n      .describe(\n        \"Stable kebab-case identity for this defect and cause; keep it unchanged across reruns.\",\n      ),\n    title: z.string().min(1).max(200).optional().describe(\"Short finding title.\"),\n    path: z.string().min(1).max(500).describe(\"Repository-relative file path.\"),\n    startLine: z\n      .number()\n      .int()\n      .min(1)\n      .optional()\n      .describe(\n        \"First line of a multiline finding in the new version. A suggestion replaces every line from startLine through line, inclusive. Omit when only one line needs replacement.\",\n      ),\n    line: z\n      .number()\n      .int()\n      .min(1)\n      .describe(\n        \"Last affected line in the pull request's new version, within the diff. This is the inclusive end of a suggestion's replacement range.\",\n      ),\n    body: z\n      .string()\n      .min(1)\n      .max(5000)\n      .describe(\n        \"Concise explanation of the defect and its impact. A fenced suggestion must replace the entire selected range, preserving required surrounding syntax. First validate the resulting full file in memory or a temporary copy; if validation fails or cannot run, explain the fix in prose without a suggestion block.\",\n      ),\n  })\n  .refine((comment) => comment.startLine === undefined || comment.startLine < comment.line, {\n    message: \"startLine must precede line; omit it for a single-line finding.\",\n    path: [\"startLine\"],\n  });\nconst reviewCommentsSchema = z\n  .array(reviewCommentSchema)\n  .max(50)\n  .default([])\n  .superRefine((comments, context) => {\n    const seen = new Set<string>();\n    comments.forEach((comment, index) => {\n      if (comment.key === undefined) return;\n      if (seen.has(comment.key)) {\n        context.addIssue({\n          code: \"custom\",\n          message: `duplicate finding key: ${comment.key}`,\n          path: [index, \"key\"],\n        });\n      }\n      seen.add(comment.key);\n    });\n  })\n  .readonly();\n\nconst reviewInputSchema = z\n  .object({\n    taskId: taskIdSchema.describe(\"Your code_review task.\"),\n    changeId: changeIdSchema.describe(\"The pull request change from your starting message.\"),\n    verdict: z.enum([\"approve\", \"request_changes\", \"comment\"]),\n    headSha: z\n      .string()\n      .regex(/^[0-9a-f]{40}$/)\n      .describe(\"Commit returned by fetch_pull_request.\"),\n    comments: reviewCommentsSchema,\n  })\n  .superRefine(({ verdict, comments }, context) => {\n    if (verdict === \"approve\" ? comments.length > 0 : comments.length === 0) {\n      context.addIssue({\n        code: \"custom\",\n        path: [\"comments\"],\n        message:\n          \"Approve only with no findings. For comment or request_changes, put every actionable finding in comments at its affected diff lines.\",\n      });\n    }\n  });\n\n/**\n * Publish an independent review of an existing pull request and finish the\n * review task without changing the pull request's factory lifecycle.\n */\nexport function createGitHubPostReviewTool(\n  input: GitHubPostReviewToolOptions,\n): GitHubPostReviewTool {\n  const { stores, ...options } = input;\n  return defineTool({\n    description:\n      \"Record a completed code review and finish your code_review task. Approve with no comments when clean; otherwise report actionable findings inline, using request_changes only for blocking defects. Factory generates the short review summary.\",\n    inputSchema: reviewInputSchema,\n    async execute(input, ctx): Promise<GitHubPostReviewResult> {\n      const { taskId, changeId, verdict, headSha, comments } = reviewInputSchema.parse(input);\n      const summary =\n        comments.length === 0\n          ? \"No issues found.\"\n          : `${comments.length} finding${comments.length === 1 ? \"\" : \"s\"}. ${verdict === \"request_changes\" ? \"Changes requested. \" : \"\"}See inline comments.`;\n      const task = await requireTaskExecution(stores, ctx, taskId);\n      if (task.kind !== \"code_review\") {\n        return {\n          recorded: false as const,\n          code: \"task_kind_mismatch\",\n          reason: `${taskId} is not a code_review task`,\n        };\n      }\n      if (task.state !== \"running\") {\n        return {\n          recorded: false as const,\n          code: \"task_not_running\",\n          reason: `task is ${task.state}, not running`,\n        };\n      }\n\n      const change = await stores.changes.get(changeId);\n      if (change === null) {\n        return {\n          recorded: false as const,\n          code: \"change_not_found\",\n          reason: `change ${changeId} does not exist`,\n        };\n      }\n      if (change.state !== \"verifying\" && change.state !== \"ready\") {\n        return {\n          recorded: false as const,\n          code: \"change_not_reviewable\",\n          reason: `change is ${change.state}, not open for review`,\n        };\n      }\n      const repository = await stores.repositories.get(change.repositoryId);\n      if (repository === null) {\n        return {\n          recorded: false as const,\n          code: \"repository_not_found\",\n          reason: `repository ${change.repositoryId} does not exist`,\n        };\n      }\n      if (\n        task.changeId !== change.id ||\n        task.repositoryIds.length !== 1 ||\n        task.repositoryIds[0] !== repository.id\n      ) {\n        throw new Error(\"Authenticated review Task, Change, and repository must match\");\n      }\n\n      const token = await options.tokenForRepository(repository.slug);\n      await requireTaskExecution(stores, ctx, taskId);\n      const completedComments = comments.map((comment) => {\n        const key = comment.key ?? legacyFindingKey(comment);\n        return {\n          ...comment,\n          key,\n          title: comment.title ?? \"Review finding\",\n          fingerprint: createHash(\"sha256\")\n            .update(`${repository.slug.toLowerCase()}#${change.prNumber}:${key}`)\n            .digest(\"hex\"),\n        };\n      });\n      const completed = {\n        taskId,\n        changeId,\n        repository: repository.slug,\n        pullRequestNumber: change.prNumber,\n        headSha,\n        verdict,\n        summary,\n        comments: completedComments,\n      } satisfies CompletedReview;\n      const publish =\n        typeof options.publishReviews === \"function\"\n          ? options.publishReviews(task)\n          : options.publishReviews !== false;\n      let review: SubmittedPullRequestReview | undefined;\n      try {\n        if (publish) {\n          review = await submitPullRequestReview({\n            repository: repository.slug,\n            token,\n            fetch: options.fetch,\n            pullRequestNumber: change.prNumber,\n            commitId: headSha,\n            event:\n              verdict === \"approve\"\n                ? \"APPROVE\"\n                : verdict === \"request_changes\"\n                  ? \"REQUEST_CHANGES\"\n                  : \"COMMENT\",\n            body: summary,\n            comments: completedComments,\n          });\n        } else {\n          const head = await readPullRequestHead({\n            repository: repository.slug,\n            token,\n            fetch: options.fetch,\n            pullRequestNumber: change.prNumber,\n          });\n          if (head.sha !== headSha) {\n            throw new StalePullRequestHeadError(headSha, head.sha);\n          }\n        }\n      } catch (error) {\n        if (!(error instanceof StalePullRequestHeadError)) {\n          throw error;\n        }\n        // The reviewer refused a stale head: the change moved on while this\n        // review was in flight, so an identical retry against the same head\n        // can never succeed either. Resolve the task as superseded right\n        // here instead of leaving it running for the stall watchdog to\n        // eventually -- and misleadingly -- report as \"stalled\".\n        const resolved = await stores.tasks\n          .transition(taskId, \"cancelled\", {\n            expectFrom: \"running\",\n            expectAttempt: task.attempt,\n            expectExecution: task.execution,\n            reason: `review superseded by newer commits: ${error.message}`,\n          })\n          .catch(() => null);\n        return {\n          recorded: false as const,\n          code: \"stale_pull_request_head\",\n          reason: error.message,\n          taskState:\n            resolved?.state ??\n            (await stores.tasks.get(taskId).catch(() => null))?.state ??\n            task.state,\n        };\n      }\n      await requireTaskExecution(stores, ctx, taskId);\n      if (review !== undefined) await options.onPublished?.({ ...completed, review });\n      await requireTaskExecution(stores, ctx, taskId);\n      await options.onCompleted?.(completed);\n      await stores.tasks.transition(taskId, \"verifying\", {\n        expectFrom: \"running\",\n        expectAttempt: task.attempt,\n        expectExecution: task.execution,\n        reason: summary,\n      });\n      await stores.tasks.transition(taskId, \"succeeded\", {\n        expectFrom: \"verifying\",\n        expectAttempt: task.attempt,\n        expectExecution: task.execution,\n        output: {\n          changeId,\n          headSha,\n          verdict,\n          summary,\n          findingCount: completedComments.length,\n          published: review !== undefined,\n          ...(review === undefined ? {} : { review }),\n        },\n      });\n      return review === undefined\n        ? {\n            recorded: true,\n            verdict,\n            published: false,\n            taskState: \"succeeded\",\n          }\n        : {\n            recorded: true,\n            verdict,\n            published: true,\n            review,\n            taskState: \"succeeded\",\n          };\n    },\n  });\n}\n\nfunction legacyFindingKey(comment: PullRequestReviewComment): string {\n  const digest = createHash(\"sha256\")\n    .update(`${comment.path}:${comment.line}:${comment.body}`)\n    .digest(\"hex\")\n    .slice(0, 24);\n  return `legacy-${digest}`;\n}\n"],"mappings":"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"}
+{"version":3,"file":"eve-post-review.mjs","names":[],"sources":["../../src/code-review/eve-post-review.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport { defineTool, type ToolContext, type ToolDefinition } from \"eve/tools\";\nimport { z } from \"zod\";\nimport type { CompletedReview, CompletedReviewFinding } from \"../code-review/contracts\";\nimport type { PublishedGitHubReview } from \"../code-review/github-contracts\";\nimport { requireTaskExecution } from \"../eve/task-execution\";\nimport {\n  readPullRequestHead,\n  StalePullRequestHeadError,\n  submitPullRequestReview,\n  type PullRequestReviewComment,\n  type SubmittedPullRequestReview,\n} from \"../github\";\nimport { changeIdSchema, taskIdSchema, type ChangeId, type TaskId } from \"../schema/id\";\nimport type { RepositorySlug } from \"../schema/repository\";\nimport type { Task, TaskState } from \"../schema/task\";\nimport type { FactoryStores } from \"../store/engine\";\n\n/** Change, repository, and Task capabilities required by the review publication tool. */\nexport type GitHubPostReviewToolStores = Pick<FactoryStores, \"changes\" | \"repositories\" | \"tasks\">;\n\n/** Configures GitHub access, publication, and durable review-reporting callbacks. */\nexport interface GitHubPostReviewToolOptions {\n  stores: GitHubPostReviewToolStores;\n  tokenForRepository: (repository: RepositorySlug) => Promise<string>;\n  /** Whether to publish a GitHub review, optionally selected from the authenticated Task. Defaults to true. */\n  publishReviews?: boolean | ((task: Task) => boolean);\n  onCompleted?: (completed: CompletedReview) => Promise<void>;\n  onPublished?: (published: PublishedGitHubReview) => Promise<void>;\n  /** Pause an obsolete attempt and return true when the application will replace it. */\n  onStaleHead?: (task: Task) => Promise<boolean>;\n  fetch?: typeof globalThis.fetch;\n}\n\n/** Machine-readable reason a code review could not be recorded. */\nexport type GitHubPostReviewFailureCode =\n  | \"task_not_found\"\n  | \"task_kind_mismatch\"\n  | \"task_not_running\"\n  | \"change_not_found\"\n  | \"change_not_reviewable\"\n  | \"repository_not_found\"\n  | \"stale_pull_request_head\"\n  | \"review_refresh_pending\";\n\n/** Outcome returned after validating, recording, and optionally publishing a code review. */\nexport type GitHubPostReviewResult =\n  | {\n      readonly recorded: false;\n      readonly code: GitHubPostReviewFailureCode;\n      readonly reason: string;\n      readonly taskState?: TaskState;\n      readonly verdict?: never;\n      readonly published?: never;\n      readonly review?: never;\n    }\n  | {\n      readonly recorded: true;\n      readonly verdict: CompletedReview[\"verdict\"];\n      readonly published: false;\n      readonly review?: never;\n      readonly taskState: \"succeeded\";\n    }\n  | {\n      readonly recorded: true;\n      readonly verdict: CompletedReview[\"verdict\"];\n      readonly published: true;\n      readonly review: SubmittedPullRequestReview;\n      readonly taskState: \"succeeded\";\n    };\n\n/** Inline review finding accepted before Factory assigns its stable fingerprint. */\nexport interface GitHubPostReviewCommentInput extends Pick<\n  CompletedReviewFinding,\n  \"path\" | \"startLine\" | \"line\" | \"body\"\n> {\n  key?: string;\n  title?: string;\n}\n\n/** Completed review supplied for validation, recording, and optional GitHub publication. */\nexport interface GitHubPostReviewInput {\n  taskId: TaskId;\n  changeId: ChangeId;\n  verdict: CompletedReview[\"verdict\"];\n  headSha: string;\n  comments: readonly GitHubPostReviewCommentInput[];\n}\n\n/** Eve outcome tool that records and optionally publishes one completed code review. */\nexport interface GitHubPostReviewTool extends ToolDefinition<\n  GitHubPostReviewInput,\n  GitHubPostReviewResult\n> {\n  execute(input: GitHubPostReviewInput, ctx: ToolContext): Promise<GitHubPostReviewResult>;\n}\n\nconst reviewCommentSchema = z\n  .strictObject({\n    key: z\n      .string()\n      .min(1)\n      .max(80)\n      .regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/)\n      .optional()\n      .describe(\n        \"Stable kebab-case identity for this defect and cause; keep it unchanged across reruns.\",\n      ),\n    title: z.string().min(1).max(200).optional().describe(\"Short finding title.\"),\n    path: z.string().min(1).max(500).describe(\"Repository-relative file path.\"),\n    startLine: z\n      .number()\n      .int()\n      .min(1)\n      .optional()\n      .describe(\n        \"First line of a multiline finding in the new version. A suggestion replaces every line from startLine through line, inclusive. Omit when only one line needs replacement.\",\n      ),\n    line: z\n      .number()\n      .int()\n      .min(1)\n      .describe(\n        \"Last affected line in the pull request's new version, within the diff. This is the inclusive end of a suggestion's replacement range.\",\n      ),\n    body: z\n      .string()\n      .min(1)\n      .max(5000)\n      .describe(\n        \"Concise explanation of the defect and its impact. A fenced suggestion must replace the entire selected range, preserving required surrounding syntax. First validate the resulting full file in memory or a temporary copy; if validation fails or cannot run, explain the fix in prose without a suggestion block.\",\n      ),\n  })\n  .refine((comment) => comment.startLine === undefined || comment.startLine < comment.line, {\n    message: \"startLine must precede line; omit it for a single-line finding.\",\n    path: [\"startLine\"],\n  });\nconst reviewCommentsSchema = z\n  .array(reviewCommentSchema)\n  .max(50)\n  .default([])\n  .superRefine((comments, context) => {\n    const seen = new Set<string>();\n    comments.forEach((comment, index) => {\n      if (comment.key === undefined) return;\n      if (seen.has(comment.key)) {\n        context.addIssue({\n          code: \"custom\",\n          message: `duplicate finding key: ${comment.key}`,\n          path: [index, \"key\"],\n        });\n      }\n      seen.add(comment.key);\n    });\n  })\n  .readonly();\n\nconst reviewInputSchema = z\n  .object({\n    taskId: taskIdSchema.describe(\"Your code_review task.\"),\n    changeId: changeIdSchema.describe(\"The pull request change from your starting message.\"),\n    verdict: z.enum([\"approve\", \"request_changes\", \"comment\"]),\n    headSha: z\n      .string()\n      .regex(/^[0-9a-f]{40}$/)\n      .describe(\"Commit returned by fetch_pull_request.\"),\n    comments: reviewCommentsSchema,\n  })\n  .superRefine(({ verdict, comments }, context) => {\n    if (verdict === \"approve\" ? comments.length > 0 : comments.length === 0) {\n      context.addIssue({\n        code: \"custom\",\n        path: [\"comments\"],\n        message:\n          \"Approve only with no findings. For comment or request_changes, put every actionable finding in comments at its affected diff lines.\",\n      });\n    }\n  });\n\n/**\n * Publish an independent review of an existing pull request and finish the\n * review task without changing the pull request's factory lifecycle.\n */\nexport function createGitHubPostReviewTool(\n  input: GitHubPostReviewToolOptions,\n): GitHubPostReviewTool {\n  const { stores, ...options } = input;\n  return defineTool({\n    description:\n      \"Record a completed code review and finish your code_review task. Approve with no comments when clean; otherwise report actionable findings inline, using request_changes only for blocking defects. Factory generates the short review summary.\",\n    inputSchema: reviewInputSchema,\n    async execute(input, ctx): Promise<GitHubPostReviewResult> {\n      const { taskId, changeId, verdict, headSha, comments } = reviewInputSchema.parse(input);\n      const summary =\n        comments.length === 0\n          ? \"No issues found.\"\n          : `${comments.length} finding${comments.length === 1 ? \"\" : \"s\"}. ${verdict === \"request_changes\" ? \"Changes requested. \" : \"\"}See inline comments.`;\n      const task = await requireTaskExecution(stores, ctx, taskId);\n      if (task.kind !== \"code_review\") {\n        return {\n          recorded: false as const,\n          code: \"task_kind_mismatch\",\n          reason: `${taskId} is not a code_review task`,\n        };\n      }\n      if (task.state !== \"running\") {\n        return {\n          recorded: false as const,\n          code: \"task_not_running\",\n          reason: `task is ${task.state}, not running`,\n        };\n      }\n\n      const change = await stores.changes.get(changeId);\n      if (change === null) {\n        return {\n          recorded: false as const,\n          code: \"change_not_found\",\n          reason: `change ${changeId} does not exist`,\n        };\n      }\n      if (change.state !== \"verifying\" && change.state !== \"ready\") {\n        return {\n          recorded: false as const,\n          code: \"change_not_reviewable\",\n          reason: `change is ${change.state}, not open for review`,\n        };\n      }\n      const repository = await stores.repositories.get(change.repositoryId);\n      if (repository === null) {\n        return {\n          recorded: false as const,\n          code: \"repository_not_found\",\n          reason: `repository ${change.repositoryId} does not exist`,\n        };\n      }\n      if (\n        task.changeId !== change.id ||\n        task.repositoryIds.length !== 1 ||\n        task.repositoryIds[0] !== repository.id\n      ) {\n        throw new Error(\"Authenticated review Task, Change, and repository must match\");\n      }\n\n      const token = await options.tokenForRepository(repository.slug);\n      await requireTaskExecution(stores, ctx, taskId);\n      const completedComments = comments.map((comment) => {\n        const key = comment.key ?? legacyFindingKey(comment);\n        return {\n          ...comment,\n          key,\n          title: comment.title ?? \"Review finding\",\n          fingerprint: createHash(\"sha256\")\n            .update(`${repository.slug.toLowerCase()}#${change.prNumber}:${key}`)\n            .digest(\"hex\"),\n        };\n      });\n      const completed = {\n        taskId,\n        attempt: task.attempt,\n        changeId,\n        repository: repository.slug,\n        pullRequestNumber: change.prNumber,\n        headSha,\n        verdict,\n        summary,\n        comments: completedComments,\n      } satisfies CompletedReview;\n      const publish =\n        typeof options.publishReviews === \"function\"\n          ? options.publishReviews(task)\n          : options.publishReviews !== false;\n      let review: SubmittedPullRequestReview | undefined;\n      try {\n        if (publish) {\n          review = await submitPullRequestReview({\n            repository: repository.slug,\n            token,\n            fetch: options.fetch,\n            pullRequestNumber: change.prNumber,\n            commitId: headSha,\n            event:\n              verdict === \"approve\"\n                ? \"APPROVE\"\n                : verdict === \"request_changes\"\n                  ? \"REQUEST_CHANGES\"\n                  : \"COMMENT\",\n            body: summary,\n            comments: completedComments,\n          });\n        } else {\n          const head = await readPullRequestHead({\n            repository: repository.slug,\n            token,\n            fetch: options.fetch,\n            pullRequestNumber: change.prNumber,\n          });\n          if (head.sha !== headSha) {\n            throw new StalePullRequestHeadError(headSha, head.sha);\n          }\n        }\n      } catch (error) {\n        if (!(error instanceof StalePullRequestHeadError)) {\n          throw error;\n        }\n        const current = await requireTaskExecution(stores, ctx, taskId);\n        if (await options.onStaleHead?.(current)) {\n          return {\n            recorded: false,\n            code: \"review_refresh_pending\",\n            reason:\n              \"The PR changed during review. End this turn; Factory will start a fresh attempt against its latest commit after recording usage.\",\n            taskState: (await stores.tasks.get(taskId))?.state ?? current.state,\n          };\n        }\n        // The reviewer refused a stale head: the change moved on while this\n        // review was in flight, so an identical retry against the same head\n        // can never succeed either. Resolve the task as superseded right\n        // here instead of leaving it running for the stall watchdog to\n        // eventually -- and misleadingly -- report as \"stalled\".\n        const resolved = await stores.tasks\n          .transition(taskId, \"cancelled\", {\n            expectFrom: \"running\",\n            expectAttempt: task.attempt,\n            expectExecution: task.execution,\n            reason: `review superseded by newer commits: ${error.message}`,\n          })\n          .catch(() => null);\n        return {\n          recorded: false as const,\n          code: \"stale_pull_request_head\",\n          reason: error.message,\n          taskState:\n            resolved?.state ??\n            (await stores.tasks.get(taskId).catch(() => null))?.state ??\n            task.state,\n        };\n      }\n      await requireTaskExecution(stores, ctx, taskId);\n      if (review !== undefined) await options.onPublished?.({ ...completed, review });\n      await requireTaskExecution(stores, ctx, taskId);\n      await options.onCompleted?.(completed);\n      await stores.tasks.transition(taskId, \"verifying\", {\n        expectFrom: \"running\",\n        expectAttempt: task.attempt,\n        expectExecution: task.execution,\n        reason: summary,\n      });\n      await stores.tasks.transition(taskId, \"succeeded\", {\n        expectFrom: \"verifying\",\n        expectAttempt: task.attempt,\n        expectExecution: task.execution,\n        output: {\n          changeId,\n          headSha,\n          verdict,\n          summary,\n          findingCount: completedComments.length,\n          published: review !== undefined,\n          ...(review === undefined ? {} : { review }),\n        },\n      });\n      return review === undefined\n        ? {\n            recorded: true,\n            verdict,\n            published: false,\n            taskState: \"succeeded\",\n          }\n        : {\n            recorded: true,\n            verdict,\n            published: true,\n            review,\n            taskState: \"succeeded\",\n          };\n    },\n  });\n}\n\nfunction legacyFindingKey(comment: PullRequestReviewComment): string {\n  const digest = createHash(\"sha256\")\n    .update(`${comment.path}:${comment.line}:${comment.body}`)\n    .digest(\"hex\")\n    .slice(0, 24);\n  return `legacy-${digest}`;\n}\n"],"mappings":"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"}

package/dist/code-review/github-reporter.d.mts

@@ -1,14 +1,14 @@
 import { TaskId } from "../schema/id.mjs";
-import { RepositorySlug } from "../schema/repository.mjs";
 import { Task } from "../schema/task.mjs";
 import { DateClock } from "../schema/common.mjs";
+import { RepositorySlug } from "../schema/repository.mjs";
 import { FactoryStores } from "../store/engine.mjs";
 import { CompletedReview } from "./contracts.mjs";
 import { StartReviewCheckInput } from "./preparation.mjs";
 //#region src/code-review/github-reporter.d.ts
 /** Storage, credentials, and presentation settings for GitHub review reporting. */
 interface GitHubReviewReporterOptions {
-  stores: Pick<FactoryStores, "taskEffects" | "changes" | "repositories">;
+  stores: Pick<FactoryStores, "tasks" | "taskEffects" | "changes" | "repositories">;
   tokenForRepository(repositorySlug: RepositorySlug): Promise<string>;
   fetch?: typeof globalThis.fetch;
   checkName?: string;
@@ -21,6 +21,10 @@ interface GitHubReviewReporterOptions {
 interface GitHubReviewReporter {
   startReviewCheck(input: StartReviewCheckInput): Promise<void>;
   completeReviewCheck(review: CompletedReview): Promise<void>;
+  /** Conclude the current attempt's obsolete check before a replacement is admitted. */
+  supersedeReviewCheck(task: Task): Promise<void>;
+  /** Read the commit pinned by the current attempt's recorded check. */
+  readReviewHead(task: Task): Promise<string | null>;
   reconcileReviewChecks(input: ReconcileReviewChecksInput): Promise<ReconcileReviewChecksResult>;
 }
 /** Bounded rotating-page controls for abandoned review-check recovery. */