@codemieai/code 0.11.0 → 0.13.0

package/dist/agents/plugins/pi/pi.plugin.js

@@ -0,0 +1,453 @@
+import { BaseAgentAdapter } from '../../core/BaseAgentAdapter.js';
+import { logger } from '../../../utils/logger.js';
+import { preparePiAgentDir } from './pi.setup.js';
+import { fetchAndBuildPiModels, classifyPiModel } from './pi.models.js';
+import { getPiAgentDir, resolvePiSessionDir } from './pi.paths.js';
+import { LEDGER_PATH_ENV, ensurePiCodeMieExtension, getPiRunLedgerPath, readPiRunLedger, } from './pi.extension.js';
+import { resolve } from 'path';
+import { detectGitBranch, detectGitRemoteRepo } from '../../../utils/processes.js';
+import { appendTranscriptMarker } from '../../core/session/session-origin-audit.js';
+import { reconcileStaleSessions } from '../../core/session/stale-session-reconciliation.js';
+import { startPiIncrementalSync, stopPiIncrementalSync } from './pi.incremental-sync.js';
+import { installRequiredPiPackages } from './pi.packages.js';
+import { PiSessionAdapter } from './pi.session.js';
+/**
+ * Pi flags that select an existing session. Pi rejects `--session-id` when any of
+ * them is present (`validateSessionIdFlags` in Pi's `main.ts` calls `process.exit(1)`),
+ * so the injected id must be suppressed for these runs. `--fork` is deliberately
+ * absent: Pi allows `--fork` together with `--session-id` and uses the id to name
+ * the forked session.
+ */
+const PI_SESSION_SELECTION_FLAGS = ['--session', '--continue', '-c', '--resume', '-r'];
+/**
+ * Read the value of a `<flag> <value>` pair. Pi's parser only accepts the
+ * space-separated form, so `--flag=value` is deliberately not matched, and it
+ * assigns on every occurrence, so the last one wins.
+ */
+function readFlagValue(args, flag) {
+    const index = args.lastIndexOf(flag);
+    return index !== -1 && index + 1 < args.length ? args[index + 1] : undefined;
+}
+function hasSessionSelectionFlag(args) {
+    return PI_SESSION_SELECTION_FLAGS.some((flag) => args.includes(flag));
+}
+/**
+ * Reconcile CodeMie's CLI surface with Pi's session flags before the run starts.
+ *
+ * Two argv-derived facts are needed later by hooks that cannot see argv:
+ * `beforeRun` receives only `env`, and `enrichArgs` receives no env at all. Both
+ * are published through `envOverrides`, which `BaseAgentAdapter` spreads into the
+ * run-scoped `env` object that also reaches `onSessionEnd` and session discovery.
+ */
+export function preparePiInvocation(args, envOverrides) {
+    // CodeMie declares `--resume <session-id>`, but Pi's `--resume`/`-r` is a boolean
+    // that opens an interactive picker, which would leave the id as a bare positional
+    // and send it to the model as a chat message. `--session <id>` is Pi's
+    // value-taking "open this session and keep appending" flag. If the user also
+    // passed `--session`, theirs wins in Pi and this pair is dropped rather than
+    // rewritten, so a second `--session` cannot shadow it and the orphaned id cannot
+    // leak into the conversation.
+    const resumeIndex = args.indexOf('--resume');
+    const hasResumeValue = resumeIndex !== -1 && resumeIndex + 1 < args.length;
+    let piArgs = args;
+    if (hasResumeValue) {
+        piArgs = args.includes('--session')
+            ? [...args.slice(0, resumeIndex), ...args.slice(resumeIndex + 2)]
+            : args.map((arg, index) => (index === resumeIndex ? '--session' : arg));
+    }
+    const overrides = { ...envOverrides };
+    // `--session-dir` is an unknown option to CodeMie's parser and reaches Pi verbatim,
+    // so discovery would otherwise scan a directory Pi never writes to. Seed the raw
+    // value; resolvePiSessionDir performs the tilde expansion Pi also applies.
+    const sessionDir = readFlagValue(piArgs, '--session-dir');
+    if (sessionDir) {
+        overrides.PI_CODING_AGENT_SESSION_DIR = sessionDir;
+    }
+    return { args: piArgs, envOverrides: overrides };
+}
+function buildPiHookConfig(env, sessionId) {
+    return {
+        agentName: env.CODEMIE_AGENT || 'pi',
+        sessionId,
+        provider: env.CODEMIE_PROVIDER,
+        apiBaseUrl: env.CODEMIE_BASE_URL,
+        ssoUrl: env.CODEMIE_URL,
+        syncApiUrl: env.CODEMIE_SYNC_API_URL,
+        version: env.CODEMIE_CLI_VERSION,
+        profileName: env.CODEMIE_PROFILE_NAME,
+        project: env.CODEMIE_PROJECT,
+        model: env.CODEMIE_MODEL,
+        clientType: 'codemie-pi',
+    };
+}
+/**
+ * Point the CodeMie session record at what the run actually produced.
+ *
+ * Three things are only knowable once Pi has exited, and each has a consumer that
+ * silently degrades without it:
+ *
+ * - `correlation.agentSessionFile` — the analytics cost path resolves the native
+ *   transcript through this field. Pi left it empty, so token and cost figures were
+ *   never readable for a Pi session, and the report blamed a missing token reader.
+ * - `correlation.agentSessionId` — the metrics aggregator prefers it when labelling
+ *   the wire `session_id`, which should be Pi's id rather than CodeMie's.
+ * - `workingDirectory` / `gitBranch` / `repository` — `--session <path>` runs the
+ *   whole session under the transcript's cwd, which may be a different repository
+ *   than the one CodeMie was launched from.
+ */
+async function correlateRunToSession(sessionId, ledger) {
+    if (!ledger.primaryTranscript)
+        return;
+    try {
+        const { SessionStore } = await import('../../core/session/SessionStore.js');
+        const store = new SessionStore();
+        const session = await store.loadSession(sessionId);
+        if (!session) {
+            logger.debug(`[pi] No session record for ${sessionId}; skipping correlation`);
+            return;
+        }
+        session.correlation = {
+            ...session.correlation,
+            status: 'matched',
+            agentSessionFile: ledger.primaryTranscript,
+            ...(ledger.piSessionId && { agentSessionId: ledger.piSessionId }),
+            detectedAt: Date.now(),
+        };
+        if (ledger.cwd && resolve(ledger.cwd) !== resolve(session.workingDirectory)) {
+            logger.debug(`[pi] Session ran under ${ledger.cwd}, not ${session.workingDirectory}`);
+            session.workingDirectory = ledger.cwd;
+            const [branch, repository] = await Promise.all([
+                detectGitBranch(ledger.cwd),
+                detectGitRemoteRepo(ledger.cwd),
+            ]);
+            if (branch)
+                session.gitBranch = branch;
+            if (repository)
+                session.repository = repository;
+        }
+        await store.saveSession(session);
+        // Ownership sidecars, so analytics can tell a CodeMie-managed transcript from a
+        // bare `pi` one.
+        for (const transcript of ledger.transcripts) {
+            appendTranscriptMarker(transcript, sessionId, 'pi');
+        }
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        logger.debug(`[pi] Correlating the run to its session record failed (non-blocking): ${msg}`);
+    }
+}
+export const PiPluginMetadata = {
+    name: 'pi',
+    displayName: 'Pi',
+    description: 'Pi - open-source coding agent harness',
+    npmPackage: '@earendil-works/pi-coding-agent',
+    cliCommand: process.env.CODEMIE_PI_BIN || 'pi',
+    sessionAnalyticsReport: true,
+    metricsConfig: {
+        excludeErrorsFromTools: ['bash'],
+    },
+    dataPaths: {
+        home: '.pi',
+    },
+    /**
+     * Pi names its resource directories differently from the scanner's defaults, so the
+     * lifecycle metric counted zero of everything until this mapping existed:
+     *
+     * - `prompts/` holds Pi's prompt templates, its slash-command equivalent. Flat `.md`
+     *   files, which is what the `commands` counter looks for.
+     * - `extensions/` holds Pi's in-process hooks as `.ts`/`.js` files, which is what the
+     *   `hooks` counter looks for.
+     * - `skills/` is a directory per skill with a `SKILL.md` entry, matching the default.
+     * - Pi has no agents or rules concept. The empty arrays are deliberate: they hold
+     *   those categories at zero rather than scanning a directory Pi never reads.
+     *
+     * `global` is the user's own Pi home rather than the agent dir CodeMie redirects Pi
+     * to (`<cwd>/.pi/codemie/agent`). That dir is a copy of this one plus CodeMie's own
+     * metrics extension, so counting it would report our plumbing as a user-authored hook.
+     */
+    extensionsConfig: {
+        project: '.pi',
+        global: '~/.pi/agent',
+        skillsEntryFile: 'SKILL.md',
+        dirNames: {
+            agents: [],
+            commands: ['prompts'],
+            skills: ['skills'],
+            hooks: ['extensions'],
+            rules: [],
+        },
+    },
+    /**
+     * MCP is not part of Pi core — Pi ships without it deliberately ("It intentionally
+     * does not include built-in MCP", Pi's `docs/usage.md`). It arrives through the
+     * `pi-mcp-adapter` package, which CodeMie installs for every managed Pi
+     * (`REQUIRED_PI_PACKAGES` in `pi.packages.ts`), so under CodeMie the adapter is
+     * effectively core and its servers are worth counting.
+     *
+     * The adapter merges six files, lowest precedence first: `~/.config/mcp/mcp.json`,
+     * `~/.agents/mcp.json`, `~/.agents/mcp/mcp.json`, `<agentDir>/mcp.json`,
+     * `<cwd>/.mcp.json`, `<cwd>/.pi/mcp.json`. Three scopes cannot hold six files, so the
+     * two project files map directly and the four global ones become ordered candidates —
+     * and note `readMCPFromSource` takes the first candidate that *parses*, it never
+     * merges.
+     *
+     * `user` names the redirected agent dir, and deliberately **not** the user's own
+     * `~/.pi/agent/mcp.json`. `beforeRun` always sets `PI_CODING_AGENT_DIR` to
+     * `<cwd>/.pi/codemie/agent` and the adapter resolves `<agentDir>/mcp.json` through that
+     * variable, so under CodeMie the home file is never one of the adapter's six sources.
+     * Listing it would report servers this Pi does not load: `preparePiAgentDir` copies once
+     * and returns early forever after, so a project whose copy predates the user's MCP setup
+     * never acquires an `mcp.json` — a permanent state, not a first-run one — while the home
+     * file keeps growing, because a bare `pi` writes precisely there. Worse, because
+     * `readMCPFromSource` returns on the first candidate that *parses*, that phantom would
+     * also hide `~/.agents/*` and `~/.config/mcp`, which the adapter genuinely does merge.
+     * (This is the opposite call from `extensionsConfig.global` above, which avoids the copy
+     * because CodeMie injects its own extension into it. Nothing injects MCP servers, so
+     * here the copy is simply the truth.)
+     *
+     * The invariant that buys: every server reported is one this run actually loads.
+     *
+     * Knowingly an approximation otherwise:
+     * - Under-counts the first run in a project, which reports zero user servers because the
+     *   copy is made in `beforeRun`, after `onSessionStart` has already sent the metric.
+     *   Self-healing from the second run on.
+     * - Over-counts a server named in two scopes. The adapter merges those into one live
+     *   server; `totalServers` sums the scopes, while `serverNames` stays deduplicated.
+     * - Under-counts every global file after the first that parses, the legacy
+     *   `mcp-servers` alias key, and any config written as true JSONC — the adapter strips
+     *   comments before parsing, `readJsonFile` does not.
+     * - Under-counts host-config imports (`hostConfigDiscovery: "on"`, or a per-file
+     *   `"imports"` array), which pull servers from Claude/Codex/Cursor/VS Code files.
+     *   Following a key into other files with other key names is beyond `navigateJsonPath`.
+     *   Both mechanisms are opt-in and default off.
+     *
+     * Every one of those failures is silent: a wrong path and a genuinely MCP-less machine
+     * are indistinguishable in the summary.
+     */
+    mcpConfig: {
+        local: {
+            path: '.pi/mcp.json',
+            jsonPath: 'mcpServers',
+        },
+        project: {
+            path: '.mcp.json',
+            jsonPath: 'mcpServers',
+        },
+        user: {
+            path: [
+                '.pi/codemie/agent/mcp.json',
+                '~/.agents/mcp/mcp.json',
+                '~/.agents/mcp.json',
+                '~/.config/mcp/mcp.json',
+            ],
+            jsonPath: 'mcpServers',
+        },
+    },
+    envMapping: {
+        baseUrl: [],
+        apiKey: [],
+        model: [],
+    },
+    supportedProviders: ['ai-run-sso', 'bearer-auth', 'litellm'],
+    ssoConfig: {
+        enabled: true,
+        clientType: 'codemie-pi',
+    },
+    /**
+     * `--task` must become `-p`, not a bare positional. Pi treats a positional as an
+     * opening prompt for an *interactive* session, so the TUI takes over the terminal
+     * and the run never exits — while `-p` is Pi's "process the prompt and exit" mode
+     * and consumes the argument that follows it as the prompt.
+     */
+    flagMappings: {
+        '--task': {
+            type: 'flag',
+            target: '-p',
+        },
+    },
+    lifecycle: {
+        async beforeRun(env, _config) {
+            const cwd = process.cwd();
+            await preparePiAgentDir(cwd);
+            await fetchAndBuildPiModels(env, cwd);
+            env.PI_CODING_AGENT_DIR = getPiAgentDir(cwd);
+            // Have Pi report which transcripts this run writes, instead of inferring them
+            // from the session directory after the fact. `preparePiAgentDir` skips the copy
+            // when the agent dir already exists, so this runs unconditionally to pick up
+            // asset changes after an upgrade.
+            const extension = await ensurePiCodeMieExtension(cwd, env);
+            if (extension.installed && env.CODEMIE_SESSION_ID) {
+                const ledgerPath = getPiRunLedgerPath(env.CODEMIE_SESSION_ID);
+                env[LEDGER_PATH_ENV] = ledgerPath;
+                process.env[LEDGER_PATH_ENV] = ledgerPath;
+            }
+            // Honor session-directory overrides early so both Pi and discovery agree.
+            const { sessionDir, isCustom } = resolvePiSessionDir(cwd, env);
+            if (isCustom) {
+                env.PI_CODING_AGENT_SESSION_DIR = sessionDir;
+                process.env.PI_CODING_AGENT_SESSION_DIR = sessionDir;
+            }
+            logger.debug('[pi] Configured PI_CODING_AGENT_DIR', { path: env.PI_CODING_AGENT_DIR });
+            return env;
+        },
+        enrichArgs(args, _config) {
+            const model = process.env.CODEMIE_MODEL;
+            if (!model) {
+                throw new Error('No model configured for codemie-pi. Run codemie setup to select a model.');
+            }
+            const classification = classifyPiModel(model);
+            const providerId = classification.provider;
+            // `--task` is not handled here: `flagMappings` rewrites it to Pi's `-p`, which
+            // BaseAgentAdapter applies after this hook. Consuming it here would leave a bare
+            // positional, and Pi treats a bare positional as an interactive opening prompt.
+            const result = ['--provider', providerId, '--model', model, ...args];
+            // Share CodeMie's session id with Pi so discovery can exact-match the
+            // transcript. Pi exits with code 1 if this is combined with a flag that
+            // already selects a session, so those runs correlate by run window instead.
+            const sessionId = process.env.CODEMIE_SESSION_ID;
+            if (sessionId && !result.includes('--session-id') && !hasSessionSelectionFlag(result)) {
+                result.push('--session-id', sessionId);
+            }
+            else if (sessionId) {
+                logger.debug('[pi] Skipping --session-id injection: argv already selects a session');
+            }
+            // Forward the effective session directory. beforeRun resolved it onto the run
+            // env, which BaseAgentAdapter has already merged into process.env. A
+            // user-supplied --session-dir is in argv already and takes precedence.
+            if (!result.includes('--session-dir') && process.env.PI_CODING_AGENT_SESSION_DIR) {
+                result.push('--session-dir', process.env.PI_CODING_AGENT_SESSION_DIR);
+            }
+            return result;
+        },
+        async onSessionStart(sessionId, env) {
+            try {
+                const { processEvent } = await import('../../../cli/commands/hook.js');
+                await processEvent({
+                    hook_event_name: 'SessionStart',
+                    session_id: sessionId,
+                    transcript_path: '',
+                    permission_mode: 'default',
+                    cwd: process.cwd(),
+                    source: 'startup',
+                }, buildPiHookConfig(env, sessionId));
+                logger.info(`[pi] SessionStart hook completed for session ${sessionId}`);
+            }
+            catch (error) {
+                const msg = error instanceof Error ? error.message : String(error);
+                logger.error(`[pi] SessionStart hook failed (non-blocking): ${msg}`);
+            }
+            // A run killed with SIGKILL, or whose terminal was closed, never reaches onSessionEnd and
+            // leaves its record `active` forever with no terminal metric. Recover those on the next
+            // start. Fire-and-forget: a stranded earlier session must not delay this one.
+            void reconcileStaleSessions('pi', env, buildPiHookConfig).catch((error) => {
+                const msg = error instanceof Error ? error.message : String(error);
+                logger.debug(`[pi] Stale-session reconciliation failed (non-blocking): ${msg}`);
+            });
+            // Flush metrics during the run, so a hard kill loses at most one interval instead of the
+            // whole session. Ledger-driven: it processes exactly the transcripts the extension
+            // recorded, never a directory scan.
+            startPiIncrementalSync({
+                sessionId,
+                metadata: PiPluginMetadata,
+                buildContext: () => ({
+                    sessionId,
+                    apiBaseUrl: env.CODEMIE_SYNC_API_URL || env.CODEMIE_BASE_URL || '',
+                    cookies: '',
+                    clientType: 'codemie-pi',
+                    version: env.CODEMIE_CLI_VERSION ?? '',
+                    dryRun: false,
+                }),
+                ssoUrl: env.CODEMIE_URL,
+                syncApiUrl: env.CODEMIE_SYNC_API_URL ?? env.CODEMIE_BASE_URL,
+                cliVersion: env.CODEMIE_CLI_VERSION,
+            });
+        },
+        async onSessionEnd(exitCode, env) {
+            const sessionId = env.CODEMIE_SESSION_ID;
+            if (!sessionId) {
+                logger.debug('[pi] No CODEMIE_SESSION_ID in environment, skipping session end');
+                return;
+            }
+            // Stop the mid-run flush FIRST, and wait for any tick already running: it appends to the
+            // same metrics JSONL this final flush is about to, and two writers that both read the
+            // existing record ids before either appends would upload every delta twice.
+            await stopPiIncrementalSync(sessionId);
+            // The extension recorded which transcripts this run wrote, from inside Pi.
+            // Nothing else is claimed: a transcript absent from the ledger belongs to
+            // another process, and uploading it would leak that session's prompts.
+            const ledger = await readPiRunLedger(sessionId);
+            // Slash commands never reach the transcript — Pi expands prompt templates into plain user
+            // text before persisting — so the ledger is their only record. Hand them to the adapter the
+            // hook pipeline will reach through the registry.
+            try {
+                const { AgentRegistry } = await import('../../registry.js');
+                const adapter = AgentRegistry.getAgent('pi')?.getSessionAdapter?.();
+                if (adapter instanceof PiSessionAdapter) {
+                    adapter.setLedgerInvocations({
+                        commandInvocations: ledger.commandInvocations,
+                        skillCommandInvocations: ledger.skillCommandInvocations,
+                    });
+                }
+            }
+            catch (error) {
+                const msg = error instanceof Error ? error.message : String(error);
+                logger.debug(`[pi] Could not attach ledger invocations (non-blocking): ${msg}`);
+            }
+            if (!ledger.loaded) {
+                logger.warn('[pi] The CodeMie run ledger is missing, so this run\'s transcripts cannot be '
+                    + 'identified. Reporting session lifecycle only — no tool metrics for this session.');
+            }
+            else if (ledger.transcripts.length === 0) {
+                logger.debug('[pi] Run produced no transcript (session ended before its first reply)');
+            }
+            await correlateRunToSession(sessionId, ledger);
+            const reason = env.CODEMIE_EXIT_SIGNAL
+                ? `signal(${env.CODEMIE_EXIT_SIGNAL})`
+                : exitCode === 0
+                    ? 'exit'
+                    : `exit(${exitCode})`;
+            try {
+                const { processEvent } = await import('../../../cli/commands/hook.js');
+                await processEvent({
+                    hook_event_name: 'SessionEnd',
+                    // Pi's own session id, so the backend joins on the agent's identity.
+                    session_id: ledger.piSessionId ?? sessionId,
+                    transcript_path: ledger.transcripts[0] ?? '',
+                    transcript_paths: ledger.transcripts.length > 0 ? ledger.transcripts : undefined,
+                    permission_mode: 'default',
+                    // `--session <path>` runs the whole session under the transcript's cwd.
+                    cwd: ledger.cwd ?? process.cwd(),
+                    reason,
+                }, buildPiHookConfig(env, sessionId));
+                logger.info(`[pi] SessionEnd hook completed for session ${sessionId}`);
+            }
+            catch (error) {
+                const msg = error instanceof Error ? error.message : String(error);
+                logger.error(`[pi] SessionEnd hook failed (non-blocking): ${msg}`);
+            }
+        },
+    },
+};
+export class PiPlugin extends BaseAgentAdapter {
+    sessionAdapter;
+    constructor() {
+        super(PiPluginMetadata);
+        this.sessionAdapter = new PiSessionAdapter(PiPluginMetadata);
+    }
+    getSessionAdapter() {
+        return this.sessionAdapter;
+    }
+    /**
+     * Translate CodeMie's session flags to Pi's and publish the argv-derived facts
+     * that `beforeRun` and `enrichArgs` need but cannot read from argv themselves.
+     */
+    async run(args, envOverrides, runOptions) {
+        const prepared = preparePiInvocation(args, envOverrides);
+        return super.run(prepared.args, prepared.envOverrides, runOptions);
+    }
+    async additionalInstallation(_options) {
+        await installRequiredPiPackages({ cliCommand: this.metadata.cliCommand });
+    }
+}
+//# sourceMappingURL=pi.plugin.js.map

