@vercel/factory 0.0.15 → 0.0.16

package/dist/client-stream.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"client-stream.mjs","names":[],"sources":["../src/client-stream.ts"],"sourcesContent":["import { ApiError, type FactoryClient } from \"./client\";\nimport { readEvents } from \"./client-events\";\nimport { Transcript } from \"./client-transcript\";\nimport type { SessionView } from \"./api-contracts\";\nimport type { TaskId } from \"./schema/id\";\nimport type { AgentSessionId } from \"./schema/session\";\nimport { transcriptSnapshotSchema } from \"./schema/transcript\";\n\n/** Client operations required to hydrate and follow a Factory session stream. */\nexport type SessionStreamClient = Pick<\n  FactoryClient,\n  \"getSessionTranscriptResponse\" | \"getSessionEventStreamResponse\"\n>;\n\n/** Callbacks and exact execution identity used while following a session stream. */\nexport interface FollowSessionStreamOptions {\n  readonly sessionId: AgentSessionId;\n  readonly executionId: string | null;\n  readonly taskId?: TaskId;\n  readonly history?: readonly NonNullable<SessionView[\"history\"]>[number][];\n  readonly transcript: Transcript;\n  readonly signal: AbortSignal;\n  readonly pollIntervalMs?: number;\n  readonly onHydrated: () => void;\n  readonly onChange: () => void;\n  readonly onConnection: (state: \"connected\" | \"reconnecting\") => void;\n  readonly onError: (error: unknown) => void;\n  readonly onConflict: () => Promise<void>;\n}\n\nfunction pause(ms: number, signal: AbortSignal): Promise<void> {\n  return new Promise((resolve) => {\n    const finish = () => {\n      clearTimeout(timer);\n      signal.removeEventListener(\"abort\", finish);\n      resolve();\n    };\n    const timer = setTimeout(finish, ms);\n    signal.addEventListener(\"abort\", finish, { once: true });\n    if (signal.aborted) finish();\n  });\n}\n\nasync function readSnapshot(\n  client: SessionStreamClient,\n  input: {\n    sessionId: AgentSessionId;\n    executionId: string;\n    taskId?: TaskId;\n    history: boolean;\n    transcript: Transcript;\n    signal: AbortSignal;\n    pollIntervalMs: number;\n    onRetry?(error: unknown): void;\n  },\n) {\n  let failures = 0;\n  while (!input.signal.aborted) {\n    try {\n      const requestSignal = AbortSignal.any([input.signal, AbortSignal.timeout(15_000)]);\n      const response = await client.getSessionTranscriptResponse({\n        sessionId: input.sessionId,\n        executionId: input.executionId,\n        ...(input.taskId === undefined ? {} : { taskId: input.taskId }),\n        ...(input.history ? { history: true } : {}),\n        signal: requestSignal,\n      });\n      input.transcript.hydrate(transcriptSnapshotSchema.parse(await response.json()));\n      return;\n    } catch (error) {\n      if (input.signal.aborted) return;\n      if (error instanceof ApiError) throw error;\n      input.onRetry?.(error);\n      failures++;\n      await pause(\n        Math.min(15_000, input.pollIntervalMs * 2 ** Math.min(failures, 3)),\n        input.signal,\n      );\n    }\n  }\n}\n\nasync function loadHistory(\n  client: SessionStreamClient,\n  options: FollowSessionStreamOptions,\n): Promise<{ id: string; transcript: Transcript }[]> {\n  const entries = options.history ?? [];\n  const results = new Map<number, { id: string; transcript: Transcript }>();\n  let next = 0;\n  await Promise.all(\n    Array.from({ length: Math.min(4, entries.length) }, async () => {\n      while (next < entries.length) {\n        const index = next++;\n        const entry = entries[index];\n        if (!entry) throw new Error(\"Historical transcript index is unavailable\");\n        const id = entry.execution.sessionId;\n        const previous = new Transcript(entry.message, entry.attachments);\n        const header = {\n          id: \"run\",\n          kind: \"status\",\n          title: entry.agent,\n          text: entry.taskId ? `Earlier work · ${entry.taskId}` : \"Earlier execution\",\n        } as const;\n        try {\n          const historySignal = AbortSignal.any([options.signal, AbortSignal.timeout(15_000)]);\n          await readSnapshot(client, {\n            sessionId: options.sessionId,\n            executionId: id,\n            history: true,\n            transcript: previous,\n            signal: historySignal,\n            pollIntervalMs: options.pollIntervalMs ?? 2000,\n          });\n          if (historySignal.aborted && !options.signal.aborted)\n            throw new Error(\"Historical transcript loading timed out\");\n        } catch (error) {\n          if (options.signal.aborted) return;\n          if (error instanceof ApiError && [401, 403].includes(error.status)) throw error;\n          previous.put({\n            id: \"unavailable\",\n            kind: \"status\",\n            title: \"History unavailable\",\n            text: \"This execution's transcript could not be loaded.\",\n          });\n        }\n        previous.blocks.unshift(header);\n        results.set(index, { id, transcript: previous });\n      }\n    }),\n  );\n  return entries.map((_, index) => {\n    const result = results.get(index);\n    if (!result) throw new Error(\"Historical transcript loading did not complete\");\n    return result;\n  });\n}\n\nasync function hydrateCurrent(\n  client: SessionStreamClient,\n  options: FollowSessionStreamOptions,\n): Promise<boolean> {\n  const executionId = options.executionId;\n  if (executionId === null) return true;\n  let failures = 0;\n  while (!options.signal.aborted) {\n    try {\n      await readSnapshot(client, {\n        sessionId: options.sessionId,\n        executionId,\n        taskId: options.taskId,\n        history: false,\n        transcript: options.transcript,\n        signal: options.signal,\n        pollIntervalMs: options.pollIntervalMs ?? 2000,\n        onRetry: (error) => {\n          options.onConnection(\"reconnecting\");\n          options.onError(error);\n        },\n      });\n      if (options.signal.aborted) return false;\n      options.onConnection(\"connected\");\n      return true;\n    } catch (error) {\n      if (options.signal.aborted) return false;\n      options.onConnection(\"reconnecting\");\n      failures++;\n      options.onError(error);\n      if (\n        error instanceof ApiError &&\n        [0, 301, 302, 303, 307, 308, 401, 403].includes(error.status)\n      )\n        return false;\n      if (error instanceof ApiError && options.taskId && error.status === 404) return false;\n      if (error instanceof ApiError && error.status === 409) {\n        await options.onConflict();\n        return false;\n      }\n      await pause(\n        Math.min(15_000, (options.pollIntervalMs ?? 2000) * 2 ** Math.min(failures, 3)),\n        options.signal,\n      );\n    }\n  }\n  return false;\n}\n\n/** Hydrates a transcript and follows its current execution until completion or disconnection. */\nexport async function followSessionStream(\n  client: SessionStreamClient,\n  options: FollowSessionStreamOptions,\n): Promise<void> {\n  const { sessionId, executionId, transcript, signal } = options;\n  let history: { id: string; transcript: Transcript }[];\n  let hydrated: boolean;\n  try {\n    [history, hydrated] = await Promise.all([\n      loadHistory(client, options),\n      hydrateCurrent(client, options),\n    ]);\n  } catch (error) {\n    if (!signal.aborted) options.onError(error);\n    return;\n  }\n  if (signal.aborted || !hydrated) return;\n  transcript.prependHistory(history);\n  if (executionId === null) transcript.state = \"waiting\";\n  options.onHydrated();\n  if (executionId === null || [\"completed\", \"failed\"].includes(transcript.state)) return;\n  let failures = 0;\n  while (!signal.aborted) {\n    const recycle = AbortSignal.timeout(60_000);\n    let established = false;\n    try {\n      const response = await client.getSessionEventStreamResponse({\n        sessionId,\n        executionId,\n        cursor: transcript.cursor,\n        ...(options.taskId === undefined ? {} : { taskId: options.taskId }),\n        signal: AbortSignal.any([signal, recycle]),\n      });\n      if (!response.body) throw new Error(\"The factory returned an empty stream\");\n      established = true;\n      options.onConnection(\"connected\");\n      for await (const event of readEvents(response.body)) {\n        if (signal.aborted) return;\n        transcript.accept(event);\n        failures = 0;\n        options.onChange();\n      }\n      if ([\"completed\", \"failed\"].includes(transcript.state)) return;\n    } catch (error) {\n      if (signal.aborted) return;\n      options.onConnection(\"reconnecting\");\n      if (recycle.aborted && established) {\n        failures = 0;\n        continue;\n      }\n      failures++;\n      options.onError(error);\n      if (\n        error instanceof ApiError &&\n        [0, 301, 302, 303, 307, 308, 401, 403].includes(error.status)\n      )\n        return;\n      if (error instanceof ApiError && options.taskId && error.status === 404) return;\n      if (error instanceof ApiError && error.status === 409) {\n        await options.onConflict();\n        return;\n      }\n    }\n    await pause(\n      Math.min(15_000, (options.pollIntervalMs ?? 2000) * 2 ** Math.min(failures, 3)),\n      signal,\n    );\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"client-stream.mjs","names":[],"sources":["../src/client-stream.ts"],"sourcesContent":["import { ApiError, type FactoryClient } from \"./client\";\nimport { readEvents } from \"./client-events\";\nimport { Transcript } from \"./client-transcript\";\nimport type { SessionView } from \"./api-contracts\";\nimport type { TaskId } from \"./schema/id\";\nimport type { AgentSessionId } from \"./schema/session\";\nimport { transcriptSnapshotSchema } from \"./schema/transcript\";\n\n/** Client operations required to hydrate and follow a Factory session stream. */\nexport type SessionStreamClient = Pick<\n  FactoryClient,\n  \"getSessionTranscriptResponse\" | \"getSessionEventStreamResponse\"\n>;\n\n/** Callbacks and exact execution identity used while following a session stream. */\nexport interface FollowSessionStreamOptions {\n  readonly sessionId: AgentSessionId;\n  readonly executionId: string | null;\n  readonly taskId?: TaskId;\n  readonly history?: readonly NonNullable<SessionView[\"history\"]>[number][];\n  readonly transcript: Transcript;\n  readonly signal: AbortSignal;\n  readonly pollIntervalMs?: number;\n  readonly onHydrated: () => void;\n  readonly onChange: () => void;\n  readonly onConnection: (state: \"connected\" | \"reconnecting\") => void;\n  readonly onError: (error: unknown) => void;\n  readonly onConflict: () => Promise<void>;\n}\n\nfunction pause(ms: number, signal: AbortSignal): Promise<void> {\n  return new Promise((resolve) => {\n    const finish = () => {\n      clearTimeout(timer);\n      signal.removeEventListener(\"abort\", finish);\n      resolve();\n    };\n    const timer = setTimeout(finish, ms);\n    signal.addEventListener(\"abort\", finish, { once: true });\n    if (signal.aborted) finish();\n  });\n}\n\nasync function readSnapshot(\n  client: SessionStreamClient,\n  input: {\n    sessionId: AgentSessionId;\n    executionId: string;\n    taskId?: TaskId;\n    history: boolean;\n    transcript: Transcript;\n    signal: AbortSignal;\n    pollIntervalMs: number;\n    onRetry?(error: unknown): void;\n  },\n) {\n  let failures = 0;\n  while (!input.signal.aborted) {\n    try {\n      const requestSignal = AbortSignal.any([input.signal, AbortSignal.timeout(15_000)]);\n      const response = await client.getSessionTranscriptResponse({\n        sessionId: input.sessionId,\n        executionId: input.executionId,\n        ...(input.taskId === undefined ? {} : { taskId: input.taskId }),\n        ...(input.history ? { history: true } : {}),\n        signal: requestSignal,\n      });\n      input.transcript.hydrate(transcriptSnapshotSchema.parse(await response.json()));\n      return;\n    } catch (error) {\n      if (input.signal.aborted) return;\n      if (error instanceof ApiError) throw error;\n      input.onRetry?.(error);\n      failures++;\n      await pause(\n        Math.min(15_000, input.pollIntervalMs * 2 ** Math.min(failures, 3)),\n        input.signal,\n      );\n    }\n  }\n}\n\nasync function loadHistory(\n  client: SessionStreamClient,\n  options: FollowSessionStreamOptions,\n): Promise<{ id: string; transcript: Transcript }[]> {\n  const entries = options.history ?? [];\n  const results = new Map<number, { id: string; transcript: Transcript }>();\n  let next = 0;\n  await Promise.all(\n    Array.from({ length: Math.min(4, entries.length) }, async () => {\n      while (next < entries.length) {\n        const index = next++;\n        const entry = entries[index];\n        if (!entry) throw new Error(\"Historical transcript index is unavailable\");\n        const id = entry.execution.sessionId;\n        const previous = new Transcript(entry.message, entry.attachments);\n        const header = {\n          id: \"run\",\n          kind: \"status\",\n          title: entry.agent,\n          text: entry.taskId ? `Earlier work · ${entry.taskId}` : \"Earlier execution\",\n        } as const;\n        try {\n          const historySignal = AbortSignal.any([options.signal, AbortSignal.timeout(15_000)]);\n          await readSnapshot(client, {\n            sessionId: options.sessionId,\n            executionId: id,\n            history: true,\n            transcript: previous,\n            signal: historySignal,\n            pollIntervalMs: options.pollIntervalMs ?? 2000,\n          });\n          if (historySignal.aborted && !options.signal.aborted)\n            throw new Error(\"Historical transcript loading timed out\");\n        } catch (error) {\n          if (options.signal.aborted) return;\n          if (error instanceof ApiError && [401, 403].includes(error.status)) throw error;\n          previous.put({\n            id: \"unavailable\",\n            kind: \"status\",\n            title: \"History unavailable\",\n            text: \"This execution's transcript could not be loaded.\",\n          });\n        }\n        previous.blocks.unshift(header);\n        results.set(index, { id, transcript: previous });\n      }\n    }),\n  );\n  return entries.map((_, index) => {\n    const result = results.get(index);\n    if (!result) throw new Error(\"Historical transcript loading did not complete\");\n    return result;\n  });\n}\n\nasync function hydrateCurrent(\n  client: SessionStreamClient,\n  options: FollowSessionStreamOptions,\n): Promise<boolean> {\n  const executionId = options.executionId;\n  if (executionId === null) return true;\n  let failures = 0;\n  while (!options.signal.aborted) {\n    try {\n      await readSnapshot(client, {\n        sessionId: options.sessionId,\n        executionId,\n        taskId: options.taskId,\n        history: false,\n        transcript: options.transcript,\n        signal: options.signal,\n        pollIntervalMs: options.pollIntervalMs ?? 2000,\n        onRetry: (error) => {\n          options.onConnection(\"reconnecting\");\n          options.onError(error);\n        },\n      });\n      if (options.signal.aborted) return false;\n      options.onConnection(\"connected\");\n      return true;\n    } catch (error) {\n      if (options.signal.aborted) return false;\n      options.onConnection(\"reconnecting\");\n      failures++;\n      options.onError(error);\n      if (\n        error instanceof ApiError &&\n        [0, 301, 302, 303, 307, 308, 401, 403].includes(error.status)\n      )\n        return false;\n      if (error instanceof ApiError && error.status === 404) return false;\n      if (error instanceof ApiError && error.status === 409) {\n        await options.onConflict();\n        return false;\n      }\n      await pause(\n        Math.min(15_000, (options.pollIntervalMs ?? 2000) * 2 ** Math.min(failures, 3)),\n        options.signal,\n      );\n    }\n  }\n  return false;\n}\n\n/** Hydrates a transcript and follows its current execution until completion or disconnection. */\nexport async function followSessionStream(\n  client: SessionStreamClient,\n  options: FollowSessionStreamOptions,\n): Promise<void> {\n  const { sessionId, executionId, transcript, signal } = options;\n  let history: { id: string; transcript: Transcript }[];\n  let hydrated: boolean;\n  try {\n    [history, hydrated] = await Promise.all([\n      loadHistory(client, options),\n      hydrateCurrent(client, options),\n    ]);\n  } catch (error) {\n    if (!signal.aborted) options.onError(error);\n    return;\n  }\n  if (signal.aborted || !hydrated) return;\n  transcript.prependHistory(history);\n  if (executionId === null) transcript.state = \"waiting\";\n  options.onHydrated();\n  if (executionId === null || [\"completed\", \"failed\"].includes(transcript.state)) return;\n  let failures = 0;\n  while (!signal.aborted) {\n    const recycle = AbortSignal.timeout(60_000);\n    let established = false;\n    try {\n      const response = await client.getSessionEventStreamResponse({\n        sessionId,\n        executionId,\n        cursor: transcript.cursor,\n        ...(options.taskId === undefined ? {} : { taskId: options.taskId }),\n        signal: AbortSignal.any([signal, recycle]),\n      });\n      if (!response.body) throw new Error(\"The factory returned an empty stream\");\n      established = true;\n      options.onConnection(\"connected\");\n      for await (const event of readEvents(response.body)) {\n        if (signal.aborted) return;\n        transcript.accept(event);\n        failures = 0;\n        options.onChange();\n      }\n      if ([\"completed\", \"failed\"].includes(transcript.state)) return;\n    } catch (error) {\n      if (signal.aborted) return;\n      options.onConnection(\"reconnecting\");\n      if (recycle.aborted && established) {\n        failures = 0;\n        continue;\n      }\n      failures++;\n      options.onError(error);\n      if (\n        error instanceof ApiError &&\n        [0, 301, 302, 303, 307, 308, 401, 403].includes(error.status)\n      )\n        return;\n      if (error instanceof ApiError && error.status === 404) {\n        if (transcript.state === \"running\") {\n          transcript.state = \"connecting\";\n          options.onChange();\n        }\n        return;\n      }\n      if (error instanceof ApiError && error.status === 409) {\n        await options.onConflict();\n        return;\n      }\n    }\n    await pause(\n      Math.min(15_000, (options.pollIntervalMs ?? 2000) * 2 ** Math.min(failures, 3)),\n      signal,\n    );\n  }\n}\n"],"mappings":"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"}

