@the-librarian/pi-extension 1.33.7 → 1.36.0

package/README.md

@@ -11,9 +11,9 @@ Librarian primer into the system prompt. One install, zero config files.
 
 ## What you get
 
-- **7 tools, identical to every other harness** — `recall`, `remember`,
+- **8 tools, identical to every other harness** — `recall`, `remember`,
   `flag_memory`, `store_handoff`, `list_handoffs`, `claim_handoff`,
-  `search_references`. Descriptions and schemas mirror the server's
+  `search_references`, `journal`. Descriptions and schemas mirror the server's
   (a drift-guard test pins them), so the model is taught the same protocol in
   Pi as in Claude Code, Codex, OpenCode, and Hermes. `flag_memory` asks
   the curator to review a wrong or outdated memory: it may correct it in place,

package/extensions/librarian/commands.ts

@@ -1,7 +1,7 @@
 // Native Pi slash commands for The Librarian — optional sugar (rethink D9).
 //
 // Four thin prompt templates aligned with docs/slash-commands.md and the
-// 7-verb surface. Each handler injects a user message that drives the LLM
+// 8-verb surface. Each handler injects a user message that drives the LLM
 // through the corresponding tool flow; the tools (and the primer) carry the
 // actual protocol, so these stay deliberately skeletal. Pi's `registerCommand`
 // is one call per verb — cheap enough to keep.
@@ -28,8 +28,8 @@ const LEARN_PROMPT =
 
 const TOGGLE_ON =
   "Private mode is ON. `[librarian:private=on]` — do not call `remember`, " +
-  "`store_handoff`, or `flag_memory` until told otherwise. `recall` and " +
-  "`search_references` stay allowed; note that read queries still reach the " +
+  "`store_handoff`, or `flag_memory` until told otherwise. `recall`, " +
+  "`search_references` and `journal` stay allowed; note that read queries still reach the " +
   "Librarian server's logs. Private mode is an in-conversation instruction; " +
   "the server cannot verify its marker. A curator review queued by a flag " +
   "from public context may still correct that memory after switching private; " +

package/extensions/librarian/index.ts

@@ -4,8 +4,8 @@
 // rethink retires the conv-state injection, the per-turn conv_state fetch, and
 // the 3-tool limitation; what survives is exactly:
 //
-//   - the 7 agent verbs (recall / remember / flag_memory / store_handoff /
-//     list_handoffs / claim_handoff / search_references) as native Pi tool
+//   - the 8 agent verbs (recall / remember / flag_memory / store_handoff /
+//     list_handoffs / claim_handoff / search_references / journal) as native Pi tool
 //     proxies over the Librarian's stateless /mcp endpoint — see `tools.ts`;
 //   - the ≤2KB primer, fetched from `GET /primer.md` once per process and
 //     appended to the system prompt via `before_agent_start` — see `primer.ts`;
@@ -47,14 +47,14 @@ export default function librarian(pi: ExtensionAPI): void {
     return;
   }
 
-  // One shared MCP client for all 7 tool proxies.
+  // One shared MCP client for all 8 tool proxies.
   const mcp = createMcpClient({
     endpoint: config.endpoint,
     token: config.token,
     ...(config.timeoutMs !== undefined ? { timeoutMs: config.timeoutMs } : {}),
   });
 
-  // Expose the Librarian's 7 verbs to the model directly (no mcp.json needed).
+  // Expose the Librarian's 8 verbs to the model directly (no mcp.json needed).
   registerLibrarianTools(pi, mcp);
 
   // Primer → system prompt, once per turn, cached per process, fail-soft.

package/extensions/librarian/tools.ts

@@ -1,4 +1,4 @@
-// The Librarian's 7 agent verbs, registered natively in the extension.
+// The Librarian's 8 agent verbs, registered natively in the extension.
 //
 // Pi's CORE has no MCP support (the `mcp.json` / mcpServers feature lives in
 // third-party adapter extensions, not the runtime). So rather than ask every
@@ -42,7 +42,7 @@ export interface LibrarianToolSpec {
 }
 
 /**
- * The 7-verb agent surface (rethink spec §5.1), one spec per server tool.
+ * The 8-verb agent surface (rethink spec §5.1, ADR 0016), one spec per server tool.
  * Exposed as a function (fresh schema objects per call) so tests can inspect
  * the specs without registering anything.
  */
@@ -174,10 +174,28 @@ export function librarianToolSpecs(): LibrarianToolSpec[] {
         limit: Type.Optional(Type.Integer({ minimum: 1, maximum: 100 })),
       }),
     },
+    {
+      name: "journal",
+      label: "Journal",
+      description:
+        "Read or search your journal: a dated history of your past conversations with the " +
+        "owner — recent days in detail, older weeks and months summarised. Your session may " +
+        "already include the last ~6 weeks. Use this for anything older, or to find what " +
+        "happened on a project or topic. Facts belong to `recall`; this is what happened and why.",
+      parameters: Type.Object({
+        query: Type.Optional(Type.String({ maxLength: 500 })),
+        from: Type.Optional(Type.String()),
+        to: Type.Optional(Type.String()),
+        project: Type.Optional(Type.String({ maxLength: 200 })),
+        harness: Type.Optional(Type.String({ maxLength: 50 })),
+        limit: Type.Optional(Type.Integer({ minimum: 1, maximum: 50 })),
+        max_tokens: Type.Optional(Type.Integer({ minimum: 1000, maximum: 40000 })),
+      }),
+    },
   ];
 }
 
-/** The 7 tool names this extension registers (for tests / smoke). */
+/** The 8 tool names this extension registers (for tests / smoke). */
 export const LIBRARIAN_TOOL_NAMES = [
   "recall",
   "remember",
@@ -186,10 +204,11 @@ export const LIBRARIAN_TOOL_NAMES = [
   "list_handoffs",
   "claim_handoff",
   "search_references",
+  "journal",
 ] as const;
 
 /**
- * Register the 7 Librarian verbs as native Pi tools. Each is a thin proxy:
+ * Register the 8 Librarian verbs as native Pi tools. Each is a thin proxy:
  * forward to the remote MCP `tools/call`, return the server's prose. Failures
  * come back as an error STRING (never a throw): the model reads it, tells the
  * user, and keeps working — a Librarian outage must not break the turn.

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@the-librarian/pi-extension",
-  "version": "1.33.7",
+  "version": "1.36.0",
   "private": false,
   "publishConfig": {
     "access": "public"
   },
-  "description": "Pi coding-agent package for The Librarian: the 7 memory/handoff tools + primer injection, backed by a remote Librarian MCP server.",
+  "description": "Pi coding-agent package for The Librarian: the 8 memory/handoff/journal tools + primer injection, backed by a remote Librarian MCP server.",
   "license": "Apache-2.0",
   "type": "module",
   "author": {