@shipfox/api-logs 2.0.0

package/src/core/session/pi/message-rows.ts

@@ -0,0 +1,211 @@
+import type {
+  SessionViewRow,
+  SessionViewToolCallRow,
+  SessionViewToolResultRow,
+} from '@shipfox/api-logs-dto';
+import {type AgentMessage, asContentBlocks, type ContentBlock} from '../entry-schema.js';
+import {field, stringField, stringifyValue, toJson} from '../object.js';
+import {messageRow} from '../rows.js';
+import {
+  assistantMeta,
+  bashExecutionMeta,
+  branchSummaryDetail,
+  branchSummaryMeta,
+  compactionDetail,
+  compactionMeta,
+  customEntryLabel,
+  customEntryMeta,
+  customEntryText,
+  messageMeta,
+} from './metadata.js';
+import {
+  bashExecutionText,
+  blockText,
+  isTerminalStop,
+  isThinkingBlock,
+  isToolCallBlock,
+  isToolResultMessage,
+  messageText,
+  normalizeRole,
+  roleLabel,
+  terminalStopDetail,
+} from './text.js';
+
+export function expandMessageEntry(
+  timestamp: number,
+  message: AgentMessage,
+): readonly SessionViewRow[] {
+  const role = normalizeRole(message);
+
+  if (isToolResultMessage(message)) return [toolResultRow(timestamp, message)];
+
+  if (role === 'assistant') return expandAssistantMessage(timestamp, message);
+
+  if (role === 'bash-execution') {
+    return [
+      messageRow(
+        timestamp,
+        role,
+        'bash execution',
+        bashExecutionText(message),
+        isTerminalStop(message),
+        bashExecutionMeta(message),
+      ),
+    ];
+  }
+  if (role === 'branch-summary') {
+    return [
+      messageRow(
+        timestamp,
+        role,
+        'branch summary',
+        branchSummaryDetail(message) ?? toJson(message),
+        isTerminalStop(message),
+        branchSummaryMeta(message),
+      ),
+    ];
+  }
+  if (role === 'compaction-summary') {
+    return [
+      messageRow(
+        timestamp,
+        role,
+        'compaction summary',
+        compactionDetail(message) ?? toJson(message),
+        isTerminalStop(message),
+        compactionMeta(message),
+      ),
+    ];
+  }
+  if (role === 'custom') {
+    return [
+      messageRow(
+        timestamp,
+        role,
+        customEntryLabel('custom'),
+        customEntryText(message) ?? toJson(message),
+        isTerminalStop(message),
+        customEntryMeta(message),
+      ),
+    ];
+  }
+
+  const text = messageText(message);
+  return [
+    messageRow(
+      timestamp,
+      role,
+      roleLabel(role),
+      text || toJson(message),
+      isTerminalStop(message),
+      messageMeta(message),
+    ),
+  ];
+}
+
+function expandAssistantMessage(
+  timestamp: number,
+  message: AgentMessage,
+): readonly SessionViewRow[] {
+  const blocks = asContentBlocks(message.content);
+  const terminalFailure = isTerminalStop(message);
+  const meta = assistantMeta(message);
+  if (blocks.length === 0) {
+    const text = messageText(message);
+    return [
+      messageRow(
+        timestamp,
+        'assistant',
+        'assistant',
+        text || terminalStopDetail(message) || toJson(message),
+        terminalFailure,
+        meta,
+      ),
+    ];
+  }
+
+  const rows: SessionViewRow[] = [];
+  const textParts: string[] = [];
+  const thinkingParts: string[] = [];
+  const pushTextParts = () => {
+    if (textParts.length === 0) return;
+    rows.push(
+      messageRow(
+        timestamp,
+        'assistant',
+        'assistant',
+        textParts.join('\n\n'),
+        terminalFailure,
+        meta,
+      ),
+    );
+    textParts.length = 0;
+  };
+  const pushThinkingParts = () => {
+    if (thinkingParts.length === 0) return;
+    rows.push({kind: 'thinking', timestamp, text: thinkingParts.join('\n\n')});
+    thinkingParts.length = 0;
+  };
+
+  for (const block of blocks) {
+    if (isToolCallBlock(block)) {
+      pushTextParts();
+      pushThinkingParts();
+      rows.push(toolCallRow(timestamp, block));
+      continue;
+    }
+
+    if (isThinkingBlock(block)) {
+      pushTextParts();
+      const text = blockText(block);
+      if (text) thinkingParts.push(text);
+      continue;
+    }
+
+    pushThinkingParts();
+    const text = blockText(block);
+    if (text) textParts.push(text);
+  }
+
+  pushTextParts();
+  pushThinkingParts();
+  if (terminalFailure && !rows.some((row) => row.kind === 'message' && row.terminalFailure)) {
+    rows.push(
+      messageRow(
+        timestamp,
+        'assistant',
+        'assistant',
+        terminalStopDetail(message) || toJson(message),
+        true,
+        meta,
+      ),
+    );
+  }
+  if (rows.length === 0)
+    rows.push(
+      messageRow(timestamp, 'assistant', 'assistant', toJson(message), terminalFailure, meta),
+    );
+
+  return rows;
+}
+
+function toolCallRow(timestamp: number, block: ContentBlock): SessionViewToolCallRow {
+  const id = stringField(block, 'id') ?? stringField(block, 'toolCallId') ?? null;
+  const name = stringField(block, 'name') ?? stringField(block, 'toolName') ?? 'tool';
+  const args = field(block, 'arguments') ?? field(block, 'input') ?? field(block, 'args') ?? {};
+
+  return {kind: 'tool-call', timestamp, id, name, input: stringifyValue(args)};
+}
+
+function toolResultRow(timestamp: number, message: AgentMessage): SessionViewToolResultRow {
+  const output = messageText(message) || stringifyValue(message.content ?? '');
+
+  return {
+    kind: 'tool-result',
+    timestamp,
+    toolCallId: message.toolCallId ?? null,
+    toolName: message.toolName ?? 'tool',
+    output,
+    isError: message.isError === true,
+  };
+}

