npm - infinicode - Versions diffs - 1.0.0 → 2.1.0 - Mend

infinicode 1.0.0 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (159) hide show

package/.opencode/plugins/home-logo-animation.tsx +120 -0
package/.opencode/plugins/routing-mode-display.tsx +135 -0
package/.opencode/themes/infinibot-gold.json +222 -0
package/.opencode/tui.json +8 -0
package/README.md +564 -72
package/dist/ascii-video-animation.d.ts +2 -0
package/dist/ascii-video-animation.js +243 -0
package/dist/cli.js +199 -50
package/dist/commands/console.d.ts +6 -0
package/dist/commands/console.js +111 -0
package/dist/commands/kernel-setup.d.ts +3 -0
package/dist/commands/kernel-setup.js +303 -0
package/dist/commands/mcp.d.ts +14 -0
package/dist/commands/mcp.js +100 -0
package/dist/commands/mission.d.ts +16 -0
package/dist/commands/mission.js +301 -0
package/dist/commands/models.d.ts +3 -1
package/dist/commands/models.js +111 -55
package/dist/commands/providers.d.ts +6 -0
package/dist/commands/providers.js +95 -0
package/dist/commands/run.d.ts +2 -1
package/dist/commands/run.js +349 -59
package/dist/commands/serve.d.ts +20 -0
package/dist/commands/serve.js +132 -0
package/dist/commands/setup.d.ts +1 -1
package/dist/commands/setup.js +77 -44
package/dist/commands/status.d.ts +2 -1
package/dist/commands/status.js +46 -30
package/dist/commands/workers.d.ts +5 -0
package/dist/commands/workers.js +103 -0
package/dist/kernel/autonomy/goal-loop.d.ts +49 -0
package/dist/kernel/autonomy/goal-loop.js +113 -0
package/dist/kernel/autonomy/index.d.ts +8 -0
package/dist/kernel/autonomy/index.js +7 -0
package/dist/kernel/browser/browser-controller.d.ts +57 -0
package/dist/kernel/browser/browser-controller.js +175 -0
package/dist/kernel/checkpoint-engine.d.ts +17 -0
package/dist/kernel/checkpoint-engine.js +128 -0
package/dist/kernel/command-system.d.ts +37 -0
package/dist/kernel/command-system.js +239 -0
package/dist/kernel/config-schema.d.ts +57 -0
package/dist/kernel/config-schema.js +36 -0
package/dist/kernel/event-bus.d.ts +19 -0
package/dist/kernel/event-bus.js +65 -0
package/dist/kernel/federation/auto-update.d.ts +36 -0
package/dist/kernel/federation/auto-update.js +57 -0
package/dist/kernel/federation/compute-router.d.ts +27 -0
package/dist/kernel/federation/compute-router.js +44 -0
package/dist/kernel/federation/config-sync.d.ts +33 -0
package/dist/kernel/federation/config-sync.js +37 -0
package/dist/kernel/federation/discovery.d.ts +11 -0
package/dist/kernel/federation/discovery.js +44 -0
package/dist/kernel/federation/event-bridge.d.ts +30 -0
package/dist/kernel/federation/event-bridge.js +61 -0
package/dist/kernel/federation/federation-plugin.d.ts +24 -0
package/dist/kernel/federation/federation-plugin.js +35 -0
package/dist/kernel/federation/federation.d.ts +135 -0
package/dist/kernel/federation/federation.js +378 -0
package/dist/kernel/federation/index.d.ts +33 -0
package/dist/kernel/federation/index.js +24 -0
package/dist/kernel/federation/lan-discovery.d.ts +43 -0
package/dist/kernel/federation/lan-discovery.js +135 -0
package/dist/kernel/federation/moltfed-adapter.d.ts +30 -0
package/dist/kernel/federation/moltfed-adapter.js +52 -0
package/dist/kernel/federation/moltfed-connector.d.ts +98 -0
package/dist/kernel/federation/moltfed-connector.js +193 -0
package/dist/kernel/federation/node-identity.d.ts +19 -0
package/dist/kernel/federation/node-identity.js +86 -0
package/dist/kernel/federation/peer-mesh.d.ts +46 -0
package/dist/kernel/federation/peer-mesh.js +117 -0
package/dist/kernel/federation/protocol.d.ts +20 -0
package/dist/kernel/federation/protocol.js +61 -0
package/dist/kernel/federation/role-context.d.ts +5 -0
package/dist/kernel/federation/role-context.js +45 -0
package/dist/kernel/federation/telemetry.d.ts +21 -0
package/dist/kernel/federation/telemetry.js +138 -0
package/dist/kernel/federation/transport-http.d.ts +44 -0
package/dist/kernel/federation/transport-http.js +207 -0
package/dist/kernel/federation/types.d.ts +212 -0
package/dist/kernel/federation/types.js +3 -0
package/dist/kernel/free-providers.d.ts +28 -0
package/dist/kernel/free-providers.js +162 -0
package/dist/kernel/frontend-scoring.d.ts +21 -0
package/dist/kernel/frontend-scoring.js +125 -0
package/dist/kernel/index.d.ts +63 -0
package/dist/kernel/index.js +45 -0
package/dist/kernel/kernel.d.ts +75 -0
package/dist/kernel/kernel.js +223 -0
package/dist/kernel/logger.d.ts +18 -0
package/dist/kernel/logger.js +26 -0
package/dist/kernel/mcp/index.d.ts +9 -0
package/dist/kernel/mcp/index.js +8 -0
package/dist/kernel/mcp/mcp-server.d.ts +27 -0
package/dist/kernel/mcp/mcp-server.js +178 -0
package/dist/kernel/mission-engine.d.ts +42 -0
package/dist/kernel/mission-engine.js +160 -0
package/dist/kernel/orchestrator.d.ts +51 -0
package/dist/kernel/orchestrator.js +226 -0
package/dist/kernel/plugin-manager.d.ts +28 -0
package/dist/kernel/plugin-manager.js +76 -0
package/dist/kernel/plugins/browser-plugin.d.ts +22 -0
package/dist/kernel/plugins/browser-plugin.js +34 -0
package/dist/kernel/plugins/dashboard-plugin.d.ts +17 -0
package/dist/kernel/plugins/dashboard-plugin.js +72 -0
package/dist/kernel/plugins/discord-plugin.d.ts +11 -0
package/dist/kernel/plugins/discord-plugin.js +35 -0
package/dist/kernel/plugins/metrics-plugin.d.ts +33 -0
package/dist/kernel/plugins/metrics-plugin.js +86 -0
package/dist/kernel/plugins/search-plugin.d.ts +17 -0
package/dist/kernel/plugins/search-plugin.js +20 -0
package/dist/kernel/plugins/slack-plugin.d.ts +11 -0
package/dist/kernel/plugins/slack-plugin.js +35 -0
package/dist/kernel/plugins/telegram-plugin.d.ts +20 -0
package/dist/kernel/plugins/telegram-plugin.js +122 -0
package/dist/kernel/policies.d.ts +33 -0
package/dist/kernel/policies.js +105 -0
package/dist/kernel/provider-discovery.d.ts +41 -0
package/dist/kernel/provider-discovery.js +179 -0
package/dist/kernel/provider-manager.d.ts +38 -0
package/dist/kernel/provider-manager.js +206 -0
package/dist/kernel/provider-url.d.ts +18 -0
package/dist/kernel/provider-url.js +45 -0
package/dist/kernel/providers/gemini-provider.d.ts +43 -0
package/dist/kernel/providers/gemini-provider.js +203 -0
package/dist/kernel/providers/ollama-provider.d.ts +44 -0
package/dist/kernel/providers/ollama-provider.js +241 -0
package/dist/kernel/providers/openai-compatible-provider.d.ts +43 -0
package/dist/kernel/providers/openai-compatible-provider.js +233 -0
package/dist/kernel/recovery-manager.d.ts +38 -0
package/dist/kernel/recovery-manager.js +156 -0
package/dist/kernel/router.d.ts +44 -0
package/dist/kernel/router.js +222 -0
package/dist/kernel/sample-missions.d.ts +11 -0
package/dist/kernel/sample-missions.js +132 -0
package/dist/kernel/scheduler.d.ts +30 -0
package/dist/kernel/scheduler.js +147 -0
package/dist/kernel/sdk/harness-sdk.d.ts +37 -0
package/dist/kernel/sdk/harness-sdk.js +48 -0
package/dist/kernel/sdk/plugin-sdk.d.ts +27 -0
package/dist/kernel/sdk/plugin-sdk.js +40 -0
package/dist/kernel/search/search-controller.d.ts +32 -0
package/dist/kernel/search/search-controller.js +141 -0
package/dist/kernel/setup.d.ts +13 -0
package/dist/kernel/setup.js +59 -0
package/dist/kernel/types.d.ts +479 -0
package/dist/kernel/types.js +7 -0
package/dist/kernel/verification-engine.d.ts +33 -0
package/dist/kernel/verification-engine.js +287 -0
package/dist/kernel/worker-runtime.d.ts +66 -0
package/dist/kernel/worker-runtime.js +261 -0
package/dist/kernel/workers/browser-worker.d.ts +6 -0
package/dist/kernel/workers/browser-worker.js +92 -0
package/dist/kernel/workers/builtin-workers.d.ts +20 -0
package/dist/kernel/workers/builtin-workers.js +120 -0
package/dist/kernel/workers/research-worker.d.ts +5 -0
package/dist/kernel/workers/research-worker.js +90 -0
package/dist/prompt-ascii-video-animation.d.ts +2 -0
package/dist/prompt-ascii-video-animation.js +243 -0
package/package.json +43 -9

