infinicode 1.0.0 → 2.0.0

package/dist/kernel/free-providers.js

@@ -0,0 +1,162 @@
+export const FREE_PROVIDERS = [
+    {
+        id: 'groq',
+        name: 'Groq',
+        baseURL: 'https://api.groq.com/openai',
+        keyUrl: 'https://console.groq.com/keys',
+        free: true,
+        recommended: {
+            coding: ['llama-3.3-70b-versatile', 'qwen-2.5-coder-32b'],
+            research: ['llama-3.3-70b-versatile'],
+            architecture: ['llama-3.3-70b-versatile'],
+            review: ['llama-3.3-70b-versatile'],
+            documentation: ['llama-3.3-70b-versatile', 'llama-3.1-8b-instant'],
+            translation: ['llama-3.3-70b-versatile'],
+            terminal: ['llama-3.3-70b-versatile'],
+            verification: ['llama-3.3-70b-versatile'],
+        },
+        knownModels: [
+            // maxRequestTokens ≈ free-tier TPM — far below context window; a request
+            // over this is rejected ("request too large") even though ctx is 128k.
+            { id: 'llama-3.3-70b-versatile', name: 'Llama 3.3 70B', contextLength: 128_000, maxRequestTokens: 12_000, capabilities: ['reasoning', 'coding'], supportsFunctionCalling: true },
+            { id: 'llama-3.1-8b-instant', name: 'Llama 3.1 8B Instant', contextLength: 128_000, maxRequestTokens: 6_000, capabilities: ['reasoning'], supportsFunctionCalling: true },
+            { id: 'qwen-2.5-coder-32b', name: 'Qwen 2.5 Coder 32B', contextLength: 128_000, maxRequestTokens: 12_000, capabilities: ['coding', 'reasoning'], supportsFunctionCalling: true },
+            { id: 'mixtral-8x7b-32768', name: 'Mixtral 8x7B', contextLength: 32_768, maxRequestTokens: 5_000, capabilities: ['reasoning'], supportsFunctionCalling: true },
+        ],
+        notes: 'Fastest cloud inference. Free tier has low per-minute token limits (small requests only).',
+    },
+    {
+        id: 'openrouter',
+        name: 'OpenRouter',
+        baseURL: 'https://openrouter.ai/api/v1',
+        keyUrl: 'https://openrouter.ai/keys',
+        free: true,
+        recommended: {
+            coding: ['qwen/qwen2.5-coder-32b-instruct:free', 'deepseek/deepseek-coder-v2:free'],
+            research: ['meta-llama/llama-3.3-70b-instruct:free'],
+            architecture: ['meta-llama/llama-3.3-70b-instruct:free', 'deepseek/deepseek-r1:free'],
+            review: ['meta-llama/llama-3.3-70b-instruct:free'],
+            documentation: ['meta-llama/llama-3.3-70b-instruct:free'],
+            translation: ['meta-llama/llama-3.3-70b-instruct:free'],
+            terminal: ['meta-llama/llama-3.3-70b-instruct:free'],
+            verification: ['meta-llama/llama-3.3-70b-instruct:free'],
+            vision: ['meta-llama/llama-3.2-90b-vision-instruct:free'],
+        },
+        knownModels: [
+            { id: 'qwen/qwen2.5-coder-32b-instruct:free', name: 'Qwen 2.5 Coder 32B (free)', contextLength: 32_768, capabilities: ['coding', 'reasoning'] },
+            { id: 'deepseek/deepseek-coder-v2:free', name: 'DeepSeek Coder V2 (free)', contextLength: 128_000, capabilities: ['coding', 'reasoning'] },
+            { id: 'meta-llama/llama-3.3-70b-instruct:free', name: 'Llama 3.3 70B (free)', contextLength: 65_536, capabilities: ['reasoning'] },
+            { id: 'deepseek/deepseek-r1:free', name: 'DeepSeek R1 (free)', contextLength: 128_000, capabilities: ['reasoning'] },
+            { id: 'meta-llama/llama-3.2-90b-vision-instruct:free', name: 'Llama 3.2 90B Vision (free)', contextLength: 131_072, capabilities: ['vision', 'reasoning'], supportsVision: true },
+        ],
+        notes: 'Aggregator — many free variants of leading models. Best variety for rotation.',
+    },
+    {
+        id: 'github',
+        name: 'GitHub Models',
+        baseURL: 'https://models.inference.ai.azure.com',
+        keyUrl: 'https://github.com/settings/tokens',
+        free: true,
+        recommended: {
+            coding: ['gpt-4o-mini', 'Mistral-large'],
+            research: ['gpt-4o-mini', 'Llama-3.3-70B-Instruct'],
+            architecture: ['gpt-4o', 'Llama-3.3-70B-Instruct'],
+            review: ['gpt-4o-mini'],
+            documentation: ['gpt-4o-mini'],
+            translation: ['gpt-4o-mini'],
+            terminal: ['gpt-4o-mini'],
+            verification: ['gpt-4o'],
+            vision: ['gpt-4o'],
+        },
+        knownModels: [
+            // GitHub Models free tier caps request size well below the context window.
+            { id: 'gpt-4o', name: 'GPT-4o', contextLength: 128_000, maxRequestTokens: 8_000, capabilities: ['reasoning', 'coding', 'vision'], supportsVision: true },
+            { id: 'gpt-4o-mini', name: 'GPT-4o mini', contextLength: 128_000, maxRequestTokens: 8_000, capabilities: ['reasoning', 'coding', 'vision'], supportsVision: true },
+            { id: 'Mistral-large', name: 'Mistral Large', contextLength: 131_072, maxRequestTokens: 8_000, capabilities: ['reasoning', 'coding'] },
+            { id: 'Llama-3.3-70B-Instruct', name: 'Llama 3.3 70B', contextLength: 131_072, capabilities: ['reasoning', 'coding'] },
+        ],
+        notes: 'Use a GitHub Personal Access Token (no scopes needed). Free while in preview.',
+    },
+    {
+        id: 'nvidia',
+        name: 'NVIDIA NIM',
+        baseURL: 'https://integrate.api.nvidia.com/v1',
+        keyUrl: 'https://build.nvidia.com',
+        free: true,
+        recommended: {
+            coding: ['qwen/qwen2.5-coder-32b-instruct', 'deepseek-ai/deepseek-coder-v2'],
+            research: ['meta/llama-3.3-70b-instruct'],
+            architecture: ['meta/llama-3.3-70b-instruct'],
+            review: ['meta/llama-3.3-70b-instruct'],
+            documentation: ['meta/llama-3.1-8b-instruct'],
+            translation: ['meta/llama-3.3-70b-instruct'],
+            terminal: ['meta/llama-3.1-8b-instruct'],
+            verification: ['meta/llama-3.3-70b-instruct'],
+        },
+        knownModels: [
+            { id: 'meta/llama-3.3-70b-instruct', name: 'Llama 3.3 70B', contextLength: 256_000, capabilities: ['reasoning'] },
+            { id: 'meta/llama-3.1-8b-instruct', name: 'Llama 3.1 8B', contextLength: 128_000, capabilities: ['reasoning'] },
+            { id: 'qwen/qwen2.5-coder-32b-instruct', name: 'Qwen 2.5 Coder 32B', contextLength: 32_768, capabilities: ['coding', 'reasoning'] },
+            { id: 'deepseek-ai/deepseek-coder-v2', name: 'DeepSeek Coder V2', contextLength: 128_000, capabilities: ['coding', 'reasoning'] },
+        ],
+        notes: 'NVIDIA build.nvidia.com offers free NIM endpoints. 1000 req/month free tier.',
+    },
+    {
+        id: 'hf',
+        name: 'Hugging Face Inference',
+        // OpenAI-compatible router (the legacy api-inference.huggingface.co host no
+        // longer serves /v1/chat/completions).
+        baseURL: 'https://router.huggingface.co/v1',
+        keyUrl: 'https://huggingface.co/settings/tokens',
+        free: true,
+        recommended: {
+            coding: ['Qwen/Qwen2.5-Coder-32B-Instruct'],
+            research: ['meta-llama/Llama-3.3-70B-Instruct'],
+            documentation: ['meta-llama/Llama-3.1-8B-Instruct'],
+            translation: ['meta-llama/Llama-3.3-70B-Instruct'],
+        },
+        knownModels: [
+            { id: 'Qwen/Qwen2.5-Coder-32B-Instruct', name: 'Qwen 2.5 Coder 32B', contextLength: 32_768, capabilities: ['coding', 'reasoning'] },
+            { id: 'meta-llama/Llama-3.3-70B-Instruct', name: 'Llama 3.3 70B', contextLength: 131_072, capabilities: ['reasoning'] },
+            { id: 'meta-llama/Llama-3.1-8B-Instruct', name: 'Llama 3.1 8B', contextLength: 128_000, capabilities: ['reasoning'] },
+        ],
+        notes: 'HF Inference API. Free tier with rate limits. Best for fill-in coverage.',
+    },
+    {
+        id: 'gemini',
+        name: 'Google Gemini',
+        baseURL: 'https://generativelanguage.googleapis.com/v1beta',
+        keyUrl: 'https://aistudio.google.com/app/apikey',
+        free: true,
+        recommended: {
+            coding: ['gemini-2.0-flash', 'gemini-1.5-pro'],
+            research: ['gemini-2.0-flash'],
+            architecture: ['gemini-1.5-pro'],
+            review: ['gemini-2.0-flash'],
+            documentation: ['gemini-2.0-flash'],
+            translation: ['gemini-2.0-flash'],
+            terminal: ['gemini-2.0-flash'],
+            verification: ['gemini-1.5-pro'],
+            vision: ['gemini-2.0-flash'],
+        },
+        knownModels: [
+            { id: 'gemini-2.0-flash', name: 'Gemini 2.0 Flash', contextLength: 1_048_576, capabilities: ['reasoning', 'coding', 'vision'], supportsVision: true, supportsFunctionCalling: true },
+            { id: 'gemini-1.5-pro', name: 'Gemini 1.5 Pro', contextLength: 2_097_152, capabilities: ['reasoning', 'coding', 'vision'], supportsVision: true, supportsFunctionCalling: true },
+            { id: 'gemini-1.5-flash', name: 'Gemini 1.5 Flash', contextLength: 1_048_576, capabilities: ['reasoning', 'vision'], supportsVision: true, supportsFunctionCalling: true },
+        ],
+        notes: 'Google Generative Language API. Free tier (15 RPM / 1500 RPD on Flash). Long context.',
+    },
+];
+export function getProviderPreset(id) {
+    return FREE_PROVIDERS.find(p => p.id === id);
+}
+export function toCloudProviderConfig(preset, apiKey) {
+    return {
+        id: preset.id,
+        name: preset.name,
+        baseURL: preset.baseURL,
+        apiKey: apiKey || undefined,
+        headerName: preset.headerName,
+        enabled: true,
+    };
+}

