conatus 0.1.0

package/dist/prompt/context-assembler.js

@@ -0,0 +1,346 @@
+/**
+ * context-assembler.ts
+ * Assembles context from hierarchical memory layers into XML-tagged blocks for LLM prompts.
+ */
+import { getSlotConfig, getSlotDefinition, } from "./slot-definitions.js";
+import { wrapXmlTag, estimateTokens, trimToTokenBudget, formatGoalContext, formatCurrentState, formatObservationHistory, formatLessons, formatKnowledge, formatReflections, formatWorkspaceState, formatStrategyTemplates, formatFailureContext, formatTaskResults, } from "./formatters.js";
+import { allocateBudget } from "../execution/context-budget.js";
+// ─── Constants ────────────────────────────────────────────────────────────────
+/** Lessons older than this many days AND with low access_count are considered stale. */
+const CONTEXT_FRESHNESS_DAYS = 14;
+/** Minimum cosine similarity threshold for vector knowledge search. */
+const KNOWLEDGE_SIMILARITY_THRESHOLD = 0.6;
+/** Strategy templates older than this many days are deprioritized when no vector search is available. */
+const STRATEGY_TEMPLATE_FRESHNESS_DAYS = 30;
+// ─── Slot → BudgetCategory mapping ───────────────────────────────────────────
+const SLOT_CATEGORY_MAP = {
+    goal_definition: "goalDefinition",
+    current_state: "goalDefinition",
+    dimension_history: "observations",
+    recent_task_results: "observations",
+    reflections: "observations",
+    workspace_state: "observations",
+    failure_context: "observations",
+    lessons: "knowledge",
+    knowledge: "knowledge",
+    strategy_templates: "transferKnowledge",
+};
+// ─── Default system prompt ────────────────────────────────────────────────────
+const DEFAULT_SYSTEM_PROMPT = "You are an AI assistant helping to achieve a goal. Use the context provided to give accurate, focused responses.";
+// ─── ContextAssembler ─────────────────────────────────────────────────────────
+export class ContextAssembler {
+    deps;
+    budget;
+    constructor(deps = {}) {
+        this.deps = deps;
+        this.budget = deps.budgetTokens ?? 4000;
+    }
+    async build(purpose, goalId, dimensionName, additionalContext) {
+        const slotConfig = getSlotConfig(purpose);
+        const goalState = goalId ? await this.loadGoalState(goalId) : null;
+        const dims = this.extractDimensionNames(goalState, dimensionName);
+        // Compute per-category token budgets
+        const allocator = this.deps.budgetAllocator ?? allocateBudget;
+        const baseAllocation = allocator(this.budget);
+        const categoryBudgets = this.applyBudgetOverrides(baseAllocation, slotConfig.budgetOverrides);
+        // Assemble each active slot
+        const assembled = [];
+        for (const slot of slotConfig.activeSlots) {
+            const slotDef = getSlotDefinition(slot);
+            const content = await this.assembleSlot(slot, goalId, goalState, dims, additionalContext);
+            if (!content)
+                continue;
+            const xmlBlock = wrapXmlTag(slotDef.xmlTag, content);
+            if (!xmlBlock)
+                continue;
+            const category = SLOT_CATEGORY_MAP[slot];
+            assembled.push({ slotDef, xmlBlock, tokens: estimateTokens(xmlBlock), category });
+        }
+        // Enforce budget: respect per-category limits, then global total
+        const trimmed = this.enforceBudget(assembled, this.budget, categoryBudgets);
+        const contextBlock = trimmed.map((e) => e.xmlBlock).join("\n\n");
+        const totalTokensUsed = estimateTokens(contextBlock);
+        return {
+            systemPrompt: "",
+            contextBlock,
+            totalTokensUsed,
+        };
+    }
+    // ─── Budget helpers ──────────────────────────────────────────────────────────
+    applyBudgetOverrides(base, overrides) {
+        if (!overrides)
+            return base;
+        // Overrides are percentages; convert to absolute tokens
+        const result = { ...base };
+        for (const [cat, pct] of Object.entries(overrides)) {
+            result[cat] = Math.floor(this.budget * (pct / 100));
+        }
+        return result;
+    }
+    // ─── Slot assemblers ────────────────────────────────────────────────────────
+    async assembleSlot(slot, goalId, goalState, dims, additionalContext) {
+        try {
+            switch (slot) {
+                case "goal_definition":
+                    return this.buildGoalDefinition(goalState);
+                case "current_state":
+                    return this.buildCurrentState(goalState);
+                case "dimension_history":
+                    return this.buildDimensionHistory(goalState);
+                case "recent_task_results":
+                    return this.buildRecentTaskResults(additionalContext);
+                case "reflections":
+                    if (!goalId)
+                        return "";
+                    return await this.buildReflections(goalId);
+                case "lessons":
+                    if (!goalId)
+                        return "";
+                    return await this.buildLessons(goalId, dims);
+                case "knowledge":
+                    if (!goalId)
+                        return "";
+                    return await this.buildKnowledge(goalId);
+                case "strategy_templates":
+                    return await this.buildStrategyTemplates(goalState);
+                case "workspace_state":
+                    if (!goalId)
+                        return "";
+                    return await this.buildWorkspaceState(goalId, dims[0]);
+                case "failure_context":
+                    return this.buildFailureContext(additionalContext);
+                default:
+                    return "";
+            }
+        }
+        catch {
+            return "";
+        }
+    }
+    // ─── Individual slot builders ────────────────────────────────────────────────
+    buildGoalDefinition(goalState) {
+        if (!goalState)
+            return "";
+        return formatGoalContext({ title: goalState.title, description: goalState.description }, goalState.active_strategy);
+    }
+    buildCurrentState(goalState) {
+        if (!goalState?.dimensions?.length)
+            return "";
+        const dims = goalState.dimensions.map((d) => ({
+            name: d.name,
+            current: d.current_value,
+            target: d.threshold?.value,
+            gap: d.gap,
+        }));
+        return formatCurrentState(dims);
+    }
+    buildDimensionHistory(goalState) {
+        if (!goalState?.dimensions?.length)
+            return "";
+        const allHistory = [];
+        for (const dim of goalState.dimensions) {
+            if (dim.history?.length) {
+                for (const h of dim.history) {
+                    allHistory.push({ timestamp: h.timestamp, score: h.value });
+                }
+            }
+        }
+        return formatObservationHistory(allHistory);
+    }
+    buildRecentTaskResults(additionalContext) {
+        const raw = additionalContext?.["existingTasks"] ?? additionalContext?.["recentTaskResults"];
+        if (!raw)
+            return "";
+        try {
+            const parsed = JSON.parse(raw);
+            if (Array.isArray(parsed)) {
+                return formatTaskResults(parsed);
+            }
+        }
+        catch {
+            // raw is not JSON — return it as-is
+            return raw;
+        }
+        return "";
+    }
+    async buildReflections(goalId) {
+        if (!this.deps.reflectionGetter)
+            return "";
+        const reflections = await this.deps.reflectionGetter(goalId, 5);
+        if (!reflections?.length)
+            return "";
+        return formatReflections(reflections.map((r) => ({
+            what_failed: r.why_it_worked_or_failed,
+            suggestion: r.what_to_do_differently,
+            content: r.what_was_attempted,
+        })));
+    }
+    async buildLessons(goalId, dims) {
+        if (!this.deps.memoryLifecycle)
+            return "";
+        const result = await this.deps.memoryLifecycle.selectForWorkingMemory(goalId, dims, []);
+        if (!result?.lessons?.length)
+            return "";
+        let lessons = result.lessons;
+        // Apply stale filtering only when we have more entries than needed
+        const budgetedMax = 5; // default lesson slot max
+        if (lessons.length > budgetedMax) {
+            const cutoffMs = CONTEXT_FRESHNESS_DAYS * 24 * 60 * 60 * 1000;
+            const now = Date.now();
+            const fresh = lessons.filter((l) => {
+                const lastAccessed = l.last_accessed ? new Date(l.last_accessed).getTime() : 0;
+                const accessCount = l.access_count ?? 0;
+                const isStale = (now - lastAccessed) > cutoffMs && accessCount < 2;
+                return !isStale;
+            });
+            // Only apply filter if it doesn't eliminate everything
+            if (fresh.length > 0) {
+                lessons = fresh;
+            }
+        }
+        return formatLessons(lessons.map((l) => ({
+            importance: l.relevance_tags?.includes("HIGH")
+                ? "HIGH"
+                : l.relevance_tags?.includes("LOW")
+                    ? "LOW"
+                    : "MEDIUM",
+            content: l.lesson ?? l.content ?? "",
+        })));
+    }
+    async buildKnowledge(goalId) {
+        if (!this.deps.knowledgeManager && !this.deps.vectorIndex)
+            return "";
+        let entries = [];
+        if (this.deps.knowledgeManager?.getRelevantKnowledge) {
+            entries = await this.deps.knowledgeManager.getRelevantKnowledge(goalId);
+        }
+        else if (this.deps.knowledgeManager?.loadKnowledge) {
+            entries = await this.deps.knowledgeManager.loadKnowledge(goalId);
+        }
+        else if (this.deps.vectorIndex) {
+            const results = await this.deps.vectorIndex.search(goalId, 5, KNOWLEDGE_SIMILARITY_THRESHOLD);
+            entries = results.map((r) => ({ content: r.text, confidence: r.similarity }));
+        }
+        if (!entries?.length)
+            return "";
+        return formatKnowledge(entries);
+    }
+    async buildStrategyTemplates(goalState) {
+        if (!this.deps.strategyTemplateSearch)
+            return "";
+        const query = goalState?.active_strategy?.hypothesis ?? goalState?.title ?? "";
+        if (!query)
+            return "";
+        let templates = await this.deps.strategyTemplateSearch(query, 3);
+        if (!templates?.length)
+            return "";
+        if (this.deps.vectorIndex) {
+            // Vector search: apply cosine similarity threshold
+            templates = templates.filter((t) => {
+                const sim = t.similarity ?? t.score ?? 1;
+                return sim >= KNOWLEDGE_SIMILARITY_THRESHOLD;
+            });
+        }
+        else {
+            // No vector search: deprioritize templates older than 30 days
+            const cutoffMs = STRATEGY_TEMPLATE_FRESHNESS_DAYS * 24 * 60 * 60 * 1000;
+            const now = Date.now();
+            const fresh = templates.filter((t) => {
+                const created = t.created_at ?? t.createdAt;
+                if (!created)
+                    return true; // no date means keep
+                return (now - new Date(created).getTime()) <= cutoffMs;
+            });
+            // Use fresh templates if any exist; otherwise fall back to all templates
+            if (fresh.length > 0) {
+                templates = fresh;
+            }
+        }
+        if (!templates?.length)
+            return "";
+        return formatStrategyTemplates(templates);
+    }
+    async buildWorkspaceState(goalId, dimensionName) {
+        if (!this.deps.contextProvider?.buildWorkspaceContextItems)
+            return "";
+        const dim = dimensionName ?? "";
+        const items = await this.deps.contextProvider.buildWorkspaceContextItems(goalId, dim);
+        if (!items?.length)
+            return "";
+        return formatWorkspaceState(items.map((i) => `${i.label}: ${i.content}`));
+    }
+    buildFailureContext(additionalContext) {
+        const raw = additionalContext?.["failureContext"] ?? additionalContext?.["failure_context"];
+        if (!raw)
+            return "";
+        return formatFailureContext(raw);
+    }
+    // ─── Helpers ─────────────────────────────────────────────────────────────────
+    async loadGoalState(goalId) {
+        if (!goalId || !this.deps.stateManager)
+            return null;
+        try {
+            return await this.deps.stateManager.loadGoalState(goalId);
+        }
+        catch {
+            return null;
+        }
+    }
+    extractDimensionNames(goalState, dimensionName) {
+        if (dimensionName)
+            return [dimensionName];
+        if (!goalState?.dimensions?.length)
+            return [];
+        return goalState.dimensions.map((d) => d.name);
+    }
+    enforceBudget(assembled, budget, categoryBudgets) {
+        // Apply per-category limits first when provided
+        let capped = assembled;
+        if (categoryBudgets) {
+            const categoryUsed = {};
+            capped = assembled.map((entry) => {
+                const cat = entry.category;
+                const catLimit = categoryBudgets[cat];
+                const used = categoryUsed[cat] ?? 0;
+                const remaining = catLimit - used;
+                if (remaining <= 0)
+                    return null;
+                if (entry.tokens <= remaining) {
+                    categoryUsed[cat] = used + entry.tokens;
+                    return entry;
+                }
+                // Trim to fit within remaining category budget
+                const trimmedBlock = trimToTokenBudget(entry.xmlBlock, remaining);
+                const trimmedTokens = estimateTokens(trimmedBlock);
+                categoryUsed[cat] = used + trimmedTokens;
+                return { ...entry, xmlBlock: trimmedBlock, tokens: trimmedTokens };
+            }).filter((e) => e !== null);
+        }
+        const total = capped.reduce((sum, e) => sum + e.tokens, 0);
+        if (total <= budget)
+            return capped;
+        // Sort by priority ascending (lower priority number = more important)
+        const sorted = [...capped].sort((a, b) => a.slotDef.priority - b.slotDef.priority);
+        // Trim from lowest priority (highest number) first
+        let remaining = budget;
+        const result = [];
+        for (const entry of sorted) {
+            if (remaining <= 0)
+                break;
+            if (entry.tokens <= remaining) {
+                result.push(entry);
+                remaining -= entry.tokens;
+            }
+            else {
+                // Partially trim this entry
+                const trimmedBlock = trimToTokenBudget(entry.xmlBlock, remaining);
+                const trimmedTokens = estimateTokens(trimmedBlock);
+                result.push({ ...entry, xmlBlock: trimmedBlock, tokens: trimmedTokens });
+                remaining = 0;
+            }
+        }
+        // Restore original slot order (by priority ascending = natural order)
+        return result.sort((a, b) => a.slotDef.priority - b.slotDef.priority);
+    }
+}
+//# sourceMappingURL=context-assembler.js.map

