ima2-gen 1.1.21 → 1.1.23

package/lib/agentStore.ts

@@ -1,422 +0,0 @@
-import { ulid } from "ulid";
-import { getDb } from "./db.js";
-import { getAgentQueueProjection } from "./agentQueueStore.js";
-import {
-  DEFAULT_AGENT_GENERATION_SETTINGS,
-  mergeAgentGenerationSettings,
-} from "./agentSettings.js";
-import {
-  cleanString,
-  cleanStringArray,
-  imageFromRow,
-  jsonStringArray,
-  parseStringArray,
-  sessionFromRow,
-  turnFromRow,
-  type AgentImageRow,
-  type AgentSessionRow,
-  type AgentTurnRow,
-} from "./agentStoreRows.js";
-import {
-  AGENT_ALLOWED_TOOLS,
-  type AgentGenerationSettings,
-  type AgentImageHandle,
-  type AgentImageInput,
-  type AgentTurn,
-  type AgentTurnRole,
-  type AgentTurnStatus,
-  type AgentWorkspacePayload,
-} from "./agentTypes.js";
-
-type FindingRow = {
-  id: string;
-  query: string;
-  url: string | null;
-  title: string | null;
-  snippet: string | null;
-};
-type LockRow = { styleLocks: string; subjectLocks: string };
-type ReferenceRow = {
-  id: string;
-  role: string;
-  imageId: string | null;
-  filename: string | null;
-  url: string | null;
-  prompt: string | null;
-};
-
-function now() {
-  return Date.now();
-}
-
-export function listAgentSessions() {
-  const db = getDb();
-  const rows = db.prepare(`
-    SELECT
-      s.id,
-      s.title,
-      s.codex_thread_id AS codexThreadId,
-      s.last_turn_id AS lastTurnId,
-      s.current_image_id AS currentImageId,
-	      s.compacted,
-	      s.web_search_enabled AS webSearchEnabled,
-	      s.generation_settings AS generationSettings,
-	      s.updated_at AS updatedAt,
-      COUNT(i.id) AS imageCount
-    FROM agent_sessions s
-    LEFT JOIN agent_images i ON i.session_id = s.id
-    GROUP BY s.id
-    ORDER BY s.updated_at DESC
-  `).all() as AgentSessionRow[];
-  return rows.map(sessionFromRow);
-}
-
-export function getAgentSession(id: string) {
-  return listAgentSessions().find((session) => session.id === id) ?? null;
-}
-
-export function createAgentSession(input: {
-  title?: unknown;
-  currentImage?: AgentImageInput | null;
-  webSearchEnabled?: boolean;
-} = {}) {
-  const db = getDb();
-  const id = `as_${ulid()}`;
-  const t = now();
-  const generationSettings = {
-    ...DEFAULT_AGENT_GENERATION_SETTINGS,
-    webSearchEnabled: input.webSearchEnabled !== false,
-  };
-  db.prepare(`
-    INSERT INTO agent_sessions
-      (id, title, codex_thread_id, web_search_enabled, generation_settings, created_at, updated_at)
-    VALUES (?, ?, ?, ?, ?, ?, ?)
-  `).run(
-    id,
-    cleanString(input.title, "New Agent"),
-    `codex_${ulid()}`,
-    input.webSearchEnabled === false ? 0 : 1,
-    JSON.stringify(generationSettings),
-    t,
-    t,
-  );
-  if (input.currentImage) importAgentImage(id, input.currentImage);
-  return getAgentSession(id)!;
-}
-
-export function renameAgentSession(id: string, title: unknown) {
-  const cleanTitle = cleanString(title, "New Agent");
-  const res = getDb()
-    .prepare("UPDATE agent_sessions SET title = ?, updated_at = ? WHERE id = ?")
-    .run(cleanTitle, now(), id);
-  return res.changes > 0;
-}
-
-export function setAgentWebSearch(id: string, enabled: boolean) {
-  const current = getAgentSession(id)?.generationSettings ?? DEFAULT_AGENT_GENERATION_SETTINGS;
-  const next = { ...current, webSearchEnabled: enabled };
-  const res = getDb()
-    .prepare("UPDATE agent_sessions SET web_search_enabled = ?, generation_settings = ?, updated_at = ? WHERE id = ?")
-    .run(enabled ? 1 : 0, JSON.stringify(next), now(), id);
-  return res.changes > 0;
-}
-
-export function setAgentGenerationSettings(id: string, patch: unknown) {
-  const current = getAgentSession(id)?.generationSettings ?? DEFAULT_AGENT_GENERATION_SETTINGS;
-  const next = mergeAgentGenerationSettings(current, patch);
-  const res = getDb()
-    .prepare("UPDATE agent_sessions SET generation_settings = ?, web_search_enabled = ?, updated_at = ? WHERE id = ?")
-    .run(JSON.stringify(next), next.webSearchEnabled ? 1 : 0, now(), id);
-  return res.changes > 0;
-}
-
-export function getAgentGenerationSettings(id: string): AgentGenerationSettings {
-  return getAgentSession(id)?.generationSettings ?? DEFAULT_AGENT_GENERATION_SETTINGS;
-}
-
-export function setAgentLocks(id: string, locks: { styleLocks?: unknown; subjectLocks?: unknown }) {
-  const res = getDb().prepare(`
-    UPDATE agent_sessions
-    SET style_locks = COALESCE(?, style_locks),
-        subject_locks = COALESCE(?, subject_locks),
-        updated_at = ?
-    WHERE id = ?
-  `).run(
-    Array.isArray(locks.styleLocks) ? JSON.stringify(cleanStringArray(locks.styleLocks)) : null,
-    Array.isArray(locks.subjectLocks) ? JSON.stringify(cleanStringArray(locks.subjectLocks)) : null,
-    now(),
-    id,
-  );
-  return res.changes > 0;
-}
-
-export function setAgentCurrentImage(sessionId: string, imageIdValue: unknown) {
-  const imageId = cleanString(imageIdValue);
-  if (!imageId) return false;
-  const image = getDb()
-    .prepare("SELECT id FROM agent_images WHERE session_id = ? AND id = ?")
-    .get(sessionId, imageId) as { id: string } | undefined;
-  if (!image) return false;
-  const res = getDb()
-    .prepare("UPDATE agent_sessions SET current_image_id = ?, updated_at = ? WHERE id = ?")
-    .run(imageId, now(), sessionId);
-  return res.changes > 0;
-}
-
-export function deleteAgentSession(id: string) {
-  const res = getDb().prepare("DELETE FROM agent_sessions WHERE id = ?").run(id);
-  return res.changes > 0;
-}
-
-export function appendAgentTurn(input: {
-  sessionId: string;
-  role: AgentTurnRole;
-  text?: string;
-  status?: AgentTurnStatus;
-  imageIds?: string[];
-  webFindingIds?: string[];
-  raw?: unknown;
-}) {
-  const id = `at_${ulid()}`;
-  const t = now();
-  getDb().prepare(`
-    INSERT INTO agent_turns
-      (id, session_id, role, text, status, image_ids, web_finding_ids, raw, created_at)
-    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
-  `).run(
-    id,
-    input.sessionId,
-    input.role,
-    cleanString(input.text, ""),
-    input.status ?? "complete",
-    jsonStringArray(input.imageIds),
-    jsonStringArray(input.webFindingIds),
-    JSON.stringify(input.raw ?? {}),
-    t,
-  );
-  touchAgentSession(input.sessionId, { lastTurnId: id });
-  return getAgentTurns(input.sessionId).find((turn) => turn.id === id)!;
-}
-
-export function getAgentTurns(sessionId: string) {
-  const rows = getDb().prepare(`
-    SELECT
-      id,
-      role,
-      text,
-	      status,
-	      image_ids AS imageIds,
-	      web_finding_ids AS webFindingIds,
-	      raw,
-	      created_at AS createdAt
-    FROM agent_turns
-    WHERE session_id = ?
-    ORDER BY created_at ASC
-  `).all(sessionId) as AgentTurnRow[];
-  return rows.map(turnFromRow);
-}
-
-export function importAgentImage(sessionId: string, input: AgentImageInput) {
-  const id = cleanString(input.id, `ai_${ulid()}`);
-  const filename = cleanString(input.filename, `${id}.png`);
-  const url = cleanString(input.url, `/generated/${filename}`);
-  const t = typeof input.createdAt === "number" ? input.createdAt : now();
-  getDb().prepare(`
-    INSERT OR REPLACE INTO agent_images
-      (id, session_id, filename, url, thumb_url, prompt, revised_prompt, width, height, created_at)
-    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-  `).run(
-    id,
-    sessionId,
-    filename,
-    url,
-    input.thumbUrl ?? null,
-    input.prompt ?? null,
-    input.revisedPrompt ?? null,
-    input.width ?? null,
-    input.height ?? null,
-    t,
-  );
-  touchAgentSession(sessionId, { currentImageId: id });
-  return getAgentImages(sessionId).find((image) => image.id === id)!;
-}
-
-export function getAgentImages(sessionId: string) {
-  const rows = getDb().prepare(`
-    SELECT
-      id,
-      filename,
-      url,
-      thumb_url AS thumbUrl,
-      prompt,
-      revised_prompt AS revisedPrompt,
-      width,
-      height,
-      created_at AS createdAt
-    FROM agent_images
-    WHERE session_id = ?
-    ORDER BY created_at ASC
-  `).all(sessionId) as AgentImageRow[];
-  return rows.map(imageFromRow);
-}
-
-export function recordAgentWebFinding(input: {
-  sessionId: string;
-  query: string;
-  url?: string | null;
-  title?: string | null;
-  snippet?: string | null;
-}) {
-  const id = `aw_${ulid()}`;
-  getDb().prepare(`
-    INSERT INTO agent_web_findings
-      (id, session_id, query, url, title, snippet, created_at)
-    VALUES (?, ?, ?, ?, ?, ?, ?)
-  `).run(id, input.sessionId, input.query, input.url ?? null, input.title ?? null, input.snippet ?? null, now());
-  return id;
-}
-
-export function getAgentWorkspacePayload(selectedSessionId?: string | null): AgentWorkspacePayload {
-  const sessions = listAgentSessions();
-  const selected = selectedSessionId && sessions.some((item) => item.id === selectedSessionId)
-    ? selectedSessionId
-    : sessions[0]?.id ?? null;
-  const turnsBySession: Record<string, AgentTurn[]> = {};
-  const imagesById: Record<string, AgentImageHandle> = {};
-  const imageIdsBySession: Record<string, string[]> = {};
-	  for (const session of sessions) {
-    turnsBySession[session.id] = getAgentTurns(session.id);
-    const images = getAgentImages(session.id);
-    imageIdsBySession[session.id] = images.map((image) => image.id);
-    for (const image of images) imagesById[image.id] = image;
-	  }
-	  const currentImageId = selected ? getCurrentImageId(selected) : null;
-	  const queueProjection = getAgentQueueProjection(sessions.map((session) => session.id));
-	  return {
-	    sessions,
-	    turnsBySession,
-	    imagesById,
-	    imageIdsBySession,
-	    selectedSessionId: selected,
-	    currentImageId,
-	    allowedTools: AGENT_ALLOWED_TOOLS,
-	    manifest: selected ? buildImageContextManifest(selected) : null,
-	    queueBySession: queueProjection.queueBySession,
-	    runSummaryBySession: queueProjection.runSummaryBySession,
-	  };
-}
-
-export function buildImageContextManifest(sessionId: string) {
-  const session = getAgentSession(sessionId);
-  if (!session) return "";
-  const image = session.lastImageId
-    ? getAgentImages(sessionId).find((item) => item.id === session.lastImageId)
-    : null;
-  const findings = getAgentWebFindings(sessionId);
-  const references = getAgentReferences(sessionId);
-  const locks = getAgentLocks(sessionId);
-  return [
-    "<ima2-image-context>",
-    `sessionId: ${session.id}`,
-    `codexThreadId: ${session.codexThreadId ?? ""}`,
-    `compactStatus: ${session.compacted ? "compacted" : "live"}`,
-    "currentImage:",
-    `  id: ${image?.id ?? ""}`,
-    `  path: ${image?.filename ?? ""}`,
-    `  prompt: ${image?.prompt ?? ""}`,
-    `  revisedPrompt: ${image?.revisedPrompt ?? ""}`,
-    "styleLocks:",
-    ...locks.styleLocks.map((lock) => `  - ${lock}`),
-    "subjectLocks:",
-    ...locks.subjectLocks.map((lock) => `  - ${lock}`),
-    "references:",
-    ...references.map((ref) => `  - id: ${ref.id}\n    role: ${ref.role}\n    imageId: ${ref.imageId ?? ""}\n    url: ${ref.url ?? ""}`),
-    "webFindings:",
-    ...findings.map((finding) => `  - query: ${finding.query}\n    url: ${finding.url ?? ""}\n    snippet: ${finding.snippet ?? ""}`),
-    "constraints:",
-    "  - final user-visible output must be an image",
-    `  - allowed tools: ${AGENT_ALLOWED_TOOLS.join(", ")}`,
-    "</ima2-image-context>",
-  ].join("\n");
-}
-
-export function compactAgentSession(sessionId: string) {
-  getDb()
-    .prepare("UPDATE agent_sessions SET compacted = 1, updated_at = ? WHERE id = ?")
-    .run(now(), sessionId);
-  appendAgentTurn({
-    sessionId,
-    role: "assistant",
-    text: "Image context compacted and manifest retained for resume.",
-    status: "complete",
-  });
-}
-
-export function restartAgentRuntimeSession(sessionId: string, reason: string) {
-  const nextThreadId = `codex_${ulid()}`;
-  getDb().prepare(`
-    UPDATE agent_sessions
-    SET codex_thread_id = ?,
-        compacted = 0,
-        updated_at = ?
-    WHERE id = ?
-  `).run(nextThreadId, now(), sessionId);
-  appendAgentTurn({
-    sessionId,
-    role: "tool",
-    text: `Codex runtime restarted: ${reason}`,
-    status: "error",
-  });
-  return nextThreadId;
-}
-
-export function touchAgentSession(sessionId: string, fields: { lastTurnId?: string; currentImageId?: string } = {}) {
-  getDb().prepare(`
-    UPDATE agent_sessions
-    SET last_turn_id = COALESCE(?, last_turn_id),
-        current_image_id = COALESCE(?, current_image_id),
-        updated_at = ?
-    WHERE id = ?
-  `).run(fields.lastTurnId ?? null, fields.currentImageId ?? null, now(), sessionId);
-}
-
-function getCurrentImageId(sessionId: string) {
-  const row = getDb()
-    .prepare("SELECT current_image_id AS currentImageId FROM agent_sessions WHERE id = ?")
-    .get(sessionId) as { currentImageId?: string | null } | undefined;
-  return row?.currentImageId ?? null;
-}
-
-function getAgentWebFindings(sessionId: string) {
-  return getDb().prepare(`
-    SELECT id, query, url, title, snippet
-    FROM agent_web_findings
-    WHERE session_id = ?
-    ORDER BY created_at ASC
-  `).all(sessionId) as FindingRow[];
-}
-
-function getAgentReferences(sessionId: string) {
-  return getDb().prepare(`
-    SELECT
-      id,
-      role,
-      image_id AS imageId,
-      filename,
-      url,
-      prompt
-    FROM agent_references
-    WHERE session_id = ?
-    ORDER BY created_at ASC
-  `).all(sessionId) as ReferenceRow[];
-}
-
-function getAgentLocks(sessionId: string) {
-  const row = getDb()
-    .prepare("SELECT style_locks AS styleLocks, subject_locks AS subjectLocks FROM agent_sessions WHERE id = ?")
-    .get(sessionId) as LockRow | undefined;
-  return {
-    styleLocks: parseStringArray(row?.styleLocks ?? "[]"),
-    subjectLocks: parseStringArray(row?.subjectLocks ?? "[]"),
-  };
-}