package/src/core/session/pi/metadata.ts

@@ -0,0 +1,148 @@
+import type {SessionViewRowMeta} from '@shipfox/api-logs-dto';
+import type {AgentMessage, SessionEntry} from '../entry-schema.js';
+import {
+  booleanField,
+  field,
+  formatCount,
+  isMeta,
+  metaItem,
+  numberField,
+  stringField,
+  stringifyValue,
+} from '../object.js';
+import {messageText} from './text.js';
+
+export function sessionDetail(entry: SessionEntry): string | null {
+  const version = numberField(entry, 'version');
+  const id = stringField(entry, 'id') ?? stringField(entry, 'sessionId');
+  const cwd = stringField(entry, 'cwd');
+  return (
+    [version == null ? null : `v${version}`, id, cwd].filter(Boolean).join(' · ') ||
+    entryDetail(entry)
+  );
+}
+
+export function modelChangeDetail(entry: SessionEntry): string | null {
+  const model =
+    stringField(entry, 'model') ?? stringField(entry, 'to') ?? stringField(entry, 'modelId');
+  const provider = stringField(entry, 'provider');
+  return [model, provider].filter(Boolean).join(' · ') || entryDetail(entry);
+}
+
+export function compactionDetail(entry: SessionEntry | AgentMessage): string | null {
+  return stringField(entry, 'summary') ?? stringField(entry, 'message') ?? entryDetail(entry);
+}
+
+export function compactionMeta(entry: SessionEntry | AgentMessage): readonly SessionViewRowMeta[] {
+  const tokensBefore = numberField(entry, 'tokensBefore');
+  return [
+    tokensBefore == null ? null : metaItem('tokens before', formatCount(tokensBefore, 'token')),
+  ].filter(isMeta);
+}
+
+export function branchSummaryDetail(entry: SessionEntry | AgentMessage): string | null {
+  return stringField(entry, 'summary') ?? stringField(entry, 'message') ?? entryDetail(entry);
+}
+
+export function branchSummaryMeta(
+  entry: SessionEntry | AgentMessage,
+): readonly SessionViewRowMeta[] {
+  const fromId = stringField(entry, 'fromId');
+  return [fromId == null ? null : metaItem('from', fromId)].filter(isMeta);
+}
+
+export function customEntryLabel(fallback: string): string {
+  return fallback;
+}
+
+export function customEntryMeta(entry: SessionEntry | AgentMessage): readonly SessionViewRowMeta[] {
+  const display = field(entry, 'display');
+  return [
+    metaItem('type', stringField(entry, 'customType')),
+    typeof display === 'boolean' ? metaItem('display', display ? 'on' : 'off') : null,
+  ].filter(isMeta);
+}
+
+export function customEntryText(entry: SessionEntry | AgentMessage): string | null {
+  const text = messageText(entry);
+  if (text) return text;
+
+  const data = field(entry, 'data') ?? field(entry, 'details');
+  return data === undefined ? entryDetail(entry) : stringifyValue(data);
+}
+
+export function bashExecutionMeta(message: AgentMessage): readonly SessionViewRowMeta[] {
+  const exitCode = field(message, 'exitCode');
+  return [
+    typeof exitCode === 'number' ? metaItem('exit', String(exitCode)) : null,
+    booleanField(message, 'cancelled') ? metaItem('cancelled', 'yes') : null,
+    booleanField(message, 'truncated') ? metaItem('truncated', 'yes') : null,
+    booleanField(message, 'excludeFromContext') ? metaItem('context', 'excluded') : null,
+    metaItem('full output', stringField(message, 'fullOutputPath'), false),
+  ].filter(isMeta);
+}
+
+export function labelDetail(entry: SessionEntry): string | null {
+  return stringField(entry, 'label') ?? entryDetail(entry);
+}
+
+export function labelMeta(entry: SessionEntry): readonly SessionViewRowMeta[] {
+  const targetId = stringField(entry, 'targetId');
+  return [targetId == null ? null : metaItem('target', targetId, false)].filter(isMeta);
+}
+
+export function assistantMeta(message: AgentMessage): readonly SessionViewRowMeta[] {
+  return [
+    providerModelMeta(message),
+    metaItem('api', stringField(message, 'api'), false),
+    usageMeta(message),
+    costMeta(message),
+    stopReasonMeta(message),
+  ].filter(isMeta);
+}
+
+export function messageMeta(message: AgentMessage): readonly SessionViewRowMeta[] {
+  return [stopReasonMeta(message)].filter(isMeta);
+}
+
+function providerModelMeta(message: AgentMessage): SessionViewRowMeta | null {
+  const model = stringField(message, 'model') ?? stringField(message, 'modelId');
+  const provider = stringField(message, 'provider');
+  const value = [provider, model].filter(Boolean).join('/');
+  return value ? metaItem('model', value) : null;
+}
+
+function usageMeta(message: AgentMessage): SessionViewRowMeta | null {
+  const usage = field(message, 'usage');
+  const totalTokens = numberField(usage, 'totalTokens');
+  return totalTokens == null ? null : metaItem('tokens', formatCount(totalTokens, 'token'));
+}
+
+function costMeta(message: AgentMessage): SessionViewRowMeta | null {
+  const usage = field(message, 'usage');
+  const cost = field(usage, 'cost');
+  const total = numberField(cost, 'total');
+  return total == null ? null : metaItem('cost', `$${total.toFixed(total < 0.01 ? 4 : 2)}`);
+}
+
+function stopReasonMeta(message: AgentMessage): SessionViewRowMeta | null {
+  const stopReason = stringField(message, 'stopReason');
+  return stopReason == null ? null : metaItem('stop', stopReason);
+}
+
+export function entryDetail(entry: SessionEntry | AgentMessage): string | null {
+  const detail =
+    stringField(entry, 'message') ??
+    stringField(entry, 'text') ??
+    stringField(entry, 'content') ??
+    stringField(entry, 'summary') ??
+    stringField(entry, 'label') ??
+    stringField(entry, 'thinkingLevel') ??
+    stringField(entry, 'level') ??
+    stringField(entry, 'reason');
+  if (detail) return detail;
+
+  const value = field(entry, 'data') ?? field(entry, 'payload');
+  if (value === undefined) return null;
+  return stringifyValue(value);
+}

