@creativeintelligence/abbie 0.1.0

package/extensions/abbie/index.ts

@@ -0,0 +1,646 @@
+/**
+ * Abbie Pi Extension
+ *
+ * Exposes Abbie CLI commands as native Pi tools so every Pi session
+ * (including bridge-spawned ones) gets structured access to:
+ * - Session management (list, replay, history)
+ * - Lifecycle reporting (progress, complete, blocked, start)
+ * - Context management (list, read, inject)
+ * - Project management (add, list, remove)
+ * - Preview deployments (deploy, list, status, stop)
+ * - Annotations (create, list, ack, reply, resolve)
+ * - Workspace health (status, doctor)
+ * - Orchestration (auto, digest, triage, backlog)
+ *
+ * Pattern: same as utils/ extension — pi.exec() wraps CLI invocations.
+ * The abbie CLI resolves its own auth from ~/.abbie/config.json.
+ */
+
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import { Type } from "@sinclair/typebox";
+
+const ABBIE = "abbie";
+
+function truncate(text: string, maxBytes = 50 * 1024): string {
+  if (Buffer.byteLength(text, "utf-8") <= maxBytes) return text;
+  return `${text.slice(0, maxBytes)}\n\n[Output truncated at ${Math.round(maxBytes / 1024)}KB]`;
+}
+
+function ok(text: string) {
+  return { content: [{ type: "text" as const, text: truncate(text) }], details: {} };
+}
+
+function err(msg: string) {
+  return { content: [{ type: "text" as const, text: msg }], details: { error: true } };
+}
+
+async function run(pi: ExtensionAPI, args: string[], cwd?: string, timeoutMs = 60_000) {
+  const r = await pi.exec(ABBIE, [...args, "--json"], { cwd, timeout: timeoutMs });
+  const output = r.stdout || r.stderr;
+  if (r.code !== 0 && !output) {
+    throw new Error(`abbie ${args[0]} exited with code ${r.code}`);
+  }
+  return output;
+}
+
+export default function abbieExtension(pi: ExtensionAPI) {
+
+  // ===========================================================================
+  // Sessions
+  // ===========================================================================
+
+  pi.registerTool({
+    name: "abbie_session_list",
+    label: "Abbie: List Sessions",
+    description: "List Pi sessions tracked in Convex. Shows recent sessions with status, project, model, duration.",
+    parameters: Type.Object({
+      status: Type.Optional(Type.String({ description: "Filter by status: active, completed, failed, pending" })),
+      project: Type.Optional(Type.String({ description: "Filter by project name" })),
+      limit: Type.Optional(Type.Number({ description: "Max sessions to return (default: 20)" })),
+    }),
+    async execute(_id, params, _signal, _onUpdate, ctx) {
+      const args = ["session", "list"];
+      if (params.status) args.push("--status", params.status);
+      if (params.project) args.push("--project", params.project);
+      if (params.limit) args.push("--limit", String(params.limit));
+      try { return ok(await run(pi, args, ctx.cwd)); }
+      catch (e: any) { return err(`Error: ${e.message}`); }
+    },
+  });
+
+  pi.registerTool({
+    name: "abbie_session_replay",
+    label: "Abbie: Replay Session",
+    description: "Replay a completed session's full transcript. Shows all messages, tool calls, and outcomes.",
+    parameters: Type.Object({
+      session_id: Type.String({ description: "Session ID to replay" }),
+      format: Type.Optional(Type.String({ description: "Output format: text (default), json, markdown" })),
+    }),
+    async execute(_id, params, _signal, _onUpdate, ctx) {
+      const args = ["session", "replay", params.session_id];
+      if (params.format) args.push("--format", params.format);
+      try { return ok(await run(pi, args, ctx.cwd, 120_000)); }
+      catch (e: any) { return err(`Error: ${e.message}`); }
+    },
+  });
+
+  pi.registerTool({
+    name: "abbie_history",
+    label: "Abbie: Session History",
+    description: "View session history with filtering. Shows sessions, reports, and activity timeline.",
+    parameters: Type.Object({
+      project: Type.Optional(Type.String({ description: "Filter by project name" })),
+      since: Type.Optional(Type.String({ description: "Time filter: 1h, 6h, 1d, 7d, 30d" })),
+      limit: Type.Optional(Type.Number({ description: "Max entries" })),
+    }),
+    async execute(_id, params, _signal, _onUpdate, ctx) {
+      const args = ["history"];
+      if (params.project) args.push("--project", params.project);
+      if (params.since) args.push("--since", params.since);
+      if (params.limit) args.push("--limit", String(params.limit));
+      try { return ok(await run(pi, args, ctx.cwd)); }
+      catch (e: any) { return err(`Error: ${e.message}`); }
+    },
+  });
+
+  // ===========================================================================
+  // Lifecycle Reports
+  // ===========================================================================
+
+  pi.registerTool({
+    name: "abbie_report_progress",
+    label: "Abbie: Report Progress",
+    description: "Report progress on current work. Posts to Convex + optionally Slack. Tracks what you're working on.",
+    parameters: Type.Object({
+      task: Type.String({ description: "What you're working on" }),
+      status: Type.Optional(Type.String({ description: "Progress status description" })),
+      project: Type.Optional(Type.String({ description: "Project name" })),
+      agent: Type.Optional(Type.String({ description: "Agent identity: claude, codex, copilot, gemini (default: claude)" })),
+    }),
+    async execute(_id, params, _signal, _onUpdate, ctx) {
+      const args = ["report", "progress", "--task", params.task];
+      if (params.status) args.push("--status", params.status);
+      if (params.project) args.push("--project", params.project);
+      if (params.agent) args.push("--agent", params.agent);
+      try { return ok(await run(pi, args, ctx.cwd)); }
+      catch (e: any) { return err(`Error: ${e.message}`); }
+    },
+  });
+
+  pi.registerTool({
+    name: "abbie_report_complete",
+    label: "Abbie: Report Complete",
+    description: "Report work as completed. Includes summary of what was done.",
+    parameters: Type.Object({
+      task: Type.String({ description: "Task that was completed" }),
+      summary: Type.Optional(Type.String({ description: "Summary of what was accomplished" })),
+      project: Type.Optional(Type.String({ description: "Project name" })),
+      agent: Type.Optional(Type.String({ description: "Agent identity (default: claude)" })),
+    }),
+    async execute(_id, params, _signal, _onUpdate, ctx) {
+      const args = ["report", "complete", "--task", params.task];
+      if (params.summary) args.push("--summary", params.summary);
+      if (params.project) args.push("--project", params.project);
+      if (params.agent) args.push("--agent", params.agent);
+      try { return ok(await run(pi, args, ctx.cwd)); }
+      catch (e: any) { return err(`Error: ${e.message}`); }
+    },
+  });
+
+  pi.registerTool({
+    name: "abbie_report_blocked",
+    label: "Abbie: Report Blocked",
+    description: "Report a blocker. Notifies via Slack and shows in dashboard attention section.",
+    parameters: Type.Object({
+      task: Type.String({ description: "Task that is blocked" }),
+      blocker: Type.String({ description: "What's blocking progress" }),
+      blocker_type: Type.Optional(Type.String({ description: "Type: dependency, question, bug, access, review" })),
+      project: Type.Optional(Type.String({ description: "Project name" })),
+      agent: Type.Optional(Type.String({ description: "Agent identity (default: claude)" })),
+    }),
+    async execute(_id, params, _signal, _onUpdate, ctx) {
+      const args = ["report", "blocked", "--task", params.task, "--blocker", params.blocker];
+      if (params.blocker_type) args.push("--blocker-type", params.blocker_type);
+      if (params.project) args.push("--project", params.project);
+      if (params.agent) args.push("--agent", params.agent);
+      try { return ok(await run(pi, args, ctx.cwd)); }
+      catch (e: any) { return err(`Error: ${e.message}`); }
+    },
+  });
+
+  // ===========================================================================
+  // Context
+  // ===========================================================================
+
+  pi.registerTool({
+    name: "abbie_context_list",
+    label: "Abbie: List Context",
+    description: "List available context artifacts — session handoffs, published context, injected docs.",
+    parameters: Type.Object({
+      type: Type.Optional(Type.String({ description: "Filter by type: handoff, publish, inject" })),
+      project: Type.Optional(Type.String({ description: "Filter by project" })),
+    }),
+    async execute(_id, params, _signal, _onUpdate, ctx) {
+      const args = ["context", "list"];
+      if (params.type) args.push("--type", params.type);
+      if (params.project) args.push("--project", params.project);
+      try { return ok(await run(pi, args, ctx.cwd)); }
+      catch (e: any) { return err(`Error: ${e.message}`); }
+    },
+  });
+
+  pi.registerTool({
+    name: "abbie_context_read",
+    label: "Abbie: Read Context",
+    description: "Read a specific context artifact by ID.",
+    parameters: Type.Object({
+      id: Type.String({ description: "Context artifact ID" }),
+    }),
+    async execute(_id, params, _signal, _onUpdate, ctx) {
+      try { return ok(await run(pi, ["context", "read", params.id], ctx.cwd)); }
+      catch (e: any) { return err(`Error: ${e.message}`); }
+    },
+  });
+
+  pi.registerTool({
+    name: "abbie_context_publish",
+    label: "Abbie: Publish Context",
+    description: "Publish a context artifact (handoff, summary, decision record) for other sessions to consume.",
+    parameters: Type.Object({
+      content: Type.String({ description: "Context content (markdown)" }),
+      title: Type.Optional(Type.String({ description: "Title for the artifact" })),
+      project: Type.Optional(Type.String({ description: "Associate with project" })),
+      type: Type.Optional(Type.String({ description: "Type: handoff, decision, summary" })),
+    }),
+    async execute(_id, params, _signal, _onUpdate, ctx) {
+      const args = ["context", "publish", "--content", params.content];
+      if (params.title) args.push("--title", params.title);
+      if (params.project) args.push("--project", params.project);
+      if (params.type) args.push("--type", params.type);
+      try { return ok(await run(pi, args, ctx.cwd)); }
+      catch (e: any) { return err(`Error: ${e.message}`); }
+    },
+  });
+
+  // ===========================================================================
+  // Projects
+  // ===========================================================================
+
+  pi.registerTool({
+    name: "abbie_project_list",
+    label: "Abbie: List Projects",
+    description: "List all projects tracked in Abbie with metadata (path, type, emoji, session count).",
+    parameters: Type.Object({}),
+    async execute(_id, _params, _signal, _onUpdate, ctx) {
+      try { return ok(await run(pi, ["project", "list"], ctx.cwd)); }
+      catch (e: any) { return err(`Error: ${e.message}`); }
+    },
+  });
+
+  pi.registerTool({
+    name: "abbie_project_add",
+    label: "Abbie: Add Project",
+    description: "Add or import a project into Abbie. Auto-detects type, structure, and tech stack.",
+    parameters: Type.Object({
+      path: Type.Optional(Type.String({ description: "Path to project (default: cwd)" })),
+      name: Type.Optional(Type.String({ description: "Override project name" })),
+      emoji: Type.Optional(Type.String({ description: "Project emoji" })),
+    }),
+    async execute(_id, params, _signal, _onUpdate, ctx) {
+      const args = ["project", "add"];
+      if (params.path) args.push("--path", params.path);
+      if (params.name) args.push("--name", params.name);
+      if (params.emoji) args.push("--emoji", params.emoji);
+      try { return ok(await run(pi, args, ctx.cwd)); }
+      catch (e: any) { return err(`Error: ${e.message}`); }
+    },
+  });
+
+  // ===========================================================================
+  // Previews
+  // ===========================================================================
+
+  pi.registerTool({
+    name: "abbie_preview_deploy",
+    label: "Abbie: Deploy Preview",
+    description: "Deploy the current project as a preview at preview.abbie.computer/<slug>.",
+    parameters: Type.Object({
+      name: Type.Optional(Type.String({ description: "Preview name" })),
+      port: Type.Optional(Type.Number({ description: "Local port to forward (default: auto-detect)" })),
+      access: Type.Optional(Type.String({ description: "Access mode: public, private, password" })),
+      password: Type.Optional(Type.String({ description: "Password (when access=password)" })),
+    }),
+    async execute(_id, params, _signal, _onUpdate, ctx) {
+      const args = ["preview"];
+      if (params.name) args.push("--name", params.name);
+      if (params.port) args.push("--port", String(params.port));
+      if (params.access) args.push("--access", params.access);
+      if (params.password) args.push("--password", params.password);
+      try { return ok(await run(pi, args, ctx.cwd, 120_000)); }
+      catch (e: any) { return err(`Error: ${e.message}`); }
+    },
+  });
+
+  pi.registerTool({
+    name: "abbie_preview_list",
+    label: "Abbie: List Previews",
+    description: "List active preview deployments with URLs, status, and access mode.",
+    parameters: Type.Object({
+      status: Type.Optional(Type.String({ description: "Filter: running, stopped, creating" })),
+    }),
+    async execute(_id, params, _signal, _onUpdate, ctx) {
+      const args = ["preview", "list"];
+      if (params.status) args.push("--status", params.status);
+      try { return ok(await run(pi, args, ctx.cwd)); }
+      catch (e: any) { return err(`Error: ${e.message}`); }
+    },
+  });
+
+  pi.registerTool({
+    name: "abbie_preview_stop",
+    label: "Abbie: Stop Preview",
+    description: "Stop a running preview deployment.",
+    parameters: Type.Object({
+      slug: Type.String({ description: "Preview slug (from the URL)" }),
+    }),
+    async execute(_id, params, _signal, _onUpdate, ctx) {
+      try { return ok(await run(pi, ["preview", "stop", "--slug", params.slug], ctx.cwd)); }
+      catch (e: any) { return err(`Error: ${e.message}`); }
+    },
+  });
+
+  // ===========================================================================
+  // Annotations
+  // ===========================================================================
+
+  pi.registerTool({
+    name: "abbie_annotation_create",
+    label: "Abbie: Create Annotation",
+    description: "Create an annotation on a preview — feedback, bug report, suggestion, or question.",
+    parameters: Type.Object({
+      preview_slug: Type.String({ description: "Preview slug to annotate" }),
+      content: Type.String({ description: "Annotation content" }),
+      intent: Type.Optional(Type.String({ description: "Intent: feedback, bug, suggestion, question, blocker" })),
+      severity: Type.Optional(Type.String({ description: "Severity: info, warning, critical" })),
+      selector: Type.Optional(Type.String({ description: "CSS selector for the annotated element" })),
+      url: Type.Optional(Type.String({ description: "URL path where annotation applies" })),
+    }),
+    async execute(_id, params, _signal, _onUpdate, ctx) {
+      const args = ["annotation", "create",
+        "--preview", params.preview_slug,
+        "--content", params.content,
+      ];
+      if (params.intent) args.push("--intent", params.intent);
+      if (params.severity) args.push("--severity", params.severity);
+      if (params.selector) args.push("--selector", params.selector);
+      if (params.url) args.push("--url", params.url);
+      try { return ok(await run(pi, args, ctx.cwd)); }
+      catch (e: any) { return err(`Error: ${e.message}`); }
+    },
+  });
+
+  pi.registerTool({
+    name: "abbie_annotation_list",
+    label: "Abbie: List Annotations",
+    description: "List annotations for a preview, optionally filtered by status.",
+    parameters: Type.Object({
+      preview_slug: Type.String({ description: "Preview slug" }),
+      status: Type.Optional(Type.String({ description: "Filter: open, resolved, all" })),
+    }),
+    async execute(_id, params, _signal, _onUpdate, ctx) {
+      const args = ["annotation", "list", "--preview", params.preview_slug];
+      if (params.status) args.push("--status", params.status);
+      try { return ok(await run(pi, args, ctx.cwd)); }
+      catch (e: any) { return err(`Error: ${e.message}`); }
+    },
+  });
+
+  pi.registerTool({
+    name: "abbie_annotation_resolve",
+    label: "Abbie: Resolve Annotation",
+    description: "Resolve an annotation, marking it as addressed.",
+    parameters: Type.Object({
+      id: Type.String({ description: "Annotation ID" }),
+      resolution: Type.Optional(Type.String({ description: "Resolution note" })),
+    }),
+    async execute(_id, params, _signal, _onUpdate, ctx) {
+      const args = ["annotation", "resolve", params.id];
+      if (params.resolution) args.push("--resolution", params.resolution);
+      try { return ok(await run(pi, args, ctx.cwd)); }
+      catch (e: any) { return err(`Error: ${e.message}`); }
+    },
+  });
+
+  // ===========================================================================
+  // Workspace Intelligence
+  // ===========================================================================
+
+  pi.registerTool({
+    name: "abbie_status",
+    label: "Abbie: Status",
+    description: "Show Abbie workspace status — bridge connection, sync state, active sessions, project health.",
+    parameters: Type.Object({}),
+    async execute(_id, _params, _signal, _onUpdate, ctx) {
+      try { return ok(await run(pi, ["status"], ctx.cwd)); }
+      catch (e: any) { return err(`Error: ${e.message}`); }
+    },
+  });
+
+  pi.registerTool({
+    name: "abbie_doctor",
+    label: "Abbie: Doctor",
+    description: "Run health checks on the Abbie workspace — config, auth, CLI versions, Convex connectivity.",
+    parameters: Type.Object({}),
+    async execute(_id, _params, _signal, _onUpdate, ctx) {
+      try { return ok(await run(pi, ["doctor"], ctx.cwd, 30_000)); }
+      catch (e: any) { return err(`Error: ${e.message}`); }
+    },
+  });
+
+  pi.registerTool({
+    name: "abbie_digest",
+    label: "Abbie: Generate Digest",
+    description: "Generate a workspace digest summarizing recent sessions, reports, and activity across projects.",
+    parameters: Type.Object({
+      since: Type.Optional(Type.String({ description: "Time range: 1h, 6h, 1d, 7d (default: 1d)" })),
+      project: Type.Optional(Type.String({ description: "Focus on specific project" })),
+    }),
+    async execute(_id, params, _signal, _onUpdate, ctx) {
+      const args = ["digest"];
+      if (params.since) args.push("--since", params.since);
+      if (params.project) args.push("--project", params.project);
+      try { return ok(await run(pi, args, ctx.cwd, 120_000)); }
+      catch (e: any) { return err(`Error: ${e.message}`); }
+    },
+  });
+
+  // ===========================================================================
+  // Orchestration
+  // ===========================================================================
+
+  pi.registerTool({
+    name: "abbie_auto",
+    label: "Abbie: Auto Mode",
+    description: "Run autonomous agent orchestration — discovers work, plans, and executes across the repo.",
+    parameters: Type.Object({
+      goal: Type.Optional(Type.String({ description: "Goal for autonomous work" })),
+      project: Type.Optional(Type.String({ description: "Target project" })),
+      agent: Type.Optional(Type.String({ description: "Agent to use: codex, copilot, claude, gemini" })),
+      dry_run: Type.Optional(Type.Boolean({ description: "Plan only, don't execute" })),
+    }),
+    async execute(_id, params, _signal, _onUpdate, ctx) {
+      const args = ["auto"];
+      if (params.goal) args.push("--goal", params.goal);
+      if (params.project) args.push("--project", params.project);
+      if (params.agent) args.push("--agent", params.agent);
+      if (params.dry_run) args.push("--dry-run");
+      try { return ok(await run(pi, args, ctx.cwd, 600_000)); }
+      catch (e: any) { return err(`Error: ${e.message}`); }
+    },
+  });
+
+  // ===========================================================================
+  // Triage
+  // ===========================================================================
+
+  pi.registerTool({
+    name: "abbie_triage_list",
+    label: "Abbie: List Triage Items",
+    description: "List items in the triage queue — issues, PRs, and tasks needing attention.",
+    parameters: Type.Object({
+      status: Type.Optional(Type.String({ description: "Filter: pending, claimed, done" })),
+      team: Type.Optional(Type.String({ description: "Filter by team" })),
+    }),
+    async execute(_id, params, _signal, _onUpdate, ctx) {
+      const args = ["triage", "list"];
+      if (params.status) args.push("--status", params.status);
+      if (params.team) args.push("--team", params.team);
+      try { return ok(await run(pi, args, ctx.cwd)); }
+      catch (e: any) { return err(`Error: ${e.message}`); }
+    },
+  });
+
+  pi.registerTool({
+    name: "abbie_triage_claim",
+    label: "Abbie: Claim Triage Item",
+    description: "Claim a triage item to work on it.",
+    parameters: Type.Object({
+      id: Type.String({ description: "Triage item ID or issue identifier" }),
+    }),
+    async execute(_id, params, _signal, _onUpdate, ctx) {
+      try { return ok(await run(pi, ["triage", "claim", params.id], ctx.cwd)); }
+      catch (e: any) { return err(`Error: ${e.message}`); }
+    },
+  });
+
+  // ===========================================================================
+  // Backlog
+  // ===========================================================================
+
+  pi.registerTool({
+    name: "abbie_backlog_list",
+    label: "Abbie: List Backlog",
+    description: "List backlog items with priority and status.",
+    parameters: Type.Object({
+      project: Type.Optional(Type.String({ description: "Filter by project" })),
+      status: Type.Optional(Type.String({ description: "Filter: open, claimed, done" })),
+    }),
+    async execute(_id, params, _signal, _onUpdate, ctx) {
+      const args = ["backlog", "list"];
+      if (params.project) args.push("--project", params.project);
+      if (params.status) args.push("--status", params.status);
+      try { return ok(await run(pi, args, ctx.cwd)); }
+      catch (e: any) { return err(`Error: ${e.message}`); }
+    },
+  });
+
+  pi.registerTool({
+    name: "abbie_backlog_add",
+    label: "Abbie: Add to Backlog",
+    description: "Add an item to the backlog for future work.",
+    parameters: Type.Object({
+      title: Type.String({ description: "Backlog item title" }),
+      description: Type.Optional(Type.String({ description: "Detailed description" })),
+      project: Type.Optional(Type.String({ description: "Associate with project" })),
+      priority: Type.Optional(Type.String({ description: "Priority: urgent, high, medium, low" })),
+    }),
+    async execute(_id, params, _signal, _onUpdate, ctx) {
+      const args = ["backlog", "add", "--title", params.title];
+      if (params.description) args.push("--description", params.description);
+      if (params.project) args.push("--project", params.project);
+      if (params.priority) args.push("--priority", params.priority);
+      try { return ok(await run(pi, args, ctx.cwd)); }
+      catch (e: any) { return err(`Error: ${e.message}`); }
+    },
+  });
+
+  // ===========================================================================
+  // Trace
+  // ===========================================================================
+
+  pi.registerTool({
+    name: "abbie_trace_export",
+    label: "Abbie: Export Trace",
+    description: "Export session traces for debugging or analysis.",
+    parameters: Type.Object({
+      session_id: Type.Optional(Type.String({ description: "Session ID to export (default: latest)" })),
+      format: Type.Optional(Type.String({ description: "Export format: json, markdown" })),
+    }),
+    async execute(_id, params, _signal, _onUpdate, ctx) {
+      const args = ["trace", "export"];
+      if (params.session_id) args.push(params.session_id);
+      if (params.format) args.push("--format", params.format);
+      try { return ok(await run(pi, args, ctx.cwd)); }
+      catch (e: any) { return err(`Error: ${e.message}`); }
+    },
+  });
+
+  // ===========================================================================
+  // Auto-bridge: start bridge daemon on Pi startup
+  // ===========================================================================
+
+  let bridgeProcess: ReturnType<typeof import("node:child_process").spawn> | null = null;
+
+  pi.on("resources_discover", async (event) => {
+    // Only auto-start on initial Pi launch, not reloads
+    if (event.reason !== "startup") return {};
+
+    // Skip if bridge is already running (e.g. user started it manually)
+    if (bridgeProcess && bridgeProcess.exitCode === null) return {};
+
+    // Check if abbie is configured (has auth)
+    const { existsSync, readFileSync } = await import("node:fs");
+    const { join } = await import("node:path");
+    const { homedir } = await import("node:os");
+    const { spawn: nodeSpawn } = await import("node:child_process");
+
+    const configPath = join(homedir(), ".abbie", "config.json");
+    if (!existsSync(configPath)) return {};
+
+    let config: { convexUrl?: string; bridgeSecret?: string };
+    try {
+      config = JSON.parse(readFileSync(configPath, "utf8"));
+    } catch {
+      return {};
+    }
+
+    // Need both convex URL and bridge secret to start
+    const convexUrl = config.convexUrl || process.env.NEXT_PUBLIC_CONVEX_URL || process.env.CONVEX_URL;
+    const bridgeSecret = config.bridgeSecret || process.env.ABBIE_BRIDGE_SECRET;
+    if (!convexUrl || !bridgeSecret) return {};
+
+    // Find the bridge script
+    const candidates = [
+      // Global install
+      join(homedir(), ".abbie", "bridge.ts"),
+      // In the CLI package (when installed via npm)
+      join(homedir(), ".nvm", "versions", "node", process.version.replace("v", ""), "lib", "node_modules", "@creativeintelligence", "abbie", "scripts", "pi-bridge.ts"),
+    ];
+
+    // Also try to find it via `abbie` CLI's package location
+    try {
+      const { execSync } = await import("node:child_process");
+      const abbiePath = execSync("which abbie", { encoding: "utf8", timeout: 3000 }).trim();
+      if (abbiePath) {
+        const { realpathSync } = await import("node:fs");
+        const realPath = realpathSync(abbiePath);
+        // abbie binary -> bin/run.js -> package root
+        const pkgRoot = join(realPath, "..", "..");
+        candidates.push(join(pkgRoot, "scripts", "pi-bridge.ts"));
+        candidates.push(join(pkgRoot, "scripts", "pi-bridge.js"));
+      }
+    } catch { /* not found */ }
+
+    // Development: look in common monorepo locations
+    candidates.push(join(homedir(), "Developer", "apps", "abbie", "abbie-xyz", "scripts", "pi-bridge.ts"));
+
+    let bridgeScript: string | null = null;
+    for (const c of candidates) {
+      if (existsSync(c)) {
+        bridgeScript = c;
+        break;
+      }
+    }
+
+    if (!bridgeScript) return {};
+
+    // Start bridge as background child process
+    try {
+      bridgeProcess = nodeSpawn(
+        "node",
+        ["--no-warnings", "--experimental-strip-types", bridgeScript],
+        {
+          env: {
+            ...process.env,
+            NEXT_PUBLIC_CONVEX_URL: convexUrl,
+            ABBIE_BRIDGE_SECRET: bridgeSecret,
+          },
+          stdio: "ignore",
+          detached: false, // dies when Pi dies
+        },
+      );
+
+      bridgeProcess.unref(); // don't block Pi's event loop
+
+      // Clean up on Pi exit
+      process.on("exit", () => {
+        if (bridgeProcess && bridgeProcess.exitCode === null) {
+          bridgeProcess.kill("SIGTERM");
+        }
+      });
+    } catch {
+      // Non-fatal — bridge auto-start is best-effort
+    }
+
+    return {};
+  });
+
+  // Clean shutdown
+  pi.on("session_shutdown", async () => {
+    if (bridgeProcess && bridgeProcess.exitCode === null) {
+      bridgeProcess.kill("SIGTERM");
+      bridgeProcess = null;
+    }
+    return {};
+  });
+}

package/extensions/abbie/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "pi-ext-abbie",
+  "version": "1.0.0",
+  "type": "module",
+  "private": true,
+  "dependencies": {
+    "@sinclair/typebox": "^0.34.0"
+  }
+}