package/dist/kernel/frontend-scoring.d.ts

@@ -0,0 +1,21 @@
+/**
+ * OpenKernel — Frontend Quality Scoring
+ *
+ * A deterministic, reproducible rubric that scores generated frontend code
+ * (HTML/CSS/JS) 0–100 across the dimensions that make a frontend feel
+ * production-grade: design tokens, themes, component breadth, accessibility,
+ * responsiveness, animation, performance, and cleanliness (no placeholders,
+ * no banned frameworks).
+ *
+ * This is the reliable half of the hybrid scorer; the LLM judge adds the
+ * subjective visual/UX verdict on top. On a miss, `feedback` gives the next
+ * attempt concrete, targeted fixes so the recovery loop converges.
+ */
+import type { FrontendAcceptance, FrontendScore } from './types.js';
+export declare const DEFAULT_FRONTEND_ACCEPTANCE: Required<Omit<FrontendAcceptance, 'bannedFrameworks'>> & {
+    bannedFrameworks: string[];
+};
+/**
+ * Score frontend code against acceptance criteria. Pure and deterministic.
+ */
+export declare function scoreFrontend(code: string, acceptance?: FrontendAcceptance): FrontendScore;

package/dist/kernel/frontend-scoring.js

@@ -0,0 +1,125 @@
+export const DEFAULT_FRONTEND_ACCEPTANCE = {
+    threshold: 85,
+    minComponents: 40,
+    minThemes: 4,
+    minTokens: 40,
+    bannedFrameworks: ['react', 'vue', 'angular', 'tailwind', 'bootstrap', 'jquery', 'svelte'],
+    requireDesignTokens: true,
+    requireResponsive: true,
+    requireAnimation: true,
+    requireAccessibility: true,
+    noPlaceholders: true,
+};
+const PLACEHOLDER_PATTERNS = [
+    /\bTODO\b/i,
+    /\bFIXME\b/i,
+    /lorem\s+ipsum/i,
+    /placeholder\s+(?:text|content|here)/i,
+    /coming\s+soon/i,
+    /your\s+(?:content|text)\s+here/i,
+    /\bXXX\b/,
+    /\.\.\.\s*$/m, // trailing ellipsis lines (unfinished sections)
+];
+// Detect a real framework dependency, not an incidental word in prose.
+function bannedFrameworkHits(code, banned) {
+    const lower = code.toLowerCase();
+    const hits = [];
+    for (const fw of banned) {
+        const patterns = [
+            new RegExp(`import[^;\\n]*['"\`][^'"\`]*${fw}[^'"\`]*['"\`]`, 'i'),
+            new RegExp(`from\\s+['"\`][^'"\`]*${fw}`, 'i'),
+            new RegExp(`(cdn|unpkg|jsdelivr)[^'"\`\\s]*${fw}`, 'i'),
+            new RegExp(`\\b${fw}\\.(min\\.)?(js|css)\\b`, 'i'),
+        ];
+        // Tailwind is detectable by its utility classes even without an import.
+        if (fw === 'tailwind') {
+            patterns.push(/class\s*=\s*["'][^"']*\b(?:flex|grid|pt-\d|px-\d|text-(?:sm|lg|xl)|bg-\w+-\d{3})\b[^"']*\bhover:/i);
+        }
+        if (patterns.some(p => p.test(lower) || p.test(code)))
+            hits.push(fw);
+    }
+    return hits;
+}
+function distinct(re, code) {
+    const set = new Set();
+    let m;
+    const g = new RegExp(re.source, re.flags.includes('g') ? re.flags : re.flags + 'g');
+    while ((m = g.exec(code)) !== null) {
+        set.add((m[1] ?? m[0]).toLowerCase());
+        if (m.index === g.lastIndex)
+            g.lastIndex++;
+    }
+    return set.size;
+}
+function ratio(actual, target) {
+    if (target <= 0)
+        return 1;
+    return Math.max(0, Math.min(1, actual / target));
+}
+/**
+ * Score frontend code against acceptance criteria. Pure and deterministic.
+ */
+export function scoreFrontend(code, acceptance) {
+    const acc = { ...DEFAULT_FRONTEND_ACCEPTANCE, ...(acceptance ?? {}) };
+    const src = code ?? '';
+    const items = [];
+    const feedback = [];
+    const add = (name, weight, earnedRatio, detail, tip) => {
+        const earned = Math.round(weight * Math.max(0, Math.min(1, earnedRatio)) * 100) / 100;
+        items.push({ name, weight, earned, detail });
+        if (earnedRatio < 0.999 && tip)
+            feedback.push(tip);
+    };
+    // 1. Design tokens (CSS custom properties). 15
+    const tokens = distinct(/--[a-z][\w-]*/i, src);
+    add('design-tokens', 15, ratio(tokens, acc.minTokens), `${tokens} custom properties (target ${acc.minTokens})`, `Define more design tokens as CSS custom properties (--color-*, --space-*, --radius-*); found ${tokens}, need ~${acc.minTokens}.`);
+    // 2. Tokens actually used via var(). 5
+    const varUses = (src.match(/var\(\s*--/g) ?? []).length;
+    add('token-usage', 5, ratio(varUses, acc.minTokens), `${varUses} var(--…) usages`, `Consume tokens with var(--…) throughout components instead of hard-coded values.`);
+    // 3. Themes. 10
+    const themes = distinct(/\[data-theme=["']?([\w-]+)/i, src) + distinct(/\.theme-([\w-]+)/i, src);
+    add('themes', 10, ratio(themes, acc.minThemes), `${themes} theme selectors (target ${acc.minThemes})`, `Add more runtime themes via [data-theme="…"] blocks; found ${themes}, need ${acc.minThemes}.`);
+    // 4. Component breadth (distinct class selectors as a proxy). 15
+    const components = distinct(/\.([a-z][\w-]{2,})\s*(?=[.,:#\s{>])/i, src);
+    add('components', 15, ratio(components, acc.minComponents), `${components} distinct component classes (target ${acc.minComponents})`, `Increase reusable component coverage; ~${components} classes found, target ${acc.minComponents}.`);
+    // 5. Accessibility. 12
+    const a11ySignals = [
+        /\baria-[a-z]+=/i, /\brole=/i, /\balt=/i, /:focus-visible/i,
+        /<(nav|main|header|footer|section|button|label)\b/i, /tabindex=/i,
+    ].filter(rx => rx.test(src)).length;
+    const a11y = a11ySignals / 6;
+    add('accessibility', 12, acc.requireAccessibility ? a11y : Math.max(a11y, 0.5), `${a11ySignals}/6 a11y signals`, `Improve accessibility: add ARIA attributes, roles, alt text, :focus-visible styles, and semantic elements.`);
+    // 6. Responsiveness. 8
+    const mediaQueries = (src.match(/@media/g) ?? []).length;
+    const fluid = /clamp\(|minmax\(|min\(|max\(/.test(src) ? 1 : 0;
+    const responsive = Math.min(1, mediaQueries / 3) * 0.7 + fluid * 0.3;
+    add('responsive', 8, acc.requireResponsive ? responsive : Math.max(responsive, 0.5), `${mediaQueries} @media, fluid=${!!fluid}`, `Add responsive breakpoints (@media) and fluid sizing (clamp/minmax).`);
+    // 7. Animation. 10
+    const keyframes = (src.match(/@keyframes/g) ?? []).length;
+    const transitions = /transition\s*:|animation\s*:/.test(src) ? 1 : 0;
+    const animation = Math.min(1, keyframes / 3) * 0.6 + transitions * 0.4;
+    add('animation', 10, acc.requireAnimation ? animation : Math.max(animation, 0.5), `${keyframes} @keyframes, transitions=${!!transitions}`, `Add an animation layer: @keyframes plus transition/animation on interactive states.`);
+    // 8. Performance hints. 5
+    const perfSignals = [
+        /will-change/i, /IntersectionObserver/i, /loading=["']lazy/i,
+        /requestAnimationFrame/i, /content-visibility/i,
+    ].filter(rx => rx.test(src)).length;
+    add('performance', 5, Math.min(1, perfSignals / 3), `${perfSignals} perf hints`, `Add performance techniques: IntersectionObserver reveals, will-change, lazy loading, rAF-driven animation.`);
+    // 9. No placeholders (hard gate). 10
+    const placeholderHit = acc.noPlaceholders ? PLACEHOLDER_PATTERNS.find(p => p.test(src)) : undefined;
+    add('no-placeholders', 10, placeholderHit ? 0 : 1, placeholderHit ? `placeholder detected (${placeholderHit.source})` : 'no placeholders', `Remove placeholder/TODO/lorem content and finish every section with real content.`);
+    // 10. No banned frameworks (hard gate). 10
+    const fwHits = bannedFrameworkHits(src, acc.bannedFrameworks);
+    add('no-banned-frameworks', 10, fwHits.length ? 0 : 1, fwHits.length ? `banned framework(s): ${fwHits.join(', ')}` : 'framework-independent', `Remove framework dependencies (${fwHits.join(', ')}); build with vanilla HTML/CSS/JS only.`);
+    const score = Math.round(items.reduce((s, i) => s + i.earned, 0));
+    const threshold = acc.threshold;
+    // Hard gates: any placeholder or banned framework fails regardless of score.
+    const gateFailed = !!placeholderHit || fwHits.length > 0 || src.trim().length === 0;
+    const passed = !gateFailed && score >= threshold;
+    if (src.trim().length === 0)
+        feedback.unshift('Output is empty — produce the frontend code.');
+    if (!passed && feedback.length === 0) {
+        feedback.push(`Raise overall quality to reach ${threshold}/100 (currently ${score}).`);
+    }
+    return { score, passed, threshold, items, feedback };
+}

package/dist/kernel/index.d.ts

@@ -0,0 +1,63 @@
+/**
+ * OpenKernel — Public API Entry Point
+ *
+ * Provider-agnostic AI execution kernel.
+ * Applications, harnesses, CLIs, bots all interact through this API.
+ */
+export * from './types.js';
+export { Kernel, createKernel } from './kernel.js';
+export type { KernelOptions } from './kernel.js';
+export { EventBus } from './event-bus.js';
+export { ProviderManager } from './provider-manager.js';
+export { CapabilityRouter } from './router.js';
+export { WorkerRuntime } from './worker-runtime.js';
+export type { WorkerContext, WorkerExecuteFn, WorkerHandler } from './worker-runtime.js';
+export { Scheduler } from './scheduler.js';
+export { CheckpointEngine } from './checkpoint-engine.js';
+export { MissionEngine } from './mission-engine.js';
+export { Orchestrator } from './orchestrator.js';
+export { PluginManager } from './plugin-manager.js';
+export { PolicyEngine, PolicyPresets, POLICY_FACTORIES } from './policies.js';
+export { VerificationEngine } from './verification-engine.js';
+export type { VerificationEngineDeps } from './verification-engine.js';
+export { RecoveryManager } from './recovery-manager.js';
+export type { RecoveryManagerDeps, RecoveryContext } from './recovery-manager.js';
+export { ConsoleLogger, SilentLogger } from './logger.js';
+export { OllamaProvider } from './providers/ollama-provider.js';
+export type { OllamaProviderOptions } from './providers/ollama-provider.js';
+export { OpenAICompatibleProvider } from './providers/openai-compatible-provider.js';
+export type { OpenAICompatibleOptions } from './providers/openai-compatible-provider.js';
+export { GeminiProvider } from './providers/gemini-provider.js';
+export type { GeminiProviderOptions } from './providers/gemini-provider.js';
+export { ALL_BUILTIN_WORKERS, createResearchWorker, createCodingWorker, createArchitectureWorker, createReviewWorker, createDocumentationWorker, createTranslationWorker, createTerminalWorker, createVerificationWorker, createVisionWorker, createFrontendWorker, createBrowserWorker, } from './workers/builtin-workers.js';
+export { KernelCommandRegistry, DEFAULT_COMMANDS } from './command-system.js';
+export type { KernelCommand, CommandContext } from './command-system.js';
+export * from './federation/index.js';
+export { createMcpServer, serveMcpStdio } from './mcp/index.js';
+export type { McpServerDeps } from './mcp/index.js';
+export { GoalLoop } from './autonomy/index.js';
+export type { Goal, GoalInput, GoalTrigger, GoalLoopDeps } from './autonomy/index.js';
+export { scoreFrontend, DEFAULT_FRONTEND_ACCEPTANCE } from './frontend-scoring.js';
+export { openAICompatBaseURL, openAICompatChatURL, openAICompatModelsURL } from './provider-url.js';
+export { createTelegramPlugin } from './plugins/telegram-plugin.js';
+export type { TelegramPluginOptions } from './plugins/telegram-plugin.js';
+export { createDiscordPlugin } from './plugins/discord-plugin.js';
+export type { DiscordPluginOptions } from './plugins/discord-plugin.js';
+export { createSlackPlugin } from './plugins/slack-plugin.js';
+export type { SlackPluginOptions } from './plugins/slack-plugin.js';
+export { createBrowserPlugin } from './plugins/browser-plugin.js';
+export type { BrowserPluginOptions } from './plugins/browser-plugin.js';
+export { BrowserController } from './browser/browser-controller.js';
+export type { BrowserAction, BrowserActionResult, BrowserControllerOptions } from './browser/browser-controller.js';
+export { createSearchPlugin } from './plugins/search-plugin.js';
+export type { SearchPluginOptions } from './plugins/search-plugin.js';
+export { SearchController } from './search/search-controller.js';
+export type { SearchOptions, SearchResult } from './search/search-controller.js';
+export { createDashboardPlugin } from './plugins/dashboard-plugin.js';
+export type { DashboardPluginOptions } from './plugins/dashboard-plugin.js';
+export { createMetricsPlugin } from './plugins/metrics-plugin.js';
+export type { MetricsSnapshot } from './plugins/metrics-plugin.js';
+export { definePlugin } from './sdk/plugin-sdk.js';
+export type { PluginBuilder } from './sdk/plugin-sdk.js';
+export { mission, taskInput, browserTaskInput, researchTaskInput, frontendTaskInput } from './sdk/harness-sdk.js';
+export type { MissionBuilder } from './sdk/harness-sdk.js';

package/dist/kernel/index.js

@@ -0,0 +1,45 @@
+/**
+ * OpenKernel — Public API Entry Point
+ *
+ * Provider-agnostic AI execution kernel.
+ * Applications, harnesses, CLIs, bots all interact through this API.
+ */
+export * from './types.js';
+export { Kernel, createKernel } from './kernel.js';
+export { EventBus } from './event-bus.js';
+export { ProviderManager } from './provider-manager.js';
+export { CapabilityRouter } from './router.js';
+export { WorkerRuntime } from './worker-runtime.js';
+export { Scheduler } from './scheduler.js';
+export { CheckpointEngine } from './checkpoint-engine.js';
+export { MissionEngine } from './mission-engine.js';
+export { Orchestrator } from './orchestrator.js';
+export { PluginManager } from './plugin-manager.js';
+export { PolicyEngine, PolicyPresets, POLICY_FACTORIES } from './policies.js';
+export { VerificationEngine } from './verification-engine.js';
+export { RecoveryManager } from './recovery-manager.js';
+export { ConsoleLogger, SilentLogger } from './logger.js';
+export { OllamaProvider } from './providers/ollama-provider.js';
+export { OpenAICompatibleProvider } from './providers/openai-compatible-provider.js';
+export { GeminiProvider } from './providers/gemini-provider.js';
+export { ALL_BUILTIN_WORKERS, createResearchWorker, createCodingWorker, createArchitectureWorker, createReviewWorker, createDocumentationWorker, createTranslationWorker, createTerminalWorker, createVerificationWorker, createVisionWorker, createFrontendWorker, createBrowserWorker, } from './workers/builtin-workers.js';
+export { KernelCommandRegistry, DEFAULT_COMMANDS } from './command-system.js';
+// Federation — neutral device mesh (peers, telemetry, config sync, MOLTFED interop)
+export * from './federation/index.js';
+// MCP — north-facing control surface (spawn/dispatch/role/voice/map over the mesh)
+export { createMcpServer, serveMcpStdio } from './mcp/index.js';
+// Autonomy — proactive unattended goal loop (interval/idle/once triggers)
+export { GoalLoop } from './autonomy/index.js';
+export { scoreFrontend, DEFAULT_FRONTEND_ACCEPTANCE } from './frontend-scoring.js';
+export { openAICompatBaseURL, openAICompatChatURL, openAICompatModelsURL } from './provider-url.js';
+export { createTelegramPlugin } from './plugins/telegram-plugin.js';
+export { createDiscordPlugin } from './plugins/discord-plugin.js';
+export { createSlackPlugin } from './plugins/slack-plugin.js';
+export { createBrowserPlugin } from './plugins/browser-plugin.js';
+export { BrowserController } from './browser/browser-controller.js';
+export { createSearchPlugin } from './plugins/search-plugin.js';
+export { SearchController } from './search/search-controller.js';
+export { createDashboardPlugin } from './plugins/dashboard-plugin.js';
+export { createMetricsPlugin } from './plugins/metrics-plugin.js';
+export { definePlugin } from './sdk/plugin-sdk.js';
+export { mission, taskInput, browserTaskInput, researchTaskInput, frontendTaskInput } from './sdk/harness-sdk.js';

package/dist/kernel/kernel.d.ts

@@ -0,0 +1,75 @@
+/**
+ * OpenKernel — Public Kernel API
+ *
+ * kernel.execute() / pause() / resume() / cancel() / status()
+ * kernel.subscribe() / registerWorker() / registerProvider()
+ * kernel.registerPlugin() / registerPolicy()
+ *
+ * This is the single entry point. Harnesses, CLIs, n8n, bots all go through here.
+ */
+import { EventBus } from './event-bus.js';
+import { ProviderManager } from './provider-manager.js';
+import { CapabilityRouter } from './router.js';
+import { WorkerRuntime } from './worker-runtime.js';
+import { Scheduler } from './scheduler.js';
+import { CheckpointEngine } from './checkpoint-engine.js';
+import { MissionEngine } from './mission-engine.js';
+import { Orchestrator } from './orchestrator.js';
+import { PluginManager } from './plugin-manager.js';
+import { PolicyEngine } from './policies.js';
+import { VerificationEngine } from './verification-engine.js';
+import { RecoveryManager } from './recovery-manager.js';
+import { KernelCommandRegistry } from './command-system.js';
+import type { CommandResult, EventHandler, KernelEvent, KernelEventType, KernelLike, Logger, Mission, MissionInput, Plugin, Policy, ProviderInterface, WorkerDefinition, MissionStatus } from './types.js';
+export interface KernelOptions {
+    logger?: Logger;
+    storageDir?: string;
+    loadBuiltinWorkers?: boolean;
+}
+export declare class Kernel implements KernelLike {
+    readonly eventBus: EventBus;
+    readonly providerManager: ProviderManager;
+    readonly router: CapabilityRouter;
+    readonly workerRuntime: WorkerRuntime;
+    readonly scheduler: Scheduler;
+    readonly checkpoints: CheckpointEngine;
+    readonly missionEngine: MissionEngine;
+    readonly orchestrator: Orchestrator;
+    readonly plugins: PluginManager;
+    readonly policies: PolicyEngine;
+    readonly verification: VerificationEngine;
+    readonly recovery: RecoveryManager;
+    readonly logger: Logger;
+    /** Canonical OpenKernel slash-command surface (/status, /workers, /goal …). */
+    readonly commands: KernelCommandRegistry;
+    private missions;
+    constructor(options?: KernelOptions);
+    execute(input: MissionInput): Promise<Mission>;
+    pause(missionId: string): Promise<void>;
+    resume(missionId: string): Promise<Mission>;
+    cancel(missionId: string): Promise<void>;
+    status(missionId: string): Promise<MissionStatus>;
+    /**
+     * Execute a canonical OpenKernel slash-command (e.g. "/status", "/goal build X").
+     * The same registry backs the CLI console and the notification plugins.
+     */
+    command(input: string): Promise<CommandResult>;
+    /** Reset a mission's failed/skipped tasks and re-run them. */
+    retry(missionId: string): Promise<Mission>;
+    subscribe(types: KernelEventType[], handler: EventHandler): () => void;
+    subscribeAll(handler: EventHandler): () => void;
+    registerWorker(definition: WorkerDefinition): void;
+    registerProvider(providerId: string, provider: ProviderInterface): void;
+    registerPlugin(plugin: Plugin): Promise<void>;
+    registerPolicy(policy: Policy): void;
+    /** Set the default policy used for routing when a mission doesn't specify one. */
+    setDefaultPolicy(name: Policy['name']): void;
+    getMission(missionId: string): Mission | undefined;
+    listMissions(): Mission[];
+    /** Emit a NOTIFICATION event that plugins (Telegram/Discord/Slack) can consume. */
+    notify(message: string, missionId?: string): void;
+    listPlugins(): Plugin[];
+    getEventHistory(): KernelEvent[];
+    destroy(): void;
+}
+export declare function createKernel(options?: KernelOptions): Kernel;