@codemieai/code 0.11.0 → 0.13.0

package/dist/agents/plugins/copilot-cli/session/processors/copilot-cli.conversations-processor.js

@@ -0,0 +1,313 @@
+/**
+ * Conversations processor for Copilot CLI sessions.
+ *
+ * Copilot persists prompt text in `events.jsonl`; `parseSessionFile` captures it into
+ * `ParsedSession.messages`. Unlike Claude and Pi, Copilot does not currently emit
+ * mid-turn hook events through CodeMie, so this processor drains the whole discovered
+ * transcript on SessionEnd and appends pending payload windows to the standard
+ * `_conversation.jsonl` spool for the shared sync pipeline.
+ */
+import { appendFile, mkdir } from 'fs/promises';
+import { dirname } from 'path';
+import { getSessionConversationPath } from '../../../../core/session/session-config.js';
+import { CODEMIE_ASSISTANT_ID, CONVERSATION_PROCESSOR_NAME } from '../../../../../providers/plugins/sso/session/processors/conversations/constants.js';
+import { CONVERSATION_SYNC_STATUS } from '../../../../../providers/plugins/sso/session/processors/conversations/types.js';
+import { readJSONL } from '../../../../../providers/plugins/sso/session/utils/jsonl-reader.js';
+import { logger } from '../../../../../utils/logger.js';
+function asTurnRecord(value) {
+    if (!value || typeof value !== 'object')
+        return null;
+    return value;
+}
+function parseTimestampMs(value) {
+    if (!value)
+        return undefined;
+    const parsed = Date.parse(value);
+    return Number.isNaN(parsed) ? undefined : parsed;
+}
+function calculateResponseTimeSeconds(start, end) {
+    const startMs = parseTimestampMs(start);
+    const endMs = parseTimestampMs(end);
+    if (startMs === undefined || endMs === undefined || endMs < startMs) {
+        return undefined;
+    }
+    return Math.max(0, Math.round(((endMs - startMs) / 1000) * 100) / 100);
+}
+function stringify(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 buildThoughts(events, historyIndex) {
+    const thoughts = [];
+    const toolThoughtByCallId = new Map();
+    for (const event of events) {
+        if (event.kind === 'assistant_commentary') {
+            if (!event.text?.trim())
+                continue;
+            thoughts.push({
+                id: `copilot-commentary-${historyIndex}-${event.sourceIndex}`,
+                parent_id: null,
+                metadata: {
+                    timestamp: event.timestamp,
+                    source_index: event.sourceIndex,
+                    event_kind: event.kind,
+                    ...(event.metadata ?? {}),
+                },
+                in_progress: false,
+                input_text: '',
+                message: event.text,
+                author_type: 'Agent',
+                author_name: 'GitHub Copilot CLI',
+                output_format: 'text',
+                error: false,
+                interrupted: false,
+                aborted: false,
+                children: [],
+            });
+            continue;
+        }
+        if (event.kind === 'tool_output') {
+            const pending = event.callId ? toolThoughtByCallId.get(event.callId) : undefined;
+            if (pending) {
+                pending.message = event.text ?? '';
+                pending.error = event.error === true;
+                pending.metadata = {
+                    ...pending.metadata,
+                    output_source_index: event.sourceIndex,
+                    output_timestamp: event.timestamp,
+                    ...(event.metadata ?? {}),
+                };
+                toolThoughtByCallId.delete(event.callId);
+                continue;
+            }
+        }
+        const thought = {
+            id: event.callId || `copilot-tool-${historyIndex}-${event.sourceIndex}`,
+            parent_id: null,
+            metadata: {
+                timestamp: event.timestamp,
+                source_index: event.sourceIndex,
+                event_kind: event.kind,
+                ...(event.callId && { call_id: event.callId }),
+                ...(event.metadata ?? {}),
+            },
+            in_progress: false,
+            input_text: event.inputText ?? '',
+            message: event.text ?? '',
+            author_type: 'Tool',
+            author_name: event.toolName || 'Unknown Tool',
+            output_format: 'text',
+            error: event.error === true,
+            interrupted: false,
+            aborted: false,
+            children: [],
+        };
+        thoughts.push(thought);
+        if (event.kind === 'tool_call' && event.callId) {
+            toolThoughtByCallId.set(event.callId, thought);
+        }
+    }
+    return thoughts;
+}
+function toHistory(turn) {
+    const history = [];
+    if (turn.user?.text) {
+        history.push({
+            role: 'User',
+            message: turn.user.text,
+            message_raw: turn.user.text,
+            history_index: turn.historyIndex,
+            date: turn.user.timestamp,
+            file_names: [],
+        });
+    }
+    if (turn.assistant?.text) {
+        const thoughts = buildThoughts(turn.events, turn.historyIndex);
+        history.push({
+            role: 'Assistant',
+            message: turn.assistant.text,
+            message_raw: turn.assistant.text,
+            history_index: turn.historyIndex,
+            date: turn.assistant.timestamp,
+            response_time: calculateResponseTimeSeconds(turn.user?.timestamp, turn.assistant.timestamp),
+            assistant_id: CODEMIE_ASSISTANT_ID,
+            thoughts: thoughts.length > 0 ? thoughts : undefined,
+        });
+    }
+    return history;
+}
+function buildTurns(messages) {
+    const turns = [];
+    let current = null;
+    let historyIndex = -1;
+    for (const [sourceIndex, raw] of messages.entries()) {
+        const record = asTurnRecord(raw);
+        const role = record?.message?.role;
+        const content = record?.message?.content?.trim();
+        if (!role || !content) {
+            continue;
+        }
+        if (role === 'user') {
+            historyIndex += 1;
+            current = {
+                historyIndex,
+                user: {
+                    text: content,
+                    timestamp: record.timestamp,
+                },
+                events: [],
+            };
+            turns.push(current);
+            continue;
+        }
+        if (!current) {
+            continue;
+        }
+        current.assistant = {
+            text: content,
+            timestamp: record.timestamp,
+            model: record.message?.model,
+        };
+        const toolRequests = Array.isArray(record.message?.toolRequests)
+            ? record.message?.toolRequests
+            : [];
+        if (toolRequests.length > 0) {
+            for (const request of toolRequests) {
+                current.events.push({
+                    kind: 'tool_call',
+                    sourceIndex,
+                    timestamp: record.timestamp,
+                    callId: request.toolCallId,
+                    toolName: request.name,
+                    inputText: stringify(request.arguments),
+                    metadata: {
+                        tool_arguments: request.arguments,
+                    },
+                });
+            }
+        }
+        else {
+            current.events.push({
+                kind: 'assistant_commentary',
+                sourceIndex,
+                timestamp: record.timestamp,
+                text: content,
+            });
+        }
+    }
+    return turns;
+}
+export class CopilotCliConversationsProcessor {
+    name = 'copilot-cli-conversations';
+    priority = 2;
+    shouldProcess(session) {
+        if (process.env.CODEMIE_CONV_SYNC_DISABLED === '1')
+            return false;
+        return session.messages.length > 0;
+    }
+    async process(session, context) {
+        const conversationId = context.agentSessionId?.trim();
+        if (!conversationId) {
+            logger.warn(`[${this.name}] Missing agentSessionId for session ${session.sessionId}; skipping conversation sync`);
+            return {
+                success: true,
+                message: 'Skipped: missing Copilot conversation id',
+                metadata: { recordsProcessed: 0, skipReason: 'MISSING_CONVERSATION_ID' },
+            };
+        }
+        const turns = buildTurns(session.messages);
+        if (turns.length === 0) {
+            return {
+                success: true,
+                message: 'No conversation turns generated',
+                metadata: { recordsProcessed: 0 },
+            };
+        }
+        const conversationsPath = getSessionConversationPath(session.sessionId);
+        await mkdir(dirname(conversationsPath), { recursive: true });
+        const existingPayloads = await readJSONL(conversationsPath);
+        const { SessionStore } = await import('../../../../core/session/SessionStore.js');
+        const sessionStore = new SessionStore();
+        const sessionMetadata = await sessionStore.loadSession(session.sessionId);
+        let lastHistoryIndex = sessionMetadata?.sync?.conversations?.lastSyncedHistoryIndex ?? -1;
+        for (const payload of existingPayloads) {
+            if (payload.payload.conversationId !== conversationId)
+                continue;
+            for (const idx of payload.historyIndices) {
+                lastHistoryIndex = Math.max(lastHistoryIndex, idx);
+            }
+        }
+        let payloadsWritten = 0;
+        let recordsProcessed = 0;
+        let lastSentinel;
+        let lastModel;
+        for (const turn of turns) {
+            if (turn.historyIndex <= lastHistoryIndex) {
+                continue;
+            }
+            const history = toHistory(turn);
+            if (history.length === 0) {
+                continue;
+            }
+            const sentinel = `${conversationId}@${turn.historyIndex}`;
+            const payloadRecord = {
+                payloadId: sentinel,
+                timestamp: Date.now(),
+                isTurnContinuation: false,
+                historyIndices: history.map((entry) => entry.history_index),
+                messageCount: history.length,
+                lastProcessedMessageUuid: sentinel,
+                payload: {
+                    conversationId,
+                    history,
+                    assistantId: CODEMIE_ASSISTANT_ID,
+                    llmModel: turn.assistant?.model,
+                },
+                status: CONVERSATION_SYNC_STATUS.PENDING,
+            };
+            await appendFile(conversationsPath, JSON.stringify(payloadRecord) + '\n');
+            payloadsWritten += 1;
+            recordsProcessed += history.length;
+            lastHistoryIndex = turn.historyIndex;
+            lastSentinel = sentinel;
+            lastModel = turn.assistant?.model ?? lastModel;
+        }
+        if (payloadsWritten === 0) {
+            return {
+                success: true,
+                message: 'No new conversation payloads',
+                metadata: { recordsProcessed: 0 },
+            };
+        }
+        logger.info(`[${CONVERSATION_PROCESSOR_NAME}] Queued ${payloadsWritten} Copilot conversation payload` +
+            `${payloadsWritten === 1 ? '' : 's'} for session ${session.sessionId}`);
+        return {
+            success: true,
+            message: `Queued ${payloadsWritten} Copilot conversation payload(s)`,
+            metadata: {
+                recordsProcessed,
+                payloadsWritten,
+                syncUpdates: {
+                    conversations: {
+                        lastSyncedMessageUuid: lastSentinel,
+                        lastSyncedHistoryIndex: lastHistoryIndex,
+                        conversationId,
+                        totalMessagesSynced: recordsProcessed,
+                        totalSyncAttempts: 1,
+                        lastSyncAt: Date.now(),
+                    },
+                },
+                llmModel: lastModel,
+            },
+        };
+    }
+}
+//# sourceMappingURL=copilot-cli.conversations-processor.js.map

package/dist/agents/plugins/copilot-cli/session/processors/copilot-cli.conversations-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-cli.conversations-processor.js","sourceRoot":"","sources":["../../../../../../src/agents/plugins/copilot-cli/session/processors/copilot-cli.conversations-processor.ts"],"names":[],"mappings":"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"}

package/dist/agents/plugins/copilot-cli/session/processors/copilot-cli.metrics-processor.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Metrics processor for Copilot CLI sessions.
+ *
+ * Extraction itself happens in `parseSessionFile` (one pass over `events.jsonl`); this
+ * processor exists so the adapter follows the same `SessionProcessor` orchestration every
+ * other agent uses.
+ */
+import type { SessionProcessor, ProcessingContext, ProcessingResult } from '../../../../core/session/BaseProcessor.js';
+import type { ParsedSession } from '../../../../core/session/BaseSessionAdapter.js';
+export declare class CopilotCliMetricsProcessor implements SessionProcessor {
+    readonly name = "copilot-cli-metrics";
+    readonly priority = 10;
+    shouldProcess(session: ParsedSession): boolean;
+    process(session: ParsedSession, _context: ProcessingContext): Promise<ProcessingResult>;
+}
+//# sourceMappingURL=copilot-cli.metrics-processor.d.ts.map

package/dist/agents/plugins/copilot-cli/session/processors/copilot-cli.metrics-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-cli.metrics-processor.d.ts","sourceRoot":"","sources":["../../../../../../src/agents/plugins/copilot-cli/session/processors/copilot-cli.metrics-processor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gDAAgD,CAAC;AAEpF,qBAAa,0BAA2B,YAAW,gBAAgB;IACjE,QAAQ,CAAC,IAAI,yBAAyB;IACtC,QAAQ,CAAC,QAAQ,MAAM;IAEvB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO;IAIxC,OAAO,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAO9F"}

package/dist/agents/plugins/copilot-cli/session/processors/copilot-cli.metrics-processor.js

@@ -0,0 +1,22 @@
+/**
+ * Metrics processor for Copilot CLI sessions.
+ *
+ * Extraction itself happens in `parseSessionFile` (one pass over `events.jsonl`); this
+ * processor exists so the adapter follows the same `SessionProcessor` orchestration every
+ * other agent uses.
+ */
+export class CopilotCliMetricsProcessor {
+    name = 'copilot-cli-metrics';
+    priority = 10;
+    shouldProcess(session) {
+        return session.metrics !== undefined;
+    }
+    async process(session, _context) {
+        const toolCalls = Object.values(session.metrics?.tools ?? {}).reduce((sum, n) => sum + n, 0);
+        return {
+            success: true,
+            metadata: { recordsProcessed: toolCalls },
+        };
+    }
+}
+//# sourceMappingURL=copilot-cli.metrics-processor.js.map

package/dist/agents/plugins/copilot-cli/session/processors/copilot-cli.metrics-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-cli.metrics-processor.js","sourceRoot":"","sources":["../../../../../../src/agents/plugins/copilot-cli/session/processors/copilot-cli.metrics-processor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,MAAM,OAAO,0BAA0B;IAC5B,IAAI,GAAG,qBAAqB,CAAC;IAC7B,QAAQ,GAAG,EAAE,CAAC;IAEvB,aAAa,CAAC,OAAsB;QAClC,OAAO,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAsB,EAAE,QAA2B;QAC/D,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7F,OAAO;YACL,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,EAAE,gBAAgB,EAAE,SAAS,EAAE;SAC1C,CAAC;IACJ,CAAC;CACF"}

package/dist/agents/plugins/pi/__tests__/home-redirect.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Point `os.homedir()` at a fixture directory for the duration of a test.
+ *
+ * `homedir()` reads `$HOME` on POSIX but `%USERPROFILE%` on Windows, so setting only one of
+ * them leaves the other platform resolving `~/.pi/agent` against the real user profile. The
+ * user-scope fixtures are then invisible and every count comes back zero — indistinguishable
+ * from the broken mapping these suites exist to catch.
+ *
+ * @returns a function that restores both variables to their previous state.
+ */
+export declare function redirectHomeDir(dir: string): () => void;
+//# sourceMappingURL=home-redirect.d.ts.map

package/dist/agents/plugins/pi/__tests__/home-redirect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"home-redirect.d.ts","sourceRoot":"","sources":["../../../../../src/agents/plugins/pi/__tests__/home-redirect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,IAAI,CAcvD"}

package/dist/agents/plugins/pi/__tests__/home-redirect.js

@@ -0,0 +1,27 @@
+/**
+ * Point `os.homedir()` at a fixture directory for the duration of a test.
+ *
+ * `homedir()` reads `$HOME` on POSIX but `%USERPROFILE%` on Windows, so setting only one of
+ * them leaves the other platform resolving `~/.pi/agent` against the real user profile. The
+ * user-scope fixtures are then invisible and every count comes back zero — indistinguishable
+ * from the broken mapping these suites exist to catch.
+ *
+ * @returns a function that restores both variables to their previous state.
+ */
+export function redirectHomeDir(dir) {
+    const saved = {
+        HOME: process.env.HOME,
+        USERPROFILE: process.env.USERPROFILE,
+    };
+    process.env.HOME = dir;
+    process.env.USERPROFILE = dir;
+    return () => {
+        for (const [name, value] of Object.entries(saved)) {
+            if (value === undefined)
+                delete process.env[name];
+            else
+                process.env[name] = value;
+        }
+    };
+}
+//# sourceMappingURL=home-redirect.js.map

package/dist/agents/plugins/pi/__tests__/home-redirect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"home-redirect.js","sourceRoot":"","sources":["../../../../../src/agents/plugins/pi/__tests__/home-redirect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,KAAK,GAAuC;QAChD,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI;QACtB,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW;KACrC,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC;IACvB,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC;IAE9B,OAAO,GAAG,EAAE;QACV,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAClD,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;;gBAC7C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QACjC,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/agents/plugins/pi/extension/README.md

@@ -0,0 +1,68 @@
+# CodeMie run ledger — Pi extension
+
+`index.js` is copied verbatim into `<piAgentDir>/extensions/codemie-metrics/` before every
+`codemie pi` run and loaded by Pi's own extension discovery. It records which transcript files the
+run produced so `onSessionEnd` can read a fact instead of inferring one.
+
+## Why this exists
+
+Pi names its transcripts itself, writes them lazily, and can produce several per run (`/new`,
+`/fork`, `--session` into another project). Working out afterwards which files belong to the run you
+just launched is guesswork — a concurrent `pi` in the same directory produces files that are
+indistinguishable by id, mtime, or `parentSession` lineage. Eight review rounds of increasingly
+careful heuristics kept yielding the same class of defect, and the failure mode is not lost metrics
+but **uploading a stranger's prompts and tool output under this user's session**.
+
+Inside Pi the question is not hard: `ctx.sessionManager.getSessionFile()` is the transcript being
+written. This extension appends that, plus every session transition, to a ledger.
+
+## Layout — why a directory and not a single file
+
+Pi's discovery accepts `extensions/*.js` and `extensions/*/index.js` (upstream
+`core/extensions/loader.ts:597-599`, `:610-638`). A bare `.js` file would inherit its module system
+from the nearest `package.json` on the *user's* disk, where a CommonJS context would make
+`export default` a syntax error. Shipping a directory lets `package.json` declare
+`{"type":"module"}` next to the code, so Pi's jiti loader and CodeMie's pre-flight `import()`
+self-test resolve it identically. `.mjs` would sidestep this too but is rejected by
+`isExtensionFile`.
+
+## The hard constraint
+
+**Any extension load failure makes Pi call `process.exit(1)`** — bad import, factory throw,
+non-function export — in every mode (upstream `main.ts:893-899`). A mistake here kills the user's
+coding session, which is much worse than collecting nothing. Hence, in `index.js`:
+
+- node builtins only; nothing from `@earendil-works/*`, not even `import type`
+- the whole factory body, and every handler body, wrapped in `try/catch`
+- never subscribes to `tool_call` (a throwing `tool_call` handler *blocks the tool*)
+- handlers return `undefined`, so the `input` handler cannot alter what the user typed
+- synchronous appends, each individually guarded
+- only parsed command *names* are recorded — never prompt or argument text
+
+`pi.extension.ts` additionally runs a pre-flight `import()` of the materialized copy and deletes it
+if it does not export a function, so a corrupted asset degrades to "no metrics" rather than "no
+session".
+
+## Ledger format
+
+`~/.codemie/sessions/<CODEMIE_SESSION_ID>_pi-run.jsonl`, append-only, one JSON object per line. The
+path arrives as `CODEMIE_PI_LEDGER`, so this file holds no assumptions about CodeMie's layout — no
+env var, no subscriptions.
+
+| `t` | Fields |
+|---|---|
+| `boot` | `pid` |
+| `session` | `reason`, `file`, `piSessionId`, `cwd`, `prevFile`, `mode` |
+| `cmd` | `kind` (`skill`\|`prompt`), `name` |
+| `shutdown` | `reason`, `file`, `target`, `piSessionId`, `cwd`, `mode` |
+
+`cwd` is `sessionManager.getCwd()` — the *transcript's* cwd, which is what `--session <path>` runs
+under, not the directory the wrapper was launched from.
+
+`file` may name a path Pi has not written yet: `_persist` only flushes once the session holds an
+assistant message. Consumers must filter on existence.
+
+## Disabling
+
+`CODEMIE_PI_EXTENSION_DISABLED=1` — the extension registers nothing, and `ensurePiCodeMieExtension`
+removes the materialized copy.

package/dist/agents/plugins/pi/extension/index.js

@@ -0,0 +1,161 @@
+/**
+ * CodeMie run ledger — a Pi extension.
+ *
+ * Pi writes its session transcripts lazily, under names it chooses, and a single
+ * run can produce several of them (`/new`, `/fork`, `--session` into another
+ * project). A wrapper that tries to work out afterwards which files belong to the
+ * run it just launched is guessing: transcripts from a concurrent `pi` in the same
+ * directory are indistinguishable by id, mtime or lineage. Guessing wrong does not
+ * merely lose metrics — it uploads a stranger's prompts and tool output under this
+ * user's session.
+ *
+ * So we do not guess. This extension runs inside Pi, where the answer is a fact:
+ * `ctx.sessionManager.getSessionFile()` is the transcript being written right now.
+ * It appends that fact, plus every session transition, to a ledger keyed to the
+ * CodeMie session id. `onSessionEnd` reads the ledger instead of scanning a
+ * directory.
+ *
+ * ## Invariants — do not relax any of these without reading the note below
+ *
+ * Pi turns ANY extension load failure into a `type:"error"` diagnostic and then
+ * calls `process.exit(1)` (upstream `main.ts:893-899`) — in every mode. A throw in
+ * this file's import or factory therefore kills the user's coding session outright.
+ * That is a far worse outcome than collecting no metrics, so:
+ *
+ *   1. Imports are node builtins only. Nothing from `@earendil-works/*`, not even
+ *      `import type` — a zero-import file removes the question entirely.
+ *   2. The whole factory body is wrapped in try/catch.
+ *   3. Every handler body is separately wrapped — a throw in `session_shutdown`
+ *      would truncate the ledger even though Pi catches it (`runner.ts:815-830`).
+ *   4. We never subscribe to `tool_call`: a throwing `tool_call` handler *blocks
+ *      the tool*, which would change what the user's agent can do.
+ *   5. Handlers return `undefined`, never a result object, so the `input` handler
+ *      cannot transform or swallow what the user typed.
+ *   6. Only parsed *names* are recorded. Prompt and argument text never enters the
+ *      ledger.
+ *
+ * Writes are synchronous (`appendFileSync`) so a hard exit cannot lose the last
+ * line, and every write is individually guarded — a read-only disk degrades this
+ * to "no metrics", never to a broken session.
+ *
+ * The ledger path arrives as `CODEMIE_PI_LEDGER` rather than being derived here,
+ * so this file holds no assumptions about CodeMie's directory layout. No env var,
+ * no ledger, no subscriptions.
+ *
+ * @see src/agents/plugins/pi/pi.extension.ts — writes this file out and reads it back
+ */
+
+import { appendFileSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+
+const LEDGER_VERSION = 1;
+
+/** `/skill:<name>` — Pi's own form, per its interactive skill dispatcher. */
+const SKILL_COMMAND = /^\/skill:([A-Za-z0-9][\w.-]*)/;
+
+/** `/<name>` — a prompt template. Anchored and charset-limited so `/usr/local/bin` does not match. */
+const PROMPT_COMMAND = /^\/([A-Za-z][\w.-]*)(?:\s|$)/;
+
+/** Call a getter that belongs to Pi, never letting its failure cost us the record. */
+function safe(read) {
+  try {
+    const value = read();
+    return value === undefined ? null : value;
+  } catch {
+    return null;
+  }
+}
+
+export default function codemieMetrics(pi) {
+  try {
+    const ledgerPath = process.env.CODEMIE_PI_LEDGER;
+    if (!ledgerPath || process.env.CODEMIE_PI_EXTENSION_DISABLED === '1') {
+      return;
+    }
+
+    let ledgerDirReady = false;
+    const append = (record) => {
+      try {
+        if (!ledgerDirReady) {
+          mkdirSync(dirname(ledgerPath), { recursive: true });
+          ledgerDirReady = true;
+        }
+        appendFileSync(ledgerPath, `${JSON.stringify({ v: LEDGER_VERSION, ts: Date.now(), ...record })}\n`);
+      } catch {
+        // A ledger we cannot write is a metrics problem, not a session problem.
+      }
+    };
+
+    /**
+     * `getCwd()` is the transcript's own cwd, which is what we want: `--session
+     * <path>` runs the whole session under the cwd recorded in that file's header,
+     * not the directory the wrapper was launched from.
+     */
+    const sessionFacts = (ctx) => ({
+      file: safe(() => ctx.sessionManager.getSessionFile()),
+      piSessionId: safe(() => ctx.sessionManager.getSessionId()),
+      cwd: safe(() => ctx.sessionManager.getCwd()),
+      mode: safe(() => ctx.mode),
+    });
+
+    append({ t: 'boot', pid: process.pid });
+
+    pi.on('session_start', (event, ctx) => {
+      try {
+        append({
+          t: 'session',
+          reason: safe(() => event.reason),
+          prevFile: safe(() => event.previousSessionFile),
+          ...sessionFacts(ctx),
+        });
+      } catch {
+        // never propagate
+      }
+      return undefined;
+    });
+
+    pi.on('session_shutdown', (event, ctx) => {
+      try {
+        append({
+          t: 'shutdown',
+          reason: safe(() => event.reason),
+          target: safe(() => event.targetSessionFile),
+          ...sessionFacts(ctx),
+        });
+      } catch {
+        // never propagate
+      }
+      return undefined;
+    });
+
+    /**
+     * Slash commands are the one signal the transcript cannot carry: Pi expands a
+     * prompt template into plain user text before persisting it, so `/review` is
+     * gone by the time the entry is written. `input` fires with the raw text.
+     *
+     * Only the command name is recorded — never its arguments.
+     */
+    pi.on('input', (event) => {
+      try {
+        const text = safe(() => event.text);
+        if (typeof text !== 'string' || text.charCodeAt(0) !== 47 /* '/' */) {
+          return undefined;
+        }
+        const skill = SKILL_COMMAND.exec(text);
+        if (skill) {
+          append({ t: 'cmd', kind: 'skill', name: skill[1] });
+          return undefined;
+        }
+        const prompt = PROMPT_COMMAND.exec(text);
+        if (prompt) {
+          append({ t: 'cmd', kind: 'prompt', name: prompt[1] });
+        }
+      } catch {
+        // never propagate
+      }
+      return undefined;
+    });
+  } catch {
+    // A throw here would make Pi exit(1) and take the user's session with it.
+  }
+}

package/dist/agents/plugins/pi/extension/package.json

@@ -0,0 +1,8 @@
+{
+  "name": "codemie-pi-run-ledger",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "main": "index.js",
+  "description": "Records which transcripts a codemie-pi run produced, from inside Pi."
+}