agent-nuvira 1.14.0

package/dist/memory/vector-store.js

@@ -0,0 +1,186 @@
+/**
+ * VectorStore — A lightweight, JSON-based vector index with cosine similarity search.
+ *
+ * Stores embeddings as `{ id, vector, metadata }` entries in a single JSON file.
+ * No external dependencies — uses only Node.js built-in fs and crypto.
+ *
+ * File location: ~/.buff/memory/vectors.json
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+// ─── Constants ──────────────────────────────────────────────────────────────
+const MEMORY_DIR = join(homedir(), '.buff', 'memory');
+const INDEX_PATH = join(MEMORY_DIR, 'vectors.json');
+/**
+ * Schema version for the vector index.
+ * Version 2: Increased embedding dimensionality from 64 to 384 (all-MiniLM-L6-v2).
+ * Old version 1 entries (64-dim) are incompatible and will be cleared.
+ */
+const CURRENT_VERSION = 2;
+// ─── Helpers ────────────────────────────────────────────────────────────────
+function ensureDir() {
+    if (!existsSync(MEMORY_DIR)) {
+        mkdirSync(MEMORY_DIR, { recursive: true });
+    }
+}
+function readIndex() {
+    try {
+        ensureDir();
+        if (!existsSync(INDEX_PATH)) {
+            return { entries: {}, version: CURRENT_VERSION };
+        }
+        const raw = readFileSync(INDEX_PATH, 'utf-8');
+        const data = JSON.parse(raw);
+        // Version migration: if the on-disk version doesn't match the current
+        // schema version, clear old entries to prevent incompatible vectors
+        // (e.g., 64-dim → 384-dim migration) from returning similarity=0 silently.
+        if (data.version !== CURRENT_VERSION) {
+            return { entries: {}, version: CURRENT_VERSION };
+        }
+        return data;
+    }
+    catch {
+        return { entries: {}, version: CURRENT_VERSION };
+    }
+}
+function writeIndex(data) {
+    ensureDir();
+    writeFileSync(INDEX_PATH, JSON.stringify(data, null, 2), 'utf-8');
+}
+// ─── Vector Math ────────────────────────────────────────────────────────────
+/** Compute the dot product of two vectors */
+function dotProduct(a, b) {
+    let sum = 0;
+    for (let i = 0; i < a.length; i++) {
+        sum += a[i] * b[i];
+    }
+    return sum;
+}
+/** Compute the L2 norm (magnitude) of a vector */
+function magnitude(v) {
+    let sum = 0;
+    for (const val of v) {
+        sum += val * val;
+    }
+    return Math.sqrt(sum);
+}
+/**
+ * Compute cosine similarity between two vectors.
+ * Returns a value between -1 and 1 (higher = more similar).
+ */
+export function cosineSimilarity(a, b) {
+    if (a.length !== b.length)
+        return 0;
+    const dot = dotProduct(a, b);
+    const magA = magnitude(a);
+    const magB = magnitude(b);
+    if (magA === 0 || magB === 0)
+        return 0;
+    return dot / (magA * magB);
+}
+// ─── VectorStore ────────────────────────────────────────────────────────────
+/**
+ * Lightweight vector store for semantic search.
+ *
+ * Usage:
+ * ```ts
+ * const store = new VectorStore();
+ * await store.insert("traj-001", [0.1, 0.2, ...], { goal: "add auth" });
+ * const results = await store.search([0.15, 0.25, ...], 3);
+ * ```
+ */
+export class VectorStore {
+    /**
+     * Insert a vector entry into the index.
+     * If an entry with the same `id` already exists, it is overwritten.
+     */
+    async insert(id, vector, metadata = {}) {
+        const data = readIndex();
+        data.entries[id] = {
+            id,
+            vector,
+            metadata,
+            createdAt: Date.now(),
+        };
+        writeIndex(data);
+    }
+    /**
+     * Retrieve a single entry by ID.
+     */
+    async get(id) {
+        const data = readIndex();
+        return data.entries[id] || null;
+    }
+    /**
+     * Remove an entry from the index.
+     */
+    async delete(id) {
+        const data = readIndex();
+        if (!data.entries[id])
+            return false;
+        delete data.entries[id];
+        writeIndex(data);
+        return true;
+    }
+    /**
+     * Search for the top-k most similar entries to the query vector.
+     * Returns results sorted by similarity (highest first).
+     */
+    async search(queryVector, k = 5, filterFn) {
+        const data = readIndex();
+        const entries = Object.values(data.entries);
+        // Compute similarities
+        const scored = [];
+        for (const entry of entries) {
+            if (filterFn && !filterFn(entry))
+                continue;
+            const sim = cosineSimilarity(queryVector, entry.vector);
+            scored.push({ entry, similarity: sim });
+        }
+        // Sort by similarity descending, take top-k
+        scored.sort((a, b) => b.similarity - a.similarity);
+        return scored.slice(0, k);
+    }
+    /**
+     * Get the total number of stored entries.
+     */
+    async count() {
+        const data = readIndex();
+        return Object.keys(data.entries).length;
+    }
+    /**
+     * Clear all entries from the index.
+     */
+    async clear() {
+        writeIndex({ entries: {}, version: CURRENT_VERSION });
+    }
+    /**
+     * Get all entries (for iteration/export).
+     */
+    async getAll() {
+        const data = readIndex();
+        return Object.values(data.entries);
+    }
+    /**
+     * Get vector store statistics.
+     */
+    stats() {
+        const data = readIndex();
+        const entries = Object.values(data.entries);
+        const dimensions = entries.length > 0 ? entries[0].vector.length : 0;
+        return {
+            totalEntries: entries.length,
+            dimensions,
+        };
+    }
+}
+// Singleton instance
+let storeInstance = null;
+export function getVectorStore() {
+    if (!storeInstance) {
+        storeInstance = new VectorStore();
+    }
+    return storeInstance;
+}
+//# sourceMappingURL=vector-store.js.map

