@dungle-scrubs/harness-cli-normalizer 0.4.6 → 0.5.0

package/dist/interpretation/support.js.map

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

package/dist/interpretation/tool-selection.d.ts

@@ -1,29 +1,19 @@
 /**
- * Tool-selection rendering: turns normalized include/exclude lists into the
- * per-harness argv tokens, per decisions D1-D3 and the Phase 0 evidence.
- *
- * Semantics:
- * - include: exact allowlist over the descriptor's curated names. pi's flag
- *   is strict over built-ins, rendered directly. claude's include flag only
- *   pre-approves without restricting the visible set, so an exact allowlist
- *   on claude renders as a deny-complement (all known minus included).
- * - exclude: the complement of the named tools over all descriptor-known
- *   names (D2). pi's native exclude subtracts from its default set (4
- *   tools), so a D2 exclude renders as a computed include list there.
- * - mutual exclusion (D1): both flags in one call refuse.
- * - extensible rule (D3): curated names validate and map; unknown
- *   clean-selector names pass through and are reported as unmapped so
- *   provenance can surface them.
+ * Tool-selection rendering with canonical vocabulary.
  */
 import type { HarnessDescriptor } from "../knowledge/descriptor.js";
 export declare const TOOL_SELECTOR: RegExp;
 export interface ToolSelection {
     readonly include?: readonly string[];
     readonly exclude?: readonly string[];
+    readonly toolMap?: Readonly<Record<string, string>>;
 }
 export interface RenderedToolSelection {
     readonly tokens: readonly string[];
-    readonly unmapped: readonly string[];
+    readonly passthrough: readonly string[];
 }
+export declare const renderAccessPreset: (h: HarnessDescriptor, access: "read" | "write", opts?: {
+    toolMap?: Readonly<Record<string, string>>;
+}) => string[];
 export declare const renderToolSelection: (h: HarnessDescriptor, selection: ToolSelection) => RenderedToolSelection;
 //# sourceMappingURL=tool-selection.d.ts.map

