@dot-ai/core 0.5.2

package/dist/contracts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contracts.js.map

package/dist/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":""}

package/dist/engine.d.ts

@@ -0,0 +1,38 @@
+import type { MemoryProvider, SkillProvider, IdentityProvider, RoutingProvider, TaskProvider, ToolProvider } from './contracts.js';
+import type { EnrichedContext, Identity, Skill } from './types.js';
+import type { Logger } from './logger.js';
+/**
+ * All providers needed by the engine.
+ */
+export interface Providers {
+    memory: MemoryProvider;
+    skills: SkillProvider;
+    identity: IdentityProvider;
+    routing: RoutingProvider;
+    tasks: TaskProvider;
+    tools: ToolProvider;
+}
+/**
+ * Cached data from boot phase. Reused across prompts.
+ */
+export interface BootCache {
+    identities: Identity[];
+    vocabulary: string[];
+    skills: Skill[];
+}
+/**
+ * Boot phase — run once per session.
+ * Loads identities, indexes skills/tools, builds label vocabulary.
+ */
+export declare function boot(providers: Providers, logger?: Logger): Promise<BootCache>;
+/**
+ * Enrich a prompt — run per prompt.
+ * Calls all providers to build an EnrichedContext.
+ */
+export declare function enrich(prompt: string, providers: Providers, cache: BootCache, logger?: Logger): Promise<EnrichedContext>;
+/**
+ * Learn phase — run after agent response.
+ * Stores learnings in memory.
+ */
+export declare function learn(response: string, providers: Providers): Promise<void>;
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,YAAY,EACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,OAAO,EAAE,eAAe,CAAC;IACzB,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,YAAY,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,QAAQ,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAsB,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CA8BpF;AAED;;;GAGG;AACH,wBAAsB,MAAM,CAC1B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,SAAS,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,eAAe,CAAC,CA8C1B;AAED;;;GAGG;AACH,wBAAsB,KAAK,CACzB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,IAAI,CAAC,CAWf"}

package/dist/engine.js

@@ -0,0 +1,88 @@
+import { extractLabels, buildVocabulary } from './labels.js';
+/**
+ * Boot phase — run once per session.
+ * Loads identities, indexes skills/tools, builds label vocabulary.
+ */
+export async function boot(providers, logger) {
+    const start = performance.now();
+    const [identities, skills, tools] = await Promise.all([
+        providers.identity.load(),
+        providers.skills.list(),
+        providers.tools.list(),
+    ]);
+    // Build vocabulary from skill labels, skill triggers (excluding meta-triggers), and tool labels
+    const META_TRIGGERS = new Set(['always', 'auto', 'manual', 'boot', 'heartbeat', 'pipeline', 'audit']);
+    const skillTriggers = skills.map((s) => (s.triggers ?? []).filter((t) => !META_TRIGGERS.has(t)));
+    const vocabulary = buildVocabulary([...skills.map((s) => s.labels), ...skillTriggers], tools.map((t) => t.labels));
+    logger?.log({
+        timestamp: new Date().toISOString(),
+        level: 'info',
+        phase: 'boot',
+        event: 'boot_complete',
+        data: { identityCount: identities.length, skillCount: skills.length, vocabularySize: vocabulary.length },
+        durationMs: Math.round(performance.now() - start),
+    });
+    return { identities, vocabulary, skills };
+}
+/**
+ * Enrich a prompt — run per prompt.
+ * Calls all providers to build an EnrichedContext.
+ */
+export async function enrich(prompt, providers, cache, logger) {
+    const start = performance.now();
+    // 1. Extract labels from prompt against known vocabulary
+    const labels = extractLabels(prompt, cache.vocabulary);
+    logger?.log({
+        timestamp: new Date().toISOString(),
+        level: 'info',
+        phase: 'enrich',
+        event: 'labels_extracted',
+        data: { labels: labels.map(l => l.name), vocabularySize: cache.vocabulary.length },
+        durationMs: Math.round(performance.now() - start),
+    });
+    // 2. Search memory + match skills + match tools + route — all in parallel
+    const [memories, matchedSkills, matchedTools, routing] = await Promise.all([
+        providers.memory.search(prompt, labels.map((l) => l.name)),
+        providers.skills.match(labels),
+        providers.tools.match(labels),
+        providers.routing.route(labels),
+    ]);
+    logger?.log({
+        timestamp: new Date().toISOString(),
+        level: 'info',
+        phase: 'enrich',
+        event: 'enrich_complete',
+        data: {
+            labelCount: labels.length,
+            memoryCount: memories.length,
+            skillCount: matchedSkills.length,
+            routing: routing.model,
+        },
+        durationMs: Math.round(performance.now() - start),
+    });
+    return {
+        prompt,
+        labels,
+        identities: cache.identities,
+        memories,
+        skills: matchedSkills,
+        tools: matchedTools,
+        routing,
+    };
+}
+/**
+ * Learn phase — run after agent response.
+ * Stores learnings in memory.
+ */
+export async function learn(response, providers) {
+    const MAX_LEARN_LENGTH = 500;
+    const truncated = response.length > MAX_LEARN_LENGTH
+        ? response.slice(0, MAX_LEARN_LENGTH) + '…'
+        : response;
+    await providers.memory.store({
+        content: truncated,
+        type: 'log',
+        date: new Date().toISOString().slice(0, 10),
+    });
+}
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

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

