@1mcp/agent 0.39.6 → 0.40.0-beta.0

package/build/domains/installation/knownServerSetup.js

@@ -0,0 +1,330 @@
+import { constants, readFileSync } from 'node:fs';
+import { access, realpath, stat } from 'node:fs/promises';
+import path from 'node:path';
+import ConfigContext from '../../config/configContext.js';
+import { getRuntimeParentEnvironment } from '../../config/runtimeBootstrap.js';
+import { transportConfigSchema } from '../../core/types/transport.js';
+import { createConfigChangeService, fingerprintConfiguredServerConfigDocument, fingerprintConfiguredServerDefaults, fingerprintConfiguredServerTarget, } from '../config-change/configChange.js';
+import { z } from 'zod';
+import { knownServerExamples } from './knownServerCatalog.js';
+import { isValidServerName } from './validators/serverNameValidator.js';
+const checkoutMarker = '{{{project.path}}}';
+const literalPath = z
+    .string()
+    .min(1)
+    .refine((value) => !/[${}]/u.test(value) &&
+    [...value].every((character) => character.charCodeAt(0) >= 32 && character.charCodeAt(0) !== 127), {
+    message: 'Use a literal path without control characters, environment references, or template markers.',
+});
+const absolutePath = literalPath.refine(path.isAbsolute, { message: 'Provide an absolute path.' });
+const knownSourceSchema = z
+    .object({
+    type: z.literal('known'),
+    exampleId: z.string().min(1),
+    localName: z.string().refine(isValidServerName, { message: 'Invalid local server name.' }).optional(),
+    executable: absolutePath.optional(),
+    checkout: absolutePath.optional(),
+})
+    .strict();
+function readKnownConfiguration() {
+    const configPath = ConfigContext.getInstance().getResolvedConfigPath();
+    let content;
+    try {
+        content = readFileSync(configPath, 'utf8');
+    }
+    catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT')
+            return { mcpServers: {} };
+        throw error;
+    }
+    const server = z.custom((value) => value !== null && typeof value === 'object' && !Array.isArray(value));
+    return z
+        .object({
+        mcpServers: z.record(z.string(), server).optional(),
+        mcpTemplates: z.record(z.string(), server).optional(),
+    })
+        .loose()
+        .parse(JSON.parse(content));
+}
+export async function resolveKnownServerExecutable(executable) {
+    if (!literalPath.safeParse(executable).success)
+        return undefined;
+    if (!path.isAbsolute(executable) && path.basename(executable) !== executable)
+        return undefined;
+    const candidates = path.isAbsolute(executable)
+        ? [executable]
+        : (getRuntimeParentEnvironment().PATH ?? '')
+            .split(path.delimiter)
+            .filter((directory) => path.isAbsolute(directory))
+            .map((directory) => path.join(directory, executable));
+    for (const candidate of candidates) {
+        if (!absolutePath.safeParse(candidate).success)
+            continue;
+        try {
+            await access(candidate, constants.X_OK);
+            if (!(await stat(candidate)).isFile())
+                continue;
+            const canonical = await realpath(candidate);
+            if (!absolutePath.safeParse(canonical).success)
+                continue;
+            const launcher = path.join(await realpath(path.dirname(candidate)), path.basename(candidate));
+            if (!absolutePath.safeParse(launcher).success)
+                continue;
+            return launcher;
+        }
+        catch {
+            continue;
+        }
+    }
+    return undefined;
+}
+export function createKnownServerSetupWorkflow(ports = {}) {
+    return {
+        run: (input) => setupKnownServer(input, ports),
+    };
+}
+export async function setupKnownServer(input, ports = {}) {
+    const base = {
+        status: 'invalid_input',
+        mode: input.mode,
+        sourceType: 'known',
+        warnings: [],
+    };
+    const parsed = knownSourceSchema.safeParse(input.source);
+    if (!parsed.success) {
+        return { ...base, fieldErrors: z.flattenError(parsed.error).fieldErrors };
+    }
+    const expectedFingerprint = z.string().min(1).optional().safeParse(input.expectedSetupFingerprint);
+    if (!expectedFingerprint.success) {
+        return {
+            ...base,
+            fieldErrors: { expectedSetupFingerprint: ['Provide a nonempty setup fingerprint from preview.'] },
+        };
+    }
+    const source = parsed.data;
+    const example = knownServerExamples.find((entry) => entry.id === source.exampleId);
+    if (!example) {
+        return {
+            ...base,
+            status: 'not_found',
+            error: `Unknown example '${source.exampleId}'. Choose ${knownServerExamples.map((entry) => entry.id).join(', ')}.`,
+        };
+    }
+    const targetName = source.localName ?? example.id;
+    const targetSource = source.checkout === undefined ? 'mcpTemplates' : 'mcpServers';
+    const result = {
+        ...base,
+        targetName,
+        targetSource,
+        exampleId: example.id,
+        metadata: { localName: targetName },
+        warnings: [
+            'Maintained setup examples do not enable automatic preparation. Existing custom preparation recipes are preserved; setup does not verify their native readiness.',
+            'Executable identity does not establish backend version compatibility or operation-specific readiness.',
+            ...example.nativeNextSteps,
+        ],
+    };
+    try {
+        const configuration = structuredClone((ports.readConfiguration ?? readKnownConfiguration)());
+        const configurationFingerprint = fingerprintConfiguredServerConfigDocument(configuration);
+        if (input.mode === 'apply' &&
+            expectedFingerprint.data !== undefined &&
+            !expectedFingerprint.data.startsWith(`${configurationFingerprint}.`)) {
+            return {
+                ...result,
+                status: 'setup_conflict',
+                error: 'Known server setup changed after preview. Review a new preview before applying.',
+            };
+        }
+        const otherSource = targetSource === 'mcpServers' ? 'mcpTemplates' : 'mcpServers';
+        if (Object.hasOwn(configuration[otherSource] ?? {}, targetName)) {
+            return {
+                ...result,
+                status: 'template_conflict',
+                error: `Target '${targetName}' exists in ${otherSource}; setup cannot convert target sources, even with force.`,
+            };
+        }
+        const existing = Object.hasOwn(configuration[targetSource] ?? {}, targetName)
+            ? configuration[targetSource]?.[targetName]
+            : undefined;
+        const inheritedEnv = z
+            .object({ env: z.unknown().optional() })
+            .loose()
+            .parse(configuration.serverDefaults ?? {}).env;
+        let exampleEnv = Array.isArray(inheritedEnv) ? undefined : example.env;
+        if (exampleEnv && inheritedEnv !== null && typeof inheritedEnv === 'object') {
+            const missingDefaults = Object.entries(exampleEnv).filter(([key]) => !Object.hasOwn(inheritedEnv, key));
+            exampleEnv = missingDefaults.length > 0 ? Object.fromEntries(missingDefaults) : undefined;
+        }
+        if (example.env && (Array.isArray(inheritedEnv) || Array.isArray(existing?.env))) {
+            result.warnings.push('Preserved array-form environment inheritance; example environment defaults are not added. Review native download and daemon settings before starting the backend.');
+        }
+        const requestedExecutable = source.executable ?? existing?.command ?? example.executable;
+        const executable = await (ports.resolveExecutable ?? resolveKnownServerExecutable)(requestedExecutable);
+        if (!executable) {
+            const error = `Executable '${requestedExecutable}' is missing or not executable. ${example.prerequisites.join(' ')} Supply --executable with an absolute launcher path.`;
+            return {
+                ...result,
+                error,
+                fieldErrors: { executable: [error] },
+            };
+        }
+        if (!absolutePath.safeParse(executable).success) {
+            const error = 'Resolved executable must be an absolute literal launcher path.';
+            return { ...result, error, fieldErrors: { executable: [error] } };
+        }
+        let checkout = checkoutMarker;
+        if (source.checkout !== undefined) {
+            checkout = await realpath(source.checkout);
+            if (!absolutePath.safeParse(checkout).success || !(await stat(checkout)).isDirectory()) {
+                return { ...result, error: 'Checkout must resolve to a literal directory path.' };
+            }
+        }
+        let config = {
+            ...example.config,
+            type: 'stdio',
+            command: executable,
+            args: example.args.map((argument) => (argument === checkoutMarker ? checkout : argument)),
+            cwd: checkout,
+            ...(exampleEnv ? { env: { ...exampleEnv } } : {}),
+        };
+        if (existing) {
+            if (existing.type !== 'stdio' && existing.type !== undefined) {
+                return { ...result, status: 'exists', error: 'Known setup cannot convert an existing non-stdio target.' };
+            }
+            if (targetSource === 'mcpTemplates') {
+                const checkoutIndex = example.args.indexOf(checkoutMarker);
+                if (existing.cwd !== checkoutMarker || existing.args?.[checkoutIndex] !== checkoutMarker) {
+                    return {
+                        ...result,
+                        error: `Existing template is not reusable: cwd and the checkout argument must both use ${checkoutMarker}. Reconfigure these explicit fields through the existing config edit workflow.`,
+                    };
+                }
+            }
+            const compatible = existing.command === executable;
+            if (!compatible && !input.force) {
+                return {
+                    ...result,
+                    status: 'exists',
+                    error: `Target '${targetName}' has a different launch configuration. Use force to reconfigure it.`,
+                };
+            }
+            config = {
+                ...example.config,
+                ...existing,
+                ...(example.config?.template ? { template: { ...example.config.template, ...existing.template } } : {}),
+                command: executable,
+                ...(exampleEnv ? { env: Array.isArray(existing.env) ? existing.env : { ...exampleEnv, ...existing.env } } : {}),
+            };
+            const matchesLaunch = example.args.every((argument, index) => argument === checkoutMarker || existing.args?.[index] === argument);
+            if (!matchesLaunch) {
+                if (!input.force) {
+                    return {
+                        ...result,
+                        status: 'exists',
+                        error: 'Existing custom launch arguments differ from the example. Use force to explicitly preserve this unverified custom launch configuration.',
+                    };
+                }
+                result.warnings.push('Preserved custom launch configuration is not a verified example recipe.');
+            }
+            if (source.checkout !== undefined) {
+                const checkoutIndex = example.args.indexOf(checkoutMarker);
+                if (!matchesLaunch || existing.args?.[checkoutIndex] === undefined) {
+                    return {
+                        ...result,
+                        error: 'Existing custom launch arguments cannot be rebound safely. Reconfigure the target explicitly before changing its checkout.',
+                    };
+                }
+                const args = [...existing.args];
+                args[checkoutIndex] = checkout;
+                config = { ...config, args, cwd: checkout };
+            }
+        }
+        const validated = transportConfigSchema.safeParse(config);
+        if (!validated.success) {
+            return {
+                ...result,
+                error: 'Candidate server configuration is invalid.',
+                fieldErrors: z.flattenError(validated.error).fieldErrors,
+            };
+        }
+        result.setupFingerprint = `${configurationFingerprint}.${fingerprintConfiguredServerConfigDocument({
+            targetName,
+            targetSource,
+            exampleId: example.id,
+            serverConfig: config,
+        })}`;
+        if (input.mode === 'apply' &&
+            expectedFingerprint.data !== undefined &&
+            expectedFingerprint.data !== result.setupFingerprint) {
+            return {
+                ...result,
+                status: 'setup_conflict',
+                error: 'Known server setup changed after preview. Review a new preview before applying.',
+            };
+        }
+        if (existing) {
+            if (fingerprintConfiguredServerTarget(existing) === fingerprintConfiguredServerTarget(config)) {
+                return { ...result, status: 'unchanged', config };
+            }
+            if (!input.force) {
+                return {
+                    ...result,
+                    status: 'exists',
+                    config,
+                    error: `Target '${targetName}' already exists. Use force to reconfigure it.`,
+                };
+            }
+        }
+        if (input.mode === 'preview')
+            return { ...result, status: 'preview', config };
+        const service = createConfigChangeService();
+        let change;
+        if (existing) {
+            change = await (ports.editTarget ?? service.editConfiguredServerTarget.bind(service))({
+                sourceName: targetName,
+                targetName,
+                targetSource,
+                serverConfig: config,
+                expectedSourceFingerprint: fingerprintConfiguredServerTarget(existing),
+                expectedGlobalConfigFingerprint: fingerprintConfiguredServerDefaults(configuration.serverDefaults),
+            });
+        }
+        else {
+            const create = targetSource === 'mcpTemplates'
+                ? (ports.createTemplate ?? service.createTemplateConfiguredServerTarget.bind(service))
+                : (ports.createStatic ?? service.createStaticConfiguredServerTarget.bind(service));
+            change = await create({
+                targetName,
+                serverConfig: config,
+                backup: input.backup ?? 'skip',
+                expectedConfigFingerprint: configurationFingerprint,
+            });
+        }
+        let status = 'failed';
+        if (change.status === 'changed')
+            status = 'applied';
+        if (change.status === 'unchanged')
+            status = 'unchanged';
+        if (change.status === 'destination_conflict')
+            status = 'exists';
+        if (change.status === 'template_conflict')
+            status = 'template_conflict';
+        return {
+            ...result,
+            status,
+            config,
+            configChange: change,
+            warnings: [...result.warnings, ...change.warnings],
+            error: change.error,
+        };
+    }
+    catch {
+        return {
+            ...result,
+            status: 'failed',
+            error: 'Known server setup failed. Check the executable, checkout directory, and configuration access; no dependency installation was attempted.',
+        };
+    }
+}
+//# sourceMappingURL=knownServerSetup.js.map