package/dist/prompt/context-assembler.js.map

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

package/dist/prompt/formatters.d.ts

@@ -0,0 +1,49 @@
+/**
+ * XML tag formatting and token trimming utilities for PromptGateway.
+ */
+export declare function wrapXmlTag(tag: string, content: string): string;
+export declare function estimateTokens(text: string): number;
+export declare function trimToTokenBudget(text: string, maxTokens: number): string;
+export declare function formatGoalContext(goal: {
+    title?: string;
+    description?: string;
+}, strategy?: {
+    hypothesis?: string;
+}): string;
+export declare function formatCurrentState(dimensions: Array<{
+    name: string;
+    current: number;
+    target?: number;
+    gap?: number;
+}>): string;
+export declare function formatObservationHistory(history: Array<{
+    timestamp: string;
+    score: number;
+}>, direction?: string): string;
+export declare function formatLessons(lessons: Array<{
+    importance: string;
+    content: string;
+}>): string;
+export declare function formatKnowledge(entries: Array<{
+    question?: string;
+    answer?: string;
+    content?: string;
+    confidence?: number;
+}>): string;
+export declare function formatReflections(reflections: Array<{
+    what_failed?: string;
+    suggestion?: string;
+    content?: string;
+}>): string;
+export declare function formatWorkspaceState(items: string[]): string;
+export declare function formatStrategyTemplates(templates: Array<{
+    hypothesis_pattern: string;
+    effectiveness_score: number;
+}>): string;
+export declare function formatFailureContext(context: string): string;
+export declare function formatTaskResults(results: Array<{
+    task_description: string;
+    outcome: string;
+    success: boolean;
+}>): string;
+//# sourceMappingURL=formatters.d.ts.map

