@vercel/factory 0.0.14 → 0.0.16

package/dist/client.mjs

@@ -0,0 +1,366 @@
+import { taskIdSchema } from "./schema/id.mjs";
+import { repositorySlugSchema } from "./schema/repository.mjs";
+import { taskSchema, taskStateSchema } from "./schema/task.mjs";
+import { readEvents, streamEventSchema } from "./client-events.mjs";
+import { MAX_IMAGES, MAX_IMAGE_BYTES, imageAttachmentSchema, imageAttachmentsSchema, imageIdSchema } from "./image-input.mjs";
+import { inputRequestSchema, toolCallSchema, transcriptBlockSchema, transcriptSnapshotSchema } from "./schema/transcript.mjs";
+import { Transcript } from "./client-transcript.mjs";
+import { approvalPageSchema, approvalRequestSchema, approvalViewSchema } from "./approval-contracts.mjs";
+import { agentSessionIdSchema, agentSessionSchema } from "./schema/session.mjs";
+import { changeSchema } from "./schema/change.mjs";
+import { inboxActivityItemSchema, inboxActivitySchema } from "./inbox-activity.mjs";
+import { agentModelConfigSchema, modelSettingsSchema, updateModelDefaultsSchema } from "./model-settings.mjs";
+import { sessionPreviewSchema, sessionPreviewsSchema } from "./session-previews.mjs";
+import { sessionReviewCheckSchema, sessionReviewIssueSchema, sessionReviewSchema, sessionReviewScreenshotSchema } from "./session-review.mjs";
+import { workspaceFileContentSchema, workspaceFileEntrySchema, workspaceFilesRequestSchema, workspaceFilesSchema, workspacePathSchema } from "./workspace-files.mjs";
+import { describeIntake, intakePageSchema, intakeViewSchema, retryIntakeSchema } from "./intake-contracts.mjs";
+import { answerSessionQuestionRequestSchema, apiAgentSchema, controlSessionRequestSchema, createSessionRequestSchema, pendingFollowUpSchema, repositoryDetailsSchema, repositorySummarySchema, sendSessionMessageRequestSchema, sessionInputResponseSchema, sessionPageSchema, sessionViewSchema, submitSessionInputRequestSchema } from "./api-contracts.mjs";
+import { workspaceDiffFileSchema, workspaceDiffSchema } from "./workspace-diff.mjs";
+import { taskGraphViewSchema } from "./task-graph-view.mjs";
+import { followSessionStream } from "./client-stream.mjs";
+import { z } from "zod";
+//#region src/client.ts
+/** All durable Task states in their schema-defined order. */
+const taskStates = Object.freeze([...taskStateSchema.options]);
+/** An unsuccessful Factory API response surfaced by the browser-safe client. */
+var ApiError = class extends Error {
+	status;
+	actor;
+	constructor(status, message, actor) {
+		super(message);
+		this.status = status;
+		this.actor = actor;
+	}
+};
+/**
+* Browser-safe typed client for the public Factory HTTP API.
+*
+* @remarks
+* Requests use same-origin credentials, bypass HTTP caches, and refuse redirects so authentication
+* redirects cannot be mistaken for API responses. When no caller signal is available, requests
+* time out after 30 seconds. Non-success responses throw {@link ApiError}; successful JSON bodies
+* are still validated against their public schemas before being returned.
+*/
+var FactoryClient = class {
+	options;
+	origin;
+	/**
+	* Creates a client for one canonical Factory origin without performing a request.
+	*
+	* @param options - Factory origin plus optional per-request headers and fetch implementation.
+	* @throws When `options.url` is not an HTTPS origin or an HTTP loopback origin.
+	*/
+	constructor(options) {
+		this.options = options;
+		const url = new URL(options.url);
+		if (url.username || url.password || url.pathname !== "/" || url.search || url.hash || url.protocol !== "https:" && !(url.protocol === "http:" && [
+			"localhost",
+			"127.0.0.1",
+			"[::1]"
+		].includes(url.hostname))) throw new Error("Factory URL must be an HTTPS origin, or HTTP on loopback");
+		this.origin = url.origin;
+	}
+	async response(path, body, signal) {
+		const url = new URL(`/api/v1/${path}`, this.origin);
+		if (url.origin !== this.origin || !url.pathname.startsWith("/api/v1/")) throw new Error("Invalid Factory API path");
+		const headers = new Headers(await this.options.headers?.());
+		headers.set("content-type", "application/json");
+		const response = await (this.options.fetch ?? globalThis.fetch)(url.href, {
+			method: body === void 0 ? "GET" : "POST",
+			headers,
+			...body === void 0 ? {} : { body: JSON.stringify(body) },
+			credentials: "same-origin",
+			cache: "no-store",
+			redirect: "manual",
+			signal: signal ?? AbortSignal.timeout(3e4)
+		});
+		if (response.type === "opaqueredirect" || [
+			301,
+			302,
+			303,
+			307,
+			308
+		].includes(response.status)) {
+			await response.body?.cancel();
+			throw new ApiError(response.status, `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.`);
+		}
+		if (!response.ok) {
+			const value = await response.json().catch(() => null);
+			const detail = value !== null && typeof value === "object" && "error" in value && typeof value.error === "string" ? value.error : `HTTP ${response.status}`;
+			const actor = value !== null && typeof value === "object" && "actor" in value && typeof value.actor === "string" ? value.actor : void 0;
+			throw new ApiError(response.status, response.status === 401 ? "Authentication rejected. Reload to sign in, or run vercel login for the terminal client." : detail, actor);
+		}
+		return response;
+	}
+	/** Read authorized intake and pre-task triage failures. */
+	async intake(options = {}) {
+		const query = new URLSearchParams();
+		for (const [key, value] of Object.entries(options)) if (value !== void 0) query.set(key, String(value));
+		return intakePageSchema.parse(await (await this.response(`intake?${query}`)).json());
+	}
+	/** Retry only the observed stopped attempt; concurrent or stale retries conflict. */
+	async retryIntake(id, expectedAttempt) {
+		return intakeViewSchema.parse(await (await this.response(`intake/${encodeURIComponent(id)}/retry`, retryIntakeSchema.parse({ expectedAttempt }))).json());
+	}
+	/** Lists approval proposals visible to the authenticated operator. */
+	async listApprovals(options = {}) {
+		const query = new URLSearchParams(Object.entries(options).filter(([, value]) => value !== void 0).map(([key, value]) => [key, String(value)]));
+		return approvalPageSchema.parse(await (await this.response(`approvals?${query}`)).json());
+	}
+	/** Reads one approval proposal by Task ID. */
+	async getApproval(id) {
+		return approvalViewSchema.parse(await (await this.response(`tasks/${encodeURIComponent(id)}/approval`)).json());
+	}
+	/** Approves one proposal, optionally recording an operator reason. */
+	async approveTask(id, reason) {
+		return approvalViewSchema.parse(await (await this.response(`tasks/${encodeURIComponent(id)}/approve`, approvalRequestSchema.parse({ reason }))).json());
+	}
+	/** Rejects one proposal with the required operator reason. */
+	async rejectTask(id, reason) {
+		return approvalViewSchema.parse(await (await this.response(`tasks/${encodeURIComponent(id)}/reject`, approvalRequestSchema.parse({ reason }))).json());
+	}
+	/** Uploads one bounded image for use in a later message. */
+	async uploadImage(input) {
+		return imageAttachmentSchema.parse(await (await this.response("images", input)).json());
+	}
+	/** Downloads a previously uploaded image. */
+	async getImage(options) {
+		return (await this.response(`images/${encodeURIComponent(options.id)}`, void 0, options.signal)).blob();
+	}
+	/** Lists agents exposed for operator session creation. */
+	async listAgents() {
+		return z.object({ agents: z.array(apiAgentSchema).readonly() }).parse(await (await this.response("agents")).json()).agents;
+	}
+	/** Reports whether the configured origin is the isolated local fixture runtime. */
+	async isLocalTestRuntime() {
+		const response = await this.response("agents");
+		const local = response.headers.get("x-factory-local-test") === "1";
+		await response.body?.cancel();
+		return local;
+	}
+	/** Lists configured repository slugs. */
+	async listRepositories() {
+		return z.object({ repositories: z.array(repositorySlugSchema).readonly() }).parse(await (await this.response("repositories")).json()).repositories;
+	}
+	/** Reads repository slugs together with their stable configured identifiers. */
+	async getRepositoryDetails() {
+		return repositoryDetailsSchema.parse(await (await this.response("repositories")).json());
+	}
+	/** Lists open Changes, optionally scoped to one repository slug. */
+	async listChanges(repository) {
+		return z.object({ changes: z.array(changeSchema).readonly() }).parse(await (await this.response(repository === void 0 ? "changes" : `changes?repository=${encodeURIComponent(repository)}`)).json()).changes;
+	}
+	/** Lists canonical Tasks exposed by the operator API. */
+	async listTasks() {
+		return z.strictObject({ tasks: z.array(taskSchema).readonly() }).parse(await (await this.response("tasks")).json()).tasks;
+	}
+	/**
+	* Lists sessions matching the requested operator scope without pagination metadata.
+	*
+	* @param options - Optional scope and detail projection; both use their server defaults when omitted.
+	* @returns The first matching page's sessions. Use {@link getSessionPage} to follow cursors.
+	*/
+	async listSessions(options = {}) {
+		return (await this.getSessionPage(options)).sessions;
+	}
+	/**
+	* Reads a filtered, cursor-paginated page of sessions.
+	*
+	* @param options - Filters, cursor, projection detail, and page limit sent to the API.
+	* @returns The validated page, including its continuation cursor and optional total count.
+	*/
+	async getSessionPage(options = {}) {
+		const query = new URLSearchParams(Object.entries(options).filter(([, value]) => value !== void 0).map(([key, value]) => [key, String(value)])).toString();
+		return sessionPageSchema.parse(await (await this.response(`sessions${query ? `?${query}` : ""}`)).json());
+	}
+	/** Reads application-owned external work requiring operator attention. */
+	async getInboxActivity() {
+		return inboxActivitySchema.parse(await (await this.response("inbox-activity")).json());
+	}
+	/** Reads application model choices and optional repository defaults. */
+	async getModelSettings(repository) {
+		const query = repository ? `?${new URLSearchParams({ repository })}` : "";
+		return modelSettingsSchema.parse(await (await this.response(`models${query}`)).json());
+	}
+	/** Saves repository defaults only when their observed revision still matches. */
+	async updateModelDefaults(input) {
+		return modelSettingsSchema.parse(await (await this.response("models", updateModelDefaultsSchema.parse(input))).json());
+	}
+	/** Counts sessions that currently require operator attention. */
+	async getInboxCount() {
+		return z.object({ totalCount: z.number().int().nonnegative() }).parse(await (await this.response("sessions?scope=all&detail=summary&attention=true&includeTotal=true&limit=1")).json()).totalCount;
+	}
+	/** Reads a summary batch for the provided session IDs. */
+	async getSessionBatch(ids) {
+		if (ids.length === 0) return [];
+		const query = new URLSearchParams({
+			ids: ids.join(","),
+			detail: "summary"
+		});
+		return z.object({ sessions: z.array(sessionViewSchema).readonly() }).parse(await (await this.response(`sessions?${query}`)).json()).sessions;
+	}
+	/**
+	* Reads one operator session.
+	*
+	* @param options - Stable session ID and optional summary or full projection.
+	* @returns The current validated session view; it is a snapshot and does not follow live events.
+	*/
+	async getSession(options) {
+		return sessionViewSchema.parse(await (await this.response(`sessions/${encodeURIComponent(options.id)}${options.detail ? `?detail=${options.detail}` : ""}`)).json());
+	}
+	/** Reads the canonical task graph projected for one session. */
+	async getSessionGraph(options) {
+		return taskGraphViewSchema.parse(await (await this.response(`sessions/${encodeURIComponent(options.id)}/graph`, void 0, options.signal)).json());
+	}
+	/** Reads the materialized transcript for one exact graph task execution. */
+	async getGraphTranscript(options) {
+		const query = new URLSearchParams({
+			taskId: options.taskId,
+			executionId: options.executionId
+		});
+		return transcriptSnapshotSchema.parse(await (await this.response(`sessions/${encodeURIComponent(options.sessionId)}/graph-transcript?${query}`, void 0, options.signal)).json());
+	}
+	/** Refreshes a session summary and reloads its history when the active execution changes. */
+	async refreshSession(previous) {
+		const current = await this.getSession({
+			id: previous.session.id,
+			detail: "summary"
+		});
+		if (current.task?.id !== previous.task?.id || current.execution?.sessionId !== previous.execution?.sessionId || current.execution?.provider !== previous.execution?.provider) return this.getSession({ id: previous.session.id });
+		return {
+			...current,
+			history: previous.history
+		};
+	}
+	/** Reads application-owned previews without starting an agent, deployment, or server. */
+	async getSessionPreviews(options) {
+		return sessionPreviewsSchema.parse(await (await this.response(`sessions/${encodeURIComponent(options.sessionId)}/previews?${new URLSearchParams({ executionId: options.executionId ?? "" })}`, void 0, options.signal)).json());
+	}
+	/** Reads recorded checks, screenshots, and issues through the application's review reader. */
+	async getSessionReview(options) {
+		return sessionReviewSchema.parse(await (await this.response(`sessions/${encodeURIComponent(options.sessionId)}/review?${new URLSearchParams({ executionId: options.executionId ?? "" })}`, void 0, options.signal)).json());
+	}
+	/** Reads a directory or complete file through the factory's configured workspace adapter. */
+	async getWorkspaceFiles(options) {
+		const query = workspaceFilesRequestSchema.parse({
+			path: options.path,
+			revision: options.revision
+		});
+		const params = new URLSearchParams({
+			executionId: options.executionId ?? "",
+			path: query.path
+		});
+		if (query.revision !== void 0) params.set("revision", query.revision);
+		return workspaceFilesSchema.parse(await (await this.response(`sessions/${encodeURIComponent(options.sessionId)}/files?${params}`, void 0, options.signal)).json());
+	}
+	/** Reads the committed workspace comparison for one observed execution. */
+	async getWorkspaceDiff(options) {
+		return workspaceDiffSchema.parse(await (await this.response(`sessions/${encodeURIComponent(options.sessionId)}/diff?${new URLSearchParams({ executionId: options.executionId ?? "" })}`, void 0, options.signal)).json());
+	}
+	/**
+	* Creates or recovers an idempotent conversational session.
+	*
+	* @remarks
+	* Retain `input.operationId` unchanged across ambiguous failures. Reusing it with identical input
+	* returns the original session; reusing it with different input is a conflict. The returned view
+	* means admission and any initial dispatch attempt finished, not that the agent's work completed.
+	*
+	* @param input - Agent, initial content, optional repository/change, and client idempotency key.
+	* @returns The admitted or recovered session snapshot.
+	*/
+	async createSession(input) {
+		return sessionViewSchema.parse(await (await this.response("sessions", createSessionRequestSchema.parse(input))).json());
+	}
+	/** Creates or recovers idempotent workflow work through a specialist signal. */
+	async createSignal(input) {
+		return sessionViewSchema.parse(await (await this.response("signals", createSessionRequestSchema.parse(input))).json());
+	}
+	/** Starts a deepsec security scan of a repository, or returns its already-active scan. */
+	async runSecurityScan(repositoryId) {
+		return z.strictObject({
+			taskId: taskIdSchema,
+			reused: z.boolean()
+		}).parse(await (await this.response(`repositories/${repositoryId}/security-scan`, {})).json());
+	}
+	/**
+	* Sends a message to an existing session using optimistic execution matching.
+	*
+	* @remarks
+	* `input.executionId` must be the execution the caller observed, or `null` when none was active.
+	* A completed Task follow-up also requires an `operationId`, which must be retained for retries.
+	* Resolving means the API accepted the message; provider or follow-up work may still be running.
+	*
+	* @param id - Stable Factory session receiving the message.
+	* @param input - Message, observed execution, steering policy, attachments, and optional retry key.
+	* @returns Nothing after the API accepts the request.
+	*/
+	async sendSessionMessage(id, input) {
+		await (await this.response(`sessions/${encodeURIComponent(id)}/messages`, sendSessionMessageRequestSchema.parse(input))).body?.cancel();
+	}
+	/**
+	* Submits responses to pending provider input requests.
+	*
+	* @param id - Stable Factory session whose provider requested input.
+	* @param input - Observed execution ID and one or more request-correlated responses.
+	* @returns Nothing after the API accepts the responses; stale execution IDs are rejected.
+	*/
+	async submitSessionInput(id, input) {
+		await (await this.response(`sessions/${encodeURIComponent(id)}/input`, submitSessionInputRequestSchema.parse(input))).body?.cancel();
+	}
+	/**
+	* Attempts to dispatch queued workflow work associated with a session.
+	*
+	* @param id - Stable Factory session whose current work should be dispatched.
+	* @returns The refreshed session after the bounded dispatch attempt, which may still be queued.
+	*/
+	async dispatchSession(id) {
+		return sessionViewSchema.parse(await (await this.response(`sessions/${encodeURIComponent(id)}/dispatch`, {})).json());
+	}
+	/** Answers a workflow question associated with a session. */
+	async answerSessionQuestion(id, input) {
+		return sessionViewSchema.parse(await (await this.response(`sessions/${encodeURIComponent(id)}/answer`, answerSessionQuestionRequestSchema.parse(input))).json());
+	}
+	/** Cooperatively interrupts the currently observed turn. */
+	async interruptSession(id, input = {}) {
+		return this.controlSession(id, "interrupt", input);
+	}
+	/** Cancels active workflow and provider work in a session. */
+	async cancelSession(id, input = {}) {
+		return this.controlSession(id, "cancel", input);
+	}
+	/** Compacts the provider context for a session. */
+	async compactSession(id, input = {}) {
+		return this.controlSession(id, "compact", input);
+	}
+	/** Clears the provider context for a session. */
+	async clearSession(id, input = {}) {
+		return this.controlSession(id, "clear", input);
+	}
+	/** Resets a session after cancelling its active work. */
+	async resetSession(id, input = {}) {
+		return this.controlSession(id, "reset", input);
+	}
+	/** Reads a materialized transcript as a raw HTTP response for incremental following. */
+	async getSessionTranscriptResponse(input) {
+		const query = new URLSearchParams({ executionId: input.executionId });
+		if (input.history === true) query.set("history", "1");
+		if (input.taskId !== void 0) query.set("taskId", input.taskId);
+		return this.response(`sessions/${encodeURIComponent(input.sessionId)}/${input.taskId ? "graph-transcript" : "transcript"}?${query}`, void 0, input.signal);
+	}
+	/** Opens a cursor-addressed session event stream as a raw HTTP response. */
+	async getSessionEventStreamResponse(input) {
+		const query = new URLSearchParams({
+			executionId: input.executionId,
+			startIndex: String(input.cursor)
+		});
+		if (input.taskId !== void 0) query.set("taskId", input.taskId);
+		return this.response(`sessions/${encodeURIComponent(input.sessionId)}/${input.taskId ? "graph-stream" : "stream"}?${query}`, void 0, input.signal);
+	}
+	async controlSession(id, action, input) {
+		await (await this.response(`sessions/${encodeURIComponent(id)}/${action}`, controlSessionRequestSchema.parse(input))).body?.cancel();
+	}
+};
+//#endregion
+export { ApiError, FactoryClient, MAX_IMAGES, MAX_IMAGE_BYTES, Transcript, agentModelConfigSchema, agentSessionIdSchema, agentSessionSchema, answerSessionQuestionRequestSchema, apiAgentSchema, controlSessionRequestSchema, createSessionRequestSchema, describeIntake, followSessionStream, imageAttachmentSchema, imageAttachmentsSchema, imageIdSchema, inboxActivityItemSchema, inboxActivitySchema, inputRequestSchema, modelSettingsSchema, pendingFollowUpSchema, readEvents, repositoryDetailsSchema, repositorySummarySchema, sendSessionMessageRequestSchema, sessionInputResponseSchema, sessionPageSchema, sessionPreviewSchema, sessionPreviewsSchema, sessionReviewCheckSchema, sessionReviewIssueSchema, sessionReviewSchema, sessionReviewScreenshotSchema, sessionViewSchema, streamEventSchema, submitSessionInputRequestSchema, taskStates, toolCallSchema, transcriptBlockSchema, transcriptSnapshotSchema, updateModelDefaultsSchema, workspaceDiffFileSchema, workspaceDiffSchema, workspaceFileContentSchema, workspaceFileEntrySchema, workspaceFilesRequestSchema, workspaceFilesSchema, workspacePathSchema };
+
+//# sourceMappingURL=client.mjs.map

