@dot-ai/core 0.5.2 → 0.8.0

package/dist/extension-api.js

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

package/dist/extension-api.js.map

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

package/dist/extension-loader.d.ts

@@ -0,0 +1,19 @@
+import type { ExtensionAPI } from './extension-api.js';
+import type { LoadedExtension } from './extension-types.js';
+import type { ExtensionsConfig } from './types.js';
+/**
+ * Discover extension file paths from configured locations.
+ */
+export declare function discoverExtensions(workspaceRoot: string, config?: ExtensionsConfig): Promise<string[]>;
+/**
+ * Create a v6 ExtensionAPI instance that collects registrations into a LoadedExtension.
+ * Extensions communicate via events only — no provider access.
+ */
+export declare function createV6CollectorAPI(extensionPath: string, config: Record<string, unknown>, eventBus?: {
+    on: (event: string, handler: (...args: unknown[]) => void) => void;
+    emit: (event: string, ...args: unknown[]) => void;
+}, workspaceRoot?: string): {
+    api: ExtensionAPI;
+    extension: LoadedExtension;
+};
+//# sourceMappingURL=extension-loader.d.ts.map

package/dist/extension-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-loader.d.ts","sourceRoot":"","sources":["../src/extension-loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAoD,MAAM,sBAAsB,CAAC;AAE9G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,aAAa,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,MAAM,EAAE,CAAC,CAiEnB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,CAAC,EAAE;IAAE,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;CAAE,EACpI,aAAa,CAAC,EAAE,MAAM,GACrB;IAAE,GAAG,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,eAAe,CAAA;CAAE,CAoCnD"}

package/dist/extension-loader.js

@@ -0,0 +1,113 @@
+import { readdir, readFile, stat } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { homedir } from 'node:os';
+import { EVENT_TIERS } from './extension-types.js';
+/**
+ * Discover extension file paths from configured locations.
+ */
+export async function discoverExtensions(workspaceRoot, config) {
+    const paths = new Set();
+    // Default discovery paths
+    const searchDirs = [
+        join(workspaceRoot, '.ai', 'extensions'),
+        join(homedir(), '.ai', 'extensions'),
+        ...(config?.paths ?? []).map(p => resolve(workspaceRoot, p)),
+    ];
+    for (const dir of searchDirs) {
+        try {
+            const entries = await readdir(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = join(dir, entry.name);
+                if (entry.isFile() && (entry.name.endsWith('.ts') || entry.name.endsWith('.js'))) {
+                    paths.add(fullPath);
+                }
+                else if (entry.isDirectory()) {
+                    // Check for index.ts or index.js
+                    for (const indexName of ['index.ts', 'index.js']) {
+                        const indexPath = join(fullPath, indexName);
+                        try {
+                            await stat(indexPath);
+                            paths.add(indexPath);
+                            break;
+                        }
+                        catch { /* not found */ }
+                    }
+                    // Check for package.json with dot-ai field
+                    try {
+                        const pkgPath = join(fullPath, 'package.json');
+                        const pkgRaw = await readFile(pkgPath, 'utf-8');
+                        const pkg = JSON.parse(pkgRaw);
+                        const dotAi = pkg['dot-ai'];
+                        if (dotAi?.extensions && Array.isArray(dotAi.extensions)) {
+                            for (const ext of dotAi.extensions) {
+                                paths.add(resolve(fullPath, ext));
+                            }
+                        }
+                    }
+                    catch { /* no package.json or no dot-ai field */ }
+                }
+            }
+        }
+        catch { /* directory doesn't exist — skip */ }
+    }
+    // Also resolve npm packages from config
+    if (config?.packages) {
+        for (const pkg of config.packages) {
+            try {
+                const { createRequire } = await import('node:module');
+                const require = createRequire(join(workspaceRoot, 'package.json'));
+                const pkgJsonPath = require.resolve(`${pkg}/package.json`);
+                const pkgRaw = await readFile(pkgJsonPath, 'utf-8');
+                const pkgJson = JSON.parse(pkgRaw);
+                const dotAi = pkgJson['dot-ai'];
+                if (dotAi?.extensions && Array.isArray(dotAi.extensions)) {
+                    const pkgDir = join(pkgJsonPath, '..');
+                    for (const ext of dotAi.extensions) {
+                        paths.add(resolve(pkgDir, ext));
+                    }
+                }
+            }
+            catch { /* package not found */ }
+        }
+    }
+    return Array.from(paths);
+}
+/**
+ * Create a v6 ExtensionAPI instance that collects registrations into a LoadedExtension.
+ * Extensions communicate via events only — no provider access.
+ */
+export function createV6CollectorAPI(extensionPath, config, eventBus, workspaceRoot) {
+    const extension = {
+        path: extensionPath,
+        handlers: new Map(),
+        tools: new Map(),
+        commands: new Map(),
+        tiers: new Set(),
+    };
+    const api = {
+        on(event, handler) {
+            if (!extension.handlers.has(event)) {
+                extension.handlers.set(event, []);
+            }
+            extension.handlers.get(event).push(handler);
+            const tier = EVENT_TIERS[event];
+            if (tier) {
+                extension.tiers.add(tier);
+            }
+        },
+        registerTool(tool) {
+            extension.tools.set(tool.name, tool);
+        },
+        registerCommand(command) {
+            extension.commands.set(command.name, command);
+        },
+        events: eventBus ?? {
+            on: () => { },
+            emit: () => { },
+        },
+        config,
+        workspaceRoot: workspaceRoot ?? process.cwd(),
+    };
+    return { api, extension };
+}
+//# sourceMappingURL=extension-loader.js.map