package/dist/kernel/plugins/dashboard-plugin.js ADDED Viewed

@@ -0,0 +1,72 @@
+import { createServer } from 'node:http';
+export function createDashboardPlugin(options = {}) {
+    let kernelRef;
+    let server;
+    const port = options.port ?? 7331;
+    const host = options.host ?? '127.0.0.1';
+    function json(res, code, body) {
+        const payload = JSON.stringify(body, null, 2);
+        res.writeHead(code, { 'Content-Type': 'application/json' });
+        res.end(payload);
+    }
+    function handle(req, res) {
+        const url = req.url ?? '/';
+        if (url === '/status') {
+            json(res, 200, {
+                ok: true,
+                missions: kernelRef?.listMissions().length ?? 0,
+                plugins: kernelRef?.listPlugins().map(p => ({ name: p.manifest.name, version: p.manifest.version })) ?? [],
+                uptime: process.uptime(),
+            });
+            return;
+        }
+        if (url === '/missions') {
+            json(res, 200, kernelRef?.listMissions().map(m => ({
+                id: m.id, name: m.name, status: m.status, goal: m.goal,
+                tasks: m.tasks.length, completed: m.tasks.filter(t => t.status === 'COMPLETED').length,
+            })) ?? []);
+            return;
+        }
+        if (url === '/events') {
+            json(res, 200, kernelRef?.getEventHistory().slice(-50) ?? []);
+            return;
+        }
+        // HTML dashboard
+        const missions = kernelRef?.listMissions() ?? [];
+        const html = `<!doctype html><html><head><meta charset="utf-8"><title>OpenKernel Dashboard</title>
+<style>body{font:14px/1.5 system-ui;margin:2rem}table{border-collapse:collapse}td,th{border:1px solid #ccc;padding:4px 8px}</style></head>
+<body><h1>OpenKernel Dashboard</h1>
+<h2>Missions (${missions.length})</h2>
+<table><tr><th>ID</th><th>Name</th><th>Status</th><th>Goal</th><th>Tasks</th></tr>
+${missions.map(m => `<tr><td>${m.id}</td><td>${m.name}</td><td>${m.status}</td><td>${escapeHtml(m.goal)}</td><td>${m.tasks.filter(t => t.status === 'COMPLETED').length}/${m.tasks.length}</td></tr>`).join('')}
+</table>
+<p><a href="/status">/status</a> · <a href="/missions">/missions</a> · <a href="/events">/events</a></p>
+</body></html>`;
+        res.writeHead(200, { 'Content-Type': 'text/html' });
+        res.end(html);
+    }
+    return {
+        manifest: {
+            name: 'dashboard',
+            version: '0.1.0',
+            description: 'HTTP status dashboard',
+            subscriptions: [],
+        },
+        onRegister(kernel) {
+            kernelRef = kernel;
+            server = createServer(handle);
+            server.listen(port, host, () => {
+                // best-effort log
+            });
+        },
+        onDestroy() {
+            server?.close();
+        },
+        onEvent(_event) {
+            // could push to SSE stream in future; for now stateless
+        },
+    };
+}
+function escapeHtml(s) {
+    return s.replace(/[&<>"']/g, c => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' }[c]));
+}

package/dist/kernel/plugins/discord-plugin.d.ts ADDED Viewed

@@ -0,0 +1,11 @@
+/**
+ * OpenKernel — Discord Plugin (Stub)
+ *
+ * Notifications via Discord webhook. Requires DISCORD_WEBHOOK_URL.
+ */
+import type { KernelEventType, Plugin } from '../types.js';
+export interface DiscordPluginOptions {
+    webhookUrl?: string;
+    notifyOn?: KernelEventType[];
+}
+export declare function createDiscordPlugin(options: DiscordPluginOptions): Plugin;

package/dist/kernel/plugins/discord-plugin.js ADDED Viewed

@@ -0,0 +1,35 @@
+export function createDiscordPlugin(options) {
+    const notifyOn = new Set(options.notifyOn ?? [
+        'MISSION_STARTED',
+        'MISSION_COMPLETED',
+        'MISSION_FAILED',
+    ]);
+    async function send(content) {
+        if (!options.webhookUrl)
+            return;
+        try {
+            await fetch(options.webhookUrl, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ content }),
+                signal: AbortSignal.timeout(5000),
+            });
+        }
+        catch {
+            // best-effort
+        }
+    }
+    return {
+        manifest: {
+            name: 'discord',
+            version: '0.1.0',
+            description: 'Discord webhook notifications',
+            subscriptions: [...notifyOn],
+        },
+        onEvent(event) {
+            if (!notifyOn.has(event.type))
+                return;
+            void send(`**${event.type}** — mission \`${event.missionId ?? '-'}\``);
+        },
+    };
+}