package/build/domains/installation/knownServerSetup.js.map

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

package/build/domains/installation/knownServerSetupTypes.d.ts

@@ -0,0 +1,34 @@
+import type { MCPServerParams } from '../../core/types/index.js';
+import type { ConfigBackupPolicy, ConfigChangeResult } from '../config-change/configChange.js';
+export interface KnownServerSetupSource {
+    type: 'known';
+    exampleId: string;
+    localName?: string;
+    executable?: string;
+    checkout?: string;
+}
+export interface KnownServerSetupInput {
+    mode: 'preview' | 'apply';
+    source: KnownServerSetupSource;
+    force?: boolean;
+    backup?: ConfigBackupPolicy;
+    expectedSetupFingerprint?: string;
+}
+export interface KnownServerSetupResult {
+    status: 'preview' | 'applied' | 'unchanged' | 'exists' | 'template_conflict' | 'setup_conflict' | 'invalid_input' | 'not_found' | 'failed';
+    mode: 'preview' | 'apply';
+    sourceType: 'known';
+    setupFingerprint?: string;
+    exampleId?: string;
+    targetSource?: 'mcpServers' | 'mcpTemplates';
+    targetName?: string;
+    config?: MCPServerParams;
+    metadata?: {
+        localName: string;
+    };
+    configChange?: ConfigChangeResult;
+    warnings: string[];
+    fieldErrors?: Record<string, string[]>;
+    error?: string;
+}
+//# sourceMappingURL=knownServerSetupTypes.d.ts.map

