@aws/agentcore 0.3.0-preview.1.0

package/dist/lib/packaging/node.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeCodeZipPackagerSync = exports.NodeCodeZipPackager = void 0;
+const constants_1 = require("../constants");
+const subprocess_1 = require("../utils/subprocess");
+const errors_1 = require("./errors");
+const helpers_1 = require("./helpers");
+const path_1 = require("path");
+const NODE_RUNTIME_REGEX = /NODE_(\d+)/;
+/**
+ * Type guard to check if runtime version is a Node runtime
+ */
+function isNodeRuntimeVersion(version) {
+    return (0, helpers_1.isNodeRuntime)(version);
+}
+/**
+ * Extracts Node version from runtime constant.
+ * Example: NODE_20 -> "20" (for use with node version checks)
+ */
+function _extractNodeVersion(runtime) {
+    const match = NODE_RUNTIME_REGEX.exec(runtime);
+    if (!match) {
+        throw new errors_1.PackagingError(`Unsupported Node runtime value: ${runtime}`);
+    }
+    const [, major] = match;
+    if (!major) {
+        throw new errors_1.PackagingError(`Invalid Node runtime value: ${runtime}`);
+    }
+    return major;
+}
+/**
+ * Async Node/TypeScript packager for CLI usage.
+ */
+class NodeCodeZipPackager {
+    async pack(spec, options = {}) {
+        if (spec.build !== 'CodeZip') {
+            throw new errors_1.PackagingError('Node packager only supports CodeZip build type.');
+        }
+        if (!isNodeRuntimeVersion(spec.runtimeVersion)) {
+            throw new errors_1.PackagingError(`Node packager only supports Node runtimes. Received: ${spec.runtimeVersion}`);
+        }
+        const agentName = options.agentName ?? spec.name;
+        const { projectRoot, srcDir, stagingDir, artifactsDir } = await (0, helpers_1.resolveProjectPaths)(options, agentName);
+        await (0, helpers_1.ensureBinaryAvailable)('npm', constants_1.NPM_INSTALL_HINT);
+        await (0, helpers_1.ensureDirClean)(stagingDir);
+        // Copy source files
+        await (0, helpers_1.copySourceTree)(srcDir, stagingDir);
+        // Install production dependencies
+        await this.installDependencies(projectRoot, stagingDir);
+        const artifactPath = options.outputPath ?? (0, path_1.join)(artifactsDir, (0, constants_1.getArtifactZipName)(agentName));
+        await (0, helpers_1.createZipFromDir)(stagingDir, artifactPath);
+        const sizeBytes = await (0, helpers_1.enforceZipSizeLimit)(artifactPath);
+        return {
+            artifactPath,
+            sizeBytes,
+            stagingPath: stagingDir,
+        };
+    }
+    async installDependencies(projectRoot, stagingDir) {
+        // Copy package.json to staging
+        const result = await (0, subprocess_1.runSubprocessCapture)('npm', ['install', '--omit=dev', '--prefix', stagingDir], {
+            cwd: projectRoot,
+        });
+        if (result.code !== 0) {
+            const combined = `${result.stdout}\n${result.stderr}`.trim();
+            throw new errors_1.PackagingError(combined.length > 0 ? combined : `npm install failed with exit code ${result.code}`);
+        }
+    }
+}
+exports.NodeCodeZipPackager = NodeCodeZipPackager;
+/**
+ * Sync Node/TypeScript packager for CDK bundling.
+ */
+class NodeCodeZipPackagerSync {
+    packCodeZip(config, options = {}) {
+        const runtimeVersion = config.runtimeVersion ?? 'NODE_20';
+        if (!isNodeRuntimeVersion(runtimeVersion)) {
+            throw new errors_1.PackagingError(`Node packager only supports Node runtimes. Received: ${runtimeVersion}`);
+        }
+        const agentName = options.agentName ?? config.name ?? 'asset';
+        const { projectRoot, srcDir, stagingDir, artifactsDir } = (0, helpers_1.resolveProjectPathsSync)(options, agentName);
+        (0, helpers_1.ensureBinaryAvailableSync)('npm', constants_1.NPM_INSTALL_HINT);
+        (0, helpers_1.ensureDirCleanSync)(stagingDir);
+        // Copy source files
+        (0, helpers_1.copySourceTreeSync)(srcDir, stagingDir);
+        // Install production dependencies
+        this.installDependenciesSync(projectRoot, stagingDir);
+        const artifactPath = options.outputPath ?? (0, path_1.join)(artifactsDir, (0, constants_1.getArtifactZipName)(agentName));
+        (0, helpers_1.createZipFromDirSync)(stagingDir, artifactPath);
+        const sizeBytes = (0, helpers_1.enforceZipSizeLimitSync)(artifactPath);
+        return {
+            artifactPath,
+            sizeBytes,
+            stagingPath: stagingDir,
+        };
+    }
+    installDependenciesSync(projectRoot, stagingDir) {
+        const result = (0, subprocess_1.runSubprocessCaptureSync)('npm', ['install', '--omit=dev', '--prefix', stagingDir], {
+            cwd: projectRoot,
+        });
+        if (result.code !== 0) {
+            const combined = `${result.stdout}\n${result.stderr}`.trim();
+            throw new errors_1.PackagingError(combined.length > 0 ? combined : `npm install failed with exit code ${result.code}`);
+        }
+    }
+}
+exports.NodeCodeZipPackagerSync = NodeCodeZipPackagerSync;
+//# sourceMappingURL=node.js.map