package/dist/kernel/plugins/metrics-plugin.d.ts ADDED Viewed

@@ -0,0 +1,33 @@
+/**
+ * OpenKernel — Metrics Plugin
+ *
+ * Subscribes to all events and maintains runtime counters:
+ *   missions started/completed/failed, tasks started/completed/failed,
+ *   workers spawned/exited, provider changes, recoveries, checkpoints,
+ *   total tokens in/out, total duration.
+ *
+ * Exposes a snapshot() the Dashboard plugin or external monitors can read.
+ */
+import type { Plugin } from '../types.js';
+export interface MetricsSnapshot {
+    missionsStarted: number;
+    missionsCompleted: number;
+    missionsFailed: number;
+    tasksStarted: number;
+    tasksCompleted: number;
+    tasksFailed: number;
+    workersSpawned: number;
+    workersExited: number;
+    providerChanged: number;
+    recoveries: number;
+    checkpoints: number;
+    verificationsPassed: number;
+    verificationsFailed: number;
+    totalTokensIn: number;
+    totalTokensOut: number;
+    totalDurationMs: number;
+    lastEventAt?: number;
+}
+export declare function createMetricsPlugin(): Plugin & {
+    snapshot(): MetricsSnapshot;
+};

package/dist/kernel/plugins/metrics-plugin.js ADDED Viewed

