pi-post 0.6.2 → 0.7.0

package/README.md

@@ -74,7 +74,7 @@ inert.
 pi install npm:pi-post
 ```
 
-Nothing to enable; every session registers itself on startup.
+Nothing to enable; every session registers itself on startup. Once a session has started, the CLI is also available at `~/.pi/agent/post/bin/pi-post` for hooks and scripts on hosts where `pi-post` is not on `PATH`.
 
 ## Use
 
@@ -145,6 +145,11 @@ sessions can read state; only one can consume a message.
 | `PI_POST_FROM` | — | Default `--from` label for the CLI |
 | `PI_POST_REPLY_TO` | — | Default `--reply-to` address for the CLI |
 
+The extension also *sets* one variable: `PI_SESSION_ADDRESS`, the session's
+own `s-…` address, exported at session start so child processes (bash tools,
+spawned scripts) can capture a reply target without shelling out to
+`pi-post whoami`.
+
 The directory is created `0700` and messages `0600`.
 
 ## Limits

package/extensions/pi-post.ts

@@ -6,6 +6,8 @@ import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-a
 import { Text } from "@earendil-works/pi-tui";
 import { Type } from "typebox";
 import type { FSWatcher } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, resolve } from "node:path";
 import { canonicalPath, sessionAddress } from "../src/address.ts";
 import { createMessage, type Message } from "../src/message.ts";
 import {
@@ -31,8 +33,10 @@ import {
   writeRecord,
 } from "../src/registry.ts";
 import { resolveTargets } from "../src/resolve.ts";
+import { ensureCliShim } from "../src/cli-shim.ts";
 
 const HEARTBEAT_MS = 30_000;
+const CLI_TARGET = resolve(dirname(fileURLToPath(import.meta.url)), "../bin/pi-post.mjs");
 
 export default function (pi: ExtensionAPI) {
   const root = postRoot();
@@ -88,8 +92,13 @@ export default function (pi: ExtensionAPI) {
     const canonical = canonicalPath(ctx.cwd);
     selfAddress = sessionAddress(sessionId);
     selfName = pi.getSessionName() ?? defaultSessionName(canonical, selfAddress);
+    // Expose the address to child processes (bash tools inherit process.env),
+    // so scripts can capture a send_message target without shelling out to
+    // `pi-post whoami` or re-deriving the hash from PI_SESSION_ID.
+    process.env.PI_SESSION_ADDRESS = selfAddress;
 
     ensureDirs(root, selfAddress);
+    ensureCliShim(root, CLI_TARGET);
     writeRecord(root, {
       v: 1,
       address: selfAddress,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pi-post",
-  "version": "0.6.2",
-  "description": "Messages between pi sessions — delivered mid-task or queued until they return. Briefs, findings, and handoffs straight into the receiving agent's context.",
+  "version": "0.7.0",
+  "description": "Messages between pi sessions — delivered mid-task or queued until they return.",
   "keywords": [
     "pi-package",
     "pi-extension",

package/src/cli-shim.ts

@@ -0,0 +1,25 @@
+import { existsSync, lstatSync, mkdirSync, readlinkSync, symlinkSync, unlinkSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+
+/** Ensure the mailbox-owned CLI path points at the package's own executable. */
+export function ensureCliShim(baseDir: string, targetPath: string): void {
+  const shimDir = join(baseDir, "bin");
+  const shimPath = join(shimDir, "pi-post");
+  try {
+    mkdirSync(shimDir, { recursive: true, mode: 0o700 });
+
+    try {
+      if (lstatSync(shimPath).isSymbolicLink()) {
+        const linkTarget = readlinkSync(shimPath);
+        if (resolve(dirname(shimPath), linkTarget) === resolve(targetPath) && existsSync(targetPath)) return;
+      }
+      unlinkSync(shimPath);
+    } catch (error) {
+      if ((error as NodeJS.ErrnoException).code !== "ENOENT") throw error;
+    }
+
+    symlinkSync(targetPath, shimPath);
+  } catch {
+    // A CLI convenience must never prevent a session from starting.
+  }
+}