package/dist/lib/packaging/node.js.map

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

package/dist/lib/packaging/python.d.ts

@@ -0,0 +1,17 @@
+import type { AgentEnvSpec } from '../../schema';
+import type { ArtifactResult, CodeZipPackager, PackageOptions, RuntimePackager } from './types/packaging';
+/**
+ * Async Python packager for CLI usage.
+ */
+export declare class PythonCodeZipPackager implements RuntimePackager {
+    pack(spec: AgentEnvSpec, options?: PackageOptions): Promise<ArtifactResult>;
+    private installWithRetries;
+}
+/**
+ * Sync Python packager for CDK bundling.
+ */
+export declare class PythonCodeZipPackagerSync implements CodeZipPackager {
+    packCodeZip(config: AgentEnvSpec, options?: PackageOptions): ArtifactResult;
+    private installWithRetriesSync;
+}
+//# sourceMappingURL=python.d.ts.map

package/dist/lib/packaging/python.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python.d.ts","sourceRoot":"","sources":["../../../src/lib/packaging/python.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAiC,MAAM,cAAc,CAAC;AAqBhF,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AA+B1G;;GAEG;AACH,qBAAa,qBAAsB,YAAW,eAAe;IACrD,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,cAAc,CAAC;YAuCvE,kBAAkB;CAsDjC;AAED;;GAEG;AACH,qBAAa,yBAA0B,YAAW,eAAe;IAC/D,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,GAAE,cAAmB,GAAG,cAAc;IAqC/E,OAAO,CAAC,sBAAsB;CAsD/B"}