@@ -0,0 +1,86 @@
+export function createMetricsPlugin() {
+    const m = {
+        missionsStarted: 0,
+        missionsCompleted: 0,
+        missionsFailed: 0,
+        tasksStarted: 0,
+        tasksCompleted: 0,
+        tasksFailed: 0,
+        workersSpawned: 0,
+        workersExited: 0,
+        providerChanged: 0,
+        recoveries: 0,
+        checkpoints: 0,
+        verificationsPassed: 0,
+        verificationsFailed: 0,
+        totalTokensIn: 0,
+        totalTokensOut: 0,
+        totalDurationMs: 0,
+    };
+    const all = [
+        'MISSION_STARTED', 'MISSION_COMPLETED', 'MISSION_FAILED',
+        'TASK_STARTED', 'TASK_COMPLETED', 'TASK_FAILED',
+        'WORKER_SPAWNED', 'WORKER_EXITED',
+        'PROVIDER_CHANGED', 'RECOVERY', 'CHECKPOINT',
+        'VERIFY_SUCCESS', 'VERIFY_FAILED',
+    ];
+    function onEvent(event) {
+        m.lastEventAt = event.timestamp;
+        switch (event.type) {
+            case 'MISSION_STARTED':
+                m.missionsStarted++;
+                break;
+            case 'MISSION_COMPLETED':
+                m.missionsCompleted++;
+                break;
+            case 'MISSION_FAILED':
+                m.missionsFailed++;
+                break;
+            case 'TASK_STARTED':
+                m.tasksStarted++;
+                break;
+            case 'TASK_COMPLETED': {
+                m.tasksCompleted++;
+                const d = event.data;
+                m.totalTokensIn += d?.output?.tokensIn ?? 0;
+                m.totalTokensOut += d?.output?.tokensOut ?? 0;
+                m.totalDurationMs += d?.output?.durationMs ?? 0;
+                break;
+            }
+            case 'TASK_FAILED':
+                m.tasksFailed++;
+                break;
+            case 'WORKER_SPAWNED':
+                m.workersSpawned++;
+                break;
+            case 'WORKER_EXITED':
+                m.workersExited++;
+                break;
+            case 'PROVIDER_CHANGED':
+                m.providerChanged++;
+                break;
+            case 'RECOVERY':
+                m.recoveries++;
+                break;
+            case 'CHECKPOINT':
+                m.checkpoints++;
+                break;
+            case 'VERIFY_SUCCESS':
+                m.verificationsPassed++;
+                break;
+            case 'VERIFY_FAILED':
+                m.verificationsFailed++;
+                break;
+        }
+    }
+    return {
+        manifest: {
+            name: 'metrics',
+            version: '0.1.0',
+            description: 'Runtime metrics counters',
+            subscriptions: all,
+        },
+        onEvent,
+        snapshot() { return { ...m }; },
+    };
+}