package/dist/interpretation/tool-selection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-selection.d.ts","sourceRoot":"","sources":["../../src/interpretation/tool-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAKpE,eAAO,MAAM,aAAa,QAA0C,CAAC;AAErE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAwCD,eAAO,MAAM,mBAAmB,MAC3B,iBAAiB,aACT,aAAa,KACvB,qBA8GF,CAAC"}
+{"version":3,"file":"tool-selection.d.ts","sourceRoot":"","sources":["../../src/interpretation/tool-selection.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAgBpE,eAAO,MAAM,aAAa,QAA0C,CAAC;AAErE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAkCD,eAAO,MAAM,kBAAkB,MAC1B,iBAAiB,UACZ,MAAM,GAAG,OAAO,SAClB;IAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAAE,KACnD,MAAM,EAkBR,CAAC;AAEF,eAAO,MAAM,mBAAmB,MAC3B,iBAAiB,aACT,aAAa,KACvB,qBA0NF,CAAC"}

package/dist/interpretation/tool-selection.js

@@ -1,46 +1,61 @@
 import { defaultDescriptors } from "../knowledge/overrides.js";
+import { hintFor } from "./hints.js";
 import { ArgvRefusalError } from "./refusal.js";
-import { supportedBy } from "./support.js";
+import { supportedBy, supportedByCanonical } from "./support.js";
+import { allCanonicalNames, canonicalTable, parseToolSelector, READ_PRESET, } from "./tool-vocabulary.js";
 export const TOOL_SELECTOR = /^[A-Za-z0-9][A-Za-z0-9._:/@-]{0,127}$/;
-const validateNames = (h, names) => {
-    for (const name of names) {
-        if (name.trim() === "" || name.includes(",")) {
-            throw new ArgvRefusalError({
-                issue: "invalid-tool-grant",
-                harness: h.name,
-                supported: ["non-empty, comma-free tool names"],
-                detail: `tools=${JSON.stringify(names)}`,
-            });
-        }
-        if (!TOOL_SELECTOR.test(name)) {
-            throw new ArgvRefusalError({
-                issue: "invalid-tool-grant",
-                harness: h.name,
-                supported: [`must match ${TOOL_SELECTOR.source}`],
-                detail: name,
-            });
-        }
+const validateInnerName = (h, name, raw) => {
+    if (name.trim() === "" || name.includes(",")) {
+        throw new ArgvRefusalError({
+            issue: "invalid-tool-grant",
+            harness: h.name,
+            supported: ["non-empty, comma-free tool names"],
+            detail: `tools=${JSON.stringify(raw)}`,
+        });
     }
-    return [...names];
+    if (!TOOL_SELECTOR.test(name)) {
+        throw new ArgvRefusalError({
+            issue: "invalid-tool-grant",
+            harness: h.name,
+            supported: [`must match ${TOOL_SELECTOR.source}`],
+            detail: name,
+        });
+    }
+};
+const categoriesFor = (h, canonicals, table) => {
+    const cats = new Set();
+    for (const c of canonicals) {
+        const val = table[c]?.[h.name];
+        if (val?.kind === "category")
+            cats.add(val.key);
+    }
+    return cats;
 };
-/** Curated-name mapping plus extensible pass-through; returns the effective
- * names and which of them the descriptor could not vouch for. */
-const resolveNames = (h, names) => {
-    const known = new Set(h.tools.builtins.map((t) => t.name));
-    const mapped = [];
-    const unmapped = [];
-    for (const name of names) {
-        if (known.has(name))
-            mapped.push(name);
-        else
-            unmapped.push(name);
+export const renderAccessPreset = (h, access, opts = {}) => {
+    if (access === "write")
+        return [];
+    // read preset
+    const filtered = READ_PRESET.filter((c) => {
+        if (opts.toolMap?.[c] !== undefined)
+            return true;
+        const table = canonicalTable(defaultDescriptors());
+        return table[c]?.[h.name] !== undefined;
+    });
+    if (filtered.length === 0)
+        return [];
+    // For tool-preset harnesses, render via tool-selection include
+    const spec = h.turnOptions.access;
+    if (spec && spec.kind === "tool-preset") {
+        const rendered = renderToolSelection(h, { include: filtered, toolMap: opts.toolMap });
+        return [...rendered.tokens];
     }
-    return { mapped, unmapped };
+    // For flag-value / flag-list-by-value harnesses, caller should handle via spec mapping;
+    // we return empty here so turn-options can map via spec values.
+    return [];
 };
 export const renderToolSelection = (h, selection) => {
     const hasInclude = selection.include !== undefined;
     const hasExclude = selection.exclude !== undefined;
-    // D1: mutual exclusivity, structured refusal.
     if (hasInclude && hasExclude) {
         throw new ArgvRefusalError({
             issue: "mutually-exclusive-options",
@@ -51,28 +66,108 @@ export const renderToolSelection = (h, selection) => {
         });
     }
     if (!hasInclude && !hasExclude)
-        return { tokens: [], unmapped: [] };
-    if (h.tools.includeFlag === null || h.tools.excludeFlag === null) {
-        const option = hasInclude ? "tools" : "excludeTools";
-        const by = supportedBy(defaultDescriptors(), option);
+        return { tokens: [], passthrough: [] };
+    const set = defaultDescriptors();
+    const table = canonicalTable(set);
+    const toolMap = selection.toolMap ?? {};
+    const allCanonical = allCanonicalNames(set, {
+        [h.name]: toolMap,
+    });
+    const splitSelection = (names) => {
+        const canonical = [];
+        const passthrough = [];
+        const setForValidate = new Set(allCanonical);
+        for (const raw of names) {
+            const parsed = parseToolSelector(raw);
+            if (parsed.kind === "native") {
+                validateInnerName(h, parsed.name, names);
+                passthrough.push(parsed.name);
+                continue;
+            }
+            validateInnerName(h, parsed.name, names);
+            if (!setForValidate.has(parsed.name)) {
+                throw new ArgvRefusalError({
+                    issue: "unknown-tool-name",
+                    harness: h.name,
+                    option: "tools",
+                    supported: [...allCanonical],
+                    hint: "use native:<name> for an extension or MCP tool",
+                    detail: `unknown tool name(s) ${parsed.name}`,
+                });
+            }
+            canonical.push(parsed.name);
+        }
+        return { canonical, passthrough };
+    };
+    const isCodexShape = h.tools.includeFlag === null && h.tools.categories.length === 0;
+    const isCategoryShape = h.tools.includeFlag === null && h.tools.categories.length > 0;
+    if (isCodexShape) {
         throw new ArgvRefusalError({
             issue: "unsupported-option",
             harness: h.name,
-            option,
+            option: hasInclude ? "tools" : "excludeTools",
             supported: ["per-tool name lists"],
-            supportedBy: by,
-            hint: h.name === "codex"
-                ? "nearest control on codex: category switches via config keys (features.shell_tool, web_search) or sandbox modes - see `hcn inspect codex`"
-                : "nearest control on muse: category switches (--disable-write, --disable-shell, --disable-web-tools) gate tool execution per session",
+            supportedBy: supportedBy(set, hasInclude ? "tools" : "excludeTools"),
+            hint: hintFor(h.name, hasInclude ? "tools" : "excludeTools") ??
+                "nearest control on codex: category switches via config keys (features.shell_tool, web_search) or sandbox modes - see `hcn inspect codex`",
         });
     }
+    if (isCategoryShape) {
+        const names = hasInclude ? selection.include : selection.exclude;
+        const { canonical, passthrough } = splitSelection(names);
+        if (hasExclude) {
+            // one helper replaces the three no-counterpart loops
+            for (const c of canonical) {
+                const has = toolMap[c] !== undefined || table[c]?.[h.name] !== undefined;
+                if (!has) {
+                    throw new ArgvRefusalError({
+                        issue: "unsupported-option",
+                        harness: h.name,
+                        option: "excludeTools",
+                        supported: ["per-tool name lists"],
+                        supportedBy: supportedByCanonical(set, c),
+                        hint: hintFor(h.name, "excludeTools"),
+                    });
+                }
+            }
+            const cats = categoriesFor(h, canonical, table);
+            const tokens = [];
+            for (const cat of h.tools.categories) {
+                if (cats.has(cat.key) && cat.disableFlag)
+                    tokens.push(cat.disableFlag);
+            }
+            return { tokens, passthrough };
+        }
+        for (const c of canonical) {
+            const has = toolMap[c] !== undefined || table[c]?.[h.name] !== undefined;
+            if (!has) {
+                throw new ArgvRefusalError({
+                    issue: "unsupported-option",
+                    harness: h.name,
+                    option: "tools",
+                    supported: ["per-tool name lists"],
+                    supportedBy: supportedByCanonical(set, c),
+                    hint: hintFor(h.name, "tools"),
+                });
+            }
+        }
+        if (canonical.length === 0) {
+            const tokens = h.tools.categories.map((c) => c.disableFlag).filter((f) => !!f);
+            return { tokens, passthrough };
+        }
+        const grantedCats = categoriesFor(h, canonical, table);
+        const tokens = [];
+        for (const cat of h.tools.categories) {
+            if (!grantedCats.has(cat.key) && cat.disableFlag)
+                tokens.push(cat.disableFlag);
+        }
+        return { tokens, passthrough };
+    }
+    // From here: h has list flags (claude, pi)
     if (hasInclude) {
-        const names = validateNames(h, selection.include);
+        const names = selection.include;
         if (names.length === 0) {
-            // Empty include list = deny everything. On pi --tools "" has no
-            // defined meaning, so refuse; on claude emit the deny complement
-            // without an empty include token.
-            if (h.tools.includeIsStrictAllowlist || h.tools.excludeFlag === null) {
+            if (h.tools.includeIsStrictAllowlist) {
                 throw new ArgvRefusalError({
                     issue: "invalid-tool-grant",
                     harness: h.name,
@@ -82,66 +177,91 @@ export const renderToolSelection = (h, selection) => {
                 });
             }
             const known = h.tools.builtins.map((t) => t.name);
-            return { tokens: [h.tools.excludeFlag, known.join(",")], unmapped: [] };
+            return { tokens: [h.tools.excludeFlag, known.join(",")], passthrough: [] };
         }
-        const { mapped, unmapped } = resolveNames(h, names);
-        if (!h.tools.includeIsStrictAllowlist) {
-            if (mapped.length === 0 && unmapped.length > 0) {
+        const { canonical, passthrough } = splitSelection(names);
+        for (const c of canonical) {
+            const has = toolMap[c] !== undefined || table[c]?.[h.name] !== undefined;
+            if (!has) {
                 throw new ArgvRefusalError({
-                    issue: "unknown-tool-name",
+                    issue: "unsupported-option",
                     harness: h.name,
                     option: "tools",
-                    supported: [`known tool names: ${h.tools.builtins.map((t) => t.name).join(", ")}`],
-                    detail: `unknown tool name(s) ${unmapped.join(", ")}`,
+                    supported: ["per-tool name lists"],
+                    supportedBy: supportedByCanonical(set, c),
+                    hint: `add toolMap.${h.name}.${c} to ~/.config/hcn/config.json or pass native:${c}`,
                 });
             }
-            // claude: exact allowlist must reshape the visible set via the deny
-            // complement (probe 2b). The include flag also carries the granted
-            // names (curated + pass-throughs) so they skip approval prompts;
-            // unmapped names ride along - the deny complement is computed over
-            // curated names only, so an extension tool in an include is granted,
-            // never denied.
+        }
+        const mapped = [];
+        for (const c of canonical) {
+            let n = toolMap[c] ?? null;
+            if (n === null) {
+                const entry = table[c]?.[h.name];
+                if (entry?.kind === "builtin")
+                    n = entry.native;
+            }
+            if (n)
+                mapped.push(n);
+        }
+        if (!h.tools.includeIsStrictAllowlist) {
+            // claude's include flag pre-approves without restricting, so an exact allowlist renders as the deny complement
             const known = h.tools.builtins.map((t) => t.name);
             const excluded = known.filter((n) => !mapped.includes(n));
-            const tokens = [h.tools.includeFlag, [...mapped, ...unmapped].join(",")];
-            tokens.push(h.tools.excludeFlag, excluded.join(","));
-            return { tokens, unmapped };
+            const tokens = [h.tools.includeFlag, [...mapped, ...passthrough].join(",")];
+            // only add exclude if needed? original pushed exclude even when? Keep original behavior: push excludeFlag excluded
+            if (excluded.length > 0 || passthrough.length > 0) {
+                tokens.push(h.tools.excludeFlag, excluded.join(","));
+            }
+            else {
+                // when all tools included, exclude nothing? but keep token? original pushed exclude always
+                tokens.push(h.tools.excludeFlag, excluded.join(","));
+            }
+            return { tokens, passthrough };
+        }
+        return {
+            tokens: [h.tools.includeFlag, [...mapped, ...passthrough].join(",")],
+            passthrough,
+        };
+    }
+    // exclude
+    const names = selection.exclude;
+    const { canonical, passthrough: excludedPassthrough } = splitSelection(names);
+    for (const c of canonical) {
+        const has = toolMap[c] !== undefined || table[c]?.[h.name] !== undefined;
+        if (!has) {
+            throw new ArgvRefusalError({
+                issue: "unsupported-option",
+                harness: h.name,
+                option: "excludeTools",
+                supported: ["per-tool name lists"],
+                supportedBy: supportedByCanonical(set, c),
+                hint: `add toolMap.${h.name}.${c} to ~/.config/hcn/config.json or pass native:${c}`,
+            });
         }
-        // pi: strict over built-ins, direct include; unmapped (extension/MCP)
-        // names ride along in the same list - pi governs them too.
-        return { tokens: [h.tools.includeFlag, [...mapped, ...unmapped].join(",")], unmapped };
     }
-    // exclude (D2): all descriptor-known names minus the excluded ones.
-    const names = validateNames(h, selection.exclude);
-    const { mapped, unmapped: excludedUnmapped } = resolveNames(h, names);
-    if (excludedUnmapped.length > 0) {
-        // Excluding a name the descriptor does not know: permitted (it may be a
-        // runtime-registered tool), rendered natively where the harness's deny
-        // list can carry it; on claude only, since its include path consumes
-        // unknown names without effect (silent-acceptance hazard).
+    if (excludedPassthrough.length > 0) {
         if (!h.tools.includeIsStrictAllowlist) {
-            const tokens = [h.tools.excludeFlag, [...mapped, ...excludedUnmapped].join(",")];
-            return { tokens, unmapped: excludedUnmapped };
+            const mapped = canonical.map((c) => toolMap[c] ?? table[c]?.[h.name]?.native ?? c);
+            const tokens = [h.tools.excludeFlag, [...mapped, ...excludedPassthrough].join(",")];
+            return { tokens, passthrough: excludedPassthrough };
         }
-        // pi: a D2 exclude renders as a computed include (its native exclude
-        // subtracts from the default set, which cannot express "all minus X"
-        // when off-by-default tools are involved). An unknown excluded name
-        // cannot be complemented - refuse rather than silently grant it.
         throw new ArgvRefusalError({
             issue: "unknown-tool-name",
             harness: h.name,
             option: "excludeTools",
             supported: [`known tool names: ${h.tools.builtins.map((t) => t.name).join(", ")}`],
-            detail: `cannot exclude unknown name(s) ${excludedUnmapped.join(", ")}: the complement cannot be computed`,
+            detail: `cannot exclude unknown name(s) ${excludedPassthrough.join(", ")}: the complement cannot be computed`,
         });
     }
+    const mapped = canonical
+        .map((c) => toolMap[c] ?? table[c]?.[h.name]?.native ?? "")
+        .filter(Boolean);
     const known = h.tools.builtins.filter((t) => !mapped.includes(t.name));
     const kept = known.map((t) => t.name);
     if (!h.tools.includeIsStrictAllowlist) {
-        // claude: deny list IS the complement expression.
-        return { tokens: [h.tools.excludeFlag, mapped.join(",")], unmapped: [] };
+        return { tokens: [h.tools.excludeFlag, mapped.join(",")], passthrough: [] };
     }
-    // pi: computed include over every known name minus the excluded.
-    return { tokens: [h.tools.includeFlag, kept.join(",")], unmapped: [] };
+    return { tokens: [h.tools.includeFlag, kept.join(",")], passthrough: [] };
 };
 //# sourceMappingURL=tool-selection.js.map

package/dist/interpretation/tool-selection.js.map

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

package/dist/interpretation/tool-vocabulary.d.ts

@@ -0,0 +1,38 @@
+import type { DescriptorSet } from "../knowledge/overrides.js";
+export declare const NATIVE_PREFIX: "native:";
+export type VocabularyEntry = {
+    kind: "builtin";
+    native: string;
+} | {
+    kind: "category";
+    key: string;
+};
+export declare const READ_PRESET: readonly ["read", "grep", "glob", "list", "web-fetch", "web-search"];
+export type ParsedSelector = {
+    kind: "canonical";
+    name: string;
+} | {
+    kind: "native";
+    name: string;
+};
+export declare const parseToolSelector: (raw: string) => ParsedSelector;
+export type ToolMap = Readonly<Record<string, Readonly<Record<string, string>>>>;
+export type ToolMapTier = "user-config" | "project-config";
+export type MergedToolMap = Readonly<Record<string, Readonly<Record<string, {
+    native: string;
+    tier: ToolMapTier;
+}>>>>;
+/** Pure merge per harness per canonical: project > user. */
+export declare const mergeToolMaps: (tiers: {
+    readonly user?: ToolMap;
+    readonly project?: ToolMap;
+}) => MergedToolMap;
+export type CanonicalTable = Readonly<Record<string, Readonly<Partial<Record<string, VocabularyEntry>>>>>;
+export declare const canonicalTable: (set: DescriptorSet) => CanonicalTable;
+export declare const canonicalToolTable: typeof canonicalTable;
+export declare const canonicalNames: (set: DescriptorSet) => readonly string[];
+export declare const allCanonicalNames: (set: DescriptorSet, toolMap?: ToolMap | MergedToolMap) => readonly string[];
+export declare const hasCounterpart: (table: CanonicalTable, canonical: string, harnessName: string, toolMap?: MergedToolMap | ToolMap) => boolean;
+export declare const nativeFor: (table: CanonicalTable, canonical: string, harnessName: string, toolMap?: MergedToolMap | ToolMap) => string | null;
+export declare const validateCanonicalList: (names: readonly string[] | undefined, allCanonical: readonly string[], harness: string) => void;
+//# sourceMappingURL=tool-vocabulary.d.ts.map

package/dist/interpretation/tool-vocabulary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-vocabulary.d.ts","sourceRoot":"","sources":["../../src/interpretation/tool-vocabulary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAG/D,eAAO,MAAM,aAAa,EAAG,SAAkB,CAAC;AAEhD,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC,eAAO,MAAM,WAAW,YAAI,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,CAAU,CAAC;AAEhG,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpG,eAAO,MAAM,iBAAiB,QAAS,MAAM,KAAG,cAGV,CAAC;AAEvC,MAAM,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAEjF,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,gBAAgB,CAAC;AAE3D,MAAM,MAAM,aAAa,GAAG,QAAQ,CAClC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC,CAAC,CAAC,CAChF,CAAC;AAEF,4DAA4D;AAC5D,eAAO,MAAM,aAAa,UAAW;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B,KAAG,aA0BH,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,QAAQ,CACnC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,CACnE,CAAC;AAIF,eAAO,MAAM,cAAc,QAAS,aAAa,KAAG,cAmCnD,CAAC;AAGF,eAAO,MAAM,kBAAkB,uBAAiB,CAAC;AAEjD,eAAO,MAAM,cAAc,QAAS,aAAa,KAAG,SAAS,MAAM,EAGlE,CAAC;AAEF,eAAO,MAAM,iBAAiB,QACvB,aAAa,YACR,OAAO,GAAG,aAAa,KAChC,SAAS,MAAM,EAMjB,CAAC;AAEF,eAAO,MAAM,cAAc,UAClB,cAAc,aACV,MAAM,eACJ,MAAM,YACT,aAAa,GAAG,OAAO,KAChC,OAaF,CAAC;AAEF,eAAO,MAAM,SAAS,UACb,cAAc,aACV,MAAM,eACJ,MAAM,YACT,aAAa,GAAG,OAAO,KAChC,MAAM,GAAG,IAeX,CAAC;AAEF,eAAO,MAAM,qBAAqB,UACzB,SAAS,MAAM,EAAE,GAAG,SAAS,gBACtB,SAAS,MAAM,EAAE,WACtB,MAAM,KACd,IAgBF,CAAC"}

package/dist/interpretation/tool-vocabulary.js

@@ -0,0 +1,142 @@
+import { ArgvRefusalError } from "./refusal.js";
+export const NATIVE_PREFIX = "native:";
+export const READ_PRESET = ["read", "grep", "glob", "list", "web-fetch", "web-search"];
+export const parseToolSelector = (raw) => raw.startsWith(NATIVE_PREFIX)
+    ? { kind: "native", name: raw.slice(NATIVE_PREFIX.length) }
+    : { kind: "canonical", name: raw };
+/** Pure merge per harness per canonical: project > user. */
+export const mergeToolMaps = (tiers) => {
+    const merged = {};
+    const harnesses = new Set([
+        ...Object.keys(tiers.user ?? {}),
+        ...Object.keys(tiers.project ?? {}),
+    ]);
+    for (const h of harnesses) {
+        const userEntries = tiers.user?.[h] ?? {};
+        const projectEntries = tiers.project?.[h] ?? {};
+        const canonicals = new Set([
+            ...Object.keys(userEntries),
+            ...Object.keys(projectEntries),
+        ]);
+        const perHarness = {};
+        for (const c of canonicals) {
+            if (projectEntries[c] !== undefined) {
+                perHarness[c] = { native: projectEntries[c], tier: "project-config" };
+            }
+            else if (userEntries[c] !== undefined) {
+                perHarness[c] = { native: userEntries[c], tier: "user-config" };
+            }
+        }
+        if (Object.keys(perHarness).length > 0) {
+            merged[h] = perHarness;
+        }
+    }
+    return merged;
+};
+const tableCache = new WeakMap();
+export const canonicalTable = (set) => {
+    const cached = tableCache.get(set);
+    if (cached)
+        return cached;
+    const allCanonical = new Set();
+    for (const h of Object.values(set)) {
+        if (!h)
+            continue;
+        for (const b of h.tools.builtins) {
+            if (b.canonical !== null)
+                allCanonical.add(b.canonical);
+        }
+        for (const c of h.tools.categories) {
+            for (const n of c.canonical)
+                allCanonical.add(n);
+        }
+    }
+    const table = {};
+    for (const canonical of allCanonical) {
+        const perHarness = {};
+        for (const h of Object.values(set)) {
+            if (!h)
+                continue;
+            const builtin = h.tools.builtins.find((b) => b.canonical === canonical);
+            if (builtin) {
+                perHarness[h.name] = { kind: "builtin", native: builtin.name };
+                continue;
+            }
+            const cat = h.tools.categories.find((c) => c.canonical.includes(canonical));
+            if (cat) {
+                perHarness[h.name] = { kind: "category", key: cat.key };
+            }
+        }
+        table[canonical] = perHarness;
+    }
+    const frozen = table;
+    tableCache.set(set, frozen);
+    return frozen;
+};
+// Backwards compat alias
+export const canonicalToolTable = canonicalTable;
+export const canonicalNames = (set) => {
+    const table = canonicalTable(set);
+    return Object.keys(table).sort();
+};
+export const allCanonicalNames = (set, toolMap) => {
+    const base = canonicalNames(set);
+    const extra = toolMap
+        ? Object.values(toolMap).flatMap((m) => Object.keys(m))
+        : [];
+    return [...new Set([...base, ...extra])].sort();
+};
+export const hasCounterpart = (table, canonical, harnessName, toolMap) => {
+    if (toolMap) {
+        const hm = toolMap[harnessName];
+        if (hm && hm[canonical] !== undefined) {
+            const v = hm[canonical];
+            if (typeof v === "object" && v !== null && "native" in v)
+                return true;
+            if (typeof v === "string")
+                return true;
+        }
+    }
+    const entry = table[canonical];
+    if (!entry)
+        return false;
+    return entry[harnessName] !== undefined;
+};
+export const nativeFor = (table, canonical, harnessName, toolMap) => {
+    if (toolMap) {
+        const hm = toolMap[harnessName];
+        const val = hm?.[canonical];
+        if (val !== undefined) {
+            if (typeof val === "object" && val !== null && "native" in val) {
+                return val.native;
+            }
+            if (typeof val === "string")
+                return val;
+        }
+    }
+    const entry = table[canonical];
+    const v = entry?.[harnessName];
+    if (v?.kind === "builtin")
+        return v.native;
+    return null;
+};
+export const validateCanonicalList = (names, allCanonical, harness) => {
+    if (!names)
+        return;
+    const set = new Set(allCanonical);
+    for (const name of names) {
+        if (name.startsWith(NATIVE_PREFIX))
+            continue;
+        if (!set.has(name)) {
+            throw new ArgvRefusalError({
+                issue: "unknown-tool-name",
+                harness: harness,
+                option: "tools",
+                supported: allCanonical,
+                hint: "use native:<name> for an extension or MCP tool",
+                detail: `unknown tool name ${JSON.stringify(name)}`,
+            });
+        }
+    }
+};
+//# sourceMappingURL=tool-vocabulary.js.map