@sage-protocol/pi-adapter 0.4.3 → 0.5.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sage-protocol/pi-adapter",
-  "version": "0.4.3",
+  "version": "0.5.2",
   "description": "Sage Protocol MCP integration for pi coding agent",
   "type": "module",
   "main": "./dist/index.js",
@@ -20,23 +20,24 @@
   ],
   "pi": {
     "extensions": [
-      "./extensions"
+      "./extensions/index.ts"
     ]
   },
   "scripts": {
-    "build": "tsc -p tsconfig.build.json",
+    "build": "npm run build:types && npm run build:bundle",
+    "build:types": "tsc -p tsconfig.build.json --emitDeclarationOnly",
+    "build:bundle": "esbuild src/index.ts --bundle --platform=node --format=esm --outfile=dist/index.js --legal-comments=none",
     "dev": "tsc -p tsconfig.build.json --watch",
     "clean": "rm -rf dist",
     "typecheck": "tsc -p tsconfig.build.json --noEmit",
     "test": "vitest --run",
+    "profile:outputs": "node scripts/profile-outputs.mjs",
+    "test:pi-sdk": "node scripts/test-pi-sdk.mjs",
     "prepare": "npm run build",
     "prepublishOnly": "npm run clean && npm run build"
   },
-  "dependencies": {
-    "@sinclair/typebox": "^0.34.0"
-  },
   "peerDependencies": {
-    "@earendil-works/pi-coding-agent": ">=0.64.0 <0.85.0",
+    "@earendil-works/pi-coding-agent": ">=0.64.0 <0.87.0",
     "@earendil-works/pi-tui": "*"
   },
   "peerDependenciesMeta": {
@@ -45,7 +46,9 @@
     }
   },
   "devDependencies": {
+    "@sinclair/typebox": "^0.34.0",
     "@types/node": "^24.0.0",
+    "esbuild": "^0.25.0",
     "typescript": "^5.7.0",
     "vitest": "^4.1.8"
   },

package/dist/behavior/index.js

@@ -1,9 +0,0 @@
-/**
- * @file behavior/index.ts
- *
- * Responsibility: Public API surface for the behavior execution subsystem.
- * Re-exports types and implementations — nothing else.
- */
-export { resolveBehaviorPlan } from "./resolver.js";
-export { PiBehaviorExecutor } from "./pi-executor.js";
-//# sourceMappingURL=index.js.map

package/dist/behavior/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/behavior/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAyB,MAAM,kBAAkB,CAAC"}

package/dist/behavior/pi-executor.js