package/build/domains/installation/knownServerSetupTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knownServerSetupTypes.d.ts","sourceRoot":"","sources":["../../../src/domains/installation/knownServerSetupTypes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAEzG,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;IAC1B,MAAM,EAAE,sBAAsB,CAAC;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EACF,SAAS,GACT,SAAS,GACT,WAAW,GACX,QAAQ,GACR,mBAAmB,GACnB,gBAAgB,GAChB,eAAe,GACf,WAAW,GACX,QAAQ,CAAC;IACb,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,YAAY,GAAG,cAAc,CAAC;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,QAAQ,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/build/domains/installation/knownServerSetupTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=knownServerSetupTypes.js.map

package/build/domains/installation/knownServerSetupTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knownServerSetupTypes.js","sourceRoot":"","sources":["../../../src/domains/installation/knownServerSetupTypes.ts"],"names":[],"mappings":""}

package/build/domains/project-selection/projectBindingScope.d.ts

@@ -0,0 +1,7 @@
+import type { ContextData } from '../../types/context.js';
+export declare function withProjectBinding<T>(bindingId: string, context: ContextData | undefined, action: () => T): T;
+export declare function getProjectBinding(): {
+    bindingId: string;
+    context?: ContextData;
+} | undefined;
+//# sourceMappingURL=projectBindingScope.d.ts.map

