bopodev-api 0.1.31 → 0.1.32

package/src/services/company-assistant-cli.ts

@@ -0,0 +1,388 @@
+import { mkdir } from "node:fs/promises";
+import type { BopoDb } from "bopodev-db";
+import {
+  executeAgentRuntime,
+  executePromptRuntime,
+  ensureOpenCodeModelConfiguredAndAvailable,
+  hasTrustFlag,
+  resolveCursorLaunchConfig,
+  type AgentRuntimeConfig,
+  type RuntimeExecutionOutput
+} from "bopodev-agent-sdk";
+import {
+  normalizeRuntimeConfig,
+  resolveDefaultRuntimeModelForProvider,
+  requiresRuntimeCwd
+} from "../lib/agent-config";
+import { resolveDefaultRuntimeCwdForCompany } from "../lib/workspace-policy";
+import { buildCompanyAssistantContextSnapshot } from "./company-assistant-context-snapshot";
+import type { AskCliBrainId } from "./company-assistant-brain";
+
+const MAX_EXTRACTED_CLI_CHARS = 60_000;
+
+function codexStdoutLooksLikeNdjsonStream(stdout: string): boolean {
+  const lines = stdout.split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
+  if (lines.length === 0) {
+    return false;
+  }
+  let jsonLines = 0;
+  for (const line of lines) {
+    if (!line.startsWith("{")) {
+      return false;
+    }
+    try {
+      JSON.parse(line);
+      jsonLines++;
+    } catch {
+      return false;
+    }
+  }
+  return jsonLines > 0;
+}
+
+/**
+ * Codex `--json` / stream-json stdout is newline-delimited JSON events.
+ * Prefer the last completed assistant-facing item; never treat `turn.completed` metadata as the reply if it looks like JSON.
+ */
+function extractCodexStreamAssistantText(stdout: string): string | null {
+  let lastMessage: string | null = null;
+  let lastTurnResult: string | null = null;
+  for (const rawLine of stdout.split(/\r?\n/)) {
+    const line = rawLine.trim();
+    if (!line.startsWith("{")) {
+      continue;
+    }
+    let parsed: unknown;
+    try {
+      parsed = JSON.parse(line) as unknown;
+    } catch {
+      continue;
+    }
+    if (!parsed || typeof parsed !== "object") {
+      continue;
+    }
+    const rec = parsed as Record<string, unknown>;
+    const type = typeof rec.type === "string" ? rec.type : "";
+    if (type === "item.completed") {
+      const item = rec.item;
+      if (!item || typeof item !== "object") {
+        continue;
+      }
+      const ir = item as Record<string, unknown>;
+      const itemType = typeof ir.type === "string" ? ir.type.toLowerCase() : "";
+      if (
+        itemType === "tool_use" ||
+        itemType === "tool_result" ||
+        itemType === "command_execution" ||
+        itemType === "reasoning"
+      ) {
+        continue;
+      }
+      if (itemType === "agent_message" || itemType === "agentmessage" || itemType === "message") {
+        const text = extractCodexAgentMessageItemText(ir);
+        if (text) {
+          lastMessage = text;
+        }
+      }
+      continue;
+    }
+    if (type === "turn.completed") {
+      const result = typeof rec.result === "string" ? rec.result.trim() : "";
+      if (result && !result.startsWith("{") && !result.startsWith("[")) {
+        lastTurnResult = result;
+      }
+    }
+  }
+  const chosen = lastMessage ?? lastTurnResult;
+  if (!chosen) {
+    return null;
+  }
+  return chosen.length > MAX_EXTRACTED_CLI_CHARS ? `${chosen.slice(0, MAX_EXTRACTED_CLI_CHARS)}\n…(truncated)` : chosen;
+}
+
+function extractCodexAgentMessageItemText(item: Record<string, unknown>): string {
+  if (typeof item.text === "string" && item.text.trim()) {
+    return item.text.trim();
+  }
+  if (typeof item.message === "string" && item.message.trim()) {
+    return item.message.trim();
+  }
+  const content = item.content;
+  if (Array.isArray(content)) {
+    const parts = content.map((c) => {
+      if (typeof c === "string") {
+        return c;
+      }
+      if (c && typeof c === "object" && !Array.isArray(c)) {
+        const o = c as Record<string, unknown>;
+        if (typeof o.text === "string") {
+          return o.text;
+        }
+      }
+      return "";
+    });
+    const joined = parts.join("").trim();
+    if (joined) {
+      return joined;
+    }
+  }
+  return "";
+}
+
+function extractAssistantBodyFromRuntime(out: RuntimeExecutionOutput, providerType: AskCliBrainId): string {
+  const comment = out.finalRunOutput?.employee_comment?.trim();
+  if (comment) {
+    return comment;
+  }
+  // Codex NDJSON: prefer last agent_message over parsedUsage (often token / turn metadata, not the reply).
+  if (providerType === "codex") {
+    const fromStream = extractCodexStreamAssistantText(out.stdout ?? "");
+    if (fromStream) {
+      return fromStream;
+    }
+    if (codexStdoutLooksLikeNdjsonStream(out.stdout ?? "")) {
+      return [
+        "I ran Codex but only got internal stream events back—no final message to show you.",
+        "",
+        "Try asking again in one short sentence, pick another brain (e.g. Claude Code or Cursor), or run `codex login` / update the CLI if you expect Codex to reply here."
+      ].join("\n");
+    }
+  }
+  const summary = out.parsedUsage?.summary?.trim();
+  if (summary) {
+    return summary;
+  }
+  const stdout = out.stdout?.trim();
+  if (stdout) {
+    return stdout.length > MAX_EXTRACTED_CLI_CHARS
+      ? `${stdout.slice(0, MAX_EXTRACTED_CLI_CHARS)}\n…(truncated)`
+      : stdout;
+  }
+  if (!out.ok) {
+    const err = out.stderr?.trim() || out.failureType || "runtime error";
+    return `Assistant runtime failed (${out.failureType ?? "error"}, exit ${out.code ?? "?"}): ${err.slice(0, 4000)}`;
+  }
+  return "No output from assistant runtime.";
+}
+
+function usageFromAssistantRuntime(out: RuntimeExecutionOutput): {
+  tokenInput: number;
+  tokenOutput: number;
+  usdCost: number;
+} {
+  const u = out.parsedUsage;
+  return {
+    tokenInput: Math.max(0, Math.floor(Number(u?.tokenInput ?? 0) || 0)),
+    tokenOutput: Math.max(0, Math.floor(Number(u?.tokenOutput ?? 0) || 0)),
+    usdCost: Math.max(0, Number(u?.usdCost ?? 0) || 0)
+  };
+}
+
+function finishOwnerCliTurn(runtime: RuntimeExecutionOutput, providerType: AskCliBrainId, startedMs: number) {
+  const usage = usageFromAssistantRuntime(runtime);
+  return {
+    assistantBody: extractAssistantBodyFromRuntime(runtime, providerType),
+    provider: providerType,
+    elapsedMs: Date.now() - startedMs,
+    tokenInput: usage.tokenInput,
+    tokenOutput: usage.tokenOutput,
+    usdCost: usage.usdCost
+  };
+}
+
+function buildOwnerCliInstructions(ceoDisplayName: string) {
+  return [
+    `You are **${ceoDisplayName}**, the company's CEO in Bopo. The owner/operator is chatting with you in Chat—reply like a real person: short paragraphs, plain language, warm and direct. Use contractions when they sound natural.`,
+    "**Answer only what they asked.** Do not volunteer status briefings or extra metrics from the snapshot—agent state, approvals, spend, tokens, runs, issue lists, etc.—unless the question clearly calls for it. Greetings (“hi”, “hello”) get a short friendly reply and an offer to help; **do not** recite costs, idle agents, or operational summaries.",
+    "When you **do** need facts, use ONLY the JSON snapshot below (issues, goals, agents, memory, approvals, runs, **costAndUsage**). For spend/tokens: **`monthToDateUtc`** is the full UTC calendar month to date (exact DB sum); **`allTime`** is lifetime totals; **`recentSample`** is just the newest rows for examples—never treat its `totalsInListedRows` as monthly figures. If something is not in the snapshot, say you do not have it—do not invent data.",
+    "Do **not** paste raw JSON, NDJSON lines, token counts, thread ids, or CLI event logs. Summarize only what answers the question. Use a short bullet list only when comparing several items the user asked about.",
+    "When the runtime expects structured JSON, put your natural-language answer for the operator in employee_comment (or the tool’s primary summary field)."
+  ].join("\n");
+}
+
+function assistantCliTimeoutMs(runtimeTimeoutSec: number): number {
+  if (runtimeTimeoutSec > 0) {
+    return Math.min(30 * 60 * 1000, runtimeTimeoutSec * 1000);
+  }
+  const env = Number(process.env.BOPO_ASSISTANT_CLI_TIMEOUT_MS);
+  if (Number.isFinite(env) && env > 0) {
+    return Math.min(30 * 60 * 1000, Math.max(120_000, env));
+  }
+  return 15 * 60 * 1000;
+}
+
+async function resolveOwnerAssistantNormalizedRuntime(db: BopoDb, companyId: string) {
+  const defaultCwd = await resolveDefaultRuntimeCwdForCompany(db, companyId);
+  await mkdir(defaultCwd, { recursive: true });
+  return normalizeRuntimeConfig({ legacy: {}, defaultRuntimeCwd: defaultCwd });
+}
+
+function ownerAssistantBaseEnv(companyId: string): Record<string, string> {
+  return {
+    BOPODEV_COMPANY_ID: companyId,
+    BOPODEV_ACTOR_TYPE: "human",
+    BOPODEV_ACTOR_ID: "owner_assistant",
+    BOPODEV_ACTOR_COMPANIES: companyId
+  };
+}
+
+async function buildOwnerCliPrompt(
+  db: BopoDb,
+  companyId: string,
+  userMessage: string,
+  ceoDisplayName: string
+) {
+  const snapshot = await buildCompanyAssistantContextSnapshot(db, companyId, userMessage);
+  return [
+    buildOwnerCliInstructions(ceoDisplayName),
+    "",
+    "## Operator question",
+    userMessage,
+    "",
+    "## Company snapshot (JSON)",
+    snapshot
+  ].join("\n");
+}
+
+export async function runCompanyAssistantBrainCliTurn(input: {
+  db: BopoDb;
+  companyId: string;
+  providerType: AskCliBrainId;
+  userMessage: string;
+  ceoDisplayName: string;
+}): Promise<{
+  assistantBody: string;
+  provider: string;
+  elapsedMs: number;
+  tokenInput: number;
+  tokenOutput: number;
+  usdCost: number;
+}> {
+  const { providerType } = input;
+  const n = await resolveOwnerAssistantNormalizedRuntime(input.db, input.companyId);
+  const cwd = n.runtimeCwd?.trim();
+  if (requiresRuntimeCwd(providerType) && !cwd) {
+    throw new Error("Could not resolve a runtime working directory for this company.");
+  }
+  const timeoutMs = assistantCliTimeoutMs(n.runtimeTimeoutSec);
+  const baseEnv = { ...ownerAssistantBaseEnv(input.companyId), ...n.runtimeEnv };
+  const model = n.runtimeModel?.trim() || resolveDefaultRuntimeModelForProvider(providerType) || "";
+
+  const prompt = await buildOwnerCliPrompt(
+    input.db,
+    input.companyId,
+    input.userMessage,
+    input.ceoDisplayName
+  );
+  const started = Date.now();
+
+  if (providerType === "codex" || providerType === "claude_code") {
+    const config: AgentRuntimeConfig = {
+      command: n.runtimeCommand,
+      args: n.runtimeArgs,
+      cwd,
+      timeoutMs,
+      interruptGraceSec: n.interruptGraceSec,
+      retryCount: providerType === "codex" ? 1 : 0,
+      env: baseEnv,
+      model: model || undefined,
+      thinkingEffort: n.runtimeThinkingEffort,
+      bootstrapPrompt: n.bootstrapPrompt,
+      runPolicy: n.runPolicy
+    };
+    const runtime = await executeAgentRuntime(providerType, prompt, config);
+    return finishOwnerCliTurn(runtime, providerType, started);
+  }
+
+  if (providerType === "gemini_cli") {
+    const command = n.runtimeCommand?.trim() || "gemini";
+    const args = ["--output-format", "stream-json", "--approval-mode", "yolo", "--sandbox=none"];
+    if (model) {
+      args.push("--model", model);
+    }
+    args.push(...(n.runtimeArgs ?? []));
+    args.push(prompt);
+    const runtime = await executePromptRuntime(
+      command,
+      prompt,
+      {
+        cwd: cwd!,
+        args,
+        timeoutMs,
+        retryCount: 0,
+        env: baseEnv,
+        model: model || undefined,
+        interruptGraceSec: n.interruptGraceSec
+      },
+      { provider: "gemini_cli" }
+    );
+    return finishOwnerCliTurn(runtime, providerType, started);
+  }
+
+  if (providerType === "opencode") {
+    const resolvedModel = model || resolveDefaultRuntimeModelForProvider("opencode");
+    if (!resolvedModel) {
+      throw new Error("OpenCode requires a model id (provider/model format).");
+    }
+    await ensureOpenCodeModelConfiguredAndAvailable({
+      model: resolvedModel,
+      command: n.runtimeCommand,
+      cwd,
+      env: baseEnv
+    });
+    const cmd = n.runtimeCommand?.trim() || "opencode";
+    const args = ["run", "--format", "json", "--model", resolvedModel, ...(n.runtimeArgs ?? [])];
+    const runtime = await executePromptRuntime(
+      cmd,
+      prompt,
+      {
+        cwd: cwd!,
+        args,
+        timeoutMs,
+        retryCount: 0,
+        env: baseEnv,
+        model: resolvedModel,
+        interruptGraceSec: n.interruptGraceSec
+      },
+      { provider: "opencode" }
+    );
+    return finishOwnerCliTurn(runtime, providerType, started);
+  }
+
+  if (providerType === "cursor") {
+    const cursorLaunch = await resolveCursorLaunchConfig({
+      command: n.runtimeCommand,
+      args: n.runtimeArgs,
+      cwd,
+      env: baseEnv
+    });
+    const c = cwd!;
+    const buildArgs = () => {
+      const baseArgs = [...cursorLaunch.prefixArgs, "-p", "--output-format", "stream-json", "--workspace", c];
+      if (model) {
+        baseArgs.push("--model", model);
+      }
+      if (!hasTrustFlag(n.runtimeArgs ?? [])) {
+        baseArgs.push("--yolo");
+      }
+      return [...baseArgs, ...(n.runtimeArgs ?? [])];
+    };
+    const runtime = await executePromptRuntime(
+      cursorLaunch.command,
+      prompt,
+      {
+        cwd: c,
+        args: buildArgs(),
+        timeoutMs,
+        retryCount: 0,
+        env: baseEnv,
+        model: model || undefined,
+        interruptGraceSec: n.interruptGraceSec
+      },
+      { provider: "cursor" }
+    );
+    return finishOwnerCliTurn(runtime, providerType, started);
+  }
+
+  throw new Error(`CLI assistant not implemented for ${providerType}.`);
+}

