@ian-pascoe/pi-codemode 0.2.0 → 0.3.1

package/README.md

@@ -87,12 +87,18 @@ type CodeModeSessionsResult = {
 The execute, result, and cancel tools return:
 
 ```ts
+type CodeModeConsoleEntry = {
+  method: "log" | "info" | "warn" | "error" | "debug";
+  text: string;
+};
+
 type CodeModeResult =
   | {
       result: "success";
       sessionId: string;
       data?: JsonValue;
       reclaimedSessionId?: string;
+      console?: CodeModeConsoleEntry[];
     }
   | { result: "pending"; sessionId: string }
   | {
@@ -112,6 +118,7 @@ type CodeModeResult =
           | "runtime";
         message: string;
       };
+      console?: CodeModeConsoleEntry[];
     };
 ```
 
@@ -119,15 +126,41 @@ type CodeModeResult =
 result text returned to the model. Pi retains additional bounded Presentation
 Snapshots in tool-result details for Transcript replay and the TUI.
 
+Cells may call `console.log`, `console.info`, `console.warn`, `console.error`,
+and `console.debug`. One call creates one ordered entry without a trailing
+newline, while embedded newlines remain intact:
+
+```ts
+console.log("answer:", 42);
+return 42;
+```
+
+```json
+{
+  "result": "success",
+  "sessionId": "...",
+  "data": 42,
+  "console": [{ "method": "log", "text": "answer: 42" }]
+}
+```
+
+Formatting matches the pinned Deno Console for format tokens, primitives,
+spacing, and multiline inspection. Getters, coercion hooks, and custom
+inspectors do not run; CodeMode uses safe inspection instead when that differs
+from Deno. Console output arrives only with terminal results. Ordinary script,
+serialization, and worker-reported runtime failures retain prior calls. A
+timeout, cancellation, termination, or process death may omit them because the
+parent kills the worker before it can reply.
+
 ## Transcript and Observer UI
 
 The CodeMode Transcript gives all four tools semantic collapsed and expanded
 rendering. Collapsed rows prioritize Cell lifecycle, a short Session ID, Cell
-Ordinal, returned-value shape, nested-tool count, and elapsed time. Expanded
-rows show the full Session ID, explicit call arguments, TypeScript source,
-structured returned data or error, and bounded nested-tool names, outcomes, and
-durations. Nested arguments and raw nested outputs are never copied into the
-presentation.
+Ordinal, returned-value shape, Console-call count, nested-tool count, and elapsed
+time. Expanded rows show the full Session ID, explicit call arguments,
+TypeScript source, bounded Console output before structured returned data or the
+error, and bounded nested-tool names, outcomes, and durations. Nested arguments
+and raw nested outputs are never copied into the presentation.
 
 Status always uses a symbol and text together:
 
@@ -138,7 +171,8 @@ Status always uses a symbol and text together:
 
 Awaited Cells publish a presentation update immediately and once per second.
 Collapsed calls show one highlighted line inline or the first eight highlighted
-lines of a multi-line Cell. Expanded calls show the complete TypeScript source.
+lines of a multi-line Cell, truncating long lines to the viewport width. Expanded
+calls wrap long lines and show the complete TypeScript source.
 Returned-data display uses Pi's 2,000-line/50-KB limit; complete oversized data
 is written to a private Result Spill while the model-facing result remains
 unchanged. Result Spill files last for the live Pi session. Replayed history
@@ -255,13 +289,16 @@ generated helper source out of ordinary source locations. Every operating-system
 permission class is denied: filesystem read/write, network, environment, system
 information, subprocesses, FFI, and remote imports.
 
-Guest code receives ECMAScript built-ins, a read-only `tools` object, and only a
-frozen `Deno.version` identity. Raw process and standard-stream access,
-`console`, `Worker`, timers, filesystem/network APIs, and module loading are
-withheld. The parent watchdog terminates the subprocess for timeout or an
-infinite loop. Deno/V8 bounds each Session to a 128 MiB old-space heap and a
-1 MiB stack. Protocol inputs, tool results, and Cell results remain JSON-only
-and limited to 8 MiB of UTF-8.
+Guest code receives ECMAScript built-ins, a read-only `tools` object, a frozen
+five-method Console facade, and only a frozen `Deno.version` identity. Raw
+process and standard-stream access, `Worker`, timers, filesystem/network APIs,
+and module loading are withheld. Console calls never write to worker streams and
+do not include output from registered Pi tool handlers. The parent watchdog
+terminates the subprocess for timeout or an infinite loop. Deno/V8 bounds each
+Session to a 128 MiB old-space heap and a 1 MiB stack. Protocol inputs, tool
+results, returned data, and Console entries share one 8 MiB UTF-8 worker-message
+limit. An oversized response becomes the bounded `serialization` failure and
+may omit its Console entries.
 
 Registered Pi tools still execute in Pi's parent process with their normal
 permissions and lifecycle hooks. Cancellation aborts them through Pi's

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ian-pascoe/pi-codemode",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "private": false,
   "description": "Process-isolated persistent TypeScript tool composition for Pi",
   "keywords": [

package/src/codemode-console-output.ts

@@ -0,0 +1,11 @@
+/** Console methods captured from a CodeMode Cell in call order. */
+export const CODEMODE_CONSOLE_METHODS = ["log", "info", "warn", "error", "debug"] as const;
+
+/** One supported CodeMode Cell Console method. */
+export type CodeModeConsoleMethod = (typeof CODEMODE_CONSOLE_METHODS)[number];
+
+/** One captured CodeMode Cell Console call without a synthetic trailing newline. */
+export type CodeModeConsoleEntry = {
+  readonly method: CodeModeConsoleMethod;
+  readonly text: string;
+};

package/src/codemode-observer-ui.ts

@@ -12,6 +12,11 @@ import type {
   CodeModeObserverSnapshot,
   CodeModeUnexpectedFailure,
 } from "./codemode-session-coordinator.js";
+import {
+  boundedCodeModeElapsedMs,
+  formatCodeModeDuration,
+  shortestUniqueCodeModeSessionPrefix,
+} from "./codemode-session-coordinator.js";
 
 const CODEMODE_OBSERVER_UI_KEY = "codemode-observer";
 const CODEMODE_OBSERVER_ROW_LIMIT = 8;
@@ -131,25 +136,12 @@ function shortestUniqueCodeModeSessionPrefixes(
     const safe = sanitizeCodeModeObserverText(session.sessionId);
     return safe.length === 0 ? "unknown" : safe;
   });
-  return identifiers.map((identifier, index) => {
-    let length = Math.min(8, identifier.length);
-    while (
-      length < identifier.length &&
-      identifiers.some(
-        (candidate, candidateIndex) =>
-          candidateIndex !== index && candidate.startsWith(identifier.slice(0, length)),
-      )
-    ) {
-      length += 1;
-    }
-    return identifier.slice(0, length);
-  });
-}
-
-function boundedElapsedMilliseconds(nowMs: number, startedAtMs: number): number {
-  const elapsed = Math.round(nowMs - startedAtMs);
-  if (!Number.isFinite(elapsed)) return 0;
-  return Math.min(Number.MAX_SAFE_INTEGER, Math.max(0, elapsed));
+  return identifiers.map((identifier, index) =>
+    shortestUniqueCodeModeSessionPrefix(
+      identifier,
+      identifiers.filter((_candidate, candidateIndex) => candidateIndex !== index),
+    ),
+  );
 }
 
 function codeModeTerminalObserverState(
@@ -182,7 +174,7 @@ function projectCodeModeObserverRow(
       sessionPrefix,
       state: "running",
       cellOrdinal: session.current_cell.ordinal,
-      elapsedMs: boundedElapsedMilliseconds(nowMs, session.current_cell.started_at_ms),
+      elapsedMs: boundedCodeModeElapsedMs(session.current_cell.started_at_ms, nowMs),
       activeToolNames,
       activeToolCount: Math.max(session.current_cell.active_tool_count, activeToolNames.length),
     };
@@ -232,13 +224,6 @@ export function buildCodeModeObserverView(
   };
 }
 
