dsh-context-mode 0.5.2 → 0.5.3

package/README.md

@@ -8,8 +8,9 @@ DeepSeek Harness tools. It registers the full `ctx_*` catalog at runtime and
 adds model-facing routing guidance, so dsh-TUI can use sandboxed execution,
 indexing, FTS5 retrieval, and web fetching without a second MCP client. It also
 registers the eight user-invocable skills from the upstream package, so the
-DSH skill surface includes `/context-mode`, `/ctx-doctor`, `/ctx-index`,
-`/ctx-insight`, `/ctx-purge`, `/ctx-search`, `/ctx-stats`, and `/ctx-upgrade`.
+DSH skill surface includes `/context-mode`, `/ctx-index`, `/ctx-purge`,
+`/ctx-search`, and `/ctx-upgrade`; the diagnostics, analytics, and statistics
+skills are off by default with their tools.
 
 > **Part of a pair.** This is the *tool* half: the `ctx_*` tools, plus the
 > archiver that files each compaction's transcript into the knowledge base.
@@ -77,6 +78,7 @@ The default patch starts the bridge with:
 - the current working directory as the project directory
 - `~/.dsh/context-mode` as the isolated database root
 - a 60-second initialize and tool-catalog timeout
+- `disabledTools: [ctx_doctor, ctx_insight, ctx_stats]`
 
 Override the row's `config` in a profile patch when needed:
 
@@ -88,8 +90,20 @@ Override the row's `config` in a profile patch when needed:
     projectDir: /absolute/path/to/worktree
     storageDir: /absolute/path/to/context-mode-data
     handshakeTimeoutMs: 120000
