@nookplot/cli 0.7.11 → 0.7.15

package/dist/utils/miningCapabilities.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Mining capability detection for `nookplot mine`.
+ *
+ * Probes the local environment to determine which mining tracks are eligible:
+ *   - knowledge: any reasoning LLM (Anthropic / OpenAI / local Ollama)
+ *   - embedding: Ollama with nomic-embed-text installed
+ *   - rlm:       reasoning LLM + Python sandbox (E2B/local interpreter)
+ *   - gradient:  GPU presence (informational only — no solver yet)
+ *
+ * Detection runs on `nookplot mine` startup, on SIGHUP (manual re-detect),
+ * and every {@link CAPABILITY_REFRESH_INTERVAL_MS} thereafter so the loop
+ * picks up newly-installed Ollama models / rotated keys without restart.
+ *
+ * @module utils/miningCapabilities
+ */
+export type MiningTrack = "knowledge" | "embedding" | "rlm" | "gradient";
+export interface MiningCapability {
+    track: MiningTrack;
+    enabled: boolean;
+    reason?: string;
+    /** Detected provider that satisfied this capability (if enabled). */
+    provider?: string;
+}
+/** Capability re-detection cadence (1h). SIGHUP forces immediate re-detect. */
+export declare const CAPABILITY_REFRESH_INTERVAL_MS: number;
+/**
+ * Detect all four mining capabilities. Pure function (no side effects beyond
+ * network probes). Safe to call repeatedly; each call re-probes everything.
+ */
+export declare function detectCapabilities(): Promise<MiningCapability[]>;
+/**
+ * Convenience: returns true if any mining track is enabled. The loop should
+ * exit early when this is false rather than burning CPU on a doomed loop.
+ */
+export declare function anyEnabled(caps: MiningCapability[]): boolean;
+/** Filter to enabled capabilities, preserving order. */
+export declare function enabledTracks(caps: MiningCapability[]): MiningTrack[];
+/**
+ * Returns the first reasoning provider available, or null if none. Order:
+ *   1. ANTHROPIC_API_KEY
+ *   2. OPENAI_API_KEY
+ *   3. Ollama with a model in REASONING_MODEL_PREFIXES
+ */
+export declare function detectReasoningProvider(): Promise<string | null>;
+/**
+ * Returns the list of Ollama-installed model names, or [] if Ollama is not
+ * running. Never throws — a 2s timeout protects against slow boots.
+ */
+export declare function listOllamaModels(): Promise<string[]>;
+/**
+ * Returns true if `python3` is in PATH and runs. Exit code is the only
+ * signal — we don't care about the version string.
+ */
+export declare function hasPython(): Promise<boolean>;
+/**
+ * Returns a short identifier of detected GPU vendor or null. The gradient
+ * track ships disabled regardless — this is purely UI signal.
+ */
+export declare function detectGpu(): Promise<string | null>;

package/dist/utils/miningCapabilities.js

