synabun 2.0.9 → 2.1.0

package/mcp-server/dist/services/tool-list.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Tool lists: what a run names out of the catalog (docs/design/mcp-tool-lists/PLAN.md §3.2-3.4).
+ *
+ * A list is an array of group ids, `all` and `mcp:` items. parseToolList reads one, or converts a name an older
+ * SynaBun stored (a preset, a comma list); resolveToolList applies the defaults and the groups a run gets by itself.
+ * Both refuse what the catalog does not have, with suggestions. Pure: the Neural Interface (dispatch, launches) and
+ * the MCP child (its runtime file, its environment, a header) call the same code.
+ */
+import { type ToolListEffect } from './tool-catalog.js';
+export type ToolListProblemReason = 'unknown' | 'gated' | 'too-long' | 'too-many' | 'not-a-string' | 'unknown-server' | 'non-selectable' | 'absent-for-provider' | 'blocked' | 'unavailable';
+export interface ToolListProblem {
+    item: string;
+    reason: ToolListProblemReason;
+    /** Ids to name instead (group ids, `all`, `mcp:*`); empty when nothing fits. */
+    suggestions: string[];
+    /** One sentence for the person or agent that wrote the item. */
+    hint: string | null;
+}
+export type ToolListErrorCode = 'TOOLS_INVALID' | 'TOOLS_TOO_MANY';
+export interface ToolListFailure {
+    ok: false;
+    code: ToolListErrorCode;
+    problems: ToolListProblem[];
+    message: string;
+}
+export interface ParsedToolList {
+    ok: true;
+    /** Normalized items, each once, in the order given. */
+    items: string[];
+    /** The stored preset name this was converted from, or null. */
+    preset: string | null;
+    /** The platform that preset implied (`twitter`, `facebook`), or null. */
+    platform: string | null;
+}
+export type ToolListParse = ParsedToolList | ToolListFailure;
+/** Registry presets by name (`profiles.<name>.groups` of data/mcp-registry.json): read only to convert a stored name. */
+export type CustomPresets = Readonly<Record<string, {
+    groups?: unknown;
+} | readonly unknown[] | null | undefined>>;
+export type ToolListSource = 'dispatch' | 'launch' | 'runtime';
+export type AddedReason = 'browser-group' | 'uses-browser' | 'design';
+export interface AddedGroup {
+    id: string;
+    why: AddedReason;
+}
+export interface ResolveToolListContext {
+    /** dispatch: the Assistant's run; launch: a stored automation; runtime: an MCP child reading its own list. */
+    source: ToolListSource;
+    usesBrowser?: boolean | null;
+    taskClass?: string | null;
+    /** claude-code, codex, opencode, gemini: decides the effect. */
+    provider?: string | null;
+    /** launch: the record's own list, already converted (§3.10). */
+    stored?: readonly string[] | null;
+    /** The owner's Default tools (launch and runtime, when nothing else names a list). */
+    defaultTools?: readonly string[] | null;
+    browserV2?: boolean;
+}
+export interface ToolListResolution {
+    ok: true;
+    /** The items asked for, normalized; null when the run named nothing (a default applied). */
+    requested: string[] | null;
+    /** The list in its stored form: `all` or groups in catalog order, then the `mcp:` items. */
+    items: string[];
+    /** Every selectable group the run gets, in catalog order: `all` expanded, added groups included. */
+    groups: string[];
+    /** External refs; availability is checked at the provider launch boundary. */
+    servers: string[];
+    /** Groups the run gets without naming them, and why. */
+    added: AddedGroup[];
+    /** Always-on ids and tool names that were named: accepted and dropped. */
+    dropped: string[];
+    effect: ToolListEffect;
+    /** Tools the run loads (strict) or focuses on (focus), before its role and grants. */
+    count: number;
+}
+export type ToolListResult = ToolListResolution | ToolListFailure;
+/** Trimmed; group ids and literals lower-cased; an `mcp:` server name keeps its case. */
+export declare function normalizeToolItem(item: string): string;
+/** One sentence per problem, for an API error, a tool answer or the MCP child's log. */
+export declare function describeToolListProblems(code: ToolListErrorCode, problems: readonly ToolListProblem[]): string;
+/**
+ * Read a list. An array (or a comma-joined string) is read as written: preset names are refused later, with
+ * suggestions. With `legacy`, a string is a stored profile value and is converted (presets, comma lists).
+ * A blank string is an empty list; a caller that means "no list" checks for blank first.
+ */
+export declare function parseToolList(value: unknown, { legacy, customPresets }?: {
+    legacy?: boolean;
+    customPresets?: CustomPresets | null;
+}): ToolListParse;
+/**
+ * Group ids an unknown item probably meant, best first (at most `limit`): an id, a label or a word of a label that
+ * equals it (`whatsapp`, `x`), one that contains it or that it contains (`googlesearch` → gsc, `discord_bot`),
+ * then one within two edits (`whatsap`). Selectable groups only.
+ */
+export declare function suggestToolIds(item: string, limit?: number): string[];
+/** strict for a provider that loads its list exactly, focus for one that reaches every SynaBun tool anyway. */
+export declare function toolListEffect(provider: string | null | undefined): ToolListEffect;
+/**
+ * The groups a run gets (§3.3). No list means the default of its source: core for a dispatch, the record's own
+ * list or the owner's Default tools for a launch, the owner's Default tools for a runtime (else `all`). `all` is
+ * every selectable group, always-on ids are dropped, unknown and gated ids are refused. A browser group, or
+ * usesBrowser, adds `browser`; a design run adds browser (unless usesBrowser is false), styleguide and image.
+ */
+export declare function resolveToolList(requested: readonly string[] | string | null | undefined, context: ResolveToolListContext): ToolListResult;
+/** A list joined for an environment variable or a header (SYNABUN_TOOLS, X-Synabun-Tools): at most 2048 bytes. */
+export declare function serializeToolList(items: readonly string[]): string;
+//# sourceMappingURL=tool-list.d.ts.map

