@1mcp/agent 0.39.8 → 0.40.0-beta.1

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":"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"}

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"}

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

@@ -0,0 +1,58 @@
+import { z } from 'zod';
+export const PreparationOptionsSchema = z
+    .object({
+    concurrency: z.number().int().min(1).max(64).default(1),
+    queueCapacity: z.number().int().min(0).max(4096).default(16),
+    requestWaitMs: z.number().int().min(0).max(3_600_000).default(5_000),
+    executionDeadlineMs: z.number().int().min(1).max(86_400_000).default(120_000),
+    maxRecords: z.number().int().min(1).max(100_000).default(1024),
+})
+    .strict();
+export const BackendPolicySchema = z
+    .object({
+    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();
+export const PreparationTargetSchema = z
+    .object({
+    checkoutRoot: z.string().min(1),
+    backendName: z.string().min(1),
+    backendIdentity: z.string().min(1),
+    configurationKey: z.string().min(1),
+})
+    .strict();
+export function preparationKey(target, policy, options, operation) {
+    return JSON.stringify([
+        target.checkoutRoot,
+        target.backendName,
+        target.backendIdentity,
+        target.configurationKey,
+        operation,
+        [...new Set(policy.allowedActions)].sort(),
+        policy.executionDeadlineMs ?? options.executionDeadlineMs,
+        policy.transientRetryLimit ?? 0,
+    ]);
+}
+export const PreparationFailureSchema = z
+    .object({
+    code: z.string().min(1).max(256),
+    message: z.string().max(4096),
+    retryable: z.boolean(),
+    instructions: z.string().min(1).max(4096),
+})
+    .strict();
+export const BackendReadyReadinessSchema = z
+    .object({
+    state: z.literal('ready'),
+    evidence: z
+        .object({
+        freshness: z.enum(['current', 'stale', 'unknown']),
+        coverage: z.enum(['complete', 'partial', 'unknown']),
+        detail: z.string().max(4096),
+    })
+        .strict(),
+})
+    .strict();
+//# sourceMappingURL=policy.js.map

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

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

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

@@ -0,0 +1,18 @@
+/** Runtime-global expensive-work bound. Running cancellation retains its slot until work settles. */
+export declare class PreparationScheduler {
+    private readonly concurrency;
+    private readonly queueCapacity;
+    private active;
+    private readonly activeResources;
+    private readonly queue;
+    constructor(concurrency: number, queueCapacity: number);
+    schedule(id: string, run: (wasQueued: boolean) => Promise<void>, resourceKey?: string, beforeAdmission?: () => void): boolean;
+    cancelQueued(id: string): boolean;
+    counts(): {
+        active: number;
+        queued: number;
+    };
+    private start;
+    private drain;
+}
+//# sourceMappingURL=scheduler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../../src/domains/backend-preparation/scheduler.ts"],"names":[],"mappings":"AASA,qGAAqG;AACrG,qBAAa,oBAAoB;IAM7B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,aAAa;IANhC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IACrD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;gBAG1B,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM;IAKxC,QAAQ,CACN,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,EAC1C,WAAW,SAAK,EAChB,eAAe,CAAC,EAAE,MAAM,IAAI,GAC3B,OAAO;IAcV,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAOjC,MAAM,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAI5C,OAAO,CAAC,KAAK;IAeb,OAAO,CAAC,KAAK;CAQd"}

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

@@ -0,0 +1,62 @@
+import { PreparationOptionsSchema } from './policy.js';
+/** Runtime-global expensive-work bound. Running cancellation retains its slot until work settles. */
+export class PreparationScheduler {
+    concurrency;
+    queueCapacity;
+    active = 0;
+    activeResources = new Set();
+    queue = [];
+    constructor(concurrency, queueCapacity) {
+        this.concurrency = concurrency;
+        this.queueCapacity = queueCapacity;
+        PreparationOptionsSchema.parse({ concurrency, queueCapacity });
+    }
+    schedule(id, run, resourceKey = id, beforeAdmission) {
+        if (this.active < this.concurrency) {
+            if (!this.activeResources.has(resourceKey)) {
+                beforeAdmission?.();
+                this.start({ id, run, resourceKey, wasQueued: false });
+                return true;
+            }
+        }
+        if (this.queue.length >= this.queueCapacity)
+            return false;
+        beforeAdmission?.();
+        this.queue.push({ id, run, resourceKey, wasQueued: true });
+        return true;
+    }
+    cancelQueued(id) {
+        const index = this.queue.findIndex((work) => work.id === id);
+        if (index < 0)
+            return false;
+        this.queue.splice(index, 1);
+        return true;
+    }
+    counts() {
+        return { active: this.active, queued: this.queue.length };
+    }
+    start(work) {
+        this.active++;
+        this.activeResources.add(work.resourceKey);
+        void Promise.resolve()
+            .then(() => work.run(work.wasQueued))
+            .finally(() => {
+            this.active--;
+            this.activeResources.delete(work.resourceKey);
+            this.drain();
+        })
+            .catch(() => {
+            /* A failing work item must still release its slot. */
+        });
+    }
+    drain() {
+        while (this.active < this.concurrency) {
+            const index = this.queue.findIndex((work) => !this.activeResources.has(work.resourceKey));
+            if (index < 0)
+                return;
+            const [next] = this.queue.splice(index, 1);
+            this.start(next);
+        }
+    }
+}
+//# sourceMappingURL=scheduler.js.map

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

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

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

@@ -0,0 +1,67 @@
+import { PreparationAdapterRegistry } from './adapterRegistry.js';
+import type { BackendPolicy, BackendReadiness, PreparationAction, PreparationAdmission, PreparationFailure, PreparationOptions, PreparationProgress, PreparationRecoveryHint, PreparationRequestOptions, PreparationResult, PreparationStatus, PreparationTarget, ProjectPreparationPreferences } from './contracts.js';
+import { PreparationScheduler } from './scheduler.js';
+export declare class BackendPreparationService {
+    private readonly registry;
+    readonly options: PreparationOptions;
+    readonly scheduler: PreparationScheduler;
+    private readonly jobs;
+    private readonly identities;
+    private sequence;
+    private shuttingDown;
+    constructor(registry: PreparationAdapterRegistry, options?: Partial<PreparationOptions>);
+    inspect(target: PreparationTarget, operation: string, options?: {
+        readonly waitMs?: number;
+        readonly signal?: AbortSignal;
+    }): Promise<BackendReadiness>;
+    /** Explicit status inspection is read-only and never admits, retries, or changes a job. */
+    inspectProgress(target: PreparationTarget, operation: string, options?: {
+        readonly waitMs?: number;
+        readonly signal?: AbortSignal;
+    }): Promise<PreparationProgress | undefined>;
+    /** Recovery only reconciles native evidence. A persisted running flag never starts or kills work. */
+    recover(target: PreparationTarget, operation: string, advisory: PreparationRecoveryHint, options?: {
+        readonly waitMs?: number;
+        readonly signal?: AbortSignal;
+    }): Promise<BackendReadiness>;
+    prepare(target: PreparationTarget, operation: string, policy: BackendPolicy, action?: PreparationAction, options?: PreparationRequestOptions): Promise<PreparationResult>;
+    private prepareInspected;
+    /** Never receives an operation callback, so pending calls cannot be queued or replayed. */
+    admit(target: PreparationTarget, operation: string, policy: BackendPolicy, preferences: ProjectPreparationPreferences, options?: PreparationRequestOptions): Promise<PreparationAdmission>;
+    private pending;
+    /** All admitted jobs, including automatic jobs with no public control handle. */
+    activeStatuses(): PreparationStatus[];
+    status(id: string): PreparationStatus | undefined;
+    wait(id: string, options?: {
+        readonly waitMs?: number;
+        readonly signal?: AbortSignal;
+    }): Promise<PreparationStatus | undefined>;
+    cancel(id: string): PreparationStatus | undefined;
+    /** Explicit retry creates a new compatible identity when the execution budget changes. */
+    retry(id: string, policy?: BackendPolicy, options?: PreparationRequestOptions): Promise<PreparationResult>;
+    /** Stop admission and wait for actual owned work settlement, including expired jobs. */
+    shutdown(): Promise<void>;
+    /** Only restores a validated stable failure; it confers no process ownership or repair authority. */
+    importFailure(target: PreparationTarget, operation: string, policy: BackendPolicy, action: PreparationAction, failure: PreparationFailure, state?: 'failed' | 'not_ready'): PreparationStatus | undefined;
+    /** Caller supplies fresh native evidence; advisory state alone cannot resolve a failure. */
+    clearResolvedFailure(target: PreparationTarget, operation: string, policy: BackendPolicy, readiness: Extract<BackendReadiness, {
+        state: 'ready';
+    }>): number;
+    private removeRecord;
+    private shutdownResult;
+    private execute;
+    private reconcileQueuedReadiness;
+    private moveActionIdentity;
+    private runAttempts;
+    private releaseCompletedRecords;
+    private failedJob;
+    private activeJob;
+    private probe;
+    private readReadiness;
+    private findJob;
+    private snapshot;
+    private update;
+    private terminal;
+    private unsupported;
+}
+//# sourceMappingURL=service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/domains/backend-preparation/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,KAAK,EACV,aAAa,EAEb,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,yBAAyB,EACzB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,6BAA6B,EAC9B,MAAM,gBAAgB,CAAC;AASxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAiBtD,qBAAa,yBAAyB;IASlC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAR3B,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;IACzC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqC;IAC1D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IACxD,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,YAAY,CAAS;gBAGV,QAAQ,EAAE,0BAA0B,EACrD,OAAO,GAAE,OAAO,CAAC,kBAAkB,CAAM;IAMrC,OAAO,CACX,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GACxE,OAAO,CAAC,gBAAgB,CAAC;IAQ5B,2FAA2F;IACrF,eAAe,CACnB,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GACxE,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC;IA8B3C,qGAAqG;IAC/F,OAAO,CACX,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,uBAAuB,EACjC,OAAO,GAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GACxE,OAAO,CAAC,gBAAgB,CAAC;IAmBtB,OAAO,CACX,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,aAAa,EACrB,MAAM,CAAC,EAAE,iBAAiB,EAC1B,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,iBAAiB,CAAC;YAuBf,gBAAgB;IAkH9B,2FAA2F;IACrF,KAAK,CACT,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,aAAa,EACrB,WAAW,EAAE,6BAA6B,EAC1C,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,oBAAoB,CAAC;IAkDhC,OAAO,CAAC,OAAO;IAUf,iFAAiF;IACjF,cAAc,IAAI,iBAAiB,EAAE;IAMrC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAK3C,IAAI,CACR,EAAE,EAAE,MAAM,EACV,OAAO,GAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GACxE,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAwBzC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAcjD,0FAA0F;IACpF,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,EAAE,OAAO,GAAE,yBAA8B,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA+DpH,wFAAwF;IAClF,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAW/B,qGAAqG;IACrG,aAAa,CACX,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,kBAAkB,EAC3B,KAAK,GAAE,QAAQ,GAAG,WAAsB,GACvC,iBAAiB,GAAG,SAAS;IA0ChC,4FAA4F;IAC5F,oBAAoB,CAClB,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,OAAO,CAAC,gBAAgB,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,GACvD,MAAM;IAmBT,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,cAAc;YAIR,OAAO;YAsEP,wBAAwB;IA+CtC,OAAO,CAAC,kBAAkB;YAcZ,WAAW;IAoBzB,OAAO,CAAC,uBAAuB;IAc/B,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,SAAS;YAmBH,KAAK;YAeL,aAAa;IAwD3B,OAAO,CAAC,OAAO;IAKf,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,MAAM;IAMd,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,WAAW;CAMpB"}