package/lib/agentStoreRows.ts

@@ -1,136 +0,0 @@
-import {
-  DEFAULT_AGENT_GENERATION_SETTINGS,
-  normalizeAgentGenerationSettings,
-} from "./agentSettings.js";
-import type {
-  AgentImageHandle,
-  AgentSessionSummary,
-  AgentToolCallSummary,
-  AgentTurn,
-  AgentTurnRole,
-  AgentTurnStatus,
-} from "./agentTypes.js";
-
-export type AgentSessionRow = {
-  id: string;
-  title: string;
-  codexThreadId: string | null;
-  lastTurnId: string | null;
-  currentImageId: string | null;
-  compacted: number;
-  webSearchEnabled: number;
-  generationSettings: string;
-  updatedAt: number;
-  imageCount: number;
-};
-
-export type AgentTurnRow = {
-  id: string;
-  role: AgentTurnRole;
-  text: string;
-  status: AgentTurnStatus;
-  imageIds: string;
-  webFindingIds: string;
-  raw: string;
-  createdAt: number;
-};
-
-export type AgentImageRow = {
-  id: string;
-  filename: string;
-  url: string;
-  thumbUrl: string | null;
-  prompt: string | null;
-  revisedPrompt: string | null;
-  width: number | null;
-  height: number | null;
-  createdAt: number;
-};
-
-export function cleanString(value: unknown, fallback = "") {
-  if (typeof value !== "string") return fallback;
-  return value.trim().slice(0, 10_000) || fallback;
-}
-
-export function parseStringArray(value: string) {
-  try {
-    const parsed = JSON.parse(value);
-    return Array.isArray(parsed) ? parsed.filter((item) => typeof item === "string") : [];
-  } catch {
-    return [];
-  }
-}
-
-export function parseJsonObject(value: string): Record<string, unknown> {
-  try {
-    const parsed = JSON.parse(value);
-    return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed as Record<string, unknown> : {};
-  } catch {
-    return {};
-  }
-}
-
-export function parseToolCalls(raw: string): AgentToolCallSummary[] | undefined {
-  const toolCalls = parseJsonObject(raw).toolCalls;
-  if (!Array.isArray(toolCalls)) return undefined;
-  return toolCalls.filter((item): item is AgentToolCallSummary => (
-    item &&
-    typeof item === "object" &&
-    typeof (item as { id?: unknown }).id === "string" &&
-    typeof (item as { name?: unknown }).name === "string"
-  ));
-}
-
-export function jsonStringArray(values: readonly string[] | undefined) {
-  return JSON.stringify(Array.isArray(values) ? values.filter(Boolean) : []);
-}
-
-export function cleanStringArray(values: unknown) {
-  if (!Array.isArray(values)) return [];
-  return values.filter((value) => typeof value === "string" && value.trim()).map((value) => value.trim());
-}
-
-export function sessionFromRow(row: AgentSessionRow): AgentSessionSummary {
-  return {
-    id: row.id,
-    title: row.title,
-    codexThreadId: row.codexThreadId,
-    lastTurnId: row.lastTurnId,
-    lastImageId: row.currentImageId,
-    imageCount: row.imageCount,
-    compacted: row.compacted === 1,
-    webSearchEnabled: row.webSearchEnabled === 1,
-    generationSettings: normalizeAgentGenerationSettings(
-      parseJsonObject(row.generationSettings),
-      { ...DEFAULT_AGENT_GENERATION_SETTINGS, webSearchEnabled: row.webSearchEnabled === 1 },
-    ),
-    updatedAt: row.updatedAt,
-  };
-}
-
-export function turnFromRow(row: AgentTurnRow): AgentTurn {
-  return {
-    id: row.id,
-    role: row.role,
-    text: row.text,
-    status: row.status,
-    imageIds: parseStringArray(row.imageIds),
-    webFindingIds: parseStringArray(row.webFindingIds),
-    toolCalls: parseToolCalls(row.raw),
-    createdAt: row.createdAt,
-  };
-}
-
-export function imageFromRow(row: AgentImageRow): AgentImageHandle {
-  return {
-    id: row.id,
-    filename: row.filename,
-    url: row.url,
-    thumbUrl: row.thumbUrl,
-    prompt: row.prompt,
-    revisedPrompt: row.revisedPrompt,
-    width: row.width,
-    height: row.height,
-    createdAt: row.createdAt,
-  };
-}