package/dist/extension-loader.js.map

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

package/dist/extension-runner.d.ts

@@ -0,0 +1,62 @@
+import type { Logger } from './logger.js';
+import type { LoadedExtension, ToolDefinition, ExtensionTier, ToolCallEvent, ToolCallResult, ExtensionDiagnostic, ExtensionContext, CollectedSections, CommandDefinition } from './extension-types.js';
+/**
+ * Simple event bus for inter-extension communication.
+ * In-memory only, no persistence.
+ */
+export declare class EventBus {
+    private listeners;
+    on(event: string, handler: (...args: unknown[]) => void): void;
+    off(event: string, handler: (...args: unknown[]) => void): void;
+    emit(event: string, ...args: unknown[]): void;
+}
+/**
+ * ExtensionRunner — fires events and collects results from loaded extensions.
+ */
+export declare class ExtensionRunner {
+    private extensions;
+    private logger?;
+    constructor(extensions: LoadedExtension[], logger?: Logger);
+    /**
+     * Fire an event and collect results from all extensions.
+     * ctx is passed as second argument to handlers (like Pi's ctx pattern).
+     * Errors in individual handlers are caught and logged — never thrown.
+     */
+    fire<T>(event: string, data?: unknown, ctx?: ExtensionContext): Promise<T[]>;
+    /**
+     * Fire a tool_call event, stop at first blocking result.
+     * Returns the blocking result, or null if all allow.
+     */
+    fireUntilBlocked(event: 'tool_call', data: ToolCallEvent, ctx?: ExtensionContext): Promise<ToolCallResult | null>;
+    /**
+     * Fire an event and collect sections from all handlers.
+     * Used for `context_enrich` — each handler returns sections and/or systemPrompt fragments.
+     * All sections are flattened into a single array; all systemPrompt strings are concatenated.
+     */
+    fireCollectSections(event: string, data?: unknown, ctx?: ExtensionContext): Promise<CollectedSections>;
+    /**
+     * Fire an event and return the first non-null/undefined result.
+     * Used for `route` — stops at the first handler that returns a value.
+     * Returns null if no handler returns a result.
+     */
+    fireFirstResult<T>(event: string, data?: unknown, ctx?: ExtensionContext): Promise<T | null>;
+    /**
+     * Fire an event as a transform chain — each handler receives the previous handler's output.
+     * Used for `label_extract`, `input`, `context_modify`.
+     *
+     * - Initial value is `data`.
+     * - If a handler returns undefined/null, the previous value is kept (no-op).
+     * - For `input` events: if the result has `consumed: true`, short-circuits and returns immediately.
+     */
+    fireChainTransform<T>(event: string, data: T, ctx?: ExtensionContext): Promise<T>;
+    /** Get all registered tools across extensions (last-wins for overrides) */
+    get tools(): ToolDefinition[];
+    /** Get all registered commands across extensions (last-wins for overrides) */
+    get commands(): CommandDefinition[];
+    /** Get diagnostic info */
+    get diagnostics(): ExtensionDiagnostic[];
+    /** Which tiers are used by loaded extensions */
+    get usedTiers(): Set<ExtensionTier>;
+    private logHandlerError;
+}
+//# sourceMappingURL=extension-runner.d.ts.map