package/build/domains/project-selection/projectBindingScope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectBindingScope.d.ts","sourceRoot":"","sources":["../../../src/domains/project-selection/projectBindingScope.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIzD,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAE7G;AAED,wBAAgB,iBAAiB,IAAI;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,WAAW,CAAA;CAAE,GAAG,SAAS,CAE5F"}

package/build/domains/project-selection/projectBindingScope.js

@@ -0,0 +1,9 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+const projectBindingScope = new AsyncLocalStorage();
+export function withProjectBinding(bindingId, context, action) {
+    return projectBindingScope.run({ bindingId, context }, action);
+}
+export function getProjectBinding() {
+    return projectBindingScope.getStore();
+}
+//# sourceMappingURL=projectBindingScope.js.map

package/build/domains/project-selection/projectBindingScope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectBindingScope.js","sourceRoot":"","sources":["../../../src/domains/project-selection/projectBindingScope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAIrD,MAAM,mBAAmB,GAAG,IAAI,iBAAiB,EAAgD,CAAC;AAElG,MAAM,UAAU,kBAAkB,CAAI,SAAiB,EAAE,OAAgC,EAAE,MAAe;IACxG,OAAO,mBAAmB,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,mBAAmB,CAAC,QAAQ,EAAE,CAAC;AACxC,CAAC"}