package/lib/agentTypes.ts

@@ -1,154 +0,0 @@
-export const AGENT_ALLOWED_TOOLS = [
-  "ima2.get_image_context",
-  "ima2.web_search",
-  "ima2.generate_image",
-  "ima2.generate_video",
-] as const;
-
-export type AgentToolName = typeof AGENT_ALLOWED_TOOLS[number];
-export type AgentTurnRole = "user" | "assistant" | "tool";
-export type AgentTurnStatus = "streaming" | "complete" | "error";
-export type AgentToolCallStatus = "queued" | "running" | "complete" | "error";
-export type AgentQueueStatus = "queued" | "running" | "succeeded" | "failed" | "canceled";
-export type AgentSessionRunStatus = "idle" | "queued" | "running" | "error";
-export type AgentGenerationStrategy = "auto" | "manual";
-export type AgentGenerationPlanMode = "single" | "fanout" | "question" | "video";
-export type AgentGenerationPlanSource = "auto-default" | "auto-request" | "manual-settings" | "slash-command" | "question-command";
-export type AgentSlashCommandName = "question" | "help" | "variants" | "generate" | "parallelism";
-
-export interface AgentGenerationSettings {
-  provider: "oauth" | "api" | "grok";
-  model: string;
-  quality: "low" | "medium" | "high";
-  size: string;
-  format: "png" | "jpeg" | "webp";
-  moderation: "auto" | "low";
-  reasoningEffort: "low" | "medium" | "high" | "xhigh";
-  webSearchEnabled: boolean;
-  generationStrategy: AgentGenerationStrategy;
-  variants: number;
-  maxAutoVariants: number;
-  parallelism: number;
-}
-
-export interface AgentSlashCommand {
-  name: AgentSlashCommandName;
-  rawName: string;
-  raw: string;
-  prompt: string;
-  value?: number;
-}
-
-export interface AgentToolCallSummary {
-  id: string;
-  name: AgentToolName;
-  status: AgentToolCallStatus;
-  startedAt?: number | null;
-  finishedAt?: number | null;
-  durationMs?: number | null;
-  requestId?: string | null;
-  inputSummary?: string | null;
-  outputSummary?: string | null;
-  imageIds?: string[];
-  webFindingIds?: string[];
-  errorCode?: string | null;
-  errorMessage?: string | null;
-}
-
-export interface AgentQueueItem {
-  id: string;
-  sessionId: string;
-  requestId: string;
-  prompt: string;
-  status: AgentQueueStatus;
-  position: number;
-  resultImageIds: string[];
-  errorCode?: string | null;
-  errorMessage?: string | null;
-  createdAt: number;
-  startedAt?: number | null;
-  finishedAt?: number | null;
-  options: AgentGenerationSettings;
-  plan: AgentGenerationPlan;
-}
-
-export interface AgentGenerationPlan {
-  mode: AgentGenerationPlanMode;
-  prompts: string[];
-  requestedVariants: number;
-  plannedVariants: number;
-  plannedParallelism: number;
-  source: AgentGenerationPlanSource;
-  reason: string;
-  command?: AgentSlashCommandName | null;
-  assistantText?: string | null;
-}
-
-export interface AgentSessionRunSummary {
-  status: AgentSessionRunStatus;
-  queuedCount: number;
-  runningCount: number;
-  lastQueueItemId?: string | null;
-  lastError?: string | null;
-}
-
-export interface AgentImageInput {
-  id?: string | null;
-  filename?: string | null;
-  url?: string | null;
-  thumbUrl?: string | null;
-  prompt?: string | null;
-  revisedPrompt?: string | null;
-  createdAt?: number | null;
-  width?: number | null;
-  height?: number | null;
-}
-
-export interface AgentImageHandle {
-  id: string;
-  filename: string;
-  url: string;
-  thumbUrl?: string | null;
-  prompt?: string | null;
-  revisedPrompt?: string | null;
-  createdAt: number;
-  width?: number | null;
-  height?: number | null;
-}
-
-export interface AgentSessionSummary {
-  id: string;
-  title: string;
-  codexThreadId: string | null;
-  lastTurnId: string | null;
-  lastImageId: string | null;
-  imageCount: number;
-  compacted: boolean;
-  webSearchEnabled: boolean;
-  generationSettings: AgentGenerationSettings;
-  updatedAt: number;
-}
-
-export interface AgentTurn {
-  id: string;
-  role: AgentTurnRole;
-  text: string;
-  imageIds: string[];
-  webFindingIds: string[];
-  status: AgentTurnStatus;
-  toolCalls?: AgentToolCallSummary[];
-  createdAt: number;
-}
-
-export interface AgentWorkspacePayload {
-  sessions: AgentSessionSummary[];
-  turnsBySession: Record<string, AgentTurn[]>;
-  imagesById: Record<string, AgentImageHandle>;
-  imageIdsBySession: Record<string, string[]>;
-  selectedSessionId: string | null;
-  currentImageId: string | null;
-  allowedTools: readonly AgentToolName[];
-  manifest: string | null;
-  queueBySession: Record<string, AgentQueueItem[]>;
-  runSummaryBySession: Record<string, AgentSessionRunSummary>;
-}