package/dist/extension-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-runner.d.ts","sourceRoot":"","sources":["../src/extension-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,aAAa,EACb,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAGhB,iBAAiB,EACjB,iBAAiB,EAElB,MAAM,sBAAsB,CAAC;AAE9B;;;GAGG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,SAAS,CAA0D;IAE3E,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI;IAO9D,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI;IAO/D,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;CAW9C;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,MAAM,CAAC,CAAS;gBAEZ,UAAU,EAAE,eAAe,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM;IAK1D;;;;OAIG;IACG,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAsBlF;;;OAGG;IACG,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAsBvH;;;;OAIG;IACG,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAuC5G;;;;OAIG;IACG,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAoBlG;;;;;;;OAOG;IACG,kBAAkB,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,CAAC,CAAC;IA6BvF,2EAA2E;IAC3E,IAAI,KAAK,IAAI,cAAc,EAAE,CAmB5B;IAED,8EAA8E;IAC9E,IAAI,QAAQ,IAAI,iBAAiB,EAAE,CAWlC;IAED,0BAA0B;IAC1B,IAAI,WAAW,IAAI,mBAAmB,EAAE,CAUvC;IAED,gDAAgD;IAChD,IAAI,SAAS,IAAI,GAAG,CAAC,aAAa,CAAC,CAQlC;IAID,OAAO,CAAC,eAAe;CAaxB"}

package/dist/extension-runner.js