package/dist/prompt/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../src/prompt/formatters.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAWzE;AAMD,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EAC9C,QAAQ,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GACjC,MAAM,CAQR;AAED,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAClF,MAAM,CAYR;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,KAAK,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EACpD,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAUR;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,KAAK,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GACtD,MAAM,CAaR;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,KAAK,CAAC;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAC5F,MAAM,CAmBR;AAED,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,KAAK,CAAC;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAClF,MAAM,CAYR;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAG5D;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,KAAK,CAAC;IAAE,kBAAkB,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,MAAM,CAAA;CAAE,CAAC,GAC5E,MAAM,CAMR;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,KAAK,CAAC;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,GAC9E,MAAM,CASR"}

package/dist/prompt/formatters.js

@@ -0,0 +1,136 @@
+/**
+ * XML tag formatting and token trimming utilities for PromptGateway.
+ */
+// ---------------------------------------------------------------------------
+// Core helpers
+// ---------------------------------------------------------------------------
+export function wrapXmlTag(tag, content) {
+    if (!content || !content.trim())
+        return "";
+    return `<${tag}>\n${content}\n</${tag}>`;
+}
+export function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+export function trimToTokenBudget(text, maxTokens) {
+    if (estimateTokens(text) <= maxTokens)
+        return text;
+    const maxChars = maxTokens * 4;
+    const trimmed = text.slice(0, maxChars);
+    // Try to trim at a line boundary
+    const lastNewline = trimmed.lastIndexOf("\n");
+    const result = lastNewline > 0 ? trimmed.slice(0, lastNewline) : trimmed;
+    return result + "\n... (truncated)";
+}
+// ---------------------------------------------------------------------------
+// Context formatters (each returns inner content; caller wraps with wrapXmlTag)
+// ---------------------------------------------------------------------------
+export function formatGoalContext(goal, strategy) {
+    const lines = [];
+    if (goal.title)
+        lines.push(`Goal: ${goal.title}`);
+    if (goal.description)
+        lines.push(`Description: ${goal.description}`);
+    if (strategy?.hypothesis)
+        lines.push(`Active Strategy: ${strategy.hypothesis}`);
+    return lines.join("\n");
+}
+export function formatCurrentState(dimensions) {
+    if (!dimensions.length)
+        return "";
+    return dimensions
+        .map((d) => {
+        let line = `${d.name}: ${d.current}`;
+        if (d.target !== undefined)
+            line += ` (target: ${d.target}`;
+        if (d.gap !== undefined)
+            line += `, gap: ${d.gap}`;
+        if (d.target !== undefined)
+            line += ")";
+        return line;
+    })
+        .join("\n");
+}
+export function formatObservationHistory(history, direction) {
+    if (!history.length)
+        return "";
+    const recent = history.slice(-5);
+    const trend = recent.map((h) => `${h.timestamp}: ${h.score}`).join(", ");
+    const lines = [`Trend (last ${recent.length}): ${trend}`];
+    if (direction)
+        lines.push(`Direction: ${direction}`);
+    return lines.join("\n");
+}
+export function formatLessons(lessons) {
+    if (!lessons.length)
+        return "";
+    const importanceOrder = { HIGH: 0, MEDIUM: 1, LOW: 2 };
+    return [...lessons]
+        .sort((a, b) => (importanceOrder[a.importance.toUpperCase()] ?? 99) -
+        (importanceOrder[b.importance.toUpperCase()] ?? 99))
+        .map((l) => `- [${l.importance.toUpperCase()}] ${l.content}`)
+        .join("\n");
+}
+export function formatKnowledge(entries) {
+    if (!entries.length)
+        return "";
+    return entries
+        .map((e) => {
+        if (e.question && e.answer) {
+            let line = `Q: ${e.question}\nA: ${e.answer}`;
+            if (e.confidence !== undefined)
+                line += ` (confidence: ${e.confidence})`;
+            return line;
+        }
+        if (e.content) {
+            let line = e.content;
+            if (e.confidence !== undefined)
+                line += ` (confidence: ${e.confidence})`;
+            return line;
+        }
+        return null;
+    })
+        .filter(Boolean)
+        .join("\n");
+}
+export function formatReflections(reflections) {
+    if (!reflections.length)
+        return "";
+    return reflections
+        .map((r) => {
+        if (r.what_failed && r.suggestion) {
+            return `Failed: ${r.what_failed}\nSuggestion: ${r.suggestion}`;
+        }
+        return r.content ?? null;
+    })
+        .filter(Boolean)
+        .join("\n---\n");
+}
+export function formatWorkspaceState(items) {
+    if (!items.length)
+        return "";
+    return items.join("\n");
+}
+export function formatStrategyTemplates(templates) {
+    if (!templates.length)
+        return "";
+    return templates
+        .map((t) => `- ${t.hypothesis_pattern} (effectiveness: ${t.effectiveness_score})`)
+        .join("\n");
+}
+export function formatFailureContext(context) {
+    if (!context || !context.trim())
+        return "";
+    return `Failure Context:\n${context}`;
+}
+export function formatTaskResults(results) {
+    if (!results.length)
+        return "";
+    return results
+        .map((r) => {
+        const status = r.success ? "SUCCESS" : "FAILURE";
+        return `[${status}] ${r.task_description}\n  Outcome: ${r.outcome}`;
+    })
+        .join("\n");
+}
+//# sourceMappingURL=formatters.js.map