package/src/core/session/pi/text.ts

@@ -0,0 +1,83 @@
+import type {AgentMessage, ContentBlock} from '../entry-schema.js';
+import {stringField, toJson} from '../object.js';
+
+const MESSAGE_SUFFIX = /Message$/;
+const CAMEL_CASE_BOUNDARY = /([a-z])([A-Z])/g;
+
+export function normalizeRole(message: AgentMessage): string {
+  const raw = message.role ?? message.type ?? 'message';
+  return raw.replace(MESSAGE_SUFFIX, '').replace(CAMEL_CASE_BOUNDARY, '$1-$2').toLowerCase();
+}
+
+export function roleLabel(role: string): string {
+  if (role === 'user') return 'user';
+  if (role === 'assistant') return 'assistant';
+  return role.replaceAll('-', ' ');
+}
+
+export function isToolResultMessage(message: AgentMessage): boolean {
+  const role = normalizeRole(message);
+  return typeof message.toolCallId === 'string' || role === 'tool' || role === 'tool-result';
+}
+
+export function isToolCallBlock(block: ContentBlock): boolean {
+  const type = stringField(block, 'type');
+  return type === 'toolCall' || type === 'tool_call' || type === 'tool-call';
+}
+
+export function isThinkingBlock(block: ContentBlock): boolean {
+  const type = stringField(block, 'type');
+  return type === 'thinking' || type === 'thought' || type === 'reasoning';
+}
+
+export function blockText(block: ContentBlock): string {
+  if (stringField(block, 'type') === 'image') return imagePlaceholder(block);
+
+  return (
+    stringField(block, 'text') ??
+    stringField(block, 'content') ??
+    stringField(block, 'thinking') ??
+    ''
+  );
+}
+
+export function messageText(message: AgentMessage): string {
+  if (typeof message.content === 'string') return message.content;
+
+  const blocks = Array.isArray(message.content) ? message.content : [];
+  if (blocks.length > 0) {
+    return blocks
+      .map((block) => blockText(block))
+      .filter(Boolean)
+      .join('\n\n');
+  }
+
+  return '';
+}
+
+export function isTerminalStop(message: AgentMessage): boolean {
+  return (
+    message.errorMessage != null ||
+    message.stopReason === 'error' ||
+    message.stopReason === 'aborted'
+  );
+}
+
+export function terminalStopDetail(message: AgentMessage): string | null {
+  if (message.errorMessage) return message.errorMessage;
+  if (message.stopReason === 'error') return 'Assistant stopped with an error.';
+  if (message.stopReason === 'aborted') return 'Assistant run was aborted.';
+  return null;
+}
+
+export function bashExecutionText(message: AgentMessage): string {
+  const command = stringField(message, 'command');
+  const output = stringField(message, 'output');
+
+  return [`$ ${command ?? ''}`.trim(), output].filter(Boolean).join('\n') || toJson(message);
+}
+
+function imagePlaceholder(block: ContentBlock): string {
+  const mimeType = stringField(block, 'mimeType');
+  return mimeType == null ? '[image]' : `[${mimeType} image]`;
+}