package/mcp-server/dist/services/tool-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-list.d.ts","sourceRoot":"","sources":["../../src/services/tool-list.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAmBL,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,cAAc,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,qBAAqB,GAAG,SAAS,GAAG,aAAa,CAAC;AAE7L,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,qBAAqB,CAAC;IAC9B,gFAAgF;IAChF,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,gEAAgE;IAChE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,MAAM,iBAAiB,GAAG,eAAe,GAAG,gBAAgB,CAAC;AAEnE,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,iBAAiB,CAAC;IACxB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,IAAI,CAAC;IACT,uDAAuD;IACvD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,+DAA+D;IAC/D,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,yEAAyE;IACzE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,eAAe,CAAC;AAE7D,yHAAyH;AACzH,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC;AAEnH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AAC/D,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,cAAc,GAAG,QAAQ,CAAC;AACtE,MAAM,WAAW,UAAU;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,WAAW,CAAA;CAAE;AAE5D,MAAM,WAAW,sBAAsB;IACrC,8GAA8G;IAC9G,MAAM,EAAE,cAAc,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,gEAAgE;IAChE,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IAClC,sFAAsF;IACtF,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IACxC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,IAAI,CAAC;IACT,4FAA4F;IAC5F,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC3B,4FAA4F;IAC5F,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,oGAAoG;IACpG,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,8EAA8E;IAC9E,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,wDAAwD;IACxD,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,cAAc,CAAC;IACvB,sFAAsF;IACtF,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,cAAc,GAAG,kBAAkB,GAAG,eAAe,CAAC;AAIlE,yFAAyF;AACzF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAItD;AAwBD,wFAAwF;AACxF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,SAAS,eAAe,EAAE,GAAG,MAAM,CAM9G;AAsCD;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,EACd,EAAE,MAAc,EAAE,aAAoB,EAAE,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;CAAO,GACxG,aAAa,CAoBf;AAiBD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,EAAE,CAiBhE;AAkGD,+GAA+G;AAC/G,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,cAAc,CAElF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,EAAE,sBAAsB,GAAG,cAAc,CA2CzI;AAED,kHAAkH;AAClH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAOlE"}

package/mcp-server/dist/services/tool-list.js