@@ -1,188 +0,0 @@
-/**
- * @file behavior/pi-executor.ts
- *
- * Responsibility: Pi-specific implementation of the BehaviorExecutor interface.
- * Executes behavior plan steps as pi subagent invocations.
- *
- * Invariants:
- * - Each step runs in an isolated subagent context (explorer for read-only, worker for mutations).
- * - Inter-step results are threaded via the subagent task message.
- * - MCP servers from the plan's mcp_servers_union are provisioned before execution.
- * - Cancellation via AbortSignal is respected between steps (not mid-step).
- * - This file is the ONLY place that depends on pi's subagent API.
- */
-import { resolveBehaviorPlan } from "./resolver.js";
-/**
- * Pi-specific BehaviorExecutor.
- *
- * Executes behavior plan steps sequentially, threading output from each step
- * as context into the next. In pi, each step maps to a subagent task — but
- * since the adapter runs as an extension (not the agent loop controller),
- * we execute via tool result injection: the plan is rendered as a structured
- * controller prompt that the agent follows step-by-step.
- *
- * Why not spawn_agent directly?
- * The pi extension API doesn't expose spawn_agent — that's a tool available
- * to the agent itself. The executor prepares the plan for the agent to execute,
- * optionally with subagent delegation hints.
- *
- * Execution modes:
- * 1. **Controller prompt** (default): Render the plan as a structured prompt
- *    the agent follows. Steps include skill content and dependency hints.
- *    The agent decides whether to use subagents based on step complexity.
- *
- * 2. **Explicit delegation** (future): For plans with `isolation: "subagent"`
- *    on steps, the executor would need the agent to call spawn_agent per step.
- *    This requires the agent loop, not the extension layer.
- */
-export class PiBehaviorExecutor {
-    name = "pi-behavior-executor";
-    bridge;
-    sendMessage;
-    constructor(config) {
-        this.bridge = config.bridge;
-        this.sendMessage = config.sendMessage;
-    }
-    async resolve(key) {
-        return resolveBehaviorPlan(this.bridge, key);
-    }
-    canExecute(plan) {
-        // We can execute any linear plan. Reject empty plans.
-        return plan.steps.length > 0;
-    }
-    async execute(plan, context) {
-        const startTime = Date.now();
-        const results = [];
-        // Render the plan as a controller prompt for the agent.
-        // This is plan injection (Smithers-style), not step completion.
-        const controllerPrompt = this.renderControllerPrompt(plan, context);
-        // Report plan to the agent via hook message
-        if (this.sendMessage) {
-            this.sendMessage({
-                customType: "sage-behavior-plan",
-                content: controllerPrompt,
-                display: true,
-            });
-        }
-        // Steps remain awaiting_agent until the host has real step results.
-        // Never claim completed solely because the plan was rendered.
-        for (const step of plan.steps) {
-            const stepStart = Date.now();
-            context.onProgress?.(step.id, "awaiting_agent");
-            results.push({
-                stepId: step.id,
-                status: "awaiting_agent",
-                durationMs: Date.now() - stepStart,
-            });
-        }
-        return {
-            status: "awaiting_agent",
-            steps: results,
-            totalDurationMs: Date.now() - startTime,
-            output: controllerPrompt,
-        };
-    }
-    /**
-     * Render a behavior plan as a structured controller prompt.
-     *
-     * The controller prompt is designed to be injected into the agent's context,
-     * giving it a step-by-step execution plan with:
-     * - Skill content for each step
-     * - Dependency hints (which steps feed into which)
-     * - MCP server requirements
-     * - Subagent delegation hints for complex steps
-     */
-    renderControllerPrompt(plan, context) {
-        const lines = [];
-        // Smithers-inspired: plan is an authority envelope + step menu, not a runtime.
-        // Status stays awaiting_agent until steps are actually done.
-        lines.push("# Behavior Plan (controller inject — not a completed run)");
-        lines.push("");
-        lines.push("This is a **durable step plan** for you (the agent) to execute with tools.");
-        lines.push("The adapter has **not** completed these steps. Status: `awaiting_agent`.");
-        lines.push("");
-        lines.push(`**Task:** ${context.task}`);
-        lines.push(`**Steps:** ${plan.steps.length}`);
-        lines.push("");
-        lines.push("## Load rule (per step)");
-        lines.push("");
-        lines.push("1. Load the **full** skill procedure for the step (`/skill:<key>`, read SKILL.md, or skills.get).");
-        lines.push("2. Freestyle tools **under that skill's constraints** — ranking/plan text is not enough.");
-        lines.push("3. Only after step work is done, move to the next step in order.");
-        lines.push("4. Report outcomes with `sage suggest feedback outcome <skill-key> --status passed|failed` when a procedure guided work.");
-        lines.push("");
-        if (context.mcpServersRequired.length > 0) {
-            lines.push("## Required MCP Servers");
-            for (const server of context.mcpServersRequired) {
-                lines.push(`- \`${server}\``);
-            }
-            lines.push("");
-        }
-        lines.push("## Execution Steps");
-        lines.push("");
-        lines.push("Execute the following steps **in order**. Each step builds on the previous.");
-        lines.push("For complex steps, consider delegating to a subagent (explorer for analysis, worker for implementation).");
-        lines.push("");
-        for (let i = 0; i < plan.steps.length; i++) {
-            const step = plan.steps[i];
-            lines.push(`### Step ${i + 1}: ${step.title}`);
-            lines.push("");
-            lines.push(`**Skill:** \`${step.skill_key}\``);
-            lines.push(`**Status:** awaiting_agent`);
-            lines.push(`**Load:** \`/skill:${step.skill_key}\` or \`sage library inspect skill get ${step.skill_key}\` or skills.get before freestyle`);
-            if (step.uses.length > 0) {
-                lines.push(`**Depends on:** ${step.uses.join(", ")}`);
-            }
-            lines.push("");
-            if (step.instruction) {
-                lines.push(step.instruction);
-                lines.push("");
-            }
-            else {
-                lines.push(`_No body in plan — load full skill \`${step.skill_key}\` before acting._`);
-                lines.push("");
-            }
-            // Subagent delegation hint for steps that benefit from isolation
-            if (this.shouldSuggestSubagent(step, plan.steps.length)) {
-                lines.push(`> 💡 **Subagent hint:** This step may benefit from running in an isolated subagent.`);
-                lines.push(`> Use \`explorer\` for analysis/read-only steps, \`worker\` for implementation steps.`);
-                lines.push("");
-            }
-            if (i < plan.steps.length - 1) {
-                lines.push("---");
-                lines.push("");
-            }
-        }
-        lines.push("");
-        lines.push("## Completion");
-        lines.push("");
-        lines.push("After completing all steps, synthesize the results into a coherent response.");
-        lines.push("Reference findings from each step and note any cross-step insights.");
-        lines.push("Do not treat plan injection alone as success; only completed step work counts.");
-        return lines.join("\n");
-    }
-    /**
-     * Heuristic: suggest subagent delegation for steps that benefit from isolation.
-     *
-     * - Plans with 4+ steps: suggest subagents for analysis-heavy steps
-     * - Steps with large instruction bodies (>2000 chars): benefit from dedicated context
-     * - Steps that are read-only analysis: explorer subagent
-     */
-    shouldSuggestSubagent(step, totalSteps) {
-        if (totalSteps < 3)
-            return false; // Small plans don't need subagent overhead
-        if (step.instruction.length > 2000)
-            return true; // Large skill content benefits from isolation
-        // Analysis/review skills benefit from subagent isolation
-        const analysisKeywords = [
-            "review",
-            "audit",
-            "analysis",
-            "assess",
-            "evaluate",
-            "critique",
-        ];
-        return analysisKeywords.some((kw) => step.skill_key.includes(kw) || step.title.toLowerCase().includes(kw));
-    }
-}
-//# sourceMappingURL=pi-executor.js.map