package/dist/kernel/plugins/search-plugin.d.ts ADDED Viewed

@@ -0,0 +1,17 @@
+/**
+ * OpenKernel — Search Plugin
+ *
+ * Default stack: SearXNG → Crawler (Crawl4AI-style fetch) → Markdown → LLM.
+ * Provides a shared SearchController that the research worker handler uses.
+ *
+ * If no SearXNG URL is configured, the controller falls back to a
+ * DuckDuckGo HTML scrape so the research worker remains functional.
+ */
+import type { Plugin } from '../types.js';
+import { SearchController } from '../search/search-controller.js';
+import type { SearchOptions } from '../search/search-controller.js';
+export interface SearchPluginOptions extends SearchOptions {
+}
+export declare function createSearchPlugin(options?: SearchPluginOptions): Plugin;
+export { SearchController };
+export type { SearchOptions, SearchResult } from '../search/search-controller.js';

package/dist/kernel/plugins/search-plugin.js ADDED Viewed

@@ -0,0 +1,20 @@
+import { SearchController } from '../search/search-controller.js';
+import { setSearchController } from '../workers/research-worker.js';
+export function createSearchPlugin(options = {}) {
+    const controller = new SearchController(options);
+    return {
+        manifest: {
+            name: 'search',
+            version: '0.2.0',
+            description: 'SearXNG + crawler search stack (Phase 4)',
+            subscriptions: [],
+        },
+        onRegister() {
+            setSearchController(controller);
+        },
+        onEvent() {
+            // stateless; the research worker drives the controller directly
+        },
+    };
+}
+export { SearchController };

package/dist/kernel/plugins/slack-plugin.d.ts ADDED Viewed

@@ -0,0 +1,11 @@
+/**
+ * OpenKernel — Slack Plugin (Stub)
+ *
+ * Notifications via Slack webhook. Requires SLACK_WEBHOOK_URL.
+ */
+import type { KernelEventType, Plugin } from '../types.js';
+export interface SlackPluginOptions {
+    webhookUrl?: string;
+    notifyOn?: KernelEventType[];
+}
+export declare function createSlackPlugin(options: SlackPluginOptions): Plugin;

package/dist/kernel/plugins/slack-plugin.js ADDED Viewed

