@hypercarrier/rarebit 0.1.0-alpha.4 → 0.1.0-alpha.5

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.1.0-alpha.5 — 2026-08-16
+
+- Repair Pi 0.84.2 Summary calls to use the active Pi model runtime. The
+  injected Pi AI completion path remains the Pi 0.83.0 fallback.
+- Declare the unbounded Pi AI peer range from Pi 0.83.0. The release gate runs
+  Recall against Pi 0.83.0 and Pi 0.84.2.
+
+This is an unpublished local release candidate. Intended npm routing after
+publication is `next=alpha.5` and `latest=alpha.4`.
+
 ## 0.1.0-alpha.4 — 2026-08-02
 
 Alpha.4 is a new artifact with a sanitized current source lineage and unchanged
@@ -7,7 +17,7 @@ product capability from the alpha.3 cutoff tree `db7d388`. The old tag graphs
 remain public and are not privacy-clean. All existing alpha.1, alpha.2, and
 alpha.3 tags, releases, and npm artifacts remain immutable (there is no alpha.1
 GitHub Release). Alpha.3 remains the original readable-Recall release. Intended
-npm routing after publication is `next=alpha.4` and `latest=alpha.1`.
+npm routing after publication is `next=alpha.4` and `latest=alpha.4`.
 The source-only machine-readable candidate derivation and vendored-scanner
 binding is [`release/privacy-lineage.v1.json`](release/privacy-lineage.v1.json).
 It is excluded from npm and does not claim publication completion.

package/README.md

@@ -10,22 +10,24 @@ and visual language can change. It is not a Task, Project, runtime, priority,
 attention, or delivery authority. Native Pi Session JSONL remains the evidence
 authority.
 
-Alpha.4 is a new artifact with a sanitized current source lineage. Product
-capability is unchanged from the alpha.3 cutoff tree `db7d388`. The old tag
-graphs remain public and are not privacy-clean. All existing alpha.1, alpha.2,
-and alpha.3 tags, releases, and npm artifacts remain immutable (there is no
-alpha.1 GitHub Release). Alpha.3 remains the original readable-Recall release.
-Intended npm routing after publication is `next=alpha.4` and `latest=alpha.1`.
-The source-only machine-readable candidate derivation and vendored-scanner
-binding is [`release/privacy-lineage.v1.json`](release/privacy-lineage.v1.json).
-It is excluded from npm and does not claim publication completion.
+Alpha.5 is an unpublished local candidate that repairs Pi 0.84.2 Summary
+calls by using the active Pi model runtime. The injected Pi AI completion path
+remains the fallback for hosts without that runtime registry. Intended npm
+routing after publication is `next=alpha.5` and `latest=alpha.4`.
+
+The old alpha.1, alpha.2, and alpha.3 tag graphs remain public and are not
+privacy-clean. Existing alpha.1 through alpha.4 tags, releases, and npm
+artifacts remain immutable. The source-only candidate derivation and
+vendored-scanner binding is
+[`release/privacy-lineage.v1.json`](release/privacy-lineage.v1.json). It is
+excluded from npm and does not claim publication completion.
 
 ## Install
 
 Use Node 22 or later and Pi 0.83 or later. Install it in Pi from npm:
 
 ```sh
-pi install npm:@hypercarrier/rarebit@0.1.0-alpha.4
+pi install npm:@hypercarrier/rarebit@0.1.0-alpha.5
 pi list
 ```
 
@@ -44,7 +46,7 @@ To use the CLI in a normal Node project, install it and invoke the local bin
 with npm:
 
 ```sh
-npm install @hypercarrier/rarebit@0.1.0-alpha.4
+npm install @hypercarrier/rarebit@0.1.0-alpha.5
 npm exec -- rarebit --help
 ```
 
@@ -128,14 +130,14 @@ sensitive. Do not put their paths or content in a ticket.
 Pin alpha versions for reproducible installs:
 
 ```sh
-pi install npm:@hypercarrier/rarebit@0.1.0-alpha.4
+pi install npm:@hypercarrier/rarebit@0.1.0-alpha.5
 pi remove npm:@hypercarrier/rarebit
 ```
 
 The exact-version install also moves an existing Rarebit npm installation to
 that pin. Pi skips versioned npm sources during package updates. Do not use an