package/dist/memory/vector-store.js.map

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

package/dist/plugins/agent-plugin.d.ts

@@ -0,0 +1,73 @@
+/**
+ * AgentPlugin — Interface for third-party agent plugins and auto-discovery.
+ *
+ * Users can place agent plugin files in ~/.buff/agents/ and they will be
+ * automatically discovered and registered with the orchestrator at startup.
+ *
+ * Provider plugins (inference providers):
+ * - Any .js file in ~/.buff/plugins/
+ * - Must export a default object matching the ProviderPlugin interface
+ *
+ * Agent plugins (agent extensions):
+ * - Any .js file in ~/.buff/agents/
+ * - Must export a default object matching the AgentPlugin interface
+ *
+ * Workflow plugins:
+ * - Any .yaml, .yml, or .json file in ~/.buff/workflows/
+ * - Defines a sequence of agent steps as a reusable workflow template
+ */
+import type { AgentContext, AgentResult } from '../agents/agent.js';
+import type { WorkflowTemplate } from '../workflow/templates.js';
+export interface AgentPluginMetadata {
+    name: string;
+    version: string;
+    description: string;
+    author?: string;
+    /** Which agent types this plugin can act as (e.g., ['writer', 'reviewer']) */
+    agentTypes: string[];
+}
+export interface AgentPlugin {
+    metadata: AgentPluginMetadata;
+    execute(context: AgentContext, callLLM: (prompt: string) => Promise<string>): Promise<AgentResult>;
+}
+/**
+ * Scan ~/.buff/plugins/ for provider plugin .js files and register them
+ * with the global PluginRegistry.
+ *
+ * Each file must export a default object matching the ProviderPlugin interface
+ * from ./registry.js. Upon discovery, the plugin is automatically registered
+ * so it can be used with: buff chat --provider <plugin-type>
+ *
+ * Returns the number of successfully loaded provider plugins.
+ */
+export declare function discoverProviderPlugins(): Promise<number>;
+/**
+ * Scan ~/.buff/agents/ for plugin .js files and load them.
+ * Returns a map of agent type → AgentPlugin.
+ */
+export declare function discoverAgentPlugins(): Promise<Map<string, AgentPlugin>>;
+/**
+ * Scan ~/.buff/workflows/ for custom workflow template files.
+ * Supports .json, .yaml, and .yml files.
+ */
+export declare function discoverWorkflowPlugins(): WorkflowTemplate[];
+/**
+ * Get plugin statistics.
+ */
+export declare function getPluginStats(): {
+    providerPlugins: number;
+    agentPlugins: number;
+    workflowPlugins: number;
+};
+/**
+ * Run all auto-discovery scanners at startup.
+ * Called once when the CLI boots up.
+ *
+ * @returns Summary of discovered plugins
+ */
+export declare function runAutoDiscovery(): Promise<{
+    providerPlugins: number;
+    agentPlugins: number;
+    workflowPlugins: number;
+}>;
+//# sourceMappingURL=agent-plugin.d.ts.map

