@vercel/factory 0.0.17 → 0.0.18

package/dist/client.d.mts

@@ -1,25 +1,25 @@
-import { InboxActivity, InboxActivityItem, inboxActivityItemSchema, inboxActivitySchema } from "./inbox-activity.mjs";
-import { AgentModelConfig, ModelSettings, UpdateModelDefaults, agentModelConfigSchema, modelSettingsSchema, updateModelDefaultsSchema } from "./model-settings.mjs";
-import { SessionPreview, SessionPreviews, sessionPreviewSchema, sessionPreviewsSchema } from "./session-previews.mjs";
-import { SessionReview, SessionReviewCheck, SessionReviewIssue, SessionReviewScreenshot, sessionReviewCheckSchema, sessionReviewIssueSchema, sessionReviewSchema, sessionReviewScreenshotSchema } from "./session-review.mjs";
-import { WorkspaceFileEntry, WorkspaceFiles, WorkspaceFilesRequest, workspaceFileContentSchema, workspaceFileEntrySchema, workspaceFilesRequestSchema, workspaceFilesSchema, workspacePathSchema } from "./workspace-files.mjs";
-import { SignalSource } from "./schema/signal.mjs";
 import { RepositoryId, 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 { InputRequest, ToolCall, TranscriptBlock, TranscriptPage, TranscriptPageQuery, TranscriptSnapshot, inputRequestSchema, toolCallSchema, transcriptBlockSchema, transcriptPageSchema, transcriptSnapshotSchema } from "./schema/transcript.mjs";
+import { RepositorySlug } from "./schema/repository.mjs";
+import { SignalSource } from "./schema/signal.mjs";
+import { SessionTaskSummary, sessionTaskSummarySchema } from "./schema/session-summary.mjs";
+import { InboxActivity, InboxActivityItem, inboxActivityItemSchema, inboxActivitySchema } from "./inbox-activity.mjs";
+import { AgentModelConfig, ModelSettings, UpdateModelDefaults, agentModelConfigSchema, modelSettingsSchema, updateModelDefaultsSchema } from "./model-settings.mjs";
+import { SessionPreview, SessionPreviews, sessionPreviewSchema, sessionPreviewsSchema } from "./session-previews.mjs";
+import { SessionReview, SessionReviewCheck, SessionReviewIssue, SessionReviewScreenshot, sessionReviewCheckSchema, sessionReviewIssueSchema, sessionReviewSchema, sessionReviewScreenshotSchema } from "./session-review.mjs";
+import { WorkspaceFileEntry, WorkspaceFiles, WorkspaceFilesRequest, workspaceFileContentSchema, workspaceFileEntrySchema, workspaceFilesRequestSchema, workspaceFilesSchema, workspacePathSchema } from "./workspace-files.mjs";
 import { ApprovalListOptions, ApprovalPage, ApprovalView } from "./approval-contracts.mjs";
 import { WorkspaceDiff, WorkspaceDiffFile, workspaceDiffFileSchema, workspaceDiffSchema } from "./workspace-diff.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";
+import { Transcript, TranscriptHistoryPage } from "./client-transcript.mjs";
+import { FollowSessionStreamOptions, SessionStreamClient, expandTranscriptBlock, followSessionStream, loadPreviousTranscriptPage } from "./client-stream.mjs";
+import { AnswerSessionQuestionRequest, ApiAgent, ControlSessionRequest, CreateSessionRequest, PendingFollowUp, RepositoryDetails, RepositorySummary, SendSessionMessageRequest, SessionInputResponse, SessionPage, SessionPullRequest, SessionSummary, SessionView, SessionWorkGroup, SessionWorkResult, SessionWorkTask, SubmitSessionInputRequest, answerSessionQuestionRequestSchema, apiAgentSchema, controlSessionRequestSchema, createSessionRequestSchema, pendingFollowUpSchema, repositoryDetailsSchema, repositorySummarySchema, sendSessionMessageRequestSchema, sessionInputResponseSchema, sessionPageSchema, sessionPullRequestSchema, sessionPullRequestStateSchema, sessionSummarySchema, sessionViewSchema, sessionWorkGroupSchema, sessionWorkResultSchema, sessionWorkTaskSchema, 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")[];
@@ -84,6 +84,8 @@ interface SessionPreviewsOptions {
 /** Identifies the operator session whose canonical task graph should be read. */
 interface GetSessionGraphOptions {
   readonly id: AgentSessionId;
+  /** Selects a Task in the bound graph or work addressed to this conversation. */
+  readonly taskId?: TaskId;
   readonly signal?: AbortSignal;
 }
 /** Identifies an exact task execution transcript within an operator session. */
@@ -111,6 +113,9 @@ interface SessionTranscriptRequest {
   readonly executionId: string;
   readonly taskId?: TaskId;
   readonly history?: boolean;
+  readonly limit?: number;
+  readonly cursor?: string;
+  readonly blockId?: string;
   readonly signal: AbortSignal;
 }
 /** Identifies a cursor-addressed event stream used by the stream follower. */
@@ -173,6 +178,7 @@ declare class FactoryClient {
       detail?: string | undefined;
       reason?: string | undefined;
       decidedAt?: string | undefined;
+      tasksNextCursor?: string | null | undefined;
     }[];
     nextCursor: string | null;
   }>;
@@ -203,6 +209,7 @@ declare class FactoryClient {
     detail?: string | undefined;
     reason?: string | undefined;
     decidedAt?: string | undefined;
+    tasksNextCursor?: string | null | undefined;
   }>;
   /** Lists approval proposals visible to the authenticated operator. */
   listApprovals(options?: ApprovalListOptions): Promise<ApprovalPage>;
@@ -224,17 +231,78 @@ declare class FactoryClient {
   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[]>;
+  /** Reads one bounded page of open Changes, optionally scoped to a repository. */
+  getChangePage(options?: {
+    repository?: RepositorySlug;
+    limit?: number;
+    cursor?: string;
+  }): Promise<{
+    changes: readonly ({
+      state: "verifying" | "ready" | "closed";
+      schemaVersion: 1;
+      id: `chg_${string}`;
+      repositoryId: `repo_${string}`;
+      prNumber: number;
+      prUrl: string;
+      author: string;
+      risk: "low" | "medium" | "high";
+      confidence: "low" | "medium" | "high";
+      evidence: {
+        reproVerified: boolean;
+        testsAdded: number;
+        checksGreen: boolean;
+        attackPassed: boolean;
+        scopeMatches: boolean;
+        previewUrl?: string | undefined;
+      };
+      createdAt: string;
+      updatedAt: string;
+      decidedBy?: string | undefined;
+      taskId?: `task_${string}` | undefined;
+      groupId?: `task_${string}` | undefined;
+      mergeSha?: string | undefined;
+    } | {
+      state: "merged" | "deployed" | "rolled_out" | "rolled_back";
+      decidedBy: string;
+      schemaVersion: 1;
+      id: `chg_${string}`;
+      repositoryId: `repo_${string}`;
+      prNumber: number;
+      prUrl: string;
+      author: string;
+      risk: "low" | "medium" | "high";
+      confidence: "low" | "medium" | "high";
+      evidence: {
+        reproVerified: boolean;
+        testsAdded: number;
+        checksGreen: boolean;
+        attackPassed: boolean;
+        scopeMatches: boolean;
+        previewUrl?: string | undefined;
+      };
+      createdAt: string;
+      updatedAt: string;
+      taskId?: `task_${string}` | undefined;
+      groupId?: `task_${string}` | undefined;
+      mergeSha?: string | undefined;
+    })[];
+    nextCursor: string | null;
+  }>;
+  /** Reads one bounded page of canonical Tasks authorized for the caller. */
+  getTaskPage(options?: {
+    limit?: number;
+    cursor?: string;
+  }): Promise<{
+    tasks: readonly Task[];
+    nextCursor: string | null;
+  }>;
   /**
    * 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.
    */
-  listSessions(options?: Pick<SessionListOptions, "scope" | "detail">): Promise<readonly SessionView[]>;
+  listSessions(options?: Pick<SessionListOptions, "scope" | "detail">): Promise<readonly SessionSummary[]>;
   /**
    * Reads a filtered, cursor-paginated page of sessions.
    *
@@ -251,7 +319,59 @@ declare class FactoryClient {
   /** 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[]>;
+  getSessionBatch(ids: readonly AgentSessionId[]): Promise<readonly SessionSummary[]>;
+  /** Reads one earlier page of authorized provider executions. */
+  getSessionHistory(id: AgentSessionId, options?: {
+    cursor?: string;
+    signal?: AbortSignal;
+  }): Promise<{
+    items: readonly {
+      agent: string;
+      message: string;
+      execution: {
+        provider: string;
+        sessionId: string;
+        environmentId?: string | undefined;
+        harness?: string | undefined;
+        traceId?: string | undefined;
+      };
+      taskId?: `task_${string}` | undefined;
+      attachments?: readonly {
+        id: `img_${string}`;
+        filename: string;
+        mediaType: "image/png" | "image/jpeg" | "image/webp";
+        size: number;
+      }[] | undefined;
+    }[];
+    nextCursor: string | null;
+  }>;
+  /** Reads one earlier page of delivered conversation notifications. */
+  getSessionNotifications(id: AgentSessionId, options?: {
+    cursor?: string;
+    signal?: AbortSignal;
+  }): Promise<{
+    items: readonly {
+      eventId: string;
+      repositoryIds: readonly [`repo_${string}`, ...`repo_${string}`[]];
+      replyTo: {
+        channel: string;
+        address: string;
+      };
+      outcome: "message" | "succeeded" | "failed" | "needs_human" | "cancelled" | "accepted" | "rolled_back" | "question" | "started" | "digest" | "budget_warning" | "budget_exhausted";
+      data: Record<string, unknown>;
+      taskId?: `task_${string}` | undefined;
+      changeId?: `chg_${string}` | undefined;
+    }[];
+    nextCursor: string | null;
+  }>;
+  /** Reads one bounded page of related Tasks authorized for this conversation. */
+  getSessionRelatedTasks(id: AgentSessionId, options?: {
+    cursor?: string;
+    signal?: AbortSignal;
+  }): Promise<{
+    items: readonly Task[];
+    nextCursor: string | null;
+  }>;
   /**
    * Reads one operator session.
    *
@@ -334,10 +454,16 @@ declare class FactoryClient {
   resetSession(id: AgentSessionId, input?: ControlSessionRequest): Promise<void>;
   /** Reads a materialized transcript as a raw HTTP response for incremental following. */
   getSessionTranscriptResponse(input: SessionTranscriptRequest): Promise<Response>;
+  /** Reads one bounded page of saved transcript history from Factory storage. */
+  getTranscriptPage(input: Omit<SessionTranscriptRequest, "blockId">): Promise<TranscriptPage>;
+  /** Expands one large transcript block after authorizing its session and execution. */
+  getTranscriptBlock(input: Omit<SessionTranscriptRequest, "limit" | "cursor"> & {
+    readonly blockId: string;
+  }): Promise<TranscriptBlock>;
   /** Opens a cursor-addressed session event stream as a raw HTTP response. */
   getSessionEventStreamResponse(input: SessionEventStreamRequest): Promise<Response>;
   private controlSession;
 }
 //#endregion
-export { type AgentModelConfig, 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 InboxActivity, type InboxActivityItem, type InputRequest, type IntakeView, MAX_IMAGES, MAX_IMAGE_BYTES, type ModelSettings, type PendingFollowUp, type RepositoryDetails, type RepositorySummary, type SendSessionMessageRequest, SessionEventStreamRequest, type SessionInputResponse, SessionListOptions, type SessionPage, type SessionPreview, type SessionPreviews, SessionPreviewsOptions, type SessionReview, type SessionReviewCheck, type SessionReviewIssue, SessionReviewOptions, type SessionReviewScreenshot, type SessionStreamClient, SessionTranscriptRequest, type SessionView, type StreamEvent, type SubmitSessionInputRequest, type TaskAgentSession, type TaskGraphView, type ToolCall, Transcript, type TranscriptBlock, type TranscriptSnapshot, type UpdateModelDefaults, type WorkspaceDiff, type WorkspaceDiffFile, WorkspaceDiffOptions, type WorkspaceFileEntry, type WorkspaceFiles, WorkspaceFilesOptions, type WorkspaceFilesRequest, 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 };
+export { type AgentModelConfig, 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 InboxActivity, type InboxActivityItem, type InputRequest, type IntakeView, MAX_IMAGES, MAX_IMAGE_BYTES, type ModelSettings, type PendingFollowUp, type RepositoryDetails, type RepositorySummary, type SendSessionMessageRequest, SessionEventStreamRequest, type SessionInputResponse, SessionListOptions, type SessionPage, type SessionPreview, type SessionPreviews, SessionPreviewsOptions, type SessionPullRequest, type SessionReview, type SessionReviewCheck, type SessionReviewIssue, SessionReviewOptions, type SessionReviewScreenshot, type SessionStreamClient, type SessionSummary, type SessionTaskSummary, SessionTranscriptRequest, type SessionView, type SessionWorkGroup, type SessionWorkResult, type SessionWorkTask, type StreamEvent, type SubmitSessionInputRequest, type TaskAgentSession, type TaskGraphView, type ToolCall, Transcript, type TranscriptBlock, type TranscriptHistoryPage, type TranscriptPage, type TranscriptPageQuery, type TranscriptSnapshot, type UpdateModelDefaults, type WorkspaceDiff, type WorkspaceDiffFile, WorkspaceDiffOptions, type WorkspaceFileEntry, type WorkspaceFiles, WorkspaceFilesOptions, type WorkspaceFilesRequest, agentModelConfigSchema, agentSessionIdSchema, agentSessionSchema, answerSessionQuestionRequestSchema, apiAgentSchema, controlSessionRequestSchema, createSessionRequestSchema, describeIntake, expandTranscriptBlock, followSessionStream, imageAttachmentSchema, imageAttachmentsSchema, imageIdSchema, inboxActivityItemSchema, inboxActivitySchema, inputRequestSchema, loadPreviousTranscriptPage, modelSettingsSchema, pendingFollowUpSchema, readEvents, repositoryDetailsSchema, repositorySummarySchema, sendSessionMessageRequestSchema, sessionInputResponseSchema, sessionPageSchema, sessionPreviewSchema, sessionPreviewsSchema, sessionPullRequestSchema, sessionPullRequestStateSchema, sessionReviewCheckSchema, sessionReviewIssueSchema, sessionReviewSchema, sessionReviewScreenshotSchema, sessionSummarySchema, sessionTaskSummarySchema, sessionViewSchema, sessionWorkGroupSchema, sessionWorkResultSchema, sessionWorkTaskSchema, streamEventSchema, submitSessionInputRequestSchema, taskStates, toolCallSchema, transcriptBlockSchema, transcriptPageSchema, transcriptSnapshotSchema, updateModelDefaultsSchema, workspaceDiffFileSchema, workspaceDiffSchema, workspaceFileContentSchema, workspaceFileEntrySchema, workspaceFilesRequestSchema, workspaceFilesSchema, workspacePathSchema };
 //# sourceMappingURL=client.d.mts.map

package/dist/client.mjs

@@ -3,21 +3,22 @@ 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 { inputRequestSchema, toolCallSchema, transcriptBlockSchema, transcriptPageSchema, 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 { agentSessionIdSchema, agentSessionSchema } from "./schema/session.mjs";
+import { sessionTaskSummarySchema } from "./schema/session-summary.mjs";
+import { answerSessionQuestionRequestSchema, apiAgentSchema, controlSessionRequestSchema, createSessionRequestSchema, pendingFollowUpSchema, repositoryDetailsSchema, repositorySummarySchema, sendSessionMessageRequestSchema, sessionInputResponseSchema, sessionPageSchema, sessionPullRequestSchema, sessionPullRequestStateSchema, sessionSummarySchema, sessionViewSchema, sessionWorkGroupSchema, sessionWorkResultSchema, sessionWorkTaskSchema, submitSessionInputRequestSchema } from "./api-contracts.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 { expandTranscriptBlock, followSessionStream, loadPreviousTranscriptPage } from "./client-stream.mjs";
 import { z } from "zod";
 //#region src/client.ts
 /** All durable Task states in their schema-defined order. */
@@ -146,13 +147,21 @@ var FactoryClient = class {
 	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;
+	/** Reads one bounded page of open Changes, optionally scoped to a repository. */
+	async getChangePage(options = {}) {
+		const query = new URLSearchParams(Object.entries(options).filter(([, value]) => value !== void 0).map(([key, value]) => [key, String(value)]));
+		return z.object({
+			changes: z.array(changeSchema).readonly(),
+			nextCursor: z.string().nullable()
+		}).parse(await (await this.response(`changes?${query}`)).json());
 	}
-	/** 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;
+	/** Reads one bounded page of canonical Tasks authorized for the caller. */
+	async getTaskPage(options = {}) {
+		const query = new URLSearchParams(Object.entries(options).filter(([, value]) => value !== void 0).map(([key, value]) => [key, String(value)]));
+		return z.object({
+			tasks: z.array(taskSchema).readonly(),
+			nextCursor: z.string().nullable()
+		}).parse(await (await this.response(`tasks?${query}`)).json());
 	}
 	/**
 	* Lists sessions matching the requested operator scope without pagination metadata.
@@ -188,7 +197,9 @@ var FactoryClient = class {
 	}
 	/** 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;
+		const result = z.object({ totalCount: z.number().int().nonnegative().optional() }).parse(await (await this.response("sessions?scope=all&detail=summary&attention=true&includeTotal=true&limit=1")).json());
+		if (result.totalCount === void 0) throw new Error("This factory's access policy does not provide an exact attention count");
+		return result.totalCount;
 	}
 	/** Reads a summary batch for the provided session IDs. */
 	async getSessionBatch(ids) {
@@ -197,7 +208,40 @@ var FactoryClient = class {
 			ids: ids.join(","),
 			detail: "summary"
 		});
-		return z.object({ sessions: z.array(sessionViewSchema).readonly() }).parse(await (await this.response(`sessions?${query}`)).json()).sessions;
+		return z.object({ sessions: z.array(sessionSummarySchema).readonly() }).parse(await (await this.response(`sessions?${query}`)).json()).sessions;
+	}
+	/** Reads one earlier page of authorized provider executions. */
+	async getSessionHistory(id, options = {}) {
+		const query = new URLSearchParams({
+			limit: "20",
+			...options.cursor ? { cursor: options.cursor } : {}
+		});
+		return z.object({
+			items: sessionViewSchema.shape.history.unwrap(),
+			nextCursor: z.string().nullable()
+		}).parse(await (await this.response(`sessions/${encodeURIComponent(id)}/history?${query}`, void 0, options.signal)).json());
+	}
+	/** Reads one earlier page of delivered conversation notifications. */
+	async getSessionNotifications(id, options = {}) {
+		const query = new URLSearchParams({
+			limit: "30",
+			...options.cursor ? { cursor: options.cursor } : {}
+		});
+		return z.object({
+			items: sessionViewSchema.shape.notifications,
+			nextCursor: z.string().nullable()
+		}).parse(await (await this.response(`sessions/${encodeURIComponent(id)}/notifications?${query}`, void 0, options.signal)).json());
+	}
+	/** Reads one bounded page of related Tasks authorized for this conversation. */
+	async getSessionRelatedTasks(id, options = {}) {
+		const query = new URLSearchParams({
+			limit: "30",
+			...options.cursor ? { cursor: options.cursor } : {}
+		});
+		return z.object({
+			items: sessionViewSchema.shape.relatedTasks.unwrap(),
+			nextCursor: z.string().nullable()
+		}).parse(await (await this.response(`sessions/${encodeURIComponent(id)}/related-tasks?${query}`, void 0, options.signal)).json());
 	}
 	/**
 	* Reads one operator session.
@@ -210,7 +254,7 @@ var FactoryClient = class {
 	}
 	/** 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());
+		return taskGraphViewSchema.parse(await (await this.response(`sessions/${encodeURIComponent(options.id)}/graph${options.taskId ? `?${new URLSearchParams({ taskId: options.taskId })}` : ""}`, void 0, options.signal)).json());
 	}
 	/** Reads the materialized transcript for one exact graph task execution. */
 	async getGraphTranscript(options) {
@@ -218,7 +262,7 @@ var FactoryClient = class {
 			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());
+		return transcriptPageSchema.parse(await (await this.response(`sessions/${encodeURIComponent(options.sessionId)}/graph-transcript?${query}`, void 0, options.signal)).json()).snapshot;
 	}
 	/** Refreshes a session summary and reloads its history when the active execution changes. */
 	async refreshSession(previous) {
@@ -227,9 +271,27 @@ var FactoryClient = class {
 			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 });
+		if (current.session.latestNotificationId !== previous.session.latestNotificationId || current.task?.updatedAt !== previous.task?.updatedAt || current.statusRevision !== previous.statusRevision) {
+			const fresh = await this.getSession({ id: previous.session.id });
+			if (fresh.task?.id !== previous.task?.id || fresh.execution?.sessionId !== previous.execution?.sessionId || fresh.execution?.provider !== previous.execution?.provider) return fresh;
+			return {
+				...fresh,
+				history: [...new Map([...previous.history ?? [], ...fresh.history ?? []].map((entry) => [JSON.stringify(entry.execution), entry])).values()],
+				historyNextCursor: (previous.history?.length ?? 0) > (fresh.history?.length ?? 0) ? previous.historyNextCursor : fresh.historyNextCursor,
+				notifications: [...new Map([...previous.notifications, ...fresh.notifications].map((entry) => [entry.eventId, entry])).values()],
+				notificationsNextCursor: previous.notifications.length > fresh.notifications.length ? previous.notificationsNextCursor : fresh.notificationsNextCursor,
+				relatedTasks: [...new Map([...fresh.relatedTasks ?? [], ...(previous.relatedTasks ?? []).filter((entry) => !fresh.relatedTasks?.some((current) => current.id === entry.id))].map((entry) => [entry.id, entry])).values()],
+				relatedTasksNextCursor: (previous.relatedTasks?.length ?? 0) > (fresh.relatedTasks?.length ?? 0) ? previous.relatedTasksNextCursor : fresh.relatedTasksNextCursor
+			};
+		}
 		return {
 			...current,
-			history: previous.history
+			history: previous.history,
+			historyNextCursor: previous.historyNextCursor,
+			notifications: previous.notifications,
+			notificationsNextCursor: previous.notificationsNextCursor,
+			relatedTasks: previous.relatedTasks,
+			relatedTasksNextCursor: previous.relatedTasksNextCursor
 		};
 	}
 	/** Reads application-owned previews without starting an agent, deployment, or server. */
@@ -345,8 +407,19 @@ var FactoryClient = class {
 		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);
+		if (input.limit !== void 0) query.set("limit", String(input.limit));
+		if (input.cursor !== void 0) query.set("cursor", input.cursor);
+		if (input.blockId !== void 0) query.set("blockId", input.blockId);
 		return this.response(`sessions/${encodeURIComponent(input.sessionId)}/${input.taskId ? "graph-transcript" : "transcript"}?${query}`, void 0, input.signal);
 	}
+	/** Reads one bounded page of saved transcript history from Factory storage. */
+	async getTranscriptPage(input) {
+		return transcriptPageSchema.parse(await (await this.getSessionTranscriptResponse(input)).json());
+	}
+	/** Expands one large transcript block after authorizing its session and execution. */
+	async getTranscriptBlock(input) {
+		return transcriptBlockSchema.parse(await (await this.getSessionTranscriptResponse(input)).json());
+	}
 	/** Opens a cursor-addressed session event stream as a raw HTTP response. */
 	async getSessionEventStreamResponse(input) {
 		const query = new URLSearchParams({
@@ -361,6 +434,6 @@ var FactoryClient = class {
 	}
 };
 //#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 };
+export { ApiError, FactoryClient, MAX_IMAGES, MAX_IMAGE_BYTES, Transcript, agentModelConfigSchema, agentSessionIdSchema, agentSessionSchema, answerSessionQuestionRequestSchema, apiAgentSchema, controlSessionRequestSchema, createSessionRequestSchema, describeIntake, expandTranscriptBlock, followSessionStream, imageAttachmentSchema, imageAttachmentsSchema, imageIdSchema, inboxActivityItemSchema, inboxActivitySchema, inputRequestSchema, loadPreviousTranscriptPage, modelSettingsSchema, pendingFollowUpSchema, readEvents, repositoryDetailsSchema, repositorySummarySchema, sendSessionMessageRequestSchema, sessionInputResponseSchema, sessionPageSchema, sessionPreviewSchema, sessionPreviewsSchema, sessionPullRequestSchema, sessionPullRequestStateSchema, sessionReviewCheckSchema, sessionReviewIssueSchema, sessionReviewSchema, sessionReviewScreenshotSchema, sessionSummarySchema, sessionTaskSummarySchema, sessionViewSchema, sessionWorkGroupSchema, sessionWorkResultSchema, sessionWorkTaskSchema, streamEventSchema, submitSessionInputRequestSchema, taskStates, toolCallSchema, transcriptBlockSchema, transcriptPageSchema, transcriptSnapshotSchema, updateModelDefaultsSchema, workspaceDiffFileSchema, workspaceDiffSchema, workspaceFileContentSchema, workspaceFileEntrySchema, workspaceFilesRequestSchema, workspaceFilesSchema, workspacePathSchema };
 
 //# sourceMappingURL=client.mjs.map