@qduc/term2 0.19.0 → 0.21.0

package/dist/services/models/model-resolution.js

@@ -0,0 +1,292 @@
+import { createInterface } from 'node:readline';
+import { getProvider, getProviderIds } from '../../providers/index.js';
+import { filterModels } from '../model-service.js';
+import { scoreSubsequence } from '../../utils/subsequence-filter.js';
+import { collectProviderModels } from './model-listing.js';
+import { HARNESS_IDLE_ENV } from '../../lib/harness-input-idle.js';
+export const VALID_REASONING_EFFORTS = ['default', 'none', 'minimal', 'low', 'medium', 'high', 'xhigh'];
+/**
+ * Parse a raw `--model` flag string, separating optional thinking suffix
+ * (":<thinking>") and optional provider prefix ("<provider>/<id>").
+ */
+export function parseModelFlag(rawModelFlag, options) {
+    const trimmed = rawModelFlag.trim();
+    // 1. Extract thinking suffix (e.g. :high, :low, :medium)
+    let withoutThinking = trimmed;
+    let reasoningEffort;
+    const colonIdx = trimmed.lastIndexOf(':');
+    if (colonIdx !== -1) {
+        const potentialEffort = trimmed.slice(colonIdx + 1).toLowerCase();
+        if (VALID_REASONING_EFFORTS.includes(potentialEffort)) {
+            reasoningEffort = potentialEffort;
+            withoutThinking = trimmed.slice(0, colonIdx).trim();
+        }
+    }
+    const rawPattern = withoutThinking;
+    // 2. Extract provider prefix
+    if (options?.providerFlag) {
+        return {
+            provider: options.providerFlag,
+            pattern: withoutThinking,
+            reasoningEffort,
+            rawPattern,
+        };
+    }
+    const slashIdx = withoutThinking.indexOf('/');
+    if (slashIdx !== -1) {
+        const prefix = withoutThinking.slice(0, slashIdx).toLowerCase();
+        const known = options?.knownProviders ?? getProviderIds();
+        if (known.map((k) => k.toLowerCase()).includes(prefix)) {
+            return {
+                provider: prefix,
+                pattern: withoutThinking.slice(slashIdx + 1).trim(),
+                reasoningEffort,
+                rawPattern,
+            };
+        }
+    }
+    return {
+        provider: undefined,
+        pattern: withoutThinking,
+        reasoningEffort,
+        rawPattern,
+    };
+}
+/**
+ * Match parsed model pattern against loaded provider model groups.
+ * Exact matches take strict precedence over partial/fuzzy matches, and an
+ * exact match of the flag exactly as typed (including any provider-style
+ * prefix) takes precedence over the split provider+pattern reading, so a
+ * literal aggregator id like `anthropic/claude-3.5-sonnet` is never
+ * reinterpreted when the vendor name collides with a provider id.
+ */
+export function matchModels(groups, parsed) {
+    const patternLower = parsed.pattern.toLowerCase();
+    const rawPatternLower = parsed.rawPattern.toLowerCase();
+    // Stage 0: The id exactly as typed. When the raw flag (prefix included) is a
+    // real model id somewhere, use it verbatim instead of the split reading.
+    const asTypedMatches = [];
+    for (const group of groups) {
+        for (const model of group.models) {
+            if (model.id.toLowerCase() === rawPatternLower) {
+                asTypedMatches.push({ provider: group.provider, model });
+            }
+        }
+    }
+    if (asTypedMatches.length > 0) {
+        return { exact: true, matches: asTypedMatches };
+    }
+    // Stage 1: Exact matches on the stripped pattern
+    const exactMatches = [];
+    for (const group of groups) {
+        if (parsed.provider && group.provider.toLowerCase() !== parsed.provider.toLowerCase()) {
+            // Check if rawPattern matches a slash model id in another provider (e.g. openrouter)
+            for (const model of group.models) {
+                if (model.id.toLowerCase() === rawPatternLower) {
+                    exactMatches.push({ provider: group.provider, model });
+                }
+            }
+            continue;
+        }
+        for (const model of group.models) {
+            if (model.id.toLowerCase() === patternLower || model.id.toLowerCase() === rawPatternLower) {
+                exactMatches.push({ provider: group.provider, model });
+            }
+        }
+    }
+    if (exactMatches.length > 0) {
+        return { exact: true, matches: exactMatches };
+    }
+    // Stage 2: Fuzzy / partial matches
+    const fuzzyMatches = [];
+    const trimmed = parsed.pattern.trim();
+    for (const group of groups) {
+        if (parsed.provider) {
+            if (group.provider.toLowerCase() === parsed.provider.toLowerCase()) {
+                const filtered = filterModels(group.models, trimmed);
+                for (const model of filtered) {
+                    fuzzyMatches.push({ provider: group.provider, model });
+                }
+            }
+            continue;
+        }
+        // No provider specified: match provider name or model id/name
+        if (scoreSubsequence(trimmed, group.provider) !== -Infinity) {
+            for (const model of group.models) {
+                fuzzyMatches.push({ provider: group.provider, model });
+            }
+        }
+        else {
+            const filtered = filterModels(group.models, trimmed);
+            for (const model of filtered) {
+                fuzzyMatches.push({ provider: group.provider, model });
+            }
+        }
+    }
+    return { exact: false, matches: fuzzyMatches };
+}
+/**
+ * Format matching models as a numbered list grouped by provider,
+ * matching `--list-models` style with sequential 1-based numbering.
+ */
+export function formatDisambiguationPrompt(matches, groups) {
+    const lines = [];
+    const labelByProvider = new Map();
+    for (const group of groups) {
+        const label = group.label ?? getProvider(group.provider)?.label;
+        if (label && label !== group.provider) {
+            labelByProvider.set(group.provider, label);
+        }
+    }
+    const byProvider = new Map();
+    for (const match of matches) {
+        const list = byProvider.get(match.provider) ?? [];
+        list.push(match);
+        byProvider.set(match.provider, list);
+    }
+    let index = 1;
+    for (const [provider, list] of byProvider) {
+        const label = labelByProvider.get(provider);
+        const header = label ? `${provider} (${label}):` : `${provider}:`;
+        lines.push(header);
+        for (const match of list) {
+            const model = match.model;
+            const name = model.name && model.name !== model.id ? `  ${model.name}` : '';
+            lines.push(`  ${index}) ${model.id}${name}`);
+            index++;
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Interactive prompt for disambiguating multiple matching models.
+ */
+export async function promptForDisambiguation(matches, groups, pattern, prompter, streams) {
+    const formatted = formatDisambiguationPrompt(matches, groups);
+    const promptText = `Multiple models match "${pattern}":\n\n${formatted}\n\nSelect a model [1-${matches.length}]: `;
+    if (prompter) {
+        const answer = await prompter(promptText);
+        if (!answer)
+            return null;
+        const num = parseInt(answer.trim(), 10);
+        if (!Number.isNaN(num) && num >= 1 && num <= matches.length) {
+            return matches[num - 1];
+        }
+        return null;
+    }
+    const input = streams?.input ?? process.stdin;
+    // Prompts go to stderr by default: stdout carries structured output (--json
+    // NDJSON, pipes) and must stay machine-readable.
+    const output = streams?.output ?? process.stderr;
+    const rl = createInterface({ input, output });
+    try {
+        output.write(`Multiple models match "${pattern}":\n\n${formatted}\n\n`);
+        while (true) {
+            const answer = await new Promise((resolve) => {
+                rl.question(`Select a model [1-${matches.length}]: `, (res) => resolve(res));
+                rl.once('close', () => resolve(null));
+            });
+            if (answer === null)
+                return null;
+            const num = parseInt(answer.trim(), 10);
+            if (!Number.isNaN(num) && num >= 1 && num <= matches.length) {
+                return matches[num - 1];
+            }
+            output.write(`Please enter a number between 1 and ${matches.length}.\n`);
+        }
+    }
+    finally {
+        rl.close();
+    }
+}
+/**
+ * Resolves `--model <pattern>` against the model catalog with exact match
+ * precedence, partial/fuzzy matching, and interactive disambiguation when needed.
+ */
+export async function resolveModelFlag(deps) {
+    const knownProviders = deps.knownProviders ?? getProviderIds();
+    const parsed = parseModelFlag(deps.modelFlag, {
+        providerFlag: deps.providerFlag,
+        knownProviders,
+    });
+    // Isolated black-box provider harnesses replay wire turns and do not mock catalog endpoints
+    if (process.env[HARNESS_IDLE_ENV] && deps.prompter === undefined) {
+        return {
+            status: 'passthrough',
+            modelId: parsed.rawPattern,
+            provider: parsed.provider,
+            reasoningEffort: parsed.reasoningEffort,
+        };
+    }
+    // Narrow the catalog load only when the user explicitly scoped it with
+    // --provider. A provider prefix parsed out of the flag itself (e.g. the
+    // `anthropic/` in `anthropic/claude-3.5-sonnet` on an aggregator) must not
+    // narrow: the full id may be a literal model id on a different provider.
+    const providerIds = deps.providerIds ?? (deps.providerFlag && parsed.provider ? [parsed.provider] : undefined);
+    const groups = await collectProviderModels({
+        settingsService: deps.settingsService,
+        loggingService: deps.loggingService,
+        fetcher: deps.fetcher,
+    }, providerIds);
+    const warnings = groups
+        .filter((group) => group.error !== undefined)
+        .map((group) => `warning: ${group.provider}: ${group.error}`);
+    const totalLoadedModels = groups.reduce((acc, g) => acc + g.models.length, 0);
+    const hasFetchErrors = groups.some((g) => g.error !== undefined);
+    // If providers had errors and yielded 0 models, pass through rather than blocking startup
+    if (totalLoadedModels === 0 && hasFetchErrors) {
+        return {
+            status: 'passthrough',
+            // Fail open with the flag as typed, matching pre-resolution behavior.
+            modelId: parsed.rawPattern,
+            provider: parsed.provider,
+            reasoningEffort: parsed.reasoningEffort,
+            ...(warnings.length > 0 ? { warnings } : {}),
+        };
+    }
+    const { matches } = matchModels(groups, parsed);
+    if (matches.length === 0) {
+        // If the target provider failed to fetch its catalog, allow passthrough
+        if (parsed.provider) {
+            const targetGroup = groups.find((g) => g.provider.toLowerCase() === parsed.provider.toLowerCase());
+            if (targetGroup?.error) {
+                return {
+                    status: 'passthrough',
+                    modelId: parsed.rawPattern,
+                    provider: parsed.provider,
+                    reasoningEffort: parsed.reasoningEffort,
+                    ...(warnings.length > 0 ? { warnings } : {}),
+                };
+            }
+        }
+        return {
+            status: 'no_match',
+            error: `Error: No models match "${deps.modelFlag}".`,
+        };
+    }
+    if (matches.length === 1) {
+        return {
+            status: 'resolved',
+            modelId: matches[0].model.id,
+            provider: matches[0].provider,
+            reasoningEffort: parsed.reasoningEffort,
+            ...(warnings.length > 0 ? { warnings } : {}),
+        };
+    }
+    // Ambiguous match: disambiguate
+    const selected = await promptForDisambiguation(matches, groups, deps.modelFlag, deps.prompter, deps.streams);
+    if (!selected) {
+        return {
+            status: 'cancelled',
+            error: 'Cancelled.',
+        };
+    }
+    return {
+        status: 'resolved',
+        modelId: selected.model.id,
+        provider: selected.provider,
+        reasoningEffort: parsed.reasoningEffort,
+        ...(warnings.length > 0 ? { warnings } : {}),
+    };
+}
+//# sourceMappingURL=model-resolution.js.map

package/dist/services/models/model-resolution.js.map

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

package/dist/services/plan-mode-interceptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan-mode-interceptor.d.ts","sourceRoot":"","sources":["../../source/services/plan-mode-interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,KAAK,eAAe,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAEtG,KAAK,wBAAwB,GAAG;IAC9B,kBAAkB,EAAE,CAAC,WAAW,EAAE,eAAe,KAAK,MAAM,IAAI,CAAC;CAClE,CAAC;AAEF,eAAO,MAAM,0BAA0B,gBACxB,wBAAwB,QAC/B;IAAE,eAAe,EAAE,gBAAgB,CAAA;CAAE,KAC1C,CAAC,MAAM,IAAI,CA2Cb,CAAC"}
+{"version":3,"file":"plan-mode-interceptor.d.ts","sourceRoot":"","sources":["../../source/services/plan-mode-interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,KAAK,eAAe,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAEtG,KAAK,wBAAwB,GAAG;IAC9B,kBAAkB,EAAE,CAAC,WAAW,EAAE,eAAe,KAAK,MAAM,IAAI,CAAC;CAClE,CAAC;AAEF,eAAO,MAAM,0BAA0B,gBACxB,wBAAwB,QAC/B;IAAE,eAAe,EAAE,gBAAgB,CAAA;CAAE,KAC1C,CAAC,MAAM,IAAI,CA2Cb,CAAC"}

package/dist/services/plan-mode-interceptor.js

@@ -1,3 +1,4 @@
+import { resolveActiveEnforcement } from './profiles/index.js';
 export const installPlanModeInterceptor = (agentClient, deps) => {
     // Subagent roles that cannot mutate the workspace (canWrite: false). The
     // `worker` role (and any future write-capable/custom role) is blocked.
@@ -16,18 +17,16 @@ export const installPlanModeInterceptor = (agentClient, deps) => {
         return typeof role === 'string' ? role : undefined;
     };
     const interceptor = async (name, params) => {
-        const isPlanMode = deps.settingsService.get('app.planMode');
-        if (!isPlanMode) {
-            return null;
-        }
-        if (['create_file', 'search_replace', 'apply_patch'].includes(name)) {
+        const denials = resolveActiveEnforcement(deps.settingsService).denials;
+        if (denials.has('filesystem-mutation') && ['create_file', 'search_replace', 'apply_patch'].includes(name)) {
             return `Plan mode is active (read-only). The "${name}" tool is disabled. Do not attempt file or state changes — investigate with read-only tools and present an ordered implementation plan. Tell the user to exit plan mode to execute it.`;
         }
         if (name === 'run_subagent' || name === 'run_subagent_async') {
             const role = extractRole(params);
             // Allow only read-only subagent roles; block worker and unknown roles
             // (an unknown role could be a write-capable custom subagent).
-            if (!role || !READ_ONLY_SUBAGENT_ROLES.has(role)) {
+            if ((role !== undefined && !READ_ONLY_SUBAGENT_ROLES.has(role) && denials.has('delegated-write')) ||
+                (role === undefined && denials.has('unknown-delegated-role'))) {
                 return `Plan mode is active (read-only). The "${name}" tool is restricted to read-only roles (explorer, mentor, librarian) — the "${role ?? 'unknown'}" role is disabled. Use a read-only subagent to investigate, then present an ordered implementation plan. Tell the user to exit plan mode to execute it.`;
             }
         }

package/dist/services/plan-mode-interceptor.js.map

@@ -1 +1 @@
-{"version":3,"file":"plan-mode-interceptor.js","sourceRoot":"","sources":["../../source/services/plan-mode-interceptor.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,WAAqC,EACrC,IAA2C,EAC7B,EAAE;IAChB,yEAAyE;IACzE,uEAAuE;IACvE,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;IAE9E,MAAM,WAAW,GAAG,CAAC,MAAe,EAAsB,EAAE;QAC1D,IAAI,GAAG,GAAG,MAAM,CAAC;QACjB,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACxB,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC;QACD,MAAM,IAAI,GAAI,GAAiC,EAAE,IAAI,CAAC;QACtD,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACrD,CAAC,CAAC;IAEF,MAAM,WAAW,GAAoB,KAAK,EAAE,IAAY,EAAE,MAAe,EAAE,EAAE;QAC3E,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC5D,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC,aAAa,EAAE,gBAAgB,EAAE,aAAa,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACpE,OAAO,yCAAyC,IAAI,wLAAwL,CAAC;QAC/O,CAAC;QAED,IAAI,IAAI,KAAK,cAAc,IAAI,IAAI,KAAK,oBAAoB,EAAE,CAAC;YAC7D,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;YACjC,sEAAsE;YACtE,8DAA8D;YAC9D,IAAI,CAAC,IAAI,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjD,OAAO,yCAAyC,IAAI,gFAClD,IAAI,IAAI,SACV,0JAA0J,CAAC;YAC7J,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF,OAAO,WAAW,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;AACrD,CAAC,CAAC"}
+{"version":3,"file":"plan-mode-interceptor.js","sourceRoot":"","sources":["../../source/services/plan-mode-interceptor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAQ/D,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,WAAqC,EACrC,IAA2C,EAC7B,EAAE;IAChB,yEAAyE;IACzE,uEAAuE;IACvE,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;IAE9E,MAAM,WAAW,GAAG,CAAC,MAAe,EAAsB,EAAE;QAC1D,IAAI,GAAG,GAAG,MAAM,CAAC;QACjB,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACxB,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC;QACD,MAAM,IAAI,GAAI,GAAiC,EAAE,IAAI,CAAC;QACtD,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACrD,CAAC,CAAC;IAEF,MAAM,WAAW,GAAoB,KAAK,EAAE,IAAY,EAAE,MAAe,EAAE,EAAE;QAC3E,MAAM,OAAO,GAAG,wBAAwB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC;QAEvE,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,IAAI,CAAC,aAAa,EAAE,gBAAgB,EAAE,aAAa,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1G,OAAO,yCAAyC,IAAI,wLAAwL,CAAC;QAC/O,CAAC;QAED,IAAI,IAAI,KAAK,cAAc,IAAI,IAAI,KAAK,oBAAoB,EAAE,CAAC;YAC7D,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;YACjC,sEAAsE;YACtE,8DAA8D;YAC9D,IACE,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;gBAC7F,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC,EAC7D,CAAC;gBACD,OAAO,yCAAyC,IAAI,gFAClD,IAAI,IAAI,SACV,0JAA0J,CAAC;YAC7J,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF,OAAO,WAAW,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;AACrD,CAAC,CAAC"}

package/dist/services/profiles/active-profile.d.ts

@@ -0,0 +1,5 @@
+import type { ISettingsService } from '../service-interfaces.js';
+import type { ResolveOptions, ResolvedEnforcementPolicy, ResolvedProfile } from './types.js';
+export declare function resolveActiveProfile(settingsService: ISettingsService, options?: ResolveOptions): ResolvedProfile;
+export declare function resolveActiveEnforcement(settingsService: ISettingsService): ResolvedEnforcementPolicy;
+//# sourceMappingURL=active-profile.d.ts.map

package/dist/services/profiles/active-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-profile.d.ts","sourceRoot":"","sources":["../../../source/services/profiles/active-profile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAGjE,OAAO,KAAK,EAAE,cAAc,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAU7F,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,eAAe,CAEjH;AAED,wBAAgB,wBAAwB,CAAC,eAAe,EAAE,gBAAgB,GAAG,yBAAyB,CAkBrG"}

package/dist/services/profiles/active-profile.js

@@ -0,0 +1,33 @@
+import { resolveProfile } from './resolver.js';
+import { ProfileResolutionError } from './types.js';
+const STANDARD_PROFILE_ID = 'builtin:standard';
+const enforcementCache = new WeakMap();
+const readActiveProfileId = (settingsService) => {
+    const value = settingsService.get('app.activeProfileId');
+    return typeof value === 'string' && value.trim().length > 0 ? value : STANDARD_PROFILE_ID;
+};
+export function resolveActiveProfile(settingsService, options) {
+    return resolveProfile(readActiveProfileId(settingsService), options);
+}
+export function resolveActiveEnforcement(settingsService) {
+    const profileId = readActiveProfileId(settingsService);
+    const cached = enforcementCache.get(settingsService);
+    if (cached?.profileId === profileId)
+        return cached.enforcement;
+    let enforcement;
+    try {
+        enforcement = resolveActiveProfile(settingsService).enforcement;
+    }
+    catch (error) {
+        if (!(error instanceof ProfileResolutionError))
+            throw error;
+        enforcement = {
+            policies: new Set(),
+            denials: new Set(),
+            handoffRestrictions: new Set(),
+        };
+    }
+    enforcementCache.set(settingsService, { profileId, enforcement });
+    return enforcement;
+}
+//# sourceMappingURL=active-profile.js.map

package/dist/services/profiles/active-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-profile.js","sourceRoot":"","sources":["../../../source/services/profiles/active-profile.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAGpD,MAAM,mBAAmB,GAAG,kBAAkB,CAAC;AAC/C,MAAM,gBAAgB,GAAG,IAAI,OAAO,EAAmF,CAAC;AAExH,MAAM,mBAAmB,GAAG,CAAC,eAAiC,EAAU,EAAE;IACxE,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IACzD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,mBAAmB,CAAC;AAC5F,CAAC,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAAC,eAAiC,EAAE,OAAwB;IAC9F,OAAO,cAAc,CAAC,mBAAmB,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,eAAiC;IACxE,MAAM,SAAS,GAAG,mBAAmB,CAAC,eAAe,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACrD,IAAI,MAAM,EAAE,SAAS,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,WAAW,CAAC;IAE/D,IAAI,WAAsC,CAAC;IAC3C,IAAI,CAAC;QACH,WAAW,GAAG,oBAAoB,CAAC,eAAe,CAAC,CAAC,WAAW,CAAC;IAClE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,CAAC,KAAK,YAAY,sBAAsB,CAAC;YAAE,MAAM,KAAK,CAAC;QAC5D,WAAW,GAAG;YACZ,QAAQ,EAAE,IAAI,GAAG,EAAE;YACnB,OAAO,EAAE,IAAI,GAAG,EAAE;YAClB,mBAAmB,EAAE,IAAI,GAAG,EAAE;SAC/B,CAAC;IACJ,CAAC;IACD,gBAAgB,CAAC,GAAG,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC;IAClE,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/services/profiles/index.d.ts

@@ -0,0 +1,9 @@
+export * from './types.js';
+export * from './schema.js';
+export * from './registry.js';
+export * from './resolver.js';
+export * from './legacy-adapter.js';
+export * from './labels.js';
+export * from './active-profile.js';
+export * from './profile-transition.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/profiles/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../source/services/profiles/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC"}

package/dist/services/profiles/index.js

@@ -0,0 +1,9 @@
+export * from './types.js';
+export * from './schema.js';
+export * from './registry.js';
+export * from './resolver.js';
+export * from './legacy-adapter.js';
+export * from './labels.js';
+export * from './active-profile.js';
+export * from './profile-transition.js';
+//# sourceMappingURL=index.js.map

package/dist/services/profiles/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/services/profiles/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC"}

package/dist/services/profiles/labels.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Return the lowercase display label for a built-in Profile ID.
+ * Unknown IDs intentionally fall back to Standard for safe, stable display
+ * while custom Profile presentation metadata is not yet available.
+ */
+export declare function getProfileLabel(profileId: string): string;
+//# sourceMappingURL=labels.d.ts.map

package/dist/services/profiles/labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../../source/services/profiles/labels.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAczD"}

package/dist/services/profiles/labels.js

@@ -0,0 +1,22 @@
+import { MENTOR_PROFILE_ID, LITE_PROFILE_ID, ORCHESTRATOR_PROFILE_ID, PLAN_PROFILE_ID, STANDARD_PROFILE_ID, } from './legacy-adapter.js';
+/**
+ * Return the lowercase display label for a built-in Profile ID.
+ * Unknown IDs intentionally fall back to Standard for safe, stable display
+ * while custom Profile presentation metadata is not yet available.
+ */
+export function getProfileLabel(profileId) {
+    switch (profileId) {
+        case LITE_PROFILE_ID:
+            return 'lite';
+        case PLAN_PROFILE_ID:
+            return 'plan';
+        case MENTOR_PROFILE_ID:
+            return 'mentor';
+        case ORCHESTRATOR_PROFILE_ID:
+            return 'orchestrator';
+        case STANDARD_PROFILE_ID:
+        default:
+            return 'standard';
+    }
+}
+//# sourceMappingURL=labels.js.map

package/dist/services/profiles/labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.js","sourceRoot":"","sources":["../../../source/services/profiles/labels.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,uBAAuB,EACvB,eAAe,EACf,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAE7B;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,eAAe;YAClB,OAAO,MAAM,CAAC;QAChB,KAAK,eAAe;YAClB,OAAO,MAAM,CAAC;QAChB,KAAK,iBAAiB;YACpB,OAAO,QAAQ,CAAC;QAClB,KAAK,uBAAuB;YAC1B,OAAO,cAAc,CAAC;QACxB,KAAK,mBAAmB,CAAC;QACzB;YACE,OAAO,UAAU,CAAC;IACtB,CAAC;AACH,CAAC"}

package/dist/services/profiles/legacy-adapter.d.ts

@@ -0,0 +1,28 @@
+import type { ProfileId, SavedAppMode } from './types.js';
+export declare const STANDARD_PROFILE_ID: 'builtin:standard';
+export declare const LITE_PROFILE_ID: 'builtin:lite';
+export declare const PLAN_PROFILE_ID: 'builtin:plan';
+export declare const MENTOR_PROFILE_ID: 'builtin:mentor';
+export declare const ORCHESTRATOR_PROFILE_ID: 'builtin:orchestrator';
+/** Compatibility projection for persisted settings; Profile identity remains canonical. */
+export declare function profileIdFromLegacyMode(mode: Partial<SavedAppMode> | undefined): ProfileId;
+export declare function legacyModeFromProfileId(profileId: string): SavedAppMode;
+export declare function normalizeLegacyMode(mode: Partial<SavedAppMode> | undefined): SavedAppMode;
+declare const LEGACY_MODE_SETTING_FIELDS: Readonly<{
+    readonly 'app.orchestratorMode': 'orchestratorMode';
+    readonly 'app.liteMode': 'liteMode';
+    readonly 'app.planMode': 'planMode';
+    readonly 'app.mentorMode': 'mentorMode';
+}>;
+export type LegacyModeSettingKey = keyof typeof LEGACY_MODE_SETTING_FIELDS;
+export declare function isLegacyModeSettingKey(key: string): key is LegacyModeSettingKey;
+/** Map one legacy setting write to the canonical Profile selected by the flags. */
+export declare function profileIdFromLegacyModeSetting(key: string, value: unknown, currentProfileId: string): ProfileId | undefined;
+export declare const legacyModeAdapter: Readonly<{
+    profileIdFromLegacyMode: typeof profileIdFromLegacyMode;
+    legacyModeFromProfileId: typeof legacyModeFromProfileId;
+    normalizeLegacyMode: typeof normalizeLegacyMode;
+    profileIdFromLegacyModeSetting: typeof profileIdFromLegacyModeSetting;
+}>;
+export {};
+//# sourceMappingURL=legacy-adapter.d.ts.map

package/dist/services/profiles/legacy-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-adapter.d.ts","sourceRoot":"","sources":["../../../source/services/profiles/legacy-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1D,eAAO,MAAM,mBAAmB,EAAG,kBAA2B,CAAC;AAC/D,eAAO,MAAM,eAAe,EAAG,cAAuB,CAAC;AACvD,eAAO,MAAM,eAAe,EAAG,cAAuB,CAAC;AACvD,eAAO,MAAM,iBAAiB,EAAG,gBAAyB,CAAC;AAC3D,eAAO,MAAM,uBAAuB,EAAG,sBAA+B,CAAC;AAEvE,2FAA2F;AAC3F,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,SAAS,GAAG,SAAS,CAM1F;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,CAevE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,SAAS,GAAG,YAAY,CAEzF;AAED,QAAA,MAAM,0BAA0B;qCACN,kBAAkB;6BAC1B,UAAU;6BACV,UAAU;+BACR,YAAY;EACrB,CAAC;AAEZ,MAAM,MAAM,oBAAoB,GAAG,MAAM,OAAO,0BAA0B,CAAC;AAE3E,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,IAAI,oBAAoB,CAE/E;AAED,mFAAmF;AACnF,wBAAgB,8BAA8B,CAC5C,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,EACd,gBAAgB,EAAE,MAAM,GACvB,SAAS,GAAG,SAAS,CAYvB;AAED,eAAO,MAAM,iBAAiB;;;;;EAK5B,CAAC"}

package/dist/services/profiles/legacy-adapter.js

@@ -0,0 +1,69 @@
+export const STANDARD_PROFILE_ID = 'builtin:standard';
+export const LITE_PROFILE_ID = 'builtin:lite';
+export const PLAN_PROFILE_ID = 'builtin:plan';
+export const MENTOR_PROFILE_ID = 'builtin:mentor';
+export const ORCHESTRATOR_PROFILE_ID = 'builtin:orchestrator';
+/** Compatibility projection for persisted settings; Profile identity remains canonical. */
+export function profileIdFromLegacyMode(mode) {
+    if (mode?.orchestratorMode)
+        return ORCHESTRATOR_PROFILE_ID;
+    if (mode?.liteMode)
+        return LITE_PROFILE_ID;
+    if (mode?.planMode)
+        return PLAN_PROFILE_ID;
+    if (mode?.mentorMode)
+        return MENTOR_PROFILE_ID;
+    return STANDARD_PROFILE_ID;
+}
+export function legacyModeFromProfileId(profileId) {
+    switch (profileId) {
+        case ORCHESTRATOR_PROFILE_ID:
+            return { orchestratorMode: true, liteMode: false, planMode: false, mentorMode: false };
+        case LITE_PROFILE_ID:
+            return { orchestratorMode: false, liteMode: true, planMode: false, mentorMode: false };
+        case PLAN_PROFILE_ID:
+            return { orchestratorMode: false, liteMode: false, planMode: true, mentorMode: false };
+        case MENTOR_PROFILE_ID:
+            return { orchestratorMode: false, liteMode: false, planMode: false, mentorMode: true };
+        case STANDARD_PROFILE_ID:
+            return { orchestratorMode: false, liteMode: false, planMode: false, mentorMode: false };
+        default:
+            throw new Error(`Cannot project unknown Profile '${profileId}' to legacy mode flags`);
+    }
+}
+export function normalizeLegacyMode(mode) {
+    return legacyModeFromProfileId(profileIdFromLegacyMode(mode));
+}
+const LEGACY_MODE_SETTING_FIELDS = Object.freeze({
+    'app.orchestratorMode': 'orchestratorMode',
+    'app.liteMode': 'liteMode',
+    'app.planMode': 'planMode',
+    'app.mentorMode': 'mentorMode',
+});
+export function isLegacyModeSettingKey(key) {
+    return Object.prototype.hasOwnProperty.call(LEGACY_MODE_SETTING_FIELDS, key);
+}
+/** Map one legacy setting write to the canonical Profile selected by the flags. */
+export function profileIdFromLegacyModeSetting(key, value, currentProfileId) {
+    if (!isLegacyModeSettingKey(key) || typeof value !== 'boolean')
+        return undefined;
+    const field = LEGACY_MODE_SETTING_FIELDS[key];
+    if (value)
+        return profileIdFromLegacyMode({ [field]: true });
+    const activeField = Object.entries(LEGACY_MODE_SETTING_FIELDS).find(([, name]) => {
+        try {
+            return legacyModeFromProfileId(currentProfileId)[name] === true;
+        }
+        catch {
+            return false;
+        }
+    })?.[1];
+    return activeField === field ? STANDARD_PROFILE_ID : currentProfileId;
+}
+export const legacyModeAdapter = Object.freeze({
+    profileIdFromLegacyMode,
+    legacyModeFromProfileId,
+    normalizeLegacyMode,
+    profileIdFromLegacyModeSetting,
+});
+//# sourceMappingURL=legacy-adapter.js.map

package/dist/services/profiles/legacy-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-adapter.js","sourceRoot":"","sources":["../../../source/services/profiles/legacy-adapter.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,mBAAmB,GAAG,kBAA2B,CAAC;AAC/D,MAAM,CAAC,MAAM,eAAe,GAAG,cAAuB,CAAC;AACvD,MAAM,CAAC,MAAM,eAAe,GAAG,cAAuB,CAAC;AACvD,MAAM,CAAC,MAAM,iBAAiB,GAAG,gBAAyB,CAAC;AAC3D,MAAM,CAAC,MAAM,uBAAuB,GAAG,sBAA+B,CAAC;AAEvE,2FAA2F;AAC3F,MAAM,UAAU,uBAAuB,CAAC,IAAuC;IAC7E,IAAI,IAAI,EAAE,gBAAgB;QAAE,OAAO,uBAAuB,CAAC;IAC3D,IAAI,IAAI,EAAE,QAAQ;QAAE,OAAO,eAAe,CAAC;IAC3C,IAAI,IAAI,EAAE,QAAQ;QAAE,OAAO,eAAe,CAAC;IAC3C,IAAI,IAAI,EAAE,UAAU;QAAE,OAAO,iBAAiB,CAAC;IAC/C,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,SAAiB;IACvD,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,uBAAuB;YAC1B,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QACzF,KAAK,eAAe;YAClB,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QACzF,KAAK,eAAe;YAClB,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QACzF,KAAK,iBAAiB;YACpB,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;QACzF,KAAK,mBAAmB;YACtB,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QAC1F;YACE,MAAM,IAAI,KAAK,CAAC,mCAAmC,SAAS,wBAAwB,CAAC,CAAC;IAC1F,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAuC;IACzE,OAAO,uBAAuB,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,0BAA0B,GAAG,MAAM,CAAC,MAAM,CAAC;IAC/C,sBAAsB,EAAE,kBAAkB;IAC1C,cAAc,EAAE,UAAU;IAC1B,cAAc,EAAE,UAAU;IAC1B,gBAAgB,EAAE,YAAY;CACtB,CAAC,CAAC;AAIZ,MAAM,UAAU,sBAAsB,CAAC,GAAW;IAChD,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,0BAA0B,EAAE,GAAG,CAAC,CAAC;AAC/E,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,8BAA8B,CAC5C,GAAW,EACX,KAAc,EACd,gBAAwB;IAExB,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACjF,MAAM,KAAK,GAAG,0BAA0B,CAAC,GAAG,CAAC,CAAC;IAC9C,IAAI,KAAK;QAAE,OAAO,uBAAuB,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE;QAC/E,IAAI,CAAC;YACH,OAAO,uBAAuB,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;QAClE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACR,OAAO,WAAW,KAAK,KAAK,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAE,gBAA8B,CAAC;AACvF,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7C,uBAAuB;IACvB,uBAAuB;IACvB,mBAAmB;IACnB,8BAA8B;CAC/B,CAAC,CAAC"}

package/dist/services/profiles/profile-transition.d.ts

@@ -0,0 +1,48 @@
+import type { ISettingsService } from '../service-interfaces.js';
+import type { ResolvedProfile } from './types.js';
+export type ProfileTransitionClass = 'noop' | 'structural' | 'notice-only' | 'agent-rebuild';
+export type ProfileTransitionPlan = {
+    targetId: string;
+    class: ProfileTransitionClass;
+    exitNotice: string | null;
+    enterNotice: string | null;
+    composedNotice: string | null;
+};
+export type ProfileTransitionPlanningDeps = {
+    availableIntegrations?: ReadonlyMap<string, boolean>;
+};
+export type ProfileTransitionDeps = ProfileTransitionPlanningDeps & {
+    /** Rebuild the active agent using the currently selected model. */
+    rebuildAgent?: () => void;
+    /** Queue the one notice produced by this transition. */
+    queueModeNotice?: (text: string) => void;
+    /** Whether this structural transition has existing history to protect. */
+    requiresHistoryConfirmation?: boolean | (() => boolean);
+    /** Clear the conversation when a structural transition is confirmed. */
+    clearConversation?: () => void | Promise<void>;
+};
+/** The interactive runtime exposes all built-in integration points. */
+export declare const DEFAULT_AVAILABLE_INTEGRATIONS: ReadonlyMap<string, boolean>;
+/**
+ * Classify the runtime impact of changing between two resolved Profiles.
+ * Identity equality intentionally wins: re-selecting a Profile has no effects,
+ * even when that Profile itself carries a workflow notice.
+ */
+export declare function classifyProfileTransition(current: ResolvedProfile, target: ResolvedProfile): ProfileTransitionClass;
+export declare function planProfileTransition(settingsService: ISettingsService, targetId: string, deps?: ProfileTransitionPlanningDeps): ProfileTransitionPlan;
+/** Owns Profile activation effects after pure resolution and classification. */
+export declare class ProfileTransitionService {
+    #private;
+    constructor(settingsService: ISettingsService, deps?: ProfileTransitionDeps);
+    constructor(deps: ProfileTransitionDeps & {
+        settingsService: ISettingsService;
+    });
+    plan(targetId: string): ProfileTransitionPlan;
+    activate(targetId: string): ProfileTransitionPlan;
+    /**
+     * Apply the runtime effects of a plan whose canonical selection has already
+     * been committed by a surrounding settings transaction.
+     */
+    commit(plan: ProfileTransitionPlan): void;
+}
+//# sourceMappingURL=profile-transition.d.ts.map