@vercel/factory 0.0.14 → 0.0.16

package/dist/client-transcript.d.mts

@@ -0,0 +1,41 @@
+import { ImageAttachment } from "./image-input.mjs";
+import { InputRequest, ToolCall, TranscriptBlock, TranscriptSnapshot } from "./schema/transcript.mjs";
+import { StreamEvent } from "./client-events.mjs";
+//#region src/client-transcript.d.ts
+/** Mutable client-side projection of snapshot and live Factory transcript events. */
+declare class Transcript {
+  private initialMessage?;
+  private initialAttachments?;
+  blocks: TranscriptBlock[];
+  inputs: Map<string, Readonly<{
+    requestId: string;
+    prompt: string;
+    kind: string;
+    allowFreeform?: boolean | undefined;
+    options?: readonly Readonly<{
+      id: string;
+      label: string;
+      description?: string | undefined;
+    }>[] | undefined;
+  }>>;
+  cursor: number;
+  state: string;
+  turnId?: string;
+  tokens: number;
+  private seen;
+  private tools;
+  constructor(initialMessage?: string | undefined, initialAttachments?: readonly ImageAttachment[] | undefined);
+  snapshot(): TranscriptSnapshot;
+  hydrate(value: TranscriptSnapshot): void;
+  put(block: TranscriptBlock): void;
+  appendHistory(id: string, transcript: Transcript): void;
+  prependHistory(entries: readonly {
+    id: string;
+    transcript: Transcript;
+  }[]): void;
+  accept(event: StreamEvent): void;
+  private tool;
+}
+//#endregion
+export { type InputRequest, type ToolCall, Transcript, type TranscriptBlock, type TranscriptSnapshot };
+//# sourceMappingURL=client-transcript.d.mts.map

package/dist/client-transcript.mjs

