@gns-foundation/hive-worker 0.1.0

package/dist/executor.js

@@ -0,0 +1,201 @@
+// ============================================================
+// HIVE WORKER — EXECUTOR
+// Runs llama-cli for an assigned job.
+//
+// Two modes:
+//   pipeline  — rpc-server already running, orchestrator calls us
+//               (worker just tracks status, no local llama-cli)
+//   solo      — worker claims and runs the whole model locally
+//               (for small models: phi-3-mini, gemma-2-2b, etc.)
+//
+// Solo mode is the active path for hive-worker v0.1 / v0.2.
+// Pipeline mode is the full swarm path (Phase 3 whitepaper).
+// ============================================================
+import { spawn } from 'child_process';
+import { execSync } from 'child_process';
+import os from 'os';
+import path from 'path';
+// ─── Binary detection ─────────────────────────────────────────
+const LLAMA_CLI_CANDIDATES = [
+    'llama-cli',
+    'llama.cpp/llama-cli',
+    `${os.homedir()}/llama.cpp/llama-cli`,
+    `${os.homedir()}/llama.cpp/build/bin/llama-cli`,
+    `${os.homedir()}/llama.cpp/build/llama-cli`,
+    // Older name
+    'main',
+    `${os.homedir()}/llama.cpp/main`,
+];
+export function findLlamaCli() {
+    for (const candidate of LLAMA_CLI_CANDIDATES) {
+        try {
+            execSync(`test -f "${candidate}" || which "${candidate}" 2>/dev/null`, { timeout: 2000 });
+            return candidate;
+        }
+        catch { /* not found */ }
+    }
+    return null;
+}
+// ─── Model cache ──────────────────────────────────────────────
+const MODEL_CACHE_DIR = path.join(os.homedir(), '.hive', 'models');
+import fs from 'fs';
+export function ensureModelCacheDir() {
+    fs.mkdirSync(MODEL_CACHE_DIR, { recursive: true });
+}
+export function modelCachePath(modelId) {
+    // Normalize: "phi-3-mini" → "phi-3-mini.gguf"
+    const filename = modelId.endsWith('.gguf') ? modelId : `${modelId}.gguf`;
+    return path.join(MODEL_CACHE_DIR, filename);
+}
+export function isModelCached(modelId) {
+    return fs.existsSync(modelCachePath(modelId));
+}
+// Known small models with public GGUF URLs (Q4_K_M quantizations)
+const KNOWN_MODELS = {
+    'phi-3-mini': 'https://huggingface.co/microsoft/Phi-3-mini-4k-instruct-gguf/resolve/main/Phi-3-mini-4k-instruct-q4.gguf',
+    'gemma-2-2b': 'https://huggingface.co/bartowski/gemma-2-2b-it-GGUF/resolve/main/gemma-2-2b-it-Q4_K_M.gguf',
+    'tinyllama': 'https://huggingface.co/TheBloke/TinyLlama-1.1B-Chat-v1.0-GGUF/resolve/main/tinyllama-1.1b-chat-v1.0.Q4_K_M.gguf',
+};
+export function resolveModelUrl(job) {
+    if (job.model_url)
+        return job.model_url;
+    return KNOWN_MODELS[job.model_id] ?? null;
+}
+// ─── Download model (streaming, with progress) ───────────────
+export async function downloadModel(modelId, url, onProgress) {
+    ensureModelCacheDir();
+    const dest = modelCachePath(modelId);
+    const tmpDest = dest + '.download';
+    const resp = await fetch(url, { signal: AbortSignal.timeout(300_000) });
+    if (!resp.ok)
+        throw new Error(`Model download failed: ${resp.status}`);
+    const totalBytes = parseInt(resp.headers.get('content-length') ?? '0', 10);
+    const totalMb = totalBytes / 1024 / 1024;
+    const writer = fs.createWriteStream(tmpDest);
+    let downloaded = 0;
+    if (!resp.body)
+        throw new Error('No response body');
+    const reader = resp.body.getReader();
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        writer.write(value);
+        downloaded += value.length;
+        if (totalBytes > 0) {
+            onProgress(Math.round((downloaded / totalBytes) * 100), Math.round(downloaded / 1024 / 1024), Math.round(totalMb));
+        }
+    }
+    await new Promise((res, rej) => {
+        writer.end(() => res());
+        writer.on('error', rej);
+    });
+    fs.renameSync(tmpDest, dest);
+    return dest;
+}
+export async function executeJob(job, opts = {}) {
+    const llamaCli = findLlamaCli();
+    if (!llamaCli) {
+        throw new Error('llama-cli not found. Install llama.cpp: https://github.com/ggerganov/llama.cpp');
+    }
+    const modelPath = modelCachePath(job.model_id);
+    if (!fs.existsSync(modelPath)) {
+        throw new Error(`Model "${job.model_id}" not cached at ${modelPath}. ` +
+            `Run: hive-worker models fetch ${job.model_id}`);
+    }
+    return runLlamaCli(llamaCli, modelPath, job, opts);
+}
+function runLlamaCli(binary, modelPath, job, opts) {
+    return new Promise((resolve, reject) => {
+        const startMs = Date.now();
+        // Build args
+        const args = [
+            '--model', modelPath,
+            '--prompt', job.prompt,
+            '--n-predict', String(job.max_tokens),
+            '--temp', String(job.temperature),
+            '--ctx-size', '4096',
+            '--threads', String(Math.max(1, Math.floor(os.cpus().length / 2))),
+            '--no-display-prompt', // suppress prompt echo
+            '--log-disable',
+            '--single-turn',
+            '-ngl', '0',
+        ];
+        // Layer range hint (pipeline mode — rpc-server handles routing,
+        // but we pass the range so the model knows which layers to host)
+        if (job.layer_start !== 0 || job.layer_end !== 31) {
+            args.push('--n-gpu-layers', '0'); // CPU-only for partial layer ranges
+        }
+        // Apple Silicon: use Metal when running full model
+        const isApple = os.platform() === 'darwin' && os.arch() === 'arm64';
+        if (isApple && job.layer_start === 0) {
+            args.push('--n-gpu-layers', '99'); // offload all layers to Metal
+        }
+        opts.onLog?.(`Starting llama-cli for "${job.model_id}" [layers ${job.layer_start}–${job.layer_end}]`);
+        opts.onLog?.(`Command: ${binary} ${args.slice(0, 6).join(' ')} ...`);
+        const proc = spawn(binary, args, {
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let output = '';
+        let stderrBuf = '';
+        // llama-cli writes generated tokens to stdout
+        proc.stdout.on('data', (chunk) => {
+            const text = chunk.toString();
+            output += text;
+            opts.onToken?.(text);
+        });
+        // Stats appear on stderr: "llama_print_timings: eval time = 12345 ms / 150 runs"
+        proc.stderr.on('data', (chunk) => {
+            stderrBuf += chunk.toString();
+            opts.onLog?.(chunk.toString().trim());
+        });
+        proc.on('error', (err) => {
+            reject(new Error(`llama-cli spawn error: ${err.message}`));
+        });
+        proc.on('close', (code) => {
+            const wallMs = Date.now() - startMs;
+            if (code !== 0) {
+                reject(new Error(`llama-cli exited with code ${code}. stderr: ${stderrBuf.slice(-500)}`));
+                return;
+            }
+            // Parse tokens/sec from llama.cpp timing output
+            // Example: "llama_print_timings:        eval time = 4523.11 ms /   150 runs"
+            const tpsMatch = stderrBuf.match(/eval time\s*=\s*([\d.]+)\s*ms\s*\/\s*(\d+)\s*runs/);
+            let tokensPerSecond = 0;
+            let tokensGenerated = output.split(/\s+/).length; // rough estimate
+            if (tpsMatch) {
+                const evalMs = parseFloat(tpsMatch[1]);
+                tokensGenerated = parseInt(tpsMatch[2], 10);
+                tokensPerSecond = Math.round((tokensGenerated / evalMs) * 1000 * 10) / 10;
+            }
+            else if (wallMs > 0) {
+                // Fallback: tokens from output word count / wall time
+                tokensPerSecond = Math.round((tokensGenerated / wallMs) * 1000 * 10) / 10;
+            }
+            resolve({
+                resultText: output.trim(),
+                tokensGenerated,
+                tokensPerSecond,
+            });
+        });
+        // Job-level timeout (safety net on top of Supabase timeout_at)
+        const deadline = new Date(job.timeout_at).getTime();
+        const remaining = deadline - Date.now() - 10_000; // 10s buffer
+        if (remaining > 0) {
+            setTimeout(() => {
+                proc.kill('SIGTERM');
+                reject(new Error('Job timed out (executor deadline)'));
+            }, remaining);
+        }
+    });
+}
+// ─── List cached models ───────────────────────────────────────
+export function listCachedModels() {
+    ensureModelCacheDir();
+    const files = fs.readdirSync(MODEL_CACHE_DIR).filter(f => f.endsWith('.gguf'));
+    return files.map(f => ({
+        modelId: f.replace('.gguf', ''),
+        sizeMb: Math.round(fs.statSync(path.join(MODEL_CACHE_DIR, f)).size / 1024 / 1024),
+    }));
+}
+//# sourceMappingURL=executor.js.map

package/dist/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,yBAAyB;AACzB,sCAAsC;AACtC,EAAE;AACF,aAAa;AACb,kEAAkE;AAClE,gEAAgE;AAChE,+DAA+D;AAC/D,iEAAiE;AACjE,EAAE;AACF,4DAA4D;AAC5D,6DAA6D;AAC7D,+DAA+D;AAE/D,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB,iEAAiE;AAEjE,MAAM,oBAAoB,GAAG;IAC3B,WAAW;IACX,qBAAqB;IACrB,GAAG,EAAE,CAAC,OAAO,EAAE,sBAAsB;IACrC,GAAG,EAAE,CAAC,OAAO,EAAE,gCAAgC;IAC/C,GAAG,EAAE,CAAC,OAAO,EAAE,4BAA4B;IAC3C,aAAa;IACb,MAAM;IACN,GAAG,EAAE,CAAC,OAAO,EAAE,iBAAiB;CACjC,CAAC;AAEF,MAAM,UAAU,YAAY;IAC1B,KAAK,MAAM,SAAS,IAAI,oBAAoB,EAAE,CAAC;QAC7C,IAAI,CAAC;YACH,QAAQ,CAAC,YAAY,SAAS,eAAe,SAAS,eAAe,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YAC1F,OAAO,SAAS,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,iEAAiE;AAEjE,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;AAEnE,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,MAAM,UAAU,mBAAmB;IACjC,EAAE,CAAC,SAAS,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,8CAA8C;IAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,OAAO,CAAC;IACzE,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,kEAAkE;AAClE,MAAM,YAAY,GAA2B;IAC3C,YAAY,EACV,0GAA0G;IAC5G,YAAY,EACV,4FAA4F;IAC9F,WAAW,EACT,iHAAiH;CACpH,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,IAAI,GAAG,CAAC,SAAS;QAAE,OAAO,GAAG,CAAC,SAAS,CAAC;IACxC,OAAO,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC;AAC5C,CAAC;AAED,gEAAgE;AAEhE,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAe,EACf,GAAW,EACX,UAAkE;IAElE,mBAAmB,EAAE,CAAC;IACtB,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,IAAI,GAAG,WAAW,CAAC;IAEnC,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACxE,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAEvE,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;IAC3E,MAAM,OAAO,GAAG,UAAU,GAAG,IAAI,GAAG,IAAI,CAAC;IAEzC,MAAM,MAAM,GAAG,EAAE,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC7C,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,IAAI,CAAC,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAEpD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;IACrC,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,IAAI;YAAE,MAAM;QAChB,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACpB,UAAU,IAAI,KAAK,CAAC,MAAM,CAAC;QAC3B,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACnB,UAAU,CACR,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,GAAG,UAAU,CAAC,GAAG,GAAG,CAAC,EAC3C,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,GAAG,IAAI,CAAC,EACpC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CACpB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,IAAI,OAAO,CAAO,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QACnC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;QACxB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC7B,OAAO,IAAI,CAAC;AACd,CAAC;AASD,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAY,EACZ,OAAwB,EAAE;IAE1B,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;IAChC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,gFAAgF,CACjF,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC/C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,UAAU,GAAG,CAAC,QAAQ,mBAAmB,SAAS,IAAI;YACtD,iCAAiC,GAAG,CAAC,QAAQ,EAAE,CAChD,CAAC;IACJ,CAAC;IAED,OAAO,WAAW,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,WAAW,CAClB,MAAc,EACd,SAAiB,EACjB,GAAY,EACZ,IAAqB;IAErB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE3B,aAAa;QACb,MAAM,IAAI,GAAG;YACX,SAAS,EAAQ,SAAS;YAC1B,UAAU,EAAO,GAAG,CAAC,MAAM;YAC3B,aAAa,EAAI,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC;YACvC,QAAQ,EAAS,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC;YACxC,YAAY,EAAK,MAAM;YACvB,WAAW,EAAM,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;YACtE,qBAAqB,EAAI,uBAAuB;YAChD,eAAe;YACf,eAAe;YACf,MAAM,EAAE,GAAG;SAEZ,CAAC;QAEF,gEAAgE;QAChE,iEAAiE;QACjE,IAAI,GAAG,CAAC,WAAW,KAAK,CAAC,IAAI,GAAG,CAAC,SAAS,KAAK,EAAE,EAAE,CAAC;YAClD,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC,CAAC,oCAAoC;QACxE,CAAC;QAED,mDAAmD;QACnD,MAAM,OAAO,GAAG,EAAE,CAAC,QAAQ,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,OAAO,CAAC;QACpE,IAAI,OAAO,IAAI,GAAG,CAAC,WAAW,KAAK,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC,CAAE,8BAA8B;QACpE,CAAC;QAED,IAAI,CAAC,KAAK,EAAE,CAAC,2BAA2B,GAAG,CAAC,QAAQ,aAAa,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC;QACtG,IAAI,CAAC,KAAK,EAAE,CAAC,YAAY,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAErE,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE;YAC/B,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC;QAEH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,SAAS,GAAG,EAAE,CAAC;QAEnB,8CAA8C;QAC9C,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACvC,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC9B,MAAM,IAAI,IAAI,CAAC;YACf,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;QAEH,iFAAiF;QACjF,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACvC,SAAS,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC9B,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACvB,MAAM,CAAC,IAAI,KAAK,CAAC,0BAA0B,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACxB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;YAEpC,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,KAAK,CACd,8BAA8B,IAAI,aAAa,SAAS,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CACvE,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YAED,gDAAgD;YAChD,6EAA6E;YAC7E,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;YACtF,IAAI,eAAe,GAAG,CAAC,CAAC;YACxB,IAAI,eAAe,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,iBAAiB;YAEnE,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,MAAM,GAAI,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;gBACxC,eAAe,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC5C,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,eAAe,GAAG,MAAM,CAAC,GAAG,IAAI,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;YAC5E,CAAC;iBAAM,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtB,sDAAsD;gBACtD,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,eAAe,GAAG,MAAM,CAAC,GAAG,IAAI,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;YAC5E,CAAC;YAED,OAAO,CAAC;gBACN,UAAU,EAAO,MAAM,CAAC,IAAI,EAAE;gBAC9B,eAAe;gBACf,eAAe;aAChB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,+DAA+D;QAC/D,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC;QACpD,MAAM,SAAS,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC,aAAa;QAC/D,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAClB,UAAU,CAAC,GAAG,EAAE;gBACd,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACrB,MAAM,CAAC,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC,CAAC;YACzD,CAAC,EAAE,SAAS,CAAC,CAAC;QAChB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,iEAAiE;AAEjE,MAAM,UAAU,gBAAgB;IAC9B,mBAAmB,EAAE,CAAC;IACtB,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/E,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACrB,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QAC/B,MAAM,EAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;KACnF,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/hardware.d.ts

@@ -0,0 +1,19 @@
+export interface HardwareProfile {
+    cpuModel: string;
+    cpuCores: number;
+    ramGb: number;
+    platform: string;
+    arch: string;
+    gpuModel: string | null;
+    estimatedTflops: number;
+    hiveClass: 'phone' | 'laptop' | 'desktop' | 'server';
+}
+export interface GeoProfile {
+    h3Cell: string;
+    city: string;
+    country: string;
+    lat: number;
+    lng: number;
+}
+export declare function detectHardware(): HardwareProfile;
+export declare function detectGeo(): Promise<GeoProfile>;

package/dist/hardware.js

@@ -0,0 +1,129 @@
+// ============================================================
+// HIVE WORKER — HARDWARE
+// Detect CPU, RAM, GPU, OS platform
+// Derive H3 cell from IP geolocation (desktop has no GPS)
+// ============================================================
+import os from 'os';
+import { execSync } from 'child_process';
+import { latLngToCell } from 'h3-js';
+// ─── CPU / RAM ───────────────────────────────────────────────
+function detectGpu() {
+    try {
+        const plat = os.platform();
+        if (plat === 'darwin') {
+            const out = execSync('system_profiler SPDisplaysDataType 2>/dev/null | grep "Chipset Model"', {
+                encoding: 'utf-8', timeout: 3000,
+            });
+            const match = out.match(/Chipset Model:\s*(.+)/);
+            return match ? match[1].trim() : null;
+        }
+        if (plat === 'linux') {
+            try {
+                const out = execSync('nvidia-smi --query-gpu=name --format=csv,noheader 2>/dev/null', {
+                    encoding: 'utf-8', timeout: 3000,
+                });
+                return out.trim().split('\n')[0] || null;
+            }
+            catch { /* no nvidia */ }
+            try {
+                const out = execSync('rocm-smi --showproductname 2>/dev/null | grep "Card"', {
+                    encoding: 'utf-8', timeout: 3000,
+                });
+                return out.trim() || null;
+            }
+            catch {
+                return null;
+            }
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+function estimateTflops(cpuCores, gpu, arch) {
+    // Very rough heuristic — enough for scheduling tier decisions
+    if (gpu) {
+        if (gpu.includes('A100'))
+            return 312;
+        if (gpu.includes('H100'))
+            return 756;
+        if (gpu.includes('4090'))
+            return 82;
+        if (gpu.includes('3090'))
+            return 35;
+        if (gpu.includes('RTX 5090'))
+            return 170;
+        if (gpu.includes('M4 Pro') || gpu.includes('M4 Max'))
+            return 14;
+        if (gpu.includes('M3 Pro') || gpu.includes('M3 Max'))
+            return 10;
+        if (gpu.includes('M2 Pro') || gpu.includes('M2 Max'))
+            return 6.5;
+        if (gpu.includes('M1 Pro') || gpu.includes('M1 Max'))
+            return 5.2;
+        if (gpu.includes('M4'))
+            return 4.6;
+        if (gpu.includes('M3'))
+            return 3.6;
+        if (gpu.includes('M2'))
+            return 2.6;
+        if (gpu.includes('M1'))
+            return 2.0;
+    }
+    // CPU-only estimate: ~0.05 TFLOPS per core for modern CPUs
+    return Math.round(cpuCores * 0.05 * 10) / 10;
+}
+function classifyDevice(ramGb, cpuCores, gpu) {
+    if (ramGb >= 64 && cpuCores >= 16)
+        return 'server';
+    if (ramGb >= 16 || (gpu && !gpu.toLowerCase().includes('apple')))
+        return 'desktop';
+    if (ramGb >= 8)
+        return 'laptop';
+    return 'phone';
+}
+export function detectHardware() {
+    const cpus = os.cpus();
+    const cpuModel = cpus[0]?.model?.trim() ?? 'Unknown CPU';
+    const cpuCores = cpus.length;
+    const ramGb = Math.round(os.totalmem() / (1024 ** 3));
+    const platform = os.platform();
+    const arch = os.arch();
+    const gpuModel = detectGpu();
+    const estimatedTflops = estimateTflops(cpuCores, gpuModel, arch);
+    const hiveClass = classifyDevice(ramGb, cpuCores, gpuModel);
+    return { cpuModel, cpuCores, ramGb, platform, arch, gpuModel, estimatedTflops, hiveClass };
+}
+// ─── GEO (IP-based, best effort) ─────────────────────────────
+export async function detectGeo() {
+    try {
+        const resp = await fetch('https://ipapi.co/json/', { signal: AbortSignal.timeout(5000) });
+        if (!resp.ok)
+            throw new Error(`HTTP ${resp.status}`);
+        const data = await resp.json();
+        const lat = data.latitude ?? 0;
+        const lng = data.longitude ?? 0;
+        const h3Cell = latLngToCell(lat, lng, 6); // Res-6: ~36 km²
+        return {
+            h3Cell,
+            city: data.city ?? 'Unknown',
+            country: data.country_name ?? 'Unknown',
+            lat,
+            lng,
+        };
+    }
+    catch {
+        // Fallback: Rome (GNS genesis location)
+        const lat = 41.8919;
+        const lng = 12.5113;
+        return {
+            h3Cell: latLngToCell(lat, lng, 6),
+            city: 'Unknown (geo offline)',
+            country: 'Unknown',
+            lat,
+            lng,
+        };
+    }
+}
+//# sourceMappingURL=hardware.js.map

package/dist/hardware.js.map

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

package/dist/identity.d.ts

@@ -0,0 +1,15 @@
+export interface HiveIdentity {
+    pk: string;
+    sk: string;
+    createdAt: string;
+}
+export declare function ensureHiveDir(): void;
+export declare function generateIdentity(): HiveIdentity;
+export declare function loadOrCreateIdentity(): {
+    identity: HiveIdentity;
+    isNew: boolean;
+};
+export declare function saveIdentity(identity: HiveIdentity): void;
+export declare function sign(identity: HiveIdentity, message: string): string;
+export declare function shortPk(pk: string): string;
+export declare function identityPath(): string;

package/dist/identity.js

@@ -0,0 +1,64 @@
+// ============================================================
+// HIVE WORKER — IDENTITY
+// Ed25519 keypair generation + local persistence
+// ~/.hive/identity.json
+// ============================================================
+import nacl from 'tweetnacl';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+const HIVE_DIR = path.join(os.homedir(), '.hive');
+const IDENTITY_FILE = path.join(HIVE_DIR, 'identity.json');
+function bytesToHex(bytes) {
+    return Array.from(bytes)
+        .map(b => b.toString(16).padStart(2, '0'))
+        .join('');
+}
+function hexToBytes(hex) {
+    const bytes = new Uint8Array(hex.length / 2);
+    for (let i = 0; i < hex.length; i += 2) {
+        bytes[i / 2] = parseInt(hex.substring(i, i + 2), 16);
+    }
+    return bytes;
+}
+export function ensureHiveDir() {
+    if (!fs.existsSync(HIVE_DIR)) {
+        fs.mkdirSync(HIVE_DIR, { recursive: true, mode: 0o700 });
+    }
+}
+export function generateIdentity() {
+    const keypair = nacl.sign.keyPair();
+    return {
+        pk: bytesToHex(keypair.publicKey),
+        sk: bytesToHex(keypair.secretKey),
+        createdAt: new Date().toISOString(),
+    };
+}
+export function loadOrCreateIdentity() {
+    ensureHiveDir();
+    if (fs.existsSync(IDENTITY_FILE)) {
+        const raw = fs.readFileSync(IDENTITY_FILE, 'utf-8');
+        const identity = JSON.parse(raw);
+        return { identity, isNew: false };
+    }
+    const identity = generateIdentity();
+    fs.writeFileSync(IDENTITY_FILE, JSON.stringify(identity, null, 2), { mode: 0o600 });
+    return { identity, isNew: true };
+}
+export function saveIdentity(identity) {
+    ensureHiveDir();
+    fs.writeFileSync(IDENTITY_FILE, JSON.stringify(identity, null, 2), { mode: 0o600 });
+}
+export function sign(identity, message) {
+    const sk = hexToBytes(identity.sk);
+    const msgBytes = new TextEncoder().encode(message);
+    const sig = nacl.sign.detached(msgBytes, sk);
+    return bytesToHex(sig);
+}
+export function shortPk(pk) {
+    return pk.slice(0, 8);
+}
+export function identityPath() {
+    return IDENTITY_FILE;
+}
+//# sourceMappingURL=identity.js.map

package/dist/identity.js.map

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

package/dist/jobs.d.ts

@@ -0,0 +1,53 @@
+export interface HiveJob {
+    id: string;
+    h3_cell: string;
+    jurisdiction: string | null;
+    model_id: string;
+    model_url: string | null;
+    layer_start: number;
+    layer_end: number;
+    prompt: string;
+    max_tokens: number;
+    temperature: number;
+    status: 'pending' | 'assigned' | 'computing' | 'completed' | 'failed' | 'timed_out';
+    worker_pk: string | null;
+    assigned_at: string | null;
+    result_text: string | null;
+    tokens_generated: number | null;
+    tokens_per_second: number | null;
+    completed_at: string | null;
+    error_message: string | null;
+    gns_reward: number;
+    settled: boolean;
+    stellar_tx_hash: string | null;
+    submitter_pk: string;
+    created_at: string;
+    timeout_at: string;
+}
+export interface JobResult {
+    resultText: string;
+    tokensGenerated: number;
+    tokensPerSecond: number;
+    error?: string;
+}
+export declare function claimJob(workerPk: string, h3Cell: string, modelId?: string): Promise<HiveJob | null>;
+export declare function markComputing(jobId: string): Promise<void>;
+export declare function postResult(jobId: string, result: JobResult): Promise<void>;
+export declare function postFailure(jobId: string, errorMsg: string): Promise<void>;
+export declare function cleanupTimedOutJobs(): Promise<void>;
+export declare function fetchJob(jobId: string): Promise<HiveJob | null>;
+export declare function fetchRecentCompletedJobs(workerPk: string, limit?: number): Promise<HiveJob[]>;
+export interface PollController {
+    stop: () => void;
+    isRunning: () => boolean;
+}
+export declare function startJobPoller(opts: {
+    workerPk: string;
+    h3Cell: string;
+    intervalMs: number;
+    onJobClaimed: (job: HiveJob) => void;
+    onJobCompleted: (job: HiveJob, result: JobResult) => void;
+    onJobFailed: (job: HiveJob, error: string) => void;
+    onLog: (msg: string) => void;
+    executor: (job: HiveJob) => Promise<JobResult>;
+}): PollController;

package/dist/jobs.js

@@ -0,0 +1,133 @@
+// ============================================================
+// HIVE WORKER — JOB QUEUE
+// Poll Supabase hive_jobs, claim atomically via FOR UPDATE
+// SKIP LOCKED (Postgres handles races — no app-level locking needed)
+// ============================================================
+const SUPABASE_URL = 'https://kaqwkxfaclyqjlfhxrmt.supabase.co';
+const SUPABASE_ANON = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImthcXdreGZhY2x5cWpsZmh4cm10Iiwicm9sZSI6ImFub24iLCJpYXQiOjE3NzI4MzU4NTAsImV4cCI6MjA4ODQxMTg1MH0.ClyWNGRxQjpKYzIROPZBqTXDsWvJioGe9pQymDOYBTc';
+const HEADERS = {
+    'apikey': SUPABASE_ANON,
+    'Authorization': `Bearer ${SUPABASE_ANON}`,
+    'Content-Type': 'application/json',
+};
+// ─── Claim (atomic via Postgres RPC) ─────────────────────────
+export async function claimJob(workerPk, h3Cell, modelId) {
+    const resp = await fetch(`${SUPABASE_URL}/rest/v1/rpc/claim_hive_job`, {
+        method: 'POST',
+        headers: HEADERS,
+        body: JSON.stringify({
+            p_worker_pk: workerPk,
+            p_h3_cell: h3Cell,
+            p_model_id: modelId ?? null,
+        }),
+    });
+    if (!resp.ok) {
+        const text = await resp.text();
+        throw new Error(`claimJob RPC failed: ${resp.status} ${text}`);
+    }
+    const rows = await resp.json();
+    return rows[0] ?? null;
+}
+// ─── Mark computing ───────────────────────────────────────────
+export async function markComputing(jobId) {
+    await patchJob(jobId, { status: 'computing' });
+}
+// ─── Post result ──────────────────────────────────────────────
+export async function postResult(jobId, result) {
+    await patchJob(jobId, {
+        status: 'completed',
+        result_text: result.resultText,
+        tokens_generated: result.tokensGenerated,
+        tokens_per_second: result.tokensPerSecond,
+        completed_at: new Date().toISOString(),
+        error_message: null,
+    });
+}
+// ─── Post failure ─────────────────────────────────────────────
+export async function postFailure(jobId, errorMsg) {
+    await patchJob(jobId, {
+        status: 'failed',
+        error_message: errorMsg,
+        completed_at: new Date().toISOString(),
+    });
+}
+// ─── Trigger timeout cleanup (call once per poll cycle) ───────
+export async function cleanupTimedOutJobs() {
+    await fetch(`${SUPABASE_URL}/rest/v1/rpc/timeout_stale_jobs`, {
+        method: 'POST',
+        headers: HEADERS,
+        body: JSON.stringify({}),
+    });
+}
+// ─── Fetch a specific job (for status watch) ──────────────────
+export async function fetchJob(jobId) {
+    const resp = await fetch(`${SUPABASE_URL}/rest/v1/hive_jobs?id=eq.${jobId}&select=*`, { headers: HEADERS });
+    if (!resp.ok)
+        return null;
+    const rows = await resp.json();
+    return rows[0] ?? null;
+}
+// ─── Fetch recent completed jobs for this worker ──────────────
+export async function fetchRecentCompletedJobs(workerPk, limit = 5) {
+    const resp = await fetch(`${SUPABASE_URL}/rest/v1/hive_jobs?worker_pk=eq.${workerPk}&status=eq.completed&order=completed_at.desc&limit=${limit}&select=*`, { headers: HEADERS });
+    if (!resp.ok)
+        return [];
+    return resp.json();
+}
+// ─── Patch helper ─────────────────────────────────────────────
+async function patchJob(jobId, fields) {
+    const resp = await fetch(`${SUPABASE_URL}/rest/v1/hive_jobs?id=eq.${jobId}`, {
+        method: 'PATCH',
+        headers: { ...HEADERS, 'Prefer': 'return=minimal' },
+        body: JSON.stringify(fields),
+    });
+    if (!resp.ok && resp.status !== 204) {
+        const text = await resp.text();
+        throw new Error(`patchJob failed: ${resp.status} ${text}`);
+    }
+}
+export function startJobPoller(opts) {
+    let running = true;
+    let busy = false;
+    const tick = async () => {
+        if (!running || busy)
+            return;
+        try {
+            // Run cleanup once per cycle
+            await cleanupTimedOutJobs().catch(() => { });
+            const job = await claimJob(opts.workerPk, opts.h3Cell);
+            if (!job)
+                return;
+            // Got one
+            busy = true;
+            opts.onJobClaimed(job);
+            try {
+                await markComputing(job.id);
+                const result = await opts.executor(job);
+                await postResult(job.id, result);
+                opts.onJobCompleted(job, result);
+            }
+            catch (execErr) {
+                const errMsg = execErr instanceof Error ? execErr.message : String(execErr);
+                await postFailure(job.id, errMsg).catch(() => { });
+                opts.onJobFailed(job, errMsg);
+                opts.onLog(`Job ${job.id.slice(0, 8)} failed: ${errMsg}`);
+            }
+            finally {
+                busy = false;
+            }
+        }
+        catch (pollErr) {
+            opts.onLog(`Poll error: ${pollErr instanceof Error ? pollErr.message : String(pollErr)}`);
+        }
+    };
+    const timer = setInterval(tick, opts.intervalMs);
+    return {
+        stop: () => {
+            running = false;
+            clearInterval(timer);
+        },
+        isRunning: () => running,
+    };
+}
+//# sourceMappingURL=jobs.js.map

package/dist/jobs.js.map

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