package/dist/prompt/formatters.js.map

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

package/dist/prompt/gateway.d.ts

@@ -0,0 +1,30 @@
+/**
+ * gateway.ts
+ * Thin orchestrator: assembles context, calls LLM, parses response.
+ */
+import { z } from "zod";
+import type { ILLMClient } from "../llm/llm-client.js";
+import { ContextAssembler } from "./context-assembler.js";
+import type { ContextPurpose } from "./slot-definitions.js";
+export interface PromptGatewayInput<T> {
+    purpose: ContextPurpose;
+    goalId?: string;
+    dimensionName?: string;
+    additionalContext?: Record<string, string>;
+    responseSchema: z.ZodSchema<T>;
+    maxTokens?: number;
+    temperature?: number;
+}
+export interface IPromptGateway {
+    execute<T>(input: PromptGatewayInput<T>): Promise<T>;
+}
+export declare class PromptGateway implements IPromptGateway {
+    private llmClient;
+    private assembler;
+    private options?;
+    constructor(llmClient: ILLMClient, assembler: ContextAssembler, options?: {
+        logger?: (msg: string) => void;
+    } | undefined);
+    execute<T>(input: PromptGatewayInput<T>): Promise<T>;
+}
+//# sourceMappingURL=gateway.d.ts.map

