@a5c-ai/babysitter-pi 0.1.0

package/scripts/setup.sh

@@ -0,0 +1,74 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# setup.sh — Full setup script for babysitter-pi plugin
+#
+# Installs npm dependencies, verifies the babysitter SDK,
+# creates necessary directories, and prints usage instructions.
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PLUGIN_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+NC='\033[0m' # No Color
+
+log()   { echo -e "${GREEN}[setup]${NC} $1"; }
+warn()  { echo -e "${YELLOW}[setup] WARNING:${NC} $1"; }
+error() { echo -e "${RED}[setup] ERROR:${NC} $1"; }
+
+# ── Check Node.js ──────────────────────────────────────────────────────
+log "Checking Node.js version..."
+if ! command -v node &>/dev/null; then
+  error "Node.js is not installed. Please install Node.js >= 18."
+  exit 1
+fi
+
+NODE_MAJOR=$(node -e "console.log(process.versions.node.split('.')[0])")
+if [ "$NODE_MAJOR" -lt 18 ]; then
+  error "Node.js v$(node -v) detected. babysitter-pi requires Node.js >= 18."
+  exit 1
+fi
+log "Node.js v$(node -v | tr -d 'v') — OK"
+
+# ── Install npm dependencies ──────────────────────────────────────────
+log "Installing npm dependencies..."
+cd "$PLUGIN_DIR"
+if [ -f "package.json" ]; then
+  npm install --no-audit --no-fund 2>&1 || {
+    warn "npm install encountered issues, but continuing setup."
+  }
+  log "Dependencies installed."
+else
+  warn "No package.json found in $PLUGIN_DIR — skipping npm install."
+fi
+
+# ── Verify babysitter SDK ─────────────────────────────────────────────
+log "Checking for @a5c-ai/babysitter-sdk..."
+SDK_CHECK=$(node -e "try { require('@a5c-ai/babysitter-sdk'); console.log('ok'); } catch(e) { console.log('missing'); }" 2>/dev/null)
+if [ "$SDK_CHECK" = "ok" ]; then
+  log "@a5c-ai/babysitter-sdk — OK"
+else
+  warn "@a5c-ai/babysitter-sdk not found. Install it with: npm install @a5c-ai/babysitter-sdk"
+fi
+
+# ── Create necessary directories ─────────────────────────────────────
+log "Creating directories..."
+mkdir -p "$PLUGIN_DIR/state"
+log "State directory ready: $PLUGIN_DIR/state"
+
+# ── Print usage instructions ─────────────────────────────────────────
+echo ""
+echo "============================================"
+echo "  babysitter-pi plugin setup complete"
+echo "============================================"
+echo ""
+echo "Usage:"
+echo "  babysitter plugin:install pi --marketplace-name <name> --project"
+echo "  babysitter plugin:configure pi --marketplace-name <name> --project"
+echo ""
+echo "For more information, see: $PLUGIN_DIR/README.md"
+echo ""
+
+log "Done."

package/scripts/sync-command-docs.cjs

