@a5c-ai/babysitter-omp 5.0.1-staging.5cd43600 → 5.0.1-staging.6e094dee

package/extensions/index.legacy.ts

@@ -0,0 +1,55 @@
+import type { ExtensionAPI } from "@oh-my-pi/pi-coding-agent";
+
+const COMMANDS = [
+  "assimilate",
+  "call",
+  "cleanup",
+  "contrib",
+  "doctor",
+  "forever",
+  "help",
+  "observe",
+  "plan",
+  "plugins",
+  "project-install",
+  "resume",
+  "retrospect",
+  "user-install",
+  "yolo",
+] as const;
+
+function toSkillPrompt(name: string, args: string): string {
+  return `/skill:${name}${args ? ` ${args}` : ""}`;
+}
+
+export default function activate(pi: ExtensionAPI): void {
+  const forwardBabysit = async (args: unknown) => {
+    pi.sendUserMessage(toSkillPrompt("babysit", String(args ?? "").trim()));
+  };
+
+  pi.registerCommand("babysit", {
+    description: "Load the Babysitter orchestration skill",
+    handler: forwardBabysit,
+  });
+
+  pi.registerCommand("babysitter", {
+    description: "Alias for /babysit",
+    handler: forwardBabysit,
+  });
+
+  for (const name of COMMANDS) {
+    const forward = async (args: unknown) => {
+      pi.sendUserMessage(toSkillPrompt(name, String(args ?? "").trim()));
+    };
+
+    pi.registerCommand(name, {
+      description: `Open the Babysitter ${name} skill`,
+      handler: forward,
+    });
+
+    pi.registerCommand(`babysitter:${name}`, {
+      description: `Alias for /${name}`,
+      handler: forward,
+    });
+  }
+}

package/extensions/index.ts

@@ -1,4 +1,8 @@
 import type { ExtensionAPI } from "@oh-my-pi/pi-coding-agent";