package/dist/prompt/gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../../src/prompt/gateway.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAI5D,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,cAAc,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACtD;AAID,qBAAa,aAAc,YAAW,cAAc;IAEhD,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,OAAO,CAAC;gBAFR,SAAS,EAAE,UAAU,EACrB,SAAS,EAAE,gBAAgB,EAC3B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,YAAA;IAGhD,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CA2C3D"}

package/dist/prompt/gateway.js

@@ -0,0 +1,43 @@
+/**
+ * gateway.ts
+ * Thin orchestrator: assembles context, calls LLM, parses response.
+ */
+import { PURPOSE_CONFIGS } from "./purposes/index.js";
+// ─── PromptGateway ────────────────────────────────────────────────────────────
+export class PromptGateway {
+    llmClient;
+    assembler;
+    options;
+    constructor(llmClient, assembler, options) {
+        this.llmClient = llmClient;
+        this.assembler = assembler;
+        this.options = options;
+    }
+    async execute(input) {
+        const config = PURPOSE_CONFIGS[input.purpose];
+        let assembled;
+        try {
+            assembled = await this.assembler.build(input.purpose, input.goalId, input.dimensionName, input.additionalContext);
+        }
+        catch (err) {
+            throw new Error(`[PromptGateway] context assembly failed (purpose=${input.purpose}, goalId=${input.goalId ?? "none"}): ${err}`);
+        }
+        let response;
+        try {
+            response = await this.llmClient.sendMessage([{ role: "user", content: assembled.contextBlock }], {
+                system: assembled.systemPrompt || config.systemPrompt,
+                max_tokens: input.maxTokens ?? config.defaultMaxTokens,
+                temperature: input.temperature ?? config.defaultTemperature,
+            });
+        }
+        catch (err) {
+            throw new Error(`[PromptGateway] LLM call failed (purpose=${input.purpose}, goalId=${input.goalId ?? "none"}): ${err}`);
+        }
+        const parsed = this.llmClient.parseJSON(response.content, input.responseSchema);
+        if (this.options?.logger) {
+            this.options.logger(`[PromptGateway] ${input.purpose} | tokens: ${response.usage.input_tokens}+${response.usage.output_tokens} | context: ${assembled.totalTokensUsed}`);
+        }
+        return parsed;
+    }
+}
+//# sourceMappingURL=gateway.js.map