package/dist/plugins/agent-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-plugin.d.ts","sourceRoot":"","sources":["../../src/plugins/agent-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAQjE,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACpG;AAmBD;;;;;;;;;GASG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,MAAM,CAAC,CAiC/D;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAiC9E;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,gBAAgB,EAAE,CAkC5D;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI;IAAE,eAAe,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CA0B3G;AAID;;;;;GAKG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC;IAChD,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC,CAWD"}

package/dist/plugins/agent-plugin.js

@@ -0,0 +1,199 @@
+/**
+ * AgentPlugin — Interface for third-party agent plugins and auto-discovery.
+ *
+ * Users can place agent plugin files in ~/.buff/agents/ and they will be
+ * automatically discovered and registered with the orchestrator at startup.
+ *
+ * Provider plugins (inference providers):
+ * - Any .js file in ~/.buff/plugins/
+ * - Must export a default object matching the ProviderPlugin interface
+ *
+ * Agent plugins (agent extensions):
+ * - Any .js file in ~/.buff/agents/
+ * - Must export a default object matching the AgentPlugin interface
+ *
+ * Workflow plugins:
+ * - Any .yaml, .yml, or .json file in ~/.buff/workflows/
+ * - Defines a sequence of agent steps as a reusable workflow template
+ */
+import { readdirSync, existsSync, mkdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { isValidWorkflowTemplate } from '../workflow/templates.js';
+import { getPluginRegistry } from './registry.js';
+import { logger } from '../utils/logger.js';
+// ─── Paths ──────────────────────────────────────────────────────────────────
+const BUFF_DIR = join(homedir(), '.buff');
+const PLUGINS_DIR = join(BUFF_DIR, 'plugins');
+const AGENTS_DIR = join(BUFF_DIR, 'agents');
+const WORKFLOWS_DIR = join(BUFF_DIR, 'workflows');
+function ensureDirectories() {
+    for (const dir of [PLUGINS_DIR, AGENTS_DIR, WORKFLOWS_DIR]) {
+        if (!existsSync(dir)) {
+            try {
+                mkdirSync(dir, { recursive: true });
+            }
+            catch { /* best-effort */ }
+        }
+    }
+}
+// ─── Auto-Discovery ─────────────────────────────────────────────────────────
+/**
+ * Scan ~/.buff/plugins/ for provider plugin .js files and register them
+ * with the global PluginRegistry.
+ *
+ * Each file must export a default object matching the ProviderPlugin interface
+ * from ./registry.js. Upon discovery, the plugin is automatically registered
+ * so it can be used with: buff chat --provider <plugin-type>
+ *
+ * Returns the number of successfully loaded provider plugins.
+ */
+export async function discoverProviderPlugins() {
+    ensureDirectories();
+    let loaded = 0;
+    try {
+        const files = readdirSync(PLUGINS_DIR).filter((f) => f.endsWith('.js'));
+        for (const file of files) {
+            try {
+                const pluginPath = join(PLUGINS_DIR, file);
+                // Dynamic import for ESM compatibility
+                const mod = await import(pluginPath);
+                if (!mod.default || !mod.default.metadata || !mod.default.getProviderType) {
+                    logger.debug(`Skipping ${file}: missing ProviderPlugin interface (need metadata + getProviderType)`);
+                    continue;
+                }
+                const plugin = mod.default;
+                const type = plugin.getProviderType();
+                const registry = getPluginRegistry();
+                registry.register(plugin);
+                loaded++;
+                logger.success(`Auto-discovered provider plugin: ${plugin.metadata.name} v${plugin.metadata.version} (${type})`);
+            }
+            catch (err) {
+                logger.debug(`Failed to load provider plugin ${file}: ${err}`);
+            }
+        }
+    }
+    catch (err) {
+        logger.debug(`Failed to scan ${PLUGINS_DIR}: ${err}`);
+    }
+    return loaded;
+}
+/**
+ * Scan ~/.buff/agents/ for plugin .js files and load them.
+ * Returns a map of agent type → AgentPlugin.
+ */
+export async function discoverAgentPlugins() {
+    const plugins = new Map();
+    ensureDirectories();
+    try {
+        const files = readdirSync(AGENTS_DIR).filter((f) => f.endsWith('.js'));
+        for (const file of files) {
+            try {
+                const pluginPath = join(AGENTS_DIR, file);
+                // Dynamic import for ESM compatibility
+                const plugin = await import(pluginPath);
+                if (!plugin.default || !plugin.default.metadata) {
+                    logger.debug(`Skipping ${file}: missing metadata or default export`);
+                    continue;
+                }
+                const agentPlugin = plugin.default;
+                for (const agentType of agentPlugin.metadata.agentTypes) {
+                    plugins.set(agentType, agentPlugin);
+                    logger.success(`Discovered agent plugin: ${agentPlugin.metadata.name} v${agentPlugin.metadata.version} (${agentType})`);
+                }
+            }
+            catch (err) {
+                logger.debug(`Failed to load plugin ${file}: ${err}`);
+            }
+        }
+    }
+    catch (err) {
+        logger.debug(`Failed to scan ${AGENTS_DIR}: ${err}`);
+    }
+    return plugins;
+}
+/**
+ * Scan ~/.buff/workflows/ for custom workflow template files.
+ * Supports .json, .yaml, and .yml files.
+ */
+export function discoverWorkflowPlugins() {
+    const workflows = [];
+    ensureDirectories();
+    try {
+        const files = readdirSync(WORKFLOWS_DIR).filter((f) => f.endsWith('.json') || f.endsWith('.yaml') || f.endsWith('.yml'));
+        for (const file of files) {
+            try {
+                const filePath = join(WORKFLOWS_DIR, file);
+                const content = readFileSync(filePath, 'utf-8');
+                if (file.endsWith('.json')) {
+                    const parsed = JSON.parse(content);
+                    if (isValidWorkflowTemplate(parsed)) {
+                        workflows.push(parsed);
+                        logger.success(`Discovered workflow template: ${parsed.id} (${file})`);
+                    }
+                }
+                else {
+                    // YAML not available as dependency — skip, or use Node.js built-in
+                    logger.debug(`YAML workflow files not yet supported (${file}). Use .json format instead.`);
+                }
+            }
+            catch (err) {
+                logger.debug(`Failed to load workflow ${file}: ${err}`);
+            }
+        }
+    }
+    catch (err) {
+        logger.debug(`Failed to scan ${WORKFLOWS_DIR}: ${err}`);
+    }
+    return workflows;
+}
+/**
+ * Get plugin statistics.
+ */
+export function getPluginStats() {
+    let providerPlugins = 0;
+    let agentPlugins = 0;
+    let workflowPlugins = 0;
+    try {
+        if (existsSync(PLUGINS_DIR)) {
+            providerPlugins = readdirSync(PLUGINS_DIR).filter((f) => f.endsWith('.js')).length;
+        }
+    }
+    catch { /* */ }
+    try {
+        if (existsSync(AGENTS_DIR)) {
+            agentPlugins = readdirSync(AGENTS_DIR).filter((f) => f.endsWith('.js')).length;
+        }
+    }
+    catch { /* */ }
+    try {
+        if (existsSync(WORKFLOWS_DIR)) {
+            workflowPlugins = readdirSync(WORKFLOWS_DIR).filter((f) => f.endsWith('.json') || f.endsWith('.yaml') || f.endsWith('.yml')).length;
+        }
+    }
+    catch { /* */ }
+    return { providerPlugins, agentPlugins, workflowPlugins };
+}
+// ─── Startup Integration ────────────────────────────────────────────────────
+/**
+ * Run all auto-discovery scanners at startup.
+ * Called once when the CLI boots up.
+ *
+ * @returns Summary of discovered plugins
+ */
+export async function runAutoDiscovery() {
+    const providerCount = await discoverProviderPlugins();
+    await discoverAgentPlugins(); // Agent plugins stored in map, not counted here
+    const workflowPlugins = discoverWorkflowPlugins();
+    const stats = getPluginStats();
+    return {
+        providerPlugins: stats.providerPlugins,
+        agentPlugins: stats.agentPlugins,
+        workflowPlugins: stats.workflowPlugins,
+    };
+}
+// ─── Validation ─────────────────────────────────────────────────────────────
+// Note: isValidWorkflowTemplate is imported from '../workflow/templates.js'
+// to avoid duplicating the validation logic.
+//# sourceMappingURL=agent-plugin.js.map

package/dist/plugins/agent-plugin.js.map

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

package/dist/plugins/registry.d.ts

@@ -0,0 +1,61 @@
+import { InferenceProvider } from '../inference/interface.js';
+import { ProviderConfig } from '../config/types.js';
+/**
+ * Plugin metadata
+ */
+export interface PluginMetadata {
+    name: string;
+    version: string;
+    description: string;
+    author?: string;
+}
+/**
+ * Plugin interface for extending Buff with custom providers
+ */
+export interface ProviderPlugin {
+    metadata: PluginMetadata;
+    /**
+     * Create an inference provider instance from this plugin
+     */
+    createProvider(config: ProviderConfig): InferenceProvider;
+    /**
+     * Get the provider type identifier (e.g., 'my-custom-provider')
+     */
+    getProviderType(): string;
+}
+/**
+ * Plugin registry for managing provider plugins
+ */
+export declare class PluginRegistry {
+    private plugins;
+    /**
+     * Register a new provider plugin
+     */
+    register(plugin: ProviderPlugin): void;
+    /**
+     * Unregister a plugin
+     */
+    unregister(providerType: string): boolean;
+    /**
+     * Get a plugin by provider type
+     */
+    getPlugin(providerType: string): ProviderPlugin | undefined;
+    /**
+     * Get all registered plugins
+     */
+    getAllPlugins(): ProviderPlugin[];
+    /**
+     * Check if a provider type has a registered plugin
+     */
+    hasPlugin(providerType: string): boolean;
+    /**
+     * Create an inference provider from a plugin
+     */
+    createProviderFromPlugin(providerType: string, config: ProviderConfig): InferenceProvider;
+    /**
+     * List all registered plugins with their metadata
+     */
+    listPlugins(): PluginMetadata[];
+}
+export declare function getPluginRegistry(): PluginRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/plugins/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/plugins/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,cAAc,CAAC;IAEzB;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,iBAAiB,CAAC;IAE1D;;OAEG;IACH,eAAe,IAAI,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAA0C;IAEzD;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAWtC;;OAEG;IACH,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAIzC;;OAEG;IACH,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI3D;;OAEG;IACH,aAAa,IAAI,cAAc,EAAE;IAIjC;;OAEG;IACH,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAIxC;;OAEG;IACH,wBAAwB,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,iBAAiB;IAQzF;;OAEG;IACH,WAAW,IAAI,cAAc,EAAE;CAGhC;AAKD,wBAAgB,iBAAiB,IAAI,cAAc,CAKlD"}

package/dist/plugins/registry.js

@@ -0,0 +1,67 @@
+import { logger } from '../utils/logger.js';
+/**
+ * Plugin registry for managing provider plugins
+ */
+export class PluginRegistry {
+    plugins = new Map();
+    /**
+     * Register a new provider plugin
+     */
+    register(plugin) {
+        const type = plugin.getProviderType();
+        if (this.plugins.has(type)) {
+            logger.warn(`Overwriting existing plugin for provider type: ${type}`);
+        }
+        this.plugins.set(type, plugin);
+        logger.success(`Registered plugin: ${plugin.metadata.name} v${plugin.metadata.version}`);
+    }
+    /**
+     * Unregister a plugin
+     */
+    unregister(providerType) {
+        return this.plugins.delete(providerType);
+    }
+    /**
+     * Get a plugin by provider type
+     */
+    getPlugin(providerType) {
+        return this.plugins.get(providerType);
+    }
+    /**
+     * Get all registered plugins
+     */
+    getAllPlugins() {
+        return Array.from(this.plugins.values());
+    }
+    /**
+     * Check if a provider type has a registered plugin
+     */
+    hasPlugin(providerType) {
+        return this.plugins.has(providerType);
+    }
+    /**
+     * Create an inference provider from a plugin
+     */
+    createProviderFromPlugin(providerType, config) {
+        const plugin = this.plugins.get(providerType);
+        if (!plugin) {
+            throw new Error(`No plugin registered for provider type: ${providerType}`);
+        }
+        return plugin.createProvider(config);
+    }
+    /**
+     * List all registered plugins with their metadata
+     */
+    listPlugins() {
+        return this.getAllPlugins().map((p) => p.metadata);
+    }
+}
+// Singleton registry
+let registryInstance = null;
+export function getPluginRegistry() {
+    if (!registryInstance) {
+        registryInstance = new PluginRegistry();
+    }
+    return registryInstance;
+}
+//# sourceMappingURL=registry.js.map

package/dist/plugins/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/plugins/registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AA6B5C;;GAEG;AACH,MAAM,OAAO,cAAc;IACjB,OAAO,GAAgC,IAAI,GAAG,EAAE,CAAC;IAEzD;;OAEG;IACH,QAAQ,CAAC,MAAsB;QAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC;QAEtC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,kDAAkD,IAAI,EAAE,CAAC,CAAC;QACxE,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC/B,MAAM,CAAC,OAAO,CAAC,sBAAsB,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,YAAoB;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,YAAoB;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,YAAoB;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,wBAAwB,CAAC,YAAoB,EAAE,MAAsB;QACnE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,2CAA2C,YAAY,EAAE,CAAC,CAAC;QAC7E,CAAC;QACD,OAAO,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACrD,CAAC;CACF;AAED,qBAAqB;AACrB,IAAI,gBAAgB,GAA0B,IAAI,CAAC;AAEnD,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,gBAAgB,GAAG,IAAI,cAAc,EAAE,CAAC;IAC1C,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC"}

package/dist/sandbox/images.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Sandbox images — Pre-defined Docker images for common programming languages.
+ *
+ * These are used as base images for sandbox containers. Each image definition
+ * includes the Docker image name, language/runtime details, and default
+ * install/test commands.
+ *
+ * Images are pulled on first use if not present locally.
+ */
+import type { SandboxImage } from './types.js';
+/**
+ * Pre-defined sandbox images for common runtimes.
+ */
+export declare const BUILTIN_SANDBOX_IMAGES: SandboxImage[];
+/**
+ * Find a built-in sandbox image by language/runtime name (case-insensitive).
+ *
+ * Examples:
+ *   resolveSandboxImage('node')        → node:20-slim
+ *   resolveSandboxImage('python')      → python:3.12-slim
+ *   resolveSandboxImage('go')          → golang:1.22
+ *   resolveSandboxImage('golang')      → golang:1.22
+ *   resolveSandboxImage('rust')        → rust:1.77-slim
+ */
+export declare function resolveSandboxImage(runtime: string): SandboxImage | undefined;
+/**
+ * Get the default sandbox image based on detected project type.
+ * Checks for common project files to determine runtime.
+ */
+export declare function detectProjectImage(projectDir: string): SandboxImage;
+//# sourceMappingURL=images.d.ts.map

package/dist/sandbox/images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.d.ts","sourceRoot":"","sources":["../../src/sandbox/images.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,YAAY,EA0EhD,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAsB7E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,CASnE"}