+import { execSync } from "child_process";
+import * as path from "path";
+
+const PLUGIN_ROOT = path.resolve(__dirname, "..");
 
 const COMMANDS = [
   "assimilate",
@@ -22,7 +26,44 @@ function toSkillPrompt(name: string, args: string): string {
   return `/skill:${name}${args ? ` ${args}` : ""}`;
 }
 
+/**
+ * Run a proxied hook script and return parsed JSON result.
+ * Returns empty object on failure (hooks are best-effort).
+ */
+function runProxiedHook(
+  scriptName: string,
+  inputData?: Record<string, unknown>
+): Record<string, unknown> {
+  const scriptPath = path.join(PLUGIN_ROOT, "hooks", scriptName);
+  try {
+    const result = execSync(`node "${scriptPath}"`, {
+      input: inputData ? JSON.stringify(inputData) : undefined,
+      stdio: ["pipe", "pipe", "pipe"],
+      timeout: 30000,
+      env: {
+        ...process.env,
+        OMP_PLUGIN_ROOT: PLUGIN_ROOT,
+      },
+    });
+    return JSON.parse(result.toString("utf8").trim());
+  } catch {
+    // Hooks are best-effort -- never break the extension
+    return {};
+  }
+}
+
 export default function activate(pi: ExtensionAPI): void {
+  // ---------------------------------------------------------------------------
+  // Trigger session-start hook on activation
+  // ---------------------------------------------------------------------------
+  runProxiedHook("babysitter-proxied-session-start.js", {
+    event: "session_start",
+    cwd: process.cwd(),
+  });
+
+  // ---------------------------------------------------------------------------
+  // Register slash commands (unchanged from legacy)
+  // ---------------------------------------------------------------------------
   const forwardBabysit = async (args: unknown) => {
     pi.sendUserMessage(toSkillPrompt("babysit", String(args ?? "").trim()));
   };

package/hooks/babysitter-proxied-before-provider-request.js

@@ -0,0 +1,167 @@
+#!/usr/bin/env node
+/**
+ * Unified Before Provider Request Hook for Oh-My-Pi
+ * Routes through hooks-proxy for all hook execution.
+ *
+ * Fires before Oh-My-Pi sends a request to the LLM provider. Delegates to
+ * `babysitter hook:run --hook-type pre-tool-use` via hooks-proxy
+ * (mapped as a model-level interception point).
+ *
+ * This hook can be used to:
+ * - Log provider requests for observability
+ * - Inject babysitter metadata into request context
+ * - Track token usage across orchestration iterations
+ *
+ * Oh-My-Pi plugin protocol (programmatic):
+ *   - Called from extension via execSync
+ *   - Receives provider request context as JSON via stdin
+ *   - Outputs JSON to stdout
+ *   - Exit 0 = success
+ */
+
+"use strict";
+
+const { execSync } = require("child_process");
+const { readFileSync, mkdirSync, appendFileSync, existsSync, writeFileSync } = require("fs");
+const os = require("os");
+const path = require("path");
+
+const PLUGIN_ROOT = process.env.OMP_PLUGIN_ROOT || path.resolve(__dirname, "..");
+const GLOBAL_ROOT = process.env.BABYSITTER_GLOBAL_STATE_DIR || path.join(os.homedir(), ".a5c");
+const STATE_DIR = process.env.BABYSITTER_STATE_DIR || path.join(GLOBAL_ROOT, "state");
+const LOG_DIR = process.env.BABYSITTER_LOG_DIR || path.join(GLOBAL_ROOT, "logs");
+const LOG_FILE = path.join(LOG_DIR, "babysitter-omp-before-provider-hook.log");
+const PROXY_MARKER = path.join(PLUGIN_ROOT, ".hooks-proxy-install-attempted");
+
+function ensureDir(dir) {
+  try { mkdirSync(dir, { recursive: true }); } catch { /* best-effort */ }
+}
+
+function blog(msg) {
+  ensureDir(LOG_DIR);
+  const ts = new Date().toISOString();
+  try {
+    appendFileSync(LOG_FILE, `[INFO] ${ts} ${msg}\n`);
+  } catch { /* best-effort */ }
+}
+
+function getSdkVersion() {
+  try {
+    const versions = JSON.parse(readFileSync(path.join(PLUGIN_ROOT, "versions.json"), "utf8"));
+    return versions.sdkVersion || "latest";
+  } catch {
+    return "latest";
+  }
+}
+
+function resolveHooksProxy() {
+  try {
+    execSync("a5c-hooks-proxy --version", { stdio: "pipe", timeout: 5000 });
+    return "a5c-hooks-proxy";
+  } catch { /* not in PATH */ }
+
+  const localProxy = path.join(
+    process.env.HOME || process.env.USERPROFILE || "~",
+    ".local", "bin", process.platform === "win32" ? "a5c-hooks-proxy.exe" : "a5c-hooks-proxy"
+  );
+  if (existsSync(localProxy)) {
+    return localProxy;
+  }
+
+  return null;
+}
+
+function installHooksProxy(version) {
+  if (existsSync(PROXY_MARKER)) return;
+
+  try {
+    execSync(`npm i -g "@a5c-ai/hooks-proxy-cli@${version}" --loglevel=error`, {
+      stdio: "pipe",
+      timeout: 120000,
+    });
+    blog(`Installed hooks-proxy globally (${version})`);
+  } catch {
+    try {
+      const prefix = path.join(process.env.HOME || process.env.USERPROFILE || "~", ".local");
+      execSync(`npm i -g "@a5c-ai/hooks-proxy-cli@${version}" --prefix "${prefix}" --loglevel=error`, {
+        stdio: "pipe",
+        timeout: 120000,
+      });
+      blog(`Installed hooks-proxy to user prefix (${version})`);
+    } catch {
+      blog("hooks-proxy installation failed");
+    }
+  }
+
+  try { writeFileSync(PROXY_MARKER, version); } catch { /* best-effort */ }
+}
+
+function main() {
+  const sessionId = process.env.BABYSITTER_SESSION_ID
+    || process.env.OMP_SESSION_ID
+    || process.env.PI_SESSION_ID
+    || "";
+
+  if (!sessionId) {
+    process.stdout.write("{}\n");
+    return;
+  }
+
+  // Read stdin for provider request context
+  let inputData = "";
+  try {
+    inputData = readFileSync(0, "utf8");
+  } catch {
+    // No stdin available
+  }
+
+  blog(`Unified before-provider-request: session=${sessionId}`);
+
+  const hookInput = JSON.stringify({
+    session_id: sessionId,
+    cwd: process.cwd(),
+    harness: "oh-my-pi",
+    plugin_root: PLUGIN_ROOT,
+    provider_request: inputData ? JSON.parse(inputData) : {},
+  });
+
+  const sdkVersion = getSdkVersion();
+
+  // Ensure hooks-proxy is installed
+  let proxy = resolveHooksProxy();
+  if (!proxy) {
+    installHooksProxy(sdkVersion);
+    proxy = resolveHooksProxy();
+  }
+
+  const handler = `babysitter hook:run --harness unified --hook-type pre-tool-use --plugin-root ${PLUGIN_ROOT} --state-dir ${STATE_DIR} --json`;
+
+  try {
+    let result;
+    if (proxy) {
+      blog(`Using hooks-proxy: ${proxy}`);
+      result = execSync(`"${proxy}" invoke --adapter oh-my-pi --handler "${handler}" --json`, {
+        input: hookInput,
+        stdio: ["pipe", "pipe", "pipe"],
+        timeout: 10000,
+        env: { ...process.env, BABYSITTER_STATE_DIR: STATE_DIR },
+      });
+    } else {
+      blog("hooks-proxy not found after install, using npx fallback");
+      result = execSync(`npx -y "@a5c-ai/hooks-proxy-cli@${sdkVersion}" invoke --adapter oh-my-pi --handler "${handler}" --json`, {
+        input: hookInput,
+        stdio: ["pipe", "pipe", "pipe"],
+        timeout: 30000,
+        env: { ...process.env, BABYSITTER_STATE_DIR: STATE_DIR },
+      });
+    }
+    const output = result.toString("utf8").trim();
+    blog(`Hook result: ${output}`);
+    process.stdout.write((output || "{}") + "\n");
+  } catch (err) {
+    blog(`Before-provider-request hook failed: ${err.message} -- non-blocking`);
+    process.stdout.write("{}\n");
+  }
+}
+
+main();

package/hooks/babysitter-proxied-context.js

@@ -0,0 +1,165 @@
+#!/usr/bin/env node
+/**
+ * Unified Context Hook for Oh-My-Pi
+ * Routes through hooks-proxy for all hook execution.
+ *
+ * Fires when Oh-My-Pi requests context injection before the agent
+ * processes a turn. Delegates to
+ * `babysitter hook:run --hook-type user-prompt-submit` via hooks-proxy.
+ *
+ * Oh-My-Pi supports native additional context and chained context
+ * propagation with session-before short-circuit semantics.
+ *
+ * Oh-My-Pi plugin protocol (programmatic):
+ *   - Called from extension via execSync
+ *   - Receives context request as JSON via stdin
+ *   - Outputs JSON to stdout with context additions
+ *   - Exit 0 = success
+ */
+
+"use strict";
+
+const { execSync } = require("child_process");
+const { readFileSync, mkdirSync, appendFileSync, existsSync, writeFileSync } = require("fs");
+const os = require("os");
+const path = require("path");
+
+const PLUGIN_ROOT = process.env.OMP_PLUGIN_ROOT || path.resolve(__dirname, "..");
+const GLOBAL_ROOT = process.env.BABYSITTER_GLOBAL_STATE_DIR || path.join(os.homedir(), ".a5c");
+const STATE_DIR = process.env.BABYSITTER_STATE_DIR || path.join(GLOBAL_ROOT, "state");
+const LOG_DIR = process.env.BABYSITTER_LOG_DIR || path.join(GLOBAL_ROOT, "logs");
+const LOG_FILE = path.join(LOG_DIR, "babysitter-omp-context-hook.log");
+const PROXY_MARKER = path.join(PLUGIN_ROOT, ".hooks-proxy-install-attempted");
+
+function ensureDir(dir) {
+  try { mkdirSync(dir, { recursive: true }); } catch { /* best-effort */ }
+}
+
+function blog(msg) {
+  ensureDir(LOG_DIR);
+  const ts = new Date().toISOString();
+  try {
+    appendFileSync(LOG_FILE, `[INFO] ${ts} ${msg}\n`);
+  } catch { /* best-effort */ }
+}
+
+function getSdkVersion() {
+  try {
+    const versions = JSON.parse(readFileSync(path.join(PLUGIN_ROOT, "versions.json"), "utf8"));
+    return versions.sdkVersion || "latest";
+  } catch {
+    return "latest";
+  }
+}
+
+function resolveHooksProxy() {
+  try {
+    execSync("a5c-hooks-proxy --version", { stdio: "pipe", timeout: 5000 });
+    return "a5c-hooks-proxy";
+  } catch { /* not in PATH */ }
+
+  const localProxy = path.join(
+    process.env.HOME || process.env.USERPROFILE || "~",
+    ".local", "bin", process.platform === "win32" ? "a5c-hooks-proxy.exe" : "a5c-hooks-proxy"
+  );
+  if (existsSync(localProxy)) {
+    return localProxy;
+  }
+
+  return null;
+}
+
+function installHooksProxy(version) {
+  if (existsSync(PROXY_MARKER)) return;
+
+  try {
+    execSync(`npm i -g "@a5c-ai/hooks-proxy-cli@${version}" --loglevel=error`, {
+      stdio: "pipe",
+      timeout: 120000,
+    });
+    blog(`Installed hooks-proxy globally (${version})`);
+  } catch {
+    try {
+      const prefix = path.join(process.env.HOME || process.env.USERPROFILE || "~", ".local");
+      execSync(`npm i -g "@a5c-ai/hooks-proxy-cli@${version}" --prefix "${prefix}" --loglevel=error`, {
+        stdio: "pipe",
+        timeout: 120000,
+      });
+      blog(`Installed hooks-proxy to user prefix (${version})`);
+    } catch {
+      blog("hooks-proxy installation failed");
+    }
+  }
+
+  try { writeFileSync(PROXY_MARKER, version); } catch { /* best-effort */ }
+}
+
+function main() {
+  const sessionId = process.env.BABYSITTER_SESSION_ID
+    || process.env.OMP_SESSION_ID
+    || process.env.PI_SESSION_ID
+    || "";
+
+  if (!sessionId) {
+    process.stdout.write("{}\n");
+    return;
+  }
+
+  // Read stdin for context request
+  let inputData = "";
+  try {
+    inputData = readFileSync(0, "utf8");
+  } catch {
+    // No stdin available
+  }
+
+  blog(`Unified context: session=${sessionId}`);
+
+  const hookInput = JSON.stringify({
+    session_id: sessionId,
+    cwd: process.cwd(),
+    harness: "oh-my-pi",
+    plugin_root: PLUGIN_ROOT,
+    context_request: inputData ? JSON.parse(inputData) : {},
+  });
+
+  const sdkVersion = getSdkVersion();
+
+  // Ensure hooks-proxy is installed
+  let proxy = resolveHooksProxy();
+  if (!proxy) {
+    installHooksProxy(sdkVersion);
+    proxy = resolveHooksProxy();
+  }
+
+  const handler = `babysitter hook:run --harness unified --hook-type user-prompt-submit --plugin-root ${PLUGIN_ROOT} --state-dir ${STATE_DIR} --json`;
+
+  try {
+    let result;
+    if (proxy) {
+      blog(`Using hooks-proxy: ${proxy}`);
+      result = execSync(`"${proxy}" invoke --adapter oh-my-pi --handler "${handler}" --json`, {
+        input: hookInput,
+        stdio: ["pipe", "pipe", "pipe"],
+        timeout: 10000,
+        env: { ...process.env, BABYSITTER_STATE_DIR: STATE_DIR },
+      });
+    } else {
+      blog("hooks-proxy not found after install, using npx fallback");
+      result = execSync(`npx -y "@a5c-ai/hooks-proxy-cli@${sdkVersion}" invoke --adapter oh-my-pi --handler "${handler}" --json`, {
+        input: hookInput,
+        stdio: ["pipe", "pipe", "pipe"],
+        timeout: 30000,
+        env: { ...process.env, BABYSITTER_STATE_DIR: STATE_DIR },
+      });
+    }
+    const output = result.toString("utf8").trim();
+    blog(`Hook result: ${output}`);
+    process.stdout.write((output || "{}") + "\n");
+  } catch (err) {
+    blog(`Context hook failed: ${err.message} -- returning empty context`);
+    process.stdout.write("{}\n");
+  }
+}
+
+main();

package/hooks/babysitter-proxied-session-start.js

@@ -0,0 +1,227 @@
+#!/usr/bin/env node
+/**
+ * Unified Session Start Hook for Oh-My-Pi
+ * Routes through hooks-proxy for all hook execution.
+ *
+ * Fires when an Oh-My-Pi session begins. Ensures the babysitter SDK CLI
+ * and hooks-proxy are installed, then delegates to
+ * `babysitter hook:run --hook-type session-start` via hooks-proxy.
+ *
+ * Oh-My-Pi plugin protocol (programmatic):
+ *   - Called from extension activate() via execSync
+ *   - Receives event context as JSON via stdin
+ *   - Outputs JSON to stdout
+ *   - Exit 0 = success
+ */
+
+"use strict";
+
+const { execSync } = require("child_process");
+const { readFileSync, mkdirSync, appendFileSync, existsSync, writeFileSync } = require("fs");
+const os = require("os");
+const path = require("path");
+const crypto = require("crypto");
+
+const PLUGIN_ROOT = process.env.OMP_PLUGIN_ROOT || path.resolve(__dirname, "..");
+const GLOBAL_ROOT = process.env.BABYSITTER_GLOBAL_STATE_DIR || path.join(os.homedir(), ".a5c");
+const STATE_DIR = process.env.BABYSITTER_STATE_DIR || path.join(GLOBAL_ROOT, "state");
+const LOG_DIR = process.env.BABYSITTER_LOG_DIR || path.join(GLOBAL_ROOT, "logs");
+const LOG_FILE = path.join(LOG_DIR, "babysitter-omp-session-start-hook.log");
+const SDK_MARKER = path.join(PLUGIN_ROOT, ".babysitter-install-attempted");
+const PROXY_MARKER = path.join(PLUGIN_ROOT, ".hooks-proxy-install-attempted");
+
+// ---------------------------------------------------------------------------
+// Logging
+// ---------------------------------------------------------------------------
+
+function ensureDir(dir) {
+  try { mkdirSync(dir, { recursive: true }); } catch { /* best-effort */ }
+}
+
+function blog(msg) {
+  ensureDir(LOG_DIR);
+  const ts = new Date().toISOString();
+  try {
+    appendFileSync(LOG_FILE, `[INFO] ${ts} ${msg}\n`);
+  } catch { /* best-effort */ }
+}
+
+// ---------------------------------------------------------------------------
+// SDK version & install
+// ---------------------------------------------------------------------------
+
+function getSdkVersion() {
+  try {
+    const versions = JSON.parse(readFileSync(path.join(PLUGIN_ROOT, "versions.json"), "utf8"));
+    return versions.sdkVersion || "latest";
+  } catch {
+    return "latest";
+  }
+}
+
+function getInstalledVersion(cmd) {
+  try {
+    return execSync(`${cmd} --version`, { stdio: "pipe", timeout: 10000 }).toString().trim();
+  } catch {
+    return null;
+  }
+}
+
+function installPackage(npmPkg, version, marker) {
+  if (existsSync(marker)) return;
+
+  try {
+    execSync(`npm i -g "${npmPkg}@${version}" --loglevel=error`, {
+      stdio: "pipe",
+      timeout: 120000,
+    });
+    blog(`Installed ${npmPkg} globally (${version})`);
+  } catch {
+    // Try user-local prefix
+    try {
+      const prefix = path.join(process.env.HOME || process.env.USERPROFILE || "~", ".local");
+      execSync(`npm i -g "${npmPkg}@${version}" --prefix "${prefix}" --loglevel=error`, {
+        stdio: "pipe",
+        timeout: 120000,
+      });
+      blog(`Installed ${npmPkg} to user prefix (${version})`);
+    } catch {
+      blog(`${npmPkg} installation failed`);
+    }
+  }
+
+  try { writeFileSync(marker, version); } catch { /* best-effort */ }
+}
+
+// ---------------------------------------------------------------------------
+// Hooks-proxy resolution & install
+// ---------------------------------------------------------------------------
+
+function resolveHooksProxy() {
+  // Check PATH first
+  try {
+    execSync("a5c-hooks-proxy --version", { stdio: "pipe", timeout: 5000 });
+    return "a5c-hooks-proxy";
+  } catch { /* not in PATH */ }
+
+  // Check user-local install
+  const localProxy = path.join(
+    process.env.HOME || process.env.USERPROFILE || "~",
+    ".local", "bin", process.platform === "win32" ? "a5c-hooks-proxy.exe" : "a5c-hooks-proxy"
+  );
+  if (existsSync(localProxy)) {
+    return localProxy;
+  }
+
+  return null;
+}
+
+// ---------------------------------------------------------------------------
+// CLI execution helpers
+// ---------------------------------------------------------------------------
+
+function runViaProxy(proxy, hookType, inputJson) {
+  const handler = `babysitter hook:run --harness unified --hook-type ${hookType} --plugin-root ${PLUGIN_ROOT} --state-dir ${STATE_DIR} --json`;
+  const result = execSync(`"${proxy}" invoke --adapter oh-my-pi --handler "${handler}" --json`, {
+    input: inputJson,
+    stdio: ["pipe", "pipe", "pipe"],
+    timeout: 30000,
+    env: { ...process.env, BABYSITTER_STATE_DIR: STATE_DIR },
+  });
+  return result.toString("utf8").trim();
+}
+
+function runViaNpxProxy(version, hookType, inputJson) {
+  const handler = `babysitter hook:run --harness unified --hook-type ${hookType} --plugin-root ${PLUGIN_ROOT} --state-dir ${STATE_DIR} --json`;
+  const result = execSync(`npx -y "@a5c-ai/hooks-proxy-cli@${version}" invoke --adapter oh-my-pi --handler "${handler}" --json`, {
+    input: inputJson,
+    stdio: ["pipe", "pipe", "pipe"],
+    timeout: 60000,
+    env: { ...process.env, BABYSITTER_STATE_DIR: STATE_DIR },
+  });
+  return result.toString("utf8").trim();
+}
+
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+
+function main() {
+  blog("Unified session-start hook invoked");
+  blog(`PLUGIN_ROOT=${PLUGIN_ROOT}`);
+
+  // Generate a session ID if Oh-My-Pi doesn't provide one
+  const sessionId = process.env.OMP_SESSION_ID
+    || process.env.PI_SESSION_ID
+    || process.env.BABYSITTER_SESSION_ID
+    || crypto.randomUUID();
+
+  // Set env var so downstream hooks can pick it up
+  process.env.BABYSITTER_SESSION_ID = sessionId;
+
+  const sdkVersion = getSdkVersion();
+
+  // Ensure SDK is installed with version sync
+  const currentSdkVersion = getInstalledVersion("babysitter");
+  if (!currentSdkVersion || currentSdkVersion !== sdkVersion) {
+    blog(`SDK needs install/upgrade: installed=${currentSdkVersion || "none"}, required=${sdkVersion}`);
+    installPackage("@a5c-ai/babysitter-sdk", sdkVersion, SDK_MARKER);
+  } else {
+    blog(`SDK version OK: ${currentSdkVersion}`);
+  }
+
+  // Ensure hooks-proxy is installed with version sync
+  const currentProxyVersion = getInstalledVersion("a5c-hooks-proxy");
+  if (!currentProxyVersion || currentProxyVersion !== sdkVersion) {
+    blog(`hooks-proxy needs install/upgrade: installed=${currentProxyVersion || "none"}, required=${sdkVersion}`);
+    installPackage("@a5c-ai/hooks-proxy-cli", sdkVersion, PROXY_MARKER);
+  } else {
+    blog(`hooks-proxy version OK: ${currentProxyVersion}`);
+  }
+
+  // Read stdin if available
+  let stdinData = "";
+  try {
+    stdinData = readFileSync(0, "utf8");
+  } catch { /* no stdin */ }
+
+  // Build hook input
+  const hookInput = JSON.stringify({
+    session_id: sessionId,
+    cwd: process.cwd(),
+    harness: "oh-my-pi",
+    plugin_root: PLUGIN_ROOT,
+    ...(stdinData ? { event_data: JSON.parse(stdinData) } : {}),
+  });
+
+  blog(`Hook input: ${hookInput}`);
+
+  // Route through hooks-proxy (install or npx fallback)
+  const proxy = resolveHooksProxy();
+  let result;
+
+  try {
+    if (proxy) {
+      blog(`Using hooks-proxy: ${proxy}`);
+      result = runViaProxy(proxy, "session-start", hookInput);
+    } else {
+      blog("hooks-proxy not found after install, using npx fallback");
+      result = runViaNpxProxy(sdkVersion, "session-start", hookInput);
+    }
+  } catch (err) {
+    blog(`Hook execution failed: ${err.message}`);
+    result = "{}";
+  }
+
+  blog(`Hook result: ${result}`);
+
+  // Output result
+  try {
+    const parsed = JSON.parse(result);
+    process.stdout.write(JSON.stringify(parsed) + "\n");
+  } catch {
+    process.stdout.write("{}\n");
+  }
+}
+
+main();

package/hooks/babysitter-proxied-stop.js

@@ -0,0 +1,179 @@
+#!/usr/bin/env node
+/**
+ * Unified Stop / Orchestration Hook for Oh-My-Pi
+ * Routes through hooks-proxy for all hook execution.
+ *
+ * Fires when the Oh-My-Pi agent completes a turn. Checks if the current
+ * babysitter run has pending effects that need attention. Delegates to
+ * `babysitter hook:run --hook-type stop` via hooks-proxy.
+ *
+ * Oh-My-Pi plugin protocol (programmatic):
+ *   - Called from extension via execSync
+ *   - Receives event context as JSON via stdin
+ *   - Outputs JSON to stdout
+ *   - Exit 0 = success
+ */
+
+"use strict";
+
+const { execSync } = require("child_process");
+const { readFileSync, mkdirSync, appendFileSync, existsSync, writeFileSync } = require("fs");
+const os = require("os");
+const path = require("path");
+
+const PLUGIN_ROOT = process.env.OMP_PLUGIN_ROOT || path.resolve(__dirname, "..");
+const GLOBAL_ROOT = process.env.BABYSITTER_GLOBAL_STATE_DIR || path.join(os.homedir(), ".a5c");
+const STATE_DIR = process.env.BABYSITTER_STATE_DIR || path.join(GLOBAL_ROOT, "state");
+const LOG_DIR = process.env.BABYSITTER_LOG_DIR || path.join(GLOBAL_ROOT, "logs");
+const LOG_FILE = path.join(LOG_DIR, "babysitter-omp-stop-hook.log");
+const PROXY_MARKER = path.join(PLUGIN_ROOT, ".hooks-proxy-install-attempted");
+
+function ensureDir(dir) {
+  try { mkdirSync(dir, { recursive: true }); } catch { /* best-effort */ }
+}
+
+function blog(msg) {
+  ensureDir(LOG_DIR);
+  const ts = new Date().toISOString();
+  try {
+    appendFileSync(LOG_FILE, `[INFO] ${ts} ${msg}\n`);
+  } catch { /* best-effort */ }
+}
+
+function getSdkVersion() {
+  try {
+    const versions = JSON.parse(readFileSync(path.join(PLUGIN_ROOT, "versions.json"), "utf8"));
+    return versions.sdkVersion || "latest";
+  } catch {
+    return "latest";
+  }
+}
+
+function resolveHooksProxy() {
+  try {
+    execSync("a5c-hooks-proxy --version", { stdio: "pipe", timeout: 5000 });
+    return "a5c-hooks-proxy";
+  } catch { /* not in PATH */ }
+
+  const localProxy = path.join(
+    process.env.HOME || process.env.USERPROFILE || "~",
+    ".local", "bin", process.platform === "win32" ? "a5c-hooks-proxy.exe" : "a5c-hooks-proxy"
+  );
+  if (existsSync(localProxy)) {
+    return localProxy;
+  }
+
+  return null;
+}
+
+function installHooksProxy(version) {
+  if (existsSync(PROXY_MARKER)) return;
+
+  try {
+    execSync(`npm i -g "@a5c-ai/hooks-proxy-cli@${version}" --loglevel=error`, {
+      stdio: "pipe",
+      timeout: 120000,
+    });
+    blog(`Installed hooks-proxy globally (${version})`);
+  } catch {
+    try {
+      const prefix = path.join(process.env.HOME || process.env.USERPROFILE || "~", ".local");
+      execSync(`npm i -g "@a5c-ai/hooks-proxy-cli@${version}" --prefix "${prefix}" --loglevel=error`, {
+        stdio: "pipe",
+        timeout: 120000,
+      });
+      blog(`Installed hooks-proxy to user prefix (${version})`);
+    } catch {
+      blog("hooks-proxy installation failed");
+    }
+  }
+
+  try { writeFileSync(PROXY_MARKER, version); } catch { /* best-effort */ }
+}
+
+function runViaProxy(proxy, hookType, inputJson) {
+  const handler = `babysitter hook:run --harness unified --hook-type ${hookType} --plugin-root ${PLUGIN_ROOT} --state-dir ${STATE_DIR} --json`;
+  const result = execSync(`"${proxy}" invoke --adapter oh-my-pi --handler "${handler}" --json`, {
+    input: inputJson,
+    stdio: ["pipe", "pipe", "pipe"],
+    timeout: 30000,
+    env: { ...process.env, BABYSITTER_STATE_DIR: STATE_DIR },
+  });
+  return result.toString("utf8").trim();
+}
+
+function runViaNpxProxy(version, hookType, inputJson) {
+  const handler = `babysitter hook:run --harness unified --hook-type ${hookType} --plugin-root ${PLUGIN_ROOT} --state-dir ${STATE_DIR} --json`;
+  const result = execSync(`npx -y "@a5c-ai/hooks-proxy-cli@${version}" invoke --adapter oh-my-pi --handler "${handler}" --json`, {
+    input: inputJson,
+    stdio: ["pipe", "pipe", "pipe"],
+    timeout: 60000,
+    env: { ...process.env, BABYSITTER_STATE_DIR: STATE_DIR },
+  });
+  return result.toString("utf8").trim();
+}
+
+function main() {
+  blog("Unified stop hook invoked");
+
+  const sessionId = process.env.BABYSITTER_SESSION_ID
+    || process.env.OMP_SESSION_ID
+    || process.env.PI_SESSION_ID
+    || "";
+
+  if (!sessionId) {
+    blog("No session ID -- nothing to check");
+    process.stdout.write("{}\n");
+    return;
+  }
+
+  const sdkVersion = getSdkVersion();
+
+  // Ensure hooks-proxy is installed
+  let proxy = resolveHooksProxy();
+  if (!proxy) {
+    installHooksProxy(sdkVersion);
+    proxy = resolveHooksProxy();
+  }
+
+  // Read stdin if available
+  let stdinData = "";
+  try {
+    stdinData = readFileSync(0, "utf8");
+  } catch { /* no stdin */ }
+
+  const hookInput = JSON.stringify({
+    session_id: sessionId,
+    cwd: process.cwd(),
+    harness: "oh-my-pi",
+    plugin_root: PLUGIN_ROOT,
+    ...(stdinData ? { event_data: JSON.parse(stdinData) } : {}),
+  });
+
+  blog(`Checking run status for session ${sessionId}`);
+
+  let result;
+  try {
+    if (proxy) {
+      blog(`Using hooks-proxy: ${proxy}`);
+      result = runViaProxy(proxy, "stop", hookInput);
+    } else {
+      blog("hooks-proxy not found after install, using npx fallback");
+      result = runViaNpxProxy(sdkVersion, "stop", hookInput);
+    }
+  } catch (err) {
+    blog(`Hook execution failed: ${err.message}`);
+    result = "{}";
+  }
+
+  blog(`Hook result: ${result}`);
+
+  try {
+    const parsed = JSON.parse(result);
+    process.stdout.write(JSON.stringify(parsed) + "\n");
+  } catch {
+    process.stdout.write("{}\n");
+  }
+}
+
+main();

package/hooks/babysitter-proxied-tool-call.js

@@ -0,0 +1,166 @@
+#!/usr/bin/env node
+/**
+ * Unified Tool Call Hook for Oh-My-Pi
+ * Routes through hooks-proxy for all hook execution.
+ *
+ * Fires before a tool execution in Oh-My-Pi. Delegates to
+ * `babysitter hook:run --hook-type pre-tool-use` via hooks-proxy.
+ *
+ * Note: Unlike Pi, Oh-My-Pi does NOT support tool input mutation.
+ * This hook is observer-only (logging/blocking but no mutation).
+ *
+ * Oh-My-Pi plugin protocol (programmatic):
+ *   - Called from extension via execSync
+ *   - Receives tool context as JSON via stdin
+ *   - Outputs JSON to stdout (empty = allow, { block: true } = block)
+ *   - Exit 0 = success
+ */
+
+"use strict";
+
+const { execSync } = require("child_process");
+const { readFileSync, mkdirSync, appendFileSync, existsSync, writeFileSync } = require("fs");
+const os = require("os");
+const path = require("path");
+
+const PLUGIN_ROOT = process.env.OMP_PLUGIN_ROOT || path.resolve(__dirname, "..");
+const GLOBAL_ROOT = process.env.BABYSITTER_GLOBAL_STATE_DIR || path.join(os.homedir(), ".a5c");
+const STATE_DIR = process.env.BABYSITTER_STATE_DIR || path.join(GLOBAL_ROOT, "state");
+const LOG_DIR = process.env.BABYSITTER_LOG_DIR || path.join(GLOBAL_ROOT, "logs");
+const LOG_FILE = path.join(LOG_DIR, "babysitter-omp-tool-call-hook.log");
+const PROXY_MARKER = path.join(PLUGIN_ROOT, ".hooks-proxy-install-attempted");
+
+function ensureDir(dir) {
+  try { mkdirSync(dir, { recursive: true }); } catch { /* best-effort */ }
+}
+
+function blog(msg) {
+  ensureDir(LOG_DIR);
+  const ts = new Date().toISOString();
+  try {
+    appendFileSync(LOG_FILE, `[INFO] ${ts} ${msg}\n`);
+  } catch { /* best-effort */ }
+}
+
+function getSdkVersion() {
+  try {
+    const versions = JSON.parse(readFileSync(path.join(PLUGIN_ROOT, "versions.json"), "utf8"));
+    return versions.sdkVersion || "latest";
+  } catch {
+    return "latest";
+  }
+}
+
+function resolveHooksProxy() {
+  try {
+    execSync("a5c-hooks-proxy --version", { stdio: "pipe", timeout: 5000 });
+    return "a5c-hooks-proxy";
+  } catch { /* not in PATH */ }
+
+  const localProxy = path.join(
+    process.env.HOME || process.env.USERPROFILE || "~",
+    ".local", "bin", process.platform === "win32" ? "a5c-hooks-proxy.exe" : "a5c-hooks-proxy"
+  );
+  if (existsSync(localProxy)) {
+    return localProxy;
+  }
+
+  return null;
+}
+
+function installHooksProxy(version) {
+  if (existsSync(PROXY_MARKER)) return;
+
+  try {
+    execSync(`npm i -g "@a5c-ai/hooks-proxy-cli@${version}" --loglevel=error`, {
+      stdio: "pipe",
+      timeout: 120000,
+    });
+    blog(`Installed hooks-proxy globally (${version})`);
+  } catch {
+    try {
+      const prefix = path.join(process.env.HOME || process.env.USERPROFILE || "~", ".local");
+      execSync(`npm i -g "@a5c-ai/hooks-proxy-cli@${version}" --prefix "${prefix}" --loglevel=error`, {
+        stdio: "pipe",
+        timeout: 120000,
+      });
+      blog(`Installed hooks-proxy to user prefix (${version})`);
+    } catch {
+      blog("hooks-proxy installation failed");
+    }
+  }
+
+  try { writeFileSync(PROXY_MARKER, version); } catch { /* best-effort */ }
+}
+
+function main() {
+  const sessionId = process.env.BABYSITTER_SESSION_ID
+    || process.env.OMP_SESSION_ID
+    || process.env.PI_SESSION_ID
+    || "";
+
+  if (!sessionId) {
+    // No session -- pass through without intervention
+    process.stdout.write("{}\n");
+    return;
+  }
+
+  // Read stdin for tool context
+  let inputData = "";
+  try {
+    inputData = readFileSync(0, "utf8");
+  } catch {
+    // No stdin available
+  }
+
+  blog(`Unified tool-call: session=${sessionId}`);
+
+  const hookInput = JSON.stringify({
+    session_id: sessionId,
+    cwd: process.cwd(),
+    harness: "oh-my-pi",
+    plugin_root: PLUGIN_ROOT,
+    tool_context: inputData ? JSON.parse(inputData) : {},
+  });
+
+  const sdkVersion = getSdkVersion();
+
+  // Ensure hooks-proxy is installed
+  let proxy = resolveHooksProxy();
+  if (!proxy) {
+    installHooksProxy(sdkVersion);
+    proxy = resolveHooksProxy();
+  }
+
+  const handler = `babysitter hook:run --harness unified --hook-type pre-tool-use --plugin-root ${PLUGIN_ROOT} --state-dir ${STATE_DIR} --json`;
+
+  try {
+    let result;
+    if (proxy) {
+      blog(`Using hooks-proxy: ${proxy}`);
+      result = execSync(`"${proxy}" invoke --adapter oh-my-pi --handler "${handler}" --json`, {
+        input: hookInput,
+        stdio: ["pipe", "pipe", "pipe"],
+        timeout: 10000,
+        env: { ...process.env, BABYSITTER_STATE_DIR: STATE_DIR },
+      });
+    } else {
+      blog("hooks-proxy not found after install, using npx fallback");
+      result = execSync(`npx -y "@a5c-ai/hooks-proxy-cli@${sdkVersion}" invoke --adapter oh-my-pi --handler "${handler}" --json`, {
+        input: hookInput,
+        stdio: ["pipe", "pipe", "pipe"],
+        timeout: 30000,
+        env: { ...process.env, BABYSITTER_STATE_DIR: STATE_DIR },
+      });
+    }
+    const output = result.toString("utf8").trim();
+    blog(`Hook result: ${output}`);
+    process.stdout.write((output || "{}") + "\n");
+  } catch (err) {
+    // On failure, allow the tool execution to proceed
+    blog(`Pre-tool-use hook failed: ${err.message} -- allowing execution`);
+    process.stdout.write("{}\n");
+  }
+}
+
+main();

package/hooks/hooks.json

@@ -0,0 +1,46 @@
+{
+  "version": 1,
+  "description": "Babysitter hook registration for Oh-My-Pi. Maps Oh-My-Pi extension events to unified babysitter hook scripts with hooks-proxy support.",
+  "hooks": {
+    "session_start": [
+      {
+        "type": "command",
+        "script": "hooks/babysitter-proxied-session-start.js",
+        "description": "Initialize babysitter session state and inject context (proxied via a5c-hooks-proxy)",
+        "timeoutMs": 30000
+      }
+    ],
+    "tool_call": [
+      {
+        "type": "command",
+        "script": "hooks/babysitter-proxied-tool-call.js",
+        "description": "Pre-tool-use hook for babysitter awareness (proxied via a5c-hooks-proxy)",
+        "timeoutMs": 10000
+      }
+    ],
+    "context": [
+      {
+        "type": "command",
+        "script": "hooks/babysitter-proxied-context.js",
+        "description": "Context injection for babysitter orchestration (proxied via a5c-hooks-proxy)",
+        "timeoutMs": 10000
+      }
+    ],
+    "before_provider_request": [
+      {
+        "type": "command",
+        "script": "hooks/babysitter-proxied-before-provider-request.js",
+        "description": "Before provider request hook for babysitter observability (proxied via a5c-hooks-proxy)",
+        "timeoutMs": 10000
+      }
+    ],
+    "stop": [
+      {
+        "type": "command",
+        "script": "hooks/babysitter-proxied-stop.js",
+        "description": "Check for pending babysitter effects when agent completes a turn (proxied via a5c-hooks-proxy)",
+        "timeoutMs": 30000
+      }
+    ]
+  }
+}

package/hooks/proxied-hooks.json

@@ -0,0 +1,47 @@
+{
+  "_comment": "Reference: hooks-proxy routing configuration for Oh-My-Pi. All hooks route through a5c-hooks-proxy with --adapter oh-my-pi.",
+  "version": 1,
+  "description": "Babysitter hook registration for Oh-My-Pi. Maps Oh-My-Pi extension events to unified babysitter hook scripts with hooks-proxy support.",
+  "hooks": {
+    "session_start": [
+      {
+        "type": "command",
+        "script": "hooks/babysitter-proxied-session-start.js",
+        "description": "Initialize babysitter session state and inject context (proxied via a5c-hooks-proxy)",
+        "timeoutMs": 30000
+      }
+    ],
+    "tool_call": [
+      {
+        "type": "command",
+        "script": "hooks/babysitter-proxied-tool-call.js",
+        "description": "Pre-tool-use hook for babysitter awareness (proxied via a5c-hooks-proxy)",
+        "timeoutMs": 10000
+      }
+    ],
+    "context": [
+      {
+        "type": "command",
+        "script": "hooks/babysitter-proxied-context.js",
+        "description": "Context injection for babysitter orchestration (proxied via a5c-hooks-proxy)",
+        "timeoutMs": 10000
+      }
+    ],
+    "before_provider_request": [
+      {
+        "type": "command",
+        "script": "hooks/babysitter-proxied-before-provider-request.js",
+        "description": "Before provider request hook for babysitter observability (proxied via a5c-hooks-proxy)",
+        "timeoutMs": 10000
+      }
+    ],
+    "stop": [
+      {
+        "type": "command",
+        "script": "hooks/babysitter-proxied-stop.js",
+        "description": "Check for pending babysitter effects when agent completes a turn (proxied via a5c-hooks-proxy)",
+        "timeoutMs": 30000
+      }
+    ]
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a5c-ai/babysitter-omp",
-  "version": "5.0.1-staging.5cd43600",
+  "version": "5.0.1-staging.6e094dee",
   "type": "module",
   "description": "Babysitter package for oh-my-pi",
   "keywords": [
@@ -14,12 +14,13 @@
     "extensions": [
       "./extensions"
     ],
+    "hooks": "./hooks/hooks.json",
     "skills": [
       "./skills"
     ]
   },
   "dependencies": {
-    "@a5c-ai/babysitter-sdk": "5.0.1-staging.5cd43600"
+    "@a5c-ai/babysitter-sdk": "5.0.1-staging.6e094dee"
   },
   "peerDependencies": {
     "@oh-my-pi/pi-coding-agent": "*"
@@ -42,6 +43,7 @@
     "README.md",
     "AGENTS.md",
     "extensions/",
+    "hooks/",
     "skills/",
     "commands/",
     "scripts/"

package/versions.json

@@ -1,3 +1,3 @@
 {
-  "sdkVersion": "5.0.1-staging.5cd43600"
+  "sdkVersion": "5.0.1-staging.6e094dee"
 }