@@ -0,0 +1,35 @@
+export function createSlackPlugin(options) {
+    const notifyOn = new Set(options.notifyOn ?? [
+        'MISSION_STARTED',
+        'MISSION_COMPLETED',
+        'MISSION_FAILED',
+    ]);
+    async function send(text) {
+        if (!options.webhookUrl)
+            return;
+        try {
+            await fetch(options.webhookUrl, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ text }),
+                signal: AbortSignal.timeout(5000),
+            });
+        }
+        catch {
+            // best-effort
+        }
+    }
+    return {
+        manifest: {
+            name: 'slack',
+            version: '0.1.0',
+            description: 'Slack webhook notifications',
+            subscriptions: [...notifyOn],
+        },
+        onEvent(event) {
+            if (!notifyOn.has(event.type))
+                return;
+            void send(`*${event.type}* — mission \`${event.missionId ?? '-'}\``);
+        },
+    };
+}

package/dist/kernel/plugins/telegram-plugin.d.ts ADDED Viewed

@@ -0,0 +1,20 @@
+/**
+ * OpenKernel — Telegram Plugin
+ *
+ * Notifications (outbound) + slash commands (inbound polling).
+ * Commands: /status /workers /logs /pause /resume /retry /models
+ *           /providers /checkpoints /goal
+ *
+ * Real bot wiring requires TELEGRAM_BOT_TOKEN + chatId.
+ * Phase 4 will flesh out natural chat with the orchestrator.
+ */
+import type { KernelEventType, Plugin } from '../types.js';
+export interface TelegramPluginOptions {
+    token?: string;
+    chatId?: string;
+    /** When true, polls Telegram getUpdates and dispatches slash commands. */
+    pollCommands?: boolean;
+    pollIntervalMs?: number;
+    notifyOn?: KernelEventType[];
+}
+export declare function createTelegramPlugin(options: TelegramPluginOptions): Plugin;

package/dist/kernel/plugins/telegram-plugin.js ADDED Viewed

@@ -0,0 +1,122 @@
+export function createTelegramPlugin(options) {
+    const notifyOn = new Set(options.notifyOn ?? [
+        'MISSION_STARTED',
+        'MISSION_COMPLETED',
+        'MISSION_FAILED',
+        'MISSION_PAUSED',
+        'MISSION_RESUMED',
+        'PROVIDER_CHANGED',
+        'NOTIFICATION',
+        'RECOVERY',
+    ]);
+    let kernelRef;
+    let pollTimer;
+    let offset = 0;
+    async function send(message) {
+        if (!options.token || !options.chatId)
+            return;
+        try {
+            await fetch(`https://api.telegram.org/bot${options.token}/sendMessage`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ chat_id: options.chatId, text: message, parse_mode: 'Markdown' }),
+                signal: AbortSignal.timeout(5000),
+            });
+        }
+        catch {
+            // best-effort
+        }
+    }
+    async function pollOnce() {
+        if (!options.token)
+            return;
+        try {
+            const res = await fetch(`https://api.telegram.org/bot${options.token}/getUpdates?offset=${offset}&timeout=0`, { signal: AbortSignal.timeout(5000) });
+            const json = (await res.json());
+            if (!json.ok || !json.result)
+                return;
+            for (const upd of json.result) {
+                offset = upd.update_id + 1;
+                const text = upd.message?.text?.trim();
+                const chatId = upd.message?.chat?.id;
+                if (!text || !chatId)
+                    continue;
+                if (options.chatId && String(chatId) !== String(options.chatId))
+                    continue;
+                await dispatchCommand(text);
+            }
+        }
+        catch {
+            // best-effort
+        }
+    }
+    async function dispatchCommand(text) {
+        if (!text.startsWith('/'))
+            return;
+        const k = kernelRef;
+        if (!k) {
+            await send('kernel not registered');
+            return;
+        }
+        // Delegate to the kernel's canonical command registry — the same surface
+        // the CLI console uses — so behavior is defined once for every channel.
+        const result = await k.command(text);
+        await send(result.text || (result.ok ? 'ok' : 'error'));
+    }
+    return {
+        manifest: {
+            name: 'telegram',
+            version: '0.2.0',
+            description: 'Telegram notifications + slash commands',
+            subscriptions: [...notifyOn],
+            commands: [
+                {
+                    name: 'tg',
+                    description: 'Send a Telegram notification manually',
+                    handler: async (args) => {
+                        await send(args.join(' ') || 'test from openkernel');
+                        console.log('sent');
+                    },
+                },
+            ],
+        },
+        onRegister(kernel) {
+            kernelRef = kernel;
+            if (options.pollCommands && options.token) {
+                const interval = options.pollIntervalMs ?? 2000;
+                pollTimer = setInterval(() => { void pollOnce(); }, interval);
+            }
+        },
+        onEvent(event) {
+            if (!notifyOn.has(event.type))
+                return;
+            const summary = formatEvent(event);
+            void send(summary);
+        },
+        onDestroy() {
+            if (pollTimer)
+                clearInterval(pollTimer);
+        },
+    };
+}
+function formatEvent(event) {
+    if (event.type === 'NOTIFICATION') {
+        const data = event.data;
+        return `*NOTIFICATION*  ${data?.message ?? ''}`;
+    }
+    const parts = [`*${event.type}*`];
+    if (event.missionId)
+        parts.push(`mission: \`${event.missionId}\``);
+    if (event.taskId)
+        parts.push(`task: \`${event.taskId}\``);
+    if (event.data && typeof event.data === 'object') {
+        const d = event.data;
+        if ('error' in d)
+            parts.push(`error: ${String(d.error)}`);
+        if ('decision' in d && d.decision && typeof d.decision === 'object') {
+            const dec = d.decision;
+            parts.push(`recovery: ${dec.action ?? ''} — ${dec.reason ?? ''}`);
+        }
+    }
+    return parts.join('  ');
+}

