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

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

@@ -0,0 +1,88 @@
+import { z } from 'zod';
+import type { BackendPreparationAdapter, BackendReadiness, PreparationAction, PreparationFailure, PreparationProgress, PreparationRecoveryHint, PreparationTarget } from './contracts.js';
+export declare const ConfiguredCommandIntegrationSchema: 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>;
+export type ConfiguredCommandIntegration = z.input<typeof ConfiguredCommandIntegrationSchema>;
+export declare const PreparationProgressSchema: z.ZodObject<{
+    message: z.ZodOptional<z.ZodString>;
+    completed: z.ZodOptional<z.ZodNumber>;
+    total: z.ZodOptional<z.ZodNumber>;
+    unit: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export interface ConfiguredCommandHelperSnapshot {
+    readonly path: string;
+    readonly digest: string;
+}
+export declare class ConfiguredCommandPreparationAdapter implements BackendPreparationAdapter {
+    private readonly integration;
+    private readonly helpers;
+    constructor(integration: ConfiguredCommandIntegration, helpers?: readonly ConfiguredCommandHelperSnapshot[]);
+    private assertHelpersCurrent;
+    private runCommand;
+    inspect(target: PreparationTarget, operation: string, options?: {
+        signal?: AbortSignal;
+        waitMs?: number;
+    }): Promise<BackendReadiness>;
+    prepare(target: PreparationTarget, action: PreparationAction, options: {
+        signal: AbortSignal;
+        executionDeadlineMs: number;
+        operation?: string;
+    }): Promise<void>;
+    progress(target: PreparationTarget, operation: string, options?: {
+        signal?: AbortSignal;
+        waitMs?: number;
+    }): Promise<PreparationProgress | undefined>;
+    reconcile(target: PreparationTarget, operation: string, _advisory: PreparationRecoveryHint, options?: {
+        signal?: AbortSignal;
+        waitMs?: number;
+    }): Promise<BackendReadiness>;
+    classifyFailure(error: unknown): PreparationFailure;
+}
+//# sourceMappingURL=configuredCommandAdapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"configuredCommandAdapter.d.ts","sourceRoot":"","sources":["../../../src/domains/backend-preparation/configuredCommandAdapter.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EACV,yBAAyB,EACzB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AAmBxB,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAuBpC,CAAC;AACZ,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE9F,eAAO,MAAM,yBAAyB;;;;;kBAYnC,CAAC;AAEJ,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,mCAAoC,YAAW,yBAAyB;IACnF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsD;IAClF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6C;gBACzD,WAAW,EAAE,4BAA4B,EAAE,OAAO,GAAE,SAAS,+BAA+B,EAAO;IAK/G,OAAO,CAAC,oBAAoB;YA0Bd,UAAU;IASlB,OAAO,CACX,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GACtD,OAAO,CAAC,gBAAgB,CAAC;IAmDtB,OAAO,CACX,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE;QAAE,MAAM,EAAE,WAAW,CAAC;QAAC,mBAAmB,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAChF,OAAO,CAAC,IAAI,CAAC;IAkBV,QAAQ,CACZ,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GACtD,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC;IAqBrC,SAAS,CACb,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,uBAAuB,EAClC,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GACtD,OAAO,CAAC,gBAAgB,CAAC;IAK5B,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB;CAUpD"}

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

@@ -0,0 +1,196 @@
+import { createHash } from 'node:crypto';
+import fs from 'node:fs';
+import { z } from 'zod';
+import { ConfiguredCommandError, runConfiguredCommand } from './configuredCommandProcess.js';
+const actionSchema = z.enum(['initialize', 'sync', 'rebuild', 'install', 'paid']);
+const commandSchema = z
+    .object({ executable: z.string().min(1).max(4096), args: z.array(z.string().max(16384)).max(256) })
+    .strict();
+const mappingSchema = z.discriminatedUnion('state', [
+    z.object({ state: z.literal('ready') }).strict(),
+    z.object({ state: z.literal('required'), action: actionSchema, instructions: z.string().min(1).max(4096) }).strict(),
+    z.object({ state: z.literal('conflict'), instructions: z.string().min(1).max(4096) }).strict(),
+    z.object({ state: z.literal('unsupported'), instructions: z.string().min(1).max(4096) }).strict(),
+    z
+        .object({
+        state: z.literal('unknown'),
+        reason: z.literal('probe_failed'),
+        instructions: z.string().min(1).max(4096),
+    })
+        .strict(),
+]);
+export const ConfiguredCommandIntegrationSchema = z
+    .object({
+    containment: z.literal('posix-process-group'),
+    probe: commandSchema,
+    status: commandSchema.optional(),
+    readinessExitCodes: z.record(z.string().regex(/^(?:0|[1-9]\d?|1\d{2}|2[0-4]\d|25[0-5])$/), mappingSchema),
+    actions: z.partialRecord(actionSchema, commandSchema
+        .extend({
+        successExitCodes: z.array(z.number().int().min(0).max(255)).min(1).default([0]),
+        transientExitCodes: z.array(z.number().int().min(0).max(255)).default([]),
+    })
+        .strict()
+        .refine((command) => !command.transientExitCodes.some((code) => command.successExitCodes.includes(code)), 'Success and transient exit codes cannot overlap')),
+    inspectionTimeoutMs: z.number().int().min(1).max(60000).default(5000),
+    outputLimitBytes: z.number().int().min(256).max(65536).default(16384),
+    terminationGraceMs: z.number().int().min(1).max(5000).default(500),
+})
+    .strict();
+export const PreparationProgressSchema = z
+    .object({
+    message: z.string().max(4096).optional(),
+    completed: z.number().finite().nonnegative().optional(),
+    total: z.number().finite().positive().optional(),
+    unit: z.string().max(128).optional(),
+})
+    .strict()
+    .refine((progress) => progress.completed === undefined || progress.total === undefined || progress.completed <= progress.total, 'Completed progress exceeds total');
+export class ConfiguredCommandPreparationAdapter {
+    integration;
+    helpers;
+    constructor(integration, helpers = []) {
+        this.integration = ConfiguredCommandIntegrationSchema.parse(integration);
+        this.helpers = helpers.map((helper) => ({ ...helper }));
+    }
+    assertHelpersCurrent() {
+        let remaining = 1024 * 1024;
+        try {
+            for (const helper of this.helpers) {
+                const fd = fs.openSync(helper.path, 'r');
+                try {
+                    const stat = fs.fstatSync(fd);
+                    if (!stat.isFile() || stat.size > remaining)
+                        throw new Error('Helper size changed');
+                    const buffer = Buffer.alloc(stat.size + 1);
+                    const bytes = fs.readSync(fd, buffer, 0, buffer.length, 0);
+                    if (bytes !== stat.size)
+                        throw new Error('Helper size changed during verification');
+                    remaining -= bytes;
+                    const digest = createHash('sha256').update(buffer.subarray(0, bytes)).digest('hex');
+                    if (digest !== helper.digest)
+                        throw new Error('Helper content changed');
+                }
+                finally {
+                    fs.closeSync(fd);
+                }
+            }
+        }
+        catch {
+            throw new ConfiguredCommandError('helper_revision_changed', 'Declared helper content changed or is unavailable; resolve the current definition before explicit retry.');
+        }
+    }
+    async runCommand(command, options) {
+        this.assertHelpersCurrent();
+        try {
+            return await runConfiguredCommand(command, { ...options, beforeLaunch: () => this.assertHelpersCurrent() });
+        }
+        finally {
+            // No command result, including a completion probe, can establish evidence under changed helper bytes.
+            this.assertHelpersCurrent();
+        }
+    }
+    async inspect(target, operation, options = {}) {
+        if (options.waitMs === 0)
+            return {
+                state: 'unknown',
+                reason: 'inspection_timeout',
+                instructions: 'No inspection budget remains; no command was launched.',
+            };
+        try {
+            const result = await this.runCommand(this.integration.probe, {
+                checkoutRoot: target.checkoutRoot,
+                operation,
+                signal: options.signal,
+                deadlineMs: Math.min(options.waitMs ?? this.integration.inspectionTimeoutMs, this.integration.inspectionTimeoutMs),
+                outputLimitBytes: this.integration.outputLimitBytes,
+                terminationGraceMs: this.integration.terminationGraceMs,
+            });
+            const mapping = this.integration.readinessExitCodes[String(result.code)];
+            if (!mapping)
+                return {
+                    state: 'unknown',
+                    reason: 'unmapped_exit',
+                    instructions: `Unmapped readiness exit ${result.code}; configure an explicit readiness mapping.`,
+                };
+            if (mapping.state === 'conflict')
+                return mapping;
+            if (mapping.state === 'unsupported')
+                return mapping;
+            if (mapping.state === 'unknown')
+                return mapping;
+            const evidence = {
+                freshness: 'unknown',
+                coverage: 'unknown',
+                detail: (result.output.trim() || result.diagnostic.trim() || `Configured probe exited ${result.code}.`).slice(0, 4096),
+            };
+            return { ...mapping, evidence };
+        }
+        catch (error) {
+            const failure = this.classifyFailure(error);
+            if (failure.code === 'unsupported_containment')
+                return { state: 'unsupported', instructions: failure.message };
+            let reason = 'probe_failed';
+            if (options.signal?.aborted)
+                reason = 'caller_disconnected';
+            else if (failure.code === 'execution_deadline')
+                reason = 'inspection_timeout';
+            return {
+                state: 'unknown',
+                reason,
+                instructions: `Read-only probe could not establish readiness: ${failure.message}`,
+            };
+        }
+    }
+    async prepare(target, action, options) {
+        const command = this.integration.actions[action];
+        if (!command)
+            throw new ConfiguredCommandError('unsupported_action', `No configured command supports ${action}.`);
+        const result = await this.runCommand(command, {
+            checkoutRoot: target.checkoutRoot,
+            operation: options.operation ?? '',
+            signal: options.signal,
+            deadlineMs: options.executionDeadlineMs,
+            outputLimitBytes: this.integration.outputLimitBytes,
+            terminationGraceMs: this.integration.terminationGraceMs,
+        });
+        if (!command.successExitCodes.includes(result.code))
+            throw new ConfiguredCommandError('command_exit', `Configured ${action} exited ${result.code}: ${result.diagnostic || result.output}`, command.transientExitCodes.includes(result.code));
+    }
+    async progress(target, operation, options = {}) {
+        if (!this.integration.status || options.waitMs === 0)
+            return undefined;
+        try {
+            const result = await this.runCommand(this.integration.status, {
+                checkoutRoot: target.checkoutRoot,
+                operation,
+                signal: options.signal,
+                deadlineMs: Math.min(options.waitMs ?? this.integration.inspectionTimeoutMs, this.integration.inspectionTimeoutMs),
+                outputLimitBytes: this.integration.outputLimitBytes,
+                terminationGraceMs: this.integration.terminationGraceMs,
+            });
+            if (result.code !== 0)
+                return undefined;
+            const progress = PreparationProgressSchema.safeParse(JSON.parse(result.output));
+            return progress.success ? progress.data : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async reconcile(target, operation, _advisory, options = {}) {
+        // Saved flags never authorize process control. The read-only native probe owns
+        // writer coordination and must still report conflict until externally reconciled.
+        return this.inspect(target, operation, options);
+    }
+    classifyFailure(error) {
+        const code = error instanceof ConfiguredCommandError ? error.code : 'command_failed';
+        return {
+            code,
+            message: error instanceof Error ? error.message : String(error),
+            retryable: error instanceof ConfiguredCommandError && error.retryable,
+            instructions: 'Inspect the configured command and native writer ownership before explicit retry. Deadline exhaustion requires a larger explicit execution budget.',
+        };
+    }
+}
+//# sourceMappingURL=configuredCommandAdapter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"configuredCommandAdapter.js","sourceRoot":"","sources":["../../../src/domains/backend-preparation/configuredCommandAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAA0B,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAWrH,MAAM,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;AAClF,MAAM,aAAa,GAAG,CAAC;KACpB,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;KAClG,MAAM,EAAE,CAAC;AACZ,MAAM,aAAa,GAAG,CAAC,CAAC,kBAAkB,CAAC,OAAO,EAAE;IAClD,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;IAChD,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;IACpH,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;IAC9F,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;IACjG,CAAC;SACE,MAAM,CAAC;QACN,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;QAC3B,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC;QACjC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;KAC1C,CAAC;SACD,MAAM,EAAE;CACZ,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC;KAChD,MAAM,CAAC;IACN,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC;IAC7C,KAAK,EAAE,aAAa;IACpB,MAAM,EAAE,aAAa,CAAC,QAAQ,EAAE;IAChC,kBAAkB,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,0CAA0C,CAAC,EAAE,aAAa,CAAC;IACzG,OAAO,EAAE,CAAC,CAAC,aAAa,CACtB,YAAY,EACZ,aAAa;SACV,MAAM,CAAC;QACN,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/E,kBAAkB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;KAC1E,CAAC;SACD,MAAM,EAAE;SACR,MAAM,CACL,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAChG,iDAAiD,CAClD,CACJ;IACD,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IACrE,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACrE,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;CACnE,CAAC;KACD,MAAM,EAAE,CAAC;AAGZ,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC;KACvC,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;IACxC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACvD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAChD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;CACrC,CAAC;KACD,MAAM,EAAE;KACR,MAAM,CACL,CAAC,QAAQ,EAAE,EAAE,CACX,QAAQ,CAAC,SAAS,KAAK,SAAS,IAAI,QAAQ,CAAC,KAAK,KAAK,SAAS,IAAI,QAAQ,CAAC,SAAS,IAAI,QAAQ,CAAC,KAAK,EAC1G,kCAAkC,CACnC,CAAC;AAOJ,MAAM,OAAO,mCAAmC;IAC7B,WAAW,CAAsD;IACjE,OAAO,CAA6C;IACrE,YAAY,WAAyC,EAAE,UAAsD,EAAE;QAC7G,IAAI,CAAC,WAAW,GAAG,kCAAkC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACzE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC;IAC1D,CAAC;IAEO,oBAAoB;QAC1B,IAAI,SAAS,GAAG,IAAI,GAAG,IAAI,CAAC;QAC5B,IAAI,CAAC;YACH,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBAClC,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBACzC,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;oBAC9B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,IAAI,GAAG,SAAS;wBAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;oBACpF,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;oBAC3C,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;oBAC3D,IAAI,KAAK,KAAK,IAAI,CAAC,IAAI;wBAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;oBACpF,SAAS,IAAI,KAAK,CAAC;oBACnB,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;oBACpF,IAAI,MAAM,KAAK,MAAM,CAAC,MAAM;wBAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;gBAC1E,CAAC;wBAAS,CAAC;oBACT,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;gBACnB,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,sBAAsB,CAC9B,yBAAyB,EACzB,0GAA0G,CAC3G,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,OAA0B,EAAE,OAAmD;QACtG,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,OAAO,MAAM,oBAAoB,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;QAC9G,CAAC;gBAAS,CAAC;YACT,sGAAsG;YACtG,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC9B,CAAC;IACH,CAAC;IACD,KAAK,CAAC,OAAO,CACX,MAAyB,EACzB,SAAiB,EACjB,UAAqD,EAAE;QAEvD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YACtB,OAAO;gBACL,KAAK,EAAE,SAAS;gBAChB,MAAM,EAAE,oBAAoB;gBAC5B,YAAY,EAAE,wDAAwD;aACvE,CAAC;QACJ,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE;gBAC3D,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,SAAS;gBACT,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,UAAU,EAAE,IAAI,CAAC,GAAG,CAClB,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,WAAW,CAAC,mBAAmB,EACtD,IAAI,CAAC,WAAW,CAAC,mBAAmB,CACrC;gBACD,gBAAgB,EAAE,IAAI,CAAC,WAAW,CAAC,gBAAgB;gBACnD,kBAAkB,EAAE,IAAI,CAAC,WAAW,CAAC,kBAAkB;aACxD,CAAC,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YACzE,IAAI,CAAC,OAAO;gBACV,OAAO;oBACL,KAAK,EAAE,SAAS;oBAChB,MAAM,EAAE,eAAe;oBACvB,YAAY,EAAE,2BAA2B,MAAM,CAAC,IAAI,4CAA4C;iBACjG,CAAC;YACJ,IAAI,OAAO,CAAC,KAAK,KAAK,UAAU;gBAAE,OAAO,OAAO,CAAC;YACjD,IAAI,OAAO,CAAC,KAAK,KAAK,aAAa;gBAAE,OAAO,OAAO,CAAC;YACpD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;gBAAE,OAAO,OAAO,CAAC;YAChD,MAAM,QAAQ,GAAG;gBACf,SAAS,EAAE,SAAkB;gBAC7B,QAAQ,EAAE,SAAkB;gBAC5B,MAAM,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,2BAA2B,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,CAC3G,CAAC,EACD,IAAI,CACL;aACF,CAAC;YACF,OAAO,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,CAAC;QAClC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;YAC5C,IAAI,OAAO,CAAC,IAAI,KAAK,yBAAyB;gBAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;YAC/G,IAAI,MAAM,GAAkE,cAAc,CAAC;YAC3F,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO;gBAAE,MAAM,GAAG,qBAAqB,CAAC;iBACvD,IAAI,OAAO,CAAC,IAAI,KAAK,oBAAoB;gBAAE,MAAM,GAAG,oBAAoB,CAAC;YAC9E,OAAO;gBACL,KAAK,EAAE,SAAS;gBAChB,MAAM;gBACN,YAAY,EAAE,kDAAkD,OAAO,CAAC,OAAO,EAAE;aAClF,CAAC;QACJ,CAAC;IACH,CAAC;IACD,KAAK,CAAC,OAAO,CACX,MAAyB,EACzB,MAAyB,EACzB,OAAiF;QAEjF,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACjD,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,sBAAsB,CAAC,oBAAoB,EAAE,kCAAkC,MAAM,GAAG,CAAC,CAAC;QAClH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE;YAC5C,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE;YAClC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,UAAU,EAAE,OAAO,CAAC,mBAAmB;YACvC,gBAAgB,EAAE,IAAI,CAAC,WAAW,CAAC,gBAAgB;YACnD,kBAAkB,EAAE,IAAI,CAAC,WAAW,CAAC,kBAAkB;SACxD,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC;YACjD,MAAM,IAAI,sBAAsB,CAC9B,cAAc,EACd,cAAc,MAAM,WAAW,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,EACnF,OAAO,CAAC,kBAAkB,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CACjD,CAAC;IACN,CAAC;IACD,KAAK,CAAC,QAAQ,CACZ,MAAyB,EACzB,SAAiB,EACjB,UAAqD,EAAE;QAEvD,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QACvE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE;gBAC5D,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,SAAS;gBACT,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,UAAU,EAAE,IAAI,CAAC,GAAG,CAClB,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,WAAW,CAAC,mBAAmB,EACtD,IAAI,CAAC,WAAW,CAAC,mBAAmB,CACrC;gBACD,gBAAgB,EAAE,IAAI,CAAC,WAAW,CAAC,gBAAgB;gBACnD,kBAAkB,EAAE,IAAI,CAAC,WAAW,CAAC,kBAAkB;aACxD,CAAC,CAAC;YACH,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC;gBAAE,OAAO,SAAS,CAAC;YACxC,MAAM,QAAQ,GAAG,yBAAyB,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YAChF,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QACtD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,KAAK,CAAC,SAAS,CACb,MAAyB,EACzB,SAAiB,EACjB,SAAkC,EAClC,UAAqD,EAAE;QAEvD,+EAA+E;QAC/E,kFAAkF;QAClF,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;IACD,eAAe,CAAC,KAAc;QAC5B,MAAM,IAAI,GAAG,KAAK,YAAY,sBAAsB,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC;QACrF,OAAO;YACL,IAAI;YACJ,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;YAC/D,SAAS,EAAE,KAAK,YAAY,sBAAsB,IAAI,KAAK,CAAC,SAAS;YACrE,YAAY,EACV,oJAAoJ;SACvJ,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,27 @@
+export declare class ConfiguredCommandError extends Error {
+    readonly code: string;
+    readonly retryable: boolean;
+    constructor(code: string, message: string, retryable?: boolean);
+}
+export interface ConfiguredCommand {
+    readonly executable: string;
+    readonly args: readonly string[];
+}
+interface CommandOptions {
+    readonly checkoutRoot: string;
+    readonly operation: string;
+    readonly signal?: AbortSignal;
+    readonly deadlineMs: number;
+    readonly outputLimitBytes: number;
+    readonly terminationGraceMs: number;
+    readonly beforeLaunch?: () => void;
+}
+/** Only invocations whose descendants stay in their new process group are supported. */
+export declare function verifyCommandContainment(signal?: AbortSignal, timeoutMs?: number): Promise<void>;
+export declare function runConfiguredCommand(command: ConfiguredCommand, options: CommandOptions): Promise<{
+    code: number;
+    output: string;
+    diagnostic: string;
+}>;
+export {};
+//# sourceMappingURL=configuredCommandProcess.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"configuredCommandProcess.d.ts","sourceRoot":"","sources":["../../../src/domains/backend-preparation/configuredCommandProcess.ts"],"names":[],"mappings":"AAKA,qBAAa,sBAAuB,SAAQ,KAAK;IAE7C,QAAQ,CAAC,IAAI,EAAE,MAAM;IAErB,QAAQ,CAAC,SAAS;gBAFT,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACN,SAAS,UAAQ;CAI7B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAED,UAAU,cAAc;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CACpC;AAED,wFAAwF;AACxF,wBAAsB,wBAAwB,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,SAAS,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAOpG;AAyBD,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAyJ/D"}

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

@@ -0,0 +1,183 @@
+import { execFile, spawn } from 'node:child_process';
+import { promisify } from 'node:util';
+const executeFile = promisify(execFile);
+export class ConfiguredCommandError extends Error {
+    code;
+    retryable;
+    constructor(code, message, retryable = false) {
+        super(message);
+        this.code = code;
+        this.retryable = retryable;
+    }
+}
+/** Only invocations whose descendants stay in their new process group are supported. */
+export async function verifyCommandContainment(signal, timeoutMs = 5000) {
+    if (process.platform !== 'linux' && process.platform !== 'darwin')
+        throw new ConfiguredCommandError('unsupported_containment', 'Owned process-group cancellation is unavailable on this platform.');
+    await processGroups(signal, timeoutMs);
+}
+async function processGroups(signal, timeoutMs = 5000) {
+    try {
+        const { stdout } = await executeFile('ps', ['-axo', 'pgid=,stat='], {
+            signal,
+            timeout: Math.max(1, Math.min(5000, timeoutMs)),
+            maxBuffer: 4 * 1024 * 1024,
+        });
+        return stdout
+            .trim()
+            .split('\n')
+            .map((line) => {
+            const [group, state] = line.trim().split(/\s+/);
+            if (!/^\d+$/.test(group) || !state)
+                throw new Error('Invalid process inventory');
+            return { group: Number(group), state };
+        });
+    }
+    catch {
+        throw new ConfiguredCommandError('unsupported_containment', 'Cannot verify owned process groups; no command may launch without cancellation support.');
+    }
+}
+export async function runConfiguredCommand(command, options) {
+    if (options.signal?.aborted)
+        throw new ConfiguredCommandError('cancelled', 'Command cancelled before launch.');
+    const expiresAt = Date.now() + options.deadlineMs;
+    try {
+        await verifyCommandContainment(options.signal, options.deadlineMs);
+    }
+    catch (error) {
+        if (options.signal?.aborted)
+            throw new ConfiguredCommandError('cancelled', 'Command cancelled during containment verification; no command launched.');
+        if (Date.now() >= expiresAt)
+            throw new ConfiguredCommandError('execution_deadline', 'Containment verification exhausted the command budget; no command launched.');
+        throw error;
+    }
+    if (options.signal?.aborted)
+        throw new ConfiguredCommandError('cancelled', 'Command cancelled before launch.');
+    if (Date.now() >= expiresAt)
+        throw new ConfiguredCommandError('execution_deadline', 'Containment verification exhausted the command budget; no command launched.');
+    const args = command.args.map((argument) => argument.replace(/\{(checkout|operation)\}/g, (_placeholder, field) => field === 'checkout' ? options.checkoutRoot : options.operation));
+    options.beforeLaunch?.();
+    return new Promise((resolve, reject) => {
+        const child = spawn(command.executable, args, {
+            cwd: options.checkoutRoot,
+            detached: true,
+            shell: false,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let output = Buffer.alloc(0);
+        let diagnostic = Buffer.alloc(0);
+        let closed = false;
+        let exitCode = null;
+        let failure;
+        let escalation;
+        let poll;
+        let finished = false;
+        let checking = false;
+        const signalOwned = (signal) => {
+            if (!child.pid || finished)
+                return;
+            try {
+                process.kill(-child.pid, signal);
+            }
+            catch {
+                /* Group exit can race signalling. */
+            }
+        };
+        const stop = (error) => {
+            if (failure)
+                return;
+            failure = error;
+            signalOwned('SIGTERM');
+            escalation = setTimeout(() => signalOwned('SIGKILL'), options.terminationGraceMs);
+        };
+        const abort = () => stop(new ConfiguredCommandError('cancelled', 'Owned command cancelled; foreign processes were not targeted.'));
+        const deadline = setTimeout(() => stop(new ConfiguredCommandError('execution_deadline', 'Owned command exceeded its execution deadline. Explicitly retry with a larger budget.')), Math.max(1, expiresAt - Date.now()));
+        const finish = () => {
+            finished = true;
+            clearTimeout(deadline);
+            if (escalation)
+                clearTimeout(escalation);
+            if (poll)
+                clearTimeout(poll);
+            options.signal?.removeEventListener('abort', abort);
+            if (failure)
+                reject(failure);
+            else if (exitCode === null)
+                reject(new ConfiguredCommandError('command_failed', 'Command ended without a successful exit code.'));
+            else
+                resolve({ code: exitCode, output: output.toString('utf8'), diagnostic: diagnostic.toString('utf8') });
+        };
+        const check = async () => {
+            if (finished || checking)
+                return;
+            checking = true;
+            try {
+                if (closed && !child.pid) {
+                    finish();
+                    return;
+                }
+                try {
+                    const groups = await processGroups();
+                    const alive = groups.some((item) => item.group === child.pid && !item.state.startsWith('Z'));
+                    if (closed && !alive) {
+                        finish();
+                        return;
+                    }
+                }
+                catch (error) {
+                    stop(error instanceof ConfiguredCommandError
+                        ? error
+                        : new ConfiguredCommandError('ownership_unknown', 'Owned process inventory unavailable.'));
+                    // Preserve ownership and scheduler capacity until actual group settlement is verified.
+                    signalOwned('SIGKILL');
+                    if (closed && child.pid) {
+                        try {
+                            process.kill(-child.pid, 0);
+                        }
+                        catch (inventoryError) {
+                            if (inventoryError.code === 'ESRCH') {
+                                finish();
+                                return;
+                            }
+                        }
+                    }
+                }
+                if (finished)
+                    return;
+                poll = setTimeout(() => {
+                    void check();
+                }, closed ? 50 : 500);
+            }
+            finally {
+                checking = false;
+            }
+        };
+        child.stdout.on('data', (chunk) => {
+            if (output.length + chunk.length > options.outputLimitBytes) {
+                output = Buffer.concat([output, chunk]).subarray(0, options.outputLimitBytes);
+                stop(new ConfiguredCommandError('output_limit', 'Command output exceeded its bounded capture limit.'));
+                return;
+            }
+            output = Buffer.concat([output, chunk]);
+        });
+        child.stderr.on('data', (chunk) => {
+            diagnostic = Buffer.concat([diagnostic, chunk]).subarray(-options.outputLimitBytes);
+        });
+        child.once('error', (error) => {
+            failure = new ConfiguredCommandError('command_unavailable', error.message);
+        });
+        child.once('close', (code) => {
+            closed = true;
+            exitCode = code;
+            // Wake settlement immediately; short probes never wait for the running interval.
+            if (poll)
+                clearTimeout(poll);
+            void check();
+        });
+        options.signal?.addEventListener('abort', abort, { once: true });
+        if (options.signal?.aborted)
+            abort();
+        void check();
+    });
+}
+//# sourceMappingURL=configuredCommandProcess.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"configuredCommandProcess.js","sourceRoot":"","sources":["../../../src/domains/backend-preparation/configuredCommandProcess.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,WAAW,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAExC,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAEpC;IAEA;IAHX,YACW,IAAY,EACrB,OAAe,EACN,YAAY,KAAK;QAE1B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJN,SAAI,GAAJ,IAAI,CAAQ;QAEZ,cAAS,GAAT,SAAS,CAAQ;IAG5B,CAAC;CACF;AAiBD,wFAAwF;AACxF,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,MAAoB,EAAE,SAAS,GAAG,IAAI;IACnF,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ;QAC/D,MAAM,IAAI,sBAAsB,CAC9B,yBAAyB,EACzB,mEAAmE,CACpE,CAAC;IACJ,MAAM,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AACzC,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,MAAoB,EAAE,SAAS,GAAG,IAAI;IACjE,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE;YAClE,MAAM;YACN,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAC/C,SAAS,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;SAC3B,CAAC,CAAC;QACH,OAAO,MAAM;aACV,IAAI,EAAE;aACN,KAAK,CAAC,IAAI,CAAC;aACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACZ,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAChD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;YACjF,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC;QACzC,CAAC,CAAC,CAAC;IACP,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,sBAAsB,CAC9B,yBAAyB,EACzB,yFAAyF,CAC1F,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAA0B,EAC1B,OAAuB;IAEvB,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO;QAAE,MAAM,IAAI,sBAAsB,CAAC,WAAW,EAAE,kCAAkC,CAAC,CAAC;IAC/G,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAClD,IAAI,CAAC;QACH,MAAM,wBAAwB,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IACrE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO;YACzB,MAAM,IAAI,sBAAsB,CAC9B,WAAW,EACX,yEAAyE,CAC1E,CAAC;QACJ,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,SAAS;YACzB,MAAM,IAAI,sBAAsB,CAC9B,oBAAoB,EACpB,6EAA6E,CAC9E,CAAC;QACJ,MAAM,KAAK,CAAC;IACd,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO;QAAE,MAAM,IAAI,sBAAsB,CAAC,WAAW,EAAE,kCAAkC,CAAC,CAAC;IAC/G,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,SAAS;QACzB,MAAM,IAAI,sBAAsB,CAC9B,oBAAoB,EACpB,6EAA6E,CAC9E,CAAC;IACJ,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CACzC,QAAQ,CAAC,OAAO,CAAC,2BAA2B,EAAE,CAAC,YAAY,EAAE,KAAa,EAAE,EAAE,CAC5E,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAChE,CACF,CAAC;IACF,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC;IACzB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,EAAE;YAC5C,GAAG,EAAE,OAAO,CAAC,YAAY;YACzB,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC;QACH,IAAI,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC7B,IAAI,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACjC,IAAI,MAAM,GAAG,KAAK,CAAC;QACnB,IAAI,QAAQ,GAAkB,IAAI,CAAC;QACnC,IAAI,OAA2C,CAAC;QAChD,IAAI,UAAqD,CAAC;QAC1D,IAAI,IAA+C,CAAC;QACpD,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,MAAM,WAAW,GAAG,CAAC,MAA6B,EAAQ,EAAE;YAC1D,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,QAAQ;gBAAE,OAAO;YACnC,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACnC,CAAC;YAAC,MAAM,CAAC;gBACP,qCAAqC;YACvC,CAAC;QACH,CAAC,CAAC;QACF,MAAM,IAAI,GAAG,CAAC,KAA6B,EAAQ,EAAE;YACnD,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,KAAK,CAAC;YAChB,WAAW,CAAC,SAAS,CAAC,CAAC;YACvB,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;QACpF,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,GAAS,EAAE,CACvB,IAAI,CAAC,IAAI,sBAAsB,CAAC,WAAW,EAAE,+DAA+D,CAAC,CAAC,CAAC;QACjH,MAAM,QAAQ,GAAG,UAAU,CACzB,GAAG,EAAE,CACH,IAAI,CACF,IAAI,sBAAsB,CACxB,oBAAoB,EACpB,uFAAuF,CACxF,CACF,EACH,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CACpC,CAAC;QACF,MAAM,MAAM,GAAG,GAAS,EAAE;YACxB,QAAQ,GAAG,IAAI,CAAC;YAChB,YAAY,CAAC,QAAQ,CAAC,CAAC;YACvB,IAAI,UAAU;gBAAE,YAAY,CAAC,UAAU,CAAC,CAAC;YACzC,IAAI,IAAI;gBAAE,YAAY,CAAC,IAAI,CAAC,CAAC;YAC7B,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YACpD,IAAI,OAAO;gBAAE,MAAM,CAAC,OAAO,CAAC,CAAC;iBACxB,IAAI,QAAQ,KAAK,IAAI;gBACxB,MAAM,CAAC,IAAI,sBAAsB,CAAC,gBAAgB,EAAE,+CAA+C,CAAC,CAAC,CAAC;;gBACnG,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC7G,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,KAAK,IAAmB,EAAE;YACtC,IAAI,QAAQ,IAAI,QAAQ;gBAAE,OAAO;YACjC,QAAQ,GAAG,IAAI,CAAC;YAChB,IAAI,CAAC;gBACH,IAAI,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;oBACzB,MAAM,EAAE,CAAC;oBACT,OAAO;gBACT,CAAC;gBACD,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,aAAa,EAAE,CAAC;oBACrC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;oBAC7F,IAAI,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;wBACrB,MAAM,EAAE,CAAC;wBACT,OAAO;oBACT,CAAC;gBACH,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,CACF,KAAK,YAAY,sBAAsB;wBACrC,CAAC,CAAC,KAAK;wBACP,CAAC,CAAC,IAAI,sBAAsB,CAAC,mBAAmB,EAAE,sCAAsC,CAAC,CAC5F,CAAC;oBACF,uFAAuF;oBACvF,WAAW,CAAC,SAAS,CAAC,CAAC;oBACvB,IAAI,MAAM,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;wBACxB,IAAI,CAAC;4BACH,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;wBAC9B,CAAC;wBAAC,OAAO,cAAc,EAAE,CAAC;4BACxB,IAAK,cAAoC,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gCAC3D,MAAM,EAAE,CAAC;gCACT,OAAO;4BACT,CAAC;wBACH,CAAC;oBACH,CAAC;gBACH,CAAC;gBACD,IAAI,QAAQ;oBAAE,OAAO;gBACrB,IAAI,GAAG,UAAU,CACf,GAAG,EAAE;oBACH,KAAK,KAAK,EAAE,CAAC;gBACf,CAAC,EACD,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAClB,CAAC;YACJ,CAAC;oBAAS,CAAC;gBACT,QAAQ,GAAG,KAAK,CAAC;YACnB,CAAC;QACH,CAAC,CAAC;QACF,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACxC,IAAI,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;gBAC5D,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;gBAC9E,IAAI,CAAC,IAAI,sBAAsB,CAAC,cAAc,EAAE,oDAAoD,CAAC,CAAC,CAAC;gBACvG,OAAO;YACT,CAAC;YACD,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACxC,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACtF,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAC5B,OAAO,GAAG,IAAI,sBAAsB,CAAC,qBAAqB,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7E,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAC3B,MAAM,GAAG,IAAI,CAAC;YACd,QAAQ,GAAG,IAAI,CAAC;YAChB,iFAAiF;YACjF,IAAI,IAAI;gBAAE,YAAY,CAAC,IAAI,CAAC,CAAC;YAC7B,KAAK,KAAK,EAAE,CAAC;QACf,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACjE,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO;YAAE,KAAK,EAAE,CAAC;QACrC,KAAK,KAAK,EAAE,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC"}