@mcp-abap-adt/llm-agent-server 10.0.0

package/dist/smart-agent/config.js

@@ -0,0 +1,360 @@
+/**
+ * Shared config utilities for SmartServer.
+ */
+import fs from 'node:fs';
+import { parse as parseYaml } from 'yaml';
+export const YAML_TEMPLATE = `port: 4004
+host: 0.0.0.0
+
+# Request routing mode:
+#   hard        — Fully managed context. Ignores client history/system prompt. Uses RAG + internal MCP tools only.
+#   pass        — Transparent proxy. Logs everything but modifies nothing.
+#   smart       — Hybrid. Preserves client history but enriches it with RAG context and MCP tools based on analysis. (default)
+mode: smart
+
+llm:
+  apiKey: \${DEEPSEEK_API_KEY}
+  model: deepseek-chat
+  temperature: 0.7
+  classifierTemperature: 0.1
+
+rag:
+  type: ollama                        # ollama | in-memory | qdrant
+  # embedder: ollama                  # Embedder to use: ollama | openai | sap-ai-core | <custom>
+  url: http://localhost:11434
+  model: nomic-embed-text
+  # collectionName: llm-agent         # Qdrant collection name (qdrant type only)
+  dedupThreshold: 0.92
+  vectorWeight: 0.7                   # Semantic similarity weight (0..1)
+  keywordWeight: 0.3                  # Lexical matching weight (0..1)
+
+mcp:
+  # type: none | http | stdio
+  # To disable MCP, set type to 'none'
+  type: http
+  url: http://localhost:3001/mcp/stream/http
+
+agent:
+  externalToolsValidationMode: permissive  # permissive | strict
+  maxIterations: 10
+  maxToolCalls: 30
+  toolUnavailableTtlMs: 600000       # Temporary tool blacklist TTL (ms)
+  ragQueryK: 10
+  # contextBudgetTokens: 4000          # Max tokens for RAG context in system prompt (0 = no limit)
+  # semanticHistoryEnabled: false      # Enable semantic history via RAG
+  # historyRecencyWindow: 4            # Last N messages from client history in LLM context
+  # historyTurnSummaryPrompt: "..."    # LLM prompt for turn summarization
+  showReasoning: false                # Explain strategy at start of response
+  historyAutoSummarizeLimit: 10       # History length to trigger compression
+  queryExpansionEnabled: false        # Expand RAG queries with LLM-generated synonyms
+  toolResultCacheTtlMs: 300000       # Tool result cache TTL (ms); 0 to disable
+  sessionTokenBudget: 0              # Multi-turn token budget; 0 to disable
+  # ragTranslateEnabled: true        # Translate non-ASCII RAG queries to English (default: true)
+  # classificationEnabled: false     # Enable for custom pipelines with multi-store routing
+  # toolReselectPerIteration: false  # Re-select tools via RAG on each tool-loop iteration
+  # llmCallStrategy: streaming       # streaming | non-streaming | fallback
+  # streamMode: full                 # full | final — streaming behavior for tool loops
+  # heartbeatIntervalMs: 5000       # SSE heartbeat interval during tool execution (ms)
+  # healthTimeoutMs: 5000            # Health check probe timeout (ms); increase for slow providers (SAP AI Core: 15000)
+  # retry:                           # LLM retry config for 429/5xx errors
+  #   maxAttempts: 3
+  #   backoffMs: 1000
+  #   retryOn: [429, 500, 502, 503]
+  #   retryOnMidStream: ['SSE stream']  # Substrings triggering mid-stream retry
+
+# --- Advanced Multi-Model Pipeline (optional) -------------------------------
+# Use this section to assign different models for different internal tasks.
+# pipeline:
+#   llm:
+#     main:
+#       provider: deepseek            # deepseek | openai | anthropic | sap-ai-sdk
+#       apiKey: \${DEEPSEEK_API_KEY}
+#       model: deepseek-chat
+#       temperature: 0.7
+#       streaming: true               # false to disable streaming for this provider
+#     classifier:                     # optional; if absent, main config is reused
+#       provider: deepseek
+#       apiKey: \${DEEPSEEK_API_KEY}
+#       model: deepseek-chat
+#       temperature: 0.1
+#     helper:                         # optional; if absent, main config is reused
+#       provider: deepseek
+#       apiKey: \${DEEPSEEK_API_KEY}
+#       model: deepseek-chat
+#       temperature: 0.1
+#
+#   rag:
+#     tools:
+#       type: qdrant
+#       url: http://qdrant:6333
+#       embedder: openai              # ollama | openai | <custom registered name>
+#       model: text-embedding-3-small
+#       apiKey: \${OPENAI_API_KEY}
+#     history:
+#       type: in-memory
+#
+#   mcp:
+#     - type: http
+#       url: http://localhost:3001/mcp/stream/http
+
+# --- Structured Pipeline (optional) -------------------------------------------
+# Replaces the hardcoded orchestration flow with a YAML-defined stage tree.
+# When absent, the default flow runs unchanged (full backwards compatibility).
+#
+# pipeline:
+#   version: "1"
+#   stages:
+#     - id: classify
+#       type: classify
+#     - id: summarize
+#       type: summarize
+#     - id: rag-retrieval
+#       type: parallel
+#       when: "shouldRetrieve"
+#       stages:
+#         - { id: translate, type: translate }
+#         - { id: expand, type: expand }
+#       after:
+#         - id: rag-queries
+#           type: parallel
+#           stages:
+#             - { id: tools, type: rag-query, config: { store: tools, k: 10 } }
+#             - { id: history, type: rag-query, config: { store: history, k: 5 } }
+#         - { id: rerank, type: rerank }
+#         - { id: tool-select, type: tool-select }
+#     - id: assemble
+#       type: assemble
+#     - id: tool-loop
+#       type: tool-loop
+
+# prompts:
+#   system: "You are a helpful assistant specialized in SAP ABAP development."
+#   classifier: |
+#     You are an intent classifier... (see source for full default prompt)
+#   reasoning: |
+#     IMPORTANT: Always start your response with a brief <reasoning> block...
+#   ragTranslate: |
+#     Translate the user request to English for search purposes...
+#   historySummary: |
+#     Summarize the conversation so far...
+
+log: smart-server.log                 # path to log file; omit for stdout
+# logDir: sessions                    # Directory for detailed session debug logs
+# pluginDir: ./my-plugins             # Additional plugin directory (loaded after defaults)
+`;
+export function resolveEnvVars(value, env = process.env) {
+    if (typeof value === 'string')
+        return value.replace(/\$\{([^}:]+)(?::-(.*?))?\}/g, (_, name, fallback) => env[name] || fallback || '');
+    if (Array.isArray(value))
+        return value.map((v) => resolveEnvVars(v, env));
+    if (value !== null && typeof value === 'object')
+        return Object.fromEntries(Object.entries(value).map(([k, v]) => [
+            k,
+            resolveEnvVars(v, env),
+        ]));
+    return value;
+}
+export function loadYamlConfig(filePath, env = process.env) {
+    const raw = fs.readFileSync(filePath, 'utf8');
+    return resolveEnvVars(parseYaml(raw), env);
+}
+export function generateConfigTemplate(outputPath) {
+    fs.writeFileSync(outputPath, YAML_TEMPLATE, 'utf8');
+}
+const get = (obj, ...keys) => keys.reduce((o, k) => {
+    if (o !== null && typeof o === 'object' && k in o) {
+        return o[k];
+    }
+    return undefined;
+}, obj);
+export function resolveSmartServerConfig(args = {}, yaml = {}, env = process.env) {
+    const flatApiKey = args['llm-api-key'] ??
+        get(yaml, 'llm', 'apiKey') ??
+        env.DEEPSEEK_API_KEY ??
+        '';
+    const pipelineApiKey = get(yaml, 'pipeline', 'llm', 'main', 'apiKey');
+    const apiKey = flatApiKey || pipelineApiKey || '';
+    if (!apiKey && !get(yaml, 'pipeline', 'llm', 'main'))
+        throw new Error('LLM API key is required');
+    const mcpUrl = args['mcp-url'] ?? get(yaml, 'mcp', 'url') ?? env.MCP_ENDPOINT;
+    const mcpCommand = args['mcp-command'] ??
+        get(yaml, 'mcp', 'command') ??
+        env.MCP_COMMAND;
+    const mcpTypeRaw = args['mcp-type'] ??
+        get(yaml, 'mcp', 'type') ??
+        (mcpUrl ? 'http' : mcpCommand ? 'stdio' : null);
+    const mcpType = (mcpTypeRaw === 'none' ? null : mcpTypeRaw);
+    const promptSystem = args['prompt-system'] ??
+        get(yaml, 'prompts', 'system') ??
+        env.PROMPT_SYSTEM ??
+        null;
+    const promptClassifier = args['prompt-classifier'] ??
+        get(yaml, 'prompts', 'classifier') ??
+        env.PROMPT_CLASSIFIER ??
+        null;
+    const promptReasoning = get(yaml, 'prompts', 'reasoning') ?? null;
+    const promptRagTranslate = get(yaml, 'prompts', 'ragTranslate') ?? null;
+    const promptHistorySummary = get(yaml, 'prompts', 'historySummary') ?? null;
+    return {
+        port: Number(args.port ?? get(yaml, 'port') ?? env.PORT ?? 4004),
+        host: args.host ?? get(yaml, 'host') ?? '0.0.0.0',
+        llm: {
+            apiKey,
+            model: args['llm-model'] ??
+                get(yaml, 'llm', 'model') ??
+                env.DEEPSEEK_MODEL ??
+                'deepseek-chat',
+            temperature: Number(args['llm-temperature'] ??
+                get(yaml, 'llm', 'temperature') ??
+                0.7),
+            classifierTemperature: Number(get(yaml, 'llm', 'classifierTemperature') ?? 0.1),
+        },
+        rag: {
+            type: (args['rag-type'] ??
+                get(yaml, 'rag', 'type') ??
+                'ollama'),
+            embedder: get(yaml, 'rag', 'embedder') ?? undefined,
+            url: args['rag-url'] ??
+                get(yaml, 'rag', 'url') ??
+                env.OLLAMA_URL ??
+                'http://localhost:11434',
+            model: args['rag-model'] ??
+                get(yaml, 'rag', 'model') ??
+                env.OLLAMA_EMBED_MODEL ??
+                'nomic-embed-text',
+            collectionName: args['rag-collection-name'] ??
+                get(yaml, 'rag', 'collectionName') ??
+                undefined,
+            dedupThreshold: Number(get(yaml, 'rag', 'dedupThreshold') ?? 0.92),
+            vectorWeight: Number(args['rag-vector-weight'] ?? get(yaml, 'rag', 'vectorWeight') ?? 0.7),
+            keywordWeight: Number(args['rag-keyword-weight'] ?? get(yaml, 'rag', 'keywordWeight') ?? 0.3),
+        },
+        mcp: mcpType
+            ? {
+                type: mcpType,
+                url: mcpUrl || undefined,
+                command: mcpCommand || undefined,
+                args: args['mcp-args'] || get(yaml, 'mcp', 'args')
+                    ? String(args['mcp-args'] || get(yaml, 'mcp', 'args')).split(' ')
+                    : undefined,
+                headers: get(yaml, 'mcp', 'headers') ||
+                    undefined,
+            }
+            : undefined,
+        agent: {
+            externalToolsValidationMode: (get(yaml, 'agent', 'externalToolsValidationMode') ?? 'permissive'),
+            maxIterations: Number(get(yaml, 'agent', 'maxIterations') ?? 10),
+            maxToolCalls: Number(get(yaml, 'agent', 'maxToolCalls') ?? 30),
+            toolUnavailableTtlMs: Number(get(yaml, 'agent', 'toolUnavailableTtlMs') ?? 600000),
+            ragQueryK: Number(get(yaml, 'agent', 'ragQueryK') ?? 10),
+            ...(get(yaml, 'agent', 'contextBudgetTokens') !== undefined
+                ? {
+                    contextBudgetTokens: Number(get(yaml, 'agent', 'contextBudgetTokens')),
+                }
+                : {}),
+            ...(get(yaml, 'agent', 'semanticHistoryEnabled') !== undefined
+                ? {
+                    semanticHistoryEnabled: Boolean(get(yaml, 'agent', 'semanticHistoryEnabled')),
+                }
+                : {}),
+            ...(get(yaml, 'agent', 'historyRecencyWindow') !== undefined
+                ? {
+                    historyRecencyWindow: Number(get(yaml, 'agent', 'historyRecencyWindow')),
+                }
+                : {}),
+            ...(get(yaml, 'agent', 'historyTurnSummaryPrompt') !== undefined
+                ? {
+                    historyTurnSummaryPrompt: String(get(yaml, 'agent', 'historyTurnSummaryPrompt')),
+                }
+                : {}),
+            showReasoning: Boolean(args['agent-show-reasoning'] ??
+                get(yaml, 'agent', 'showReasoning') ??
+                false),
+            historyAutoSummarizeLimit: Number(get(yaml, 'agent', 'historyAutoSummarizeLimit') ?? 10),
+            queryExpansionEnabled: Boolean(get(yaml, 'agent', 'queryExpansionEnabled') ?? false),
+            toolResultCacheTtlMs: Number(get(yaml, 'agent', 'toolResultCacheTtlMs') ?? 300000),
+            sessionTokenBudget: Number(get(yaml, 'agent', 'sessionTokenBudget') ?? 0),
+            ...(get(yaml, 'agent', 'classificationEnabled') !== undefined
+                ? {
+                    classificationEnabled: Boolean(get(yaml, 'agent', 'classificationEnabled')),
+                }
+                : {}),
+            ...(get(yaml, 'agent', 'toolReselectPerIteration') !== undefined
+                ? {
+                    toolReselectPerIteration: Boolean(get(yaml, 'agent', 'toolReselectPerIteration')),
+                }
+                : {}),
+            ...(get(yaml, 'agent', 'ragTranslateEnabled') !== undefined
+                ? {
+                    ragTranslateEnabled: Boolean(get(yaml, 'agent', 'ragTranslateEnabled')),
+                }
+                : {}),
+            ...(get(yaml, 'agent', 'refreshToolsPerIteration') !== undefined
+                ? {
+                    refreshToolsPerIteration: Boolean(get(yaml, 'agent', 'refreshToolsPerIteration')),
+                }
+                : {}),
+            ...(get(yaml, 'agent', 'streamMode') !== undefined
+                ? {
+                    streamMode: String(get(yaml, 'agent', 'streamMode')),
+                }
+                : {}),
+            ...(get(yaml, 'agent', 'llmCallStrategy') !== undefined
+                ? {
+                    llmCallStrategy: String(get(yaml, 'agent', 'llmCallStrategy')),
+                }
+                : {}),
+            ...(get(yaml, 'agent', 'heartbeatIntervalMs') !== undefined
+                ? {
+                    heartbeatIntervalMs: Number(get(yaml, 'agent', 'heartbeatIntervalMs')),
+                }
+                : {}),
+            ...(get(yaml, 'agent', 'healthTimeoutMs') !== undefined
+                ? {
+                    healthTimeoutMs: Number(get(yaml, 'agent', 'healthTimeoutMs')),
+                }
+                : {}),
+            ...(get(yaml, 'agent', 'retry') !== undefined
+                ? {
+                    retry: get(yaml, 'agent', 'retry'),
+                }
+                : {}),
+        },
+        prompts: promptSystem ||
+            promptClassifier ||
+            promptReasoning ||
+            promptRagTranslate ||
+            promptHistorySummary
+            ? {
+                ...(promptSystem ? { system: promptSystem } : {}),
+                ...(promptClassifier ? { classifier: promptClassifier } : {}),
+                ...(typeof promptReasoning === 'string'
+                    ? { reasoning: promptReasoning }
+                    : {}),
+                ...(typeof promptRagTranslate === 'string'
+                    ? { ragTranslate: promptRagTranslate }
+                    : {}),
+                ...(typeof promptHistorySummary === 'string'
+                    ? { historySummary: promptHistorySummary }
+                    : {}),
+            }
+            : undefined,
+        mode: (args.mode ??
+            get(yaml, 'mode') ??
+            env.SMART_AGENT_MODE ??
+            'hybrid'),
+        logDir: args['log-dir'] ?? get(yaml, 'logDir') ?? null,
+        pluginDir: args['plugin-dir'] ?? get(yaml, 'pluginDir') ?? undefined,
+        ...(yaml.pipeline ? { pipeline: yaml.pipeline } : {}),
+        ...(yaml.skills
+            ? {
+                skills: {
+                    type: (get(yaml, 'skills', 'type') ?? 'claude'),
+                    dirs: get(yaml, 'skills', 'dirs'),
+                    projectRoot: get(yaml, 'skills', 'projectRoot'),
+                },
+            }
+            : {}),
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/smart-agent/config.js.map

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

package/dist/smart-agent/context/context-assembler.d.ts

@@ -0,0 +1,49 @@
+import type { HistoryEntry, IContextAssembler, Message } from '@mcp-abap-adt/llm-agent';
+import { AssemblerError, type CallOptions, type McpTool, type RagResult, type Result, type Subprompt } from '@mcp-abap-adt/llm-agent';
+export interface ContextAssemblerConfig {
+    /** chars/4 token budget. No limit when undefined. */
+    maxTokens?: number;
+    /** Preamble prepended before context sections in system message. */
+    systemPromptPreamble?: string;
+    /** Emit RAG scores as annotations for observability. Default: false. */
+    includeProvenance?: boolean;
+    /**
+     * When true, instructions are added to the system prompt asking the LLM
+     * to explain its reasoning.
+     */
+    showReasoning?: boolean;
+    /**
+     * Optional custom reasoning instruction.
+     */
+    reasoningInstruction?: string;
+    /**
+     * Display name mapping for RAG store keys → section headers.
+     * Default: `{ facts: 'Known Facts', feedback: 'Feedback', state: 'Current State' }`.
+     * Unknown keys are title-cased automatically.
+     */
+    sectionHeaders?: Record<string, string>;
+    /**
+     * Maximum number of recent messages to include from client history.
+     * Only the last N non-system messages are passed to the LLM.
+     * Older messages are excluded — they are available via RAG if needed.
+     * When undefined, all messages are included (backward compatible).
+     */
+    historyRecencyWindow?: number;
+}
+export declare const DEFAULT_REASONING_INSTRUCTION = "IMPORTANT: Always start your response with a brief <reasoning> block.\nExplain:\n1. Which tools you selected and why.\n2. How you interpreted the retrieved context.\n3. Your step-by-step strategy for the current turn.\nThe reasoning block must be visible to the user and placed at the very beginning.";
+export declare class ContextAssembler implements IContextAssembler {
+    private readonly maxTokens;
+    private readonly systemPromptPreamble;
+    private readonly includeProvenance;
+    private readonly showReasoning;
+    private readonly reasoningInstruction;
+    private readonly sectionHeaders;
+    private readonly historyRecencyWindow;
+    constructor(config?: ContextAssemblerConfig);
+    assemble(action: Subprompt, retrieved: {
+        ragResults: Record<string, RagResult[]>;
+        tools: McpTool[];
+        recentActions?: string[];
+    }, history: HistoryEntry[], options?: CallOptions): Promise<Result<Message[], AssemblerError>>;
+}
+//# sourceMappingURL=context-assembler.d.ts.map

package/dist/smart-agent/context/context-assembler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-assembler.d.ts","sourceRoot":"","sources":["../../../src/smart-agent/context/context-assembler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,OAAO,EACR,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,MAAM,EACX,KAAK,SAAS,EAEf,MAAM,yBAAyB,CAAC;AAMjC,MAAM,WAAW,sBAAsB;IACrC,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,wEAAwE;IACxE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,eAAO,MAAM,6BAA6B,iTAKwC,CAAC;AAiInF,qBAAa,gBAAiB,YAAW,iBAAiB;IACxD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAqB;IAC1D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAU;IAC5C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IACxC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAqB;IAC1D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyB;IACxD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAqB;gBAE9C,MAAM,CAAC,EAAE,sBAAsB;IAarC,QAAQ,CACZ,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE;QACT,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QACxC,KAAK,EAAE,OAAO,EAAE,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;KAC1B,EACD,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,cAAc,CAAC,CAAC;CAuF9C"}

package/dist/smart-agent/context/context-assembler.js

@@ -0,0 +1,184 @@
+import { AssemblerError, } from '@mcp-abap-adt/llm-agent';
+export const DEFAULT_REASONING_INSTRUCTION = `IMPORTANT: Always start your response with a brief <reasoning> block.
+Explain:
+1. Which tools you selected and why.
+2. How you interpreted the retrieved context.
+3. Your step-by-step strategy for the current turn.
+The reasoning block must be visible to the user and placed at the very beginning.`;
+const DEFAULT_SECTION_HEADERS = {
+    facts: 'Known Facts',
+    feedback: 'Feedback',
+    state: 'Current State',
+    history: 'Relevant History',
+};
+// ---------------------------------------------------------------------------
+// Module-private helpers
+// ---------------------------------------------------------------------------
+/** Type guard: ToolCallRecord has `call` and `result`, Message has `role`. */
+function isToolCallRecord(item) {
+    return (typeof item === 'object' &&
+        item !== null &&
+        'call' in item &&
+        'result' in item);
+}
+/** Approximate token count: ceil(text.length / 4) */
+function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+/** Single RagResult → "- <text> [score: 0.92]" (provenance) or "- <text>" */
+function formatRagEntry(r, provenance) {
+    if (provenance) {
+        return `- ${r.text} [score: ${r.score.toFixed(2)}]`;
+    }
+    return `- ${r.text}`;
+}
+/** Header + entries → "## Header\n- e1\n- e2" or '' if entries empty */
+function buildSection(header, entries) {
+    if (entries.length === 0)
+        return '';
+    return `## ${header}\n${entries.join('\n')}`;
+}
+/** Derive a display header from a store key (e.g. 'my_store' → 'My Store') */
+function titleCase(key) {
+    return key.replace(/[_-]/g, ' ').replace(/\b\w/g, (c) => c.toUpperCase());
+}
+/** Combine all sections into system message content */
+function buildSystemContent(ragResults, provenance, sectionHeaders, recentActions) {
+    const sections = [];
+    for (const [key, results] of Object.entries(ragResults)) {
+        const header = sectionHeaders[key] ?? titleCase(key);
+        const section = buildSection(header, results.map((r) => formatRagEntry(r, provenance)));
+        if (section)
+            sections.push(section);
+    }
+    if (recentActions && recentActions.length > 0) {
+        const section = buildSection('Recent Actions', recentActions.map((a) => `- ${a}`));
+        if (section)
+            sections.push(section);
+    }
+    return sections.join('\n\n');
+}
+// ---------------------------------------------------------------------------
+// Token budgeting
+// ---------------------------------------------------------------------------
+/**
+ * Drop entries until total token count fits within budget.
+ * Trims stores in reverse insertion order, then tools last.
+ */
+function applyTokenBudget(ragResults, actionTokens, maxTokens, provenance, sectionHeaders, recentActions) {
+    const mutableResults = {};
+    for (const [key, arr] of Object.entries(ragResults)) {
+        mutableResults[key] = [...arr];
+    }
+    const storeKeys = Object.keys(mutableResults);
+    const totalTokens = () => {
+        const content = buildSystemContent(mutableResults, provenance, sectionHeaders, recentActions);
+        return actionTokens + estimateTokens(content);
+    };
+    while (totalTokens() > maxTokens) {
+        let trimmed = false;
+        for (let i = storeKeys.length - 1; i >= 0; i--) {
+            const key = storeKeys[i];
+            if (mutableResults[key].length > 0) {
+                mutableResults[key] = mutableResults[key].slice(0, -1);
+                trimmed = true;
+                break;
+            }
+        }
+        if (!trimmed)
+            break;
+    }
+    return mutableResults;
+}
+// ---------------------------------------------------------------------------
+// ContextAssembler
+// ---------------------------------------------------------------------------
+export class ContextAssembler {
+    maxTokens;
+    systemPromptPreamble;
+    includeProvenance;
+    showReasoning;
+    reasoningInstruction;
+    sectionHeaders;
+    historyRecencyWindow;
+    constructor(config) {
+        this.maxTokens = config?.maxTokens;
+        this.systemPromptPreamble = config?.systemPromptPreamble;
+        this.includeProvenance = config?.includeProvenance ?? false;
+        this.showReasoning = config?.showReasoning ?? false;
+        this.reasoningInstruction = config?.reasoningInstruction;
+        this.sectionHeaders = {
+            ...DEFAULT_SECTION_HEADERS,
+            ...config?.sectionHeaders,
+        };
+        this.historyRecencyWindow = config?.historyRecencyWindow;
+    }
+    async assemble(action, retrieved, history, options) {
+        try {
+            if (options?.signal?.aborted) {
+                return { ok: false, error: new AssemblerError('Aborted', 'ABORTED') };
+            }
+            // Sort all RAG results by score descending
+            const sortedResults = {};
+            for (const [key, results] of Object.entries(retrieved.ragResults)) {
+                sortedResults[key] = [...results].sort((a, b) => b.score - a.score);
+            }
+            let finalResults = sortedResults;
+            if (this.maxTokens !== undefined) {
+                finalResults = applyTokenBudget(sortedResults, estimateTokens(action.text), this.maxTokens, this.includeProvenance, this.sectionHeaders, retrieved.recentActions);
+            }
+            const systemContent = buildSystemContent(finalResults, this.includeProvenance, this.sectionHeaders, retrieved.recentActions);
+            const messages = [];
+            const preamble = this.systemPromptPreamble ?? '';
+            const toolGuidance = 'Use available tools when they can accomplish the task. When an action is impossible with available tools — say so clearly and do not attempt it.';
+            if (preamble || systemContent || this.showReasoning) {
+                const parts = [
+                    preamble,
+                    toolGuidance,
+                    this.showReasoning
+                        ? this.reasoningInstruction || DEFAULT_REASONING_INSTRUCTION
+                        : '',
+                    systemContent,
+                ].filter(Boolean);
+                messages.push({ role: 'system', content: parts.join('\n\n') });
+            }
+            // Separate regular messages from tool call records
+            const regularMessages = [];
+            const toolMessages = [];
+            for (const item of history) {
+                if (isToolCallRecord(item)) {
+                    const raw = item.result.content;
+                    const text = typeof raw === 'string' ? raw : JSON.stringify(raw);
+                    toolMessages.push({
+                        role: 'tool',
+                        content: `${item.call.name}: ${text}`,
+                    });
+                }
+                else if (item.role !== 'system') {
+                    regularMessages.push(item);
+                }
+            }
+            // Apply recency window — keep only the last N messages from client history.
+            // Older messages are excluded; they are available via RAG stores if needed.
+            const windowedMessages = this.historyRecencyWindow !== undefined &&
+                regularMessages.length > this.historyRecencyWindow
+                ? regularMessages.slice(-this.historyRecencyWindow)
+                : regularMessages;
+            if (windowedMessages.length > 0) {
+                messages.push(...windowedMessages);
+            }
+            else {
+                messages.push({ role: 'user', content: action.text });
+            }
+            messages.push(...toolMessages);
+            return { ok: true, value: messages };
+        }
+        catch (err) {
+            return {
+                ok: false,
+                error: new AssemblerError(String(err), 'ASSEMBLER_ERROR'),
+            };
+        }
+    }
+}
+//# sourceMappingURL=context-assembler.js.map

package/dist/smart-agent/context/context-assembler.js.map

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

package/dist/smart-agent/context/index.d.ts

@@ -0,0 +1,3 @@
+export type { ContextAssemblerConfig } from './context-assembler.js';
+export { ContextAssembler } from './context-assembler.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/smart-agent/context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/smart-agent/context/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/smart-agent/context/index.js

@@ -0,0 +1,2 @@
+export { ContextAssembler } from './context-assembler.js';
+//# sourceMappingURL=index.js.map

package/dist/smart-agent/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/smart-agent/context/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC"}