@a5c-ai/babysitter-opencode 5.0.1-staging.b5c14f2a → 5.0.1-staging.c66885f8

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

@@ -0,0 +1,218 @@
+#!/usr/bin/env node
+/**
+ * Unified Session Created Hook for OpenCode
+ * Routes through hooks-proxy for all hook execution.
+ *
+ * Fires when an OpenCode session is created. Ensures the babysitter SDK CLI
+ * and hooks-proxy are installed, then delegates to
+ * `babysitter hook:run --hook-type session-start` via hooks-proxy.
+ *
+ * OpenCode plugin protocol:
+ *   - Receives event context as JSON via process.argv or stdin
+ *   - Outputs JSON to stdout
+ *   - Exit 0 = success
+ */
+
+"use strict";
+
+const { execSync, execFileSync } = 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.OPENCODE_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-session-created-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 opencode --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 opencode --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-created hook invoked");
+  blog(`PLUGIN_ROOT=${PLUGIN_ROOT}`);
+
+  // Generate a session ID if OpenCode doesn't provide one
+  const sessionId = process.env.OPENCODE_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}`);
+  }
+
+  // Build hook input
+  const hookInput = JSON.stringify({
+    session_id: sessionId,
+    cwd: process.cwd(),
+    harness: "opencode",
+    plugin_root: PLUGIN_ROOT,
+  });
+
+  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-session-idle.js

@@ -0,0 +1,173 @@
+#!/usr/bin/env node
+/**
+ * Unified Session Idle Hook for OpenCode
+ * Routes through hooks-proxy for all hook execution.
+ *
+ * Fires when the OpenCode agent goes idle. Checks if the current babysitter
+ * run has pending effects that need attention. Since OpenCode does NOT have a
+ * blocking stop hook, this is fire-and-forget -- it outputs context about
+ * pending effects so the agent can decide whether to continue iterating.
+ *
+ * Delegates to `babysitter hook:run --hook-type stop` via hooks-proxy.
+ *
+ * OpenCode plugin protocol:
+ *   - 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.OPENCODE_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-session-idle-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 opencode --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 opencode --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 session-idle hook invoked");
+
+  const sessionId = process.env.BABYSITTER_SESSION_ID
+    || process.env.OPENCODE_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();
+  }
+
+  const hookInput = JSON.stringify({
+    session_id: sessionId,
+    cwd: process.cwd(),
+    harness: "opencode",
+    plugin_root: PLUGIN_ROOT,
+  });
+
+  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-shell-env.js

@@ -0,0 +1,148 @@
+#!/usr/bin/env node
+/**
+ * Unified Shell Environment Hook for OpenCode
+ * Routes through hooks-proxy when available for consistency,
+ * but primarily performs direct env var injection.
+ *
+ * Fires when OpenCode initializes a shell environment. Injects babysitter
+ * environment variables (BABYSITTER_SESSION_ID, BABYSITTER_STATE_DIR, etc.)
+ * so that subprocesses and other hooks can discover the active session.
+ *
+ * This is critical for OpenCode because it does NOT natively inject
+ * distinctive env vars into plugins -- the babysitter plugin must self-inject
+ * them via this hook.
+ *
+ * OpenCode plugin protocol:
+ *   - Outputs env var assignments as JSON: { "env": { "KEY": "VALUE" } }
+ *   - Exit 0 = success
+ */
+
+"use strict";
+
+const { readFileSync, mkdirSync, appendFileSync, existsSync, writeFileSync } = require("fs");
+const { execSync } = require("child_process");
+const os = require("os");
+const path = require("path");
+const crypto = require("crypto");
+
+const PLUGIN_ROOT = process.env.OPENCODE_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 RUNS_DIR = process.env.BABYSITTER_RUNS_DIR || path.join(GLOBAL_ROOT, "runs");
+const LOG_DIR = process.env.BABYSITTER_LOG_DIR || path.join(GLOBAL_ROOT, "logs");
+const LOG_FILE = path.join(LOG_DIR, "babysitter-shell-env-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() {
+  blog("Unified shell-env hook invoked");
+
+  // Resolve or generate session ID
+  const sessionId = process.env.BABYSITTER_SESSION_ID
+    || process.env.OPENCODE_SESSION_ID
+    || crypto.randomUUID();
+
+  const sdkVersion = getSdkVersion();
+
+  // Ensure hooks-proxy is installed (for other hooks to use)
+  const proxy = resolveHooksProxy();
+  if (!proxy) {
+    installHooksProxy(sdkVersion);
+  }
+
+  // Build env vars to inject
+  const env = {
+    BABYSITTER_SESSION_ID: sessionId,
+    OPENCODE_SESSION_ID: sessionId,
+    BABYSITTER_STATE_DIR: STATE_DIR,
+    BABYSITTER_RUNS_DIR: RUNS_DIR,
+    OPENCODE_PLUGIN_ROOT: PLUGIN_ROOT,
+  };
+
+  // Add SDK version for downstream hooks
+  if (sdkVersion && sdkVersion !== "latest") {
+    env.BABYSITTER_SDK_VERSION = sdkVersion;
+  }
+
+  // Add global state dir if defined
+  const globalStateDir = process.env.BABYSITTER_GLOBAL_STATE_DIR;
+  if (globalStateDir) {
+    env.BABYSITTER_GLOBAL_STATE_DIR = globalStateDir;
+  }
+
+  // Note: shell-env is purely env injection — hooks-proxy routing is logged
+  // but the output is always the same env vars object. The proxy can
+  // potentially enrich env vars in the future.
+  const resolvedProxy = resolveHooksProxy();
+  if (resolvedProxy) {
+    blog(`hooks-proxy available: ${resolvedProxy} (env injection is direct)`);
+  }
+
+  blog(`Injecting env: ${JSON.stringify(env)}`);
+
+  process.stdout.write(JSON.stringify({ env }) + "\n");
+}
+
+main();

package/hooks/babysitter-proxied-tool-execute-after.js

@@ -0,0 +1,164 @@
+#!/usr/bin/env node
+/**
+ * Unified Tool Execute After Hook for OpenCode
+ * Routes through hooks-proxy for all hook execution.
+ *
+ * Fires after a tool execution in OpenCode. Delegates to
+ * `babysitter hook:run --hook-type post-tool-use` via hooks-proxy.
+ *
+ * This hook can be used to:
+ * - Log tool execution results for babysitter run observability
+ * - Trigger babysitter effects based on tool outputs
+ * - Update session state after tool executions
+ *
+ * OpenCode plugin protocol:
+ *   - Receives tool result 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.OPENCODE_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-tool-after-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.OPENCODE_SESSION_ID
+    || "";
+
+  if (!sessionId) {
+    process.stdout.write("{}\n");
+    return;
+  }
+
+  // Read stdin for tool result context
+  let inputData = "";
+  try {
+    inputData = require("fs").readFileSync(0, "utf8");
+  } catch {
+    // No stdin available
+  }
+
+  blog(`Unified tool-execute-after: session=${sessionId}`);
+
+  const hookInput = JSON.stringify({
+    session_id: sessionId,
+    cwd: process.cwd(),
+    harness: "opencode",
+    plugin_root: PLUGIN_ROOT,
+    tool_result: 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 post-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 opencode --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 opencode --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(`Post-tool-use hook failed: ${err.message} -- non-blocking`);
+    process.stdout.write("{}\n");
+  }
+}
+
+main();

package/hooks/babysitter-proxied-tool-execute-before.js

@@ -0,0 +1,166 @@
+#!/usr/bin/env node
+/**
+ * Unified Tool Execute Before Hook for OpenCode
+ * Routes through hooks-proxy for all hook execution.
+ *
+ * Fires before a tool execution in OpenCode. Delegates to
+ * `babysitter hook:run --hook-type pre-tool-use` via hooks-proxy.
+ *
+ * This hook can be used to:
+ * - Log tool invocations for babysitter run observability
+ * - Block certain tool calls during specific orchestration phases
+ * - Inject babysitter context into tool arguments
+ *
+ * OpenCode plugin protocol:
+ *   - 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.OPENCODE_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-tool-before-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.OPENCODE_SESSION_ID
+    || "";
+
+  if (!sessionId) {
+    // No session -- pass through without intervention
+    process.stdout.write("{}\n");
+    return;
+  }
+
+  // Read stdin for tool context
+  let inputData = "";
+  try {
+    inputData = require("fs").readFileSync(0, "utf8");
+  } catch {
+    // No stdin available
+  }
+
+  blog(`Unified tool-execute-before: session=${sessionId}`);
+
+  const hookInput = JSON.stringify({
+    session_id: sessionId,
+    cwd: process.cwd(),
+    harness: "opencode",
+    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 opencode --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 opencode --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

@@ -1,44 +1,44 @@
 {
   "version": 1,
-  "description": "Babysitter hook registration for OpenCode. Maps OpenCode plugin events to babysitter hook scripts.",
+  "description": "Babysitter hook registration for OpenCode. Maps OpenCode plugin events to unified babysitter hook scripts with hooks-proxy support.",
   "hooks": {
     "session.created": [
       {
         "type": "command",
-        "script": "hooks/session-created.js",
-        "description": "Initialize babysitter session state and inject context",
+        "script": "hooks/babysitter-proxied-session-created.js",
+        "description": "Initialize babysitter session state and inject context (proxied via a5c-hooks-proxy)",
         "timeoutMs": 30000
       }
     ],
     "session.idle": [
       {
         "type": "command",
-        "script": "hooks/session-idle.js",
-        "description": "Check for pending babysitter effects when agent goes idle",
+        "script": "hooks/babysitter-proxied-session-idle.js",
+        "description": "Check for pending babysitter effects when agent goes idle (proxied via a5c-hooks-proxy)",
         "timeoutMs": 30000
       }
     ],
     "shell.env": [
       {
         "type": "command",
-        "script": "hooks/shell-env.js",
-        "description": "Inject BABYSITTER_SESSION_ID and other env vars into shell",
+        "script": "hooks/babysitter-proxied-shell-env.js",
+        "description": "Inject BABYSITTER_SESSION_ID and other env vars into shell (proxied via a5c-hooks-proxy)",
         "timeoutMs": 5000
       }
     ],
     "tool.execute.before": [
       {
         "type": "command",
-        "script": "hooks/tool-execute-before.js",
-        "description": "Pre-tool-use hook for babysitter awareness",
+        "script": "hooks/babysitter-proxied-tool-execute-before.js",
+        "description": "Pre-tool-use hook for babysitter awareness (proxied via a5c-hooks-proxy)",
         "timeoutMs": 10000
       }
     ],
     "tool.execute.after": [
       {
         "type": "command",
-        "script": "hooks/tool-execute-after.js",
-        "description": "Post-tool-use hook for babysitter awareness",
+        "script": "hooks/babysitter-proxied-tool-execute-after.js",
+        "description": "Post-tool-use hook for babysitter awareness (proxied via a5c-hooks-proxy)",
         "timeoutMs": 10000
       }
     ]

package/hooks/hooks.json.legacy

@@ -0,0 +1,46 @@
+{
+  "version": 1,
+  "description": "Babysitter hook registration for OpenCode. Maps OpenCode plugin events to babysitter hook scripts.",
+  "hooks": {
+    "session.created": [
+      {
+        "type": "command",
+        "script": "hooks/session-created.js",
+        "description": "Initialize babysitter session state and inject context",
+        "timeoutMs": 30000
+      }
+    ],
+    "session.idle": [
+      {
+        "type": "command",
+        "script": "hooks/session-idle.js",
+        "description": "Check for pending babysitter effects when agent goes idle",
+        "timeoutMs": 30000
+      }
+    ],
+    "shell.env": [
+      {
+        "type": "command",
+        "script": "hooks/shell-env.js",
+        "description": "Inject BABYSITTER_SESSION_ID and other env vars into shell",
+        "timeoutMs": 5000
+      }
+    ],
+    "tool.execute.before": [
+      {
+        "type": "command",
+        "script": "hooks/tool-execute-before.js",
+        "description": "Pre-tool-use hook for babysitter awareness",
+        "timeoutMs": 10000
+      }
+    ],
+    "tool.execute.after": [
+      {
+        "type": "command",
+        "script": "hooks/tool-execute-after.js",
+        "description": "Post-tool-use hook for babysitter awareness",
+        "timeoutMs": 10000
+      }
+    ]
+  }
+}

package/hooks/proxied-hooks.json

@@ -0,0 +1,47 @@
+{
+  "_comment": "NOT ACTIVE — Alternative hooks.json using per-hook unified scripts with hooks-proxy support. To activate, replace hooks.json with this file.",
+  "version": 1,
+  "description": "Babysitter hook registration for OpenCode. Maps OpenCode plugin events to unified babysitter hook scripts with hooks-proxy support.",
+  "hooks": {
+    "session.created": [
+      {
+        "type": "command",
+        "script": "hooks/babysitter-proxied-session-created.js",
+        "description": "Initialize babysitter session state and inject context (proxied via a5c-hooks-proxy)",
+        "timeoutMs": 30000
+      }
+    ],
+    "session.idle": [
+      {
+        "type": "command",
+        "script": "hooks/babysitter-proxied-session-idle.js",
+        "description": "Check for pending babysitter effects when agent goes idle (proxied via a5c-hooks-proxy)",
+        "timeoutMs": 30000
+      }
+    ],
+    "shell.env": [
+      {
+        "type": "command",
+        "script": "hooks/babysitter-proxied-shell-env.js",
+        "description": "Inject BABYSITTER_SESSION_ID and other env vars into shell (proxied via a5c-hooks-proxy)",
+        "timeoutMs": 5000
+      }
+    ],
+    "tool.execute.before": [
+      {
+        "type": "command",
+        "script": "hooks/babysitter-proxied-tool-execute-before.js",
+        "description": "Pre-tool-use hook for babysitter awareness (proxied via a5c-hooks-proxy)",
+        "timeoutMs": 10000
+      }
+    ],
+    "tool.execute.after": [
+      {
+        "type": "command",
+        "script": "hooks/babysitter-proxied-tool-execute-after.js",
+        "description": "Post-tool-use hook for babysitter awareness (proxied via a5c-hooks-proxy)",
+        "timeoutMs": 10000
+      }
+    ]
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a5c-ai/babysitter-opencode",
-  "version": "5.0.1-staging.b5c14f2a",
+  "version": "5.0.1-staging.c66885f8",
   "description": "Babysitter orchestration plugin for OpenCode with SDK-managed process-library bootstrapping and in-turn iteration model",
   "scripts": {
     "test": "node test/integration.test.js",
@@ -41,6 +41,6 @@
   },
   "homepage": "https://github.com/a5c-ai/babysitter/tree/main/plugins/babysitter-opencode#readme",
   "dependencies": {
-    "@a5c-ai/babysitter-sdk": "5.0.1-staging.b5c14f2a"
+    "@a5c-ai/babysitter-sdk": "5.0.1-staging.c66885f8"
   }
 }

package/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "babysitter",
-  "version": "5.0.1-staging.b5c14f2a",
+  "version": "5.0.1-staging.c66885f8",
   "description": "Orchestrate complex, multi-step workflows with event-sourced state management, hook-based extensibility, and human-in-the-loop approval -- powered by the Babysitter SDK",
   "author": "a5c.ai",
   "license": "MIT",

package/versions.json

@@ -1,4 +1,4 @@
 {
-  "sdkVersion": "5.0.1-staging.b5c14f2a",
+  "sdkVersion": "5.0.1-staging.c66885f8",
   "pluginVersion": "0.1.0"
 }