@codemieai/code 0.12.0 → 0.13.0

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."
+}

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

@@ -0,0 +1,3 @@
+export { PiPlugin, PiPluginMetadata } from './pi.plugin.js';
+export { PiSessionAdapter } from './pi.session.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/agents/plugins/pi/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

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

@@ -0,0 +1,3 @@
+export { PiPlugin, PiPluginMetadata } from './pi.plugin.js';
+export { PiSessionAdapter } from './pi.session.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/agents/plugins/pi/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

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

@@ -0,0 +1,60 @@
+/**
+ * Materializes the CodeMie run-ledger extension into Pi's agent directory, and
+ * reads back the ledger it produces.
+ *
+ * The ledger replaces post-hoc transcript attribution: instead of scanning Pi's
+ * session directory afterwards and inferring which files this run wrote, the
+ * extension records each transcript from inside Pi as it is opened. See
+ * `extension/README.md` for why, and for the constraints the asset operates under.
+ */
+/** Absolute ledger path, handed to the extension so it holds no layout assumptions. */
+export declare const LEDGER_PATH_ENV = "CODEMIE_PI_LEDGER";
+export interface PiExtensionStatus {
+    installed: boolean;
+    path?: string;
+    reason?: 'disabled' | 'source-missing' | 'selftest-failed' | 'write-failed';
+}
+export interface PiRunLedger {
+    /** True when the extension ran at all. False means the run produced no attributable data. */
+    loaded: boolean;
+    /** Transcripts this run wrote, deduped, existence-filtered, in first-seen order. */
+    transcripts: string[];
+    /** The last transcript the run was writing — the one to correlate the session record to. */
+    primaryTranscript?: string;
+    /** Pi's own session id for `primaryTranscript`. */
+    piSessionId?: string;
+    /** The transcript's cwd, which `--session <path>` makes differ from the launch cwd. */
+    cwd?: string;
+    /** `/name` prompt-template invocations, which never reach the transcript. */
+    commandInvocations: Record<string, number>;
+    /** `/skill:name` invocations, corroborating the transcript's `<skill>` wrapper. */
+    skillCommandInvocations: Record<string, number>;
+}
+/**
+ * `~/.codemie/sessions/{sessionId}_pi-run.jsonl`, beside the metrics and conversation
+ * JSONL files. The `.jsonl` suffix keeps it clear of every consumer that enumerates
+ * session records, all of which filter on `.json`.
+ */
+export declare function getPiRunLedgerPath(sessionId: string): string;
+/**
+ * Copy the extension into Pi's agent dir, then prove it loads.
+ *
+ * Pi turns any extension load failure into `process.exit(1)`, so a corrupted or
+ * truncated asset would kill the user's session rather than merely lose metrics.
+ * The pre-flight import below is the same check Pi performs (`typeof factory ===
+ * 'function'`); failing it here deletes the copy, so Pi never sees it.
+ *
+ * Never throws: every failure degrades to `{installed: false}`.
+ */
+export declare function ensurePiCodeMieExtension(cwd?: string, env?: NodeJS.ProcessEnv, sourceDir?: string): Promise<PiExtensionStatus>;
+/**
+ * Read the ledger the extension wrote during the run.
+ *
+ * Malformed lines are skipped individually rather than failing the read — a
+ * truncated final line after a hard kill must not discard the records before it.
+ * Transcript paths are existence-filtered because `getSessionFile()` reports the
+ * path Pi *plans* to write, and Pi does not create the file until the session holds
+ * an assistant message.
+ */
+export declare function readPiRunLedger(sessionId: string): Promise<PiRunLedger>;
+//# sourceMappingURL=pi.extension.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pi.extension.d.ts","sourceRoot":"","sources":["../../../../src/agents/plugins/pi/pi.extension.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAiBH,uFAAuF;AACvF,eAAO,MAAM,eAAe,sBAAsB,CAAC;AAEnD,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,UAAU,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,cAAc,CAAC;CAC7E;AAED,MAAM,WAAW,WAAW;IAC1B,6FAA6F;IAC7F,MAAM,EAAE,OAAO,CAAC;IAChB,oFAAoF;IACpF,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,4FAA4F;IAC5F,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uFAAuF;IACvF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,mFAAmF;IACnF,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE5D;AAMD;;;;;;;;;GASG;AACH,wBAAsB,wBAAwB,CAC5C,GAAG,GAAE,MAAsB,EAC3B,GAAG,GAAE,MAAM,CAAC,UAAwB,EAGpC,SAAS,GAAE,MAAuD,GACjE,OAAO,CAAC,iBAAiB,CAAC,CA0C5B;AAkDD;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAiE7E"}

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

