@growthub/cli 0.6.0 → 0.6.1

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

@@ -0,0 +1,312 @@
+/**
+ * Native Intelligence — Planner (Phase 4)
+ *
+ * Generates or refines workflow graphs from intent + contract truth.
+ *
+ * V1 scope:
+ *   - Recommend a node sequence from available contracts
+ *   - Map node slugs to fulfill user intent
+ *   - Suggest bindings to collect
+ *   - Optionally choose an existing workflow instead of creating a new one
+ *
+ * Important rule:
+ *   Planner does NOT execute.
+ *   Planner outputs graph suggestions only.
+ *   Final compile/save/execute still goes through the existing contract pipeline.
+ *
+ * Falls back to deterministic single-node planning when model is unavailable.
+ */
+// ---------------------------------------------------------------------------
+// System prompt for workflow planning
+// ---------------------------------------------------------------------------
+const PLANNER_SYSTEM_PROMPT = `You are a workflow graph planner for the Growthub platform.
+Your job is to propose a pipeline graph (sequence of CMS nodes) that fulfills the user's intent.
+
+You receive:
+- The user's intent/goal
+- Available CMS node contracts (with slugs, input schemas, output types, families)
+- Optionally, existing saved workflows that might already fulfill the need
+
+Rules:
+1. Only use node slugs that exist in the available contracts list
+2. Propose realistic bindings — use empty strings for values the user must provide
+3. Chain nodes by specifying upstream dependencies when outputs feed into downstream inputs
+4. Respect constraints (max nodes, required output types, preferred families)
+5. If an existing workflow already matches well, recommend it instead of planning a new graph
+6. Keep graphs minimal — prefer fewer nodes that accomplish the goal
+7. NEVER propose nodes that don't exist in the available contracts
+
+Respond in JSON:
+{
+  "proposedNodes": [
+    {
+      "slug": "string — must be from available contracts",
+      "displayName": "string",
+      "reason": "string — why this node is needed",
+      "suggestedBindings": { "key": "value or empty string" },
+      "upstreamNodeSlugs": ["string — slugs of upstream nodes, if any"]
+    }
+  ],
+  "explanation": "string — overall plan rationale",
+  "alternativeExistingWorkflowId": "string | null",
+  "alternativeExistingWorkflowReason": "string | null",
+  "confidence": 0.0-1.0,
+  "warnings": ["string"]
+}`;
+// ---------------------------------------------------------------------------
+// Planner
+// ---------------------------------------------------------------------------
+export async function planWorkflow(input, backend) {
+    const userPrompt = buildPlannerPrompt(input);
+    try {
+        const completion = await backend.complete({
+            systemPrompt: PLANNER_SYSTEM_PROMPT,
+            userPrompt,
+            temperature: 0.4,
+            maxTokens: 3072,
+            responseFormat: "json",
+        });
+        const parsed = parseJsonSafe(completion.text);
+        if (parsed) {
+            return validatePlanningResult(parsed, input);
+        }
+    }
+    catch {
+        // Fall through to deterministic fallback
+    }
+    return buildDeterministicPlan(input);
+}
+// ---------------------------------------------------------------------------
+// Deterministic fallback (no model required)
+// ---------------------------------------------------------------------------
+export function buildDeterministicPlan(input) {
+    const { userIntent, availableContracts, existingWorkflows, constraints } = input;
+    const intentLower = userIntent.toLowerCase();
+    const intentTokens = intentLower.split(/\s+/).filter((t) => t.length > 2);
+    const existingMatch = findBestExistingWorkflow(existingWorkflows ?? [], intentTokens, intentLower);
+    const scoredContracts = availableContracts
+        .map((c) => ({ contract: c, score: scoreContract(c, intentTokens, intentLower, constraints) }))
+        .sort((a, b) => b.score - a.score);
+    const maxNodes = constraints?.maxNodes ?? 5;
+    const requiredOutputs = new Set(constraints?.requiredOutputTypes ?? []);
+    const selectedNodes = [];
+    const usedSlugs = new Set();
+    const warnings = [];
+    for (const { contract, score } of scoredContracts) {
+        if (selectedNodes.length >= maxNodes)
+            break;
+        if (score <= 0)
+            break;
+        if (usedSlugs.has(contract.slug))
+            continue;
+        if (constraints?.avoidSlugs?.includes(contract.slug))
+            continue;
+        const suggestedBindings = {};
+        for (const field of contract.inputs) {
+            suggestedBindings[field.key] = field.defaultValue ?? "";
+        }
+        const upstreamSlugs = [];
+        if (selectedNodes.length > 0) {
+            const lastNode = selectedNodes[selectedNodes.length - 1];
+            const lastContract = availableContracts.find((c) => c.slug === lastNode.slug);
+            if (lastContract && hasOutputInputOverlap(lastContract, contract)) {
+                upstreamSlugs.push(lastNode.slug);
+            }
+        }
+        selectedNodes.push({
+            slug: contract.slug,
+            displayName: contract.displayName,
+            reason: `Matches intent tokens and produces ${contract.outputTypes.join(", ") || "general"} output.`,
+            suggestedBindings,
+            upstreamNodeSlugs: upstreamSlugs.length > 0 ? upstreamSlugs : undefined,
+        });
+        usedSlugs.add(contract.slug);
+        for (const outType of contract.outputTypes) {
+            requiredOutputs.delete(outType);
+        }
+    }
+    if (requiredOutputs.size > 0) {
+        warnings.push(`Could not find contracts producing required output types: ${[...requiredOutputs].join(", ")}.`);
+    }
+    if (selectedNodes.length === 0) {
+        warnings.push("No contracts matched the user intent. Consider refining the task description.");
+        return {
+            proposedNodes: [],
+            explanation: "No matching contracts found for the given intent.",
+            confidence: 0.1,
+            warnings,
+        };
+    }
+    return {
+        proposedNodes: selectedNodes,
+        explanation: `Proposed ${selectedNodes.length}-node pipeline using ${selectedNodes.map((n) => n.slug).join(" -> ")}.`,
+        alternativeExistingWorkflowId: existingMatch?.workflowId,
+        alternativeExistingWorkflowReason: existingMatch
+            ? `Existing workflow "${existingMatch.name}" may already fulfill this intent.`
+            : undefined,
+        confidence: Math.min(0.7, selectedNodes.length > 0 ? scoredContracts[0].score / 10 : 0.1),
+        warnings,
+    };
+}
+// ---------------------------------------------------------------------------
+// Scoring helpers
+// ---------------------------------------------------------------------------
+function scoreContract(contract, intentTokens, intentLower, constraints) {
+    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;
+    }
+    if (constraints?.requiredOutputTypes) {
+        for (const requiredType of constraints.requiredOutputTypes) {
+            if (contract.outputTypes.includes(requiredType))
+                score += 3;
+        }
+    }
+    if (constraints?.preferredFamilies) {
+        if (constraints.preferredFamilies.includes(contract.family))
+            score += 2;
+    }
+    for (const outType of contract.outputTypes) {
+        if (intentLower.includes(outType.toLowerCase()))
+            score += 1.5;
+    }
+    return score;
+}
+function findBestExistingWorkflow(workflows, intentTokens, intentLower) {
+    let best = null;
+    let bestScore = 0;
+    for (const wf of workflows) {
+        if (wf.label === "archived")
+            continue;
+        let score = 0;
+        const nameLower = wf.name.toLowerCase();
+        const slugsLower = wf.nodeSlugs.join(" ").toLowerCase();
+        for (const token of intentTokens) {
+            if (nameLower.includes(token))
+                score += 2;
+            if (slugsLower.includes(token))
+                score += 1.5;
+        }
+        if (wf.label === "canonical")
+            score += 1;
+        if (score > bestScore) {
+            bestScore = score;
+            best = wf;
+        }
+    }
+    return bestScore >= 3 ? best : null;
+}
+function hasOutputInputOverlap(upstream, downstream) {
+    const outputTypes = new Set(upstream.outputTypes.map((t) => t.toLowerCase()));
+    for (const input of downstream.inputs) {
+        const keyLower = input.key.toLowerCase();
+        for (const outType of outputTypes) {
+            if (keyLower.includes(outType) || outType.includes(keyLower)) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+// ---------------------------------------------------------------------------
+// Prompt builder
+// ---------------------------------------------------------------------------
+function buildPlannerPrompt(input) {
+    const { userIntent, availableContracts, existingWorkflows, executionMode, constraints } = input;
+    const sections = [
+        `User Intent: ${userIntent}`,
+        `Execution Mode: ${executionMode ?? "hosted"}`,
+    ];
+    if (constraints) {
+        sections.push("", "Constraints:");
+        if (constraints.maxNodes)
+            sections.push(`  Max Nodes: ${constraints.maxNodes}`);
+        if (constraints.requiredOutputTypes?.length) {
+            sections.push(`  Required Output Types: ${constraints.requiredOutputTypes.join(", ")}`);
+        }
+        if (constraints.preferredFamilies?.length) {
+            sections.push(`  Preferred Families: ${constraints.preferredFamilies.join(", ")}`);
+        }
+        if (constraints.avoidSlugs?.length) {
+            sections.push(`  Avoid Slugs: ${constraints.avoidSlugs.join(", ")}`);
+        }
+    }
+    sections.push("", `Available Contracts (${availableContracts.length}):`);
+    for (const contract of availableContracts.slice(0, 40)) {
+        const inputs = contract.inputs
+            .map((i) => `${i.key}:${i.type}${i.required ? "*" : ""}`)
+            .join(", ");
+        sections.push(`  - ${contract.slug} "${contract.displayName}" (${contract.family})`
+            + ` — inputs=[${inputs}], outputs=[${contract.outputTypes.join(",")}]`
+            + `, strategy=${contract.executionStrategy}`);
+    }
+    if (existingWorkflows && existingWorkflows.length > 0) {
+        sections.push("", `Existing Workflows (${existingWorkflows.length}):`);
+        for (const wf of existingWorkflows.slice(0, 20)) {
+            sections.push(`  - [${wf.workflowId}] "${wf.name}" (${wf.label ?? "unlabeled"}) — nodes: ${wf.nodeSlugs.join(", ")} — v${wf.versionCount}`);
+        }
+    }
+    return sections.join("\n");
+}
+function validatePlanningResult(raw, input) {
+    const availableSlugs = new Set(input.availableContracts.map((c) => c.slug));
+    const proposedNodes = [];
+    const warnings = Array.isArray(raw.warnings) ? [...raw.warnings] : [];
+    if (Array.isArray(raw.proposedNodes)) {
+        for (const node of raw.proposedNodes) {
+            if (typeof node.slug !== "string")
+                continue;
+            if (!availableSlugs.has(node.slug)) {
+                warnings.push(`Proposed node slug "${node.slug}" is not in the available contracts — skipped.`);
+                continue;
+            }
+            proposedNodes.push({
+                slug: node.slug,
+                displayName: typeof node.displayName === "string" ? node.displayName : node.slug,
+                reason: typeof node.reason === "string" ? node.reason : "Selected by planner.",
+                suggestedBindings: node.suggestedBindings && typeof node.suggestedBindings === "object"
+                    ? node.suggestedBindings
+                    : {},
+                upstreamNodeSlugs: Array.isArray(node.upstreamNodeSlugs) ? node.upstreamNodeSlugs : undefined,
+            });
+        }
+    }
+    return {
+        proposedNodes,
+        explanation: typeof raw.explanation === "string" ? raw.explanation : "Plan generated.",
+        alternativeExistingWorkflowId: typeof raw.alternativeExistingWorkflowId === "string"
+            ? raw.alternativeExistingWorkflowId
+            : undefined,
+        alternativeExistingWorkflowReason: typeof raw.alternativeExistingWorkflowReason === "string"
+            ? raw.alternativeExistingWorkflowReason
+            : undefined,
+        confidence: typeof raw.confidence === "number" ? Math.max(0, Math.min(1, raw.confidence)) : 0.5,
+        warnings,
+    };
+}
+// ---------------------------------------------------------------------------
+// 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=planner.js.map

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

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

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

@@ -0,0 +1,27 @@
+/**
+ * Native Intelligence — Provider / Backend Adapter
+ *
+ * Thin adapter to the actual model backend. V1 supports:
+ *   - Local Gemma endpoint (OpenAI-compatible API)
+ *   - Hosted internal model endpoint
+ *   - Easy swap later (custom fine-tuned, different model families)
+ *
+ * The rest of the system does not care whether the backend is:
+ *   - local Gemma 3n
+ *   - hosted Gemma 3
+ *   - CodeGemma
+ *   - a future custom fine-tuned model
+ */
+import type { NativeIntelligenceBackend, NativeIntelligenceConfig } from "./contract.js";
+export declare function createNativeIntelligenceBackend(config: NativeIntelligenceConfig): NativeIntelligenceBackend;
+export declare function createStubBackend(): NativeIntelligenceBackend;
+export declare function checkBackendHealth(config: NativeIntelligenceConfig): Promise<{
+    available: boolean;
+    latencyMs: number;
+    error?: string;
+}>;
+export declare class NativeIntelligenceBackendError extends Error {
+    readonly status: number;
+    constructor(status: number, message: string);
+}
+//# sourceMappingURL=provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/runtime/native-intelligence/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,yBAAyB,EACzB,wBAAwB,EAGzB,MAAM,eAAe,CAAC;AAyBvB,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,wBAAwB,GAC/B,yBAAyB,CAgH3B;AAiFD,wBAAgB,iBAAiB,IAAI,yBAAyB,CAU7D;AAMD,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA6BpE;AAMD,qBAAa,8BAA+B,SAAQ,KAAK;IACvD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBACZ,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI5C"}

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

@@ -0,0 +1,221 @@
+/**
+ * Native Intelligence — Provider / Backend Adapter
+ *
+ * Thin adapter to the actual model backend. V1 supports:
+ *   - Local Gemma endpoint (OpenAI-compatible API)
+ *   - Hosted internal model endpoint
+ *   - Easy swap later (custom fine-tuned, different model families)
+ *
+ * The rest of the system does not care whether the backend is:
+ *   - local Gemma 3n
+ *   - hosted Gemma 3
+ *   - CodeGemma
+ *   - a future custom fine-tuned model
+ */
+// ---------------------------------------------------------------------------
+// Backend creation
+// ---------------------------------------------------------------------------
+export function createNativeIntelligenceBackend(config) {
+    return {
+        async complete(input) {
+            const startMs = Date.now();
+            const messages = [
+                { role: "system", content: input.systemPrompt },
+                { role: "user", content: input.userPrompt },
+            ];
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), config.timeoutMs ?? 30_000);
+            try {
+                const headers = {
+                    "content-type": "application/json",
+                    accept: "application/json",
+                };
+                if (config.apiKey) {
+                    headers.authorization = `Bearer ${config.apiKey}`;
+                }
+                const modelCandidates = resolveModelCandidates(config);
+                const endpointCandidates = resolveEndpointCandidates(config);
+                let result = null;
+                let lastError = null;
+                for (let endpointIndex = 0; endpointIndex < endpointCandidates.length; endpointIndex += 1) {
+                    const endpoint = endpointCandidates[endpointIndex];
+                    for (let modelIndex = 0; modelIndex < modelCandidates.length; modelIndex += 1) {
+                        const model = modelCandidates[modelIndex];
+                        const body = {
+                            model,
+                            messages,
+                            temperature: input.temperature ?? config.defaultTemperature ?? 0.3,
+                            max_tokens: input.maxTokens ?? config.defaultMaxTokens ?? 4096,
+                        };
+                        if (input.responseFormat === "json") {
+                            body.response_format = { type: "json_object" };
+                        }
+                        try {
+                            const response = await fetch(endpoint, {
+                                method: "POST",
+                                headers,
+                                body: JSON.stringify(body),
+                                signal: controller.signal,
+                            });
+                            if (response.ok) {
+                                result = (await response.json());
+                                break;
+                            }
+                            const errorText = await response.text().catch(() => "");
+                            const backendError = new NativeIntelligenceBackendError(response.status, `Model backend responded with ${response.status}: ${errorText || response.statusText}`);
+                            lastError = backendError;
+                            if (!shouldTryNextModel(response.status, errorText, model, config, modelCandidates)) {
+                                throw backendError;
+                            }
+                        }
+                        catch (err) {
+                            if (err instanceof NativeIntelligenceBackendError) {
+                                throw err;
+                            }
+                            lastError = new NativeIntelligenceBackendError(502, err instanceof Error ? err.message : "Unknown backend error");
+                            const hasAnotherEndpoint = endpointIndex < endpointCandidates.length - 1;
+                            if (!hasAnotherEndpoint) {
+                                throw lastError;
+                            }
+                            break;
+                        }
+                    }
+                    if (result)
+                        break;
+                }
+                if (!result) {
+                    throw lastError ?? new NativeIntelligenceBackendError(502, "Model backend returned no response.");
+                }
+                const latencyMs = Date.now() - startMs;
+                const text = extractCompletionText(result);
+                return {
+                    text,
+                    usage: result.usage
+                        ? {
+                            promptTokens: result.usage.prompt_tokens ?? 0,
+                            completionTokens: result.usage.completion_tokens ?? 0,
+                            totalTokens: result.usage.total_tokens ?? 0,
+                        }
+                        : undefined,
+                    modelId: result.model ?? config.modelId,
+                    latencyMs,
+                };
+            }
+            finally {
+                clearTimeout(timeoutId);
+            }
+        },
+    };
+}
+function resolveModelCandidates(config) {
+    const primary = config.modelId;
+    const candidates = [];
+    if (typeof config.localModel === "string" && config.localModel.trim().length > 0) {
+        candidates.push(config.localModel.trim());
+    }
+    const envLocalModel = process.env.NATIVE_INTELLIGENCE_LOCAL_MODEL?.trim()
+        || process.env.OLLAMA_MODEL?.trim();
+    if (envLocalModel && !candidates.includes(envLocalModel)) {
+        candidates.push(envLocalModel);
+    }
+    if (!candidates.includes(primary)) {
+        candidates.push(primary);
+    }
+    // Ollama commonly registers Gemma with explicit size tags (e.g. gemma3:4b).
+    // Keep canonical model ids in config, but try a practical local fallback.
+    if (config.backendType === "local"
+        && primary === "gemma3"
+        && !candidates.includes("gemma3:4b")) {
+        candidates.push("gemma3:4b");
+    }
+    return candidates;
+}
+function resolveEndpointCandidates(config) {
+    const primary = config.endpoint;
+    const candidates = [primary];
+    if (config.backendType !== "local")
+        return candidates;
+    const normalized = primary.toLowerCase();
+    if ((normalized.includes("localhost:8080") || normalized.includes("127.0.0.1:8080"))
+        && !candidates.includes("http://127.0.0.1:11434/v1/chat/completions")) {
+        candidates.push("http://127.0.0.1:11434/v1/chat/completions");
+    }
+    return candidates;
+}
+function shouldTryNextModel(status, errorText, attemptedModel, config, candidates) {
+    const hasNextCandidate = candidates[candidates.length - 1] !== attemptedModel;
+    if (!hasNextCandidate)
+        return false;
+    if (config.backendType !== "local")
+        return false;
+    const normalizedError = errorText.toLowerCase();
+    return status === 404 || normalizedError.includes("model") && normalizedError.includes("not found");
+}
+function extractCompletionText(response) {
+    if (response.choices && response.choices.length > 0) {
+        const choice = response.choices[0];
+        if (choice.message?.content)
+            return choice.message.content;
+        if (choice.text)
+            return choice.text;
+    }
+    throw new NativeIntelligenceBackendError(502, "Model backend returned no completion text.");
+}
+// ---------------------------------------------------------------------------
+// Stub backend for offline / fallback use
+// ---------------------------------------------------------------------------
+export function createStubBackend() {
+    return {
+        async complete(input) {
+            return {
+                text: "",
+                modelId: "stub",
+                latencyMs: 0,
+            };
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Backend availability check
+// ---------------------------------------------------------------------------
+export async function checkBackendHealth(config) {
+    const startMs = Date.now();
+    try {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), 5_000);
+        try {
+            const response = await fetch(config.endpoint.replace(/\/chat\/completions$/, "/models"), {
+                method: "GET",
+                headers: {
+                    accept: "application/json",
+                    ...(config.apiKey ? { authorization: `Bearer ${config.apiKey}` } : {}),
+                },
+                signal: controller.signal,
+            });
+            const latencyMs = Date.now() - startMs;
+            return { available: response.ok, latencyMs };
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    catch (err) {
+        const latencyMs = Date.now() - startMs;
+        return {
+            available: false,
+            latencyMs,
+            error: err instanceof Error ? err.message : "Unknown error",
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// Error
+// ---------------------------------------------------------------------------
+export class NativeIntelligenceBackendError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+    }
+}
+//# sourceMappingURL=provider.js.map

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

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

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

@@ -0,0 +1,23 @@
+/**
+ * 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.
+ */
+import type { NativeIntelligenceBackend, WorkflowRecommendationInput, WorkflowRecommendationResult } from "./contract.js";
+export declare function recommendWorkflow(input: WorkflowRecommendationInput, backend: NativeIntelligenceBackend): Promise<WorkflowRecommendationResult>;
+export declare function buildDeterministicRecommendation(input: WorkflowRecommendationInput): WorkflowRecommendationResult;
+//# sourceMappingURL=recommender.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recommender.d.ts","sourceRoot":"","sources":["../../../src/runtime/native-intelligence/recommender.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EACV,yBAAyB,EACzB,2BAA2B,EAC3B,4BAA4B,EAK7B,MAAM,eAAe,CAAC;AAoDvB,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,2BAA2B,EAClC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,4BAA4B,CAAC,CAqBvC;AAMD,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,2BAA2B,GACjC,4BAA4B,CAwG9B"}