package/dist/client-transcript.mjs

@@ -202,7 +202,11 @@ var Transcript = class {
 			const total = (value) => typeof value === "number" ? value : Number(record(value).total ?? 0);
 			this.tokens += total(usage.inputTokens) + total(usage.outputTokens);
 		}
-		if (type === "session.waiting") this.state = this.inputs.size > 0 ? "needs input" : "waiting";
+		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}`,

package/dist/client-transcript.mjs.map

@@ -1 +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 (type === \"session.waiting\") 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,IAAI,SAAS,mBAAmB,KAAK,QAAQ,KAAK,OAAO,OAAO,IAAI,gBAAgB;EACpF,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"}
+{"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":"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"}

package/dist/client.d.mts

@@ -1,5 +1,10 @@
+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 { TaskId } from "./schema/id.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";
@@ -9,7 +14,6 @@ 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";
@@ -24,7 +28,7 @@ interface SessionListOptions {
   readonly scope?: "all" | "interactive";
   readonly detail?: "full" | "summary";
   readonly limit?: number;
-  readonly cursor?: AgentSessionId;
+  readonly cursor?: string;
   readonly query?: string;
   readonly repository?: RepositorySlug;
   readonly agent?: string;
@@ -42,8 +46,17 @@ declare class ApiError extends Error {
 }
 /** 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. */
@@ -56,6 +69,18 @@ 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;
@@ -68,6 +93,12 @@ interface GraphTranscriptOptions {
   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;
@@ -90,10 +121,24 @@ interface SessionEventStreamRequest {
   readonly taskId?: TaskId;
   readonly signal: AbortSignal;
 }
-/** Browser-safe typed client for the public Factory HTTP API. */
+/**
+ * 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. */
@@ -183,15 +228,36 @@ declare class FactoryClient {
   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. */
+  /**
+   * 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. */
+  /**
+   * 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. */
+  /**
+   * 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>;
@@ -199,17 +265,60 @@ declare class FactoryClient {
   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. */
+  /**
+   * 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>;
-  /** Sends a message to an existing session. */
+  /** 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. */
+  /**
+   * 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>;
-  /** Dispatches queued workflow work associated with a session. */
+  /**
+   * 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>;
@@ -230,5 +339,5 @@ declare class FactoryClient {
   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 };
+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

package/dist/client.mjs

@@ -1,3 +1,4 @@
+import { taskIdSchema } from "./schema/id.mjs";
 import { repositorySlugSchema } from "./schema/repository.mjs";
 import { taskSchema, taskStateSchema } from "./schema/task.mjs";
 import { readEvents, streamEventSchema } from "./client-events.mjs";
@@ -7,6 +8,11 @@ import { Transcript } from "./client-transcript.mjs";
 import { approvalPageSchema, approvalRequestSchema, approvalViewSchema } from "./approval-contracts.mjs";
 import { agentSessionIdSchema, agentSessionSchema } from "./schema/session.mjs";
 import { changeSchema } from "./schema/change.mjs";
+import { inboxActivityItemSchema, inboxActivitySchema } from "./inbox-activity.mjs";
+import { agentModelConfigSchema, modelSettingsSchema, updateModelDefaultsSchema } from "./model-settings.mjs";
+import { sessionPreviewSchema, sessionPreviewsSchema } from "./session-previews.mjs";
+import { sessionReviewCheckSchema, sessionReviewIssueSchema, sessionReviewSchema, sessionReviewScreenshotSchema } from "./session-review.mjs";
+import { workspaceFileContentSchema, workspaceFileEntrySchema, workspaceFilesRequestSchema, workspaceFilesSchema, workspacePathSchema } from "./workspace-files.mjs";
 import { describeIntake, intakePageSchema, intakeViewSchema, retryIntakeSchema } from "./intake-contracts.mjs";
 import { answerSessionQuestionRequestSchema, apiAgentSchema, controlSessionRequestSchema, createSessionRequestSchema, pendingFollowUpSchema, repositoryDetailsSchema, repositorySummarySchema, sendSessionMessageRequestSchema, sessionInputResponseSchema, sessionPageSchema, sessionViewSchema, submitSessionInputRequestSchema } from "./api-contracts.mjs";
 import { workspaceDiffFileSchema, workspaceDiffSchema } from "./workspace-diff.mjs";
@@ -26,10 +32,24 @@ var ApiError = class extends Error {
 		this.actor = actor;
 	}
 };
-/** Browser-safe typed client for the public Factory HTTP API. */
+/**
+* Browser-safe typed client for the public Factory HTTP API.
+*
+* @remarks
+* Requests use same-origin credentials, bypass HTTP caches, and refuse redirects so authentication
+* redirects cannot be mistaken for API responses. When no caller signal is available, requests
+* time out after 30 seconds. Non-success responses throw {@link ApiError}; successful JSON bodies
+* are still validated against their public schemas before being returned.
+*/
 var FactoryClient = class {
 	options;
 	origin;
+	/**
+	* Creates a client for one canonical Factory origin without performing a request.
+	*
+	* @param options - Factory origin plus optional per-request headers and fetch implementation.
+	* @throws When `options.url` is not an HTTPS origin or an HTTP loopback origin.
+	*/
 	constructor(options) {
 		this.options = options;
 		const url = new URL(options.url);
@@ -134,15 +154,38 @@ var FactoryClient = class {
 	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. */
+	/**
+	* Lists sessions matching the requested operator scope without pagination metadata.
+	*
+	* @param options - Optional scope and detail projection; both use their server defaults when omitted.
+	* @returns The first matching page's sessions. Use {@link getSessionPage} to follow cursors.
+	*/
 	async listSessions(options = {}) {
 		return (await this.getSessionPage(options)).sessions;
 	}
-	/** Reads a filtered, cursor-paginated page of sessions. */
+	/**
+	* Reads a filtered, cursor-paginated page of sessions.
+	*
+	* @param options - Filters, cursor, projection detail, and page limit sent to the API.
+	* @returns The validated page, including its continuation cursor and optional total count.
+	*/
 	async getSessionPage(options = {}) {
 		const query = new URLSearchParams(Object.entries(options).filter(([, value]) => value !== void 0).map(([key, value]) => [key, String(value)])).toString();
 		return sessionPageSchema.parse(await (await this.response(`sessions${query ? `?${query}` : ""}`)).json());
 	}
+	/** Reads application-owned external work requiring operator attention. */
+	async getInboxActivity() {
+		return inboxActivitySchema.parse(await (await this.response("inbox-activity")).json());
+	}
+	/** Reads application model choices and optional repository defaults. */
+	async getModelSettings(repository) {
+		const query = repository ? `?${new URLSearchParams({ repository })}` : "";
+		return modelSettingsSchema.parse(await (await this.response(`models${query}`)).json());
+	}
+	/** Saves repository defaults only when their observed revision still matches. */
+	async updateModelDefaults(input) {
+		return modelSettingsSchema.parse(await (await this.response("models", updateModelDefaultsSchema.parse(input))).json());
+	}
 	/** Counts sessions that currently require operator attention. */
 	async getInboxCount() {
 		return z.object({ totalCount: z.number().int().nonnegative() }).parse(await (await this.response("sessions?scope=all&detail=summary&attention=true&includeTotal=true&limit=1")).json()).totalCount;
@@ -156,7 +199,12 @@ var FactoryClient = class {
 		});
 		return z.object({ sessions: z.array(sessionViewSchema).readonly() }).parse(await (await this.response(`sessions?${query}`)).json()).sessions;
 	}
-	/** Reads one operator session. */
+	/**
+	* Reads one operator session.
+	*
+	* @param options - Stable session ID and optional summary or full projection.
+	* @returns The current validated session view; it is a snapshot and does not follow live events.
+	*/
 	async getSession(options) {
 		return sessionViewSchema.parse(await (await this.response(`sessions/${encodeURIComponent(options.id)}${options.detail ? `?detail=${options.detail}` : ""}`)).json());
 	}
@@ -184,11 +232,42 @@ var FactoryClient = class {
 			history: previous.history
 		};
 	}
+	/** Reads application-owned previews without starting an agent, deployment, or server. */
+	async getSessionPreviews(options) {
+		return sessionPreviewsSchema.parse(await (await this.response(`sessions/${encodeURIComponent(options.sessionId)}/previews?${new URLSearchParams({ executionId: options.executionId ?? "" })}`, void 0, options.signal)).json());
+	}
+	/** Reads recorded checks, screenshots, and issues through the application's review reader. */
+	async getSessionReview(options) {
+		return sessionReviewSchema.parse(await (await this.response(`sessions/${encodeURIComponent(options.sessionId)}/review?${new URLSearchParams({ executionId: options.executionId ?? "" })}`, void 0, options.signal)).json());
+	}
+	/** Reads a directory or complete file through the factory's configured workspace adapter. */
+	async getWorkspaceFiles(options) {
+		const query = workspaceFilesRequestSchema.parse({
+			path: options.path,
+			revision: options.revision
+		});
+		const params = new URLSearchParams({
+			executionId: options.executionId ?? "",
+			path: query.path
+		});
+		if (query.revision !== void 0) params.set("revision", query.revision);
+		return workspaceFilesSchema.parse(await (await this.response(`sessions/${encodeURIComponent(options.sessionId)}/files?${params}`, void 0, options.signal)).json());
+	}
 	/** Reads the committed workspace comparison for one observed execution. */
 	async getWorkspaceDiff(options) {
 		return workspaceDiffSchema.parse(await (await this.response(`sessions/${encodeURIComponent(options.sessionId)}/diff?${new URLSearchParams({ executionId: options.executionId ?? "" })}`, void 0, options.signal)).json());
 	}
-	/** Creates or recovers an idempotent conversational session. */
+	/**
+	* Creates or recovers an idempotent conversational session.
+	*
+	* @remarks
+	* Retain `input.operationId` unchanged across ambiguous failures. Reusing it with identical input
+	* returns the original session; reusing it with different input is a conflict. The returned view
+	* means admission and any initial dispatch attempt finished, not that the agent's work completed.
+	*
+	* @param input - Agent, initial content, optional repository/change, and client idempotency key.
+	* @returns The admitted or recovered session snapshot.
+	*/
 	async createSession(input) {
 		return sessionViewSchema.parse(await (await this.response("sessions", createSessionRequestSchema.parse(input))).json());
 	}
@@ -196,15 +275,44 @@ var FactoryClient = class {
 	async createSignal(input) {
 		return sessionViewSchema.parse(await (await this.response("signals", createSessionRequestSchema.parse(input))).json());
 	}
-	/** Sends a message to an existing session. */
+	/** Starts a deepsec security scan of a repository, or returns its already-active scan. */
+	async runSecurityScan(repositoryId) {
+		return z.strictObject({
+			taskId: taskIdSchema,
+			reused: z.boolean()
+		}).parse(await (await this.response(`repositories/${repositoryId}/security-scan`, {})).json());
+	}
+	/**
+	* Sends a message to an existing session using optimistic execution matching.
+	*
+	* @remarks
+	* `input.executionId` must be the execution the caller observed, or `null` when none was active.
+	* A completed Task follow-up also requires an `operationId`, which must be retained for retries.
+	* Resolving means the API accepted the message; provider or follow-up work may still be running.
+	*
+	* @param id - Stable Factory session receiving the message.
+	* @param input - Message, observed execution, steering policy, attachments, and optional retry key.
+	* @returns Nothing after the API accepts the request.
+	*/
 	async sendSessionMessage(id, input) {
 		await (await this.response(`sessions/${encodeURIComponent(id)}/messages`, sendSessionMessageRequestSchema.parse(input))).body?.cancel();
 	}
-	/** Submits responses to pending provider input requests. */
+	/**
+	* Submits responses to pending provider input requests.
+	*
+	* @param id - Stable Factory session whose provider requested input.
+	* @param input - Observed execution ID and one or more request-correlated responses.
+	* @returns Nothing after the API accepts the responses; stale execution IDs are rejected.
+	*/
 	async submitSessionInput(id, input) {
 		await (await this.response(`sessions/${encodeURIComponent(id)}/input`, submitSessionInputRequestSchema.parse(input))).body?.cancel();
 	}
-	/** Dispatches queued workflow work associated with a session. */
+	/**
+	* Attempts to dispatch queued workflow work associated with a session.
+	*
+	* @param id - Stable Factory session whose current work should be dispatched.
+	* @returns The refreshed session after the bounded dispatch attempt, which may still be queued.
+	*/
 	async dispatchSession(id) {
 		return sessionViewSchema.parse(await (await this.response(`sessions/${encodeURIComponent(id)}/dispatch`, {})).json());
 	}
@@ -253,6 +361,6 @@ var FactoryClient = class {
 	}
 };
 //#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 };
+export { ApiError, FactoryClient, MAX_IMAGES, MAX_IMAGE_BYTES, Transcript, agentModelConfigSchema, agentSessionIdSchema, agentSessionSchema, answerSessionQuestionRequestSchema, apiAgentSchema, controlSessionRequestSchema, createSessionRequestSchema, describeIntake, followSessionStream, imageAttachmentSchema, imageAttachmentsSchema, imageIdSchema, inboxActivityItemSchema, inboxActivitySchema, inputRequestSchema, modelSettingsSchema, pendingFollowUpSchema, readEvents, repositoryDetailsSchema, repositorySummarySchema, sendSessionMessageRequestSchema, sessionInputResponseSchema, sessionPageSchema, sessionPreviewSchema, sessionPreviewsSchema, sessionReviewCheckSchema, sessionReviewIssueSchema, sessionReviewSchema, sessionReviewScreenshotSchema, sessionViewSchema, streamEventSchema, submitSessionInputRequestSchema, taskStates, toolCallSchema, transcriptBlockSchema, transcriptSnapshotSchema, updateModelDefaultsSchema, workspaceDiffFileSchema, workspaceDiffSchema, workspaceFileContentSchema, workspaceFileEntrySchema, workspaceFilesRequestSchema, workspaceFilesSchema, workspacePathSchema };
 
 //# sourceMappingURL=client.mjs.map