-function formatCodeModeObserverDuration(elapsedMs: number): string {
-  if (elapsedMs < 1_000) return `${elapsedMs}ms`;
-  if (elapsedMs < 60_000) return `${(elapsedMs / 1_000).toFixed(1)}s`;
-  const seconds = Math.floor(elapsedMs / 1_000);
-  return `${Math.floor(seconds / 60)}m ${String(seconds % 60).padStart(2, "0")}s`;
-}
-
 function formatCodeModeObserverToolActivity(
   row: Extract<CodeModeObserverRow, { state: "running" }>,
 ): string | undefined {
@@ -256,10 +241,6 @@ function codeModeObserverRowDetail(row: CodeModeObserverRow): string {
     : `Cell ${row.cellOrdinal}`;
 }
 
-function joinCodeModeObserverRow(parts: readonly string[], separator: string): string {
-  return parts.join(separator);
-}
-
 function renderCodeModeObserverRow(
   row: CodeModeObserverRow,
   width: number,
@@ -270,9 +251,7 @@ function renderCodeModeObserverRow(
   const status = theme.fg(presentation.color, presentation.label);
   const detail = theme.fg("muted", codeModeObserverRowDetail(row));
   const duration =
-    row.state === "running"
-      ? theme.fg("muted", formatCodeModeObserverDuration(row.elapsedMs))
-      : undefined;
+    row.state === "running" ? theme.fg("muted", formatCodeModeDuration(row.elapsedMs)) : undefined;
   const toolActivity =
     row.state === "running" ? formatCodeModeObserverToolActivity(row) : undefined;
   const themedToolActivity =
@@ -285,13 +264,13 @@ function renderCodeModeObserverRow(
     [identity, status],
   ].map((parts) => parts.filter((part): part is string => part !== undefined));
   for (const parts of candidates) {
-    const line = joinCodeModeObserverRow(parts, separator);
+    const line = parts.join(separator);
     if (visibleWidth(line) <= width) return line;
   }
 
   const compactSeparator = theme.fg("dim", CODEMODE_OBSERVER_COMPACT_SEPARATOR_TEXT);
   const compactIdentity = `${theme.fg(presentation.color, presentation.symbol)} ${theme.bold(row.sessionPrefix)}`;
-  const compact = joinCodeModeObserverRow([compactIdentity, status], compactSeparator);
+  const compact = [compactIdentity, status].join(compactSeparator);
   if (visibleWidth(compact) <= width) return compact;
   return truncateToWidth(compact, width, CODEMODE_OBSERVER_ELLIPSIS);
 }