@codemem/pi-extension 0.46.0-rc.3 → 0.46.0

package/dist/inject.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Cache-stable memory injection for pi's `context` event.
+ *
+ * Replays the exact framed bytes already decided for older user messages and
+ * fetches at most one new pack for the latest undecided user message, appending
+ * the block to that message only. Mutates the request copy in place and never
+ * returns anything — a context handler that returns { messages } drops system
+ * messages on Pi 0.84 and collapses them mid-conversation on Pi 0.87.
+ *
+ * Decisions live in memory for this extension instance only. A restart starts
+ * with an empty cache and is not cache-safe; older messages replay again only
+ * after new decisions build up.
+ */
+import type { PiCodememClient } from "./client.js";
+import type { PiExtensionConfig } from "./config.js";
+/** Structural view of a pi AgentMessage (pi-agent-core types are not a dependency). */
+export type PiContextMessage = {
+    role?: unknown;
+    content?: unknown;
+    timestamp?: unknown;
+};
+export type PiInjector = {
+    /** Mutates the given request-copy messages in place; returns nothing. */
+    inject(messages: PiContextMessage[], signal?: AbortSignal): Promise<void>;
+    /**
+     * One-shot replay skip. Arm only after session_compact with willRetry.
+     * The next inject replays and does not fetch.
+     */
+    noteCompaction(): void;
+    /** Drop a replay skip that will not be the immediate resume. */
+    clearCompaction(): void;
+    /** Re-key decision identity on session_start. */
+    rekey(sessionId: string): void;
+};
+export declare function createPiInjector(options: {
+    client: PiCodememClient;
+    config: PiExtensionConfig;
+    /**
+     * Timestamp when the message has one. When it does not, a fresh id that is
+     * not the ingest counter, so a missing timestamp is not cached.
+     */
+    discriminator: (message: PiContextMessage) => string | number;
+}): PiInjector;
+//# sourceMappingURL=inject.d.ts.map

package/dist/inject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject.d.ts","sourceRoot":"","sources":["../src/inject.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AASrD,uFAAuF;AACvF,MAAM,MAAM,gBAAgB,GAAG;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACxB,yEAAyE;IACzE,MAAM,CAAC,QAAQ,EAAE,gBAAgB,EAAE,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E;;;OAGG;IACH,cAAc,IAAI,IAAI,CAAC;IACvB,gEAAgE;IAChE,eAAe,IAAI,IAAI,CAAC;IACxB,iDAAiD;IACjD,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,CAAC;AAgOF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IACzC,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,iBAAiB,CAAC;IAC1B;;;OAGG;IACH,aAAa,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,MAAM,GAAG,MAAM,CAAC;CAC9D,GAAG,UAAU,CAiEb"}

package/dist/plugin-log.d.ts

@@ -0,0 +1,11 @@
+export declare function pluginLogPath(): string;
+/** `inject.pack.ok source=pi` line previously written only by `pi-hook-inject`. */
+export declare function logPiInjectPack(fields: {
+    origin: "local" | "viewer";
+    items: number;
+    packTokens: number;
+    queryLen: number;
+    empty: boolean;
+    project: string | null;
+}): void;
+//# sourceMappingURL=plugin-log.d.ts.map

package/dist/plugin-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-log.d.ts","sourceRoot":"","sources":["../src/plugin-log.ts"],"names":[],"mappings":"AAkBA,wBAAgB,aAAa,IAAI,MAAM,CAKtC;AAED,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,MAAM,EAAE;IACvC,MAAM,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,GAAG,IAAI,CAkBP"}

package/dist/viewer.d.ts

@@ -53,8 +53,38 @@ export declare function viewerRequestTarget(cwd: string, env?: NodeJS.ProcessEnv
     };
 };
 export declare function isViewerTargetConflict(status: number, body: unknown): boolean;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+/** Renderer-owned pack item spans (core PackResponse.rendered_items). */
+export type RenderedPackItem = {
+    id: number;
+    fingerprint: string;
+    spans: Array<{
+        start: number;
+        end: number;
+    }>;
+};
+/** Successful proven pack body; null when unproven, failing, or non-JSON. */
+export type ProvenPack = {
+    packText: string;
+    /** Present only when the response carried renderer span data. */
+    renderedItems?: RenderedPackItem[];
+    /** metrics.total_items from the same response. */
+    itemCount?: number;
+    /** metrics.pack_tokens from the same response, when present. */
+    packTokens?: number;
+};
 export declare function profileMatchesViewerTarget(profile: unknown, dbPath: string, identity: unknown): boolean;
-/** GET /api/prompt-pack-profile, then POST /api/pack with db_path + identity_target. */
+/**
+ * PackResponse contract check. A valid zero-item pack has a string `pack_text`
+ * and numeric `metrics.total_items` (0 is success). `{}`, a non-string `pack_text`,
+ * a missing item count, a non-array `rendered_items`, or an `error` field is not a pack.
+ */
+export declare function parseProvenPack(body: unknown): ProvenPack | null;
+/**
+ * GET /api/prompt-pack-profile, then POST /api/pack with db_path + identity_target.
+ * Returns a contract-valid pack, including a zero-item pack; null means unproven,
+ * failed, or a body that is not a PackResponse, and the caller may fall back.
+ */
 export declare function proveAndPostPack(config: PiExtensionConfig, args: {
     context: string;
     cwd: string;
@@ -62,7 +92,7 @@ export declare function proveAndPostPack(config: PiExtensionConfig, args: {
     signal: AbortSignal;
     limit?: number;
     tokenBudget?: number;
-}): Promise<string>;
+}): Promise<ProvenPack | null>;
 /** Probe viewer with a cheap GET. Returns true when reachable. */
 export declare function probeViewer(config: PiExtensionConfig, signal?: AbortSignal): Promise<boolean>;
 /**

package/dist/viewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"viewer.d.ts","sourceRoot":"","sources":["../src/viewer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"viewer.d.ts","sourceRoot":"","sources":["../src/viewer.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codemem/pi-extension",
-  "version": "0.46.0-rc.3",
+  "version": "0.46.0",
   "description": "CodeMem extension for the pi coding agent — ingest, injection, and native memory tools",
   "type": "module",
   "main": "./dist/index.js",
@@ -22,7 +22,7 @@
     "typebox": "*"
   },
   "devDependencies": {
-    "@codemem/core": "^0.46.0-rc.3",
+    "@codemem/core": "^0.46.0",
     "@earendil-works/pi-coding-agent": "^0.84.1",
     "@types/node": "^24.12.4",
     "typebox": "^1.3.7",