-unpinned source for alpha.4 recovery: unpinned npm resolution follows the
-retained `latest`, which remains alpha.1.
+unpinned source for alpha.5 recovery: unpinned npm resolution follows the
+retained `latest`, which remains alpha.4.
 
 To roll back, reinstall a known version with `pi install npm:@hypercarrier/rarebit@<version>`.
 Removal stops package loading. It does not alter Pi Session JSONL or delete
@@ -144,9 +146,11 @@ only after you review it.
 
 ## Compatibility and support
 
-This alpha supports Node 22+ and Pi 0.83+. It works as a deterministic CLI
-without a model. Summary, Title, and the Pi extension require a compatible Pi
-installation and configured provider credentials.
+This alpha supports Node 22+ and Pi 0.83.0 or later. Its Pi AI peer has no
+upper bound. The release gate runs Recall against Pi 0.83.0 and Pi 0.84.2. It
+works as a deterministic CLI without a model. Summary, Title, and the Pi
+extension require a compatible Pi installation and configured provider
+credentials.
 
 Report security issues privately as described in [SECURITY.md](SECURITY.md).
 Use https://github.com/deephbz/rarebit/issues for normal support. Include no

package/RUNBOOK.md

@@ -1,19 +1,20 @@
 # Rarebit runbook
 
-This runbook applies to `0.1.0-alpha.4`. Operational behavior, including
-readable Markdown Recall, is unchanged from alpha.3; see [CHANGELOG.md](CHANGELOG.md)
-for sanitized-lineage and release-routing details.
+This runbook applies to `0.1.0-alpha.5`. This candidate repairs Pi 0.84.2
+Summary calls by using the active Pi model runtime. The injected Pi AI completion
+path remains the fallback for hosts without that runtime registry. See
+[CHANGELOG.md](CHANGELOG.md) for release details.
 
 Set `rarebit.model` in global Pi settings or in a trusted Project's
 `.pi/settings.json`. It must be `provider/model` or an object with `provider`
 and `id`. Rarebit fails closed when it is missing or invalid. It does not use
 Pi's interactive `defaultModel`.
 
-Install or move this package to the alpha.4 pin with
-`pi install npm:@hypercarrier/rarebit@0.1.0-alpha.4`. Pi treats versioned npm
+Install or move this package to the alpha.5 pin with
+`pi install npm:@hypercarrier/rarebit@0.1.0-alpha.5`. Pi treats versioned npm
 sources as pinned, so package update commands skip it. Do not use an unpinned
-source for alpha.4 recovery: unpinned npm resolution follows the retained
-`latest`, which remains alpha.1. Run `pi remove npm:@hypercarrier/rarebit` to
+source for alpha.5 recovery: unpinned npm resolution follows the retained
+`latest`, which remains alpha.4. Run `pi remove npm:@hypercarrier/rarebit` to
 stop loading it. These commands do not modify native Sessions or remove Rarebit
 retained data.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hypercarrier/rarebit",
-  "version": "0.1.0-alpha.4",
+  "version": "0.1.0-alpha.5",
   "description": "Sparse, provenance-bearing conversational evidence recovery for Pi sessions.",
   "license": "MIT",
   "author": "HyperCarrier contributors",
@@ -29,13 +29,15 @@
   "scripts": {
     "test": "node --test test/*.test.mjs",
     "test:e2e:summary-cache": "node scripts/e2e-summary-cache.mjs",
-    "test:e2e:recall": "node scripts/e2e-recall-pi083.mjs",
+    "test:e2e:recall": "node scripts/e2e-recall-pi0842.mjs",
+    "test:e2e:recall:pi083": "node scripts/e2e-recall-pi083.mjs",
     "verify:package": "node scripts/verify-package.mjs"
   },
   "peerDependencies": {
-    "@earendil-works/pi-ai": "*"
+    "@earendil-works/pi-ai": ">=0.83.0"
   },
   "devDependencies": {
+    "@earendil-works/pi-coding-agent": "0.84.2",
     "ajv": "^6.15.0",
     "typescript": "^5.9.3"
   },