package/build/domains/project-selection/projectPolicy.d.ts

@@ -0,0 +1,11 @@
+import type { InboundConnectionConfig } from '../../core/types/server.js';
+import type { MCPServerParams } from '../../core/types/transport.js';
+import type { ContextData } from '../../types/context.js';
+export declare function hasExplicitProjectFilterSelection(filterConfig: InboundConnectionConfig): boolean;
+/** Resolve defaults from the selected checkout on the runtime. Client JSON carries no effective-policy assertions. */
+export declare function resolveProjectPolicies(context: ContextData, filterConfig?: InboundConnectionConfig): Promise<InboundConnectionConfig[]>;
+export declare function isProjectBackendVisible(config: MCPServerParams | undefined, context: ContextData | undefined, policies: readonly InboundConnectionConfig[]): boolean;
+/** Explain target ambiguity only for configured backends admitted by the request's existing filter. */
+export declare function projectSelectionDiagnostic(config: MCPServerParams | undefined, context: ContextData | undefined, filterConfig: InboundConnectionConfig): string | undefined;
+export declare function projectToolArguments(config: MCPServerParams | undefined, context: ContextData | undefined, args: unknown): unknown;
+//# sourceMappingURL=projectPolicy.d.ts.map

package/build/domains/project-selection/projectPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectPolicy.d.ts","sourceRoot":"","sources":["../../../src/domains/project-selection/projectPolicy.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIzD,wBAAgB,iCAAiC,CAAC,YAAY,EAAE,uBAAuB,GAAG,OAAO,CAUhG;AAED,sHAAsH;AACtH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,WAAW,EACpB,YAAY,GAAE,uBAA4B,GACzC,OAAO,CAAC,uBAAuB,EAAE,CAAC,CA2BpC;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,eAAe,GAAG,SAAS,EACnC,OAAO,EAAE,WAAW,GAAG,SAAS,EAChC,QAAQ,EAAE,SAAS,uBAAuB,EAAE,GAC3C,OAAO,CAWT;AAED,uGAAuG;AACvG,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,eAAe,GAAG,SAAS,EACnC,OAAO,EAAE,WAAW,GAAG,SAAS,EAChC,YAAY,EAAE,uBAAuB,GACpC,MAAM,GAAG,SAAS,CAWpB;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,eAAe,GAAG,SAAS,EACnC,OAAO,EAAE,WAAW,GAAG,SAAS,EAChC,IAAI,EAAE,OAAO,GACZ,OAAO,CAsBT"}