+    disabledTools: []          # opt the maintenance tools back in
 ```
 
+### Why some tools are off by default
+
+Every registered tool ships its full schema on every request, so a tool nobody
+calls is a permanent token tax. `ctx_doctor`, `ctx_insight`, and `ctx_stats`
+report on context-mode itself rather than on the user's work — a human runs
+them deliberately. Their skills are suppressed with them, since a skill that
+teaches a model to call an unregistered tool helps nobody.
+
+The tools behind `disabledTools` stay in the vendored engine; only their DSH
+registration is skipped. Set `disabledTools: []` to restore all eleven.
+
 `serverPath` is available for local development and pinned deployments. It may
 be an absolute path or a path relative to the profile process directory.
 
@@ -103,10 +117,12 @@ when the Cordis plugin is disposed.
 Context-mode analysis, indexing, search, and diagnostics tools are marked concurrency-safe so independent model tool calls may overlap. `ctx_insight`, `ctx_purge`, and `ctx_upgrade` remain exclusive because they open external UI or mutate installation and stored data.
 `ctx_batch_execute` additionally parallelizes its own command batch through its `concurrency` parameter.
 
-All eleven `ctx_*` capabilities are exposed on DSH — `ctx_execute`,
-`ctx_execute_file`, `ctx_batch_execute`, `ctx_fetch_and_index`, `ctx_index`,
-`ctx_search`, `ctx_stats`, `ctx_doctor`, `ctx_upgrade`, `ctx_purge`, and
-`ctx_insight`. Each registered tool carries DSH-specific routing guidance in its
+Eight of the eleven `ctx_*` capabilities are exposed on DSH by default —
+`ctx_execute`, `ctx_execute_file`, `ctx_batch_execute`, `ctx_fetch_and_index`,
+`ctx_index`, `ctx_search`, `ctx_upgrade`, and `ctx_purge`. `ctx_stats`,
+`ctx_doctor`, and `ctx_insight` are held back by `disabledTools` (see
+[Configuration](#configuration)). Each registered tool carries DSH-specific
+routing guidance in its
 description, and the plugin injects a routing section plus a bundled
 `context-mode` skill so the model reaches for these tools by default.
 

package/lib/types/index.d.ts

@@ -24,6 +24,15 @@ export interface Config {
      * `ctx_search` can still reach what the compaction summary drops.
      */
     precompact?: boolean;
+    /**
+     * Tool names to keep out of the model's catalog and the skill list.
+     *
+     * Every registered tool ships its full schema on every request, so a tool
+     * nobody calls is a permanent token tax. Defaults to the maintenance-only
+     * tools: diagnostics, analytics, and statistics are things a human runs
+     * deliberately, not something the model should reach for mid-task.
+     */
+    disabledTools?: string[];
 }
 export declare const Config: Schemastery<Config>;
 export declare const ROUTING_TEXT: string;

package/lib/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAYlD,eAAO,MAAM,IAAI,qBAAqB,CAAA;AAEtC,qDAAqD;AACrD,MAAM,WAAW,MAAM;IACrB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,eAAO,MAAM,MAAM,EAAE,WAAW,CAAC,MAAM,CAOrC,CAAA;AAWF,eAAO,MAAM,YAAY,QAMb,CAAA;AA6EZ,+EAA+E;AAC/E,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,MAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAoF5E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAYlD,eAAO,MAAM,IAAI,qBAAqB,CAAA;AAEtC,qDAAqD;AACrD,MAAM,WAAW,MAAM;IACrB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;CACzB;AAWD,eAAO,MAAM,MAAM,EAAE,WAAW,CAAC,MAAM,CAQrC,CAAA;AAWF,eAAO,MAAM,YAAY,QAMb,CAAA;AA6EZ,+EAA+E;AAC/E,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,MAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAsF5E"}

package/lib/types/index.js

@@ -17,6 +17,14 @@ import { installPrecompactArchive } from './precompact.js';
 import { installBashRoutingGuard } from './routing.js';
 import { installSessionMemory } from './session-memory.js';
 export const name = 'dsh-context-mode';
+/**
+ * Maintenance-only tools that are off unless a deployment opts back in.
+ *
+ * `ctx_doctor`, `ctx_insight`, and `ctx_stats` report on context-mode itself;
+ * the model has never needed them to do the user's work, and each one's schema
+ * is carried on every request.
+ */
+const DEFAULT_DISABLED_TOOLS = ['ctx_doctor', 'ctx_insight', 'ctx_stats'];
 export const Config = z.object({
     enabled: z.boolean().default(true),
     serverPath: z.string().default(''),
@@ -24,6 +32,7 @@ export const Config = z.object({
     storageDir: z.string().default(''),
     handshakeTimeoutMs: z.number().step(1).min(1_000).default(60_000),
     precompact: z.boolean().default(true),
+    disabledTools: z.array(z.string()).default([...DEFAULT_DISABLED_TOOLS]),
 });
 const OUTPUT_SCHEMA = {
     type: 'object',
@@ -108,6 +117,7 @@ export async function apply(ctx, config = {}) {
         storageDir: config.storageDir?.trim() || join(homedir(), '.dsh', 'context-mode'),
         handshakeTimeoutMs: config.handshakeTimeoutMs ?? 60_000,
         precompact: config.precompact ?? true,
+        disabledTools: new Set(config.disabledTools ?? DEFAULT_DISABLED_TOOLS),
     };
     if (!resolved.enabled)
         return;
@@ -133,7 +143,7 @@ export async function apply(ctx, config = {}) {
     disposers.push(memoryDisposer);
     const precompactDisposer = installPrecompactArchive(ctx, () => client, { enabled: resolved.precompact });
     disposers.push(precompactDisposer);
-    const skillDisposer = registerBundledSkills(ctx);
+    const skillDisposer = registerBundledSkills(ctx, resolved.disabledTools);
     if (skillDisposer !== undefined)
         disposers.push(skillDisposer);
     try {
@@ -156,6 +166,8 @@ export async function apply(ctx, config = {}) {
         for (const tool of catalog) {
             if (disposed)
                 return;
+            if (resolved.disabledTools.has(tool.name))
+                continue;
             try {
                 disposers.push(tools.register(toDefinition(tool, bridge)));
             }
@@ -179,12 +191,16 @@ export async function apply(ctx, config = {}) {
         ctx.logger.warn(`dsh-context-mode: bridge unavailable; plugin is inactive (${errorMessage(error)})`);
     }
 }
-function registerBundledSkills(ctx) {
+function registerBundledSkills(ctx, disabledTools) {
     const skills = ctx.get('skills', false);
     if (skills === undefined)
         return undefined;
     const disposers = [];
     for (const skill of BUNDLED_SKILLS) {
+        // A skill whose tool is not registered would only teach the model to call
+        // something that is not there.
+        if (skill.name !== name && disabledTools.has(skill.name.replace(/-/g, '_')))
+            continue;
         try {
             const content = readFileSync(new URL(`../../${skill.path}`, import.meta.url), 'utf8');
             disposers.push(skills.register({ ...skill, content }));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-context-mode",
-  "version": "0.5.2",
+  "version": "0.5.3",
   "description": "Expose context-mode MCP tools as native DeepSeek Harness tools",
   "keywords": [
     "dsh",