package/scripts/e2e-recall-pi083.mjs

@@ -1,257 +1,59 @@
 import assert from "node:assert/strict";
-import { access, mkdtemp, readFile, rm } from "node:fs/promises";
+import { execFileSync, spawnSync } from "node:child_process";
+import { mkdtemp, rm } from "node:fs/promises";
 import { tmpdir } from "node:os";
-import { dirname, join, resolve } from "node:path";
-import { setTimeout as delay } from "node:timers/promises";
-import { pathToFileURL } from "node:url";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
 
-import registerPiRarebit from "../src/extension.mjs";
+const root = fileURLToPath(new URL("..", import.meta.url));
+const piVersion = "0.83.0";
+const work = await mkdtemp(join(tmpdir(), "rarebit-pi083-recall-"));
 
-async function waitFor(predicate, label, timeout = 2_000) {
-  const end = Date.now() + timeout;
-  while (!predicate()) {
-    if (Date.now() >= end) throw new Error(`Timed out waiting for ${label}`);
-    await delay(5);
-  }
+function run(command, args, cwd = root) {
+  return execFileSync(command, args, { cwd, encoding: "utf8" });
 }
 
-function expectedRecallMarkdown(conversationPath, detailedPath, request) {
-  return `# Rarebit Recall
-
-*Use these local private evidence files to recover historical context for this turn.*
-
-## How to use this bundle
-
-1. Treat **Current request** below as the exact current user request.
-2. Read **Conversation** first for meaning.
-3. Use **Detailed evidence** only for source, Session, branch, or lineage facts.
-4. Answer the current request using this evidence.
-
-## Local private evidence files
-
-**Conversation** — \`rarebit_conversation/v1\`
-
-\`\`\`text
-${conversationPath}
-\`\`\`
-
-**Detailed evidence** — \`rarebit_message_recall/v1\`
-
-\`\`\`text
-${detailedPath}
-\`\`\`
-
-## Current request
-
-\`\`\`text
-${request}
-\`\`\``;
-}
-
-function conversationPathFrom(message) {
-  const match = message.match(
-    /\*\*Conversation\*\* — `rarebit_conversation\/v1`\n\n```text\n([^\n]*rarebit-conversation\.json)\n```/,
-  );
-  assert.ok(match, "Recall Markdown must contain the fenced conversation path");
-  return match[1];
-}
-
-function detailedPathFrom(message) {
-  const match = message.match(
-    /\*\*Detailed evidence\*\* — `rarebit_message_recall\/v1`\n\n```text\n([^\n]*rarebit-evidence\.json)\n```/,
-  );
-  assert.ok(match, "Recall Markdown must contain the fenced detailed path");
-  return match[1];
-}
-
-const root =
-  process.env.PI_CODING_AGENT_ROOT ??
-  resolve(
-    dirname(process.execPath),
-    "../lib/node_modules/@earendil-works/pi-coding-agent",
-  );
-const packageJson = JSON.parse(
-  await readFile(join(root, "package.json"), "utf8"),
-);
-assert.equal(
-  packageJson.version,
-  "0.83.0",
-  `Pi 0.83.0 is required; found ${packageJson.version}`,
-);
-const pi = await import(pathToFileURL(join(root, "dist/index.js")).href);
-const faux = await import(
-  pathToFileURL(
-    join(root, "node_modules/@earendil-works/pi-ai/dist/providers/faux.js"),
-  ).href
-);
-
-const temp = await mkdtemp(join(tmpdir(), "hc-rarebit-pi083-recall-"));
-const sessions = join(temp, "sessions");
-const manager = pi.SessionManager.create(temp, sessions);
-const runtime = await pi.ModelRuntime.create({ modelsPath: null });
-const provider = faux.fauxProvider({
-  provider: "recall-faux",
-  models: [{ id: "recall-faux" }],
-});
-runtime.registerNativeProvider(provider.provider);
-let releaseBusy;
-let busyEntered;
-let fourthContext;
-const busyRelease = new Promise((resolve) => {
-  releaseBusy = resolve;
-});
-const busyEntry = new Promise((resolve) => {
-  busyEntered = resolve;
-});
-provider.setResponses([
-  faux.fauxAssistantMessage("seed complete"),
-  faux.fauxAssistantMessage("idle complete"),
-  async () => {
-    busyEntered();
-    return busyRelease.then(() => faux.fauxAssistantMessage("busy complete"));
-  },
-  (context) => {
-    fourthContext = context;
-    return faux.fauxAssistantMessage("steered complete");
-  },
-]);
-const settings = pi.SettingsManager.inMemory({
-  compaction: { enabled: false },
-});
-const loader = new pi.DefaultResourceLoader({
-  cwd: temp,
-  agentDir: temp,
-  settingsManager: settings,
-  noSkills: true,
-  noPromptTemplates: true,
-  noThemes: true,
-  noContextFiles: true,
-  extensionFactories: [registerPiRarebit],
-});
-await loader.reload();
-const { session } = await pi.createAgentSession({
-  cwd: temp,
-  agentDir: temp,
-  model: provider.getModel(),
-  modelRuntime: runtime,
-  noTools: "all",
-  resourceLoader: loader,
-  sessionManager: manager,
-  settingsManager: settings,
-});
-const recallDirectories = [];
 try {
-  await session.prompt("seed persistent Session");
-  await session.agent.waitForIdle();
-  await session.prompt("/rarebit recall exact idle request", {
-    streamingBehavior: "steer",
+  const packed = JSON.parse(
+    run("npm", ["pack", "--json", "--ignore-scripts", "--pack-destination", work]),
+  )[0];
+  const tarball = join(work, packed.filename);
+  run("npm", ["init", "-y"], work);
+  run(
+    "npm",
+    [
+      "install",
+      "--ignore-scripts",
+      tarball,
+      `@earendil-works/pi-coding-agent@${piVersion}`,
+    ],
+    work,
+  );
+  const installedRoot = join(
+    work,
+    "node_modules",
+    "@earendil-works",
+    "pi-coding-agent",
+  );
+  const recall = join(
+    work,
+    "node_modules",
+    "@hypercarrier",
+    "rarebit",
+    "scripts",
+    "e2e-recall-pi0842.mjs",
+  );
+  const result = spawnSync(process.execPath, [recall], {
+    cwd: work,
+    encoding: "utf8",
+    env: {
+      ...process.env,
+      PI_CODING_AGENT_ROOT: installedRoot,
+      RAREBIT_EXPECTED_PI_VERSION: piVersion,
+    },
   });
-  await waitFor(
-    () => provider.state.callCount === 2,
-    "idle Recall provider call",
-  );
-  await session.agent.waitForIdle();
-  const userEntries = manager
-    .getBranch()
-    .filter((entry) => JSON.stringify(entry).includes("exact idle request"));
-  assert.equal(userEntries.length, 1);
-  const message = userEntries[0].message ?? userEntries[0];
-  const idleMessageText = message.content[0].text;
-  const idleConversationPath = conversationPathFrom(idleMessageText);
-  const idleDetailedPath = detailedPathFrom(idleMessageText);
-  assert.equal(
-    idleMessageText,
-    expectedRecallMarkdown(
-      idleConversationPath,
-      idleDetailedPath,
-      "exact idle request",
-    ),
-  );
-  recallDirectories.push(dirname(idleConversationPath));
-  await access(idleConversationPath);
-  await access(idleDetailedPath);
-  assert.equal(
-    manager
-      .getBranch()
-      .some(
-        (entry) =>
-          entry.customType === "rarebit.recall" ||
-          entry.message?.customType === "rarebit.recall",
-      ),
-    false,
-  );
-
-  assert.equal(provider.state.callCount, 2);
-  const queueUpdates = [];
-  session.subscribe((event) => {
-    if (event.type === "queue_update") queueUpdates.push(event);
-  });
-  const busyRun = session.prompt("busy seed");
-  await busyEntry;
-  await session.prompt("/rarebit recall exact busy request", {
-    streamingBehavior: "steer",
-  });
-  await waitFor(
-    () => queueUpdates.some((event) => event.steering?.length === 1),
-    "busy Recall steering queue",
-  );
-  const queued = queueUpdates.find((event) => event.steering?.length === 1);
-  assert.equal(queued.steering.length, 1);
-  assert.equal(queued.followUp?.length ?? 0, 0);
-  const queuedMessage = queued.steering[0];
-  const busyMessageText =
-    typeof queuedMessage === "string"
-      ? queuedMessage
-      : (queuedMessage.content?.[0]?.text ?? queuedMessage.content);
-  const busyConversationPath = conversationPathFrom(busyMessageText);
-  const busyDetailedPath = detailedPathFrom(busyMessageText);
-  assert.equal(
-    busyMessageText,
-    expectedRecallMarkdown(
-      busyConversationPath,
-      busyDetailedPath,
-      "exact busy request",
-    ),
-  );
-  recallDirectories.push(dirname(busyConversationPath));
-  await access(busyConversationPath);
-  await access(busyDetailedPath);
-  releaseBusy();
-  await busyRun;
-  await session.agent.waitForIdle();
-  assert.equal(provider.state.callCount, 4);
-  const recallCount = (texts) =>
-    texts.filter((text) => text === busyMessageText).length;
-  const fourthUserTexts = (fourthContext?.messages ?? [])
-    .filter((message) => message.role === "user")
-    .map((message) => message.content?.[0]?.text ?? "");
-  assert.equal(recallCount(fourthUserTexts), 1);
-  const persistedUserTexts = manager
-    .getBranch()
-    .filter((entry) => (entry.message ?? entry).role === "user")
-    .map((entry) => (entry.message ?? entry).content?.[0]?.text ?? "");
-  assert.equal(recallCount(persistedUserTexts), 1);
-  assert.equal(
-    manager
-      .getBranch()
-      .some(
-        (entry) =>
-          entry.customType === "rarebit.recall" ||
-          entry.message?.customType === "rarebit.recall",
-      ),
-    false,
-  );
-  console.log(
-    `Pi ${packageJson.version} Recall E2E passed: idle and busy steer Markdown messages; no custom receipt.`,
-  );
+  assert.equal(result.status, 0, `${result.stdout}\n${result.stderr}`);
+  process.stdout.write(`Pi ${piVersion} Recall E2E passed from the packed artifact.\n`);
 } finally {
-  releaseBusy?.();
-  await Promise.all(
-    recallDirectories.map((directory) =>
-      rm(directory, { recursive: true, force: true }),
-    ),
-  );
-  session.dispose();
-  runtime.unregisterProvider("recall-faux");
-  await rm(temp, { recursive: true, force: true });
+  await rm(work, { recursive: true, force: true });
 }

package/scripts/e2e-recall-pi0842.mjs

@@ -0,0 +1,259 @@
+import assert from "node:assert/strict";
+import { access, mkdtemp, readFile, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { setTimeout as delay } from "node:timers/promises";
+import { fileURLToPath, pathToFileURL } from "node:url";
+
+import registerPiRarebit from "../src/extension.mjs";
+
+async function waitFor(predicate, label, timeout = 2_000) {
+  const end = Date.now() + timeout;
+  while (!predicate()) {
+    if (Date.now() >= end) throw new Error(`Timed out waiting for ${label}`);
+    await delay(5);
+  }
+}
+
+function expectedRecallMarkdown(conversationPath, detailedPath, request) {
+  return `# Rarebit Recall
+
+*Use these local private evidence files to recover historical context for this turn.*
+
+## How to use this bundle
+
+1. Treat **Current request** below as the exact current user request.
+2. Read **Conversation** first for meaning.
+3. Use **Detailed evidence** only for source, Session, branch, or lineage facts.
+4. Answer the current request using this evidence.
+
+## Local private evidence files
+
+**Conversation** — \`rarebit_conversation/v1\`
+
+\`\`\`text
+${conversationPath}
+\`\`\`
+
+**Detailed evidence** — \`rarebit_message_recall/v1\`
+
+\`\`\`text
+${detailedPath}
+\`\`\`
+
+## Current request
+
+\`\`\`text
+${request}
+\`\`\``;
+}
+
+function conversationPathFrom(message) {
+  const match = message.match(
+    /\*\*Conversation\*\* — `rarebit_conversation\/v1`\n\n```text\n([^\n]*rarebit-conversation\.json)\n```/,
+  );
+  assert.ok(match, "Recall Markdown must contain the fenced conversation path");
+  return match[1];
+}
+
+function detailedPathFrom(message) {
+  const match = message.match(
+    /\*\*Detailed evidence\*\* — `rarebit_message_recall\/v1`\n\n```text\n([^\n]*rarebit-evidence\.json)\n```/,
+  );
+  assert.ok(match, "Recall Markdown must contain the fenced detailed path");
+  return match[1];
+}
+
+const bundledPiRoot = resolve(
+  dirname(fileURLToPath(import.meta.url)),
+  "../node_modules/@earendil-works/pi-coding-agent",
+);
+const root =
+  process.env.PI_CODING_AGENT_ROOT ??
+  bundledPiRoot;
+const expectedPiVersion = process.env.RAREBIT_EXPECTED_PI_VERSION ?? "0.84.2";
+const packageJson = JSON.parse(
+  await readFile(join(root, "package.json"), "utf8"),
+);
+assert.equal(
+  packageJson.version,
+  expectedPiVersion,
+  `Pi ${expectedPiVersion} is required; found ${packageJson.version}`,
+);
+const pi = await import(pathToFileURL(join(root, "dist/index.js")).href);
+const faux = await import(
+  pathToFileURL(
+    join(root, "node_modules/@earendil-works/pi-ai/dist/providers/faux.js"),
+  ).href
+);
+
+const temp = await mkdtemp(join(tmpdir(), "rarebit-pi0842-recall-"));
+const sessions = join(temp, "sessions");
+const manager = pi.SessionManager.create(temp, sessions);
+const runtime = await pi.ModelRuntime.create({ modelsPath: null });
+const provider = faux.fauxProvider({
+  provider: "recall-faux",
+  models: [{ id: "recall-faux" }],
+});
+runtime.registerNativeProvider(provider.provider);
+let releaseBusy;
+let busyEntered;
+let fourthContext;
+const busyRelease = new Promise((resolve) => {
+  releaseBusy = resolve;
+});
+const busyEntry = new Promise((resolve) => {
+  busyEntered = resolve;
+});
+provider.setResponses([
+  faux.fauxAssistantMessage("seed complete"),
+  faux.fauxAssistantMessage("idle complete"),
+  async () => {
+    busyEntered();
+    return busyRelease.then(() => faux.fauxAssistantMessage("busy complete"));
+  },
+  (context) => {
+    fourthContext = context;
+    return faux.fauxAssistantMessage("steered complete");
+  },
+]);
+const settings = pi.SettingsManager.inMemory({
+  compaction: { enabled: false },
+});
+const loader = new pi.DefaultResourceLoader({
+  cwd: temp,
+  agentDir: temp,
+  settingsManager: settings,
+  noSkills: true,
+  noPromptTemplates: true,
+  noThemes: true,
+  noContextFiles: true,
+  extensionFactories: [registerPiRarebit],
+});
+await loader.reload();
+const { session } = await pi.createAgentSession({
+  cwd: temp,
+  agentDir: temp,
+  model: provider.getModel(),
+  modelRuntime: runtime,
+  noTools: "all",
+  resourceLoader: loader,
+  sessionManager: manager,
+  settingsManager: settings,
+});
+const recallDirectories = [];
+try {
+  await session.prompt("seed persistent Session");
+  await session.agent.waitForIdle();
+  await session.prompt("/rarebit recall exact idle request", {
+    streamingBehavior: "steer",
+  });
+  await waitFor(
+    () => provider.state.callCount === 2,
+    "idle Recall provider call",
+  );
+  await session.agent.waitForIdle();
+  const userEntries = manager
+    .getBranch()
+    .filter((entry) => JSON.stringify(entry).includes("exact idle request"));
+  assert.equal(userEntries.length, 1);
+  const message = userEntries[0].message ?? userEntries[0];
+  const idleMessageText = message.content[0].text;
+  const idleConversationPath = conversationPathFrom(idleMessageText);
+  const idleDetailedPath = detailedPathFrom(idleMessageText);
+  assert.equal(
+    idleMessageText,
+    expectedRecallMarkdown(
+      idleConversationPath,
+      idleDetailedPath,
+      "exact idle request",
+    ),
+  );
+  recallDirectories.push(dirname(idleConversationPath));
+  await access(idleConversationPath);
+  await access(idleDetailedPath);
+  assert.equal(
+    manager
+      .getBranch()
+      .some(
+        (entry) =>
+          entry.customType === "rarebit.recall" ||
+          entry.message?.customType === "rarebit.recall",
+      ),
+    false,
+  );
+
+  assert.equal(provider.state.callCount, 2);
+  const queueUpdates = [];
+  session.subscribe((event) => {
+    if (event.type === "queue_update") queueUpdates.push(event);
+  });
+  const busyRun = session.prompt("busy seed");
+  await busyEntry;
+  await session.prompt("/rarebit recall exact busy request", {
+    streamingBehavior: "steer",
+  });
+  await waitFor(
+    () => queueUpdates.some((event) => event.steering?.length === 1),
+    "busy Recall steering queue",
+  );
+  const queued = queueUpdates.find((event) => event.steering?.length === 1);
+  assert.equal(queued.steering.length, 1);
+  assert.equal(queued.followUp?.length ?? 0, 0);
+  const queuedMessage = queued.steering[0];
+  const busyMessageText =
+    typeof queuedMessage === "string"
+      ? queuedMessage
+      : (queuedMessage.content?.[0]?.text ?? queuedMessage.content);
+  const busyConversationPath = conversationPathFrom(busyMessageText);
+  const busyDetailedPath = detailedPathFrom(busyMessageText);
+  assert.equal(
+    busyMessageText,
+    expectedRecallMarkdown(
+      busyConversationPath,
+      busyDetailedPath,
+      "exact busy request",
+    ),
+  );
+  recallDirectories.push(dirname(busyConversationPath));
+  await access(busyConversationPath);
+  await access(busyDetailedPath);
+  releaseBusy();
+  await busyRun;
+  await session.agent.waitForIdle();
+  assert.equal(provider.state.callCount, 4);
+  const recallCount = (texts) =>
+    texts.filter((text) => text === busyMessageText).length;
+  const fourthUserTexts = (fourthContext?.messages ?? [])
+    .filter((message) => message.role === "user")
+    .map((message) => message.content?.[0]?.text ?? "");
+  assert.equal(recallCount(fourthUserTexts), 1);
+  const persistedUserTexts = manager
+    .getBranch()
+    .filter((entry) => (entry.message ?? entry).role === "user")
+    .map((entry) => (entry.message ?? entry).content?.[0]?.text ?? "");
+  assert.equal(recallCount(persistedUserTexts), 1);
+  assert.equal(
+    manager
+      .getBranch()
+      .some(
+        (entry) =>
+          entry.customType === "rarebit.recall" ||
+          entry.message?.customType === "rarebit.recall",
+      ),
+    false,
+  );
+  console.log(
+    `Pi ${packageJson.version} Recall E2E passed: idle and busy steer Markdown messages; no custom receipt.`,
+  );
+} finally {
+  releaseBusy?.();
+  await Promise.all(
+    recallDirectories.map((directory) =>
+      rm(directory, { recursive: true, force: true }),
+    ),
+  );
+  session.dispose();
+  runtime.unregisterProvider("recall-faux");
+  await rm(temp, { recursive: true, force: true });
+}

package/scripts/verify-package.mjs

@@ -16,13 +16,14 @@ const required = [
   "package/SECURITY.md", "package/bin/rarebit.mjs",
   "package/src/index.mjs", "package/src/types.d.ts",
   "package/schemas/rarebit.schema.json", "package/test/rarebit-cli.test.mjs",
-  "package/scripts/e2e-recall-pi083.mjs", "package/scripts/verify-package.mjs",
+  "package/scripts/e2e-recall-pi083.mjs", "package/scripts/e2e-recall-pi0842.mjs", "package/scripts/verify-package.mjs",
 ];
 const forbiddenPath = /(^|\/)(\.git|node_modules|\.github|hc-rarebit\.mjs)(\/|$)|HyperCarrier|timeline|pi-team/i;
 const allowedBare = new Set(["@earendil-works/pi-ai"]);
 const packageFor = (specifier) => specifier.startsWith("@") ? specifier.split("/").slice(0, 2).join("/") : specifier.split("/")[0];
 const packageJson = JSON.parse(await readFile(join(root, "package.json"), "utf8"));
-assert.equal(packageJson.version, "0.1.0-alpha.4", "release version mismatch");
+assert.equal(packageJson.version, "0.1.0-alpha.5", "release version mismatch");
+assert.equal(packageJson.peerDependencies?.["@earendil-works/pi-ai"], ">=0.83.0", "Pi AI peer range mismatch");
 
 const packed = JSON.parse(npm(["pack", "--json", "--ignore-scripts"]))[0];
 const tarball = join(root, packed.filename);

package/src/rarebit-model.mjs

@@ -52,10 +52,17 @@ export function resolveRarebitModelConfiguration(config = {}) {
 }
 
 export async function createPiRarebitModelClient(ctx, config = {}) {
-  const { complete, getModel } = config.piAi ?? {};
-  if (typeof complete !== "function")
+  const { complete: fallbackComplete, getModel } = config.piAi ?? {};
+  const runtimeComplete =
+    typeof ctx?.modelRegistry?.complete === "function"
+      ? ctx.modelRegistry.complete.bind(ctx.modelRegistry)
+      : undefined;
+  if (
+    typeof runtimeComplete !== "function" &&
+    typeof fallbackComplete !== "function"
+  )
     throw new Error(
-      "Pi AI contract is unavailable; load the Rarebit Pi extension or provide modelClient/piAi",
+      "Pi model completion is unavailable; load the Rarebit Pi extension or provide modelClient/piAi",
     );
   const resolution = resolveRarebitModelConfiguration(config);
   if (!resolution.ok) throw new Error(resolution.error);
@@ -79,7 +86,8 @@ export async function createPiRarebitModelClient(ctx, config = {}) {
     );
   return {
     async complete(request) {
-      return complete(
+      const completion = runtimeComplete ?? fallbackComplete;
+      return completion(
         model,
         {
           messages: [

package/test/rarebit-core.test.mjs

@@ -197,7 +197,7 @@ test("Summary normalization accepts explicit uncertainty and conflicting evidenc
   }
 });
 
-test("Pi Summary model calls forward the stable Session cache identity", async () => {
+test("Pi Summary fallback model calls forward the stable Session cache identity", async () => {
   let receivedOptions;
   const client = await createPiRarebitModelClient(
     {
@@ -220,6 +220,40 @@ test("Pi Summary model calls forward the stable Session cache identity", async (
   assert.equal(receivedOptions.sessionId, "session-cache-1");
 });
 
+test("Pi Summary uses the current model registry and preserves null header deletions", async () => {
+  let received;
+  const client = await createPiRarebitModelClient(
+    {
+      modelRegistry: {
+        find: () => ({ provider: "runtime", id: "registered-model" }),
+        getApiKeyAndHeaders: async () => ({
+          ok: true,
+          apiKey: "test-key",
+          headers: { "x-retained": "value", "x-delete": null },
+        }),
+        complete: async function (model, context, options) {
+          assert.equal(typeof this.find, "function");
+          received = { model, context, options };
+          return { text: "ok" };
+        },
+      },
+    },
+    {
+      model: { provider: "runtime", id: "registered-model" },
+      piAi: { complete: async () => { throw new Error("fallback used"); } },
+    },
+  );
+  await client.complete({ prompt: "prompt", cacheSessionId: "session-cache-2" });
+  assert.equal(received.model.provider, "runtime");
+  assert.equal(received.model.id, "registered-model");
+  assert.equal(received.context.messages[0].content[0].text, "prompt");
+  assert.deepEqual(received.options.headers, {
+    "x-retained": "value",
+    "x-delete": null,
+  });
+  assert.equal(received.options.sessionId, "session-cache-2");
+});
+
 test("job identity varies with an operation's semantic inputs, not raw source path", () => {
   const selection = selectRarebits([
     entry("u", { role: "user", content: "goal" }),