@nookplot/cli 0.7.45 → 0.7.46

package/dist/utils/categoryRatchet.js

@@ -0,0 +1,58 @@
+/**
+ * CategoryRatchet — TTL + LRU bounded replacement for the session-lifetime
+ * `loadedCategories` Set (perf roadmap Phase 5, LLM token diet).
+ *
+ * Every category loaded via browse_tools used to stay in the action surface
+ * for the life of the process, so long-running agents accumulated categories
+ * and every subsequent LLM prompt carried all of their action descriptions.
+ * The ratchet keeps at most MAX_LOADED_CATEGORIES recently-loaded categories,
+ * each for CATEGORY_TTL_MS since its last (re)load. Agents can always
+ * re-load an evicted category — browse_tools is a core action.
+ *
+ * `pin()` marks a category permanent (never evicted, never expired) — used
+ * for boot pre-seeds that must stay visible for the whole session.
+ *
+ * NOTE: duplicate of runtime/src/categoryRatchet.ts — the CLI builds
+ * against the published @nookplot/runtime package, so it cannot import new
+ * runtime source exports. Keep the two copies in sync.
+ *
+ * @module utils/categoryRatchet
+ */
+/** How long a browse_tools category stays in the action surface. */
+export const CATEGORY_TTL_MS = 30 * 60 * 1000;
+/** Max unpinned categories kept at once (oldest-loaded evicted first). */
+export const MAX_LOADED_CATEGORIES = 4;
+export class CategoryRatchet {
+    /** Permanently visible categories (boot pre-seeds). */
+    pinned = new Set();
+    /** name → last load time. Map insertion order doubles as LRU order. */
+    loaded = new Map();
+    /** Mark a category permanent — never TTL-expired, never LRU-evicted. */
+    pin(name) {
+        this.pinned.add(name);
+        this.loaded.delete(name);
+    }
+    /** Record a category load. Refreshes TTL/recency; evicts LRU beyond cap. */
+    add(name) {
+        if (this.pinned.has(name))
+            return;
+        this.loaded.delete(name); // re-insert so Map order reflects recency
+        this.loaded.set(name, Date.now());
+        while (this.loaded.size > MAX_LOADED_CATEGORIES) {
+            const oldest = this.loaded.keys().next().value;
+            if (oldest === undefined)
+                break;
+            this.loaded.delete(oldest);
+        }
+    }
+    /** Live view for getAvailableActionsFromMap: pinned ∪ unexpired loads. */
+    snapshot() {
+        const now = Date.now();
+        for (const [name, loadedAt] of this.loaded) {
+            if (now - loadedAt > CATEGORY_TTL_MS)
+                this.loaded.delete(name);
+        }
+        return new Set([...this.pinned, ...this.loaded.keys()]);
+    }
+}
+//# sourceMappingURL=categoryRatchet.js.map

package/dist/utils/categoryRatchet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"categoryRatchet.js","sourceRoot":"","sources":["../../src/utils/categoryRatchet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,oEAAoE;AACpE,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAE9C,0EAA0E;AAC1E,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAEvC,MAAM,OAAO,eAAe;IAC1B,uDAAuD;IACtC,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IAC5C,uEAAuE;IACtD,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEpD,wEAAwE;IACxE,GAAG,CAAC,IAAY;QACd,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,4EAA4E;IAC5E,GAAG,CAAC,IAAY;QACd,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO;QAClC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,0CAA0C;QACpE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,qBAAqB,EAAE,CAAC;YAChD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAC/C,IAAI,MAAM,KAAK,SAAS;gBAAE,MAAM;YAChC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,0EAA0E;IAC1E,QAAQ;QACN,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC3C,IAAI,GAAG,GAAG,QAAQ,GAAG,eAAe;gBAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC1D,CAAC;CACF"}

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,56 +1,56 @@
-{
-  "name": "@nookplot/cli",
-  "version": "0.7.45",
-  "description": "CLI toolkit for NookPlot agent developers — scaffold, register, sync, and monitor agents",
-  "author": "nookplot",
-  "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "publishConfig": {
-    "access": "public"
-  },
-  "bin": {
-    "nookplot": "dist/index.js"
-  },
-  "scripts": {
-    "build": "tsc && cp src/tool-manifest.json dist/tool-manifest.json && cp src/evalManifest.json dist/evalManifest.json",
-    "clean": "rm -rf dist",
-    "dev": "tsx src/index.ts",
-    "test": "vitest run",
-    "postinstall": "node dist/postinstall.js 2>/dev/null || true"
-  },
-  "dependencies": {
-    "@nookplot/runtime": "^0.5.151",
-    "chalk": "5.6.2",
-    "commander": "12.1.0",
-    "dotenv": "16.6.1",
-    "ethers": "6.16.0",
-    "glob": "11.1.0",
-    "inquirer": "12.11.1",
-    "js-yaml": "4.1.1",
-    "ora": "8.2.0"
-  },
-  "peerDependencies": {
-    "@xmtp/agent-sdk": ">=0.1.0"
-  },
-  "peerDependenciesMeta": {
-    "@xmtp/agent-sdk": {
-      "optional": true
-    }
-  },
-  "devDependencies": {
-    "@types/inquirer": "^9.0.7",
-    "@types/js-yaml": "^4.0.9",
-    "@types/node": "20.14.10",
-    "typescript": "5.5.4",
-    "vitest": "3.0.5"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "license": "MIT"
-}
+{
+  "name": "@nookplot/cli",
+  "version": "0.7.46",
+  "description": "CLI toolkit for NookPlot agent developers — scaffold, register, sync, and monitor agents",
+  "author": "nookplot",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "nookplot": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc && cp src/tool-manifest.json dist/tool-manifest.json && cp src/evalManifest.json dist/evalManifest.json",
+    "clean": "rm -rf dist",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "postinstall": "node dist/postinstall.js 2>/dev/null || true"
+  },
+  "dependencies": {
+    "@nookplot/runtime": "^0.5.151",
+    "chalk": "5.6.2",
+    "commander": "12.1.0",
+    "dotenv": "16.6.1",
+    "ethers": "6.16.0",
+    "glob": "11.1.0",
+    "inquirer": "12.11.1",
+    "js-yaml": "4.1.1",
+    "ora": "8.2.0"
+  },
+  "peerDependencies": {
+    "@xmtp/agent-sdk": ">=0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@xmtp/agent-sdk": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/inquirer": "^9.0.7",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "20.14.10",
+    "typescript": "5.5.4",
+    "vitest": "3.0.5"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "license": "MIT"
+}