package/dist/lib/packaging/python.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PythonCodeZipPackagerSync = exports.PythonCodeZipPackager = void 0;
+const constants_1 = require("../constants");
+const subprocess_1 = require("../utils/subprocess");
+const errors_1 = require("./errors");
+const helpers_1 = require("./helpers");
+const uv_1 = require("./uv");
+const path_1 = require("path");
+const PYTHON_RUNTIME_REGEX = /PYTHON_(\d+)_?(\d+)?/;
+/**
+ * Type guard to check if runtime version is a Python runtime
+ */
+function isPythonRuntimeVersion(version) {
+    return (0, helpers_1.isPythonRuntime)(version);
+}
+// AC Runtime uses AL2023 with GLIBC 2.34, we can support any manylinux <= 2_34
+const PLATFORM_CANDIDATES = ['aarch64-manylinux2014', 'aarch64-manylinux_2_28', 'aarch64-manylinux_2_34'];
+/**
+ * Extracts Python version from runtime constant.
+ * Example: PYTHON_3_12 -> "3.12" (for use with uv --python-version)
+ */
+function extractPythonVersion(runtime) {
+    const match = PYTHON_RUNTIME_REGEX.exec(runtime);
+    if (!match) {
+        throw new errors_1.PackagingError(`Unsupported Python runtime value: ${runtime}`);
+    }
+    const [, major, minor] = match;
+    if (!major || !minor) {
+        throw new errors_1.PackagingError(`Invalid Python runtime value: ${runtime}`);
+    }
+    return `${Number(major)}.${Number(minor)}`;
+}
+/**
+ * Async Python packager for CLI usage.
+ */
+class PythonCodeZipPackager {
+    async pack(spec, options = {}) {
+        if (spec.build !== 'CodeZip') {
+            throw new errors_1.PackagingError('Python packager only supports CodeZip build type.');
+        }
+        if (!isPythonRuntimeVersion(spec.runtimeVersion)) {
+            throw new errors_1.PackagingError(`Python packager only supports Python runtimes. Received: ${spec.runtimeVersion}`);
+        }
+        const agentName = options.agentName ?? spec.name;
+        const { projectRoot, srcDir, stagingDir, artifactsDir, pyprojectPath } = await (0, helpers_1.resolveProjectPaths)(options, agentName);
+        const pythonPlatforms = options.pythonPlatform ? [options.pythonPlatform] : PLATFORM_CANDIDATES;
+        await (0, helpers_1.ensureBinaryAvailable)('uv', constants_1.UV_INSTALL_HINT);
+        await (0, helpers_1.ensureDirClean)(stagingDir);
+        const finalStaging = await this.installWithRetries(projectRoot, srcDir, stagingDir, spec.runtimeVersion, pythonPlatforms, pyprojectPath);
+        const artifactPath = options.outputPath ?? (0, path_1.join)(artifactsDir, (0, constants_1.getArtifactZipName)(agentName));
+        await (0, helpers_1.createZipFromDir)(finalStaging, artifactPath);
+        const sizeBytes = await (0, helpers_1.enforceZipSizeLimit)(artifactPath);
+        return {
+            artifactPath,
+            sizeBytes,
+            stagingPath: finalStaging,
+        };
+    }
+    async installWithRetries(projectRoot, srcDir, stagingDir, runtimeVersion, pythonPlatforms, pyprojectPath) {
+        const pythonVersion = extractPythonVersion(runtimeVersion);
+        for (const platform of pythonPlatforms) {
+            if (!platform) {
+                throw new errors_1.PackagingError('No platform candidate available for dependency installation.');
+            }
+            await (0, helpers_1.ensureDirClean)(stagingDir);
+            const result = await (0, subprocess_1.runSubprocessCapture)('uv', [
+                'pip',
+                'install',
+                '-r',
+                pyprojectPath,
+                '--target',
+                stagingDir,
+                '--python-version',
+                pythonVersion,
+                '--python-platform',
+                platform,
+                '--only-binary',
+                ':all:',
+            ], { cwd: projectRoot });
+            if (result.code === 0) {
+                await (0, helpers_1.copySourceTree)(srcDir, stagingDir);
+                await (0, helpers_1.convertWindowsScriptsToLinux)(stagingDir);
+                return stagingDir;
+            }
+            else {
+                const platformIssue = (0, uv_1.detectUnavailablePlatform)(result);
+                if (platformIssue) {
+                    continue;
+                }
+                const combined = `${result.stdout}\n${result.stderr}`.trim();
+                throw new errors_1.PackagingError(combined.length > 0 ? combined : `uv install failed on platform ${platform} with exit code ${result.code}`);
+            }
+        }
+        throw new errors_1.PackagingError('uv install failed for all platform candidates.');
+    }
+}
+exports.PythonCodeZipPackager = PythonCodeZipPackager;
+/**
+ * Sync Python packager for CDK bundling.
+ */
+class PythonCodeZipPackagerSync {
+    packCodeZip(config, options = {}) {
+        const runtimeVersion = config.runtimeVersion ?? 'PYTHON_3_12';
+        if (!isPythonRuntimeVersion(runtimeVersion)) {
+            throw new errors_1.PackagingError(`Python packager only supports Python runtimes. Received: ${runtimeVersion}`);
+        }
+        const agentName = options.agentName ?? config.name ?? 'asset';
+        const { projectRoot, srcDir, stagingDir, artifactsDir, pyprojectPath } = (0, helpers_1.resolveProjectPathsSync)(options, agentName);
+        const pythonPlatforms = options.pythonPlatform ? [options.pythonPlatform] : PLATFORM_CANDIDATES;
+        (0, helpers_1.ensureBinaryAvailableSync)('uv', constants_1.UV_INSTALL_HINT);
+        (0, helpers_1.ensureDirCleanSync)(stagingDir);
+        const finalStaging = this.installWithRetriesSync(projectRoot, srcDir, stagingDir, runtimeVersion, pythonPlatforms, pyprojectPath);
+        const artifactPath = options.outputPath ?? (0, path_1.join)(artifactsDir, (0, constants_1.getArtifactZipName)(agentName));
+        (0, helpers_1.createZipFromDirSync)(finalStaging, artifactPath);
+        const sizeBytes = (0, helpers_1.enforceZipSizeLimitSync)(artifactPath);
+        return {
+            artifactPath,
+            sizeBytes,
+            stagingPath: finalStaging,
+        };
+    }
+    installWithRetriesSync(projectRoot, srcDir, stagingDir, runtimeVersion, pythonPlatforms, pyprojectPath) {
+        const pythonVersion = extractPythonVersion(runtimeVersion);
+        for (const platform of pythonPlatforms) {
+            if (!platform) {
+                throw new errors_1.PackagingError('No platform candidate available for dependency installation.');
+            }
+            (0, helpers_1.ensureDirCleanSync)(stagingDir);
+            const result = (0, subprocess_1.runSubprocessCaptureSync)('uv', [
+                'pip',
+                'install',
+                '-r',
+                pyprojectPath,
+                '--target',
+                stagingDir,
+                '--python-version',
+                pythonVersion,
+                '--python-platform',
+                platform,
+                '--only-binary',
+                ':all:',
+            ], { cwd: projectRoot });
+            if (result.code === 0) {
+                (0, helpers_1.copySourceTreeSync)(srcDir, stagingDir);
+                (0, helpers_1.convertWindowsScriptsToLinuxSync)(stagingDir);
+                return stagingDir;
+            }
+            else {
+                const platformIssue = (0, uv_1.detectUnavailablePlatform)(result);
+                if (platformIssue) {
+                    continue;
+                }
+                const combined = `${result.stdout}\n${result.stderr}`.trim();
+                throw new errors_1.PackagingError(combined.length > 0 ? combined : `uv install failed on platform ${platform} with exit code ${result.code}`);
+            }
+        }
+        throw new errors_1.PackagingError('uv install failed for all platform candidates.');
+    }
+}
+exports.PythonCodeZipPackagerSync = PythonCodeZipPackagerSync;
+//# sourceMappingURL=python.js.map

