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

package/build/domains/backend-preparation/contracts.d.ts

@@ -0,0 +1,131 @@
+export type PreparationAction = 'initialize' | 'sync' | 'rebuild' | 'install' | 'paid';
+/** All identity and authorization resolution happens before entering this domain. */
+export interface PreparationTarget {
+    readonly checkoutRoot: string;
+    readonly backendName: string;
+    readonly backendIdentity: string;
+    readonly configurationKey: string;
+}
+export interface BackendPolicy {
+    readonly allowedActions: readonly PreparationAction[];
+    readonly executionDeadlineMs?: number;
+    readonly transientRetryLimit?: number;
+}
+export type ProjectPreparationPreferences = Readonly<Record<string, {
+    readonly enabled: boolean;
+}>>;
+export interface ReadinessEvidence {
+    readonly freshness: 'current' | 'stale' | 'unknown';
+    readonly coverage: 'complete' | 'partial' | 'unknown';
+    readonly detail: string;
+}
+export type BackendReadiness = {
+    readonly state: 'ready';
+    readonly evidence: ReadinessEvidence;
+} | {
+    readonly state: 'required';
+    readonly action: PreparationAction;
+    readonly instructions: string;
+    readonly evidence: ReadinessEvidence;
+} | {
+    readonly state: 'unknown';
+    readonly reason: 'inspection_timeout' | 'caller_disconnected' | 'unmapped_exit' | 'probe_failed';
+    readonly instructions: string;
+} | {
+    readonly state: 'unsupported' | 'conflict';
+    readonly instructions: string;
+};
+export interface PreparationFailure {
+    readonly code: string;
+    readonly message: string;
+    readonly retryable: boolean;
+    readonly instructions: string;
+}
+/** Saved status is advisory: never a process ownership credential. */
+export interface PreparationRecoveryHint {
+    readonly previousJobId: string;
+    readonly previousState: string;
+}
+export interface PreparationProgress {
+    readonly message?: string;
+    readonly completed?: number;
+    readonly total?: number;
+    readonly unit?: string;
+}
+export interface BackendPreparationAdapter {
+    /** Optional read-only status command; missing or invalid data means progress unavailable. */
+    progress?(target: PreparationTarget, operation: string, options?: {
+        readonly signal?: AbortSignal;
+        readonly waitMs?: number;
+    }): Promise<PreparationProgress | undefined>;
+    inspect(target: PreparationTarget, operation: string, options?: {
+        readonly signal?: AbortSignal;
+        readonly waitMs?: number;
+    }): Promise<BackendReadiness>;
+    /** Must settle only once owned work has stopped. Abort must never stop foreign work. */
+    prepare(target: PreparationTarget, action: PreparationAction, options: {
+        readonly signal: AbortSignal;
+        readonly executionDeadlineMs: number;
+        readonly operation?: string;
+    }): Promise<void>;
+    classifyFailure(error: unknown): PreparationFailure;
+    /** Must reconcile native readiness and ownership; unsupported recovery reports conflict. */
+    reconcile?(target: PreparationTarget, operation: string, advisory: PreparationRecoveryHint, options?: {
+        readonly signal?: AbortSignal;
+        readonly waitMs?: number;
+    }): Promise<BackendReadiness>;
+}
+export interface PreparationOptions {
+    readonly concurrency: number;
+    readonly queueCapacity: number;
+    readonly requestWaitMs: number;
+    readonly executionDeadlineMs: number;
+    readonly maxRecords: number;
+}
+export interface PreparationRequestOptions {
+    readonly waitMs?: number;
+    readonly signal?: AbortSignal;
+    /** Trusted runtime-only synchronous advisory-capacity reservation; never a backend-operation callback. */
+    readonly beforeAdmission?: () => void;
+    /** Optional caller-owned asynchronous validation after native inspection, before a new job is scheduled. */
+    readonly validateAdmission?: () => Promise<void>;
+}
+export type PreparationState = 'queued' | 'running' | 'cancelling' | 'ready' | 'not_ready' | 'failed' | 'cancelled';
+export interface PreparationStatus {
+    readonly id: string;
+    readonly target: PreparationTarget;
+    readonly operation: string;
+    readonly action: PreparationAction;
+    readonly state: PreparationState;
+    readonly attempt: number;
+    readonly executionDeadlineMs: number;
+    readonly elapsedMs?: number;
+    readonly progress?: PreparationProgress;
+    readonly readiness?: BackendReadiness;
+    readonly failure?: PreparationFailure;
+}
+export type PreparationResult = {
+    readonly state: 'ready';
+    readonly readiness: BackendReadiness;
+} | {
+    readonly state: 'job';
+    readonly status: PreparationStatus;
+} | Extract<BackendReadiness, {
+    state: 'unknown';
+}> | {
+    readonly state: 'busy' | 'disabled' | 'unsupported' | 'conflict' | 'forbidden';
+    readonly instructions: string;
+};
+export type PreparationAdmission = {
+    readonly state: 'ready';
+    readonly readiness: BackendReadiness;
+} | {
+    readonly state: 'pending';
+    readonly status: PreparationStatus;
+    readonly operationExecuted: false;
+    readonly operationQueued: false;
+    readonly instructions: string;
+} | Exclude<PreparationResult, {
+    state: 'ready';
+}>;
+//# sourceMappingURL=contracts.d.ts.map