package/dist/behavior/pi-executor.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"pi-executor.js","sourceRoot":"","sources":["../../src/behavior/pi-executor.ts"],"names":[],"mappings":"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"}

package/dist/behavior/resolver.js

@@ -1,171 +0,0 @@
-/**
- * @file behavior/resolver.ts
- *
- * Responsibility: Resolve behavior keys into BehaviorPlans via Sage MCP.
- *
- * Invariants:
- * - Resolution always goes through the MCP bridge (never direct file reads).
- * - Returns a validated BehaviorPlan or throws with a clear error.
- * - The resolver is stateless — no caching (Sage MCP handles that).
- */
-/**
- * Resolve a behavior key into a BehaviorPlan via Sage MCP.
- *
- * Calls `get_prompt(key, expand: ["behaviorPlan", "behaviorSkillBodies"])`
- * through the MCP bridge and extracts the plan from the response.
- */
-export async function resolveBehaviorPlan(bridge, key) {
-    if (!bridge.isReady()) {
-        throw new Error(`Cannot resolve behavior '${key}': Sage MCP bridge is not connected`);
-    }
-    // Call Sage MCP to get the behavior with plan expansion.
-    // The expand modes progressively resolve: parse → resolve → plan → bodies.
-    const result = await bridge.callCodeModeExecute({
-        domain: "prompts",
-        action: "get",
-        params: {
-            key,
-            expand: ["behaviorPlan", "behaviorSkillBodies"],
-        },
-    });
-    return extractPlanFromResult(result, key);
-}
-/**
- * Extract and validate a BehaviorPlan from an MCP result.
- *
- * The MCP response may contain the plan in several locations depending
- * on the Sage MCP version:
- * - result.content[].text (JSON string)
- * - result.extra.behaviorPlan (object)
- * - result.plan (object)
- */
-function extractPlanFromResult(result, key) {
-    if (!result || typeof result !== "object") {
-        throw new Error(`Empty response when resolving behavior '${key}'`);
-    }
-    const obj = result;
-    // Try structured plan field first (multiple nesting levels)
-    const promptEnvelope = obj.prompt;
-    const planCandidate = obj.plan ??
-        obj.behaviorPlan ??
-        obj.extra?.behaviorPlan ??
-        promptEnvelope?.behaviorPlan;
-    if (planCandidate && typeof planCandidate === "object") {
-        return validatePlan(planCandidate, key);
-    }
-    // Try parsing from MCP content text blocks
-    if (Array.isArray(obj.content)) {
-        for (const block of obj.content) {
-            if (!block || typeof block !== "object")
-                continue;
-            const text = block.text;
-            if (typeof text !== "string")
-                continue;
-            // Try JSON parse — the plan may be embedded as JSON
-            try {
-                const parsed = JSON.parse(text);
-                if (parsed &&
-                    typeof parsed === "object" &&
-                    Array.isArray(parsed.steps)) {
-                    return validatePlan(parsed, key);
-                }
-                // Check nested
-                if (parsed.plan &&
-                    typeof parsed.plan === "object" &&
-                    Array.isArray(parsed.plan.steps)) {
-                    return validatePlan(parsed.plan, key);
-                }
-                if (parsed.behaviorPlan && typeof parsed.behaviorPlan === "object") {
-                    return validatePlan(parsed.behaviorPlan, key);
-                }
-                // Check inside prompt envelope — get_prompt returns { prompt: { behaviorPlan: ... } }
-                if (parsed.prompt &&
-                    typeof parsed.prompt === "object" &&
-                    parsed.prompt.behaviorPlan &&
-                    typeof parsed.prompt.behaviorPlan === "object") {
-                    return validatePlan(parsed.prompt.behaviorPlan, key);
-                }
-            }
-            catch {
-                // Not JSON — may be the rendered markdown controller prompt.
-                // Extract plan structure from markdown if possible.
-                const markdownPlan = parseMarkdownPlan(text, key);
-                if (markdownPlan)
-                    return markdownPlan;
-            }
-        }
-    }
-    throw new Error(`Could not extract behavior plan from response for '${key}'. ` +
-        `The behavior may not exist or may not have the 'behavior' field in its prompt extra.`);
-}
-/** Validate a raw object as a BehaviorPlan. */
-function validatePlan(raw, key) {
-    const steps = raw.steps;
-    if (!Array.isArray(steps) || steps.length === 0) {
-        throw new Error(`Behavior '${key}' resolved but has no steps`);
-    }
-    const validSteps = steps.map((step, i) => {
-        if (!step || typeof step !== "object") {
-            throw new Error(`Step ${i} in behavior '${key}' is not an object`);
-        }
-        const s = step;
-        return {
-            id: typeof s.id === "string" ? s.id : `step-${i + 1}`,
-            title: typeof s.title === "string" ? s.title : `Step ${i + 1}`,
-            skill_key: typeof s.skill_key === "string" ? s.skill_key : "",
-            instruction: typeof s.instruction === "string" ? s.instruction : "",
-            uses: Array.isArray(s.uses) ? s.uses : [],
-            produces: Array.isArray(s.produces)
-                ? s.produces
-                : [`output-${i + 1}`],
-        };
-    });
-    return {
-        version: typeof raw.version === "string" ? raw.version : "1",
-        inputs: Array.isArray(raw.inputs)
-            ? raw.inputs.map((inp) => ({
-                name: String(inp.name ?? ""),
-                description: typeof inp.description === "string" ? inp.description : undefined,
-                required: Boolean(inp.required),
-            }))
-            : [{ name: "task", required: true, description: "The task to perform" }],
-        steps: validSteps,
-    };
-}
-/**
- * Best-effort extraction of plan steps from Sage's rendered markdown controller prompt.
- *
- * When the MCP response is the rendered markdown (not raw JSON), parse step
- * headers like "### Step 1: Skill Name" to reconstruct the plan structure.
- */
-function parseMarkdownPlan(markdown, _key) {
-    const stepPattern = /^###?\s+Step\s+(\d+):\s+(.+)$/gm;
-    const steps = [];
-    let match;
-    while ((match = stepPattern.exec(markdown)) !== null) {
-        const stepNum = parseInt(match[1], 10);
-        const title = match[2].trim();
-        // Extract skill key from the line after "**Skill**: `key`"
-        const afterHeader = markdown.slice(match.index + match[0].length, match.index + match[0].length + 500);
-        const skillMatch = afterHeader.match(/\*\*Skill\*\*:\s*`([^`]+)`/);
-        const instructionMatch = afterHeader.match(/\*\*Instruction\*\*:\s*(.+?)(?:\n\*\*|\n###|$)/s);
-        steps.push({
-            id: `step-${stepNum}`,
-            title,
-            skill_key: skillMatch?.[1] ?? title.toLowerCase().replace(/\s+/g, "-"),
-            instruction: instructionMatch?.[1]?.trim() ?? `Apply the ${title} skill`,
-            uses: stepNum > 1 ? [`step-${stepNum - 1}`] : [],
-            produces: [`output-${stepNum}`],
-        });
-    }
-    if (steps.length === 0)
-        return null;
-    return {
-        version: "1",
-        inputs: [
-            { name: "task", required: true, description: "The task to perform" },
-        ],
-        steps,
-    };
-}
-//# sourceMappingURL=resolver.js.map

package/dist/behavior/resolver.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../src/behavior/resolver.ts"],"names":[],"mappings":"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"}

package/dist/behavior/types.js

@@ -1,16 +0,0 @@
-/**
- * @file behavior/types.ts
- *
- * Responsibility: Define the canonical types for Sage behavior plans and the
- * BehaviorExecutor plugin interface that bridges Sage's behavior engine to
- * any AI harness's subagent system.
- *
- * Invariants:
- * - Types mirror the Sage core Rust structs (crates/core/src/library/behavior.rs).
- * - The BehaviorExecutor interface is the ONLY contract between the adapter core
- *   and harness-specific executors — core never imports from executor implementations.
- * - All step IDs are unique within a plan.
- * - Steps form a linear dependency chain (step-N uses output of step-N-1).
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/behavior/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/behavior/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAEH,4CAA4C;AAC5C,cAAc,sBAAsB,CAAC;AAErC,yCAAyC;AACzC,cAAc,qBAAqB,CAAC"}