package/dist/lib/packaging/python.js.map

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

package/dist/lib/packaging/types/index.d.ts

@@ -0,0 +1,2 @@
+export type { ArtifactResult, CodeBundleConfig, CodeZipPackager, PackageOptions, RuntimePackager } from './packaging';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/packaging/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/packaging/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/lib/packaging/types/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/lib/packaging/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/packaging/types/index.ts"],"names":[],"mappings":""}

package/dist/lib/packaging/types/packaging.d.ts

@@ -0,0 +1,57 @@
+import type { AgentEnvSpec, RuntimeVersion } from '../../../schema';
+export interface PackageOptions {
+    /** Optional override for project root; defaults to cwd or discovered root. */
+    projectRoot?: string;
+    /** Optional override for source directory; defaults to <projectRoot>/src. */
+    srcDir?: string;
+    /** Optional override for pyproject path; defaults to <projectRoot>/pyproject.toml (Python) or package.json (Node). */
+    pyprojectPath?: string;
+    /** Optional override for artifact base directory; defaults to <projectRoot>/.agentcore. */
+    artifactDir?: string;
+    /** Optional override for python platform tag; defaults to aarch64-manylinux2014. Only used for Python. */
+    pythonPlatform?: string;
+    /** Agent name for artifact naming and staging isolation. */
+    agentName?: string;
+    /** Output path for the zip artifact. If provided, writes directly here. */
+    outputPath?: string;
+}
+export interface ArtifactResult {
+    artifactPath: string;
+    sizeBytes: number;
+    stagingPath: string;
+}
+/**
+ * Common interface for code bundling.
+ * Both AgentEnvSpec and runtime configs satisfy this interface.
+ */
+export interface CodeBundleConfig {
+    name: string;
+    codeLocation: string;
+    entrypoint: string;
+    runtimeVersion?: RuntimeVersion;
+}
+/**
+ * Async packager interface for CLI usage.
+ */
+export interface RuntimePackager {
+    /**
+     * Package code for a runtime asynchronously.
+     * @param spec The agent environment spec
+     * @param options Packaging options
+     * @returns Promise of ArtifactResult with the path to the created zip
+     */
+    pack(spec: AgentEnvSpec, options?: PackageOptions): Promise<ArtifactResult>;
+}
+/**
+ * Sync packager interface for CDK bundling constructs.
+ */
+export interface CodeZipPackager {
+    /**
+     * Package code for a CodeZip runtime synchronously.
+     * @param config The code bundle configuration (AgentEnvSpec or compatible)
+     * @param options Packaging options
+     * @returns ArtifactResult with the path to the created zip
+     */
+    packCodeZip(config: CodeBundleConfig | AgentEnvSpec, options?: PackageOptions): ArtifactResult;
+}
+//# sourceMappingURL=packaging.d.ts.map