@@ -0,0 +1,334 @@
+/**
+ * Tool lists: what a run names out of the catalog (docs/design/mcp-tool-lists/PLAN.md §3.2-3.4).
+ *
+ * A list is an array of group ids, `all` and `mcp:` items. parseToolList reads one, or converts a name an older
+ * SynaBun stored (a preset, a comma list); resolveToolList applies the defaults and the groups a run gets by itself.
+ * Both refuse what the catalog does not have, with suggestions. Pure: the Neural Interface (dispatch, launches) and
+ * the MCP child (its runtime file, its environment, a header) call the same code.
+ */
+import { ALWAYS_ON_TOOLS, DEFAULT_TOOLS, HOST_EFFECT, LEGACY_PRESETS, LEGACY_PRESET_PLATFORMS, RETIRED_GROUPS, RETIRED_PRESETS, SELECTABLE_GROUP_IDS, TOOL_GROUPS, TOOL_LIST_LIMITS, countTools, groupOfTool, isAlwaysOnId, isBrowserGroup, isGatedGroup, isSelectableGroup, sortGroups, toolGroup, } from './tool-catalog.js';
+const MCP_PREFIX = /^mcp:/i;
+/** Trimmed; group ids and literals lower-cased; an `mcp:` server name keeps its case. */
+export function normalizeToolItem(item) {
+    const trimmed = item.trim();
+    if (MCP_PREFIX.test(trimmed))
+        return `mcp:${trimmed.slice(4).trim()}`;
+    return trimmed.toLowerCase();
+}
+function splitList(value) {
+    return value.split(',').map(normalizeToolItem).filter(Boolean);
+}
+function unique(items) {
+    return [...new Set(items)];
+}
+function clip(value, max = 80) {
+    return value.length > max ? `${value.slice(0, max)}…` : value;
+}
+function describeValue(value) {
+    if (value === null)
+        return 'null';
+    if (Array.isArray(value))
+        return 'an array';
+    return typeof value === 'object' ? 'an object' : clip(String(value));
+}
+function failure(code, problems) {
+    return { ok: false, code, problems, message: describeToolListProblems(code, problems) };
+}
+/** One sentence per problem, for an API error, a tool answer or the MCP child's log. */
+export function describeToolListProblems(code, problems) {
+    const parts = problems.map((problem) => (problem.hint ? `${problem.item} (${problem.hint})` : problem.item));
+    if (code === 'TOOLS_TOO_MANY') {
+        return `A tool list holds at most ${TOOL_LIST_LIMITS.maxItems} items of at most ${TOOL_LIST_LIMITS.maxGroupItemLength} characters (${TOOL_LIST_LIMITS.maxServerItemLength} for an mcp: item): ${parts.join('; ')}`;
+    }
+    return `${problems.some(problem => problem.item.startsWith('mcp:')) ? 'Invalid tool selection' : 'Not SynaBun tool groups'}: ${parts.join('; ')}`;
+}
+/** A registry preset's groups that a list may name, or null when the registry has no preset of that name. */
+function customPresetGroups(customPresets, name) {
+    if (!customPresets)
+        return null;
+    for (const [key, preset] of Object.entries(customPresets)) {
+        if (String(key).trim().toLowerCase() !== name)
+            continue;
+        const groups = Array.isArray(preset) ? preset : (preset && typeof preset === 'object' ? preset.groups : null);
+        if (!Array.isArray(groups))
+            return [];
+        return sortGroups(groups.filter((group) => typeof group === 'string').map((group) => group.trim().toLowerCase()).filter(isSelectableGroup));
+    }
+    return null;
+}
+/**
+ * A profile name an older SynaBun stored (SYNABUN_PROFILE, a runtime file's `profile`, a record's `mcpProfile`,
+ * active-profile.json): a preset becomes its groups (with the registry's own groups of that name), `full` and a
+ * retired preset become `all`, anything else is read as a comma list. In a comma list the retired groups and the
+ * gated ones are left out (the role and the grant decide those); what is left is checked like any list.
+ */
+function convertLegacyProfile(value, customPresets) {
+    const name = value.trim().toLowerCase();
+    const platform = LEGACY_PRESET_PLATFORMS[name] ?? null;
+    if (name === 'full' || RETIRED_PRESETS.includes(name))
+        return { ok: true, items: ['all'], preset: name, platform: null };
+    const custom = customPresetGroups(customPresets, name);
+    if (Object.prototype.hasOwnProperty.call(LEGACY_PRESETS, name)) {
+        return { ok: true, items: sortGroups([...LEGACY_PRESETS[name], ...(custom || [])]), preset: name, platform };
+    }
+    if (custom)
+        return { ok: true, items: custom, preset: name, platform: null };
+    const tokens = splitList(value);
+    const kept = tokens.filter((token) => !RETIRED_GROUPS.includes(token) && !isGatedGroup(token));
+    // A list that named only retired groups launched as every group before; it still does.
+    if (tokens.length && !kept.length && tokens.every((token) => RETIRED_GROUPS.includes(token))) {
+        return { ok: true, items: ['all'], preset: null, platform: null };
+    }
+    return { ok: true, items: unique(kept), preset: null, platform: null };
+}
+/**
+ * Read a list. An array (or a comma-joined string) is read as written: preset names are refused later, with
+ * suggestions. With `legacy`, a string is a stored profile value and is converted (presets, comma lists).
+ * A blank string is an empty list; a caller that means "no list" checks for blank first.
+ */
+export function parseToolList(value, { legacy = false, customPresets = null } = {}) {
+    if (Array.isArray(value)) {
+        const problems = [];
+        const items = [];
+        for (const raw of value) {
+            if (typeof raw !== 'string') {
+                problems.push({ item: describeValue(raw), reason: 'not-a-string', suggestions: [], hint: 'every item of a tool list is a string' });
+                continue;
+            }
+            const item = normalizeToolItem(raw);
+            if (item)
+                items.push(item);
+        }
+        if (problems.length)
+            return failure('TOOLS_INVALID', problems);
+        return { ok: true, items: unique(items), preset: null, platform: null };
+    }
+    if (typeof value !== 'string') {
+        return failure('TOOLS_INVALID', [{ item: describeValue(value), reason: 'not-a-string', suggestions: [], hint: 'a tool list is an array of group ids' }]);
+    }
+    if (legacy)
+        return convertLegacyProfile(value, customPresets);
+    return { ok: true, items: unique(splitList(value)), preset: null, platform: null };
+}
+function levenshtein(a, b) {
+    if (a === b)
+        return 0;
+    const previous = Array.from({ length: b.length + 1 }, (_, index) => index);
+    for (let i = 1; i <= a.length; i += 1) {
+        let diagonal = previous[0];
+        previous[0] = i;
+        for (let j = 1; j <= b.length; j += 1) {
+            const above = previous[j];
+            previous[j] = Math.min(previous[j] + 1, previous[j - 1] + 1, diagonal + (a[i - 1] === b[j - 1] ? 0 : 1));
+            diagonal = above;
+        }
+    }
+    return previous[b.length];
+}
+/**
+ * Group ids an unknown item probably meant, best first (at most `limit`): an id, a label or a word of a label that
+ * equals it (`whatsapp`, `x`), one that contains it or that it contains (`googlesearch` → gsc, `discord_bot`),
+ * then one within two edits (`whatsap`). Selectable groups only.
+ */
+export function suggestToolIds(item, limit = 3) {
+    const key = String(item ?? '').toLowerCase().replace(/[^a-z0-9]/g, '');
+    if (!key)
+        return [];
+    const scored = [];
+    TOOL_GROUPS.forEach((group, order) => {
+        if (group.gate)
+            return;
+        const id = group.id.replace(/_/g, '');
+        const short = group.id.replace(/^browser_/, '').replace(/_/g, '');
+        const label = group.label.toLowerCase().replace(/[^a-z0-9]/g, '');
+        const words = group.label.toLowerCase().split(/[^a-z0-9]+/).filter(Boolean);
+        let score = 0;
+        if (key === id || key === short || key === label || words.includes(key))
+            score = 3;
+        else if (key.length >= 3 && (label.includes(key) || id.includes(key) || (short.length >= 3 && key.includes(short))))
+            score = 2;
+        else if (key.length >= 3 && Math.min(levenshtein(key, short), levenshtein(key, id), levenshtein(key, label)) <= 2)
+            score = 1;
+        if (score)
+            scored.push({ id: group.id, score, order });
+    });
+    return scored.sort((a, b) => b.score - a.score || a.order - b.order).slice(0, limit).map((entry) => entry.id);
+}
+/** What a retired preset name stands for now: the groups that set it apart from the default. */
+function presetProblem(item) {
+    if (!Object.prototype.hasOwnProperty.call(LEGACY_PRESETS, item))
+        return null;
+    if (item === 'full' || RETIRED_PRESETS.includes(item)) {
+        return { item, reason: 'unknown', suggestions: ['all'], hint: `${item} was a preset; name all` };
+    }
+    const groups = LEGACY_PRESETS[item];
+    const browserComesWith = groups.some((id) => id !== 'browser' && isBrowserGroup(id));
+    const distinct = sortGroups(groups.filter((id) => !DEFAULT_TOOLS.includes(id) && !(id === 'browser' && browserComesWith)));
+    if (!distinct.length) {
+        return { item, reason: 'unknown', suggestions: [...DEFAULT_TOOLS], hint: `${item} was a preset: it is the default (${DEFAULT_TOOLS.join(', ')}), so leave tools out` };
+    }
+    return { item, reason: 'unknown', suggestions: distinct, hint: `${item} was a preset; name ${distinct.join(', ')}` };
+}
+function gatedProblem(item, group) {
+    if (toolGroup(group)?.gate === 'grant:computer') {
+        return { item, reason: 'gated', suggestions: [], hint: `${group} is never named in a list: pass uses_computer: true for a desktop grant` };
+    }
+    return { item, reason: 'gated', suggestions: [], hint: `${group} is the Assistant's own, never a worker's: its role decides` };
+}
+function unknownProblem(item) {
+    const preset = presetProblem(item);
+    if (preset)
+        return preset;
+    const owner = groupOfTool(item);
+    if (owner && isSelectableGroup(owner)) {
+        return { item, reason: 'unknown', suggestions: [owner], hint: `${item} is a tool of the ${owner} group; name ${owner}` };
+    }
+    const suggestions = suggestToolIds(item);
+    return { item, reason: 'unknown', suggestions, hint: suggestions.length ? `did you mean ${suggestions.join(' or ')}?` : null };
+}
+/** Every item checked against the catalog and the limits. */
+function checkItems(items) {
+    const problems = [];
+    if (items.length > TOOL_LIST_LIMITS.maxItems) {
+        problems.push({ item: `${items.length} items`, reason: 'too-many', suggestions: [], hint: `at most ${TOOL_LIST_LIMITS.maxItems}` });
+    }
+    const serializedBytes = new TextEncoder().encode(items.join(',')).length;
+    if (serializedBytes > TOOL_LIST_LIMITS.maxSerializedBytes)
+        problems.push({ item: `${serializedBytes} bytes`, reason: 'too-long', suggestions: [], hint: `at most ${TOOL_LIST_LIMITS.maxSerializedBytes} serialized bytes` });
+    const groups = new Set();
+    const servers = [];
+    const dropped = [];
+    let all = false;
+    for (const item of items) {
+        const server = item.startsWith('mcp:');
+        const limit = server ? TOOL_LIST_LIMITS.maxServerItemLength : TOOL_LIST_LIMITS.maxGroupItemLength;
+        if (item.length > limit) {
+            problems.push({ item: clip(item), reason: 'too-long', suggestions: [], hint: `at most ${limit} characters` });
+            continue;
+        }
+        if (item === 'all') {
+            all = true;
+            continue;
+        }
+        if (isAlwaysOnId(item) || ALWAYS_ON_TOOLS.includes(item)) {
+            dropped.push(item);
+            continue;
+        }
+        if (isSelectableGroup(item)) {
+            groups.add(item);
+            continue;
+        }
+        if (isGatedGroup(item)) {
+            problems.push(gatedProblem(item, item));
+            continue;
+        }
+        if (item === 'mcp:*') {
+            servers.push(item);
+            continue;
+        }
+        if (server) {
+            if (/^mcp:[A-Za-z0-9][A-Za-z0-9._:-]{0,63}$/.test(item) && item !== 'mcp:SynaBun')
+                servers.push(item);
+            else
+                problems.push({ item, reason: 'non-selectable', suggestions: [], hint: item === 'mcp:SynaBun'
+                        ? 'SynaBun is managed through tool groups, not an external server reference'
+                        : 'this name cannot be selected individually: use 1-64 letters, digits, dots, underscores, colons or hyphens, starting with a letter or digit; mcp:* selects configured, permitted servers' });
+            continue;
+        }
+        const owner = groupOfTool(item);
+        if (owner && isGatedGroup(owner)) {
+            problems.push(gatedProblem(item, owner));
+            continue;
+        }
+        problems.push(unknownProblem(item));
+    }
+    if (problems.length) {
+        const tooMany = problems.some((problem) => problem.reason === 'too-many' || problem.reason === 'too-long');
+        return failure(tooMany ? 'TOOLS_TOO_MANY' : 'TOOLS_INVALID', problems);
+    }
+    const sorted = sortGroups(groups);
+    return {
+        ok: true,
+        groups: all ? [...SELECTABLE_GROUP_IDS] : sorted,
+        servers: unique(servers).sort(),
+        dropped,
+        items: all ? ['all', ...unique(servers).sort()] : [...sorted, ...unique(servers).sort()],
+    };
+}
+function defaultItems(context) {
+    if (context.source === 'dispatch')
+        return DEFAULT_TOOLS;
+    if (context.source === 'launch' && context.stored)
+        return context.stored;
+    return context.defaultTools ?? ['all'];
+}
+/** strict for a provider that loads its list exactly, focus for one that reaches every SynaBun tool anyway. */
+export function toolListEffect(provider) {
+    return (provider && HOST_EFFECT[provider]) || 'strict';
+}
+/**
+ * The groups a run gets (§3.3). No list means the default of its source: core for a dispatch, the record's own
+ * list or the owner's Default tools for a launch, the owner's Default tools for a runtime (else `all`). `all` is
+ * every selectable group, always-on ids are dropped, unknown and gated ids are refused. A browser group, or
+ * usesBrowser, adds `browser`; a design run adds browser (unless usesBrowser is false), styleguide and image.
+ */
+export function resolveToolList(requested, context) {
+    let asked = null;
+    if (requested !== undefined && requested !== null) {
+        const parsed = parseToolList(requested);
+        if (!parsed.ok)
+            return parsed;
+        asked = parsed.items;
+    }
+    let base = asked;
+    if (!base) {
+        const fallback = parseToolList([...defaultItems(context)]);
+        if (!fallback.ok)
+            return fallback;
+        base = fallback.items;
+    }
+    const checked = checkItems(base);
+    if (!checked.ok)
+        return checked;
+    const groups = new Set(checked.groups);
+    const added = [];
+    const add = (id, why) => {
+        if (groups.has(id))
+            return;
+        groups.add(id);
+        added.push({ id, why });
+    };
+    if ([...groups].some((id) => id !== 'browser' && isBrowserGroup(id)))
+        add('browser', 'browser-group');
+    if (context.usesBrowser === true)
+        add('browser', 'uses-browser');
+    const design = context.taskClass === 'design';
+    if (design && context.usesBrowser !== false)
+        add('browser', 'design');
+    if (design) {
+        add('styleguide', 'design');
+        add('image', 'design');
+    }
+    const resolved = sortGroups(groups);
+    return {
+        ok: true,
+        requested: asked,
+        items: checked.items,
+        groups: resolved,
+        servers: checked.servers,
+        added,
+        dropped: checked.dropped,
+        effect: toolListEffect(context.provider),
+        count: countTools(resolved, { browserV2: context.browserV2 }),
+    };
+}
+/** A list joined for an environment variable or a header (SYNABUN_TOOLS, X-Synabun-Tools): at most 2048 bytes. */
+export function serializeToolList(items) {
+    const value = unique(items.map(normalizeToolItem).filter(Boolean)).join(',');
+    const bytes = new TextEncoder().encode(value).length;
+    if (bytes > TOOL_LIST_LIMITS.maxSerializedBytes) {
+        throw new RangeError(`A tool list joined for an environment variable or a header is at most ${TOOL_LIST_LIMITS.maxSerializedBytes} bytes; this one is ${bytes}.`);
+    }
+    return value;
+}
+//# sourceMappingURL=tool-list.js.map