package/dist/format.d.ts

@@ -0,0 +1,18 @@
+import type { EnrichedContext } from './types.js';
+import type { Logger } from './logger.js';
+export interface FormatOptions {
+    /** Skip identity sections (useful when already injected at session start) */
+    skipIdentities?: boolean;
+    /** Max chars per skill content. Truncated skills get a [...truncated] marker. Default: unlimited */
+    maxSkillLength?: number;
+    /** Max number of skills to include (already sorted by match relevance). Default: unlimited */
+    maxSkills?: number;
+    /** Optional logger for tracing */
+    logger?: Logger;
+}
+/**
+ * Format an EnrichedContext into markdown sections for injection into agent context.
+ * Sections are ordered by priority: identity > memory > skills > tools > routing.
+ */
+export declare function formatContext(ctx: EnrichedContext, options?: FormatOptions): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAA2C,MAAM,YAAY,CAAC;AAC3F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,aAAa;IAC5B,6EAA6E;IAC7E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,oGAAoG;IACpG,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8FAA8F;IAC9F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CAyDnF"}

package/dist/format.js

@@ -0,0 +1,89 @@
+/**
+ * Format an EnrichedContext into markdown sections for injection into agent context.
+ * Sections are ordered by priority: identity > memory > skills > tools > routing.
+ */
+export function formatContext(ctx, options) {
+    const start = performance.now();
+    const sections = [];
+    // Identity sections (sorted by priority, highest first)
+    if (!options?.skipIdentities) {
+        const sortedIdentities = [...ctx.identities].sort((a, b) => b.priority - a.priority);
+        for (const identity of sortedIdentities) {
+            if (identity.content) {
+                sections.push(identity.content);
+            }
+        }
+    }
+    // Memory section
+    if (ctx.memories.length > 0) {
+        sections.push(formatMemory(ctx.memories));
+    }
+    // Skills section
+    let loadedSkills = ctx.skills.filter(s => s.content);
+    if (options?.maxSkills != null) {
+        loadedSkills = loadedSkills.slice(0, options.maxSkills);
+    }
+    if (loadedSkills.length > 0) {
+        sections.push(formatSkills(loadedSkills, options?.maxSkillLength));
+    }
+    // Tools section
+    if (ctx.tools.length > 0) {
+        sections.push(formatTools(ctx.tools));
+    }
+    // Routing hint
+    if (ctx.routing.model !== 'default') {
+        sections.push(formatRouting(ctx.routing));
+    }
+    const result = sections.join('\n\n---\n\n');
+    options?.logger?.log({
+        timestamp: new Date().toISOString(),
+        level: 'info',
+        phase: 'format',
+        event: 'format_complete',
+        data: {
+            outputChars: result.length,
+            estimatedTokens: Math.round(result.length / 4),
+            skillsIncluded: loadedSkills.map(s => s.name),
+            truncatedSkills: loadedSkills
+                .filter(s => options?.maxSkillLength != null && (s.content?.length ?? 0) > options.maxSkillLength)
+                .map(s => s.name),
+        },
+        durationMs: Math.round(performance.now() - start),
+    });
+    return result;
+}
+function formatMemory(memories) {
+    const lines = ['## Relevant Memory\n'];
+    for (const m of memories.slice(0, 10)) { // Limit to 10 most relevant
+        const date = m.date ? ` (${m.date})` : '';
+        lines.push(`- ${m.content}${date}`);
+    }
+    return lines.join('\n');
+}
+function formatSkills(skills, maxLength) {
+    const lines = ['## Active Skills\n'];
+    for (const s of skills) {
+        lines.push(`### ${s.name}`);
+        if (s.content) {
+            if (maxLength != null && s.content.length > maxLength) {
+                lines.push(s.content.slice(0, maxLength) + '\n\n[...truncated]');
+            }
+            else {
+                lines.push(s.content);
+            }
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+function formatTools(tools) {
+    const lines = ['## Available Tools\n'];
+    for (const t of tools) {
+        lines.push(`- **${t.name}**: ${t.description}`);
+    }
+    return lines.join('\n');
+}
+function formatRouting(routing) {
+    return `## Model Routing\n\nRecommended model: **${routing.model}** (${routing.reason})`;
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @dot-ai/core v4 — Contracts and types for the dot-ai convention.
+ *
+ * dot-ai = contracts (interfaces) + providers (pluggable implementations) + adapters (agent integration).
+ * Core defines WHAT, providers define HOW, adapters define WHERE.
+ */
+export type { Label, Node, MemoryEntry, Skill, Identity, Task, Tool, RoutingResult, EnrichedContext, TaskFilter, DotAiConfig, DebugConfig, ProviderConfig, WorkspaceConfig, } from './types.js';
+export type { MemoryProvider, SkillProvider, IdentityProvider, RoutingProvider, TaskProvider, ToolProvider, ProviderFactory, } from './contracts.js';
+export { boot, enrich, learn } from './engine.js';
+export type { Providers, BootCache } from './engine.js';
+export { loadConfig, resolveConfig, injectRoot } from './config.js';
+export type { ResolvedConfig } from './config.js';
+export { formatContext } from './format.js';
+export type { FormatOptions } from './format.js';
+export type { LogLevel, LogEntry, Logger } from './logger.js';
+export { NoopLogger, JsonFileLogger, StderrLogger } from './logger.js';
+export { registerProvider, clearProviders, createProviders } from './loader.js';
+export { extractLabels, buildVocabulary } from './labels.js';
+export { discoverNodes, parseScanDirs } from './nodes.js';
+export { registerDefaults } from './loader.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,KAAK,EACL,IAAI,EACJ,WAAW,EACX,KAAK,EACL,QAAQ,EACR,IAAI,EACJ,IAAI,EACJ,aAAa,EACb,eAAe,EACf,UAAU,EACV,WAAW,EACX,WAAW,EACX,cAAc,EACd,eAAe,GAChB,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACpE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGvE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGhF,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG7D,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,22 @@
+/**
+ * @dot-ai/core v4 — Contracts and types for the dot-ai convention.
+ *
+ * dot-ai = contracts (interfaces) + providers (pluggable implementations) + adapters (agent integration).
+ * Core defines WHAT, providers define HOW, adapters define WHERE.
+ */
+// ── Engine ──
+export { boot, enrich, learn } from './engine.js';
+// ── Config ──
+export { loadConfig, resolveConfig, injectRoot } from './config.js';
+// ── Format ──
+export { formatContext } from './format.js';
+export { NoopLogger, JsonFileLogger, StderrLogger } from './logger.js';
+// ── Loader ──
+export { registerProvider, clearProviders, createProviders } from './loader.js';
+// ── Labels ──
+export { extractLabels, buildVocabulary } from './labels.js';
+// ── Nodes ──
+export { discoverNodes, parseScanDirs } from './nodes.js';
+// ── registerDefaults ──
+export { registerDefaults } from './loader.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA+BH,eAAe;AACf,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGlD,eAAe;AACf,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGpE,eAAe;AACf,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAK5C,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEvE,eAAe;AACf,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEhF,eAAe;AACf,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE7D,cAAc;AACd,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE1D,yBAAyB;AACzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/labels.d.ts

@@ -0,0 +1,13 @@
+import type { Label } from './types.js';
+/**
+ * Extract labels from a prompt using word-boundary keyword matching.
+ * No LLM — pure deterministic pattern matching.
+ * Returns matched Label[] from a known vocabulary.
+ */
+export declare function extractLabels(prompt: string, vocabulary: string[]): Label[];
+/**
+ * Build a vocabulary from skill labels and any other known labels.
+ * This is called once at boot to build the label dictionary.
+ */
+export declare function buildVocabulary(skillLabels: string[][], toolLabels: string[][]): string[];
+//# sourceMappingURL=labels.d.ts.map

package/dist/labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../src/labels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAMxC;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,CAc3E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,CAQzF"}

package/dist/labels.js

@@ -0,0 +1,36 @@
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Extract labels from a prompt using word-boundary keyword matching.
+ * No LLM — pure deterministic pattern matching.
+ * Returns matched Label[] from a known vocabulary.
+ */
+export function extractLabels(prompt, vocabulary) {
+    const labels = [];
+    const seen = new Set();
+    for (const word of vocabulary) {
+        if (seen.has(word))
+            continue;
+        const regex = new RegExp(`\\b${escapeRegex(word)}\\b`, 'i');
+        if (regex.test(prompt)) {
+            seen.add(word);
+            labels.push({ name: word, source: 'extract' });
+        }
+    }
+    return labels;
+}
+/**
+ * Build a vocabulary from skill labels and any other known labels.
+ * This is called once at boot to build the label dictionary.
+ */
+export function buildVocabulary(skillLabels, toolLabels) {
+    const set = new Set();
+    for (const labels of [...skillLabels, ...toolLabels]) {
+        for (const label of labels) {
+            set.add(label);
+        }
+    }
+    return Array.from(set);
+}
+//# sourceMappingURL=labels.js.map

package/dist/labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.js","sourceRoot":"","sources":["../src/labels.ts"],"names":[],"mappings":"AAEA,SAAS,WAAW,CAAC,CAAS;IAC5B,OAAO,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,UAAoB;IAChE,MAAM,MAAM,GAAY,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QAC7B,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,MAAM,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC5D,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,WAAuB,EAAE,UAAsB;IAC7E,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,MAAM,IAAI,CAAC,GAAG,WAAW,EAAE,GAAG,UAAU,CAAC,EAAE,CAAC;QACrD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC"}

package/dist/loader.d.ts

@@ -0,0 +1,26 @@
+import type { DotAiConfig } from './types.js';
+import type { Providers } from './engine.js';
+/**
+ * Register a provider factory.
+ * Call this before createProviders().
+ *
+ * @example
+ * registerProvider('@dot-ai/cockpit-memory', (opts) => new CockpitMemory(opts.url));
+ */
+export declare function registerProvider(name: string, factory: (options: Record<string, unknown>) => unknown): void;
+/**
+ * Clear all registered providers.
+ * Useful for testing.
+ */
+export declare function clearProviders(): void;
+/**
+ * Register all default file-based providers.
+ * Call this at startup if you want file-based defaults available.
+ */
+export declare function registerDefaults(): void;
+/**
+ * Create all providers from config.
+ * Falls back to no-op providers for any missing registration.
+ */
+export declare function createProviders(config: DotAiConfig): Promise<Providers>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAQ,MAAM,YAAY,CAAC;AASpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAQ7C;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,GACrD,IAAI,CAEN;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAIvC;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CAW7E"}

package/dist/loader.js

@@ -0,0 +1,120 @@
+import { resolveConfig } from './config.js';
+/**
+ * Registry of provider factories.
+ * Adapters register their providers here before boot.
+ */
+const registry = new Map();
+/**
+ * Register a provider factory.
+ * Call this before createProviders().
+ *
+ * @example
+ * registerProvider('@dot-ai/cockpit-memory', (opts) => new CockpitMemory(opts.url));
+ */
+export function registerProvider(name, factory) {
+    registry.set(name, factory);
+}
+/**
+ * Clear all registered providers.
+ * Useful for testing.
+ */
+export function clearProviders() {
+    registry.clear();
+}
+/**
+ * Register all default file-based providers.
+ * Call this at startup if you want file-based defaults available.
+ */
+export function registerDefaults() {
+    // Default providers are now separate packages (@dot-ai/provider-file-memory, etc.)
+    // They are resolved via auto-discovery in resolve() → tryImportProvider()
+    // No explicit registration needed — the package names match the config defaults.
+}
+/**
+ * Create all providers from config.
+ * Falls back to no-op providers for any missing registration.
+ */
+export async function createProviders(config) {
+    const resolved = resolveConfig(config);
+    return {
+        memory: await resolve(resolved.memory.use, resolved.memory.with ?? {}, noopMemory),
+        skills: await resolve(resolved.skills.use, resolved.skills.with ?? {}, noopSkills),
+        identity: await resolve(resolved.identity.use, resolved.identity.with ?? {}, noopIdentity),
+        routing: await resolve(resolved.routing.use, resolved.routing.with ?? {}, noopRouting),
+        tasks: await resolve(resolved.tasks.use, resolved.tasks.with ?? {}, noopTasks),
+        tools: await resolve(resolved.tools.use, resolved.tools.with ?? {}, noopTools),
+    };
+}
+async function resolve(name, options, fallback) {
+    let factory = registry.get(name);
+    if (!factory) {
+        // Auto-discovery: try dynamic import
+        factory = await tryImportProvider(name);
+        if (factory) {
+            registry.set(name, factory); // Cache for next time
+        }
+    }
+    if (!factory)
+        return fallback;
+    return factory(options);
+}
+/**
+ * Try to import a provider package dynamically.
+ * Looks for: default export factory, createXxxProvider function, or XxxProvider class.
+ */
+async function tryImportProvider(name) {
+    try {
+        const mod = await import(name);
+        // 1. Check for default export (function)
+        if (typeof mod.default === 'function') {
+            return mod.default;
+        }
+        // 2. Check for createXxxProvider factory function
+        for (const [key, value] of Object.entries(mod)) {
+            if (key.startsWith('create') && key.endsWith('Provider') && typeof value === 'function') {
+                return value;
+            }
+        }
+        // 3. Check for XxxProvider class (constructor)
+        for (const [key, value] of Object.entries(mod)) {
+            if (key.endsWith('Provider') && typeof value === 'function') {
+                return (opts) => new value(opts);
+            }
+        }
+        return undefined;
+    }
+    catch {
+        // Package not found or import error — not a problem, fall back to noop
+        return undefined;
+    }
+}
+// ── No-op providers (safe fallbacks) ────────────────────────────────────────
+const noopMemory = {
+    async search(_query, _labels) { return []; },
+    async store(_entry) { },
+};
+const noopSkills = {
+    async list() { return []; },
+    async match(_labels) { return []; },
+    async load(_name) { return null; },
+};
+const noopIdentity = {
+    async load() { return []; },
+};
+const noopRouting = {
+    async route(_labels) { return { model: 'default', reason: 'no routing provider' }; },
+};
+const noopTasks = {
+    async list(_filter) { return []; },
+    async get(_id) { return null; },
+    async create(task) { return { id: crypto.randomUUID(), ...task }; },
+    async update(id, patch) {
+        return { id, text: '', status: '', ...patch };
+    },
+};
+const noopTools = {
+    async list() { return []; },
+    async match(_labels) { return []; },
+    async load(_name) { return null; },
+};
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,29 @@
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface LogEntry {
+    timestamp: string;
+    level: LogLevel;
+    phase: 'boot' | 'enrich' | 'learn' | 'format';
+    event: string;
+    data?: Record<string, unknown>;
+    durationMs?: number;
+}
+export interface Logger {
+    log(entry: LogEntry): void;
+    flush(): Promise<void>;
+}
+export declare class NoopLogger implements Logger {
+    log(_entry: LogEntry): void;
+    flush(): Promise<void>;
+}
+export declare class JsonFileLogger implements Logger {
+    private buffer;
+    private filePath;
+    constructor(filePath: string);
+    log(entry: LogEntry): void;
+    flush(): Promise<void>;
+}
+export declare class StderrLogger implements Logger {
+    log(entry: LogEntry): void;
+    flush(): Promise<void>;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,QAAQ,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,MAAM;IACrB,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,qBAAa,UAAW,YAAW,MAAM;IACvC,GAAG,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI;IACrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAC7B;AAED,qBAAa,cAAe,YAAW,MAAM;IAC3C,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,EAAE,MAAM;IAI5B,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAIpB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAM7B;AAED,qBAAa,YAAa,YAAW,MAAM;IACzC,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAGpB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAC7B"}

package/dist/logger.js

@@ -0,0 +1,29 @@
+import { appendFile } from 'node:fs/promises';
+export class NoopLogger {
+    log(_entry) { }
+    async flush() { }
+}
+export class JsonFileLogger {
+    buffer = [];
+    filePath;
+    constructor(filePath) {
+        this.filePath = filePath;
+    }
+    log(entry) {
+        this.buffer.push(JSON.stringify(entry));
+    }
+    async flush() {
+        if (this.buffer.length === 0)
+            return;
+        const data = this.buffer.join('\n') + '\n';
+        this.buffer = [];
+        await appendFile(this.filePath, data, 'utf-8');
+    }
+}
+export class StderrLogger {
+    log(entry) {
+        process.stderr.write(JSON.stringify(entry) + '\n');
+    }
+    async flush() { }
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAkB9C,MAAM,OAAO,UAAU;IACrB,GAAG,CAAC,MAAgB,IAAS,CAAC;IAC9B,KAAK,CAAC,KAAK,KAAmB,CAAC;CAChC;AAED,MAAM,OAAO,cAAc;IACjB,MAAM,GAAa,EAAE,CAAC;IACtB,QAAQ,CAAS;IAEzB,YAAY,QAAgB;QAC1B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,GAAG,CAAC,KAAe;QACjB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACrC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QAC3C,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,MAAM,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;CACF;AAED,MAAM,OAAO,YAAY;IACvB,GAAG,CAAC,KAAe;QACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IACrD,CAAC;IACD,KAAK,CAAC,KAAK,KAAmB,CAAC;CAChC"}

package/dist/nodes.d.ts

@@ -0,0 +1,15 @@
+import type { Node } from './types.js';
+/**
+ * Discover all .ai/ directories in a workspace.
+ * Always includes root. Scans configurable directories for sub-nodes.
+ *
+ * @param root - workspace root (absolute path)
+ * @param scanDirs - directories to scan for sub-nodes (default: ["projects"])
+ */
+export declare function discoverNodes(root: string, scanDirs?: string[]): Node[];
+/**
+ * Parse scanDirs from a config string value.
+ * Returns empty array if not configured.
+ */
+export declare function parseScanDirs(value: unknown): string[];
+//# sourceMappingURL=nodes.d.ts.map

package/dist/nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodes.d.ts","sourceRoot":"","sources":["../src/nodes.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,EAAiB,GAAG,IAAI,EAAE,CAyBrF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAGtD"}