package/dist/lib/packaging/types/packaging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packaging.d.ts","sourceRoot":"","sources":["../../../../src/lib/packaging/types/packaging.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEpE,MAAM,WAAW,cAAc;IAC7B,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sHAAsH;IACtH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2FAA2F;IAC3F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0GAA0G;IAC1G,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC7E;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EAAE,gBAAgB,GAAG,YAAY,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,cAAc,CAAC;CAChG"}

package/dist/lib/packaging/types/packaging.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=packaging.js.map

package/dist/lib/packaging/types/packaging.js.map

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

package/dist/lib/packaging/uv.d.ts

@@ -0,0 +1,7 @@
+import type { SubprocessResult } from '../utils/subprocess';
+export interface PlatformIssue {
+    message: string;
+    platforms?: string[];
+}
+export declare function detectUnavailablePlatform(result: SubprocessResult): PlatformIssue | null;
+//# sourceMappingURL=uv.d.ts.map

package/dist/lib/packaging/uv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uv.d.ts","sourceRoot":"","sources":["../../../src/lib/packaging/uv.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAMD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,gBAAgB,GAAG,aAAa,GAAG,IAAI,CAoBxF"}

package/dist/lib/packaging/uv.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectUnavailablePlatform = detectUnavailablePlatform;
+const PLATFORM_HINT_REGEX = /platforms:\s*([^\n]+)/i;
+const MANYLINUX_TOKEN = /(manylinux[^\s,]+)/gi;
+const NO_WHEELS_REGEX = /(has no wheels with a matching platform tag|no compatible (?:wheels|tags) found)/i;
+function detectUnavailablePlatform(result) {
+    const combined = `${result.stdout}\n${result.stderr}`;
+    const hintMatch = PLATFORM_HINT_REGEX.exec(combined);
+    if (hintMatch?.[1]) {
+        const hints = Array.from(hintMatch[1].matchAll(MANYLINUX_TOKEN))
+            .map(match => match[1])
+            .filter((value) => Boolean(value));
+        if (hints.length > 0) {
+            return {
+                message: extractRelevantBlock(combined, PLATFORM_HINT_REGEX),
+                platforms: hints,
+            };
+        }
+    }
+    if (NO_WHEELS_REGEX.test(combined)) {
+        return { message: extractRelevantBlock(combined, NO_WHEELS_REGEX) };
+    }
+    return null;
+}
+function extractRelevantBlock(text, pattern, context = 3) {
+    const lines = text.split(/\r?\n/);
+    const index = lines.findIndex(line => pattern.test(line));
+    if (index === -1) {
+        return text.trim();
+    }
+    const start = Math.max(0, index - context);
+    const end = Math.min(lines.length, index + context + 1);
+    return lines
+        .slice(start, end)
+        .map(line => line.trim())
+        .join('\n')
+        .trim();
+}
+//# sourceMappingURL=uv.js.map

