@dot-ai/core 0.5.2 → 0.7.0

package/dist/runtime.js

@@ -0,0 +1,441 @@
+import { loadConfig } from './config.js';
+import { computeChecksum, loadBootCache, writeBootCache } from './boot-cache.js';
+import { toolDefinitionToCapability } from './capabilities.js';
+import { discoverExtensions, createV6CollectorAPI } from './extension-loader.js';
+import { ExtensionRunner, EventBus } from './extension-runner.js';
+import { NoopLogger } from './logger.js';
+import { extractLabels } from './labels.js';
+/**
+ * DotAiRuntime — encapsulates the full extension-based pipeline lifecycle.
+ * Boot once, process many prompts.
+ */
+export class DotAiRuntime {
+    caps = [];
+    booted = false;
+    options;
+    logger;
+    _runner = null;
+    _eventBus = null;
+    vocabulary = [];
+    constructor(options) {
+        this.options = options;
+        this.logger = options.logger ?? new NoopLogger();
+    }
+    // ── Context Builder ──
+    buildCtx(labels = []) {
+        return {
+            workspaceRoot: this.options.workspaceRoot,
+            events: this._eventBus ?? { on: () => { }, off: () => { }, emit: () => { } },
+            labels,
+        };
+    }
+    // ══════════════════════════════════════════════════════════════════════════════
+    // Boot
+    // ══════════════════════════════════════════════════════════════════════════════
+    /**
+     * Boot the runtime — loads config, discovers extensions, fires lifecycle events.
+     * Call once per session. Safe to call multiple times (idempotent).
+     */
+    async boot() {
+        if (this.booted)
+            return;
+        const start = performance.now();
+        const rawConfig = await loadConfig(this.options.workspaceRoot);
+        // Create event bus
+        this._eventBus = new EventBus();
+        // Discover extensions
+        const extConfig = this.options.extensions ?? rawConfig.extensions;
+        const extPaths = await discoverExtensions(this.options.workspaceRoot, extConfig);
+        // Compute checksum for cache invalidation
+        const checksum = await computeChecksum(this.options.workspaceRoot, extPaths);
+        // Try loading from cache
+        const cached = await loadBootCache(this.options.workspaceRoot, checksum);
+        // Load extensions via v6 collector API (always needed for handlers)
+        const loaded = await this.loadExtensions(extPaths);
+        this._runner = new ExtensionRunner(loaded, this.logger);
+        if (cached) {
+            // Cache hit — use cached vocabulary, skip resources_discover
+            this.vocabulary = cached.vocabulary;
+            this.logger.log({
+                timestamp: new Date().toISOString(),
+                level: 'info',
+                phase: 'boot',
+                event: 'boot_cache_hit',
+                data: { checksum, vocabularySize: cached.vocabulary.length },
+            });
+        }
+        else {
+            // Cache miss — fire resources_discover → build vocabulary
+            const ctx = this.buildCtx();
+            const discoverResults = await this._runner.fire('resources_discover', undefined, ctx);
+            // Build vocabulary from all extension-contributed labels
+            const allLabels = new Set();
+            for (const result of discoverResults) {
+                if (result.labels && Array.isArray(result.labels)) {
+                    for (const label of result.labels) {
+                        allLabels.add(label);
+                    }
+                }
+            }
+            this.vocabulary = Array.from(allLabels);
+            // Write cache
+            await writeBootCache(this.options.workspaceRoot, {
+                version: 1,
+                checksum,
+                vocabulary: this.vocabulary,
+                extensionPaths: extPaths,
+                tools: this._runner.tools.map(t => ({ name: t.name, description: t.description ?? '' })),
+                createdAt: new Date().toISOString(),
+            });
+        }
+        // Build capabilities from extension-registered tools
+        this.caps = this._runner.tools.map(toolDefinitionToCapability);
+        this.logger.log({
+            timestamp: new Date().toISOString(),
+            level: 'info',
+            phase: 'boot',
+            event: 'boot_complete',
+            data: {
+                extensionCount: loaded.length,
+                vocabularySize: this.vocabulary.length,
+                toolCount: this._runner.tools.length,
+                commandCount: this._runner.commands.length,
+                cacheHit: !!cached,
+            },
+            durationMs: Math.round(performance.now() - start),
+        });
+        // Fire session_start (always, regardless of cache)
+        const ctx = this.buildCtx();
+        await this._runner.fire('session_start', undefined, ctx);
+        this.booted = true;
+    }
+    /**
+     * Load extensions using jiti for TypeScript support, falls back to dynamic import.
+     */
+    async loadExtensions(extensionPaths) {
+        if (extensionPaths.length === 0)
+            return [];
+        let jitiImport;
+        try {
+            const { createJiti } = await import('jiti');
+            jitiImport = createJiti(import.meta.url, { interopDefault: true });
+        }
+        catch {
+            this.logger.log({
+                timestamp: new Date().toISOString(),
+                level: 'warn',
+                phase: 'boot',
+                event: 'jiti_not_available',
+                data: { message: 'jiti not installed, falling back to dynamic import' },
+            });
+        }
+        const loaded = [];
+        for (const extPath of extensionPaths) {
+            try {
+                let mod;
+                if (jitiImport) {
+                    mod = jitiImport(extPath);
+                }
+                else {
+                    mod = await import(extPath);
+                }
+                const factory = (typeof mod.default === 'function' ? mod.default : mod);
+                if (typeof factory !== 'function') {
+                    this.logger.log({
+                        timestamp: new Date().toISOString(),
+                        level: 'warn',
+                        phase: 'boot',
+                        event: 'extension_no_factory',
+                        data: { path: extPath },
+                    });
+                    continue;
+                }
+                // TODO: resolve per-extension config from settings.json `with:` block
+                const extConfig = {};
+                const { api, extension } = createV6CollectorAPI(extPath, extConfig, this._eventBus, this.options.workspaceRoot);
+                await factory(api);
+                loaded.push(extension);
+                this.logger.log({
+                    timestamp: new Date().toISOString(),
+                    level: 'info',
+                    phase: 'boot',
+                    event: 'extension_loaded',
+                    data: {
+                        path: extPath,
+                        handlers: Object.fromEntries(Array.from(extension.handlers.entries()).map(([k, v]) => [k, v.length])),
+                        tools: Array.from(extension.tools.keys()),
+                        commands: Array.from(extension.commands.keys()),
+                    },
+                });
+            }
+            catch (err) {
+                this.logger.log({
+                    timestamp: new Date().toISOString(),
+                    level: 'warn',
+                    phase: 'boot',
+                    event: 'extension_load_error',
+                    data: {
+                        path: extPath,
+                        error: err instanceof Error ? err.message : String(err),
+                    },
+                });
+            }
+        }
+        return loaded;
+    }
+    // ══════════════════════════════════════════════════════════════════════════════
+    // Process Prompt
+    // ══════════════════════════════════════════════════════════════════════════════
+    /**
+     * Process a prompt through the pipeline:
+     * 1. Extract labels (core regex + label_extract chain-transform)
+     * 2. Route (first-result)
+     * 3. Context enrich (collect-sections)
+     * 4. Assemble sections by priority
+     * 5. Apply token budget trimming
+     */
+    async processPrompt(prompt, formatOverrides) {
+        if (!this.booted) {
+            await this.boot();
+        }
+        const start = performance.now();
+        // 1. Extract labels from prompt using vocabulary
+        let labels = extractLabels(prompt, this.vocabulary);
+        // Chain-transform via label_extract event
+        if (this._runner) {
+            const ctx = this.buildCtx(labels);
+            const enrichedLabels = await this._runner.fireChainTransform('label_extract', labels, ctx);
+            if (enrichedLabels && Array.isArray(enrichedLabels)) {
+                labels = enrichedLabels;
+            }
+        }
+        this.logger.log({
+            timestamp: new Date().toISOString(),
+            level: 'info',
+            phase: 'enrich',
+            event: 'labels_extracted',
+            data: { labels: labels.map(l => l.name), vocabularySize: this.vocabulary.length },
+            durationMs: Math.round(performance.now() - start),
+        });
+        // 2. Route (first-result)
+        let routing = null;
+        if (this._runner) {
+            const routeEvent = { labels };
+            const ctx = this.buildCtx(labels);
+            routing = await this._runner.fireFirstResult('route', routeEvent, ctx);
+        }
+        // 3. Context enrich (collect-sections)
+        let sections = [];
+        if (this._runner) {
+            const enrichEvent = { prompt, labels };
+            const ctx = this.buildCtx(labels);
+            const collected = await this._runner.fireCollectSections('context_enrich', enrichEvent, ctx);
+            sections = collected.sections;
+            // Also fire legacy context_inject for backward compat
+            const injectEvent = { prompt, labels };
+            const injectResults = await this._runner.fire('context_inject', injectEvent, ctx);
+            for (const result of injectResults) {
+                if (result.inject) {
+                    sections.push({
+                        id: `legacy-inject-${sections.length}`,
+                        title: 'Extension Context',
+                        content: result.inject,
+                        priority: 20,
+                        source: 'legacy',
+                    });
+                }
+            }
+        }
+        // 4. Sort sections by priority DESC
+        sections.sort((a, b) => b.priority - a.priority);
+        // 5. Apply token budget trimming
+        const tokenBudget = formatOverrides?.tokenBudget ?? this.options.tokenBudget;
+        if (tokenBudget) {
+            sections = this.trimSections(sections, tokenBudget);
+        }
+        // 6. Assemble sections into formatted markdown
+        const formatted = this.assembleSections(sections);
+        this.logger.log({
+            timestamp: new Date().toISOString(),
+            level: 'info',
+            phase: 'format',
+            event: 'format_complete',
+            data: {
+                sectionCount: sections.length,
+                outputChars: formatted.length,
+                estimatedTokens: Math.round(formatted.length / 4),
+                routing: routing?.model ?? 'default',
+                labels: labels.map(l => l.name),
+            },
+            durationMs: Math.round(performance.now() - start),
+        });
+        // Build enriched context for adapters that need it
+        const enriched = this.buildEnrichedFromSections(prompt, labels, sections, routing);
+        return {
+            formatted,
+            enriched,
+            capabilities: this.caps,
+            routing,
+            labels,
+            sections,
+        };
+    }
+    // ══════════════════════════════════════════════════════════════════════════════
+    // Learn
+    // ══════════════════════════════════════════════════════════════════════════════
+    /**
+     * Learn from agent response — fires agent_end event.
+     * Memory extensions handle storage in their handlers.
+     */
+    async learn(response) {
+        if (this._runner) {
+            await this._runner.fire('agent_end', { response }, this.buildCtx());
+        }
+    }
+    // ══════════════════════════════════════════════════════════════════════════════
+    // Event Firing
+    // ══════════════════════════════════════════════════════════════════════════════
+    /**
+     * Fire an event (for adapters to call on agent-native events).
+     */
+    async fire(event, data) {
+        if (!this._runner)
+            return [];
+        return this._runner.fire(event, data, this.buildCtx());
+    }
+    /**
+     * Fire a tool_call event and return block result if any.
+     */
+    async fireToolCall(event) {
+        if (!this._runner)
+            return null;
+        return this._runner.fireUntilBlocked('tool_call', event, this.buildCtx());
+    }
+    /**
+     * Shutdown: fire session_end, flush logger.
+     */
+    async shutdown() {
+        if (this._runner) {
+            await this._runner.fire('session_end', undefined, this.buildCtx());
+        }
+        await this.logger.flush();
+    }
+    // ══════════════════════════════════════════════════════════════════════════════
+    // Accessors
+    // ══════════════════════════════════════════════════════════════════════════════
+    /** Get the interactive capabilities (for registering as tools) */
+    get capabilities() {
+        return this.caps;
+    }
+    /** Check if runtime has been booted */
+    get isBooted() {
+        return this.booted;
+    }
+    /** Flush logger buffers — call before process exit in CLI hooks */
+    async flush() {
+        await this.logger.flush();
+    }
+    /** Get the extension runner */
+    get runner() {
+        return this._runner;
+    }
+    /** Get registered commands from extensions */
+    get commands() {
+        return this._runner?.commands ?? [];
+    }
+    /** Get diagnostics including extensions */
+    get diagnostics() {
+        return {
+            extensions: this._runner?.diagnostics ?? [],
+            usedTiers: this._runner ? Array.from(this._runner.usedTiers) : [],
+            capabilityCount: this.caps.length,
+            vocabularySize: this.vocabulary.length,
+        };
+    }
+    // ══════════════════════════════════════════════════════════════════════════════
+    // Helpers
+    // ══════════════════════════════════════════════════════════════════════════════
+    /**
+     * Assemble sorted sections into a single markdown string.
+     */
+    assembleSections(sections) {
+        if (sections.length === 0)
+            return '';
+        return sections
+            .map(s => {
+            if (s.title) {
+                return `## ${s.title}\n\n${s.content}`;
+            }
+            return s.content;
+        })
+            .join('\n\n---\n\n');
+    }
+    /**
+     * Trim sections to fit within a token budget.
+     * Respects trimStrategy: 'never' sections are never removed.
+     */
+    trimSections(sections, budget) {
+        const estimateTokens = (secs) => Math.round(secs.map(s => `## ${s.title}\n\n${s.content}`).join('\n\n---\n\n').length / 4);
+        let current = estimateTokens(sections);
+        if (current <= budget)
+            return sections;
+        const result = [...sections];
+        const actions = [];
+        // Strategy 1: Truncate 'truncate' sections
+        for (let i = result.length - 1; i >= 0; i--) {
+            if (current <= budget)
+                break;
+            const s = result[i];
+            if (s.trimStrategy === 'truncate' && s.content.length > 2000) {
+                result[i] = { ...s, content: s.content.slice(0, 2000) + '\n\n[...truncated]' };
+                actions.push(`truncated section: ${s.id}`);
+                current = estimateTokens(result);
+            }
+        }
+        // Strategy 2: Drop non-'never' sections (lowest priority first)
+        for (let i = result.length - 1; i >= 0; i--) {
+            if (current <= budget)
+                break;
+            const s = result[i];
+            if (s.trimStrategy !== 'never') {
+                actions.push(`dropped section: ${s.id} (priority ${s.priority})`);
+                result.splice(i, 1);
+                current = estimateTokens(result);
+            }
+        }
+        if (actions.length > 0) {
+            const warning = { budget, actual: current, actions };
+            this.logger.log({
+                timestamp: new Date().toISOString(),
+                level: current > budget ? 'warn' : 'info',
+                phase: 'format',
+                event: 'budget_trimmed',
+                data: warning,
+            });
+        }
+        return result;
+    }
+    /**
+     * Build a backward-compatible EnrichedContext from pipeline output.
+     * Adapters that log enriched fields still work.
+     */
+    buildEnrichedFromSections(prompt, labels, sections, routing) {
+        return {
+            prompt,
+            labels,
+            identities: sections
+                .filter(s => s.source === 'identity' || s.priority >= 80)
+                .map(s => ({
+                type: s.id ?? s.source,
+                content: s.content,
+                source: s.source,
+                priority: s.priority,
+            })),
+            memories: [],
+            skills: [],
+            tools: [],
+            routing: routing ?? { model: 'default', reason: 'no routing extensions' },
+        };
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjF,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAE/D,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAWlE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAyC5C;;;GAGG;AACH,MAAM,OAAO,YAAY;IACf,IAAI,GAAiB,EAAE,CAAC;IACxB,MAAM,GAAG,KAAK,CAAC;IACN,OAAO,CAAiB;IACxB,MAAM,CAAS;IACxB,OAAO,GAA2B,IAAI,CAAC;IACvC,SAAS,GAAoB,IAAI,CAAC;IAClC,UAAU,GAAa,EAAE,CAAC;IAElC,YAAY,OAAuB;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;IACnD,CAAC;IAED,wBAAwB;IAEhB,QAAQ,CAAC,SAAkB,EAAE;QACnC,OAAO;YACL,aAAa,EAAE,IAAI,CAAC,OAAO,CAAC,aAAa;YACzC,MAAM,EAAE,IAAI,CAAC,SAAS,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE;YACzE,MAAM;SACP,CAAC;IACJ,CAAC;IAED,iFAAiF;IACjF,OAAO;IACP,iFAAiF;IAEjF;;;OAGG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QAExB,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAChC,MAAM,SAAS,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QAE/D,mBAAmB;QACnB,IAAI,CAAC,SAAS,GAAG,IAAI,QAAQ,EAAE,CAAC;QAEhC,sBAAsB;QACtB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,SAAS,CAAC,UAAU,CAAC;QAClE,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;QAEjF,0CAA0C;QAC1C,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;QAE7E,yBAAyB;QACzB,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;QAEzE,oEAAoE;QACpE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QACnD,IAAI,CAAC,OAAO,GAAG,IAAI,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAExD,IAAI,MAAM,EAAE,CAAC;YACX,6DAA6D;YAC7D,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;YACpC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;gBACd,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,KAAK,EAAE,MAAM;gBACb,KAAK,EAAE,MAAM;gBACb,KAAK,EAAE,gBAAgB;gBACvB,IAAI,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE;aAC7D,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,0DAA0D;YAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC5B,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAC7C,oBAAoB,EAAE,SAAS,EAAE,GAAG,CACrC,CAAC;YAEF,yDAAyD;YACzD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;YACpC,KAAK,MAAM,MAAM,IAAI,eAAe,EAAE,CAAC;gBACrC,IAAI,MAAM,CAAC,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;oBAClD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;wBAClC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;oBACvB,CAAC;gBACH,CAAC;YACH,CAAC;YACD,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAExC,cAAc;YACd,MAAM,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE;gBAC/C,OAAO,EAAE,CAAC;gBACV,QAAQ;gBACR,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,cAAc,EAAE,QAAQ;gBACxB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC,CAAC;gBACxF,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC,CAAC;QACL,CAAC;QAED,qDAAqD;QACrD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;QAE/D,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;YACd,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,KAAK,EAAE,MAAM;YACb,KAAK,EAAE,MAAM;YACb,KAAK,EAAE,eAAe;YACtB,IAAI,EAAE;gBACJ,cAAc,EAAE,MAAM,CAAC,MAAM;gBAC7B,cAAc,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM;gBACtC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM;gBACpC,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAC1C,QAAQ,EAAE,CAAC,CAAC,MAAM;aACnB;YACD,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;SAClD,CAAC,CAAC;QAEH,mDAAmD;QACnD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC5B,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;QAEzD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,cAAc,CAAC,cAAwB;QACnD,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAE3C,IAAI,UAAiD,CAAC;QACtD,IAAI,CAAC;YACH,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;YAC5C,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;gBACd,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,KAAK,EAAE,MAAM;gBACb,KAAK,EAAE,MAAM;gBACb,KAAK,EAAE,oBAAoB;gBAC3B,IAAI,EAAE,EAAE,OAAO,EAAE,oDAAoD,EAAE;aACxE,CAAC,CAAC;QACL,CAAC;QAED,MAAM,MAAM,GAA0D,EAAE,CAAC;QAEzE,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;YACrC,IAAI,CAAC;gBACH,IAAI,GAA4B,CAAC;gBACjC,IAAI,UAAU,EAAE,CAAC;oBACf,GAAG,GAAG,UAAU,CAAC,OAAO,CAA4B,CAAC;gBACvD,CAAC;qBAAM,CAAC;oBACN,GAAG,GAAG,MAAM,MAAM,CAAC,OAAO,CAA4B,CAAC;gBACzD,CAAC;gBAED,MAAM,OAAO,GAAG,CAAC,OAAO,GAAG,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAChB,CAAC;gBAEvD,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;oBAClC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;wBACd,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;wBACnC,KAAK,EAAE,MAAM;wBACb,KAAK,EAAE,MAAM;wBACb,KAAK,EAAE,sBAAsB;wBAC7B,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;qBACxB,CAAC,CAAC;oBACH,SAAS;gBACX,CAAC;gBAED,sEAAsE;gBACtE,MAAM,SAAS,GAA4B,EAAE,CAAC;gBAE9C,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,oBAAoB,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,SAAU,EAAE,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;gBACjH,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;gBACnB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBAEvB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;oBACd,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACnC,KAAK,EAAE,MAAM;oBACb,KAAK,EAAE,MAAM;oBACb,KAAK,EAAE,kBAAkB;oBACzB,IAAI,EAAE;wBACJ,IAAI,EAAE,OAAO;wBACb,QAAQ,EAAE,MAAM,CAAC,WAAW,CAC1B,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CACxE;wBACD,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;wBACzC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;qBAChD;iBACF,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;oBACd,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACnC,KAAK,EAAE,MAAM;oBACb,KAAK,EAAE,MAAM;oBACb,KAAK,EAAE,sBAAsB;oBAC7B,IAAI,EAAE;wBACJ,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;qBACxD;iBACF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,iFAAiF;IACjF,iBAAiB;IACjB,iFAAiF;IAEjF;;;;;;;OAOG;IACH,KAAK,CAAC,aAAa,CAAC,MAAc,EAAE,eAAwC;QAC1E,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACpB,CAAC;QAED,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAEhC,iDAAiD;QACjD,IAAI,MAAM,GAAG,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAEpD,0CAA0C;QAC1C,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAClC,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAC1D,eAAe,EAAE,MAAM,EAAE,GAAG,CAC7B,CAAC;YACF,IAAI,cAAc,IAAI,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;gBACpD,MAAM,GAAG,cAAc,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;YACd,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,KAAK,EAAE,MAAM;YACb,KAAK,EAAE,QAAQ;YACf,KAAK,EAAE,kBAAkB;YACzB,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE;YACjF,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;SAClD,CAAC,CAAC;QAEH,0BAA0B;QAC1B,IAAI,OAAO,GAAuB,IAAI,CAAC;QACvC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,UAAU,GAAe,EAAE,MAAM,EAAE,CAAC;YAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAClC,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,eAAe,CAAc,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;QACtF,CAAC;QAED,uCAAuC;QACvC,IAAI,QAAQ,GAAc,EAAE,CAAC;QAC7B,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,WAAW,GAAuB,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;YAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAClC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,gBAAgB,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC;YAC7F,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;YAE9B,sDAAsD;YACtD,MAAM,WAAW,GAAuB,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;YAC3D,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAC3C,gBAAgB,EAAE,WAAW,EAAE,GAAG,CACnC,CAAC;YACF,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;gBACnC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;oBAClB,QAAQ,CAAC,IAAI,CAAC;wBACZ,EAAE,EAAE,iBAAiB,QAAQ,CAAC,MAAM,EAAE;wBACtC,KAAK,EAAE,mBAAmB;wBAC1B,OAAO,EAAE,MAAM,CAAC,MAAM;wBACtB,QAAQ,EAAE,EAAE;wBACZ,MAAM,EAAE,QAAQ;qBACjB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,oCAAoC;QACpC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;QAEjD,iCAAiC;QACjC,MAAM,WAAW,GAAG,eAAe,EAAE,WAAW,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;QAC7E,IAAI,WAAW,EAAE,CAAC;YAChB,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QACtD,CAAC;QAED,+CAA+C;QAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAElD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;YACd,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,KAAK,EAAE,MAAM;YACb,KAAK,EAAE,QAAQ;YACf,KAAK,EAAE,iBAAiB;YACxB,IAAI,EAAE;gBACJ,YAAY,EAAE,QAAQ,CAAC,MAAM;gBAC7B,WAAW,EAAE,SAAS,CAAC,MAAM;gBAC7B,eAAe,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;gBACjD,OAAO,EAAE,OAAO,EAAE,KAAK,IAAI,SAAS;gBACpC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aAChC;YACD,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;SAClD,CAAC,CAAC;QAEH,mDAAmD;QACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,yBAAyB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QAEnF,OAAO;YACL,SAAS;YACT,QAAQ;YACR,YAAY,EAAE,IAAI,CAAC,IAAI;YACvB,OAAO;YACP,MAAM;YACN,QAAQ;SACT,CAAC;IACJ,CAAC;IAED,iFAAiF;IACjF,QAAQ;IACR,iFAAiF;IAEjF;;;OAGG;IACH,KAAK,CAAC,KAAK,CAAC,QAAgB;QAC1B,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAED,iFAAiF;IACjF,eAAe;IACf,iFAAiF;IAEjF;;OAEG;IACH,KAAK,CAAC,IAAI,CAAI,KAAa,EAAE,IAAc;QACzC,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAI,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,KAAoB;QACrC,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,WAAW,EAAE,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ;QACZ,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACrE,CAAC;QACD,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED,iFAAiF;IACjF,YAAY;IACZ,iFAAiF;IAEjF,kEAAkE;IAClE,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,uCAAuC;IACvC,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,mEAAmE;IACnE,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED,+BAA+B;IAC/B,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,8CAA8C;IAC9C,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC;IACtC,CAAC;IAED,2CAA2C;IAC3C,IAAI,WAAW;QACb,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,OAAO,EAAE,WAAW,IAAI,EAAE;YAC3C,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE;YACjE,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM;YACjC,cAAc,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM;SACvC,CAAC;IACJ,CAAC;IAED,iFAAiF;IACjF,UAAU;IACV,iFAAiF;IAEjF;;OAEG;IACK,gBAAgB,CAAC,QAAmB;QAC1C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAErC,OAAO,QAAQ;aACZ,GAAG,CAAC,CAAC,CAAC,EAAE;YACP,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;gBACZ,OAAO,MAAM,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;YACzC,CAAC;YACD,OAAO,CAAC,CAAC,OAAO,CAAC;QACnB,CAAC,CAAC;aACD,IAAI,CAAC,aAAa,CAAC,CAAC;IACzB,CAAC;IAED;;;OAGG;IACK,YAAY,CAAC,QAAmB,EAAE,MAAc;QACtD,MAAM,cAAc,GAAG,CAAC,IAAe,EAAE,EAAE,CACzC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAE5F,IAAI,OAAO,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;QACvC,IAAI,OAAO,IAAI,MAAM;YAAE,OAAO,QAAQ,CAAC;QAEvC,MAAM,MAAM,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC;QAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;QAE7B,2CAA2C;QAC3C,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5C,IAAI,OAAO,IAAI,MAAM;gBAAE,MAAM;YAC7B,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YACpB,IAAI,CAAC,CAAC,YAAY,KAAK,UAAU,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;gBAC7D,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,oBAAoB,EAAE,CAAC;gBAC/E,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC3C,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QAED,gEAAgE;QAChE,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5C,IAAI,OAAO,IAAI,MAAM;gBAAE,MAAM;YAC7B,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YACpB,IAAI,CAAC,CAAC,YAAY,KAAK,OAAO,EAAE,CAAC;gBAC/B,OAAO,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC;gBAClE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBACpB,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,OAAO,GAAkB,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;YACpE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;gBACd,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;gBACzC,KAAK,EAAE,QAAQ;gBACf,KAAK,EAAE,gBAAgB;gBACvB,IAAI,EAAE,OAA6C;aACpD,CAAC,CAAC;QACL,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;OAGG;IACK,yBAAyB,CAC/B,MAAc,EACd,MAAe,EACf,QAAmB,EACnB,OAA2B;QAE3B,OAAO;YACL,MAAM;YACN,MAAM;YACN,UAAU,EAAE,QAAQ;iBACjB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,IAAI,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC;iBACxD,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACT,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,MAAM;gBACtB,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;aACrB,CAAC,CAAC;YACL,QAAQ,EAAE,EAAE;YACZ,MAAM,EAAE,EAAE;YACV,KAAK,EAAE,EAAE;YACT,OAAO,EAAE,OAAO,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,uBAAuB,EAAE;SAC1E,CAAC;IACJ,CAAC;CACF"}

package/dist/types.d.ts

@@ -65,7 +65,7 @@ export interface RoutingResult {
     fallback?: string;
 }
 /**
- * The output of the enrich() call.
+ * The output of the enrich pipeline.
  * This is what adapters consume to inject into the agent.
  */
 export interface EnrichedContext {
@@ -73,6 +73,8 @@ export interface EnrichedContext {
     labels: Label[];
     identities: Identity[];
     memories: MemoryEntry[];
+    memoryDescription?: string;
+    recentTasks?: Task[];
     skills: Skill[];
     tools: Tool[];
     routing: RoutingResult;
@@ -86,7 +88,7 @@ export interface TaskFilter {
     tags?: string[];
 }
 /**
- * Configuration from dot-ai.yml
+ * Configuration types
  */
 export interface DebugConfig {
     logPath?: string;
@@ -95,17 +97,34 @@ export interface WorkspaceConfig {
     scanDirs?: string;
 }
 export interface DotAiConfig {
-    memory?: ProviderConfig;
-    skills?: ProviderConfig;
-    identity?: ProviderConfig;
-    routing?: ProviderConfig;
-    tasks?: ProviderConfig;
-    tools?: ProviderConfig;
     debug?: DebugConfig;
     workspace?: WorkspaceConfig;
+    extensions?: ExtensionsConfig;
+    prompts?: PromptsConfig;
 }
-export interface ProviderConfig {
-    use: string;
+/** Prompt template type */
+export interface PromptTemplate {
+    name: string;
+    content: string;
+    args?: string[];
+    description?: string;
+}
+/** Extensions config section */
+export interface ExtensionsConfig {
+    paths?: string[];
+    packages?: string[];
+}
+/** Prompts config section */
+export interface PromptsConfig {
+    use?: string;
     with?: Record<string, unknown>;
 }
+/**
+ * Warning emitted when context exceeds the token budget.
+ */
+export interface BudgetWarning {
+    budget: number;
+    actual: number;
+    actions: string[];
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dot-ai/core",
-  "version": "0.5.2",
+  "version": "0.7.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/jogelin/dot-ai",
@@ -13,6 +13,9 @@
     "@types/node": "^22.0.0",
     "typescript": "^5.9.3"
   },
+  "optionalDependencies": {
+    "jiti": "^2.0.0"
+  },
   "publishConfig": {
     "access": "public"
   },

package/src/__tests__/capabilities.test.ts

@@ -0,0 +1,72 @@
+import { describe, it, expect, vi } from 'vitest';
+import { toolDefinitionToCapability } from '../capabilities.js';
+import type { ToolDefinition } from '../extension-types.js';
+
+describe('toolDefinitionToCapability()', () => {
+  function makeToolDef(overrides?: Partial<ToolDefinition>): ToolDefinition {
+    return {
+      name: 'my_tool',
+      description: 'Does something useful',
+      parameters: { type: 'object', properties: { input: { type: 'string' } } },
+      execute: vi.fn().mockResolvedValue({ content: 'result text', details: { extra: 42 } }),
+      promptSnippet: 'Use my_tool for useful things.',
+      promptGuidelines: 'Always provide input.',
+      ...overrides,
+    };
+  }
+
+  it('maps ToolDefinition fields to Capability correctly', () => {
+    const tool = makeToolDef();
+    const cap = toolDefinitionToCapability(tool);
+
+    expect(cap.name).toBe('my_tool');
+    expect(cap.description).toBe('Does something useful');
+    expect(cap.parameters).toEqual(tool.parameters);
+  });
+
+  it('maps content → text in execute result', async () => {
+    const tool = makeToolDef();
+    const cap = toolDefinitionToCapability(tool);
+
+    const result = await cap.execute({ input: 'hello' });
+
+    expect(result.text).toBe('result text');
+  });
+
+  it('preserves details from the tool execute result', async () => {
+    const tool = makeToolDef();
+    const cap = toolDefinitionToCapability(tool);
+
+    const result = await cap.execute({});
+
+    expect(result.details).toEqual({ extra: 42 });
+  });
+
+  it('preserves promptSnippet', () => {
+    const cap = toolDefinitionToCapability(makeToolDef());
+    expect(cap.promptSnippet).toBe('Use my_tool for useful things.');
+  });
+
+  it('preserves promptGuidelines', () => {
+    const cap = toolDefinitionToCapability(makeToolDef());
+    expect(cap.promptGuidelines).toBe('Always provide input.');
+  });
+
+  it('handles missing promptSnippet / promptGuidelines gracefully', () => {
+    const tool = makeToolDef({ promptSnippet: undefined, promptGuidelines: undefined });
+    const cap = toolDefinitionToCapability(tool);
+
+    expect(cap.promptSnippet).toBeUndefined();
+    expect(cap.promptGuidelines).toBeUndefined();
+  });
+
+  it('forwards params to the underlying tool execute', async () => {
+    const executeFn = vi.fn().mockResolvedValue({ content: 'ok' });
+    const tool = makeToolDef({ execute: executeFn });
+    const cap = toolDefinitionToCapability(tool);
+
+    await cap.execute({ input: 'test-value' });
+
+    expect(executeFn).toHaveBeenCalledWith({ input: 'test-value' });
+  });
+});