@sage-protocol/pi-adapter 0.4.3 → 0.5.1

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"}