package/src/services/company-assistant-context-snapshot.ts

@@ -0,0 +1,287 @@
+import type { BopoDb } from "bopodev-db";
+import {
+  aggregateCompanyCostLedgerAllTime,
+  aggregateCompanyCostLedgerInRange,
+  getCompany,
+  listAgents,
+  listApprovalRequests,
+  listCostEntries,
+  listGoals,
+  listHeartbeatRuns,
+  listIssueGoalIdsBatch,
+  listIssues,
+  listProjects
+} from "bopodev-db";
+import { loadAgentMemoryContext } from "./memory-file-service";
+
+const MAX_SNAPSHOT_CHARS = 96_000;
+
+function parseJsonArray(raw: string | null | undefined): string[] {
+  if (!raw) {
+    return [];
+  }
+  try {
+    const v = JSON.parse(raw) as unknown;
+    return Array.isArray(v) ? v.filter((x): x is string => typeof x === "string") : [];
+  } catch {
+    return [];
+  }
+}
+
+function serializeIssue(row: Record<string, unknown>, goalIds: string[]) {
+  return {
+    id: row.id,
+    projectId: row.projectId,
+    parentIssueId: row.parentIssueId ?? null,
+    loopId: row.loopId ?? null,
+    title: row.title,
+    body: row.body ?? null,
+    status: row.status,
+    priority: row.priority,
+    assigneeAgentId: row.assigneeAgentId ?? null,
+    labels: parseJsonArray(row.labelsJson as string),
+    tags: parseJsonArray(row.tagsJson as string),
+    goalIds,
+    updatedAt: row.updatedAt instanceof Date ? row.updatedAt.toISOString() : String(row.updatedAt)
+  };
+}
+
+const COST_SNAPSHOT_ROW_LIMIT = 60;
+
+function serializeCostRow(row: {
+  id: string;
+  runId: string | null;
+  projectId: string | null;
+  issueId: string | null;
+  agentId: string | null;
+  providerType: string;
+  runtimeModelId: string | null;
+  tokenInput: number;
+  tokenOutput: number;
+  usdCost: string;
+  usdCostStatus: string | null;
+  createdAt: Date;
+}) {
+  return {
+    id: row.id,
+    createdAt: row.createdAt instanceof Date ? row.createdAt.toISOString() : String(row.createdAt),
+    providerType: row.providerType,
+    runtimeModelId: row.runtimeModelId ?? null,
+    agentId: row.agentId ?? null,
+    runId: row.runId ?? null,
+    issueId: row.issueId ?? null,
+    projectId: row.projectId ?? null,
+    tokenInput: row.tokenInput,
+    tokenOutput: row.tokenOutput,
+    usdCost: String(row.usdCost),
+    usdCostStatus: row.usdCostStatus ?? null
+  };
+}
+
+function sumCostRows(
+  rows: Array<{ tokenInput: number; tokenOutput: number; usdCost: string }>
+): { tokenInput: number; tokenOutput: number; usd: number } {
+  let tokenInput = 0;
+  let tokenOutput = 0;
+  let usd = 0;
+  for (const r of rows) {
+    tokenInput += Number(r.tokenInput) || 0;
+    tokenOutput += Number(r.tokenOutput) || 0;
+    usd += Number.parseFloat(String(r.usdCost)) || 0;
+  }
+  return { tokenInput, tokenOutput, usd };
+}
+
+function sanitizeAgentRow(row: Record<string, unknown>) {
+  return {
+    id: row.id,
+    name: row.name,
+    role: row.role,
+    roleKey: row.roleKey ?? null,
+    title: row.title ?? null,
+    capabilities: row.capabilities ?? null,
+    status: row.status,
+    managerAgentId: row.managerAgentId ?? null,
+    providerType: row.providerType,
+    heartbeatCron: row.heartbeatCron,
+    canHireAgents: row.canHireAgents ?? null
+  };
+}
+
+function resolveMemoryAnchorAgentId(
+  agents: Awaited<ReturnType<typeof listAgents>>
+): string | null {
+  const active = agents
+    .filter((a) => a.status !== "terminated")
+    .sort((a, b) => a.name.localeCompare(b.name));
+  return active[0]?.id ?? null;
+}
+
+/**
+ * Read-only JSON bundle for owner-assistant CLI runs.
+ * Memory uses the first non-terminated agent as anchor (company + agent memory roots), or omits agent-only roots when none exist.
+ */
+export async function buildCompanyAssistantContextSnapshot(
+  db: BopoDb,
+  companyId: string,
+  userQueryHint: string
+): Promise<string> {
+  const agents = await listAgents(db, companyId);
+  const memoryAgentId = resolveMemoryAnchorAgentId(agents);
+
+  const company = await getCompany(db, companyId);
+  const projects = await listProjects(db, companyId);
+  const allIssues = await listIssues(db, companyId);
+  const issuesSorted = [...allIssues].sort((a, b) => {
+    const ta = a.updatedAt instanceof Date ? a.updatedAt.getTime() : 0;
+    const tb = b.updatedAt instanceof Date ? b.updatedAt.getTime() : 0;
+    return tb - ta;
+  });
+  let issueLimit = 45;
+  let issuesSlice = issuesSorted.slice(0, issueLimit);
+  let goalMap = await listIssueGoalIdsBatch(
+    db,
+    companyId,
+    issuesSlice.map((r) => r.id)
+  );
+  const goals = await listGoals(db, companyId);
+  const approvals = await listApprovalRequests(db, companyId);
+  const pending = approvals.filter((r) => r.status === "pending").slice(0, 25);
+  const runs = await listHeartbeatRuns(db, companyId, 18);
+  const costRowsRaw = await listCostEntries(db, companyId, COST_SNAPSHOT_ROW_LIMIT);
+  const costRows = costRowsRaw.map((r) =>
+    serializeCostRow({
+      id: r.id,
+      runId: r.runId ?? null,
+      projectId: r.projectId ?? null,
+      issueId: r.issueId ?? null,
+      agentId: r.agentId ?? null,
+      providerType: r.providerType,
+      runtimeModelId: r.runtimeModelId ?? null,
+      tokenInput: r.tokenInput ?? 0,
+      tokenOutput: r.tokenOutput ?? 0,
+      usdCost: String(r.usdCost ?? "0"),
+      usdCostStatus: r.usdCostStatus ?? null,
+      createdAt: r.createdAt instanceof Date ? r.createdAt : new Date(String(r.createdAt))
+    })
+  );
+  const costTotalsRecent = sumCostRows(costRows);
+
+  const monthRef = new Date();
+  const yUtc = monthRef.getUTCFullYear();
+  const mUtc = monthRef.getUTCMonth();
+  const monthStartUtc = new Date(Date.UTC(yUtc, mUtc, 1, 0, 0, 0, 0));
+  const monthEndExclusiveUtc = new Date(Date.UTC(yUtc, mUtc + 1, 1, 0, 0, 0, 0));
+  const [costMonthUtc, costAllTime] = await Promise.all([
+    aggregateCompanyCostLedgerInRange(db, companyId, monthStartUtc, monthEndExclusiveUtc),
+    aggregateCompanyCostLedgerAllTime(db, companyId)
+  ]);
+
+  const memoryContext = memoryAgentId
+    ? await loadAgentMemoryContext({
+        companyId,
+        agentId: memoryAgentId,
+        projectIds: [],
+        queryText: userQueryHint.trim() || undefined
+      })
+    : {
+        memoryRoot: "",
+        tacitNotes: undefined as string | undefined,
+        durableFacts: [] as string[],
+        dailyNotes: [] as string[]
+      };
+
+  const buildPayload = () => ({
+    company: company
+      ? { id: company.id, name: company.name, mission: company.mission ?? null }
+      : { error: "not_found" },
+    projects: projects.map((p) => ({
+      id: p.id,
+      name: p.name,
+      status: p.status,
+      description: p.description ?? null
+    })),
+    issues: issuesSlice.map((r) =>
+      serializeIssue(r as unknown as Record<string, unknown>, goalMap.get(r.id) ?? [])
+    ),
+    goals: goals.map((g) => ({
+      id: g.id,
+      title: g.title,
+      status: g.status,
+      level: g.level,
+      projectId: g.projectId ?? null,
+      description: g.description ?? null
+    })),
+    agents: agents
+      .filter((a) => a.status !== "terminated")
+      .map((a) => sanitizeAgentRow(a as unknown as Record<string, unknown>)),
+    pendingApprovals: pending.map((r) => ({
+      id: r.id,
+      action: r.action,
+      status: r.status,
+      createdAt: r.createdAt instanceof Date ? r.createdAt.toISOString() : String(r.createdAt)
+    })),
+    recentHeartbeatRuns: runs.map((r) => ({
+      id: r.id,
+      agentId: r.agentId,
+      status: r.status,
+      startedAt: r.startedAt instanceof Date ? r.startedAt.toISOString() : String(r.startedAt),
+      finishedAt: r.finishedAt
+        ? r.finishedAt instanceof Date
+          ? r.finishedAt.toISOString()
+          : String(r.finishedAt)
+        : null
+    })),
+    costAndUsage: {
+      note: `monthToDateUtc and allTime are exact sums over cost_ledger in the database. recentEntries (max ${COST_SNAPSHOT_ROW_LIMIT}) is for line-level detail only—do not treat totalsInListedRows as monthly or all-time totals.`,
+      monthToDateUtc: {
+        calendarMonth: `${yUtc}-${String(mUtc + 1).padStart(2, "0")}`,
+        rangeStartUtcInclusive: monthStartUtc.toISOString(),
+        rangeEndUtcExclusive: monthEndExclusiveUtc.toISOString(),
+        ledgerRowCount: costMonthUtc.rowCount,
+        tokenInput: costMonthUtc.tokenInput,
+        tokenOutput: costMonthUtc.tokenOutput,
+        usdTotal: costMonthUtc.usdTotal
+      },
+      allTime: {
+        ledgerRowCount: costAllTime.rowCount,
+        tokenInput: costAllTime.tokenInput,
+        tokenOutput: costAllTime.tokenOutput,
+        usdTotal: costAllTime.usdTotal
+      },
+      recentSample: {
+        rowCount: costRows.length,
+        totalsInListedRows: {
+          usd: costTotalsRecent.usd,
+          tokenInput: costTotalsRecent.tokenInput,
+          tokenOutput: costTotalsRecent.tokenOutput
+        },
+        entries: costRows
+      }
+    },
+    memoryContext: {
+      memoryRoot: memoryContext.memoryRoot,
+      tacitNotes: memoryContext.tacitNotes ?? null,
+      durableFacts: memoryContext.durableFacts ?? [],
+      dailyNotes: memoryContext.dailyNotes ?? []
+    }
+  });
+
+  let payload = buildPayload();
+  let raw = JSON.stringify(payload);
+  while (raw.length > MAX_SNAPSHOT_CHARS && issueLimit > 8) {
+    issueLimit -= 8;
+    issuesSlice = issuesSorted.slice(0, issueLimit);
+    goalMap = await listIssueGoalIdsBatch(
+      db,
+      companyId,
+      issuesSlice.map((r) => r.id)
+    );
+    payload = buildPayload();
+    raw = JSON.stringify(payload);
+  }
+  if (raw.length > MAX_SNAPSHOT_CHARS) {
+    return `${raw.slice(0, MAX_SNAPSHOT_CHARS)}\n…(snapshot truncated)`;
+  }
+  return raw;
+}