farming-code 2.2.29 → 2.2.32

package/backend/acp-transcript.js

@@ -1,512 +0,0 @@
-const crypto = require('crypto');
-const { createTwoFilesPatch, diffLines } = require('diff');
-
-const MAX_RENDERED_DIFF_CHARS = 64 * 1024;
-const MAX_INLINE_TOOL_DETAIL_CHARS = 4 * 1024;
-const MAX_TRANSCRIPT_INLINE_TOOL_DETAIL_CHARS = 64 * 1024;
-const MAX_TRANSCRIPT_MEDIA_BYTES = 25 * 1024 * 1024;
-const MAX_TRANSCRIPT_MEDIA_BASE64_CHARS = Math.ceil(MAX_TRANSCRIPT_MEDIA_BYTES / 3) * 4;
-const MAX_EMBEDDED_RESOURCE_TEXT_CHARS = 4 * 1024;
-const MAX_COLLABORATION_AGENTS = 16;
-const MAX_COLLABORATION_ID_CHARS = 160;
-const MAX_COLLABORATION_PATH_CHARS = 512;
-const MAX_COLLABORATION_MESSAGE_CHARS = 160;
-const TRANSCRIPT_MEDIA_MIME_TYPES = new Set([
-  'audio/aac',
-  'audio/flac',
-  'audio/mp4',
-  'audio/mpeg',
-  'audio/ogg',
-  'audio/wav',
-  'audio/wave',
-  'audio/webm',
-  'audio/x-wav',
-  'image/gif',
-  'image/jpeg',
-  'image/png',
-  'image/webp',
-]);
-
-function diffBlocks(content) {
-  return (Array.isArray(content) ? content : [])
-    .filter(block => block?.type === 'diff' && typeof block.path === 'string' && block.path.trim());
-}
-
-function diffAction(block) {
-  const kind = String(block?._meta?.kind || '').trim().toLowerCase();
-  if (['add', 'added', 'create', 'created'].includes(kind)) return 'Added';
-  if (['delete', 'deleted', 'remove', 'removed'].includes(kind)) return 'Deleted';
-  if (['move', 'moved'].includes(kind)) return 'Moved';
-  if (['rename', 'renamed'].includes(kind)) return 'Renamed';
-  return 'Updated';
-}
-
-function patchLineStats(oldText, newText) {
-  return diffLines(oldText, newText).reduce((stats, part) => {
-    const count = Number(part.count || 0);
-    if (part.added) stats.added += count;
-    if (part.removed) stats.removed += count;
-    return stats;
-  }, { added: 0, removed: 0 });
-}
-
-function patchChanges(content, options = {}) {
-  return diffBlocks(content).map(block => {
-    const path = String(block.path || '').trim();
-    const oldText = block.oldText == null ? '' : String(block.oldText);
-    const newText = block.newText == null ? '' : String(block.newText);
-    const stats = patchLineStats(oldText, newText);
-    return {
-      path,
-      kind: diffAction(block).toLowerCase(),
-      added: stats.added,
-      removed: stats.removed,
-      ...(options.includeDiff === true
-        ? { diff: boundedDiffText(createTwoFilesPatch(path, path, oldText, newText, 'before', 'after', { context: 3 })) }
-        : {}),
-    };
-  });
-}
-
-function patchReviewChanges(content) {
-  return diffBlocks(content).map(block => ({
-    kind: diffAction(block).toLowerCase(),
-    newText: block.newText == null ? '' : String(block.newText),
-    oldText: block.oldText == null ? '' : String(block.oldText),
-    path: String(block.path || '').trim(),
-  }));
-}
-
-function boundedDiffText(value) {
-  const text = String(value || '');
-  if (text.length <= MAX_RENDERED_DIFF_CHARS) return text;
-  return `${text.slice(0, MAX_RENDERED_DIFF_CHARS)}\n\n[Diff detail truncated]`;
-}
-
-function renderedDiffText(block) {
-  const path = String(block.path || '').trim();
-  const oldText = block.oldText == null ? '' : String(block.oldText);
-  const newText = block.newText == null ? '' : String(block.newText);
-  const patch = createTwoFilesPatch(path, path, oldText, newText, 'before', 'after', { context: 3 });
-  return `File: ${path}\n${boundedDiffText(patch)}`.trim();
-}
-
-function jsonText(value) {
-  if (value === undefined || value === null) return '';
-  if (typeof value === 'string') return value;
-  try {
-    return JSON.stringify(value, null, 2);
-  } catch {
-    return String(value);
-  }
-}
-
-function toolContentText(content) {
-  return (Array.isArray(content) ? content : []).map(block => {
-    if (!block || typeof block !== 'object') return '';
-    if (block.type === 'content') {
-      const inner = block.content;
-      if (inner?.type === 'text') return String(inner.text || '');
-      if (inner?.type === 'resource_link') return [inner.name, inner.uri].filter(Boolean).join(' — ');
-      if (inner?.type === 'resource') return jsonText(inner.resource);
-      if (inner?.type === 'image') return `[Image: ${inner.mimeType || 'image'}]`;
-      if (inner?.type === 'audio') return `[Audio: ${inner.mimeType || 'audio'}]`;
-      return jsonText(inner);
-    }
-    if (block.type === 'diff') {
-      return renderedDiffText(block);
-    }
-    if (block.type === 'terminal') {
-      const terminal = block.terminal && typeof block.terminal === 'object' ? block.terminal : null;
-      const status = terminal?.exitStatus
-        ? `Exited ${terminal.exitStatus.exitCode ?? terminal.exitStatus.signal ?? ''}`.trim()
-        : 'Running';
-      const output = String(terminal?.output || '').trim();
-      return [`Terminal: ${block.terminalId || ''} (${status})`.trim(), output].filter(Boolean).join('\n');
-    }
-    if (block.type === 'text') return String(block.text || '');
-    return jsonText(block);
-  }).filter(Boolean).join('\n\n').trim();
-}
-
-function equivalentJsonText(text, value) {
-  const candidate = String(text || '').trim();
-  if (!candidate || value === undefined || value === null) return false;
-  if (candidate === jsonText(value).trim()) return true;
-  try {
-    return JSON.stringify(JSON.parse(candidate)) === JSON.stringify(value);
-  } catch {
-    return false;
-  }
-}
-
-function toolOutputText(entry) {
-  const output = entry.rawOutput;
-  if (
-    String(entry.kind || '').toLowerCase() === 'execute'
-    && output
-    && typeof output === 'object'
-    && !Array.isArray(output)
-  ) {
-    const stdout = typeof output.stdout === 'string' ? output.stdout.trimEnd() : '';
-    const stderr = typeof output.stderr === 'string' ? output.stderr.trimEnd() : '';
-    const sections = [];
-    if (stdout) sections.push(stdout);
-    if (stderr) sections.push(`stderr\n${stderr}`);
-    if (output.interrupted === true) sections.push('Interrupted');
-    if (sections.length > 0) return sections.join('\n\n');
-  }
-  return jsonText(output).trim();
-}
-
-function detailForTool(entry) {
-  const sections = [];
-  const rawInput = jsonText(entry.rawInput).trim();
-  // Terminal blocks have a dedicated, live presentation populated by the ACP
-  // client terminal manager. Rendering the same block through generic detail
-  // text duplicates its output directly below the terminal card.
-  let structuredContent = toolContentText(
-    (Array.isArray(entry.content) ? entry.content : []).filter(block => block?.type !== 'terminal')
-  );
-  const rawOutput = toolOutputText(entry);
-  // Some ACP adapters mirror rawOutput as a text content block. Keep the
-  // canonical output once instead of presenting the same JSON twice.
-  if (equivalentJsonText(structuredContent, entry.rawOutput)) structuredContent = '';
-  const locations = (Array.isArray(entry.locations) ? entry.locations : [])
-    .map(location => {
-      const path = String(location?.path || location?.uri || '');
-      const line = location?.line == null ? '' : `:${location.line}`;
-      return `${path}${line}`;
-    })
-    .filter(Boolean)
-    .join('\n');
-  if (rawInput) sections.push(`Input\n${rawInput}`);
-  if (structuredContent) sections.push(structuredContent);
-  if (rawOutput) sections.push(`Output\n${rawOutput}`);
-  if (locations) sections.push(`Locations\n${locations}`);
-  return sections.join('\n\n');
-}
-
-function transcriptResource(resourceValue) {
-  const resource = resourceValue && typeof resourceValue === 'object' ? resourceValue : {};
-  const text = typeof resource.text === 'string' ? resource.text : '';
-  return {
-    name: resource.name,
-    uri: resource.uri,
-    mimeType: resource.mimeType,
-    ...(text
-      ? {
-          text: text.slice(0, MAX_EMBEDDED_RESOURCE_TEXT_CHARS),
-          ...(text.length > MAX_EMBEDDED_RESOURCE_TEXT_CHARS ? { textTruncated: true } : {}),
-        }
-      : {}),
-  };
-}
-
-function transcriptMediaValue(block) {
-  if (!block || typeof block !== 'object') return null;
-  if (['image', 'audio'].includes(block.type)) return block;
-  if (
-    block.type === 'content'
-    && block.content
-    && typeof block.content === 'object'
-    && ['image', 'audio'].includes(block.content.type)
-  ) {
-    return block.content;
-  }
-  return null;
-}
-
-function validatedTranscriptMedia(block) {
-  const type = String(block?.type || '');
-  const data = typeof block?.data === 'string' ? block.data : '';
-  const mimeType = String(block?.mimeType || '').trim().toLowerCase();
-  if (
-    !['image', 'audio'].includes(type)
-    || !data
-    || data.length > MAX_TRANSCRIPT_MEDIA_BASE64_CHARS
-    || data.length % 4 !== 0
-    || !TRANSCRIPT_MEDIA_MIME_TYPES.has(mimeType)
-    || !/^[a-z0-9+/]*={0,2}$/i.test(data)
-  ) return null;
-  const paddingChars = data.endsWith('==') ? 2 : (data.endsWith('=') ? 1 : 0);
-  const decodedBytes = (data.length / 4) * 3 - paddingChars;
-  if (decodedBytes <= 0 || decodedBytes > MAX_TRANSCRIPT_MEDIA_BYTES) return null;
-  return { data, decodedBytes, mimeType, type };
-}
-
-function transcriptMediaId(block) {
-  const media = validatedTranscriptMedia(block);
-  if (!media) return '';
-  return crypto.createHash('sha256')
-    .update(media.type)
-    .update('\0')
-    .update(media.mimeType)
-    .update('\0')
-    .update(media.data)
-    .digest('hex');
-}
-
-function decodeAcpTranscriptMedia(block) {
-  const media = validatedTranscriptMedia(block);
-  if (!media) return null;
-  const content = Buffer.from(media.data, 'base64');
-  if (content.length !== media.decodedBytes) return null;
-  return {
-    content,
-    mimeType: media.mimeType,
-  };
-}
-
-function compactTranscriptMedia(block, entry, options = {}) {
-  const mediaPathPrefix = String(options.mediaPathPrefix || '').replace(/\/+$/, '');
-  if (!mediaPathPrefix) return JSON.parse(JSON.stringify(block));
-  const hasInlineData = typeof block?.data === 'string' && block.data.length > 0;
-  if (!hasInlineData) return JSON.parse(JSON.stringify(block));
-  const mediaId = transcriptMediaId(block);
-  const projected = { ...block };
-  delete projected.data;
-  if (!mediaId) return projected;
-  projected.url = `${mediaPathPrefix}/${encodeURIComponent(String(entry?.id || ''))}/${mediaId}`;
-  return projected;
-}
-
-function acpTranscriptMedia(entry, requestedMediaId) {
-  const mediaId = String(requestedMediaId || '').trim().toLowerCase();
-  if (!/^[a-f0-9]{64}$/.test(mediaId)) return null;
-  const direct = Array.isArray(entry?.content) ? entry.content : [];
-  const output = entry?.rawOutput && typeof entry.rawOutput === 'object' ? entry.rawOutput : {};
-  const result = output?.result && typeof output.result === 'object' ? output.result : {};
-  const raw = Array.isArray(result.content)
-    ? result.content
-    : (Array.isArray(output.content) ? output.content : []);
-  for (const block of [...direct, ...raw]) {
-    const media = transcriptMediaValue(block);
-    if (!media) continue;
-    if (transcriptMediaId(media) === mediaId) return media;
-  }
-  return null;
-}
-
-function transcriptMediaBlocks(entry, options = {}) {
-  const direct = Array.isArray(entry?.content) ? entry.content : [];
-  const output = entry?.rawOutput && typeof entry.rawOutput === 'object' ? entry.rawOutput : {};
-  const result = output?.result && typeof output.result === 'object' ? output.result : {};
-  const raw = Array.isArray(result.content)
-    ? result.content
-    : (Array.isArray(output.content) ? output.content : []);
-  const blocks = [...direct, ...raw].flatMap(block => {
-    if (!block || typeof block !== 'object') return [];
-    if (block.type === 'terminal') return [{ type: 'terminal', terminalId: String(block.terminalId || '') }];
-    if (['image', 'audio'].includes(block.type)) {
-      return [compactTranscriptMedia(block, entry, options)];
-    }
-    if (block.type === 'resource_link') return [JSON.parse(JSON.stringify(block))];
-    if (block.type === 'resource') {
-      return [{
-        type: 'resource',
-        resource: transcriptResource(block.resource),
-      }];
-    }
-    if (block.type !== 'content' || !block.content || typeof block.content !== 'object') return [];
-    const content = block.content;
-    if (['image', 'audio'].includes(content.type)) {
-      const projected = compactTranscriptMedia(content, entry, options);
-      return [{ type: 'content', content: projected }];
-    }
-    if (content.type === 'resource_link') {
-      return [{ type: 'content', content: JSON.parse(JSON.stringify(content)) }];
-    }
-    if (content.type === 'resource') {
-      return [{
-        type: 'content',
-        content: {
-          type: 'resource',
-          resource: transcriptResource(content.resource),
-        },
-      }];
-    }
-    return [];
-  });
-  const seenTerminals = new Set();
-  return blocks.filter(block => {
-    if (block.type !== 'terminal') return true;
-    if (!block.terminalId || seenTerminals.has(block.terminalId)) return false;
-    seenTerminals.add(block.terminalId);
-    return true;
-  });
-}
-
-function transcriptEntryWithCompactMedia(entry, options = {}) {
-  const mediaPathPrefix = String(options.mediaPathPrefix || '').trim();
-  if (!mediaPathPrefix || !Array.isArray(entry?.content)) return entry;
-  const content = entry.content.map(block => {
-    const media = transcriptMediaValue(block);
-    if (!media) return block;
-    const projected = compactTranscriptMedia(media, entry, options);
-    return block?.type === 'content'
-      ? { ...block, content: projected }
-      : projected;
-  });
-  return { ...entry, content };
-}
-
-function generatedMediaTool(entry) {
-  const title = String(entry?.title || '').trim().toLowerCase();
-  const id = String(entry?.id || '').trim().toLowerCase();
-  const output = entry?.rawOutput && typeof entry.rawOutput === 'object' ? entry.rawOutput : {};
-  return id.startsWith('ig_')
-    || title === 'image generation'
-    || title === 'audio generation'
-    || String(output.savedPath || '').includes('/generated_images/');
-}
-
-function boundedCollaborationString(value, maxChars) {
-  return String(value || '').trim().slice(0, maxChars);
-}
-
-function boundedCollaborationIds(value) {
-  const seen = new Set();
-  return (Array.isArray(value) ? value : []).flatMap(item => {
-    const id = boundedCollaborationString(item, MAX_COLLABORATION_ID_CHARS);
-    if (!id || seen.has(id) || seen.size >= MAX_COLLABORATION_AGENTS) return [];
-    seen.add(id);
-    return [id];
-  });
-}
-
-function transcriptCodexToolMeta(entry) {
-  const codex = entry?._meta?.codex && typeof entry._meta.codex === 'object'
-    ? entry._meta.codex
-    : {};
-  const compact = {};
-  if (codex.collaboration && typeof codex.collaboration === 'object') {
-    const rawInput = entry?.rawInput && typeof entry.rawInput === 'object' && !Array.isArray(entry.rawInput)
-      ? entry.rawInput
-      : {};
-    const receiverThreadIds = boundedCollaborationIds(
-      codex.collaboration.receiverThreadIds || rawInput.receiverThreadIds
-    );
-    const rawStates = rawInput.agentsStates && typeof rawInput.agentsStates === 'object' && !Array.isArray(rawInput.agentsStates)
-      ? rawInput.agentsStates
-      : {};
-    const agentsStates = {};
-    const stateIds = boundedCollaborationIds([...receiverThreadIds, ...Object.keys(rawStates)]);
-    for (const threadId of stateIds) {
-      const state = rawStates[threadId] && typeof rawStates[threadId] === 'object'
-        ? rawStates[threadId]
-        : {};
-      agentsStates[threadId] = {
-        status: boundedCollaborationString(state.status, 32),
-        message: boundedCollaborationString(state.message, MAX_COLLABORATION_MESSAGE_CHARS),
-      };
-    }
-    compact.collaboration = {
-      tool: boundedCollaborationString(codex.collaboration.tool, 48),
-      senderThreadId: boundedCollaborationString(
-        codex.collaboration.senderThreadId || rawInput.senderThreadId,
-        MAX_COLLABORATION_ID_CHARS
-      ),
-      receiverThreadIds,
-      agentsStates,
-    };
-  }
-  if (codex.subagent && typeof codex.subagent === 'object') {
-    compact.subagent = {
-      threadId: boundedCollaborationString(codex.subagent.threadId, MAX_COLLABORATION_ID_CHARS),
-      path: boundedCollaborationString(codex.subagent.path, MAX_COLLABORATION_PATH_CHARS),
-      activity: boundedCollaborationString(codex.subagent.activity, 32),
-    };
-  }
-  return Object.keys(compact).length > 0 ? compact : null;
-}
-
-function acpTranscriptToolEntry(entry, options = {}) {
-  if (!entry || entry.type !== 'tool') return entry;
-  const detail = detailForTool(entry);
-  const requestedInlineDetailChars = Number(options.maxInlineDetailChars);
-  const inlineDetailChars = Number.isFinite(requestedInlineDetailChars)
-    ? Math.max(0, Math.min(MAX_INLINE_TOOL_DETAIL_CHARS, Math.floor(requestedInlineDetailChars)))
-    : MAX_INLINE_TOOL_DETAIL_CHARS;
-  const changes = patchChanges(entry.content).map(change => ({
-    path: change.path,
-    kind: change.kind,
-    added: change.added,
-    removed: change.removed,
-    ...(entry?._meta?.farming_patch_decisions?.[change.path]
-      ? { decision: entry._meta.farming_patch_decisions[change.path] }
-      : {}),
-  }));
-  const patchSummary = diffBlocks(entry.content)
-    .map(block => `${diffAction(block)} ${String(block.path || '').trim()}`)
-    .join('\n');
-  const meta = {};
-  if (entry?._meta?.subagent_session_info) {
-    const sessionId = boundedCollaborationString(
-      entry._meta.subagent_session_info.session_id,
-      MAX_COLLABORATION_ID_CHARS
-    );
-    if (sessionId) meta.subagent_session_info = { session_id: sessionId };
-  }
-  if (entry?._meta?.farming_patch_decisions) {
-    meta.farming_patch_decisions = JSON.parse(JSON.stringify(entry._meta.farming_patch_decisions));
-  }
-  const codexMeta = transcriptCodexToolMeta(entry);
-  if (codexMeta) meta.codex = codexMeta;
-  return {
-    id: String(entry.id || ''),
-    type: 'tool',
-    title: String(entry.title || ''),
-    kind: String(entry.kind || 'other'),
-    status: String(entry.status || ''),
-    content: transcriptMediaBlocks(entry, options),
-    ...(Object.keys(meta).length > 0 ? { _meta: meta } : {}),
-    transcriptDetail: detail.length <= inlineDetailChars
-      ? detail
-      : `${detail.slice(0, inlineDetailChars)}${inlineDetailChars > 0 ? '\n\n' : ''}[Open to load full detail]`,
-    transcriptDetailTruncated: detail.length > inlineDetailChars,
-    transcriptPatchSummary: patchSummary,
-    transcriptChanges: changes,
-    generatedMedia: generatedMediaTool(entry),
-    internal: entry.internal === true,
-  };
-}
-
-function acpTranscriptEntries(entries, options = {}) {
-  const requestedBudget = Number(options.maxInlineToolDetailChars);
-  let remainingInlineDetailChars = Number.isFinite(requestedBudget)
-    ? Math.max(0, Math.floor(requestedBudget))
-    : MAX_TRANSCRIPT_INLINE_TOOL_DETAIL_CHARS;
-  const source = Array.isArray(entries) ? entries : [];
-  const projected = new Array(source.length);
-
-  // The transcript page owns only a bounded summary. Exact tool and subagent
-  // detail remains backend-owned and is loaded on explicit expansion.
-  for (let index = source.length - 1; index >= 0; index -= 1) {
-    const entry = source[index];
-    if (entry?.type !== 'tool') {
-      projected[index] = transcriptEntryWithCompactMedia(entry, options);
-      continue;
-    }
-    const projectedEntry = acpTranscriptToolEntry(entry, {
-      maxInlineDetailChars: remainingInlineDetailChars,
-      mediaPathPrefix: options.mediaPathPrefix,
-    });
-    remainingInlineDetailChars = Math.max(
-      0,
-      remainingInlineDetailChars - String(projectedEntry.transcriptDetail || '').length
-    );
-    projected[index] = projectedEntry;
-  }
-  return projected;
-}
-
-module.exports = {
-  acpTranscriptEntries,
-  acpTranscriptMedia,
-  acpToolChanges: entry => patchChanges(entry?.content, { includeDiff: true }),
-  acpToolDetail: detailForTool,
-  acpToolReviewChanges: entry => patchReviewChanges(entry?.content),
-  acpTranscriptToolEntry,
-  decodeAcpTranscriptMedia,
-};