@@ -0,0 +1,201 @@
+/**
+ * Materializes the CodeMie run-ledger extension into Pi's agent directory, and
+ * reads back the ledger it produces.
+ *
+ * The ledger replaces post-hoc transcript attribution: instead of scanning Pi's
+ * session directory afterwards and inferring which files this run wrote, the
+ * extension records each transcript from inside Pi as it is opened. See
+ * `extension/README.md` for why, and for the constraints the asset operates under.
+ */
+import { createHash } from 'crypto';
+import { existsSync } from 'fs';
+import { mkdir, readFile, readdir, rm, writeFile } from 'fs/promises';
+import { join } from 'path';
+import { pathToFileURL } from 'url';
+import { logger } from '../../../utils/logger.js';
+import { getCodemiePath, getDirname } from '../../../utils/paths.js';
+import { getPiAgentDir } from './pi.paths.js';
+/** Directory name under `<piAgentDir>/extensions/` that holds the materialized asset. */
+const EXTENSION_DIR_NAME = 'codemie-metrics';
+/** Set to `1` to skip installation entirely and remove any previously installed copy. */
+const DISABLE_ENV = 'CODEMIE_PI_EXTENSION_DISABLED';
+/** Absolute ledger path, handed to the extension so it holds no layout assumptions. */
+export const LEDGER_PATH_ENV = 'CODEMIE_PI_LEDGER';
+/**
+ * `~/.codemie/sessions/{sessionId}_pi-run.jsonl`, beside the metrics and conversation
+ * JSONL files. The `.jsonl` suffix keeps it clear of every consumer that enumerates
+ * session records, all of which filter on `.json`.
+ */
+export function getPiRunLedgerPath(sessionId) {
+    return getCodemiePath('sessions', `${sessionId}_pi-run.jsonl`);
+}
+function emptyLedger() {
+    return { loaded: false, transcripts: [], commandInvocations: {}, skillCommandInvocations: {} };
+}
+/**
+ * Copy the extension into Pi's agent dir, then prove it loads.
+ *
+ * Pi turns any extension load failure into `process.exit(1)`, so a corrupted or
+ * truncated asset would kill the user's session rather than merely lose metrics.
+ * The pre-flight import below is the same check Pi performs (`typeof factory ===
+ * 'function'`); failing it here deletes the copy, so Pi never sees it.
+ *
+ * Never throws: every failure degrades to `{installed: false}`.
+ */
+export async function ensurePiCodeMieExtension(cwd = process.cwd(), env = process.env, 
+// Defaulted rather than resolved inline so the self-test failure path — the one
+// that stands between a corrupted asset and `pi` exiting 1 — is reachable in tests.
+sourceDir = join(getDirname(import.meta.url), 'extension')) {
+    const targetDir = join(getPiAgentDir(cwd), 'extensions', EXTENSION_DIR_NAME);
+    if (env[DISABLE_ENV] === '1') {
+        await removeExtension(targetDir);
+        return { installed: false, reason: 'disabled' };
+    }
+    try {
+        const files = await readSourceFiles(sourceDir);
+        if (!files) {
+            logger.debug(`[pi-extension] Source assets not found at ${sourceDir}; run ledger disabled`);
+            return { installed: false, reason: 'source-missing' };
+        }
+        await mkdir(targetDir, { recursive: true });
+        for (const [name, content] of Object.entries(files)) {
+            const targetPath = join(targetDir, name);
+            // Rewrite only on change: an untouched mtime keeps Pi's `/reload` quiet and
+            // avoids churn in a directory the user may be watching.
+            if (await fileMatches(targetPath, content))
+                continue;
+            await writeFile(targetPath, content, 'utf-8');
+        }
+        const entryPath = join(targetDir, 'index.js');
+        if (!(await exportsFactory(entryPath, files['index.js']))) {
+            await removeExtension(targetDir);
+            logger.warn('[pi-extension] Run-ledger extension failed its load self-test and was removed. '
+                + 'Pi will start normally; this run will report no tool metrics.');
+            return { installed: false, reason: 'selftest-failed' };
+        }
+        logger.debug(`[pi-extension] Run ledger installed at ${targetDir}`);
+        return { installed: true, path: targetDir };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.warn(`[pi-extension] Could not install the run-ledger extension: ${message}`);
+        await removeExtension(targetDir);
+        return { installed: false, reason: 'write-failed' };
+    }
+}
+/** Read every asset the extension directory ships. Returns undefined when it is absent. */
+async function readSourceFiles(sourceDir) {
+    if (!existsSync(sourceDir))
+        return undefined;
+    const files = {};
+    for (const name of await readdir(sourceDir)) {
+        // README.md is documentation for maintainers, not part of what Pi loads.
+        if (name !== 'index.js' && name !== 'package.json')
+            continue;
+        files[name] = await readFile(join(sourceDir, name), 'utf-8');
+    }
+    return files['index.js'] && files['package.json'] ? files : undefined;
+}
+async function fileMatches(path, content) {
+    try {
+        return (await readFile(path, 'utf-8')) === content;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Import the materialized copy and check it exports a factory function, matching
+ * Pi's own acceptance test. The content hash busts Node's module cache so a
+ * rewritten asset is re-checked rather than resolved to the previous version.
+ */
+async function exportsFactory(entryPath, content) {
+    try {
+        const cacheKey = createHash('sha1').update(content).digest('hex').slice(0, 12);
+        const module = (await import(`${pathToFileURL(entryPath).href}?v=${cacheKey}`));
+        return typeof module.default === 'function';
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.debug(`[pi-extension] Self-test import failed: ${message}`);
+        return false;
+    }
+}
+async function removeExtension(targetDir) {
+    try {
+        await rm(targetDir, { recursive: true, force: true });
+    }
+    catch {
+        // Leaving a stale copy is survivable; failing the run is not.
+    }
+}
+/**
+ * Read the ledger the extension wrote during the run.
+ *
+ * Malformed lines are skipped individually rather than failing the read — a
+ * truncated final line after a hard kill must not discard the records before it.
+ * Transcript paths are existence-filtered because `getSessionFile()` reports the
+ * path Pi *plans* to write, and Pi does not create the file until the session holds
+ * an assistant message.
+ */
+export async function readPiRunLedger(sessionId) {
+    const ledger = emptyLedger();
+    const ledgerPath = getPiRunLedgerPath(sessionId);
+    let raw;
+    try {
+        raw = await readFile(ledgerPath, 'utf-8');
+    }
+    catch {
+        logger.debug(`[pi-extension] No run ledger at ${ledgerPath}`);
+        return ledger;
+    }
+    const seen = new Set();
+    for (const line of raw.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        let record;
+        try {
+            record = JSON.parse(trimmed);
+        }
+        catch {
+            continue;
+        }
+        switch (record.t) {
+            case 'boot':
+                ledger.loaded = true;
+                break;
+            case 'session':
+            case 'shutdown': {
+                // The last record wins for cwd and identity: a run that forked or switched
+                // sessions ends attached to the file it was writing when it stopped.
+                if (typeof record.cwd === 'string' && record.cwd)
+                    ledger.cwd = record.cwd;
+                const file = record.file;
+                if (typeof file !== 'string' || !file || !existsSync(file))
+                    break;
+                if (!seen.has(file)) {
+                    seen.add(file);
+                    ledger.transcripts.push(file);
+                }
+                ledger.primaryTranscript = file;
+                ledger.piSessionId = typeof record.piSessionId === 'string' ? record.piSessionId : undefined;
+                break;
+            }
+            case 'cmd': {
+                const name = record.name;
+                if (typeof name !== 'string' || !name)
+                    break;
+                const target = record.kind === 'skill' ? ledger.skillCommandInvocations : ledger.commandInvocations;
+                target[name] = (target[name] ?? 0) + 1;
+                break;
+            }
+            default:
+                break;
+        }
+    }
+    logger.debug(`[pi-extension] Ledger for ${sessionId}: loaded=${ledger.loaded}, `
+        + `${ledger.transcripts.length} transcript(s), cwd=${ledger.cwd ?? 'unset'}`);
+    return ledger;
+}
+//# sourceMappingURL=pi.extension.js.map

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

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

package/dist/agents/plugins/pi/pi.incremental-sync.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Pi Incremental Sync Timer
+ *
+ * Pi has no hook surface that fires mid-run, so without this timer a session's
+ * metrics exist only in memory until `onSessionEnd` flushes them. A SIGKILL, a
+ * closed terminal, or an OS shutdown therefore loses the entire run. Ticking every
+ * ~30 s writes per-record metric deltas to JSONL and uploads whatever is PENDING,
+ * so at most one interval's worth of work is ever at risk.
+ *
+ * Which transcripts to process is read from the run ledger the CodeMie extension
+ * writes from inside Pi — never inferred from the session directory. A directory
+ * listing cannot tell this run's transcripts from a concurrent `pi`'s, and claiming
+ * one uploads a stranger's prompts under this user's identity.
+ *
+ * @see pi.extension.ts
+ */
+import type { ProcessingContext } from '../../../agents/core/session/BaseProcessor.js';
+import type { SessionAdapter } from '../../../agents/core/session/BaseSessionAdapter.js';
+import type { AgentMetadata } from '../../../agents/core/types.js';
+export interface StartPiIncrementalSyncOptions {
+    /** CodeMie session id — names both the ledger and the metric JSONL files. */
+    sessionId: string;
+    /** Pi agent metadata, used to build the default session adapter. */
+    metadata: AgentMetadata;
+    /** Builds a fresh ProcessingContext on each tick (cookies/version may rotate). */
+    buildContext: () => ProcessingContext;
+    /** CodeMie SSO URL used to load stored credentials (e.g. env.CODEMIE_URL). */
+    ssoUrl?: string;
+    /** Sync API base URL for the upload context (env.CODEMIE_SYNC_API_URL ?? env.CODEMIE_BASE_URL). */
+    syncApiUrl?: string;
+    /** CLI version string forwarded to the upload context. */
+    cliVersion?: string;
+    /** Overrides the default and the env interval. Injected by tests. */
+    intervalMs?: number;
+    /** Overrides the default `PiSessionAdapter`. Injected by tests. */
+    adapter?: SessionAdapter;
+}
+export declare function startPiIncrementalSync(options: StartPiIncrementalSyncOptions): void;
+/**
+ * Stop ticking and wait — for a bounded time — on a tick that is already running.
+ *
+ * The wait is the point. `clearInterval` cancels the *schedule*, not the tick already
+ * executing, and the caller's next move is the end-of-session flush over the same
+ * `{sessionId}_metrics.jsonl`. Both read the file's record ids before either appends, so
+ * an overlap appends the same deltas twice — and the sync path uploads pending records
+ * without deduplicating them by record id.
+ *
+ * The bound is the point too. This runs on the way out of the CLI, and the tick's upload
+ * is a 30 s API timeout over three attempts *per batch*: waiting it out would hang the
+ * exit for minutes whenever the sync host black-holes traffic. So the tick is first told
+ * to skip its upload — the phase that can take minutes and that appends nothing — and only
+ * the remainder is awaited, under {@link STOP_DRAIN_TIMEOUT_MS}.
+ *
+ * If the bound expires the tick was already mid-upload, and the hazard accepted is the
+ * inverse of the double-append: `MetricsSyncProcessor` finishes by rewriting the whole
+ * metrics file from the snapshot it read, so deltas the session-end flush appends in the
+ * meantime can be dropped. One truncated shutdown is the price of never hanging every
+ * user whose network is down.
+ */
+export declare function stopPiIncrementalSync(sessionId: string, 
+/** Overrides {@link STOP_DRAIN_TIMEOUT_MS}. Injected by tests. */
+drainTimeoutMs?: number): Promise<void>;
+//# sourceMappingURL=pi.incremental-sync.d.ts.map

package/dist/agents/plugins/pi/pi.incremental-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi.incremental-sync.d.ts","sourceRoot":"","sources":["../../../../src/agents/plugins/pi/pi.incremental-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAC;AAClF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAM5D,MAAM,WAAW,6BAA6B;IAC5C,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,QAAQ,EAAE,aAAa,CAAC;IACxB,kFAAkF;IAClF,YAAY,EAAE,MAAM,iBAAiB,CAAC;IACtC,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mGAAmG;IACnG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AA2BD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,6BAA6B,GAAG,IAAI,CAyBnF;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM;AACjB,kEAAkE;AAClE,cAAc,GAAE,MAA8B,GAC7C,OAAO,CAAC,IAAI,CAAC,CAgBf"}