@@ -0,0 +1,260 @@
+/**
+ * Simple event bus for inter-extension communication.
+ * In-memory only, no persistence.
+ */
+export class EventBus {
+    listeners = new Map();
+    on(event, handler) {
+        if (!this.listeners.has(event)) {
+            this.listeners.set(event, []);
+        }
+        this.listeners.get(event).push(handler);
+    }
+    off(event, handler) {
+        const handlers = this.listeners.get(event);
+        if (!handlers)
+            return;
+        const idx = handlers.indexOf(handler);
+        if (idx >= 0)
+            handlers.splice(idx, 1);
+    }
+    emit(event, ...args) {
+        const handlers = this.listeners.get(event);
+        if (!handlers)
+            return;
+        for (const handler of handlers) {
+            try {
+                handler(...args);
+            }
+            catch {
+                // Silently ignore errors in event bus handlers
+            }
+        }
+    }
+}
+/**
+ * ExtensionRunner — fires events and collects results from loaded extensions.
+ */
+export class ExtensionRunner {
+    extensions;
+    logger;
+    constructor(extensions, logger) {
+        this.extensions = extensions;
+        this.logger = logger;
+    }
+    /**
+     * Fire an event and collect results from all extensions.
+     * ctx is passed as second argument to handlers (like Pi's ctx pattern).
+     * Errors in individual handlers are caught and logged — never thrown.
+     */
+    async fire(event, data, ctx) {
+        const results = [];
+        for (const ext of this.extensions) {
+            const handlers = ext.handlers.get(event);
+            if (!handlers)
+                continue;
+            for (const handler of handlers) {
+                try {
+                    const result = await handler(data, ctx);
+                    if (result !== undefined && result !== null) {
+                        results.push(result);
+                    }
+                }
+                catch (err) {
+                    this.logHandlerError(ext.path, event, err);
+                }
+            }
+        }
+        return results;
+    }
+    /**
+     * Fire a tool_call event, stop at first blocking result.
+     * Returns the blocking result, or null if all allow.
+     */
+    async fireUntilBlocked(event, data, ctx) {
+        for (const ext of this.extensions) {
+            const handlers = ext.handlers.get(event);
+            if (!handlers)
+                continue;
+            for (const handler of handlers) {
+                try {
+                    const result = await handler(data, ctx);
+                    if (result?.decision === 'block') {
+                        return result;
+                    }
+                }
+                catch (err) {
+                    this.logHandlerError(ext.path, event, err);
+                }
+            }
+        }
+        return null;
+    }
+    // ── v6 Emission Patterns ──
+    /**
+     * Fire an event and collect sections from all handlers.
+     * Used for `context_enrich` — each handler returns sections and/or systemPrompt fragments.
+     * All sections are flattened into a single array; all systemPrompt strings are concatenated.
+     */
+    async fireCollectSections(event, data, ctx) {
+        const sectionMap = new Map();
+        const anonymousSections = [];
+        const systemPromptParts = [];
+        for (const ext of this.extensions) {
+            const handlers = ext.handlers.get(event);
+            if (!handlers)
+                continue;
+            for (const handler of handlers) {
+                try {
+                    const result = await handler(data, ctx);
+                    if (result === undefined || result === null)
+                        continue;
+                    if (result.sections && Array.isArray(result.sections)) {
+                        for (const section of result.sections) {
+                            // Sections with the same id are overridden (last-wins)
+                            if (section.id) {
+                                sectionMap.set(section.id, section);
+                            }
+                            else {
+                                anonymousSections.push(section);
+                            }
+                        }
+                    }
+                    if (result.systemPrompt && typeof result.systemPrompt === 'string') {
+                        systemPromptParts.push(result.systemPrompt);
+                    }
+                }
+                catch (err) {
+                    this.logHandlerError(ext.path, event, err);
+                }
+            }
+        }
+        return {
+            sections: [...sectionMap.values(), ...anonymousSections],
+            systemPrompt: systemPromptParts.join('\n'),
+        };
+    }
+    /**
+     * Fire an event and return the first non-null/undefined result.
+     * Used for `route` — stops at the first handler that returns a value.
+     * Returns null if no handler returns a result.
+     */
+    async fireFirstResult(event, data, ctx) {
+        for (const ext of this.extensions) {
+            const handlers = ext.handlers.get(event);
+            if (!handlers)
+                continue;
+            for (const handler of handlers) {
+                try {
+                    const result = await handler(data, ctx);
+                    if (result !== undefined && result !== null) {
+                        return result;
+                    }
+                }
+                catch (err) {
+                    this.logHandlerError(ext.path, event, err);
+                }
+            }
+        }
+        return null;
+    }
+    /**
+     * Fire an event as a transform chain — each handler receives the previous handler's output.
+     * Used for `label_extract`, `input`, `context_modify`.
+     *
+     * - Initial value is `data`.
+     * - If a handler returns undefined/null, the previous value is kept (no-op).
+     * - For `input` events: if the result has `consumed: true`, short-circuits and returns immediately.
+     */
+    async fireChainTransform(event, data, ctx) {
+        let current = data;
+        for (const ext of this.extensions) {
+            const handlers = ext.handlers.get(event);
+            if (!handlers)
+                continue;
+            for (const handler of handlers) {
+                try {
+                    const result = await handler(current, ctx);
+                    if (result !== undefined && result !== null) {
+                        current = result;
+                        // Short-circuit for input events when consumed
+                        if (event === 'input' && result.consumed === true) {
+                            return current;
+                        }
+                    }
+                }
+                catch (err) {
+                    this.logHandlerError(ext.path, event, err);
+                }
+            }
+        }
+        return current;
+    }
+    // ── Accessors ──
+    /** Get all registered tools across extensions (last-wins for overrides) */
+    get tools() {
+        const toolMap = new Map();
+        for (const ext of this.extensions) {
+            for (const [name, tool] of ext.tools) {
+                if (toolMap.has(name)) {
+                    this.logger?.log({
+                        timestamp: new Date().toISOString(),
+                        level: 'info',
+                        phase: 'runtime',
+                        event: 'tool_override',
+                        data: { tool: name, extension: ext.path },
+                    });
+                }
+                toolMap.set(name, tool);
+            }
+        }
+        return Array.from(toolMap.values());
+    }
+    /** Get all registered commands across extensions (last-wins for overrides) */
+    get commands() {
+        const cmdMap = new Map();
+        for (const ext of this.extensions) {
+            if (!ext.commands)
+                continue;
+            for (const [name, cmd] of ext.commands) {
+                cmdMap.set(name, cmd);
+            }
+        }
+        return Array.from(cmdMap.values());
+    }
+    /** Get diagnostic info */
+    get diagnostics() {
+        return this.extensions.map(ext => ({
+            path: ext.path,
+            handlerCounts: Object.fromEntries(Array.from(ext.handlers.entries()).map(([k, v]) => [k, v.length])),
+            toolNames: Array.from(ext.tools.keys()),
+            commandNames: ext.commands ? Array.from(ext.commands.keys()) : [],
+            tiers: Array.from(ext.tiers),
+        }));
+    }
+    /** Which tiers are used by loaded extensions */
+    get usedTiers() {
+        const tiers = new Set();
+        for (const ext of this.extensions) {
+            for (const tier of ext.tiers) {
+                tiers.add(tier);
+            }
+        }
+        return tiers;
+    }
+    // ── Private Helpers ──
+    logHandlerError(extPath, event, err) {
+        this.logger?.log({
+            timestamp: new Date().toISOString(),
+            level: 'warn',
+            phase: 'runtime',
+            event: 'extension_handler_error',
+            data: {
+                extension: extPath,
+                eventName: event,
+                error: err instanceof Error ? err.message : String(err),
+            },
+        });
+    }
+}
+//# sourceMappingURL=extension-runner.js.map

package/dist/extension-runner.js.map

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