package/dist/prompt/gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.js","sourceRoot":"","sources":["../../src/prompt/gateway.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAmBtD,iFAAiF;AAEjF,MAAM,OAAO,aAAa;IAEd;IACA;IACA;IAHV,YACU,SAAqB,EACrB,SAA2B,EAC3B,OAA4C;QAF5C,cAAS,GAAT,SAAS,CAAY;QACrB,cAAS,GAAT,SAAS,CAAkB;QAC3B,YAAO,GAAP,OAAO,CAAqC;IACnD,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAI,KAA4B;QAC3C,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAE9C,IAAI,SAAS,CAAC;QACd,IAAI,CAAC;YACH,SAAS,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CACpC,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,aAAa,EACnB,KAAK,CAAC,iBAAiB,CACxB,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,oDAAoD,KAAK,CAAC,OAAO,YAAY,KAAK,CAAC,MAAM,IAAI,MAAM,MAAM,GAAG,EAAE,CAC/G,CAAC;QACJ,CAAC;QAED,IAAI,QAAQ,CAAC;QACb,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,CACzC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,YAAY,EAAE,CAAC,EACnD;gBACE,MAAM,EAAE,SAAS,CAAC,YAAY,IAAI,MAAM,CAAC,YAAY;gBACrD,UAAU,EAAE,KAAK,CAAC,SAAS,IAAI,MAAM,CAAC,gBAAgB;gBACtD,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,MAAM,CAAC,kBAAkB;aAC5D,CACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,4CAA4C,KAAK,CAAC,OAAO,YAAY,KAAK,CAAC,MAAM,IAAI,MAAM,MAAM,GAAG,EAAE,CACvG,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;QAEhF,IAAI,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;YACzB,IAAI,CAAC,OAAO,CAAC,MAAM,CACjB,mBAAmB,KAAK,CAAC,OAAO,cAAc,QAAQ,CAAC,KAAK,CAAC,YAAY,IAAI,QAAQ,CAAC,KAAK,CAAC,aAAa,eAAe,SAAS,CAAC,eAAe,EAAE,CACpJ,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}