package/dist/agents/plugins/pi/pi.plugin.js.map

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

package/dist/agents/plugins/pi/pi.session.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Pi Session Adapter
+ *
+ * Discovers and parses Pi JSONL session files, then runs the metrics processor.
+ */
+import type { SessionAdapter, ParsedSession, AggregatedResult, SessionDiscoveryOptions, SessionDescriptor } from '../../core/session/BaseSessionAdapter.js';
+import type { SessionProcessor, ProcessingContext } from '../../core/session/BaseProcessor.js';
+import type { AgentMetadata } from '../../core/types.js';
+export interface PiDiscoveryOptions extends SessionDiscoveryOptions {
+    /** Environment variables used to resolve Pi session-directory overrides. */
+    env?: NodeJS.ProcessEnv;
+}
+/** One transcript linked to a parsed session, as {@link ParsedSession.subagents} carries it. */
+type LinkedTranscript = NonNullable<ParsedSession['subagents']>[number];
+/**
+ * `subagents[].agentType` for a nested sub-agent run: a delegated agent Pi ran under this
+ * transcript, stored at `<transcript-without-.jsonl>/<agentId>/run-N/session.jsonl`.
+ */
+export declare const PI_SUBAGENT_RUN = "pi-subagent-run";
+/**
+ * `subagents[].agentType` for a transcript that CONTINUED this one (`/fork`, `/branch`).
+ * Its inherited entries are byte-identical copies of this transcript's, ids included, so
+ * consumers must fold it in by entry identity rather than concatenating blindly.
+ *
+ * Never attached by this adapter — see {@link PiSessionAdapter.loadSubagentRuns} for why folding
+ * a fork family is the analytics layer's job. `native-loader.ts` attaches it.
+ */
+export declare const PI_FORKED_CONTINUATION = "pi-forked-continuation";
+/** The transcripts that continued `parsed` via `/fork` or `/branch`, in discovery order. */
+export declare function piForkedContinuations(parsed: ParsedSession): LinkedTranscript[];
+import { type PiLedgerInvocations } from './session/processors/pi.metrics-processor.js';
+export declare class PiSessionAdapter implements SessionAdapter {
+    private readonly metadata;
+    readonly agentName = "pi";
+    private processors;
+    constructor(metadata: AgentMetadata);
+    private initializeProcessors;
+    /**
+     * Supply the run-ledger counts the metrics processor cannot derive from a transcript.
+     *
+     * Pi expands a prompt template into plain user text before persisting it, so `/review` never
+     * appears in the JSONL — the only record of it is the ledger the CodeMie extension wrote
+     * (`pi.extension.ts`). The processing pipeline reaches this adapter through the registry
+     * singleton, and `ProcessingContext` is shared by every agent, so the counts are handed over
+     * here rather than threaded through a field only Pi would ever read.
+     */
+    setLedgerInvocations(ledgerInvocations: PiLedgerInvocations | undefined): void;
+    registerProcessor(processor: SessionProcessor): void;
+    parseSessionFile(filePath: string, sessionId: string): Promise<ParsedSession>;
+    /**
+     * Nested sub-agent transcripts, stored under `<transcript-without-.jsonl>/<agentId>/run-N/`.
+     *
+     * A delegated agent gets its own session file there. The parent records tool results for those
+     * dispatches but NO usage on them (measured on a real corpus: 1707 `toolResult` entries, zero
+     * carrying `usage`), so every token a sub-agent burned lives only in the nested file and a
+     * reader that walks `messages` alone misses all of it.
+     *
+     * Attached WITHOUT a `toolUseId`: this is session-level spend, not the allocation of one
+     * dispatch, and `cost-enricher.enrichDispatchCosts` keys on `toolUseId` precisely so it skips
+     * these.
+     *
+     * **Forked continuations are deliberately NOT linked here.** `/fork` writes a new file that
+     * replays the prior conversation verbatim, so folding it into its source looks tempting — but
+     * `codemie pi --fork` is a second MANAGED run with a CodeMie session of its own, and the cost
+     * enricher walks sessions in `startTime` order against a shared `seen` set. Anything attached
+     * to the earlier session's transcript is consumed by the earlier session, so the forked run
+     * reports as free and its spend lands on the wrong session, date and branch. Collapsing a fork
+     * family is the analytics layer's job, where the set of sessions being reported is known;
+     * `native-loader.ts` does it for untracked runs.
+     *
+     * This is identity, not attribution: a directory Pi named after this transcript. Nothing here
+     * guesses ownership from mtime, id shape, or timing — see {@link discoverSessions}.
+     */
+    private loadSubagentRuns;
+    private static readonly HEADER_READ_BYTES;
+    private readSessionHeader;
+    private readJsonlFile;
+    processSession(filePath: string, sessionId: string, context: ProcessingContext): Promise<AggregatedResult>;
+    /**
+     * Enumerate the Pi transcripts visible from this project.
+     *
+     * This is a plain listing, and deliberately so: it answers "which Pi transcripts
+     * exist here", never "which of them belong to the run that just finished".
+     *
+     * That second question cannot be answered from a directory. A concurrent `pi` — or
+     * a second CodeMie run in the same cwd — writes files indistinguishable from this
+     * run's by id, mtime, or `parentSession` lineage, and claiming one of them uploads
+     * a stranger's prompts and tool output under this user's session. Successive
+     * rounds of increasingly careful heuristics here were each shown to be reachable-
+     * wrong, so ownership is no longer inferred at all: the CodeMie extension records
+     * each transcript path from inside Pi, and `readPiRunLedger` reads it back.
+     *
+     * Scope follows the caller. With a `cwd`, the listing is that project's: the transcripts in
+     * that project's session directory whose own header declares that cwd — what a managed run
+     * needs. Without one, the listing is every project's, because that is what analytics needs:
+     * Claude and Codex discovery is global, so a cwd-scoped Pi would report zero usage whenever
+     * `codemie analytics` is run from anywhere but the project directory.
+     *
+     * @see pi.extension.ts
+     */
+    discoverSessions(options?: SessionDiscoveryOptions): Promise<SessionDescriptor[]>;
+    /**
+     * Every transcript in `sessionDir` recent enough to matter, optionally narrowed to one project.
+     *
+     * A session directory can be shared between projects (`--session-dir`, or a
+     * `sessionDir` in the project's `.pi/settings.json`), so when a `projectPath` is
+     * given each file's own header must declare that cwd. Filtering is on mtime rather
+     * than header timestamp so a long-running session is not dropped while it is still
+     * being written to.
+     */
+    private listTranscripts;
+}
+export {};
+//# sourceMappingURL=pi.session.d.ts.map