package/dist/kernel/policies.d.ts ADDED Viewed

@@ -0,0 +1,33 @@
+/**
+ * OpenKernel — Policy Engine
+ *
+ * Built-in policies: free-first, fastest, highest-quality, local-first,
+ * privacy-first, balanced, offline.
+ */
+import type { Policy, PolicyName, PolicyRef } from './types.js';
+export declare const PolicyPresets: {
+    freeFirst(): Policy;
+    fastest(): Policy;
+    highestQuality(): Policy;
+    localFirst(): Policy;
+    privacyFirst(): Policy;
+    balanced(): Policy;
+    offline(): Policy;
+};
+export declare const POLICY_FACTORIES: {
+    freeFirst(): Policy;
+    fastest(): Policy;
+    highestQuality(): Policy;
+    localFirst(): Policy;
+    privacyFirst(): Policy;
+    balanced(): Policy;
+    offline(): Policy;
+};
+export declare class PolicyEngine {
+    private policies;
+    constructor();
+    register(policy: Policy): void;
+    get(name: PolicyName): Policy;
+    resolveRef(name?: PolicyName): PolicyRef;
+    list(): Policy[];
+}

package/dist/kernel/policies.js ADDED Viewed

@@ -0,0 +1,105 @@
+export const PolicyPresets = {
+    freeFirst() {
+        return {
+            name: 'free-first',
+            execution: { parallelism: 2 },
+            routing: { mode: 'free-first' },
+            verification: { strict: false },
+            checkpoint: { everyTask: true },
+            retry: { maxAttempts: 3, backoffMs: 1000 },
+            notifications: { channels: [] },
+        };
+    },
+    fastest() {
+        return {
+            name: 'fastest',
+            execution: { parallelism: 4 },
+            routing: { mode: 'fastest' },
+            verification: { strict: false },
+            checkpoint: { everyTask: false },
+            retry: { maxAttempts: 2, backoffMs: 500 },
+            notifications: { channels: [] },
+        };
+    },
+    highestQuality() {
+        return {
+            name: 'highest-quality',
+            execution: { parallelism: 2, timeout: 300_000 },
+            routing: { mode: 'quality' },
+            verification: { strict: true },
+            checkpoint: { everyTask: true },
+            retry: { maxAttempts: 5, backoffMs: 2000 },
+            notifications: { channels: [] },
+        };
+    },
+    localFirst() {
+        return {
+            name: 'local-first',
+            execution: { parallelism: 2 },
+            routing: { mode: 'local', preferredProviders: ['ollama'] },
+            verification: { strict: false },
+            checkpoint: { everyTask: true },
+            retry: { maxAttempts: 3, backoffMs: 1000 },
+            notifications: { channels: [] },
+        };
+    },
+    privacyFirst() {
+        return {
+            name: 'privacy-first',
+            execution: { parallelism: 2 },
+            routing: { mode: 'privacy', preferredProviders: ['ollama'], blockedProviders: [] },
+            verification: { strict: true },
+            checkpoint: { everyTask: true },
+            retry: { maxAttempts: 3, backoffMs: 1000 },
+            notifications: { channels: [] },
+        };
+    },
+    balanced() {
+        return {
+            name: 'balanced',
+            execution: { parallelism: 4 },
+            routing: { mode: 'balanced' },
+            verification: { strict: false },
+            checkpoint: { everyTask: true },
+            retry: { maxAttempts: 3, backoffMs: 1500 },
+            notifications: { channels: [] },
+        };
+    },
+    offline() {
+        return {
+            name: 'offline',
+            execution: { parallelism: 2 },
+            routing: { mode: 'offline', preferredProviders: ['ollama'] },
+            verification: { strict: false },
+            checkpoint: { everyTask: true },
+            retry: { maxAttempts: 3, backoffMs: 1000 },
+            notifications: { channels: [] },
+        };
+    },
+};
+export const POLICY_FACTORIES = PolicyPresets;
+export class PolicyEngine {
+    policies = new Map();
+    constructor() {
+        this.register(PolicyPresets.freeFirst());
+        this.register(PolicyPresets.fastest());
+        this.register(PolicyPresets.highestQuality());
+        this.register(PolicyPresets.localFirst());
+        this.register(PolicyPresets.privacyFirst());
+        this.register(PolicyPresets.balanced());
+        this.register(PolicyPresets.offline());
+    }
+    register(policy) {
+        this.policies.set(policy.name, policy);
+    }
+    get(name) {
+        return this.policies.get(name) ?? PolicyPresets.balanced();
+    }
+    resolveRef(name) {
+        const policy = this.get(name ?? 'balanced');
+        return { name: policy.name, policy };
+    }
+    list() {
+        return [...this.policies.values()];
+    }
+}