package/dist/lib/packaging/uv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uv.js","sourceRoot":"","sources":["../../../src/lib/packaging/uv.ts"],"names":[],"mappings":";;AAWA,8DAoBC;AAxBD,MAAM,mBAAmB,GAAG,wBAAwB,CAAC;AACrD,MAAM,eAAe,GAAG,sBAAsB,CAAC;AAC/C,MAAM,eAAe,GAAG,mFAAmF,CAAC;AAE5G,SAAgB,yBAAyB,CAAC,MAAwB;IAChE,MAAM,QAAQ,GAAG,GAAG,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC;IACtD,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrD,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnB,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;aAC7D,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;aACtB,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QACtD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,OAAO;gBACL,OAAO,EAAE,oBAAoB,CAAC,QAAQ,EAAE,mBAAmB,CAAC;gBAC5D,SAAS,EAAE,KAAK;aACjB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnC,OAAO,EAAE,OAAO,EAAE,oBAAoB,CAAC,QAAQ,EAAE,eAAe,CAAC,EAAE,CAAC;IACtE,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAY,EAAE,OAAe,EAAE,OAAO,GAAG,CAAC;IACtE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC;IACxD,OAAO,KAAK;SACT,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC;SACjB,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SACxB,IAAI,CAAC,IAAI,CAAC;SACV,IAAI,EAAE,CAAC;AACZ,CAAC"}

package/dist/lib/schemas/io/config-io.d.ts