package/dist/agents/plugins/pi/pi.session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi.session.d.ts","sourceRoot":"","sources":["../../../../src/agents/plugins/pi/pi.session.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAC5J,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAC/F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIzD,MAAM,WAAW,kBAAmB,SAAQ,uBAAuB;IACjE,4EAA4E;IAC5E,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,gGAAgG;AAChG,KAAK,gBAAgB,GAAG,WAAW,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,eAAe,oBAAoB,CAAC;AAEjD;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,2BAA2B,CAAC;AAE/D,4FAA4F;AAC5F,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,gBAAgB,EAAE,CAE/E;AAiDD,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,8CAA8C,CAAC;AAItD,qBAAa,gBAAiB,YAAW,cAAc;IAIzC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAHrC,QAAQ,CAAC,SAAS,QAAQ;IAC1B,OAAO,CAAC,UAAU,CAA0B;gBAEf,QAAQ,EAAE,aAAa;IAIpD,OAAO,CAAC,oBAAoB;IAM5B;;;;;;;;OAQG;IACH,oBAAoB,CAAC,iBAAiB,EAAE,mBAAmB,GAAG,SAAS,GAAG,IAAI;IAK9E,iBAAiB,CAAC,SAAS,EAAE,gBAAgB,GAAG,IAAI;IAM9C,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA2BnF;;;;;;;;;;;;;;;;;;;;;;;OAuBG;YACW,gBAAgB;IAyC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAS;YAEpC,iBAAiB;YAuBjB,aAAa;IAoBrB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA4ChH;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,gBAAgB,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAuBvF;;;;;;;;OAQG;YACW,eAAe;CAqD9B"}