package/build/domains/backend-preparation/contracts.d.ts.map

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

package/build/domains/backend-preparation/contracts.js

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

package/build/domains/backend-preparation/contracts.js.map

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

package/build/domains/backend-preparation/integrationDefinitions.d.ts

@@ -0,0 +1,171 @@
+import { z } from 'zod';
+import { type ConfiguredCommandHelperSnapshot, ConfiguredCommandIntegrationSchema } from './configuredCommandAdapter.js';
+export declare const AffectedPreparationToolsSchema: z.ZodUnion<readonly [z.ZodLiteral<"all">, z.ZodArray<z.ZodString>]>;
+export declare const IntegrationDefinitionSelectionSchema: z.ZodObject<{
+    id: z.ZodString;
+    file: z.ZodOptional<z.ZodString>;
+    inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strict>;
+export declare const IntegrationDefinitionSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    id: z.ZodString;
+    revision: z.ZodString;
+    helperRevision: z.ZodString;
+    helperFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    compatibility: z.ZodObject<{
+        backend: z.ZodString;
+        versions: z.ZodArray<z.ZodString>;
+        platforms: z.ZodArray<z.ZodEnum<{
+            darwin: "darwin";
+            linux: "linux";
+            win32: "win32";
+        }>>;
+        readinessScope: z.ZodString;
+    }, z.core.$strict>;
+    inputs: z.ZodRecord<z.ZodString, z.ZodObject<{
+        required: z.ZodOptional<z.ZodBoolean>;
+        default: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    affectedTools: z.ZodUnion<readonly [z.ZodLiteral<"all">, z.ZodArray<z.ZodString>]>;
+    integration: z.ZodObject<{
+        containment: z.ZodLiteral<"posix-process-group">;
+        probe: z.ZodObject<{
+            executable: z.ZodString;
+            args: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+        status: z.ZodOptional<z.ZodObject<{
+            executable: z.ZodString;
+            args: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>>;
+        readinessExitCodes: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+            state: z.ZodLiteral<"ready">;
+        }, z.core.$strict>, z.ZodObject<{
+            state: z.ZodLiteral<"required">;
+            action: z.ZodEnum<{
+                initialize: "initialize";
+                sync: "sync";
+                rebuild: "rebuild";
+                install: "install";
+                paid: "paid";
+            }>;
+            instructions: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            state: z.ZodLiteral<"conflict">;
+            instructions: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            state: z.ZodLiteral<"unsupported">;
+            instructions: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            state: z.ZodLiteral<"unknown">;
+            reason: z.ZodLiteral<"probe_failed">;
+            instructions: z.ZodString;
+        }, z.core.$strict>], "state">>;
+        actions: z.ZodRecord<z.ZodEnum<{
+            initialize: "initialize";
+            sync: "sync";
+            rebuild: "rebuild";
+            install: "install";
+            paid: "paid";
+        }> & z.core.$partial, z.ZodObject<{
+            executable: z.ZodString;
+            args: z.ZodArray<z.ZodString>;
+            successExitCodes: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
+            transientExitCodes: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
+        }, z.core.$strict>>;
+        inspectionTimeoutMs: z.ZodDefault<z.ZodNumber>;
+        outputLimitBytes: z.ZodDefault<z.ZodNumber>;
+        terminationGraceMs: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type IntegrationDefinition = z.input<typeof IntegrationDefinitionSchema>;
+export type IntegrationDefinitionSelection = z.infer<typeof IntegrationDefinitionSelectionSchema>;
+export interface ResolvedIntegrationDefinition {
+    readonly definition: z.output<typeof IntegrationDefinitionSchema>;
+    readonly integration: z.output<typeof ConfiguredCommandIntegrationSchema>;
+    readonly affectedTools: z.infer<typeof AffectedPreparationToolsSchema>;
+    readonly revision: string;
+    readonly helperSnapshots: readonly ConfiguredCommandHelperSnapshot[];
+}
+/** Read-only resolution from runtime-owned inputs. Never reads caller or project configuration. */
+export declare function resolveIntegrationDefinition(selection: IntegrationDefinitionSelection, builtins?: readonly IntegrationDefinition[]): ResolvedIntegrationDefinition;
+export declare const PreparationConfigSchema: z.ZodObject<{
+    adapter: z.ZodLiteral<"configured-command">;
+    affectedTools: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"all">, z.ZodArray<z.ZodString>]>>;
+    integration: z.ZodOptional<z.ZodObject<{
+        containment: z.ZodLiteral<"posix-process-group">;
+        probe: z.ZodObject<{
+            executable: z.ZodString;
+            args: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+        status: z.ZodOptional<z.ZodObject<{
+            executable: z.ZodString;
+            args: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>>;
+        readinessExitCodes: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+            state: z.ZodLiteral<"ready">;
+        }, z.core.$strict>, z.ZodObject<{
+            state: z.ZodLiteral<"required">;
+            action: z.ZodEnum<{
+                initialize: "initialize";
+                sync: "sync";
+                rebuild: "rebuild";
+                install: "install";
+                paid: "paid";
+            }>;
+            instructions: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            state: z.ZodLiteral<"conflict">;
+            instructions: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            state: z.ZodLiteral<"unsupported">;
+            instructions: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            state: z.ZodLiteral<"unknown">;
+            reason: z.ZodLiteral<"probe_failed">;
+            instructions: z.ZodString;
+        }, z.core.$strict>], "state">>;
+        actions: z.ZodRecord<z.ZodEnum<{
+            initialize: "initialize";
+            sync: "sync";
+            rebuild: "rebuild";
+            install: "install";
+            paid: "paid";
+        }> & z.core.$partial, z.ZodObject<{
+            executable: z.ZodString;
+            args: z.ZodArray<z.ZodString>;
+            successExitCodes: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
+            transientExitCodes: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
+        }, z.core.$strict>>;
+        inspectionTimeoutMs: z.ZodDefault<z.ZodNumber>;
+        outputLimitBytes: z.ZodDefault<z.ZodNumber>;
+        terminationGraceMs: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>>;
+    definition: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        file: z.ZodOptional<z.ZodString>;
+        inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strict>>;
+    activation: z.ZodOptional<z.ZodLiteral<"setup">>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    allowedActions: z.ZodArray<z.ZodEnum<{
+        initialize: "initialize";
+        sync: "sync";
+        rebuild: "rebuild";
+        install: "install";
+        paid: "paid";
+    }>>;
+    executionDeadlineMs: z.ZodOptional<z.ZodNumber>;
+    transientRetryLimit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type PreparationConfig = z.output<typeof PreparationConfigSchema>;
+export type EffectivePreparationConfig = PreparationConfig & {
+    affectedTools: z.infer<typeof AffectedPreparationToolsSchema>;
+    effectiveRevision?: string;
+    helperSnapshots?: readonly ConfiguredCommandHelperSnapshot[];
+};
+export declare class PreparationConfigurationError extends Error {
+    constructor(cause: unknown);
+}
+/** Validate setup/config changes without launching commands or applying configuration. */
+export declare function validatePreparationConfig(config: unknown, builtins?: readonly IntegrationDefinition[]): EffectivePreparationConfig;
+//# sourceMappingURL=integrationDefinitions.d.ts.map

package/build/domains/backend-preparation/integrationDefinitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrationDefinitions.d.ts","sourceRoot":"","sources":["../../../src/domains/backend-preparation/integrationDefinitions.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EACL,KAAK,+BAA+B,EACpC,kCAAkC,EACnC,MAAM,+BAA+B,CAAC;AAWvC,eAAO,MAAM,8BAA8B,qEAGzC,CAAC;AACH,eAAO,MAAM,oCAAoC;;;;kBAWtC,CAAC;AACZ,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAyB7B,CAAC;AACZ,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oCAAoC,CAAC,CAAC;AAClG,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,2BAA2B,CAAC,CAAC;IAClE,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,kCAAkC,CAAC,CAAC;IAC1E,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;IACvE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,SAAS,+BAA+B,EAAE,CAAC;CACtE;AAED,mGAAmG;AACnG,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,8BAA8B,EACzC,QAAQ,GAAE,SAAS,qBAAqB,EAAkC,GACzE,6BAA6B,CA0H/B;AAED,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAgChC,CAAC;AACL,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACzE,MAAM,MAAM,0BAA0B,GAAG,iBAAiB,GAAG;IAC3D,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;IAC9D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,SAAS,+BAA+B,EAAE,CAAC;CAC9D,CAAC;AAEF,qBAAa,6BAA8B,SAAQ,KAAK;gBAC1C,KAAK,EAAE,OAAO;CAI3B;AAED,0FAA0F;AAC1F,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,OAAO,EACf,QAAQ,GAAE,SAAS,qBAAqB,EAAkC,GACzE,0BAA0B,CAQ5B"}

package/build/domains/backend-preparation/integrationDefinitions.js

@@ -0,0 +1,246 @@
+import { createHash } from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+import { z } from 'zod';
+import { builtInIntegrationDefinitions } from './builtInIntegrationDefinitions.js';
+import { ConfiguredCommandIntegrationSchema, } from './configuredCommandAdapter.js';
+const identitySchema = z.string().regex(/^[a-z][a-z0-9-]{0,127}$/);
+const inputNameSchema = z.string().regex(/^[a-zA-Z][a-zA-Z0-9_]{0,127}$/);
+const reservedCommandMarkerPattern = /\{(?:checkout|operation|input:[^}]*)\}/;
+const inputValueSchema = z
+    .string()
+    .min(1)
+    .max(16384)
+    .refine((value) => !value.includes('\0'), 'Input cannot contain NUL')
+    .refine((value) => !reservedCommandMarkerPattern.test(value), 'Input contains a reserved command marker');
+export const AffectedPreparationToolsSchema = z.union([
+    z.literal('all'),
+    z.array(z.string().min(1).max(256)).min(1).max(4096),
+]);
+export const IntegrationDefinitionSelectionSchema = z
+    .object({
+    id: identitySchema,
+    file: z
+        .string()
+        .min(1)
+        .max(4096)
+        .refine(path.isAbsolute, 'Definition file must be an absolute local JSON path')
+        .optional(),
+    inputs: z.record(inputNameSchema, inputValueSchema).optional(),
+})
+    .strict();
+export const IntegrationDefinitionSchema = z
+    .object({
+    schemaVersion: z.literal(1),
+    id: identitySchema,
+    revision: z.string().min(1).max(256),
+    helperRevision: z.string().min(1).max(256),
+    helperFiles: z.array(z.string().min(1).max(4096)).min(1).max(8).optional(),
+    compatibility: z
+        .object({
+        backend: z.string().min(1).max(256),
+        versions: z.array(z.string().min(1).max(256)).min(1).max(256),
+        platforms: z
+            .array(z.enum(['linux', 'darwin', 'win32']))
+            .min(1)
+            .max(3),
+        readinessScope: z.string().min(1).max(4096),
+    })
+        .strict(),
+    inputs: z.record(inputNameSchema, z.object({ required: z.boolean().optional(), default: inputValueSchema.optional() }).strict()),
+    affectedTools: AffectedPreparationToolsSchema,
+    integration: ConfiguredCommandIntegrationSchema,
+})
+    .strict();
+/** Read-only resolution from runtime-owned inputs. Never reads caller or project configuration. */
+export function resolveIntegrationDefinition(selection, builtins = builtInIntegrationDefinitions) {
+    selection = IntegrationDefinitionSelectionSchema.parse(selection);
+    const registry = new Map();
+    for (const candidate of builtins) {
+        const definition = IntegrationDefinitionSchema.parse(candidate);
+        if (registry.has(definition.id))
+            throw new Error(`Ambiguous integration definition identity: ${definition.id}`);
+        registry.set(definition.id, definition);
+    }
+    let source;
+    let definition;
+    if (selection.file) {
+        if (path.extname(selection.file) !== '.json')
+            throw new Error('Definition file must be local JSON (.json)');
+        source = fs.realpathSync(selection.file);
+        const stat = fs.statSync(source);
+        if (!stat.isFile() || stat.size > 1024 * 1024)
+            throw new Error('Definition must be a JSON file no larger than 1 MiB');
+        definition = IntegrationDefinitionSchema.parse(JSON.parse(fs.readFileSync(source, 'utf8')));
+        if (registry.has(definition.id))
+            throw new Error(`Local definition conflicts with built-in identity: ${definition.id}`);
+    }
+    else {
+        const found = registry.get(selection.id);
+        if (!found)
+            throw new Error(`Unknown integration definition: ${selection.id}`);
+        definition = found;
+    }
+    if (definition.id !== selection.id)
+        throw new Error(`Definition identity does not match selected id: ${selection.id}`);
+    if (!definition.compatibility.platforms.some((platform) => platform === process.platform)) {
+        throw new Error(`Unsupported integration platform: ${process.platform}; supported: ${definition.compatibility.platforms.join(', ')}`);
+    }
+    const inputs = {};
+    for (const name of Object.keys(selection.inputs ?? {})) {
+        if (!Object.hasOwn(definition.inputs, name))
+            throw new Error(`Unknown integration input: ${name}`);
+    }
+    for (const [name, declaration] of Object.entries(definition.inputs)) {
+        const value = selection.inputs?.[name] ?? declaration.default;
+        if (value === undefined) {
+            if (declaration.required)
+                throw new Error(`Missing required integration input: ${name}`);
+            continue;
+        }
+        inputs[name] = value;
+    }
+    let helperBytes = 0;
+    const helpers = (definition.helperFiles ?? []).map((file) => {
+        if (reservedCommandMarkerPattern.test(file))
+            throw new Error('Declared helper reference contains a reserved command marker');
+        if (!path.isAbsolute(file) && !source)
+            throw new Error('Built-in helper file paths must be absolute');
+        const declaredPath = path.isAbsolute(file) ? path.normalize(file) : path.resolve(path.dirname(source), file);
+        const helper = fs.realpathSync(declaredPath);
+        if (reservedCommandMarkerPattern.test(helper))
+            throw new Error('Canonical helper path contains a reserved command marker');
+        const stat = fs.statSync(helper);
+        helperBytes += stat.size;
+        if (!stat.isFile() || helperBytes > 1024 * 1024)
+            throw new Error('Declared helpers must be local files totaling no more than 1 MiB');
+        return {
+            reference: file,
+            declaredPath,
+            path: helper,
+            digest: createHash('sha256').update(fs.readFileSync(helper)).digest('hex'),
+        };
+    });
+    const bindHelperReference = (value) => {
+        let candidate;
+        if (path.isAbsolute(value))
+            candidate = path.normalize(value);
+        else if (source)
+            candidate = path.resolve(path.dirname(source), value);
+        const helper = helpers.find((item) => item.reference === value || item.declaredPath === candidate || item.path === candidate);
+        if (helper)
+            return helper.path;
+        const literal = value.replace(/\{input:[^}]+\}/g, '');
+        for (const item of helpers) {
+            const aliases = [
+                item.reference,
+                path.normalize(item.reference),
+                item.declaredPath,
+                item.path,
+                path.basename(item.declaredPath),
+                path.basename(item.path),
+            ];
+            if (source)
+                aliases.push(path.relative(path.dirname(source), item.declaredPath), path.relative(path.dirname(source), item.path));
+            if (aliases.some((reference) => reference.length > 0 && literal.includes(reference))) {
+                throw new Error('Declared helper references must occupy a whole executable or argv argument; embedded references are unsupported');
+            }
+        }
+        return value;
+    };
+    const integration = structuredClone(definition.integration);
+    const commands = [integration.probe, integration.status, ...Object.values(integration.actions)];
+    for (const command of commands) {
+        if (!command)
+            continue;
+        if (command.executable.includes('{'))
+            throw new Error('Definition executable cannot contain placeholders');
+        command.executable = bindHelperReference(command.executable);
+        if (!path.isAbsolute(command.executable) && /[/\\]/.test(command.executable)) {
+            if (!source)
+                throw new Error('Built-in definition executable paths must be absolute');
+            command.executable = path.resolve(path.dirname(source), command.executable);
+        }
+        command.args = command.args.map((argument) => bindHelperReference(argument).replace(/\{input:([^}]+)\}/g, (_match, name) => {
+            if (!Object.hasOwn(inputs, name))
+                throw new Error(`Missing integration input for command: ${name}`);
+            return inputs[name];
+        }));
+    }
+    const validatedIntegration = ConfiguredCommandIntegrationSchema.parse(integration);
+    const revision = createHash('sha256')
+        .update(JSON.stringify({ definition, integration: validatedIntegration, inputs, source, helpers }))
+        .digest('hex');
+    return {
+        definition,
+        integration: validatedIntegration,
+        affectedTools: definition.affectedTools,
+        revision,
+        helperSnapshots: helpers.map(({ path, digest }) => ({ path, digest })),
+    };
+}
+export const PreparationConfigSchema = z
+    .object({
+    adapter: z.literal('configured-command'),
+    affectedTools: AffectedPreparationToolsSchema.optional(),
+    integration: ConfiguredCommandIntegrationSchema.optional(),
+    definition: IntegrationDefinitionSelectionSchema.optional(),
+    activation: z.literal('setup').optional(),
+    enabled: z.boolean().optional(),
+    allowedActions: z.array(z.enum(['initialize', 'sync', 'rebuild', 'install', 'paid'])).max(5),
+    executionDeadlineMs: z.number().int().min(1).max(86_400_000).optional(),
+    transientRetryLimit: z.number().int().min(0).max(3).optional(),
+})
+    .strict()
+    .superRefine((config, context) => {
+    if (config.definition && config.integration)
+        context.addIssue({
+            code: 'custom',
+            path: ['definition'],
+            message: 'Named definition and inline integration are mutually exclusive',
+        });
+    if (!config.definition && !config.affectedTools)
+        context.addIssue({
+            code: 'custom',
+            path: ['affectedTools'],
+            message: 'Inline preparation requires affectedTools',
+        });
+    if (config.activation && !config.definition)
+        context.addIssue({
+            code: 'custom',
+            path: ['activation'],
+            message: 'Setup activation requires an explicitly selected definition',
+        });
+});
+export class PreparationConfigurationError extends Error {
+    constructor(cause) {
+        super(cause instanceof Error ? cause.message : 'Preparation configuration is unavailable', { cause });
+        this.name = 'PreparationConfigurationError';
+    }
+}
+/** Validate setup/config changes without launching commands or applying configuration. */
+export function validatePreparationConfig(config, builtins = builtInIntegrationDefinitions) {
+    const parsed = PreparationConfigSchema.parse(config);
+    if (!parsed.definition)
+        return { ...parsed, affectedTools: parsed.affectedTools };
+    try {
+        return resolvePreparationConfig(parsed, builtins);
+    }
+    catch (error) {
+        throw new PreparationConfigurationError(error);
+    }
+}
+function resolvePreparationConfig(parsed, builtins) {
+    const resolved = resolveIntegrationDefinition(parsed.definition, builtins);
+    if (parsed.affectedTools && JSON.stringify(parsed.affectedTools) !== JSON.stringify(resolved.affectedTools)) {
+        throw new Error('Configured affectedTools conflicts with the selected definition');
+    }
+    return {
+        ...parsed,
+        integration: resolved.integration,
+        affectedTools: resolved.affectedTools,
+        effectiveRevision: resolved.revision,
+        helperSnapshots: resolved.helperSnapshots,
+    };
+}
+//# sourceMappingURL=integrationDefinitions.js.map

package/build/domains/backend-preparation/integrationDefinitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrationDefinitions.js","sourceRoot":"","sources":["../../../src/domains/backend-preparation/integrationDefinitions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAEL,kCAAkC,GACnC,MAAM,+BAA+B,CAAC;AAEvC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;AACnE,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;AAC1E,MAAM,4BAA4B,GAAG,wCAAwC,CAAC;AAC9E,MAAM,gBAAgB,GAAG,CAAC;KACvB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,KAAK,CAAC;KACV,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,0BAA0B,CAAC;KACpE,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,4BAA4B,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,0CAA0C,CAAC,CAAC;AAC5G,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC;IACpD,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IAChB,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;CACrD,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC;KAClD,MAAM,CAAC;IACN,EAAE,EAAE,cAAc;IAClB,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,IAAI,CAAC;SACT,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,qDAAqD,CAAC;SAC9E,QAAQ,EAAE;IACb,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,eAAe,EAAE,gBAAgB,CAAC,CAAC,QAAQ,EAAE;CAC/D,CAAC;KACD,MAAM,EAAE,CAAC;AACZ,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC;KACzC,MAAM,CAAC;IACN,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3B,EAAE,EAAE,cAAc;IAClB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACpC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAC1C,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC1E,aAAa,EAAE,CAAC;SACb,MAAM,CAAC;QACN,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;QACnC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;QAC7D,SAAS,EAAE,CAAC;aACT,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;aAC3C,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,CAAC,CAAC;QACT,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;KAC5C,CAAC;SACD,MAAM,EAAE;IACX,MAAM,EAAE,CAAC,CAAC,MAAM,CACd,eAAe,EACf,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,gBAAgB,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAC9F;IACD,aAAa,EAAE,8BAA8B;IAC7C,WAAW,EAAE,kCAAkC;CAChD,CAAC;KACD,MAAM,EAAE,CAAC;AAWZ,mGAAmG;AACnG,MAAM,UAAU,4BAA4B,CAC1C,SAAyC,EACzC,WAA6C,6BAA6B;IAE1E,SAAS,GAAG,oCAAoC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAwD,CAAC;IACjF,KAAK,MAAM,SAAS,IAAI,QAAQ,EAAE,CAAC;QACjC,MAAM,UAAU,GAAG,2BAA2B,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAChE,IAAI,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC;QAChH,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,MAA0B,CAAC;IAC/B,IAAI,UAAwD,CAAC;IAC7D,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC;QACnB,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAC5G,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,IAAI;YAC3C,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,UAAU,GAAG,2BAA2B,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;QAC5F,IAAI,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,sDAAsD,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC;IAC3F,CAAC;SAAM,CAAC;QACN,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/E,UAAU,GAAG,KAAK,CAAC;IACrB,CAAC;IACD,IAAI,UAAU,CAAC,EAAE,KAAK,SAAS,CAAC,EAAE;QAChC,MAAM,IAAI,KAAK,CAAC,mDAAmD,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;IACrF,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,KAAK,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1F,MAAM,IAAI,KAAK,CACb,qCAAqC,OAAO,CAAC,QAAQ,gBAAgB,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACrH,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;QACvD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,EAAE,CAAC,CAAC;IACrG,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACpE,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,OAAO,CAAC;QAC9D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,WAAW,CAAC,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,IAAI,EAAE,CAAC,CAAC;YACzF,SAAS;QACX,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IACvB,CAAC;IACD,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,MAAM,OAAO,GAAG,CAAC,UAAU,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAC1D,IAAI,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;QAClF,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACtG,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAO,CAAC,EAAE,IAAI,CAAC,CAAC;QAC9G,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;QAC7C,IAAI,4BAA4B,CAAC,IAAI,CAAC,MAAM,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;QAC9E,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACjC,WAAW,IAAI,IAAI,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,WAAW,GAAG,IAAI,GAAG,IAAI;YAC7C,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;QACtF,OAAO;YACL,SAAS,EAAE,IAAI;YACf,YAAY;YACZ,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC3E,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,MAAM,mBAAmB,GAAG,CAAC,KAAa,EAAU,EAAE;QACpD,IAAI,SAA6B,CAAC;QAClC,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;YAAE,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;aACzD,IAAI,MAAM;YAAE,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC;QACvE,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CACzB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,KAAK,KAAK,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,CACjG,CAAC;QACF,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC,IAAI,CAAC;QAC/B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;QACtD,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,MAAM,OAAO,GAAG;gBACd,IAAI,CAAC,SAAS;gBACd,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC;gBAC9B,IAAI,CAAC,YAAY;gBACjB,IAAI,CAAC,IAAI;gBACT,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC;gBAChC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;aACzB,CAAC;YACF,IAAI,MAAM;gBACR,OAAO,CAAC,IAAI,CACV,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC,EACtD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAC/C,CAAC;YACJ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;gBACrF,MAAM,IAAI,KAAK,CACb,iHAAiH,CAClH,CAAC;YACJ,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IACF,MAAM,WAAW,GAAG,eAAe,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IAC5D,MAAM,QAAQ,GAAG,CAAC,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;IAChG,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,IAAI,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QAC3G,OAAO,CAAC,UAAU,GAAG,mBAAmB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YAC7E,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;YACtF,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;QAC9E,CAAC;QACD,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAC3C,mBAAmB,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,IAAY,EAAE,EAAE;YACnF,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,IAAI,EAAE,CAAC,CAAC;YACpG,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IACD,MAAM,oBAAoB,GAAG,kCAAkC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACnF,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC;SAClC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;SAClG,MAAM,CAAC,KAAK,CAAC,CAAC;IACjB,OAAO;QACL,UAAU;QACV,WAAW,EAAE,oBAAoB;QACjC,aAAa,EAAE,UAAU,CAAC,aAAa;QACvC,QAAQ;QACR,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;KACvE,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC;IACxC,aAAa,EAAE,8BAA8B,CAAC,QAAQ,EAAE;IACxD,WAAW,EAAE,kCAAkC,CAAC,QAAQ,EAAE;IAC1D,UAAU,EAAE,oCAAoC,CAAC,QAAQ,EAAE;IAC3D,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE;IACzC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC/B,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5F,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE;IACvE,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC/D,CAAC;KACD,MAAM,EAAE;KACR,WAAW,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE;IAC/B,IAAI,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,WAAW;QACzC,OAAO,CAAC,QAAQ,CAAC;YACf,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,YAAY,CAAC;YACpB,OAAO,EAAE,gEAAgE;SAC1E,CAAC,CAAC;IACL,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,aAAa;QAC7C,OAAO,CAAC,QAAQ,CAAC;YACf,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,eAAe,CAAC;YACvB,OAAO,EAAE,2CAA2C;SACrD,CAAC,CAAC;IACL,IAAI,MAAM,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,UAAU;QACzC,OAAO,CAAC,QAAQ,CAAC;YACf,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,YAAY,CAAC;YACpB,OAAO,EAAE,6DAA6D;SACvE,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAQL,MAAM,OAAO,6BAA8B,SAAQ,KAAK;IACtD,YAAY,KAAc;QACxB,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,0CAA0C,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACtG,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;IAC9C,CAAC;CACF;AAED,0FAA0F;AAC1F,MAAM,UAAU,yBAAyB,CACvC,MAAe,EACf,WAA6C,6BAA6B;IAE1E,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACrD,IAAI,CAAC,MAAM,CAAC,UAAU;QAAE,OAAO,EAAE,GAAG,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,aAAc,EAAE,CAAC;IACnF,IAAI,CAAC;QACH,OAAO,wBAAwB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,6BAA6B,CAAC,KAAK,CAAC,CAAC;IACjD,CAAC;AACH,CAAC;AAED,SAAS,wBAAwB,CAC/B,MAAyB,EACzB,QAA0C;IAE1C,MAAM,QAAQ,GAAG,4BAA4B,CAAC,MAAM,CAAC,UAAW,EAAE,QAAQ,CAAC,CAAC;IAC5E,IAAI,MAAM,CAAC,aAAa,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QAC5G,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IACrF,CAAC;IACD,OAAO;QACL,GAAG,MAAM;QACT,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,aAAa,EAAE,QAAQ,CAAC,aAAa;QACrC,iBAAiB,EAAE,QAAQ,CAAC,QAAQ;QACpC,eAAe,EAAE,QAAQ,CAAC,eAAe;KAC1C,CAAC;AACJ,CAAC"}

package/build/domains/backend-preparation/policy.d.ts

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+import type { BackendPolicy, PreparationOptions, PreparationTarget } from './contracts.js';
+export declare const PreparationOptionsSchema: z.ZodObject<{
+    concurrency: z.ZodDefault<z.ZodNumber>;
+    queueCapacity: z.ZodDefault<z.ZodNumber>;
+    requestWaitMs: z.ZodDefault<z.ZodNumber>;
+    executionDeadlineMs: z.ZodDefault<z.ZodNumber>;
+    maxRecords: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const BackendPolicySchema: z.ZodObject<{
+    allowedActions: z.ZodArray<z.ZodEnum<{
+        initialize: "initialize";
+        sync: "sync";
+        rebuild: "rebuild";
+        install: "install";
+        paid: "paid";
+    }>>;
+    executionDeadlineMs: z.ZodOptional<z.ZodNumber>;
+    transientRetryLimit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const PreparationTargetSchema: z.ZodObject<{
+    checkoutRoot: z.ZodString;
+    backendName: z.ZodString;
+    backendIdentity: z.ZodString;
+    configurationKey: z.ZodString;
+}, z.core.$strict>;
+export declare function preparationKey(target: PreparationTarget, policy: BackendPolicy, options: PreparationOptions, operation?: string): string;
+export declare const PreparationFailureSchema: z.ZodObject<{
+    code: z.ZodString;
+    message: z.ZodString;
+    retryable: z.ZodBoolean;
+    instructions: z.ZodString;
+}, z.core.$strict>;
+export declare const BackendReadyReadinessSchema: z.ZodObject<{
+    state: z.ZodLiteral<"ready">;
+    evidence: z.ZodObject<{
+        freshness: z.ZodEnum<{
+            unknown: "unknown";
+            current: "current";
+            stale: "stale";
+        }>;
+        coverage: z.ZodEnum<{
+            unknown: "unknown";
+            complete: "complete";
+            partial: "partial";
+        }>;
+        detail: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+//# sourceMappingURL=policy.d.ts.map

package/build/domains/backend-preparation/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../../src/domains/backend-preparation/policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAE3F,eAAO,MAAM,wBAAwB;;;;;;kBAQ1B,CAAC;AAEZ,eAAO,MAAM,mBAAmB;;;;;;;;;;kBAMrB,CAAC;AAEZ,eAAO,MAAM,uBAAuB;;;;;kBAOzB,CAAC;AAEZ,wBAAgB,cAAc,CAC5B,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,kBAAkB,EAC3B,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAWR;AAED,eAAO,MAAM,wBAAwB;;;;;kBAO1B,CAAC;AAEZ,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;kBAW7B,CAAC"}