@@ -0,0 +1,106 @@
+import type { AgentCoreCliMcpDefs, AgentCoreMcpSpec, AgentCoreProjectSpec, AwsDeploymentTarget, DeployedState } from '../../../schema';
+import { type PathConfig, PathResolver } from './path-resolver';
+/**
+ * Manages reading, writing, and validation of AgentCore configuration files
+ */
+export declare class ConfigIO {
+    private readonly pathResolver;
+    private readonly projectDiscovered;
+    /**
+     * Create a ConfigIO instance.
+     * If no baseDir is provided, automatically discovers the project using findConfigRoot().
+     */
+    constructor(pathConfig?: Partial<PathConfig>);
+    /**
+     * Check if this ConfigIO is associated with a discovered or explicitly configured project.
+     * Returns false if no baseDir was provided and no project was found via auto-discovery.
+     */
+    hasProject(): boolean;
+    /**
+     * Get the current path resolver
+     */
+    getPathResolver(): PathResolver;
+    /**
+     * Update the base directory for config files
+     */
+    setBaseDir(baseDir: string): void;
+    /**
+     * Get the project root directory (parent of agentcore/)
+     */
+    getProjectRoot(): string;
+    /**
+     * Get the config root directory (the agentcore/ directory)
+     */
+    getConfigRoot(): string;
+    /**
+     * Read and validate the project configuration.
+     */
+    readProjectSpec(): Promise<AgentCoreProjectSpec>;
+    /**
+     * Write and validate the project configuration file.
+     */
+    writeProjectSpec(data: AgentCoreProjectSpec): Promise<void>;
+    /**
+     * Read and validate the AWS configuration file.
+     * Applies overrides following AWS SDK precedence:
+     * - Account: from current credentials if AWS_PROFILE is set
+     * - Region: AWS_REGION > AWS_DEFAULT_REGION > profile config > saved value
+     */
+    readAWSDeploymentTargets(): Promise<AwsDeploymentTarget[]>;
+    /**
+     * Write and validate the AWS configuration file
+     */
+    writeAWSDeploymentTargets(data: AwsDeploymentTarget[]): Promise<void>;
+    /**
+     * Read and validate the deployed state file.
+     * Validates that all target keys exist in aws-targets.
+     */
+    readDeployedState(): Promise<DeployedState>;
+    /**
+     * Write and validate the deployed state file.
+     * Validates that all target keys exist in aws-targets.
+     */
+    writeDeployedState(data: DeployedState): Promise<void>;
+    /**
+     * Read and validate the MCP configuration file
+     */
+    readMcpSpec(): Promise<AgentCoreMcpSpec>;
+    /**
+     * Write and validate the MCP configuration file
+     */
+    writeMcpSpec(data: AgentCoreMcpSpec): Promise<void>;
+    /**
+     * Read and validate the MCP definitions file
+     */
+    readMcpDefs(): Promise<AgentCoreCliMcpDefs>;
+    /**
+     * Write and validate the MCP definitions file
+     */
+    writeMcpDefs(data: AgentCoreCliMcpDefs): Promise<void>;
+    /**
+     * Check if the base directory exists
+     */
+    baseDirExists(): boolean;
+    /**
+     * Check if a specific config file exists
+     */
+    configExists(type: 'project' | 'awsTargets' | 'state' | 'mcp' | 'mcpDefs'): boolean;
+    /**
+     * Initialize the base directory and CLI system subdirectory.
+     * Requires that a baseDir was explicitly provided or a project was discovered.
+     */
+    initializeBaseDir(): Promise<void>;
+    /**
+     * Generic read and validate method
+     */
+    private readAndValidate;
+    /**
+     * Generic validate and write method
+     */
+    private validateAndWrite;
+}
+/**
+ * Create a new ConfigIO instance
+ */
+export declare function createConfigIO(pathConfig?: Partial<PathConfig>): ConfigIO;
+//# sourceMappingURL=config-io.d.ts.map

package/dist/lib/schemas/io/config-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-io.d.ts","sourceRoot":"","sources":["../../../../src/lib/schemas/io/config-io.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,EACd,MAAM,iBAAiB,CAAC;AAiBzB,OAAO,EAAkB,KAAK,UAAU,EAAE,YAAY,EAAkB,MAAM,iBAAiB,CAAC;AAOhG;;GAEG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAU;IAE5C;;;OAGG;gBACS,UAAU,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC;IAsB5C;;;OAGG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,eAAe,IAAI,YAAY;IAI/B;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIjC;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAKtD;;OAEG;IACG,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjE;;;;;OAKG;IACG,wBAAwB,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAiChE;;OAEG;IACG,yBAAyB,CAAC,IAAI,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3E;;;OAGG;IACG,iBAAiB,IAAI,OAAO,CAAC,aAAa,CAAC;IASjD;;;OAGG;IACG,kBAAkB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAS5D;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAK9C;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzD;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAKjD;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5D;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,YAAY,GAAG,OAAO,GAAG,KAAK,GAAG,SAAS,GAAG,OAAO;IAWnF;;;OAGG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBxC;;OAEG;YACW,eAAe;IAiC7B;;OAEG;YACW,gBAAgB;CA8B/B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,QAAQ,CAEzE"}