@a5c-ai/babysitter-opencode 5.0.1-staging.d73033a7 → 5.0.1-staging.d8bdfcceaf4a

package/hooks/session-idle.js

@@ -1,124 +0,0 @@
-#!/usr/bin/env node
-/**
- * Babysitter Session Idle Hook for OpenCode
- *
- * 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` (which handles the
- * run-state inspection and iteration tracking).
- *
- * 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 } = 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");
-
-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 runBabysitterHook(hookType, inputJson) {
-  const sdkVersion = getSdkVersion();
-  const args = [
-    "hook:run",
-    "--hook-type", hookType,
-    "--harness", "opencode",
-    "--plugin-root", PLUGIN_ROOT,
-    "--state-dir", STATE_DIR,
-    "--json",
-  ];
-
-  try {
-    const result = execSync(`babysitter ${args.join(" ")}`, {
-      input: inputJson,
-      stdio: ["pipe", "pipe", "pipe"],
-      timeout: 30000,
-      env: { ...process.env, BABYSITTER_STATE_DIR: STATE_DIR },
-    });
-    return result.toString("utf8").trim();
-  } catch {
-    try {
-      const result = execSync(`npx -y "@a5c-ai/babysitter-sdk@${sdkVersion}" ${args.join(" ")}`, {
-        input: inputJson,
-        stdio: ["pipe", "pipe", "pipe"],
-        timeout: 60000,
-        env: { ...process.env, BABYSITTER_STATE_DIR: STATE_DIR },
-      });
-      return result.toString("utf8").trim();
-    } catch (err) {
-      blog(`Hook execution failed: ${err.message}`);
-      return "{}";
-    }
-  }
-}
-
-function main() {
-  blog("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 hookInput = JSON.stringify({
-    session_id: sessionId,
-    cwd: process.cwd(),
-    harness: "opencode",
-    plugin_root: PLUGIN_ROOT,
-  });
-
-  blog(`Checking run status for session ${sessionId}`);
-
-  // Delegate to the stop hook handler, which inspects run state
-  // and returns block/allow decisions
-  const result = runBabysitterHook("stop", hookInput);
-
-  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/shell-env.js

@@ -1,88 +0,0 @@
-#!/usr/bin/env node
-/**
- * Babysitter Shell Environment Hook for OpenCode
- *
- * 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 } = 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 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");
-
-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 main() {
-  blog("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();
-
-  // 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;
-  }
-
-  blog(`Injecting env: ${JSON.stringify(env)}`);
-
-  process.stdout.write(JSON.stringify({ env }) + "\n");
-}
-
-main();

package/hooks/tool-execute-after.js

@@ -1,107 +0,0 @@
-#!/usr/bin/env node
-/**
- * Babysitter Tool Execute After Hook for OpenCode
- *
- * Fires after a tool execution in OpenCode. Delegates to
- * `babysitter hook:run --hook-type post-tool-use` for post-tool-use awareness.
- *
- * 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 } = 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");
-
-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 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(`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();
-  const args = [
-    "hook:run",
-    "--hook-type", "post-tool-use",
-    "--harness", "opencode",
-    "--plugin-root", PLUGIN_ROOT,
-    "--state-dir", STATE_DIR,
-    "--json",
-  ];
-
-  try {
-    const result = execSync(`babysitter ${args.join(" ")}`, {
-      input: hookInput,
-      stdio: ["pipe", "pipe", "pipe"],
-      timeout: 10000,
-      env: { ...process.env, BABYSITTER_STATE_DIR: STATE_DIR },
-    });
-    const output = result.toString("utf8").trim();
-    blog(`Hook result: ${output}`);
-    process.stdout.write((output || "{}") + "\n");
-  } catch {
-    blog("Post-tool-use hook failed -- non-blocking");
-    process.stdout.write("{}\n");
-  }
-}
-
-main();

package/hooks/tool-execute-before.js

@@ -1,109 +0,0 @@
-#!/usr/bin/env node
-/**
- * Babysitter Tool Execute Before Hook for OpenCode
- *
- * Fires before a tool execution in OpenCode. Delegates to
- * `babysitter hook:run --hook-type pre-tool-use` for pre-tool-use awareness.
- *
- * 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 } = 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");
-
-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 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(`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();
-  const args = [
-    "hook:run",
-    "--hook-type", "pre-tool-use",
-    "--harness", "opencode",
-    "--plugin-root", PLUGIN_ROOT,
-    "--state-dir", STATE_DIR,
-    "--json",
-  ];
-
-  try {
-    const result = execSync(`babysitter ${args.join(" ")}`, {
-      input: hookInput,
-      stdio: ["pipe", "pipe", "pipe"],
-      timeout: 10000,
-      env: { ...process.env, BABYSITTER_STATE_DIR: STATE_DIR },
-    });
-    const output = result.toString("utf8").trim();
-    blog(`Hook result: ${output}`);
-    process.stdout.write((output || "{}") + "\n");
-  } catch {
-    // On failure, allow the tool execution to proceed
-    blog("Pre-tool-use hook failed -- allowing execution");
-    process.stdout.write("{}\n");
-  }
-}
-
-main();

package/scripts/sync-command-docs.cjs

@@ -1,107 +0,0 @@
-'use strict';
-
-const path = require('path');
-const {
-  listMarkdownBasenames,
-  reportCheckResult,
-  syncCommandMirrors,
-  syncSkillsFromCommands,
-  writeFileIfChanged,
-} = require('../../../scripts/plugin-command-sync-lib.cjs');
-
-const PACKAGE_ROOT = path.resolve(__dirname, '..');
-const REPO_ROOT = path.resolve(PACKAGE_ROOT, '..', '..');
-const ROOT_COMMANDS = path.join(REPO_ROOT, 'plugins', 'babysitter', 'commands');
-const COMMANDS_ROOT = path.join(PACKAGE_ROOT, 'commands');
-const SKILLS_ROOT = path.join(PACKAGE_ROOT, 'skills');
-const LABEL = 'babysitter-opencode sync';
-
-const BABYSIT_SKILL = `---
-name: babysit
-description: Orchestrate via @babysitter. Use this skill when asked to babysit a run, orchestrate a process or whenever it is called explicitly. (babysit, babysitter, orchestrate, orchestrate a run, workflow, etc.)
----
-
-# babysit
-
-Orchestrate \`.a5c/runs/<runId>/\` through iterative execution.
-
-## Dependencies
-
-### Babysitter SDK and CLI
-
-Read the SDK version from \`versions.json\` to ensure version compatibility:
-
-\`\`\`bash
-SDK_VERSION=$(node -e "try{const fs=require('fs');const probes=['./plugins/babysitter-opencode/versions.json','./node_modules/@a5c-ai/babysitter-opencode/versions.json'];for(const probe of probes){if(fs.existsSync(probe)){console.log(JSON.parse(fs.readFileSync(probe,'utf8')).sdkVersion||'latest');process.exit(0)}}console.log('latest')}catch{console.log('latest')}")
-
-npm i -g @a5c-ai/babysitter-sdk@$SDK_VERSION
-CLI="npx -y @a5c-ai/babysitter-sdk@$SDK_VERSION"
-\`\`\`
-
-## Instructions
-
-Run the following command to get full orchestration instructions:
-
-\`\`\`bash
-babysitter instructions:babysit-skill --harness opencode --interactive
-\`\`\`
-
-For non-interactive mode:
-
-\`\`\`bash
-babysitter instructions:babysit-skill --harness opencode --no-interactive
-\`\`\`
-
-Follow the instructions returned by the command above to orchestrate the run.
-`;
-
-function getCommandNames() {
-  return listMarkdownBasenames(ROOT_COMMANDS);
-}
-
-function main() {
-  const check = process.argv.includes('--check');
-  const commandNames = getCommandNames();
-  const mirrorResult = syncCommandMirrors({
-    label: LABEL,
-    sourceRoot: ROOT_COMMANDS,
-    targetRoot: COMMANDS_ROOT,
-    names: commandNames,
-    check,
-    cwd: PACKAGE_ROOT,
-  });
-  const skillsResult = syncSkillsFromCommands({
-    label: LABEL,
-    sourceRoot: COMMANDS_ROOT,
-    skillsRoot: SKILLS_ROOT,
-    names: commandNames,
-    check,
-    cwd: PACKAGE_ROOT,
-  });
-
-  const babysitSkillPath = path.join(SKILLS_ROOT, 'babysit', 'SKILL.md');
-  if (check) {
-    const fs = require('fs');
-    const stale = [...mirrorResult.stale, ...skillsResult.stale];
-    const current = fs.existsSync(babysitSkillPath)
-      ? fs.readFileSync(babysitSkillPath, 'utf8')
-      : null;
-    if (current !== BABYSIT_SKILL) {
-      stale.push(path.relative(PACKAGE_ROOT, babysitSkillPath));
-    }
-    reportCheckResult(LABEL, stale);
-    return;
-  }
-
-  const babysitUpdated = writeFileIfChanged(babysitSkillPath, BABYSIT_SKILL) ? 1 : 0;
-  const updated = mirrorResult.updated + skillsResult.updated + babysitUpdated;
-
-  if (updated === 0) {
-    console.log(`[${LABEL}] no OpenCode command or skill changes were needed.`);
-    return;
-  }
-
-  console.log(`[${LABEL}] updated ${updated} OpenCode command/skill file(s).`);
-}
-
-main();

package/scripts/sync-command-surfaces.js

@@ -1,52 +0,0 @@
-#!/usr/bin/env node
-/**
- * Sync command surfaces from the canonical babysitter plugin.
- *
- * Copies command .md files from the cursor/codex plugins or generates
- * them from the SDK CLI command definitions. Used during build/deploy
- * to keep command surfaces in sync across harness plugins.
- */
-
-"use strict";
-
-const fs = require("fs");
-const path = require("path");
-
-const PLUGIN_ROOT = path.resolve(__dirname, "..");
-const COMMANDS_DIR = path.join(PLUGIN_ROOT, "commands");
-
-// Check mode
-const checkOnly = process.argv.includes("--check");
-
-function main() {
-  // Verify commands directory exists and has files
-  if (!fs.existsSync(COMMANDS_DIR)) {
-    console.error("ERROR: commands/ directory not found");
-    process.exit(1);
-  }
-
-  const files = fs.readdirSync(COMMANDS_DIR).filter(f => f.endsWith(".md"));
-  if (files.length === 0) {
-    console.error("ERROR: No command .md files found in commands/");
-    process.exit(1);
-  }
-
-  console.log(`Found ${files.length} command files:`);
-  for (const file of files) {
-    const content = fs.readFileSync(path.join(COMMANDS_DIR, file), "utf8");
-    const hasHeader = content.startsWith("---");
-    const status = hasHeader ? "OK" : "MISSING FRONTMATTER";
-    console.log(`  ${file} [${status}]`);
-    if (checkOnly && !hasHeader) {
-      process.exit(1);
-    }
-  }
-
-  if (checkOnly) {
-    console.log("\nAll command files are valid.");
-  } else {
-    console.log("\nCommand surfaces synced.");
-  }
-}
-
-main();