package/dist/client.mjs.map

@@ -0,0 +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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"}

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

@@ -0,0 +1,27 @@
+import { ChangeId, TaskId } from "../schema/id.mjs";
+import { RepositorySlug } from "../schema/repository.mjs";
+//#region src/code-review/contracts.d.ts
+/** A review result bound to the exact Task, Change, repository, pull request, and head commit. */
+interface CompletedReview {
+  taskId: TaskId;
+  changeId: ChangeId;
+  repository: RepositorySlug;
+  pullRequestNumber: number;
+  headSha: string;
+  verdict: "approve" | "request_changes" | "comment";
+  summary: string;
+  comments: readonly CompletedReviewFinding[];
+}
+/** One stable, fingerprinted inline finding from a completed review. */
+interface CompletedReviewFinding {
+  fingerprint: string;
+  key: string;
+  title: string;
+  path: string;
+  startLine?: number;
+  line: number;
+  body: string;
+}
+//#endregion
+export { CompletedReview, CompletedReviewFinding };
+//# sourceMappingURL=contracts.d.mts.map

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

@@ -0,0 +1,70 @@
+import { ChangeId, TaskId } from "../schema/id.mjs";
+import { RepositorySlug } from "../schema/repository.mjs";
+import { Task, TaskState } from "../schema/task.mjs";
+import { FactoryStores } from "../store/engine.mjs";
+import { CompletedReview, CompletedReviewFinding } from "./contracts.mjs";
+import { SubmittedPullRequestReview } from "../github.mjs";
+import { PublishedGitHubReview } from "./github-contracts.mjs";
+import { ToolContext, ToolDefinition } from "eve/tools";
+//#region src/code-review/eve-post-review.d.ts
+/** Change, repository, and Task capabilities required by the review publication tool. */
+type GitHubPostReviewToolStores = Pick<FactoryStores, "changes" | "repositories" | "tasks">;
+/** Configures GitHub access, publication, and durable review-reporting callbacks. */
+interface GitHubPostReviewToolOptions {
+  stores: GitHubPostReviewToolStores;
+  tokenForRepository: (repository: RepositorySlug) => Promise<string>;
+  /** Whether to publish a GitHub review, optionally selected from the authenticated Task. Defaults to true. */
+  publishReviews?: boolean | ((task: Task) => boolean);
+  onCompleted?: (completed: CompletedReview) => Promise<void>;
+  onPublished?: (published: PublishedGitHubReview) => Promise<void>;
+  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";
+/** Outcome returned after validating, recording, and optionally publishing a code review. */
+type GitHubPostReviewResult = {
+  readonly recorded: false;
+  readonly code: GitHubPostReviewFailureCode;
+  readonly reason: string;
+  readonly taskState?: TaskState;
+  readonly verdict?: never;
+  readonly published?: never;
+  readonly review?: never;
+} | {
+  readonly recorded: true;
+  readonly verdict: CompletedReview["verdict"];
+  readonly published: false;
+  readonly review?: never;
+  readonly taskState: "succeeded";
+} | {
+  readonly recorded: true;
+  readonly verdict: CompletedReview["verdict"];
+  readonly published: true;
+  readonly review: SubmittedPullRequestReview;
+  readonly taskState: "succeeded";
+};
+/** Inline review finding accepted before Factory assigns its stable fingerprint. */
+interface GitHubPostReviewCommentInput extends Pick<CompletedReviewFinding, "path" | "startLine" | "line" | "body"> {
+  key?: string;
+  title?: string;
+}
+/** Completed review supplied for validation, recording, and optional GitHub publication. */
+interface GitHubPostReviewInput {
+  taskId: TaskId;
+  changeId: ChangeId;
+  verdict: CompletedReview["verdict"];
+  headSha: string;
+  comments: readonly GitHubPostReviewCommentInput[];
+}
+/** Eve outcome tool that records and optionally publishes one completed code review. */
+interface GitHubPostReviewTool extends ToolDefinition<GitHubPostReviewInput, GitHubPostReviewResult> {
+  execute(input: GitHubPostReviewInput, ctx: ToolContext): Promise<GitHubPostReviewResult>;
+}
+/**
+ * Publish an independent review of an existing pull request and finish the
+ * review task without changing the pull request's factory lifecycle.
+ */
+declare function createGitHubPostReviewTool(input: GitHubPostReviewToolOptions): GitHubPostReviewTool;
+//#endregion
+export { GitHubPostReviewCommentInput, GitHubPostReviewFailureCode, GitHubPostReviewInput, GitHubPostReviewResult, GitHubPostReviewTool, GitHubPostReviewToolOptions, GitHubPostReviewToolStores, createGitHubPostReviewTool };
+//# sourceMappingURL=eve-post-review.d.mts.map