@vercel/factory 0.0.13 → 0.0.15

package/dist/client.d.mts

@@ -0,0 +1,234 @@
+import { SignalSource } from "./schema/signal.mjs";
+import { TaskId } from "./schema/id.mjs";
+import { RepositorySlug } from "./schema/repository.mjs";
+import { Task } from "./schema/task.mjs";
+import { MaybePromise } from "./schema/common.mjs";
+import { ImageAttachment, ImageId, ImageUploadInput, MAX_IMAGES, MAX_IMAGE_BYTES, imageAttachmentSchema, imageAttachmentsSchema, imageIdSchema } from "./image-input.mjs";
+import { AgentSession, AgentSessionId, DirectAgentSession, ExternalAgentSession, TaskAgentSession, agentSessionIdSchema, agentSessionSchema } from "./schema/session.mjs";
+import { Change } from "./schema/change.mjs";
+import { InputRequest, ToolCall, TranscriptBlock, TranscriptSnapshot, inputRequestSchema, toolCallSchema, transcriptBlockSchema, transcriptSnapshotSchema } from "./schema/transcript.mjs";
+import { ApprovalListOptions, ApprovalPage, ApprovalView } from "./approval-contracts.mjs";
+import { WorkspaceDiff, WorkspaceDiffFile, workspaceDiffFileSchema, workspaceDiffSchema } from "./workspace-diff.mjs";
+import "./signals.mjs";
+import { IntakeView, describeIntake } from "./intake-contracts.mjs";
+import { TaskGraphView } from "./task-graph-view.mjs";
+import { StreamEvent, readEvents, streamEventSchema } from "./client-events.mjs";
+import { Transcript } from "./client-transcript.mjs";
+import { FollowSessionStreamOptions, SessionStreamClient, followSessionStream } from "./client-stream.mjs";
+import { AnswerSessionQuestionRequest, ApiAgent, ControlSessionRequest, CreateSessionRequest, PendingFollowUp, RepositoryDetails, RepositorySummary, SendSessionMessageRequest, SessionInputResponse, SessionPage, SessionView, SubmitSessionInputRequest, answerSessionQuestionRequestSchema, apiAgentSchema, controlSessionRequestSchema, createSessionRequestSchema, pendingFollowUpSchema, repositoryDetailsSchema, repositorySummarySchema, sendSessionMessageRequestSchema, sessionInputResponseSchema, sessionPageSchema, sessionViewSchema, submitSessionInputRequestSchema } from "./api-contracts.mjs";
+//#region src/client.d.ts
+/** All durable Task states in their schema-defined order. */
+declare const taskStates: readonly ("queued" | "running" | "stalled" | "verifying" | "succeeded" | "failed" | "needs_human" | "cancelled")[];
+/** Filters and pagination accepted by the session-list API. */
+interface SessionListOptions {
+  readonly scope?: "all" | "interactive";
+  readonly detail?: "full" | "summary";
+  readonly limit?: number;
+  readonly cursor?: AgentSessionId;
+  readonly query?: string;
+  readonly repository?: RepositorySlug;
+  readonly agent?: string;
+  readonly source?: "automatic";
+  readonly state?: Task["state"] | "conversation";
+  readonly attention?: boolean;
+  readonly topLevel?: boolean;
+  readonly includeTotal?: boolean;
+}
+/** An unsuccessful Factory API response surfaced by the browser-safe client. */
+declare class ApiError extends Error {
+  readonly status: number;
+  readonly actor?: string | undefined;
+  constructor(status: number, message: string, actor?: string | undefined);
+}
+/** Connection and request customization for {@link FactoryClient}. */
+interface FactoryClientOptions {
+  readonly url: string;
+  readonly headers?: () => MaybePromise<HeadersInit>;
+  readonly fetch?: typeof globalThis.fetch;
+}
+/** Identifies an uploaded image and optionally controls cancellation of its download. */
+interface GetImageOptions {
+  readonly id: ImageId;
+  readonly signal?: AbortSignal;
+}
+/** Identifies an operator session and the amount of detail to return. */
+interface GetSessionOptions {
+  readonly id: AgentSessionId;
+  readonly detail?: "full" | "summary";
+}
+/** Identifies the operator session whose canonical task graph should be read. */
+interface GetSessionGraphOptions {
+  readonly id: AgentSessionId;
+  readonly signal?: AbortSignal;
+}
+/** Identifies an exact task execution transcript within an operator session. */
+interface GraphTranscriptOptions {
+  readonly sessionId: AgentSessionId;
+  readonly taskId: TaskId;
+  readonly executionId: string;
+  readonly signal?: AbortSignal;
+}
+/** Identifies the execution whose committed workspace should be compared. */
+interface WorkspaceDiffOptions {
+  readonly sessionId: AgentSessionId;
+  readonly executionId: string | null;
+  readonly signal?: AbortSignal;
+}
+/** Identifies a materialized transcript response used by the stream follower. */
+interface SessionTranscriptRequest {
+  readonly sessionId: AgentSessionId;
+  readonly executionId: string;
+  readonly taskId?: TaskId;
+  readonly history?: boolean;
+  readonly signal: AbortSignal;
+}
+/** Identifies a cursor-addressed event stream used by the stream follower. */
+interface SessionEventStreamRequest {
+  readonly sessionId: AgentSessionId;
+  readonly executionId: string;
+  readonly cursor: number;
+  readonly taskId?: TaskId;
+  readonly signal: AbortSignal;
+}
+/** Browser-safe typed client for the public Factory HTTP API. */
+declare class FactoryClient {
+  private readonly options;
+  private readonly origin;
+  constructor(options: FactoryClientOptions);
+  private response;
+  /** Read authorized intake and pre-task triage failures. */
+  intake(options?: {
+    repository?: string;
+    cursor?: string;
+    limit?: number;
+  }): Promise<{
+    items: {
+      id: `sig_${string}`;
+      schemaVersion: 1;
+      repositoryId: `repo_${string}`;
+      source: SignalSource;
+      deliveryId: string;
+      replyTo: {
+        channel: string;
+        address: string;
+      };
+      receivedAt: string;
+      outcome: "pending" | "accepted" | "duplicate" | "unactionable" | "low_confidence" | "ignored";
+      repository: string;
+      taskIds: `task_${string}`[];
+      triage?: {
+        attempt: number;
+        state: "running" | "blocked" | "uncertain";
+        by: string;
+        startedAt: string;
+        updatedAt: string;
+        sessionId?: string | undefined;
+        failure?: "cancelled" | "billing_verification_required" | "provider_failed" | "no_decision" | "launch_unconfirmed" | undefined;
+      } | undefined;
+      detail?: string | undefined;
+      reason?: string | undefined;
+      decidedAt?: string | undefined;
+    }[];
+    nextCursor: string | null;
+  }>;
+  /** Retry only the observed stopped attempt; concurrent or stale retries conflict. */
+  retryIntake(id: string, expectedAttempt: number): Promise<{
+    id: `sig_${string}`;
+    schemaVersion: 1;
+    repositoryId: `repo_${string}`;
+    source: SignalSource;
+    deliveryId: string;
+    replyTo: {
+      channel: string;
+      address: string;
+    };
+    receivedAt: string;
+    outcome: "pending" | "accepted" | "duplicate" | "unactionable" | "low_confidence" | "ignored";
+    repository: string;
+    taskIds: `task_${string}`[];
+    triage?: {
+      attempt: number;
+      state: "running" | "blocked" | "uncertain";
+      by: string;
+      startedAt: string;
+      updatedAt: string;
+      sessionId?: string | undefined;
+      failure?: "cancelled" | "billing_verification_required" | "provider_failed" | "no_decision" | "launch_unconfirmed" | undefined;
+    } | undefined;
+    detail?: string | undefined;
+    reason?: string | undefined;
+    decidedAt?: string | undefined;
+  }>;
+  /** Lists approval proposals visible to the authenticated operator. */
+  listApprovals(options?: ApprovalListOptions): Promise<ApprovalPage>;
+  /** Reads one approval proposal by Task ID. */
+  getApproval(id: TaskId): Promise<ApprovalView>;
+  /** Approves one proposal, optionally recording an operator reason. */
+  approveTask(id: TaskId, reason?: string): Promise<ApprovalView>;
+  /** Rejects one proposal with the required operator reason. */
+  rejectTask(id: TaskId, reason: string): Promise<ApprovalView>;
+  /** Uploads one bounded image for use in a later message. */
+  uploadImage(input: ImageUploadInput): Promise<ImageAttachment>;
+  /** Downloads a previously uploaded image. */
+  getImage(options: GetImageOptions): Promise<Blob>;
+  /** Lists agents exposed for operator session creation. */
+  listAgents(): Promise<readonly ApiAgent[]>;
+  /** Reports whether the configured origin is the isolated local fixture runtime. */
+  isLocalTestRuntime(): Promise<boolean>;
+  /** Lists configured repository slugs. */
+  listRepositories(): Promise<readonly RepositorySlug[]>;
+  /** Reads repository slugs together with their stable configured identifiers. */
+  getRepositoryDetails(): Promise<RepositoryDetails>;
+  /** Lists open Changes, optionally scoped to one repository slug. */
+  listChanges(repository?: RepositorySlug): Promise<readonly Change[]>;
+  /** Lists canonical Tasks exposed by the operator API. */
+  listTasks(): Promise<readonly Task[]>;
+  /** Lists sessions matching the requested operator scope. */
+  listSessions(options?: Pick<SessionListOptions, "scope" | "detail">): Promise<readonly SessionView[]>;
+  /** Reads a filtered, cursor-paginated page of sessions. */
+  getSessionPage(options?: SessionListOptions): Promise<SessionPage>;
+  /** Counts sessions that currently require operator attention. */
+  getInboxCount(): Promise<number>;
+  /** Reads a summary batch for the provided session IDs. */
+  getSessionBatch(ids: readonly AgentSessionId[]): Promise<readonly SessionView[]>;
+  /** Reads one operator session. */
+  getSession(options: GetSessionOptions): Promise<SessionView>;
+  /** Reads the canonical task graph projected for one session. */
+  getSessionGraph(options: GetSessionGraphOptions): Promise<TaskGraphView>;
+  /** Reads the materialized transcript for one exact graph task execution. */
+  getGraphTranscript(options: GraphTranscriptOptions): Promise<TranscriptSnapshot>;
+  /** Refreshes a session summary and reloads its history when the active execution changes. */
+  refreshSession(previous: SessionView): Promise<SessionView>;
+  /** Reads the committed workspace comparison for one observed execution. */
+  getWorkspaceDiff(options: WorkspaceDiffOptions): Promise<WorkspaceDiff>;
+  /** Creates or recovers an idempotent conversational session. */
+  createSession(input: CreateSessionRequest): Promise<SessionView>;
+  /** Creates or recovers idempotent workflow work through a specialist signal. */
+  createSignal(input: CreateSessionRequest): Promise<SessionView>;
+  /** Sends a message to an existing session. */
+  sendSessionMessage(id: AgentSessionId, input: SendSessionMessageRequest): Promise<void>;
+  /** Submits responses to pending provider input requests. */
+  submitSessionInput(id: AgentSessionId, input: SubmitSessionInputRequest): Promise<void>;
+  /** Dispatches queued workflow work associated with a session. */
+  dispatchSession(id: AgentSessionId): Promise<SessionView>;
+  /** Answers a workflow question associated with a session. */
+  answerSessionQuestion(id: AgentSessionId, input: AnswerSessionQuestionRequest): Promise<SessionView>;
+  /** Cooperatively interrupts the currently observed turn. */
+  interruptSession(id: AgentSessionId, input?: ControlSessionRequest): Promise<void>;
+  /** Cancels active workflow and provider work in a session. */
+  cancelSession(id: AgentSessionId, input?: ControlSessionRequest): Promise<void>;
+  /** Compacts the provider context for a session. */
+  compactSession(id: AgentSessionId, input?: ControlSessionRequest): Promise<void>;
+  /** Clears the provider context for a session. */
+  clearSession(id: AgentSessionId, input?: ControlSessionRequest): Promise<void>;
+  /** Resets a session after cancelling its active work. */
+  resetSession(id: AgentSessionId, input?: ControlSessionRequest): Promise<void>;
+  /** Reads a materialized transcript as a raw HTTP response for incremental following. */
+  getSessionTranscriptResponse(input: SessionTranscriptRequest): Promise<Response>;
+  /** Opens a cursor-addressed session event stream as a raw HTTP response. */
+  getSessionEventStreamResponse(input: SessionEventStreamRequest): Promise<Response>;
+  private controlSession;
+}
+//#endregion
+export { type AgentSession, type AgentSessionId, type AnswerSessionQuestionRequest, type ApiAgent, ApiError, type ApprovalListOptions, type ApprovalPage, type ApprovalView, type ControlSessionRequest, type CreateSessionRequest, type DirectAgentSession, type ExternalAgentSession, FactoryClient, FactoryClientOptions, type FollowSessionStreamOptions, GetImageOptions, GetSessionGraphOptions, GetSessionOptions, GraphTranscriptOptions, type ImageAttachment, type ImageId, type ImageUploadInput, type InputRequest, type IntakeView, MAX_IMAGES, MAX_IMAGE_BYTES, type PendingFollowUp, type RepositoryDetails, type RepositorySummary, type SendSessionMessageRequest, SessionEventStreamRequest, type SessionInputResponse, SessionListOptions, type SessionPage, type SessionStreamClient, SessionTranscriptRequest, type SessionView, type StreamEvent, type SubmitSessionInputRequest, type TaskAgentSession, type TaskGraphView, type ToolCall, Transcript, type TranscriptBlock, type TranscriptSnapshot, type WorkspaceDiff, type WorkspaceDiffFile, WorkspaceDiffOptions, agentSessionIdSchema, agentSessionSchema, answerSessionQuestionRequestSchema, apiAgentSchema, controlSessionRequestSchema, createSessionRequestSchema, describeIntake, followSessionStream, imageAttachmentSchema, imageAttachmentsSchema, imageIdSchema, inputRequestSchema, pendingFollowUpSchema, readEvents, repositoryDetailsSchema, repositorySummarySchema, sendSessionMessageRequestSchema, sessionInputResponseSchema, sessionPageSchema, sessionViewSchema, streamEventSchema, submitSessionInputRequestSchema, taskStates, toolCallSchema, transcriptBlockSchema, transcriptSnapshotSchema, workspaceDiffFileSchema, workspaceDiffSchema };
+//# sourceMappingURL=client.d.mts.map