@@ -0,0 +1,176 @@
+/**
+ * Mining capability detection for `nookplot mine`.
+ *
+ * Probes the local environment to determine which mining tracks are eligible:
+ *   - knowledge: any reasoning LLM (Anthropic / OpenAI / local Ollama)
+ *   - embedding: Ollama with nomic-embed-text installed
+ *   - rlm:       reasoning LLM + Python sandbox (E2B/local interpreter)
+ *   - gradient:  GPU presence (informational only — no solver yet)
+ *
+ * Detection runs on `nookplot mine` startup, on SIGHUP (manual re-detect),
+ * and every {@link CAPABILITY_REFRESH_INTERVAL_MS} thereafter so the loop
+ * picks up newly-installed Ollama models / rotated keys without restart.
+ *
+ * @module utils/miningCapabilities
+ */
+import { spawn } from "node:child_process";
+import { platform } from "node:os";
+/** Capability re-detection cadence (1h). SIGHUP forces immediate re-detect. */
+export const CAPABILITY_REFRESH_INTERVAL_MS = 60 * 60 * 1000;
+/** Ollama default port. */
+const OLLAMA_BASE = "http://127.0.0.1:11434";
+/** Models that count as "reasoning-capable" for knowledge / RLM tracks. */
+const REASONING_MODEL_PREFIXES = [
+    "hermes", "llama3", "qwen", "mistral", "deepseek",
+    "phi", "gemma", "command", "yi", "mixtral",
+];
+/** Embedding models the embedding track can use. */
+const EMBEDDING_MODELS = ["nomic-embed-text"];
+// ── Public API ──────────────────────────────────────────────────────────
+/**
+ * Detect all four mining capabilities. Pure function (no side effects beyond
+ * network probes). Safe to call repeatedly; each call re-probes everything.
+ */
+export async function detectCapabilities() {
+    const reasoning = await detectReasoningProvider();
+    const ollamaModels = await listOllamaModels();
+    const embeddingModel = ollamaModels.find((m) => EMBEDDING_MODELS.some((e) => m.startsWith(e)));
+    const pythonAvailable = await hasPython();
+    const gpu = await detectGpu();
+    const knowledge = reasoning
+        ? { track: "knowledge", enabled: true, provider: reasoning }
+        : { track: "knowledge", enabled: false, reason: "No LLM available — set ANTHROPIC_API_KEY, OPENAI_API_KEY, or run Ollama with a reasoning model" };
+    const embedding = embeddingModel
+        ? { track: "embedding", enabled: true, provider: `ollama (${embeddingModel})` }
+        : { track: "embedding", enabled: false, reason: "Run: ollama pull nomic-embed-text" };
+    const rlm = !reasoning
+        ? { track: "rlm", enabled: false, reason: "RLM needs an LLM — set ANTHROPIC_API_KEY, OPENAI_API_KEY, or run Ollama" }
+        : !pythonAvailable
+            ? { track: "rlm", enabled: false, reason: "RLM needs Python 3 in PATH for sandbox execution" }
+            : { track: "rlm", enabled: true, provider: `${reasoning} + python` };
+    const gradient = gpu
+        ? { track: "gradient", enabled: false, reason: "GPU detected — gradient mining solver coming in a future phase", provider: gpu }
+        : { track: "gradient", enabled: false, reason: "No GPU detected" };
+    return [knowledge, embedding, rlm, gradient];
+}
+/**
+ * Convenience: returns true if any mining track is enabled. The loop should
+ * exit early when this is false rather than burning CPU on a doomed loop.
+ */
+export function anyEnabled(caps) {
+    return caps.some((c) => c.enabled);
+}
+/** Filter to enabled capabilities, preserving order. */
+export function enabledTracks(caps) {
+    return caps.filter((c) => c.enabled).map((c) => c.track);
+}
+// ── Reasoning provider detection (env vars + Ollama) ─────────────────────
+/**
+ * Returns the first reasoning provider available, or null if none. Order:
+ *   1. ANTHROPIC_API_KEY
+ *   2. OPENAI_API_KEY
+ *   3. Ollama with a model in REASONING_MODEL_PREFIXES
+ */
+export async function detectReasoningProvider() {
+    if (process.env.ANTHROPIC_API_KEY)
+        return "anthropic";
+    if (process.env.OPENAI_API_KEY)
+        return "openai";
+    const models = await listOllamaModels();
+    for (const m of models) {
+        if (REASONING_MODEL_PREFIXES.some((p) => m.toLowerCase().includes(p))) {
+            return `ollama (${m})`;
+        }
+    }
+    return null;
+}
+// ── Ollama probe ─────────────────────────────────────────────────────────
+/**
+ * Returns the list of Ollama-installed model names, or [] if Ollama is not
+ * running. Never throws — a 2s timeout protects against slow boots.
+ */
+export async function listOllamaModels() {
+    try {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 2000);
+        const res = await fetch(`${OLLAMA_BASE}/api/tags`, { signal: controller.signal });
+        clearTimeout(timeout);
+        if (!res.ok)
+            return [];
+        const body = (await res.json());
+        return (body.models ?? []).map((m) => m.name);
+    }
+    catch {
+        return [];
+    }
+}
+// ── Python sandbox probe ─────────────────────────────────────────────────
+/**
+ * Returns true if `python3` is in PATH and runs. Exit code is the only
+ * signal — we don't care about the version string.
+ */
+export async function hasPython() {
+    return runWithExitCode("python3", ["--version"], 1500);
+}
+// ── GPU probe (informational) ────────────────────────────────────────────
+/**
+ * Returns a short identifier of detected GPU vendor or null. The gradient
+ * track ships disabled regardless — this is purely UI signal.
+ */
+export async function detectGpu() {
+    const os = platform();
+    if (os === "darwin") {
+        // Apple silicon — `system_profiler SPDisplaysDataType` lists GPU. Quicker:
+        // assume any darwin host has at least integrated GPU. We treat M1/M2/M3
+        // as detected because Metal is always present.
+        return process.arch === "arm64" ? "apple-silicon" : null;
+    }
+    if (os === "linux" || os === "win32") {
+        if (await runWithExitCode("nvidia-smi", ["--query-gpu=name", "--format=csv,noheader"], 1500)) {
+            return "nvidia";
+        }
+        if (await runWithExitCode("rocminfo", ["--noversion"], 1500)) {
+            return "amd";
+        }
+    }
+    return null;
+}
+// ── Helpers ──────────────────────────────────────────────────────────────
+function runWithExitCode(cmd, args, timeoutMs) {
+    return new Promise((resolve) => {
+        let settled = false;
+        let child;
+        try {
+            child = spawn(cmd, args, { stdio: "ignore" });
+        }
+        catch {
+            resolve(false);
+            return;
+        }
+        const timeout = setTimeout(() => {
+            if (!settled) {
+                settled = true;
+                try {
+                    child.kill("SIGKILL");
+                }
+                catch { /* ignore */ }
+                resolve(false);
+            }
+        }, timeoutMs);
+        child.on("error", () => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timeout);
+            resolve(false);
+        });
+        child.on("exit", (code) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timeout);
+            resolve(code === 0);
+        });
+    });
+}
+//# sourceMappingURL=miningCapabilities.js.map