@@ -0,0 +1,233 @@
+import { receivedImages } from "./image-input.mjs";
+import { inputRequestSchema, transcriptSnapshotSchema } from "./schema/transcript.mjs";
+//#region src/client-transcript.ts
+function record(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value) ? value : {};
+}
+function string(value) {
+	return typeof value === "string" ? value : JSON.stringify(value, null, 2) ?? "";
+}
+function parseInput(text) {
+	try {
+		return JSON.parse(text);
+	} catch {
+		return;
+	}
+}
+function settled(tool) {
+	return [
+		"completed",
+		"failed",
+		"cancelled",
+		"rejected"
+	].includes(tool.state);
+}
+/** Mutable client-side projection of snapshot and live Factory transcript events. */
+var Transcript = class {
+	initialMessage;
+	initialAttachments;
+	blocks = [];
+	inputs = /* @__PURE__ */ new Map();
+	cursor = 0;
+	state = "connecting";
+	turnId;
+	tokens = 0;
+	seen = /* @__PURE__ */ new Set();
+	tools = /* @__PURE__ */ new Map();
+	constructor(initialMessage, initialAttachments) {
+		this.initialMessage = initialMessage;
+		this.initialAttachments = initialAttachments;
+	}
+	snapshot() {
+		return transcriptSnapshotSchema.parse({
+			blocks: this.blocks,
+			inputs: [...this.inputs.values()],
+			cursor: this.cursor,
+			state: this.state,
+			turnId: this.turnId,
+			tokens: this.tokens
+		});
+	}
+	hydrate(value) {
+		const snapshot = transcriptSnapshotSchema.parse(value);
+		this.blocks = snapshot.blocks.map((block) => ({ ...block }));
+		const firstUser = this.blocks.find((block) => block.kind === "user");
+		if (firstUser !== void 0 && (this.initialMessage !== void 0 || this.initialAttachments !== void 0)) {
+			const text = this.initialMessage ?? firstUser.text;
+			const attachments = this.initialAttachments ?? firstUser.attachments;
+			const firstUserIndex = this.blocks.indexOf(firstUser);
+			if (attachments?.length) this.blocks[firstUserIndex] = {
+				...firstUser,
+				text,
+				attachments: [...attachments]
+			};
+			else {
+				const { attachments: _attachments, ...withoutAttachments } = firstUser;
+				this.blocks[firstUserIndex] = {
+					...withoutAttachments,
+					text
+				};
+			}
+		}
+		this.inputs = new Map(snapshot.inputs.map((request) => [request.requestId, request]));
+		this.cursor = snapshot.cursor;
+		this.state = snapshot.state;
+		this.turnId = snapshot.turnId;
+		this.tokens = snapshot.tokens;
+		this.seen.clear();
+		this.tools = new Map(this.blocks.flatMap((block) => block.tool ? [[block.tool.callId, block.tool]] : []));
+		this.initialMessage = void 0;
+		this.initialAttachments = void 0;
+	}
+	put(block) {
+		const index = this.blocks.findIndex((item) => item.id === block.id);
+		if (index < 0) this.blocks.push(block);
+		else this.blocks[index] = block;
+	}
+	appendHistory(id, transcript) {
+		for (const block of transcript.blocks) this.put({
+			...block,
+			id: `history:${id}:${block.id}`
+		});
+	}
+	prependHistory(entries) {
+		const history = entries.flatMap(({ id, transcript }) => transcript.blocks.map((block) => ({
+			...block,
+			id: `history:${id}:${block.id}`
+		})));
+		const ids = new Set(history.map((block) => block.id));
+		this.blocks = [...history, ...this.blocks.filter((block) => !ids.has(block.id))];
+	}
+	accept(event) {
+		this.cursor++;
+		if (event.meta?.id !== void 0) {
+			if (this.seen.has(event.meta.id)) return;
+			this.seen.add(event.meta.id);
+		}
+		const { type, data } = event;
+		const coordinate = `${data.turnId}:${data.stepIndex}:${data.sequence}`;
+		if (type === "turn.started") {
+			this.turnId = string(data.turnId);
+			this.state = "running";
+		}
+		if (type === "message.received") {
+			const attachments = this.initialAttachments ?? receivedImages(data.parts);
+			const partsText = Array.isArray(data.parts) ? data.parts.filter((part) => record(part).type === "text").map((part) => string(record(part).text)).join("\n") : void 0;
+			this.put({
+				id: `user:${event.meta?.id ?? this.cursor}`,
+				kind: "user",
+				title: "You",
+				text: this.initialMessage ?? (attachments.length ? partsText ?? "" : string(data.message)),
+				...attachments.length ? { attachments: [...attachments] } : {}
+			});
+			this.initialMessage = void 0;
+			this.initialAttachments = void 0;
+		}
+		if (type === "message.appended" || type === "message.completed") this.put({
+			id: `message:${coordinate}`,
+			kind: "assistant",
+			title: "Assistant",
+			text: string(data.message)
+		});
+		if (type === "result.completed") this.put({
+			id: `result:${coordinate}`,
+			kind: "assistant",
+			title: "Result",
+			text: `\`\`\`json\n${string(data.result)}\n\`\`\``
+		});
+		if (type === "reasoning.appended" || type === "reasoning.completed") this.put({
+			id: `reasoning:${coordinate}`,
+			kind: "reasoning",
+			title: "Reasoning",
+			text: string(data.reasoning)
+		});
+		if (type === "actions.requested" && Array.isArray(data.actions)) for (const item of data.actions) {
+			const action = record(item);
+			const callId = string(action.callId);
+			const previous = this.tools.get(callId);
+			this.tool({
+				...previous,
+				callId,
+				input: action.input,
+				inputText: string(action.input),
+				name: string(action.toolName ?? action.name ?? action.kind),
+				state: previous?.state === "input-streaming" ? "running" : previous?.state ?? "running"
+			});
+		}
+		if (type === "action.input.appended") {
+			const id = string(data.callId);
+			const previous = this.tools.get(id);
+			const offset = data.inputTextOffset;
+			const delta = string(data.inputTextDelta);
+			if ((!previous || previous.state === "input-streaming") && (offset === 0 || offset === previous?.inputText.length)) {
+				const inputText = (offset === 0 ? "" : previous?.inputText ?? "") + delta;
+				this.tool({
+					callId: id,
+					input: parseInput(inputText),
+					inputText,
+					name: string(data.toolName),
+					state: "input-streaming"
+				});
+			}
+		}
+		if (type === "action.result" || type === "action.partial") {
+			const result = record(data.result);
+			const id = string(result.callId);
+			const previous = this.tools.get(id);
+			if (type !== "action.partial" || !previous || !settled(previous)) this.tool({
+				...previous,
+				callId: id,
+				input: previous?.input,
+				inputText: previous?.inputText ?? "",
+				name: previous?.name ?? string(result.toolName ?? result.kind),
+				output: "output" in result ? result.output : result,
+				error: data.error,
+				state: type === "action.partial" ? "running" : data.status === "rejected" ? "rejected" : data.status === "failed" || data.error != null ? "failed" : "completed"
+			});
+		}
+		if (type === "turn.cancelled" || type === "turn.failed" || type === "session.failed") {
+			for (const tool of this.tools.values()) if (!settled(tool)) this.tool({
+				...tool,
+				state: type === "turn.cancelled" ? "cancelled" : "failed",
+				error: data.message
+			});
+		}
+		if (type === "input.requested") {
+			for (const request of inputRequestSchema.array().parse(data.requests)) this.inputs.set(request.requestId, request);
+			this.state = "needs input";
+		}
+		if (type === "input.resolved" && Array.isArray(data.resolutions)) for (const resolution of data.resolutions) this.inputs.delete(string(record(resolution).requestId));
+		if (type === "step.completed") {
+			const usage = record(data.usage);
+			const total = (value) => typeof value === "number" ? value : Number(record(value).total ?? 0);
+			this.tokens += total(usage.inputTokens) + total(usage.outputTokens);
+		}
+		if (type === "session.waiting" || [
+			"turn.completed",
+			"turn.failed",
+			"turn.cancelled"
+		].includes(type) && (this.turnId === void 0 || data.turnId === this.turnId)) this.state = this.inputs.size > 0 ? "needs input" : "waiting";
+		if (["session.completed", "session.failed"].includes(type)) this.state = type.slice(8);
+		if (type.endsWith(".failed") || type === "turn.cancelled" || type.startsWith("compaction.") || type.startsWith("authorization.") || type.startsWith("subagent.")) this.put({
+			id: `event:${event.meta?.id ?? this.cursor}`,
+			kind: type.endsWith(".failed") ? "error" : "status",
+			title: type,
+			text: string(data.message ?? data.output ?? data.authorization ?? data.subagentName ?? data.name ?? "")
+		});
+	}
+	tool(tool) {
+		this.tools.set(tool.callId, tool);
+		const output = tool.error ?? tool.output;
+		this.put({
+			id: `tool:${tool.callId}`,
+			kind: "tool",
+			title: tool.name,
+			tool,
+			text: `Input\n\`\`\`json\n${tool.inputText}\n\`\`\`${output === void 0 ? "" : `\n\nOutput\n\`\`\`\n${string(output)}\n\`\`\``}`
+		});
+	}
+};
+//#endregion
+export { Transcript };
+
+//# sourceMappingURL=client-transcript.mjs.map

package/dist/client-transcript.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-transcript.mjs","names":[],"sources":["../src/client-transcript.ts"],"sourcesContent":["import { receivedImages, type ImageAttachment } from \"./image-input\";\nimport type { StreamEvent } from \"./client-events\";\nimport {\n  inputRequestSchema,\n  transcriptSnapshotSchema,\n  type InputRequest,\n  type ToolCall,\n  type TranscriptBlock,\n  type TranscriptSnapshot,\n} from \"./schema/transcript\";\n\nexport type {\n  InputRequest,\n  ToolCall,\n  TranscriptBlock,\n  TranscriptSnapshot,\n} from \"./schema/transcript\";\n\nfunction record(value: unknown): Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : {};\n}\nfunction string(value: unknown): string {\n  return typeof value === \"string\" ? value : (JSON.stringify(value, null, 2) ?? \"\");\n}\nfunction parseInput(text: string): unknown {\n  try {\n    return JSON.parse(text);\n  } catch {\n    return undefined;\n  }\n}\nfunction settled(tool: ToolCall) {\n  return [\"completed\", \"failed\", \"cancelled\", \"rejected\"].includes(tool.state);\n}\n\n/** Mutable client-side projection of snapshot and live Factory transcript events. */\nexport class Transcript {\n  blocks: TranscriptBlock[] = [];\n  inputs = new Map<string, InputRequest>();\n  cursor = 0;\n  state = \"connecting\";\n  turnId?: string;\n  tokens = 0;\n  private seen = new Set<string>();\n  private tools = new Map<string, ToolCall>();\n  constructor(\n    private initialMessage?: string,\n    private initialAttachments?: readonly ImageAttachment[],\n  ) {}\n\n  snapshot(): TranscriptSnapshot {\n    return transcriptSnapshotSchema.parse({\n      blocks: this.blocks,\n      inputs: [...this.inputs.values()],\n      cursor: this.cursor,\n      state: this.state,\n      turnId: this.turnId,\n      tokens: this.tokens,\n    });\n  }\n\n  hydrate(value: TranscriptSnapshot): void {\n    const snapshot = transcriptSnapshotSchema.parse(value);\n    this.blocks = snapshot.blocks.map((block) => ({ ...block }));\n    const firstUser = this.blocks.find(\n      (block): block is Extract<TranscriptBlock, { kind: \"user\" }> => block.kind === \"user\",\n    );\n    if (\n      firstUser !== undefined &&\n      (this.initialMessage !== undefined || this.initialAttachments !== undefined)\n    ) {\n      const text = this.initialMessage ?? firstUser.text;\n      const attachments = this.initialAttachments ?? firstUser.attachments;\n      const firstUserIndex = this.blocks.indexOf(firstUser);\n      if (attachments?.length) {\n        this.blocks[firstUserIndex] = { ...firstUser, text, attachments: [...attachments] };\n      } else {\n        const { attachments: _attachments, ...withoutAttachments } = firstUser;\n        this.blocks[firstUserIndex] = { ...withoutAttachments, text };\n      }\n    }\n    this.inputs = new Map(snapshot.inputs.map((request) => [request.requestId, request]));\n    this.cursor = snapshot.cursor;\n    this.state = snapshot.state;\n    this.turnId = snapshot.turnId;\n    this.tokens = snapshot.tokens;\n    this.seen.clear();\n    this.tools = new Map(\n      this.blocks.flatMap((block) =>\n        block.tool ? [[block.tool.callId, block.tool] as const] : [],\n      ),\n    );\n    this.initialMessage = undefined;\n    this.initialAttachments = undefined;\n  }\n\n  put(block: TranscriptBlock) {\n    const index = this.blocks.findIndex((item) => item.id === block.id);\n    if (index < 0) this.blocks.push(block);\n    else this.blocks[index] = block;\n  }\n\n  appendHistory(id: string, transcript: Transcript) {\n    for (const block of transcript.blocks) this.put({ ...block, id: `history:${id}:${block.id}` });\n  }\n\n  prependHistory(entries: readonly { id: string; transcript: Transcript }[]) {\n    const history = entries.flatMap(({ id, transcript }) =>\n      transcript.blocks.map((block) => ({ ...block, id: `history:${id}:${block.id}` })),\n    );\n    const ids = new Set(history.map((block) => block.id));\n    this.blocks = [...history, ...this.blocks.filter((block) => !ids.has(block.id))];\n  }\n\n  accept(event: StreamEvent) {\n    this.cursor++;\n    if (event.meta?.id !== undefined) {\n      if (this.seen.has(event.meta.id)) return;\n      this.seen.add(event.meta.id);\n    }\n    const { type, data } = event;\n    const coordinate = `${data.turnId}:${data.stepIndex}:${data.sequence}`;\n    if (type === \"turn.started\") {\n      this.turnId = string(data.turnId);\n      this.state = \"running\";\n    }\n    if (type === \"message.received\") {\n      const attachments = this.initialAttachments ?? receivedImages(data.parts);\n      const partsText = Array.isArray(data.parts)\n        ? data.parts\n            .filter((part) => record(part).type === \"text\")\n            .map((part) => string(record(part).text))\n            .join(\"\\n\")\n        : undefined;\n      this.put({\n        id: `user:${event.meta?.id ?? this.cursor}`,\n        kind: \"user\",\n        title: \"You\",\n        text:\n          this.initialMessage ?? (attachments.length ? (partsText ?? \"\") : string(data.message)),\n        ...(attachments.length ? { attachments: [...attachments] } : {}),\n      });\n      this.initialMessage = undefined;\n      this.initialAttachments = undefined;\n    }\n    if (type === \"message.appended\" || type === \"message.completed\")\n      this.put({\n        id: `message:${coordinate}`,\n        kind: \"assistant\",\n        title: \"Assistant\",\n        text: string(data.message),\n      });\n    if (type === \"result.completed\")\n      this.put({\n        id: `result:${coordinate}`,\n        kind: \"assistant\",\n        title: \"Result\",\n        text: `\\`\\`\\`json\\n${string(data.result)}\\n\\`\\`\\``,\n      });\n    if (type === \"reasoning.appended\" || type === \"reasoning.completed\")\n      this.put({\n        id: `reasoning:${coordinate}`,\n        kind: \"reasoning\",\n        title: \"Reasoning\",\n        text: string(data.reasoning),\n      });\n    if (type === \"actions.requested\" && Array.isArray(data.actions))\n      for (const item of data.actions) {\n        const action = record(item);\n        const callId = string(action.callId);\n        const previous = this.tools.get(callId);\n        this.tool({\n          ...previous,\n          callId,\n          input: action.input,\n          inputText: string(action.input),\n          name: string(action.toolName ?? action.name ?? action.kind),\n          state: previous?.state === \"input-streaming\" ? \"running\" : (previous?.state ?? \"running\"),\n        });\n      }\n    if (type === \"action.input.appended\") {\n      const id = string(data.callId);\n      const previous = this.tools.get(id);\n      const offset = data.inputTextOffset;\n      const delta = string(data.inputTextDelta);\n      if (\n        (!previous || previous.state === \"input-streaming\") &&\n        (offset === 0 || offset === previous?.inputText.length)\n      ) {\n        const inputText = (offset === 0 ? \"\" : (previous?.inputText ?? \"\")) + delta;\n        this.tool({\n          callId: id,\n          input: parseInput(inputText),\n          inputText,\n          name: string(data.toolName),\n          state: \"input-streaming\",\n        });\n      }\n    }\n    if (type === \"action.result\" || type === \"action.partial\") {\n      const result = record(data.result);\n      const id = string(result.callId);\n      const previous = this.tools.get(id);\n      if (type !== \"action.partial\" || !previous || !settled(previous))\n        this.tool({\n          ...previous,\n          callId: id,\n          input: previous?.input,\n          inputText: previous?.inputText ?? \"\",\n          name: previous?.name ?? string(result.toolName ?? result.kind),\n          output: \"output\" in result ? result.output : result,\n          error: data.error,\n          state:\n            type === \"action.partial\"\n              ? \"running\"\n              : data.status === \"rejected\"\n                ? \"rejected\"\n                : data.status === \"failed\" || data.error != null\n                  ? \"failed\"\n                  : \"completed\",\n        });\n    }\n    if (type === \"turn.cancelled\" || type === \"turn.failed\" || type === \"session.failed\")\n      for (const tool of this.tools.values()) {\n        if (!settled(tool))\n          this.tool({\n            ...tool,\n            state: type === \"turn.cancelled\" ? \"cancelled\" : \"failed\",\n            error: data.message,\n          });\n      }\n    if (type === \"input.requested\") {\n      for (const request of inputRequestSchema.array().parse(data.requests))\n        this.inputs.set(request.requestId, request);\n      this.state = \"needs input\";\n    }\n    if (type === \"input.resolved\" && Array.isArray(data.resolutions))\n      for (const resolution of data.resolutions)\n        this.inputs.delete(string(record(resolution).requestId));\n    if (type === \"step.completed\") {\n      const usage = record(data.usage);\n      const total = (value: unknown) =>\n        typeof value === \"number\" ? value : Number(record(value).total ?? 0);\n      this.tokens += total(usage.inputTokens) + total(usage.outputTokens);\n    }\n    if (\n      type === \"session.waiting\" ||\n      ([\"turn.completed\", \"turn.failed\", \"turn.cancelled\"].includes(type) &&\n        (this.turnId === undefined || data.turnId === this.turnId))\n    )\n      this.state = this.inputs.size > 0 ? \"needs input\" : \"waiting\";\n    if ([\"session.completed\", \"session.failed\"].includes(type)) this.state = type.slice(8);\n    if (\n      type.endsWith(\".failed\") ||\n      type === \"turn.cancelled\" ||\n      type.startsWith(\"compaction.\") ||\n      type.startsWith(\"authorization.\") ||\n      type.startsWith(\"subagent.\")\n    ) {\n      this.put({\n        id: `event:${event.meta?.id ?? this.cursor}`,\n        kind: type.endsWith(\".failed\") ? \"error\" : \"status\",\n        title: type,\n        text: string(\n          data.message ?? data.output ?? data.authorization ?? data.subagentName ?? data.name ?? \"\",\n        ),\n      });\n    }\n  }\n\n  private tool(tool: ToolCall) {\n    this.tools.set(tool.callId, tool);\n    const output = tool.error ?? tool.output;\n    this.put({\n      id: `tool:${tool.callId}`,\n      kind: \"tool\",\n      title: tool.name,\n      tool,\n      text: `Input\\n\\`\\`\\`json\\n${tool.inputText}\\n\\`\\`\\`${output === undefined ? \"\" : `\\n\\nOutput\\n\\`\\`\\`\\n${string(output)}\\n\\`\\`\\``}`,\n    });\n  }\n}\n"],"mappings":";;;AAkBA,SAAS,OAAO,OAAyC;CACvD,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK,IACrE,QACD,CAAC;AACP;AACA,SAAS,OAAO,OAAwB;CACtC,OAAO,OAAO,UAAU,WAAW,QAAS,KAAK,UAAU,OAAO,MAAM,CAAC,KAAK;AAChF;AACA,SAAS,WAAW,MAAuB;CACzC,IAAI;EACF,OAAO,KAAK,MAAM,IAAI;CACxB,QAAQ;EACN;CACF;AACF;AACA,SAAS,QAAQ,MAAgB;CAC/B,OAAO;EAAC;EAAa;EAAU;EAAa;CAAU,CAAC,CAAC,SAAS,KAAK,KAAK;AAC7E;;AAGA,IAAa,aAAb,MAAwB;CAUZ;CACA;CAVV,SAA4B,CAAC;CAC7B,yBAAS,IAAI,IAA0B;CACvC,SAAS;CACT,QAAQ;CACR;CACA,SAAS;CACT,uBAAe,IAAI,IAAY;CAC/B,wBAAgB,IAAI,IAAsB;CAC1C,YACE,gBACA,oBACA;EAFQ,KAAA,iBAAA;EACA,KAAA,qBAAA;CACP;CAEH,WAA+B;EAC7B,OAAO,yBAAyB,MAAM;GACpC,QAAQ,KAAK;GACb,QAAQ,CAAC,GAAG,KAAK,OAAO,OAAO,CAAC;GAChC,QAAQ,KAAK;GACb,OAAO,KAAK;GACZ,QAAQ,KAAK;GACb,QAAQ,KAAK;EACf,CAAC;CACH;CAEA,QAAQ,OAAiC;EACvC,MAAM,WAAW,yBAAyB,MAAM,KAAK;EACrD,KAAK,SAAS,SAAS,OAAO,KAAK,WAAW,EAAE,GAAG,MAAM,EAAE;EAC3D,MAAM,YAAY,KAAK,OAAO,MAC3B,UAA+D,MAAM,SAAS,MACjF;EACA,IACE,cAAc,KAAA,MACb,KAAK,mBAAmB,KAAA,KAAa,KAAK,uBAAuB,KAAA,IAClE;GACA,MAAM,OAAO,KAAK,kBAAkB,UAAU;GAC9C,MAAM,cAAc,KAAK,sBAAsB,UAAU;GACzD,MAAM,iBAAiB,KAAK,OAAO,QAAQ,SAAS;GACpD,IAAI,aAAa,QACf,KAAK,OAAO,kBAAkB;IAAE,GAAG;IAAW;IAAM,aAAa,CAAC,GAAG,WAAW;GAAE;QAC7E;IACL,MAAM,EAAE,aAAa,cAAc,GAAG,uBAAuB;IAC7D,KAAK,OAAO,kBAAkB;KAAE,GAAG;KAAoB;IAAK;GAC9D;EACF;EACA,KAAK,SAAS,IAAI,IAAI,SAAS,OAAO,KAAK,YAAY,CAAC,QAAQ,WAAW,OAAO,CAAC,CAAC;EACpF,KAAK,SAAS,SAAS;EACvB,KAAK,QAAQ,SAAS;EACtB,KAAK,SAAS,SAAS;EACvB,KAAK,SAAS,SAAS;EACvB,KAAK,KAAK,MAAM;EAChB,KAAK,QAAQ,IAAI,IACf,KAAK,OAAO,SAAS,UACnB,MAAM,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,MAAM,IAAI,CAAU,IAAI,CAAC,CAC7D,CACF;EACA,KAAK,iBAAiB,KAAA;EACtB,KAAK,qBAAqB,KAAA;CAC5B;CAEA,IAAI,OAAwB;EAC1B,MAAM,QAAQ,KAAK,OAAO,WAAW,SAAS,KAAK,OAAO,MAAM,EAAE;EAClE,IAAI,QAAQ,GAAG,KAAK,OAAO,KAAK,KAAK;OAChC,KAAK,OAAO,SAAS;CAC5B;CAEA,cAAc,IAAY,YAAwB;EAChD,KAAK,MAAM,SAAS,WAAW,QAAQ,KAAK,IAAI;GAAE,GAAG;GAAO,IAAI,WAAW,GAAG,GAAG,MAAM;EAAK,CAAC;CAC/F;CAEA,eAAe,SAA4D;EACzE,MAAM,UAAU,QAAQ,SAAS,EAAE,IAAI,iBACrC,WAAW,OAAO,KAAK,WAAW;GAAE,GAAG;GAAO,IAAI,WAAW,GAAG,GAAG,MAAM;EAAK,EAAE,CAClF;EACA,MAAM,MAAM,IAAI,IAAI,QAAQ,KAAK,UAAU,MAAM,EAAE,CAAC;EACpD,KAAK,SAAS,CAAC,GAAG,SAAS,GAAG,KAAK,OAAO,QAAQ,UAAU,CAAC,IAAI,IAAI,MAAM,EAAE,CAAC,CAAC;CACjF;CAEA,OAAO,OAAoB;EACzB,KAAK;EACL,IAAI,MAAM,MAAM,OAAO,KAAA,GAAW;GAChC,IAAI,KAAK,KAAK,IAAI,MAAM,KAAK,EAAE,GAAG;GAClC,KAAK,KAAK,IAAI,MAAM,KAAK,EAAE;EAC7B;EACA,MAAM,EAAE,MAAM,SAAS;EACvB,MAAM,aAAa,GAAG,KAAK,OAAO,GAAG,KAAK,UAAU,GAAG,KAAK;EAC5D,IAAI,SAAS,gBAAgB;GAC3B,KAAK,SAAS,OAAO,KAAK,MAAM;GAChC,KAAK,QAAQ;EACf;EACA,IAAI,SAAS,oBAAoB;GAC/B,MAAM,cAAc,KAAK,sBAAsB,eAAe,KAAK,KAAK;GACxE,MAAM,YAAY,MAAM,QAAQ,KAAK,KAAK,IACtC,KAAK,MACF,QAAQ,SAAS,OAAO,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,CAC9C,KAAK,SAAS,OAAO,OAAO,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CACxC,KAAK,IAAI,IACZ,KAAA;GACJ,KAAK,IAAI;IACP,IAAI,QAAQ,MAAM,MAAM,MAAM,KAAK;IACnC,MAAM;IACN,OAAO;IACP,MACE,KAAK,mBAAmB,YAAY,SAAU,aAAa,KAAM,OAAO,KAAK,OAAO;IACtF,GAAI,YAAY,SAAS,EAAE,aAAa,CAAC,GAAG,WAAW,EAAE,IAAI,CAAC;GAChE,CAAC;GACD,KAAK,iBAAiB,KAAA;GACtB,KAAK,qBAAqB,KAAA;EAC5B;EACA,IAAI,SAAS,sBAAsB,SAAS,qBAC1C,KAAK,IAAI;GACP,IAAI,WAAW;GACf,MAAM;GACN,OAAO;GACP,MAAM,OAAO,KAAK,OAAO;EAC3B,CAAC;EACH,IAAI,SAAS,oBACX,KAAK,IAAI;GACP,IAAI,UAAU;GACd,MAAM;GACN,OAAO;GACP,MAAM,eAAe,OAAO,KAAK,MAAM,EAAE;EAC3C,CAAC;EACH,IAAI,SAAS,wBAAwB,SAAS,uBAC5C,KAAK,IAAI;GACP,IAAI,aAAa;GACjB,MAAM;GACN,OAAO;GACP,MAAM,OAAO,KAAK,SAAS;EAC7B,CAAC;EACH,IAAI,SAAS,uBAAuB,MAAM,QAAQ,KAAK,OAAO,GAC5D,KAAK,MAAM,QAAQ,KAAK,SAAS;GAC/B,MAAM,SAAS,OAAO,IAAI;GAC1B,MAAM,SAAS,OAAO,OAAO,MAAM;GACnC,MAAM,WAAW,KAAK,MAAM,IAAI,MAAM;GACtC,KAAK,KAAK;IACR,GAAG;IACH;IACA,OAAO,OAAO;IACd,WAAW,OAAO,OAAO,KAAK;IAC9B,MAAM,OAAO,OAAO,YAAY,OAAO,QAAQ,OAAO,IAAI;IAC1D,OAAO,UAAU,UAAU,oBAAoB,YAAa,UAAU,SAAS;GACjF,CAAC;EACH;EACF,IAAI,SAAS,yBAAyB;GACpC,MAAM,KAAK,OAAO,KAAK,MAAM;GAC7B,MAAM,WAAW,KAAK,MAAM,IAAI,EAAE;GAClC,MAAM,SAAS,KAAK;GACpB,MAAM,QAAQ,OAAO,KAAK,cAAc;GACxC,KACG,CAAC,YAAY,SAAS,UAAU,uBAChC,WAAW,KAAK,WAAW,UAAU,UAAU,SAChD;IACA,MAAM,aAAa,WAAW,IAAI,KAAM,UAAU,aAAa,MAAO;IACtE,KAAK,KAAK;KACR,QAAQ;KACR,OAAO,WAAW,SAAS;KAC3B;KACA,MAAM,OAAO,KAAK,QAAQ;KAC1B,OAAO;IACT,CAAC;GACH;EACF;EACA,IAAI,SAAS,mBAAmB,SAAS,kBAAkB;GACzD,MAAM,SAAS,OAAO,KAAK,MAAM;GACjC,MAAM,KAAK,OAAO,OAAO,MAAM;GAC/B,MAAM,WAAW,KAAK,MAAM,IAAI,EAAE;GAClC,IAAI,SAAS,oBAAoB,CAAC,YAAY,CAAC,QAAQ,QAAQ,GAC7D,KAAK,KAAK;IACR,GAAG;IACH,QAAQ;IACR,OAAO,UAAU;IACjB,WAAW,UAAU,aAAa;IAClC,MAAM,UAAU,QAAQ,OAAO,OAAO,YAAY,OAAO,IAAI;IAC7D,QAAQ,YAAY,SAAS,OAAO,SAAS;IAC7C,OAAO,KAAK;IACZ,OACE,SAAS,mBACL,YACA,KAAK,WAAW,aACd,aACA,KAAK,WAAW,YAAY,KAAK,SAAS,OACxC,WACA;GACZ,CAAC;EACL;EACA,IAAI,SAAS,oBAAoB,SAAS,iBAAiB,SAAS,kBAC7D;QAAA,MAAM,QAAQ,KAAK,MAAM,OAAO,GACnC,IAAI,CAAC,QAAQ,IAAI,GACf,KAAK,KAAK;IACR,GAAG;IACH,OAAO,SAAS,mBAAmB,cAAc;IACjD,OAAO,KAAK;GACd,CAAC;EAAA;EAEP,IAAI,SAAS,mBAAmB;GAC9B,KAAK,MAAM,WAAW,mBAAmB,MAAM,CAAC,CAAC,MAAM,KAAK,QAAQ,GAClE,KAAK,OAAO,IAAI,QAAQ,WAAW,OAAO;GAC5C,KAAK,QAAQ;EACf;EACA,IAAI,SAAS,oBAAoB,MAAM,QAAQ,KAAK,WAAW,GAC7D,KAAK,MAAM,cAAc,KAAK,aAC5B,KAAK,OAAO,OAAO,OAAO,OAAO,UAAU,CAAC,CAAC,SAAS,CAAC;EAC3D,IAAI,SAAS,kBAAkB;GAC7B,MAAM,QAAQ,OAAO,KAAK,KAAK;GAC/B,MAAM,SAAS,UACb,OAAO,UAAU,WAAW,QAAQ,OAAO,OAAO,KAAK,CAAC,CAAC,SAAS,CAAC;GACrE,KAAK,UAAU,MAAM,MAAM,WAAW,IAAI,MAAM,MAAM,YAAY;EACpE;EACA,IACE,SAAS,qBACR;GAAC;GAAkB;GAAe;EAAgB,CAAC,CAAC,SAAS,IAAI,MAC/D,KAAK,WAAW,KAAA,KAAa,KAAK,WAAW,KAAK,SAErD,KAAK,QAAQ,KAAK,OAAO,OAAO,IAAI,gBAAgB;EACtD,IAAI,CAAC,qBAAqB,gBAAgB,CAAC,CAAC,SAAS,IAAI,GAAG,KAAK,QAAQ,KAAK,MAAM,CAAC;EACrF,IACE,KAAK,SAAS,SAAS,KACvB,SAAS,oBACT,KAAK,WAAW,aAAa,KAC7B,KAAK,WAAW,gBAAgB,KAChC,KAAK,WAAW,WAAW,GAE3B,KAAK,IAAI;GACP,IAAI,SAAS,MAAM,MAAM,MAAM,KAAK;GACpC,MAAM,KAAK,SAAS,SAAS,IAAI,UAAU;GAC3C,OAAO;GACP,MAAM,OACJ,KAAK,WAAW,KAAK,UAAU,KAAK,iBAAiB,KAAK,gBAAgB,KAAK,QAAQ,EACzF;EACF,CAAC;CAEL;CAEA,KAAa,MAAgB;EAC3B,KAAK,MAAM,IAAI,KAAK,QAAQ,IAAI;EAChC,MAAM,SAAS,KAAK,SAAS,KAAK;EAClC,KAAK,IAAI;GACP,IAAI,QAAQ,KAAK;GACjB,MAAM;GACN,OAAO,KAAK;GACZ;GACA,MAAM,sBAAsB,KAAK,UAAU,UAAU,WAAW,KAAA,IAAY,KAAK,uBAAuB,OAAO,MAAM,EAAE;EACzH,CAAC;CACH;AACF"}

package/dist/client.d.mts

@@ -0,0 +1,343 @@
+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 { 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";
+//#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?: string;
+  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 {
+  /**
+   * Canonical Factory origin. It must be HTTPS, except for HTTP loopback development, and cannot
+   * contain credentials, a path, query parameters, or a fragment.
+   */
+  readonly url: string;
+  /**
+   * Headers resolved immediately before every request, allowing short-lived authentication to be
+   * refreshed. Factory always sets `content-type` to `application/json` afterward.
+   */
+  readonly headers?: () => MaybePromise<HeadersInit>;
+  /** Fetch implementation used for every request; defaults to `globalThis.fetch`. */
+  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";
+}
+/** Selects the observed execution whose review evidence should be read. */
+interface SessionReviewOptions {
+  readonly sessionId: AgentSessionId;
+  readonly executionId: string | null;
+  readonly signal?: AbortSignal;
+}
+/** Selects the observed execution whose preview links and instructions should be read. */
+interface SessionPreviewsOptions {
+  readonly sessionId: AgentSessionId;
+  readonly executionId: string | null;
+  readonly signal?: AbortSignal;
+}
+/** 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 a file or directory at an observed execution and optional immutable revision. */
+interface WorkspaceFilesOptions extends WorkspaceFilesRequest {
+  readonly sessionId: AgentSessionId;
+  readonly executionId: string | null;
+  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.
+ *
+ * @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.
+ */
+declare class FactoryClient {
+  private readonly options;
+  private readonly 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: 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 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[]>;
+  /**
+   * 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.
+   */
+  getSessionPage(options?: SessionListOptions): Promise<SessionPage>;
+  /** Reads application-owned external work requiring operator attention. */
+  getInboxActivity(): Promise<InboxActivity>;
+  /** Reads application model choices and optional repository defaults. */
+  getModelSettings(repository?: RepositorySlug): Promise<ModelSettings>;
+  /** Saves repository defaults only when their observed revision still matches. */
+  updateModelDefaults(input: UpdateModelDefaults): Promise<ModelSettings>;
+  /** 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.
+   *
+   * @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.
+   */
+  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 application-owned previews without starting an agent, deployment, or server. */
+  getSessionPreviews(options: SessionPreviewsOptions): Promise<SessionPreviews>;
+  /** Reads recorded checks, screenshots, and issues through the application's review reader. */
+  getSessionReview(options: SessionReviewOptions): Promise<SessionReview>;
+  /** Reads a directory or complete file through the factory's configured workspace adapter. */
+  getWorkspaceFiles(options: WorkspaceFilesOptions): Promise<WorkspaceFiles>;
+  /** Reads the committed workspace comparison for one observed execution. */
+  getWorkspaceDiff(options: WorkspaceDiffOptions): Promise<WorkspaceDiff>;
+  /**
+   * 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.
+   */
+  createSession(input: CreateSessionRequest): Promise<SessionView>;
+  /** Creates or recovers idempotent workflow work through a specialist signal. */
+  createSignal(input: CreateSessionRequest): Promise<SessionView>;
+  /** Starts a deepsec security scan of a repository, or returns its already-active scan. */
+  runSecurityScan(repositoryId: RepositoryId): Promise<{
+    taskId: TaskId;
+    reused: boolean;
+  }>;
+  /**
+   * 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.
+   */
+  sendSessionMessage(id: AgentSessionId, input: SendSessionMessageRequest): Promise<void>;
+  /**
+   * 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.
+   */
+  submitSessionInput(id: AgentSessionId, input: SubmitSessionInputRequest): Promise<void>;
+  /**
+   * 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.
+   */
+  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 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 };
+//# sourceMappingURL=client.d.mts.map