package/dist/kernel/provider-discovery.d.ts ADDED Viewed

@@ -0,0 +1,41 @@
+import type { ProviderModel, WorkerType } from '../kernel/types.js';
+import type { CloudProviderConfig, WorkerModelPref } from './config-schema.js';
+import { type FreeProviderPreset } from './free-providers.js';
+export interface DiscoveredModel {
+    providerId: string;
+    model: ProviderModel;
+}
+export interface ProviderTestResult {
+    providerId: string;
+    name: string;
+    ok: boolean;
+    error?: string;
+    modelCount: number;
+    latencyMs?: number;
+}
+export declare function testOllamaProvider(baseURL: string, fallbackURL?: string, timeoutMs?: number): Promise<ProviderTestResult>;
+export declare function testCloudProvider(cfg: CloudProviderConfig, timeoutMs?: number): Promise<ProviderTestResult>;
+export declare function testProviderInteractive(label: string, fn: () => Promise<ProviderTestResult>): Promise<ProviderTestResult>;
+/**
+ * Discover all available models across all configured providers (Ollama + cloud).
+ * Returns a flat list tagged with providerId.
+ */
+export declare function discoverAllModels(opts: {
+    masterUrl: string;
+    tailscaleMasterUrl?: string;
+    cloudProviders: CloudProviderConfig[];
+}): Promise<DiscoveredModel[]>;
+/**
+ * Build a friendly display label for a discovered model.
+ */
+export declare function modelLabel(dm: DiscoveredModel): string;
+/**
+ * Suggest a recommended model for a worker type from the discovered pool.
+ * Falls back to the provider preset's recommended list if discovery found nothing.
+ */
+export declare function suggestModelForWorker(workerType: WorkerType, discovered: DiscoveredModel[]): DiscoveredModel | undefined;
+/**
+ * Build a complete workerModels map by suggesting a model for each builtin worker type.
+ */
+export declare function suggestAllWorkerModels(discovered: DiscoveredModel[]): Partial<Record<WorkerType, WorkerModelPref>>;
+export type { FreeProviderPreset };