package/dist/utils/miningCapabilities.js.map

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

package/dist/utils/skills.js

@@ -223,18 +223,18 @@ export function extractCapabilities(skills) {
  * Generate a starter skills.yaml content string.
  */
 export function generateStarterSkillsYaml() {
-    return `# skills.yaml — Declarative skill definitions for your Nookplot agent
-#
-# Each skill becomes a marketplace listing and updates your agent's profile.
-# Run \`nookplot skills sync\` to publish changes to the network.
-
-skills:
-  - name: example-skill
-    description: "Describe what this skill does"
-    category: ai
-    # price: "0.50"          # USDC per task (optional — omit for free)
-    # pricingModel: per-task  # per-task | hourly | subscription | custom
-    tags: [example]
+    return `# skills.yaml — Declarative skill definitions for your Nookplot agent
+#
+# Each skill becomes a marketplace listing and updates your agent's profile.
+# Run \`nookplot skills sync\` to publish changes to the network.
+
+skills:
+  - name: example-skill
+    description: "Describe what this skill does"
+    category: ai
+    # price: "0.50"          # USDC per task (optional — omit for free)
+    # pricingModel: per-task  # per-task | hourly | subscription | custom
+    tags: [example]
 `;
 }
 //# sourceMappingURL=skills.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nookplot/cli",
-  "version": "0.7.11",
+  "version": "0.7.15",
   "description": "CLI toolkit for NookPlot agent developers — scaffold, register, sync, and monitor agents",
   "author": "nookplot",
   "type": "module",
@@ -24,7 +24,7 @@
     "postinstall": "node dist/postinstall.js 2>/dev/null || true"
   },
   "dependencies": {
-    "@nookplot/runtime": "^0.5.72",
+    "@nookplot/runtime": "^0.5.118",
     "chalk": "5.6.2",
     "commander": "12.1.0",
     "dotenv": "16.6.1",