package/mcp-server/dist/services/tool-list.js.map

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

package/mcp-server/dist/services/tool-runtime.d.ts

@@ -0,0 +1,161 @@
+/**
+ * The tool selection of one MCP server runtime: which SynaBun groups it advertises, and how.
+ *
+ * strict: the runtime advertises exactly its groups (OpenCode, Gemini, any other stdio client). focus: it
+ * advertises every group and its groups only steer the instructions (Claude Code's ToolSearch, Codex's deferred
+ * catalog, which Codex snapshots at the start of a turn). Gated groups follow the caller's role and grant in both
+ * modes, never a list.
+ *
+ * Each MCP server owns one ToolRuntime: the HTTP transport keeps several servers in one process, and a
+ * module-global selection once made one client's change land on another client's server.
+ */
+import type { RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type CallerRole } from './identity.js';
+import { type AddedGroup, type CustomPresets } from './tool-list.js';
+export type ToolMode = 'strict' | 'focus';
+export type CallerCapability = 'computer';
+/** The list of this runtime (comma-joined group ids) and the file its tool_groups changes go to. */
+export declare const TOOLS_ENV = "SYNABUN_TOOLS";
+export declare const TOOLS_PATH_ENV = "SYNABUN_TOOLS_PATH";
+/** deferred / focus: a focus host; profiled / strict: a strict one. */
+export declare const TOOL_CATALOG_MODE_ENV = "SYNABUN_TOOL_CATALOG_MODE";
+/** Read as aliases through the legacy conversion (an older Neural Interface, a user's own config.toml or Gemini settings); never written. */
+export declare const LEGACY_PROFILE_ENV = "SYNABUN_PROFILE";
+export declare const LEGACY_RUNTIME_PROFILE_PATH_ENV = "SYNABUN_RUNTIME_PROFILE_PATH";
+/** The owner's Default tools: Settings and `synabun tools set` write it; a runtime reads it when it starts, never later. */
+export declare const DEFAULT_TOOLS_PATH: string;
+/** Groups only a caller with this role sees: the role decides, so no list can reveal or hide them. */
+export declare const ROLE_GATED_GROUPS: Readonly<Record<string, CallerRole>>;
+/** Groups a capability the caller proves unlocks: `computer` needs a desktop grant (and macOS). */
+export declare const CAPABILITY_GATED_GROUPS: Readonly<Record<string, CallerCapability>>;
+export declare function isRoleGatedGroup(group: string): boolean;
+export declare function isCapabilityGatedGroup(group: string): boolean;
+/** Where a runtime's selection came from (tool_groups get shows it). */
+export type ToolSelectionSource = 'tools-file' | 'tools-env' | 'legacy-runtime-file' | 'claude-code' | 'legacy-profile-env' | 'default-tools' | 'legacy-default' | 'all' | 'http' | 'header' | 'channel' | 'explicit' | 'tool_groups';
+export interface ToolSelection {
+    /** Selectable groups, catalog order. */
+    groups: string[];
+    mode: ToolMode;
+    /** The host's own mode, when a list that could not be read made this selection strict. */
+    hostMode?: ToolMode;
+    /** Why the list could not be read: the runtime then has its always-on and gated tools only. */
+    listError: string | null;
+    source: ToolSelectionSource;
+    /** Groups the runtime got without naming them (browser for a browser group). */
+    added: AddedGroup[];
+}
+/** The selection of a host's own list, with its host mode. */
+export declare function selectionOf(groups: readonly string[], mode: ToolMode, source: ToolSelectionSource, added?: AddedGroup[]): ToolSelection;
+/** What a list that could not be read leaves: memory tools only (and the gated ones), strict until tool_groups succeeds. */
+export declare function unreadableSelection(source: ToolSelectionSource, reason: string, hostMode: ToolMode): ToolSelection;
+export declare function isClaudeCode(env?: NodeJS.ProcessEnv): boolean;
+/** focus for Codex (SYNABUN_TOOL_CATALOG_MODE=deferred, or a managed Codex sidepanel), strict otherwise. */
+export declare function readHostMode(env?: NodeJS.ProcessEnv): ToolMode;
+/** The registry's presets, read only to convert a stored profile name. */
+export declare function readCustomPresets(): CustomPresets | null;
+/**
+ * The selection of a list given in code or by a request (a header, the worker channel), resolved like a runtime's
+ * own: `all` expanded, a browser group's `browser` added. One that cannot be read is memory tools only, strict.
+ */
+export declare function selectionFromList(value: unknown, mode: ToolMode, source: ToolSelectionSource, { legacy }?: {
+    legacy?: boolean;
+}): ToolSelection;
+/**
+ * The selection a runtime starts with, the first of: its runtime file (SYNABUN_TOOLS_PATH), its list
+ * (SYNABUN_TOOLS), the runtime file of an older Neural Interface (SYNABUN_RUNTIME_PROFILE_PATH), Claude Code
+ * (CLAUDECODE=1: focus on every group), the old SYNABUN_PROFILE, the owner's Default tools, the old
+ * active-profile.json, every group. The runtime's own pins come before CLAUDECODE, so a strict runtime that
+ * inherited it from a parent shell keeps its list. A list that cannot be read is not skipped: the runtime starts
+ * with memory tools only and says why (fail closed, never every group).
+ */
+export declare function readInitialTools(env?: NodeJS.ProcessEnv): ToolSelection;
+/**
+ * The value an older Neural Interface's /api/mcp/runtime-profile and runtime file understand for these groups: a
+ * comma list (every selectable id is one of its group names), or its always-on pseudo-group `memory` for none.
+ */
+export declare function legacyProfileValue(groups: readonly string[]): string;
+/**
+ * Save this runtime's groups where a restarted child of the same runtime reads them, never the shared default.
+ * Over HTTP there is no such file: process.env is the Neural Interface's own, not a caller's.
+ */
+export declare function runtimeToolsWithExternalRefs(groups: readonly string[]): string[];
+export declare function persistRuntimeTools(groups: readonly string[]): 'tools-file' | 'legacy-runtime-file' | null;
+export declare function logCodexConfigNoticeOnce(): void;
+export interface ToolApplyResult {
+    groups: string[];
+    /** The groups the instructions name: the selection plus the gated groups the role and grant unlock. */
+    activeGroups: string[];
+    /** Groups that became active, and groups that stopped being active. */
+    enabled: string[];
+    disabled: string[];
+    added: AddedGroup[];
+    /** Tools this server advertises now. */
+    totalTools: number;
+    changed: boolean;
+    /** Whether any tool appeared in or left the host's tool list. */
+    advertisedChanged: boolean;
+    mode: ToolMode;
+    listError: string | null;
+}
+export interface ToolRuntimeOptions {
+    role?: CallerRole | null;
+    capabilities?: CallerCapability[] | null;
+    platform?: string;
+}
+export declare class ToolRuntime {
+    private groups;
+    private mode;
+    private hostMode;
+    private listError;
+    private source;
+    private added;
+    private role;
+    private capabilities;
+    private readonly platform;
+    private activeGroups;
+    private readonly toolGroups;
+    private ungroupedTools;
+    private onToolsChanged;
+    private notificationTimer;
+    constructor(selection?: ToolSelection, options?: ToolRuntimeOptions);
+    getGroups(): string[];
+    /** The groups the instructions name: the selection plus the gated groups the role and grant unlock. */
+    getActiveGroups(): Set<string>;
+    getMode(): ToolMode;
+    /** The mode the host has once its list reads: focus for Codex and Claude Code, strict otherwise. */
+    getHostMode(): ToolMode;
+    getListError(): string | null;
+    getSource(): ToolSelectionSource;
+    getAdded(): AddedGroup[];
+    getRole(): CallerRole | null;
+    getCapabilities(): CallerCapability[];
+    getSelection(): ToolSelection;
+    /** Plain setter: callers apply() afterwards so the gated groups follow (index.ts setServerRole does both). */
+    setRole(role: CallerRole | null): void;
+    /** Plain setter, like setRole. */
+    setCapabilities(capabilities: CallerCapability[]): void;
+    setToolGroup(name: string, tools: RegisteredTool[]): void;
+    /** How many registered tools sit outside every group (the always-on tools, and any compatibility name). */
+    setUngroupedToolCount(count: number): void;
+    setOnToolsChanged(fn: (() => void | Promise<void>) | null): void;
+    private inBandRefresh;
+    setInBandRefresh(fn: () => Promise<boolean>): void;
+    hasInBandRefresh(): boolean;
+    refreshBeforeReply(): Promise<boolean>;
+    dispose(): void;
+    /**
+     * Coalesce one delayed tools/list_changed. The delay matters: OpenCode used to get the notification while the
+     * tool call that caused it was still in flight, and could abort or cache the old tool round trip.
+     */
+    scheduleToolsChangedNotification(delayMs?: number): boolean;
+    /** The selection with the gates applied: a gated group is active iff this runtime's role or grant unlocks it. */
+    private resolveActive;
+    /** Tools this server advertises: the ones outside every group and each group's enabled tools. */
+    getAdvertisedToolCount(): number;
+    /**
+     * Apply a new selection (or re-apply the current one after a role or grant change). Tools are flipped directly:
+     * RegisteredTool.enable()/disable() would each send a notification, and the caller sends one after its answer.
+     */
+    apply(next?: Partial<ToolSelection>): ToolApplyResult;
+}
+//# sourceMappingURL=tool-runtime.d.ts.map

package/mcp-server/dist/services/tool-runtime.d.ts.map

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