@ian-pascoe/pi-codemode 0.3.0 → 0.4.0

package/README.md

@@ -171,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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ian-pascoe/pi-codemode",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "private": false,
   "description": "Process-isolated persistent TypeScript tool composition for Pi",
   "keywords": [
@@ -24,6 +24,7 @@
   },
   "files": [
     "src",
+    "skills",
     "README.md",
     "LICENSE"
   ],
@@ -50,6 +51,9 @@
   "pi": {
     "extensions": [
       "./src/index.ts"
+    ],
+    "skills": [
+      "./skills"
     ]
   },
   "scripts": {

package/skills/pi-codemode/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: pi-codemode
+description: Configure or diagnose Pi CodeMode when tools disappear, Cells fail, Sessions reach capacity, or Exposure Modes route tools incorrectly.
+license: MIT
+---
+
+# Pi CodeMode
+
+1. Read the relevant Cell, Session, or Exposure Mode section of [`../../README.md`](../../README.md).
+2. Inspect disable warnings and call `codemode_sessions`.
+3. When an unused slot exists, run `return { ok: true, deno: Deno.version.deno };` in a new Cell and inspect the generated exposed-tool declarations.
+4. Classify any stable error code using that reference. Verify nested execution only with a declared, non-mutating tool.
+5. For an Exposure Mode change, compute the winning rule for the affected tool, edit the intended layer, and list live Sessions before `/reload`.
+6. Finish when the minimal Cell succeeds and the affected tool has the intended direct and CodeMode availability.
+
+Direct availability does not imply CodeMode exposure. `/reload` destroys live Sessions and their Notebook Bindings.

package/src/codemode-tool-rendering.ts

@@ -200,6 +200,47 @@ function highlightedCodeModeSource(source: string): string {
     .join("\n");
 }
 
+function truncateHighlightedCodeModeSourceLine(line: string, width: number): string {
+  if (visibleWidth(line) <= width) return line;
+  const prefix = sliceByColumn(line, 0, Math.max(0, width - 1), true);
+  return `${prefix}\u001b[22;23;24;25;27;28;29;39m…`;
+}
+
+class CodeModeCollapsedSourceComponent implements Component {
+  private readonly lines: readonly string[];
+
+  constructor(source: string) {
+    this.lines = highlightedCodeModeSource(source).split("\n");
+  }
+
+  render(width: number): string[] {
+    if (width <= 0) return [];
+    return this.lines.map((line) => truncateHighlightedCodeModeSourceLine(line, width));
+  }
+
+  invalidate(): void {}
+}
+
+class CodeModeCollapsedInlineSourceComponent implements Component {
+  constructor(
+    private readonly prefix: string,
+    private readonly source: string,
+    private readonly suffix: string,
+  ) {}
+
+  render(width: number): string[] {
+    if (width <= 0) return [];
+    const sourceWidth = width - visibleWidth(this.prefix) - visibleWidth(this.suffix);
+    if (visibleWidth(this.source) === 0 || sourceWidth <= 0)
+      return new Text(`${this.prefix.trimEnd()}${this.suffix}`, 0, 0).render(width);
+    return [
+      `${this.prefix}${truncateHighlightedCodeModeSourceLine(this.source, sourceWidth)}${this.suffix}`,
+    ];
+  }
+
+  invalidate(): void {}
+}
+
 function appendHighlightedCodeModeSource(container: Container, source: string): void {
   container.addChild(new Text(highlightedCodeModeSource(source), 0, 0));
 }
@@ -319,30 +360,27 @@ export function renderCodeModeToolCall(
   const oneLineSource = source !== undefined && !source.includes("\n") ? source : undefined;
   const expansionHint = `${keyText("app.tools.expand")} to expand`;
   const container = new Container();
-  container.addChild(
-    new Text(
-      [
-        theme.fg("toolTitle", theme.bold("CodeMode")),
-        theme.fg("accent", operation),
-        theme.fg("muted", sessionId === undefined ? "new" : formatSessionPrefix(sessionId)),
-        !expanded && oneLineSource !== undefined
-          ? highlightCode(oneLineSource, "typescript")[0]
-          : undefined,
-        !expanded && oneLineSource !== undefined
-          ? theme.fg("dim", `·  ${expansionHint}`)
-          : undefined,
-      ]
-        .filter((part): part is string => part !== undefined)
-        .join("  "),
-      0,
-      0,
-    ),
-  );
+  const header = [
+    theme.fg("toolTitle", theme.bold("CodeMode")),
+    theme.fg("accent", operation),
+    theme.fg("muted", sessionId === undefined ? "new" : formatSessionPrefix(sessionId)),
+  ].join("  ");
+  if (!expanded && oneLineSource !== undefined) {
+    container.addChild(
+      new CodeModeCollapsedInlineSourceComponent(
+        `${header}  `,
+        highlightCode(oneLineSource, "typescript")[0] ?? "",
+        `  ${theme.fg("dim", `·  ${expansionHint}`)}`,
+      ),
+    );
+  } else {
+    container.addChild(new Text(header, 0, 0));
+  }
   if (!expanded) {
     if (source === undefined || oneLineSource !== undefined) return container;
     const sourceLines = source.split("\n");
     const visibleSource = sourceLines.slice(0, CODEMODE_COLLAPSED_SCRIPT_LINES).join("\n");
-    appendHighlightedCodeModeSource(container, visibleSource);
+    container.addChild(new CodeModeCollapsedSourceComponent(visibleSource));
     const omittedLines = Math.max(0, sourceLines.length - CODEMODE_COLLAPSED_SCRIPT_LINES);
     const omitted =
       omittedLines === 0 ? "" : `… ${pluralizedCodeModeCount(omittedLines, "line")} omitted  ·  `;

package/src/pi-codemode-extension.ts

@@ -39,7 +39,7 @@ import {
 } from "./pi-tool-bridge.js";
 
 const CODEMODE_EXECUTE_DESCRIPTION =
-  "Execute a TypeScript Cell in a persistent isolated Deno CodeMode Session. Reuse a Session ID to retain Notebook Bindings; a new Session reclaims the least-recently-used idle Session at capacity. Use the read-only tools object for registered Pi tools. Cells may call console.log, console.info, console.warn, console.error, and console.debug; captured output arrives only with terminal results.";
+  "Execute a TypeScript Cell in a persistent isolated Deno CodeMode Session. Reuse a Session ID to retain Notebook Bindings; a new Session reclaims the least-recently-used idle Session at capacity. Use the read-only tools object for registered Pi tools. Return final result data with a top-level return statement. Reserve console.log, console.info, console.warn, console.error, and console.debug for diagnostics; captured output arrives only with terminal results.";
 
 type PiCodeModeGeneration = {
   readonly captured: CapturedPiAgentSession;