@@ -0,0 +1,115 @@
+'use strict';
+
+const path = require('path');
+const {
+  normalizeNewlines,
+  reportCheckResult,
+  writeFileIfChanged,
+} = require('../../../scripts/plugin-command-sync-lib.cjs');
+
+const PACKAGE_ROOT = path.resolve(__dirname, '..');
+const COMMANDS_ROOT = path.join(PACKAGE_ROOT, 'commands');
+const LABEL = 'babysitter-pi sync';
+
+const HARNESS_LABEL = 'pi';
+const TROUBLESHOOT_CMD = 'where pi';
+
+const COMMAND_DOCS = {
+  'babysitter-call.md': `---
+name: babysitter:call
+description: Start a babysitter orchestration run
+arguments:
+  - name: prompt
+    description: The task to orchestrate
+    required: true
+---
+
+Start a babysitter orchestration run. Creates a new run using the SDK, binds it to the current session, and begins iteration.
+
+This command initialises a fresh babysitter run with the given prompt, associates it with the active ${HARNESS_LABEL} session, and kicks off the first orchestration iteration. The loop driver will continue iterating automatically on subsequent \`agent_end\` events until the run completes, fails, or a guard trips.
+`,
+  'babysitter-resume.md': `---
+name: babysitter:resume
+description: Resume a previously stopped or interrupted babysitter run
+arguments:
+  - name: runId
+    description: The run ID to resume
+    required: true
+---
+
+Resume an existing babysitter orchestration run that was previously stopped, interrupted, or is in a waiting state. Re-binds the run to the current session and continues iteration from where it left off.
+
+## Behaviour
+
+1. Locates the run directory for the given run ID.
+2. Reads run metadata and journal to determine current state.
+3. Re-binds the run to the active ${HARNESS_LABEL} session.
+`,
+  'babysitter-doctor.md': `---
+name: babysitter:doctor
+description: Diagnose the health of a babysitter run
+arguments:
+  - name: runId
+    description: Optional run ID to diagnose (defaults to the active run)
+    required: false
+---
+
+Run diagnostic checks against a babysitter run to identify potential issues. Inspects run metadata, journal integrity, state cache, lock files, and effect health.
+`,
+  'babysitter-status.md': `---
+name: babysitter:status
+description: Check the status of the active babysitter run
+arguments:
+  - name: runId
+    description: Optional run ID to check (defaults to the active run)
+    required: false
+---
+
+Check the current status of a babysitter orchestration run.
+
+## Notes
+
+- When called without arguments, reports on the run bound to the current session.
+- If discovery reports \`${HARNESS_LABEL}\` as installed but direct invocation fails, validate \`${TROUBLESHOOT_CMD}\`.
+`,
+};
+
+function main() {
+  const check = process.argv.includes('--check');
+  const stale = [];
+  let updated = 0;
+
+  for (const [fileName, expectedRaw] of Object.entries(COMMAND_DOCS)) {
+    const targetPath = path.join(COMMANDS_ROOT, fileName);
+    const expected = normalizeNewlines(expectedRaw);
+
+    if (check) {
+      const actual = require('fs').existsSync(targetPath)
+        ? normalizeNewlines(require('fs').readFileSync(targetPath, 'utf8'))
+        : null;
+      if (actual !== expected) {
+        stale.push(path.relative(PACKAGE_ROOT, targetPath));
+      }
+      continue;
+    }
+
+    if (writeFileIfChanged(targetPath, expected)) {
+      updated += 1;
+      console.log(`[${LABEL}] updated ${path.relative(PACKAGE_ROOT, targetPath)}`);
+    }
+  }
+
+  if (check) {
+    reportCheckResult(LABEL, stale);
+    return;
+  }
+
+  if (updated === 0) {
+    console.log(`[${LABEL}] no PI command doc changes were needed.`);
+    return;
+  }
+
+  console.log(`[${LABEL}] updated ${updated} PI command doc file(s).`);
+}
+
+main();

package/skills/babysitter/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: babysitter
+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.)
+---
+
+# babysitter
+
+Orchestrate `.a5c/runs/<runId>/` through iterative execution.
+
+## Dependencies
+
+### Babysitter SDK and CLI
+
+Read the SDK version from the plugin manifest to ensure version compatibility:
+
+```bash
+PLUGIN_ROOT="${PI_PLUGIN_ROOT:-$OMP_PLUGIN_ROOT}"
+SDK_VERSION=$(node -e "try{const root=process.env.PI_PLUGIN_ROOT||process.env.OMP_PLUGIN_ROOT;console.log(root?JSON.parse(require('fs').readFileSync(require('path').join(root,'versions.json'),'utf8')).sdkVersion||'latest':'latest')}catch{console.log('latest')}")
+sudo npm i -g @a5c-ai/babysitter-sdk@$SDK_VERSION
+# sudo is depending on the env and system
+```
+
+then use the CLI alias: CLI="babysitter"
+
+**Alternatively, use the CLI alias:** `CLI="npx -y @a5c-ai/babysitter-sdk@$SDK_VERSION"`
+
+### jq
+
+make sure you have jq installed and available in the path. if not, install it.
+
+## Instructions
+
+Run the following command to get full orchestration instructions:
+
+```bash
+babysitter instructions:babysit-skill --harness pi --interactive
+```
+
+For non-interactive mode (running with `-p` flag or no AskUserQuestion tool):
+
+```bash
+babysitter instructions:babysit-skill --harness pi --no-interactive
+```
+
+Follow the instructions returned by the command above to orchestrate the run.