@growthub/cli 0.6.0 → 0.6.2

package/dist/runtime/native-intelligence/recommender.js

@@ -0,0 +1,299 @@
+/**
+ * Native Intelligence — Recommender (Phase 3)
+ *
+ * Given a task/intent, decides whether to:
+ *   - Reuse an existing saved workflow
+ *   - Start from a template
+ *   - Synthesize a new graph
+ *
+ * Builds on the existing system's:
+ *   - Saved workflows
+ *   - Workflow lifecycle / hygiene labels
+ *   - CMS node contracts
+ *   - Templates
+ *
+ * The model creates value immediately without becoming "the whole orchestrator"
+ * because it only recommends — the user/agent still chooses and executes.
+ *
+ * Falls back to deterministic scoring when model is unavailable.
+ */
+// ---------------------------------------------------------------------------
+// System prompt for workflow recommendation
+// ---------------------------------------------------------------------------
+const RECOMMENDER_SYSTEM_PROMPT = `You are a workflow recommendation engine for the Growthub platform.
+Given a user's task intent, you decide the best path forward:
+
+1. "reuse-existing" — if a saved workflow closely matches the intent
+2. "start-from-template" — if a known node contract/template is a good starting point
+3. "synthesize-new" — if no existing workflow or template fits well
+
+You receive:
+- The user's task description/intent
+- A list of saved workflows (with names, node slugs, lifecycle labels)
+- A list of available CMS node contracts
+
+Your recommendation must:
+- Pick the best strategy and explain why
+- Provide 1-2 alternatives when possible
+- Reference specific workflow IDs, names, or node slugs
+- Consider lifecycle labels (canonical > experimental > archived)
+- Be honest about confidence level
+
+Respond in JSON:
+{
+  "topRecommendation": {
+    "strategy": "reuse-existing | start-from-template | synthesize-new",
+    "workflowId": "string | null — for reuse-existing",
+    "workflowName": "string | null — for reuse-existing",
+    "templateSlug": "string | null — for start-from-template",
+    "reason": "string — why this is recommended",
+    "confidence": 0.0-1.0
+  },
+  "alternatives": [
+    {
+      "strategy": "...",
+      "workflowId": "string | null",
+      "workflowName": "string | null",
+      "templateSlug": "string | null",
+      "reason": "string",
+      "confidence": 0.0-1.0
+    }
+  ],
+  "explanation": "string — overall recommendation rationale"
+}`;
+// ---------------------------------------------------------------------------
+// Recommender
+// ---------------------------------------------------------------------------
+export async function recommendWorkflow(input, backend) {
+    const userPrompt = buildRecommenderPrompt(input);
+    try {
+        const completion = await backend.complete({
+            systemPrompt: RECOMMENDER_SYSTEM_PROMPT,
+            userPrompt,
+            temperature: 0.3,
+            maxTokens: 2048,
+            responseFormat: "json",
+        });
+        const parsed = parseJsonSafe(completion.text);
+        if (parsed) {
+            return validateRecommendationResult(parsed, input);
+        }
+    }
+    catch {
+        // Fall through to deterministic fallback
+    }
+    return buildDeterministicRecommendation(input);
+}
+// ---------------------------------------------------------------------------
+// Deterministic fallback (no model required)
+// ---------------------------------------------------------------------------
+export function buildDeterministicRecommendation(input) {
+    const { userIntent, savedWorkflows, availableContracts } = input;
+    const intentLower = userIntent.toLowerCase();
+    const intentTokens = intentLower.split(/\s+/).filter((t) => t.length > 2);
+    const scoredWorkflows = savedWorkflows
+        .filter((w) => w.label !== "archived")
+        .map((w) => ({
+        workflow: w,
+        score: scoreWorkflowMatch(w, intentTokens, intentLower),
+    }))
+        .sort((a, b) => b.score - a.score);
+    const scoredContracts = availableContracts
+        .map((c) => ({
+        contract: c,
+        score: scoreContractMatch(c, intentTokens, intentLower),
+    }))
+        .sort((a, b) => b.score - a.score);
+    const bestWorkflow = scoredWorkflows[0];
+    const bestContract = scoredContracts[0];
+    const alternatives = [];
+    if (bestWorkflow && bestWorkflow.score >= 3) {
+        const topRecommendation = {
+            strategy: "reuse-existing",
+            workflowId: bestWorkflow.workflow.workflowId,
+            workflowName: bestWorkflow.workflow.name,
+            reason: `Saved workflow "${bestWorkflow.workflow.name}" matches your intent with ${bestWorkflow.workflow.nodeCount} node(s): ${bestWorkflow.workflow.nodeSlugs.join(", ")}.`,
+            confidence: Math.min(0.9, bestWorkflow.score / 10),
+        };
+        if (bestContract && bestContract.score >= 2) {
+            alternatives.push({
+                strategy: "start-from-template",
+                templateSlug: bestContract.contract.slug,
+                reason: `Contract "${bestContract.contract.displayName}" could serve as a starting point for a new pipeline.`,
+                confidence: Math.min(0.7, bestContract.score / 10),
+            });
+        }
+        alternatives.push({
+            strategy: "synthesize-new",
+            reason: "Build a custom pipeline if the existing workflow doesn't fully match your needs.",
+            confidence: 0.3,
+        });
+        return {
+            topRecommendation,
+            alternatives,
+            explanation: `Found ${scoredWorkflows.filter((w) => w.score >= 2).length} potentially matching saved workflow(s). ` +
+                `"${bestWorkflow.workflow.name}" is the closest match.`,
+        };
+    }
+    if (bestContract && bestContract.score >= 2) {
+        const topRecommendation = {
+            strategy: "start-from-template",
+            templateSlug: bestContract.contract.slug,
+            reason: `Contract "${bestContract.contract.displayName}" (${bestContract.contract.family}) is a good starting point for your task.`,
+            confidence: Math.min(0.7, bestContract.score / 10),
+        };
+        if (scoredWorkflows.length > 0 && bestWorkflow && bestWorkflow.score >= 1) {
+            alternatives.push({
+                strategy: "reuse-existing",
+                workflowId: bestWorkflow.workflow.workflowId,
+                workflowName: bestWorkflow.workflow.name,
+                reason: `Existing workflow "${bestWorkflow.workflow.name}" might partially match — review before reusing.`,
+                confidence: Math.min(0.5, bestWorkflow.score / 10),
+            });
+        }
+        alternatives.push({
+            strategy: "synthesize-new",
+            reason: "Compose a multi-node pipeline from available contracts.",
+            confidence: 0.4,
+        });
+        return {
+            topRecommendation,
+            alternatives,
+            explanation: `No strong saved workflow match found. "${bestContract.contract.displayName}" is the best contract starting point.`,
+        };
+    }
+    return {
+        topRecommendation: {
+            strategy: "synthesize-new",
+            reason: "No strong match found in saved workflows or available templates. A custom pipeline is recommended.",
+            confidence: 0.5,
+        },
+        alternatives: savedWorkflows.length > 0 && bestWorkflow
+            ? [{
+                    strategy: "reuse-existing",
+                    workflowId: bestWorkflow.workflow.workflowId,
+                    workflowName: bestWorkflow.workflow.name,
+                    reason: `"${bestWorkflow.workflow.name}" is the closest existing workflow, but may need significant modification.`,
+                    confidence: Math.min(0.3, (bestWorkflow.score || 0) / 10),
+                }]
+            : [],
+        explanation: "No strong matches found. Recommending a custom pipeline synthesis.",
+    };
+}
+// ---------------------------------------------------------------------------
+// Scoring helpers
+// ---------------------------------------------------------------------------
+function scoreWorkflowMatch(workflow, intentTokens, intentLower) {
+    let score = 0;
+    const nameLower = workflow.name.toLowerCase();
+    const descLower = (workflow.description ?? "").toLowerCase();
+    const slugsLower = workflow.nodeSlugs.map((s) => s.toLowerCase()).join(" ");
+    for (const token of intentTokens) {
+        if (nameLower.includes(token))
+            score += 2;
+        if (descLower.includes(token))
+            score += 1;
+        if (slugsLower.includes(token))
+            score += 1.5;
+    }
+    // Explicit node slug mention in user intent should strongly favor reuse.
+    for (const slug of workflow.nodeSlugs) {
+        if (intentLower.includes(slug.toLowerCase())) {
+            score += 2;
+        }
+    }
+    if (workflow.label === "canonical")
+        score += 2;
+    if (workflow.label === "experimental")
+        score += 0.5;
+    if (workflow.label === "archived")
+        score -= 3;
+    if (workflow.versionCount >= 3)
+        score += 1;
+    return score;
+}
+function scoreContractMatch(contract, intentTokens, intentLower) {
+    let score = 0;
+    const slugLower = contract.slug.toLowerCase();
+    const nameLower = contract.displayName.toLowerCase();
+    const familyLower = contract.family.toLowerCase();
+    for (const token of intentTokens) {
+        if (slugLower.includes(token))
+            score += 2;
+        if (nameLower.includes(token))
+            score += 2;
+        if (familyLower.includes(token))
+            score += 1;
+    }
+    for (const outputType of contract.outputTypes) {
+        if (intentLower.includes(outputType.toLowerCase())) {
+            score += 1.5;
+        }
+    }
+    return score;
+}
+// ---------------------------------------------------------------------------
+// Prompt builder
+// ---------------------------------------------------------------------------
+function buildRecommenderPrompt(input) {
+    const { userIntent, savedWorkflows, availableContracts, executionMode } = input;
+    const sections = [
+        `User Intent: ${userIntent}`,
+        `Execution Mode: ${executionMode ?? "hosted"}`,
+        "",
+        `Saved Workflows (${savedWorkflows.length}):`,
+    ];
+    for (const wf of savedWorkflows.slice(0, 30)) {
+        sections.push(`  - [${wf.workflowId}] "${wf.name}" (${wf.label ?? "unlabeled"}) — ${wf.nodeCount} node(s): ${wf.nodeSlugs.join(", ")} — v${wf.versionCount}`);
+    }
+    sections.push("", `Available Contracts (${availableContracts.length}):`);
+    for (const contract of availableContracts.slice(0, 30)) {
+        sections.push(`  - ${contract.slug} "${contract.displayName}" (${contract.family}) — outputs: [${contract.outputTypes.join(",")}]`);
+    }
+    return sections.join("\n");
+}
+function validateRecommendationResult(raw, input) {
+    return {
+        topRecommendation: validateRecommendation(raw.topRecommendation, input),
+        alternatives: Array.isArray(raw.alternatives)
+            ? raw.alternatives.map((alt) => validateRecommendation(alt, input))
+            : [],
+        explanation: typeof raw.explanation === "string" ? raw.explanation : "Recommendation generated.",
+    };
+}
+function validateRecommendation(raw, input) {
+    const strategy = validateStrategy(raw?.strategy);
+    return {
+        strategy,
+        workflowId: typeof raw?.workflowId === "string" ? raw.workflowId : undefined,
+        workflowName: typeof raw?.workflowName === "string" ? raw.workflowName : undefined,
+        templateSlug: typeof raw?.templateSlug === "string" ? raw.templateSlug : undefined,
+        reason: typeof raw?.reason === "string" ? raw.reason : "No specific reason provided.",
+        confidence: typeof raw?.confidence === "number" ? Math.max(0, Math.min(1, raw.confidence)) : 0.5,
+    };
+}
+function validateStrategy(strategy) {
+    const valid = ["reuse-existing", "start-from-template", "synthesize-new"];
+    if (typeof strategy === "string" && valid.includes(strategy)) {
+        return strategy;
+    }
+    return "synthesize-new";
+}
+// ---------------------------------------------------------------------------
+// JSON parse helper
+// ---------------------------------------------------------------------------
+function parseJsonSafe(text) {
+    try {
+        const trimmed = text.trim();
+        const jsonStart = trimmed.indexOf("{");
+        const jsonEnd = trimmed.lastIndexOf("}");
+        if (jsonStart >= 0 && jsonEnd > jsonStart) {
+            return JSON.parse(trimmed.slice(jsonStart, jsonEnd + 1));
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=recommender.js.map

package/dist/runtime/native-intelligence/recommender.js.map

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

package/dist/runtime/native-intelligence/summarizer.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Native Intelligence — Summarizer (Phase 1)
+ *
+ * Generates better execution summaries at key lifecycle points:
+ *   - pre-save review text
+ *   - pre-execution explanation
+ *   - "why this workflow" summary
+ *   - "what is missing" guidance
+ *   - post-execution summary
+ *
+ * This is the lowest-risk, highest-value V1 use case because:
+ *   - No workflow mutation needed
+ *   - Immediately useful for both agents and humans
+ *   - Improves current CLI UX right away
+ *
+ * When the model backend is unavailable, falls back to deterministic
+ * template-based summaries so the CLI never blocks on model availability.
+ */
+import type { NativeIntelligenceBackend, ExecutionSummaryInput, ExecutionSummaryResult } from "./contract.js";
+export declare function summarizeExecution(input: ExecutionSummaryInput, backend: NativeIntelligenceBackend): Promise<ExecutionSummaryResult>;
+export declare function buildDeterministicSummary(input: ExecutionSummaryInput): ExecutionSummaryResult;
+//# sourceMappingURL=summarizer.d.ts.map

package/dist/runtime/native-intelligence/summarizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarizer.d.ts","sourceRoot":"","sources":["../../../src/runtime/native-intelligence/summarizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EACV,yBAAyB,EACzB,qBAAqB,EACrB,sBAAsB,EAIvB,MAAM,eAAe,CAAC;AAwCvB,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,qBAAqB,EAC5B,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,sBAAsB,CAAC,CAqBjC;AAMD,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,qBAAqB,GAC3B,sBAAsB,CAyFxB"}

package/dist/runtime/native-intelligence/summarizer.js

@@ -0,0 +1,228 @@
+/**
+ * Native Intelligence — Summarizer (Phase 1)
+ *
+ * Generates better execution summaries at key lifecycle points:
+ *   - pre-save review text
+ *   - pre-execution explanation
+ *   - "why this workflow" summary
+ *   - "what is missing" guidance
+ *   - post-execution summary
+ *
+ * This is the lowest-risk, highest-value V1 use case because:
+ *   - No workflow mutation needed
+ *   - Immediately useful for both agents and humans
+ *   - Improves current CLI UX right away
+ *
+ * When the model backend is unavailable, falls back to deterministic
+ * template-based summaries so the CLI never blocks on model availability.
+ */
+// ---------------------------------------------------------------------------
+// System prompt for summary generation
+// ---------------------------------------------------------------------------
+const SUMMARIZER_SYSTEM_PROMPT = `You are a workflow execution analyst for the Growthub platform.
+Your job is to produce clear, concise, actionable summaries about workflow pipelines.
+
+You analyze:
+- Pipeline graph structure (node slugs, bindings, upstream dependencies)
+- Contract truth (required/optional inputs, output types, execution strategies)
+- Execution results when available (success/failure per node, artifacts produced)
+- Runtime mode (local, hosted, hybrid)
+
+Your summaries must be:
+- Specific: reference actual node slugs and binding names
+- Actionable: tell the user what to fix or what to expect
+- Concise: under 200 words for each summary section
+- Honest: flag real issues, don't invent phantom problems
+
+You NEVER recommend running workflows, only explain and analyze them.
+You NEVER generate executable code or modify pipeline configurations.
+
+Respond in JSON with this schema:
+{
+  "title": "string — short summary title",
+  "explanation": "string — 1-3 sentence overview of the pipeline",
+  "missingBindingGuidance": ["string — one per missing binding with fix guidance"],
+  "runtimeModeNote": "string | null — note about execution mode implications",
+  "outputExpectation": "string | null — what artifacts/outputs to expect",
+  "costLatencyCautions": ["string — cost or latency warnings"],
+  "warnings": ["string — other warnings"],
+  "confidence": "number 0-1 — how confident in the analysis"
+}`;
+// ---------------------------------------------------------------------------
+// Summarizer
+// ---------------------------------------------------------------------------
+export async function summarizeExecution(input, backend) {
+    const userPrompt = buildSummarizerPrompt(input);
+    try {
+        const completion = await backend.complete({
+            systemPrompt: SUMMARIZER_SYSTEM_PROMPT,
+            userPrompt,
+            temperature: 0.2,
+            maxTokens: 2048,
+            responseFormat: "json",
+        });
+        const parsed = parseJsonSafe(completion.text);
+        if (parsed) {
+            return validateSummaryResult(parsed);
+        }
+    }
+    catch {
+        // Fall through to deterministic fallback
+    }
+    return buildDeterministicSummary(input);
+}
+// ---------------------------------------------------------------------------
+// Deterministic fallback (no model required)
+// ---------------------------------------------------------------------------
+export function buildDeterministicSummary(input) {
+    const { pipeline, registryContext, phase, executionResult } = input;
+    const nodeCount = pipeline.nodes.length;
+    const slugs = pipeline.nodes.map((n) => n.slug);
+    const allMissing = pipeline.nodes.flatMap((n) => n.missingRequired);
+    const allWarnings = [...pipeline.warnings];
+    const costCautions = [];
+    const missingGuidance = [];
+    for (const node of pipeline.nodes) {
+        for (const field of node.missingRequired) {
+            const contract = registryContext.find((c) => c.slug === node.slug);
+            const inputField = contract?.inputs.find((i) => i.key === field);
+            const label = inputField?.label ?? field;
+            missingGuidance.push(`${node.slug}: "${label}" (${field}) is required but missing. Provide a value before execution.`);
+        }
+    }
+    for (const node of pipeline.nodes) {
+        if (node.outputTypes.includes("video")) {
+            costCautions.push(`${node.slug}: video generation may have higher latency and cost.`);
+        }
+        if (node.assetCount > 5) {
+            costCautions.push(`${node.slug}: ${node.assetCount} assets referenced — verify all are accessible.`);
+        }
+    }
+    let title;
+    let explanation;
+    let runtimeModeNote;
+    let outputExpectation;
+    if (phase === "pre-save") {
+        title = `Pre-Save Review: ${nodeCount}-node pipeline`;
+        explanation = `Pipeline "${pipeline.pipelineId}" contains ${nodeCount} node(s): ${slugs.join(", ")}. `
+            + (allMissing.length > 0
+                ? `${allMissing.length} required binding(s) are missing.`
+                : "All required bindings are present.");
+    }
+    else if (phase === "pre-execution") {
+        title = `Pre-Execution Summary: ${nodeCount} node(s)`;
+        explanation = `About to execute pipeline "${pipeline.pipelineId}" with ${nodeCount} node(s) in ${pipeline.executionMode} mode. `
+            + (allMissing.length > 0
+                ? `Warning: ${allMissing.length} required binding(s) are unresolved.`
+                : "All bindings are resolved.");
+        runtimeModeNote = pipeline.executionMode === "hosted"
+            ? "Running in hosted mode — execution happens on Growthub servers."
+            : pipeline.executionMode === "local"
+                ? "Running in local mode — execution happens on this machine."
+                : "Running in hybrid mode — some nodes execute locally, others hosted.";
+    }
+    else if (phase === "post-execution" && executionResult) {
+        title = `Execution ${executionResult.status === "succeeded" ? "Completed" : "Failed"}: ${nodeCount} node(s)`;
+        const succeeded = Object.values(executionResult.nodeStatuses).filter((s) => s === "succeeded").length;
+        const failed = Object.values(executionResult.nodeStatuses).filter((s) => s === "failed").length;
+        explanation = `Execution finished: ${succeeded} succeeded, ${failed} failed. `
+            + (executionResult.artifactCount > 0
+                ? `${executionResult.artifactCount} artifact(s) produced.`
+                : "No artifacts produced.");
+        if (executionResult.errorMessages && executionResult.errorMessages.length > 0) {
+            allWarnings.push(...executionResult.errorMessages.map((msg) => `Execution error: ${msg}`));
+        }
+        outputExpectation = executionResult.outputText
+            ? `Output preview: ${executionResult.outputText.slice(0, 200)}`
+            : undefined;
+    }
+    else if (phase === "recommendation") {
+        title = `Workflow Analysis: ${nodeCount} node(s)`;
+        explanation = `Analyzing pipeline with ${nodeCount} node(s): ${slugs.join(", ")}. `
+            + `This pipeline ${allMissing.length === 0 ? "is ready for execution" : "needs attention before execution"}.`;
+    }
+    else {
+        title = `Pipeline Summary: ${nodeCount} node(s)`;
+        explanation = `Pipeline "${pipeline.pipelineId}" with ${nodeCount} node(s) in ${pipeline.executionMode} mode.`;
+    }
+    const outputFamilies = new Set(pipeline.nodes.flatMap((n) => n.outputTypes));
+    if (!outputExpectation && outputFamilies.size > 0) {
+        outputExpectation = `Expected output types: ${[...outputFamilies].join(", ")}.`;
+    }
+    return {
+        title,
+        explanation,
+        missingBindingGuidance: missingGuidance,
+        runtimeModeNote,
+        outputExpectation,
+        costLatencyCautions: costCautions,
+        warnings: allWarnings,
+        confidence: 1.0,
+    };
+}
+// ---------------------------------------------------------------------------
+// Prompt builder
+// ---------------------------------------------------------------------------
+function buildSummarizerPrompt(input) {
+    const { pipeline, registryContext, phase, executionResult } = input;
+    const sections = [
+        `Phase: ${phase}`,
+        `Pipeline ID: ${pipeline.pipelineId}`,
+        `Execution Mode: ${pipeline.executionMode}`,
+        `Node Count: ${pipeline.nodes.length}`,
+        "",
+        "Nodes:",
+    ];
+    for (const node of pipeline.nodes) {
+        const contract = registryContext.find((c) => c.slug === node.slug);
+        sections.push(`  - ${node.slug}: bindings=${node.bindingCount}, missing=[${node.missingRequired.join(",")}], outputs=[${node.outputTypes.join(",")}], assets=${node.assetCount}`
+            + (contract ? `, family=${contract.family}, strategy=${contract.executionStrategy}` : ""));
+    }
+    if (pipeline.warnings.length > 0) {
+        sections.push("", "Pipeline Warnings:", ...pipeline.warnings.map((w) => `  - ${w}`));
+    }
+    if (executionResult) {
+        sections.push("", "Execution Result:", `  Status: ${executionResult.status}`, `  Artifacts: ${executionResult.artifactCount}`, `  Node Statuses: ${JSON.stringify(executionResult.nodeStatuses)}`);
+        if (executionResult.errorMessages && executionResult.errorMessages.length > 0) {
+            sections.push("  Errors:", ...executionResult.errorMessages.map((e) => `    - ${e}`));
+        }
+        if (executionResult.outputText) {
+            sections.push(`  Output Preview: ${executionResult.outputText.slice(0, 500)}`);
+        }
+    }
+    sections.push("", "Available Contract Context:");
+    for (const contract of registryContext.slice(0, 20)) {
+        sections.push(`  - ${contract.slug} (${contract.family}): inputs=[${contract.inputs.map((i) => `${i.key}:${i.type}${i.required ? "*" : ""}`).join(",")}], outputs=[${contract.outputTypes.join(",")}]`);
+    }
+    return sections.join("\n");
+}
+// ---------------------------------------------------------------------------
+// JSON parse helper
+// ---------------------------------------------------------------------------
+function parseJsonSafe(text) {
+    try {
+        const trimmed = text.trim();
+        const jsonStart = trimmed.indexOf("{");
+        const jsonEnd = trimmed.lastIndexOf("}");
+        if (jsonStart >= 0 && jsonEnd > jsonStart) {
+            return JSON.parse(trimmed.slice(jsonStart, jsonEnd + 1));
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+function validateSummaryResult(raw) {
+    return {
+        title: typeof raw.title === "string" ? raw.title : "Pipeline Summary",
+        explanation: typeof raw.explanation === "string" ? raw.explanation : "",
+        missingBindingGuidance: Array.isArray(raw.missingBindingGuidance) ? raw.missingBindingGuidance : [],
+        runtimeModeNote: typeof raw.runtimeModeNote === "string" ? raw.runtimeModeNote : undefined,
+        outputExpectation: typeof raw.outputExpectation === "string" ? raw.outputExpectation : undefined,
+        costLatencyCautions: Array.isArray(raw.costLatencyCautions) ? raw.costLatencyCautions : [],
+        warnings: Array.isArray(raw.warnings) ? raw.warnings : [],
+        confidence: typeof raw.confidence === "number" ? Math.max(0, Math.min(1, raw.confidence)) : 0.5,
+    };
+}
+//# sourceMappingURL=summarizer.js.map

package/dist/runtime/native-intelligence/summarizer.js.map

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

package/dist/runtime/open-agents/contract.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Open Agents — Contract Types
+ *
+ * Stable types that define the boundary between the Growthub CLI and
+ * an Open Agents backend (Vercel-style durable agent workflow runtime).
+ *
+ * Open Agents provides:
+ *   - Durable multi-step agent workflow execution
+ *   - Isolated sandbox environments (filesystem, network, shell, git)
+ *   - GitHub integration (clone, branch, commit, PR)
+ *   - Agent tools: file, search, shell, task delegation, skills
+ *
+ * Guardrails:
+ *   - Local runtime remains canonical — this is a harness, not a replacement
+ *   - CMS nodes and kit primitives remain the execution substrate
+ *   - Open Agents adds durable orchestration and sandbox isolation
+ *   - Config is persisted to ~/.paperclip/open-agents/config.json
+ */
+export type OpenAgentsBackendType = "local" | "hosted";
+export type OpenAgentsAuthMode = "none" | "api-key" | "vercel-managed";
+export type SandboxState = "creating" | "running" | "hibernating" | "snapshotting" | "stopped" | "error";
+export type AgentSessionStatus = "idle" | "running" | "waiting" | "completed" | "failed" | "cancelled";
+export type AgentRunEventType = "sandbox_create" | "sandbox_resume" | "sandbox_hibernate" | "tool_start" | "tool_result" | "file_edit" | "file_create" | "shell_exec" | "search" | "git_commit" | "git_push" | "git_pr" | "agent_message" | "agent_thinking" | "task_delegate" | "workflow_step" | "error";
+export interface AgentRunEvent {
+    type: AgentRunEventType;
+    timestamp: string;
+    detail: string;
+    metadata?: Record<string, unknown>;
+}
+export interface OpenAgentsSessionSummary {
+    sessionId: string;
+    status: AgentSessionStatus;
+    repoUrl?: string;
+    branch?: string;
+    prompt?: string;
+    createdAt: string;
+    updatedAt?: string;
+    eventCount: number;
+    sandboxState: SandboxState;
+}
+export interface OpenAgentsHealthResult {
+    available: boolean;
+    latencyMs: number;
+    version?: string;
+    error?: string;
+}
+export interface OpenAgentsConfig {
+    backendType: OpenAgentsBackendType;
+    authMode?: OpenAgentsAuthMode;
+    endpoint: string;
+    apiKey?: string;
+    defaultRepo?: string;
+    defaultBranch?: string;
+    sandboxTimeoutMs?: number;
+    timeoutMs?: number;
+}
+export declare const DEFAULT_OPEN_AGENTS_CONFIG: OpenAgentsConfig;
+//# sourceMappingURL=contract.d.ts.map

package/dist/runtime/open-agents/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../src/runtime/open-agents/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,QAAQ,CAAC;AACvD,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,SAAS,GAAG,gBAAgB,CAAC;AAMvE,MAAM,MAAM,YAAY,GACpB,UAAU,GACV,SAAS,GACT,aAAa,GACb,cAAc,GACd,SAAS,GACT,OAAO,CAAC;AAMZ,MAAM,MAAM,kBAAkB,GAC1B,MAAM,GACN,SAAS,GACT,SAAS,GACT,WAAW,GACX,QAAQ,GACR,WAAW,CAAC;AAMhB,MAAM,MAAM,iBAAiB,GACzB,gBAAgB,GAChB,gBAAgB,GAChB,mBAAmB,GACnB,YAAY,GACZ,aAAa,GACb,WAAW,GACX,aAAa,GACb,YAAY,GACZ,QAAQ,GACR,YAAY,GACZ,UAAU,GACV,QAAQ,GACR,eAAe,GACf,gBAAgB,GAChB,eAAe,GACf,eAAe,GACf,OAAO,CAAC;AAMZ,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,iBAAiB,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAMD,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,YAAY,CAAC;CAC5B;AAMD,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,qBAAqB,CAAC;IACnC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,0BAA0B,EAAE,gBAMxC,CAAC"}