package/dist/client.mjs

@@ -0,0 +1,258 @@
+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 { 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. */
+var FactoryClient = class {
+	options;
+	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. */
+	async listSessions(options = {}) {
+		return (await this.getSessionPage(options)).sessions;
+	}
+	/** Reads a filtered, cursor-paginated page of sessions. */
+	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());
+	}
+	/** 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. */
+	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 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. */
+	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());
+	}
+	/** Sends a message to an existing session. */
+	async sendSessionMessage(id, input) {
+		await (await this.response(`sessions/${encodeURIComponent(id)}/messages`, sendSessionMessageRequestSchema.parse(input))).body?.cancel();
+	}
+	/** Submits responses to pending provider input requests. */
+	async submitSessionInput(id, input) {
+		await (await this.response(`sessions/${encodeURIComponent(id)}/input`, submitSessionInputRequestSchema.parse(input))).body?.cancel();
+	}
+	/** Dispatches queued workflow work associated with a session. */
+	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, agentSessionIdSchema, agentSessionSchema, answerSessionQuestionRequestSchema, apiAgentSchema, controlSessionRequestSchema, createSessionRequestSchema, describeIntake, followSessionStream, imageAttachmentSchema, imageAttachmentsSchema, imageIdSchema, inputRequestSchema, pendingFollowUpSchema, readEvents, repositoryDetailsSchema, repositorySummarySchema, sendSessionMessageRequestSchema, sessionInputResponseSchema, sessionPageSchema, sessionViewSchema, streamEventSchema, submitSessionInputRequestSchema, taskStates, toolCallSchema, transcriptBlockSchema, transcriptSnapshotSchema, workspaceDiffFileSchema, workspaceDiffSchema };
+
+//# sourceMappingURL=client.mjs.map

package/dist/client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.mjs","names":[],"sources":["../src/client.ts"],"sourcesContent":["import { 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 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?: AgentSessionId;\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  readonly url: string;\n  readonly headers?: () => MaybePromise<HeadersInit>;\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/** 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 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/** Browser-safe typed client for the public Factory HTTP API. */\nexport class FactoryClient {\n  private readonly origin: string;\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  /** Lists sessions matching the requested operator scope. */\n  async listSessions(\n    options: Pick<SessionListOptions, \"scope\" | \"detail\"> = {},\n  ): Promise<readonly SessionView[]> {\n    return (await this.getSessionPage(options)).sessions;\n  }\n  /** Reads a filtered, cursor-paginated page of sessions. */\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  /** 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  /** Reads one operator session. */\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 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  /** Creates or recovers an idempotent conversational session. */\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  /** Sends a message to an existing session. */\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  /** Submits responses to pending provider input requests. */\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  /** Dispatches queued workflow work associated with a session. */\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,26 @@
+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;
+  line: number;
+  body: string;
+}
+//#endregion
+export { CompletedReview, CompletedReviewFinding };
+//# sourceMappingURL=contracts.d.mts.map