compact-agent 1.13.0 → 1.15.0

package/dist/tools/skill.d.ts

@@ -0,0 +1,27 @@
+/**
+ * skill_view tool — the Level-1 step in the progressive-disclosure
+ * skill schema (M2 item 3, from the Hermes audit).
+ *
+ * Background. The system prompt used to inject the FULL prompt body of
+ * the best-matching ECC skill on every turn (up to 4KB). With 228
+ * skills bundled, even injecting only one match costs a lot of tokens
+ * for every interaction. Hermes Agent solves this with three loading
+ * levels:
+ *
+ *   Level 0 — names + one-line descriptions ONLY in system prompt
+ *             (~30-60 chars per skill × top-3 = ~200 char overhead)
+ *   Level 1 — full prompt body, loaded on demand by skill_view(name)
+ *   Level 2 — referenced sub-files inside a skill (not implemented;
+ *             our skills are flat one-file SKILL.md units)
+ *
+ * The model sees Level 0 candidates and decides whether to escalate.
+ * If a skill name looks irrelevant, it skips the lookup entirely. If
+ * a skill clearly fits, one tool call gets the full text. Net effect
+ * for most turns: lower system-prompt cost, occasional one-turn
+ * expansion when a skill is actually needed.
+ *
+ * skill_view is read-only and non-destructive, so it bypasses every
+ * permission gate.
+ */
+import type { Tool } from './types.js';
+export declare const SkillViewTool: Tool;

package/dist/tools/skill.js

@@ -0,0 +1,74 @@
+/**
+ * skill_view tool — the Level-1 step in the progressive-disclosure
+ * skill schema (M2 item 3, from the Hermes audit).
+ *
+ * Background. The system prompt used to inject the FULL prompt body of
+ * the best-matching ECC skill on every turn (up to 4KB). With 228
+ * skills bundled, even injecting only one match costs a lot of tokens
+ * for every interaction. Hermes Agent solves this with three loading
+ * levels:
+ *
+ *   Level 0 — names + one-line descriptions ONLY in system prompt
+ *             (~30-60 chars per skill × top-3 = ~200 char overhead)
+ *   Level 1 — full prompt body, loaded on demand by skill_view(name)
+ *   Level 2 — referenced sub-files inside a skill (not implemented;
+ *             our skills are flat one-file SKILL.md units)
+ *
+ * The model sees Level 0 candidates and decides whether to escalate.
+ * If a skill name looks irrelevant, it skips the lookup entirely. If
+ * a skill clearly fits, one tool call gets the full text. Net effect
+ * for most turns: lower system-prompt cost, occasional one-turn
+ * expansion when a skill is actually needed.
+ *
+ * skill_view is read-only and non-destructive, so it bypasses every
+ * permission gate.
+ */
+import { findEccSkillByName } from '../ecc.js';
+export const SkillViewTool = {
+    name: 'skill_view',
+    description: 'Load the FULL prompt body of a bundled skill by name. The system prompt ' +
+        'lists relevant skills as names + one-line descriptions (Level 0 disclosure); ' +
+        'call this tool to read the full skill content (Level 1) when one of those ' +
+        'names looks like it applies to the current request. Returns the skill\'s ' +
+        'description + full prompt text. Use the exact name from the system prompt ' +
+        'or any unique substring.',
+    parameters: {
+        type: 'object',
+        properties: {
+            name: {
+                type: 'string',
+                description: 'Skill name (exact or unique substring, case-insensitive)',
+            },
+        },
+        required: ['name'],
+    },
+    isReadOnly: true,
+    isDestructive: false,
+    async call(input) {
+        try {
+            const name = String(input.name || '').trim();
+            if (!name)
+                return { output: 'Error: name required.', isError: true };
+            const skill = findEccSkillByName(name);
+            if (!skill) {
+                return { output: `No skill matches "${name}". Check the Level-0 list in the system prompt for available names.`, isError: false };
+            }
+            const out = [
+                `# ${skill.name}`,
+                '',
+                `**Category:** ${skill.category}`,
+                `**Triggers:** ${skill.triggers.slice(0, 8).join(', ')}${skill.triggers.length > 8 ? '…' : ''}`,
+                `**Description:** ${skill.description}`,
+                '',
+                '---',
+                '',
+                skill.prompt,
+            ];
+            return { output: out.join('\n'), isError: false };
+        }
+        catch (e) {
+            return { output: `Error loading skill: ${e instanceof Error ? e.message : e}`, isError: true };
+        }
+    },
+};
+//# sourceMappingURL=skill.js.map

package/dist/tools/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../src/tools/skill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,MAAM,CAAC,MAAM,aAAa,GAAS;IACjC,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,0EAA0E;QAC1E,+EAA+E;QAC/E,4EAA4E;QAC5E,2EAA2E;QAC3E,4EAA4E;QAC5E,0BAA0B;IAC5B,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0DAA0D;aACxE;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;IACD,UAAU,EAAE,IAAI;IAChB,aAAa,EAAE,KAAK;IAEpB,KAAK,CAAC,IAAI,CAAC,KAAK;QACd,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAC7C,IAAI,CAAC,IAAI;gBAAE,OAAO,EAAE,MAAM,EAAE,uBAAuB,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACrE,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;YACvC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,EAAE,MAAM,EAAE,qBAAqB,IAAI,qEAAqE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YACpI,CAAC;YACD,MAAM,GAAG,GAAa;gBACpB,KAAK,KAAK,CAAC,IAAI,EAAE;gBACjB,EAAE;gBACF,iBAAiB,KAAK,CAAC,QAAQ,EAAE;gBACjC,iBAAiB,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBAC/F,oBAAoB,KAAK,CAAC,WAAW,EAAE;gBACvC,EAAE;gBACF,KAAK;gBACL,EAAE;gBACF,KAAK,CAAC,MAAM;aACb,CAAC;YACF,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACpD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,EAAE,MAAM,EAAE,wBAAwB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACjG,CAAC;IACH,CAAC;CACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "compact-agent",
-  "version": "1.13.0",
+  "version": "1.15.0",
   "description": "A dense, feature-rich AI coding agent for the terminal. Built-in voice dictation (Whisper) + TTS readout (ElevenLabs) + screen-reader mode for blind / low-vision users. 80+ slash commands, 9 modes including Hermes self-improving loop, multi-agent orchestration, bundled everything-claude-code skills library, learning system, and observable LLM transport. Works with OpenRouter, OpenAI, Anthropic-compatible, Ollama, LM Studio, DeepSeek, or any OpenAI-compatible API.",
   "type": "module",
   "license": "MIT",