package/build/domains/project-selection/projectPolicy.js

@@ -0,0 +1,104 @@
+import { normalizeTags, resolveProjectContext } from '../../config/projectConfigLoader.js';
+import { resolveFilterSelection } from '../../core/filtering/filterSelection.js';
+import { TemplateFilteringService } from '../../core/filtering/templateFilteringService.js';
+import { PresetManager } from '../preset/manager/presetManager.js';
+import { requireProjectTarget, resolveProjectSelection } from './projectSelection.js';
+export function hasExplicitProjectFilterSelection(filterConfig) {
+    const mode = filterConfig.projectFilterMode ?? filterConfig.tagFilterMode;
+    if (mode === 'none')
+        return false;
+    if (mode !== undefined)
+        return true;
+    return (filterConfig.presetName !== undefined ||
+        filterConfig.tagQuery !== undefined ||
+        filterConfig.tagExpression !== undefined ||
+        (filterConfig.tags?.length ?? 0) > 0);
+}
+/** Resolve defaults from the selected checkout on the runtime. Client JSON carries no effective-policy assertions. */
+export async function resolveProjectPolicies(context, filterConfig = {}) {
+    const selection = resolveProjectSelection(context);
+    if (selection.kind === 'unresolved')
+        return [];
+    // Preserve the existing explicit-selector precedence for a single checkout.
+    // Combined selection always retains each runtime-derived member policy.
+    if (selection.kind === 'single' && hasExplicitProjectFilterSelection(filterConfig)) {
+        const { tags, tagExpression, tagQuery, tagFilterMode, presetName } = filterConfig;
+        return [{ tags, tagExpression, tagQuery, tagFilterMode, presetName }];
+    }
+    return Promise.all(selection.projects.map(async (project) => {
+        const { projectConfig } = await resolveProjectContext(project.path);
+        let filters = {};
+        if (projectConfig?.preset !== undefined) {
+            filters = { preset: projectConfig.preset };
+        }
+        else if (projectConfig?.filter !== undefined) {
+            filters = { filter: projectConfig.filter };
+        }
+        else if (projectConfig?.tags !== undefined) {
+            filters = { tags: normalizeTags(projectConfig.tags)?.join(',') };
+        }
+        const result = resolveFilterSelection(filters, {
+            presetLookup: { getPreset: (name) => PresetManager.getInstance().getPreset(name) ?? undefined },
+        });
+        if (!result.ok)
+            throw new Error(`Invalid project filter for ${project.label}: ${result.error.message}`);
+        return result.selection.compatibility;
+    }));
+}
+export function isProjectBackendVisible(config, context, policies) {
+    if (!config)
+        return true;
+    const mode = config.projectTarget?.mode ?? (config.template ? 'single' : 'independent');
+    if (mode === 'independent')
+        return true;
+    if (!context)
+        return !config.projectTarget;
+    const selected = resolveProjectSelection(context);
+    if (selected.kind === 'unresolved')
+        return false;
+    if (selected.kind === 'native-set' && mode !== 'native-set')
+        return false;
+    return policies.every((policy) => TemplateFilteringService.getMatchingTemplates([['backend', config]], policy).length === 1);
+}
+/** Explain target ambiguity only for configured backends admitted by the request's existing filter. */
+export function projectSelectionDiagnostic(config, context, filterConfig) {
+    if (!config || !context || config.disabled)
+        return undefined;
+    const mode = config.projectTarget?.mode ?? (config.template ? 'single' : 'independent');
+    if (mode === 'independent')
+        return undefined;
+    if (TemplateFilteringService.getMatchingTemplates([['backend', config]], filterConfig).length === 0)
+        return undefined;
+    try {
+        requireProjectTarget(context, mode);
+    }
+    catch (error) {
+        return error instanceof Error ? error.message : String(error);
+    }
+    return undefined;
+}
+export function projectToolArguments(config, context, args) {
+    if (!config?.projectTarget)
+        return args;
+    const { mode, argument } = config.projectTarget;
+    if (mode === 'independent')
+        return args;
+    if (!context)
+        throw new Error('Project Selection is unresolved. Use --project <checkout> or --project-set <file>');
+    const selected = requireProjectTarget(context, mode);
+    if (!argument) {
+        if (!config.template)
+            throw new Error('This checkout-specific static backend has no target argument. Configure a target-bound template or an explicit projectTarget.argument.');
+        return args;
+    }
+    if (args !== undefined && (args === null || typeof args !== 'object' || Array.isArray(args))) {
+        throw new Error('Project-targeted tool arguments must be an object');
+    }
+    const supplied = args;
+    const target = mode === 'native-set' ? selected.map((project) => project.path) : selected[0].path;
+    if (supplied?.[argument] !== undefined && JSON.stringify(supplied[argument]) !== JSON.stringify(target)) {
+        throw new Error(`Tool argument '${argument}' conflicts with the explicit Project Selection`);
+    }
+    return { ...supplied, [argument]: target };
+}
+//# sourceMappingURL=projectPolicy.js.map

package/build/domains/project-selection/projectPolicy.js.map

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

package/build/domains/project-selection/projectSelection.d.ts

@@ -0,0 +1,30 @@
+import type { ContextData, ProjectSet, ProjectSetMember } from '../../types/context.js';
+import { z } from 'zod';
+export declare const projectSetSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    projects: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        path: z.ZodString;
+    }, z.core.$strict>>;
+    selection: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+export type ResolvedProjectSelection = {
+    kind: 'unresolved';
+    availableLabels: string[];
+} | {
+    kind: 'single';
+    projects: [ProjectSetMember];
+} | {
+    kind: 'native-set';
+    projects: ProjectSetMember[];
+};
+export declare function resolveProjectSelection(context: Pick<ContextData, 'project' | 'projectSet'>): ResolvedProjectSelection;
+export declare function canonicalizeProjectSet(value: unknown, baseDirectory: string, resolveCheckout?: typeof canonicalizeCheckoutPath): Promise<ProjectSet>;
+export declare function canonicalizeCheckoutPath(checkout: string, baseDirectory: string): Promise<string>;
+/** The only saved state is a user-selected file; this never updates a runtime-global current project. */
+export declare function loadProjectSet(file: string, selection?: string[], resolveCheckout?: typeof canonicalizeCheckoutPath): Promise<ProjectSet>;
+export declare function withProjectSelection(context: ContextData, projectSet: ProjectSet): ContextData;
+/** Private routing identity. The canonical authentication/transport session remains unchanged. */
+export declare function createProjectBindingId(sessionId: string, context: ContextData, bindingConfiguration?: unknown): string;
+export declare function requireProjectTarget(context: ContextData, mode: 'independent' | 'single' | 'native-set'): ProjectSetMember[];
+//# sourceMappingURL=projectSelection.d.ts.map

package/build/domains/project-selection/projectSelection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectSelection.d.ts","sourceRoot":"","sources":["../../../src/domains/project-selection/projectSelection.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAIvF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,gBAAgB;;;;;;;kBAuBO,CAAC;AAErC,MAAM,MAAM,wBAAwB,GAChC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,eAAe,EAAE,MAAM,EAAE,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,CAAC,gBAAgB,CAAC,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,EAAE,gBAAgB,EAAE,CAAA;CAAE,CAAC;AAEzD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,YAAY,CAAC,GACnD,wBAAwB,CAa1B;AAED,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,OAAO,EACd,aAAa,EAAE,MAAM,EACrB,eAAe,kCAA2B,GACzC,OAAO,CAAC,UAAU,CAAC,CASrB;AAED,wBAAsB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAKvG;AAED,yGAAyG;AACzG,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,MAAM,EAAE,EACpB,eAAe,kCAA2B,GACzC,OAAO,CAAC,UAAU,CAAC,CAwBrB;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,GAAG,WAAW,CAS9F;AAED,kGAAkG;AAClG,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,EACpB,oBAAoB,CAAC,EAAE,OAAO,GAC7B,MAAM,CAYR;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,aAAa,GAAG,QAAQ,GAAG,YAAY,GAC5C,gBAAgB,EAAE,CAcpB"}