@aws/agentcore 0.13.1 → 0.14.1

package/dist/schema/schemas/primitives/memory.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MemoryStrategySchema = exports.MemoryStrategyNameSchema = exports.DEFAULT_EPISODIC_REFLECTION_NAMESPACES = exports.DEFAULT_STRATEGY_NAMESPACES = exports.MemoryStrategyTypeSchema = void 0;
+exports.MemoryStrategySchema = exports.MemoryStrategyNameSchema = exports.DEFAULT_EPISODIC_REFLECTION_NAMESPACES = exports.DEFAULT_EPISODIC_REFLECTION_NAMESPACE_TEMPLATES = exports.DEFAULT_STRATEGY_NAMESPACES = exports.DEFAULT_STRATEGY_NAMESPACE_TEMPLATES = exports.MemoryStrategyTypeSchema = void 0;
 const zod_1 = require("zod");
 // ============================================================================
 // Memory Strategy Types
@@ -16,20 +16,30 @@ const zod_1 = require("zod");
  */
 exports.MemoryStrategyTypeSchema = zod_1.z.enum(['SEMANTIC', 'SUMMARIZATION', 'USER_PREFERENCE', 'EPISODIC']);
 /**
- * Default namespaces for each memory strategy type.
+ * Default namespace templates for each memory strategy type.
  * These match the patterns generated in CLI session.py templates.
  */
-exports.DEFAULT_STRATEGY_NAMESPACES = {
+exports.DEFAULT_STRATEGY_NAMESPACE_TEMPLATES = {
     SEMANTIC: ['/users/{actorId}/facts'],
     USER_PREFERENCE: ['/users/{actorId}/preferences'],
     SUMMARIZATION: ['/summaries/{actorId}/{sessionId}'],
     EPISODIC: ['/episodes/{actorId}/{sessionId}'],
 };
 /**
- * Default reflection namespaces for the EPISODIC strategy.
- * The service requires reflection namespaces to be the same as or a prefix of episode namespaces.
+ * @deprecated Use {@link DEFAULT_STRATEGY_NAMESPACE_TEMPLATES} instead.
+ * Retained as an alias for backward compatibility.
  */
-exports.DEFAULT_EPISODIC_REFLECTION_NAMESPACES = ['/episodes/{actorId}'];
+exports.DEFAULT_STRATEGY_NAMESPACES = exports.DEFAULT_STRATEGY_NAMESPACE_TEMPLATES;
+/**
+ * Default reflection namespace templates for the EPISODIC strategy.
+ * The service requires reflection templates to be the same as or a prefix of episode templates.
+ */
+exports.DEFAULT_EPISODIC_REFLECTION_NAMESPACE_TEMPLATES = ['/episodes/{actorId}'];
+/**
+ * @deprecated Use {@link DEFAULT_EPISODIC_REFLECTION_NAMESPACE_TEMPLATES} instead.
+ * Retained as an alias for backward compatibility.
+ */
+exports.DEFAULT_EPISODIC_REFLECTION_NAMESPACES = exports.DEFAULT_EPISODIC_REFLECTION_NAMESPACE_TEMPLATES;
 /**
  * Memory strategy name validation.
  * Pattern: ^[a-zA-Z][a-zA-Z0-9_]{0,47}$
@@ -43,6 +53,12 @@ exports.MemoryStrategyNameSchema = zod_1.z
 /**
  * Memory strategy configuration.
  * Each memory can have multiple strategies with optional namespace scoping.
+ *
+ * Field naming:
+ * - `namespaceTemplates` / `reflectionNamespaceTemplates` are the preferred field names.
+ * - `namespaces` / `reflectionNamespaces` are deprecated aliases retained for backward
+ *   compatibility. Specifying both the deprecated and preferred form for the same concept
+ *   is rejected by validation.
  */
 exports.MemoryStrategySchema = zod_1.z
     .object({
@@ -52,22 +68,47 @@ exports.MemoryStrategySchema = zod_1.z
     name: exports.MemoryStrategyNameSchema.optional(),
     /** Optional description */
     description: zod_1.z.string().optional(),
-    /** Optional namespaces for scoping memory access */
+    /** Optional namespace templates for scoping memory access */
+    namespaceTemplates: zod_1.z.array(zod_1.z.string()).optional(),
+    /** @deprecated Use `namespaceTemplates` instead. */
     namespaces: zod_1.z.array(zod_1.z.string()).optional(),
-    /** Reflection namespaces for EPISODIC strategy. Required by the service for episodic strategies. */
+    /** Reflection namespace templates for EPISODIC strategy. Required by the service for episodic strategies. */
+    reflectionNamespaceTemplates: zod_1.z.array(zod_1.z.string()).optional(),
+    /** @deprecated Use `reflectionNamespaceTemplates` instead. */
     reflectionNamespaces: zod_1.z.array(zod_1.z.string()).optional(),
 })
-    .refine(strategy => strategy.type !== 'EPISODIC' ||
-    (strategy.reflectionNamespaces !== undefined && strategy.reflectionNamespaces.length > 0), {
-    message: 'EPISODIC strategy requires reflectionNamespaces',
-    path: ['reflectionNamespaces'],
+    .refine(strategy => !((strategy.namespaces?.length ?? 0) > 0 && (strategy.namespaceTemplates?.length ?? 0) > 0), {
+    message: "'namespaces' and 'namespaceTemplates' are mutually exclusive. Prefer 'namespaceTemplates' ('namespaces' is deprecated).",
+    path: ['namespaceTemplates'],
+})
+    .refine(strategy => !((strategy.reflectionNamespaces?.length ?? 0) > 0 && (strategy.reflectionNamespaceTemplates?.length ?? 0) > 0), {
+    message: "'reflectionNamespaces' and 'reflectionNamespaceTemplates' are mutually exclusive. Prefer 'reflectionNamespaceTemplates' ('reflectionNamespaces' is deprecated).",
+    path: ['reflectionNamespaceTemplates'],
+})
+    .refine(strategy => strategy.type === 'EPISODIC' ||
+    (strategy.reflectionNamespaceTemplates === undefined && strategy.reflectionNamespaces === undefined), {
+    message: "'reflectionNamespaceTemplates' is only allowed on EPISODIC strategies",
+    path: ['reflectionNamespaceTemplates'],
 })
     .refine(strategy => {
-    if (strategy.type !== 'EPISODIC' || !strategy.reflectionNamespaces || !strategy.namespaces)
+    if (strategy.type !== 'EPISODIC')
+        return true;
+    const reflection = strategy.reflectionNamespaceTemplates ?? strategy.reflectionNamespaces;
+    return reflection !== undefined && reflection.length > 0;
+}, {
+    message: 'EPISODIC strategy requires reflectionNamespaceTemplates',
+    path: ['reflectionNamespaceTemplates'],
+})
+    .refine(strategy => {
+    if (strategy.type !== 'EPISODIC')
+        return true;
+    const reflection = strategy.reflectionNamespaceTemplates ?? strategy.reflectionNamespaces;
+    const templates = strategy.namespaceTemplates ?? strategy.namespaces;
+    if (!reflection || !templates)
         return true;
-    return strategy.reflectionNamespaces.every(ref => strategy.namespaces.some(ns => ns.startsWith(ref)));
+    return reflection.every(ref => templates.some(ns => ns.startsWith(ref)));
 }, {
-    message: 'Each reflectionNamespace must be a prefix of at least one namespace',
-    path: ['reflectionNamespaces'],
+    message: 'Each reflectionNamespaceTemplate must be a prefix of at least one namespaceTemplate',
+    path: ['reflectionNamespaceTemplates'],
 });
 //# sourceMappingURL=memory.js.map

package/dist/schema/schemas/primitives/memory.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../../src/schema/schemas/primitives/memory.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E;;;;;;;;GAQG;AACU,QAAA,wBAAwB,GAAG,OAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,eAAe,EAAE,iBAAiB,EAAE,UAAU,CAAC,CAAC,CAAC;AAG7G;;;GAGG;AACU,QAAA,2BAA2B,GAAkD;IACxF,QAAQ,EAAE,CAAC,wBAAwB,CAAC;IACpC,eAAe,EAAE,CAAC,8BAA8B,CAAC;IACjD,aAAa,EAAE,CAAC,kCAAkC,CAAC;IACnD,QAAQ,EAAE,CAAC,iCAAiC,CAAC;CAC9C,CAAC;AAEF;;;GAGG;AACU,QAAA,sCAAsC,GAAa,CAAC,qBAAqB,CAAC,CAAC;AAExF;;;;GAIG;AACU,QAAA,wBAAwB,GAAG,OAAC;KACtC,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,EAAE,CAAC;KACP,KAAK,CACJ,8BAA8B,EAC9B,kGAAkG,CACnG,CAAC;AAEJ;;;GAGG;AACU,QAAA,oBAAoB,GAAG,OAAC;KAClC,MAAM,CAAC;IACN,oBAAoB;IACpB,IAAI,EAAE,gCAAwB;IAC9B,4CAA4C;IAC5C,IAAI,EAAE,gCAAwB,CAAC,QAAQ,EAAE;IACzC,2BAA2B;IAC3B,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,oDAAoD;IACpD,UAAU,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC1C,oGAAoG;IACpG,oBAAoB,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACrD,CAAC;KACD,MAAM,CACL,QAAQ,CAAC,EAAE,CACT,QAAQ,CAAC,IAAI,KAAK,UAAU;IAC5B,CAAC,QAAQ,CAAC,oBAAoB,KAAK,SAAS,IAAI,QAAQ,CAAC,oBAAoB,CAAC,MAAM,GAAG,CAAC,CAAC,EAC3F;IACE,OAAO,EAAE,iDAAiD;IAC1D,IAAI,EAAE,CAAC,sBAAsB,CAAC;CAC/B,CACF;KACA,MAAM,CACL,QAAQ,CAAC,EAAE;IACT,IAAI,QAAQ,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,QAAQ,CAAC,oBAAoB,IAAI,CAAC,QAAQ,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IACxG,OAAO,QAAQ,CAAC,oBAAoB,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,UAAW,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACzG,CAAC,EACD;IACE,OAAO,EAAE,qEAAqE;IAC9E,IAAI,EAAE,CAAC,sBAAsB,CAAC;CAC/B,CACF,CAAC"}
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../../src/schema/schemas/primitives/memory.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aws/agentcore",
-  "version": "0.13.1",
+  "version": "0.14.1",
   "description": "CLI for Amazon Bedrock AgentCore",
   "license": "Apache-2.0",
   "repository": {
@@ -64,7 +64,7 @@
     "test": "vitest run --project unit",
     "test:all": "vitest run",
     "test:watch": "vitest --project unit",
-    "test:integ": "vitest run --project integ",
+    "test:integ": "npm run build && vitest run --project integ",
     "test:unit": "vitest run --project unit --coverage",
     "test:e2e": "vitest run --project e2e",
     "test:update-snapshots": "vitest run --project unit --update",
@@ -78,19 +78,20 @@
     "@aws-sdk/client-bedrock": "^3.1012.0",
     "@aws-sdk/client-bedrock-agent": "^3.1012.0",
     "@aws-sdk/client-bedrock-agentcore": "^3.1020.0",
-    "@aws-sdk/client-bedrock-agentcore-control": "^3.1020.0",
+    "@aws-sdk/client-bedrock-agentcore-control": "^3.1039.0",
     "@aws-sdk/client-bedrock-runtime": "^3.893.0",
     "@aws-sdk/client-cloudformation": "^3.893.0",
     "@aws-sdk/client-cloudwatch-logs": "^3.893.0",
     "@aws-sdk/client-resource-groups-tagging-api": "^3.893.0",
     "@aws-sdk/client-s3": "^3.1012.0",
     "@aws-sdk/client-sts": "^3.893.0",
+    "@aws-sdk/region-config-resolver": "^3.972.13",
     "@aws-sdk/client-xray": "^3.1003.0",
     "@aws-sdk/credential-providers": "^3.893.0",
-    "@aws/agent-inspector": "0.3.0",
+    "@aws/agent-inspector": "0.4.2",
     "@commander-js/extra-typings": "^14.0.0",
     "@opentelemetry/api": "^1.9.1",
-    "@opentelemetry/exporter-metrics-otlp-http": "^0.214.0",
+    "@opentelemetry/exporter-metrics-otlp-http": "^0.215.0",
     "@opentelemetry/otlp-transformer": "^0.213.0",
     "@opentelemetry/resources": "^2.6.1",
     "@opentelemetry/sdk-metrics": "^2.6.1",
@@ -142,6 +143,7 @@
     "node-pty": "^1.1.0",
     "prettier": "^3.7.4",
     "secretlint": "^12.2.0",
+    "strip-ansi": "^7.2.0",
     "tsx": "^4.21.0",
     "typescript": "^5",
     "typescript-eslint": "^8.50.1",
@@ -149,15 +151,15 @@
   },
   "overridesComments": {
     "minimatch": "GHSA-7r86-cg39-jmmj, GHSA-23c5-xmqv-rm74: minimatch 10.0.0-10.2.2 has ReDoS vulnerabilities. Multiple transitive deps (eslint, typescript-eslint, eslint-plugin-import, eslint-plugin-react, prettier-plugin-sort-imports, aws-cdk-lib) pin older versions. Remove this override once upstream packages update their minimatch dependency to >=10.2.3.",
+    "glob": "glob <12 is deprecated and emits npm install warnings (https://github.com/isaacs/node-glob). Pulled in transitively via archiver-utils@5.0.2 (latest), which still pins glob@^10.0.0. archiver-utils only uses glob.sync(pattern, options), which remains compatible in glob@13. Remove this override once archiver-utils updates its glob dependency.",
     "fast-xml-parser": "GHSA-8gc5-j5rx-235r, GHSA-jp2q-39xq-3w4g: fast-xml-parser <=5.5.6 has entity expansion bypass (CVE-2026-33036, CVE-2026-33349). Transitive via @aws-sdk/xml-builder. Remove once @aws-sdk updates to fast-xml-parser >=5.5.7.",
-    "@aws-sdk/xml-builder": "aws/aws-sdk-js-v3#7867: @aws-sdk/xml-builder <3.972.14 does not configure maxTotalExpansions on fast-xml-parser, causing 'Entity expansion limit exceeded' on large CloudFormation responses. Remove once @aws-sdk/client-* deps are bumped past 3.972.14.",
-    "glob": "glob <12 is deprecated and emits npm install warnings (https://github.com/isaacs/node-glob). Pulled in transitively via archiver-utils@5.0.2 (latest), which still pins glob@^10.0.0. archiver-utils only uses glob.sync(pattern, options), which remains compatible in glob@13. Remove this override once archiver-utils updates its glob dependency."
+    "@aws-sdk/xml-builder": "aws/aws-sdk-js-v3#7867: @aws-sdk/xml-builder <3.972.14 does not configure maxTotalExpansions on fast-xml-parser, causing 'Entity expansion limit exceeded' on large CloudFormation responses. Remove once @aws-sdk/client-* deps are bumped past 3.972.14."
   },
   "overrides": {
     "minimatch": "10.2.4",
+    "glob": "^13.0.0",
     "fast-xml-parser": "5.5.7",
-    "@aws-sdk/xml-builder": "3.972.15",
-    "glob": "^13.0.0"
+    "@aws-sdk/xml-builder": "3.972.15"
   },
   "engines": {
     "node": ">=20"

package/scripts/bump-version.ts

@@ -218,11 +218,11 @@ function categorizeCommits(gitLog: string): CategorizedChanges {
 
     const msg = trimmed.slice(2).trim();
 
-    if (msg.startsWith('feat:') || msg.startsWith('feature:')) {
+    if (/^(feat|feature)(\(.*?\))?:/.test(msg)) {
       result.features.push(msg);
-    } else if (msg.startsWith('fix:') || msg.startsWith('bugfix:')) {
+    } else if (/^(fix|bugfix)(\(.*?\))?:/.test(msg)) {
       result.fixes.push(msg);
-    } else if (msg.startsWith('docs:') || msg.startsWith('doc:')) {
+    } else if (/^docs?(\(.*?\))?:/.test(msg)) {
       result.docs.push(msg);
     } else {
       result.other.push(msg);

package/scripts/run-e2e-dev.sh

@@ -0,0 +1,56 @@
+#!/usr/bin/env bash
+# Run E2E tests against your dev account using local credentials.
+#
+# Usage:
+#   ./scripts/run-e2e-dev.sh                          # runs strands-bedrock.test.ts
+#   ./scripts/run-e2e-dev.sh --all                    # runs the full e2e suite
+#   ./scripts/run-e2e-dev.sh e2e-tests/foo.test.ts    # runs a specific test file
+
+set -euo pipefail
+
+REGION="${AWS_REGION:-us-east-1}"
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+# ── Parse arguments ────────────────────────────────────────────────────────────
+RUN_ALL=false
+TEST_FILES=()
+for arg in "$@"; do
+  if [[ "$arg" == "--all" ]]; then
+    RUN_ALL=true
+  else
+    TEST_FILES+=("$arg")
+  fi
+done
+
+# ── Build & install CLI from source ────────────────────────────────────────────
+cd "$REPO_ROOT"
+npm run build
+TARBALL=$(npm pack | tail -1)
+npm install -g "$TARBALL"
+echo "=== Installed: $(agentcore --version) ==="
+
+# ── Set env vars for tests ─────────────────────────────────────────────────────
+export AWS_REGION="$REGION"
+export AWS_ACCOUNT_ID=$(aws sts get-caller-identity --query Account --output text)
+
+# ── Run tests ──────────────────────────────────────────────────────────────────
+cd "$REPO_ROOT"
+
+EXCLUDE_API_KEY_TESTS=(
+  --exclude 'e2e-tests/*-anthropic*'
+  --exclude 'e2e-tests/*-openai*'
+  --exclude 'e2e-tests/*-gemini*'
+)
+
+if [[ "$RUN_ALL" == "true" ]]; then
+  echo "=== Running full e2e suite ==="
+  npx vitest run --project e2e
+elif [[ ${#TEST_FILES[@]} -gt 0 ]]; then
+  echo "=== Running: ${TEST_FILES[*]} ==="
+  npx vitest run --project e2e "${TEST_FILES[@]}"
+else
+  echo "=== Running all Bedrock/IAM tests (excluding API-key-dependent tests) ==="
+  npx vitest run --project e2e "${EXCLUDE_API_KEY_TESTS[@]}"
+fi

package/scripts/run-e2e-local.sh

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# Run E2E tests locally, replicating the GitHub Actions e2e-tests.yml workflow.
+# Run E2E tests locally in the CI account, replicating the GitHub Actions e2e-tests.yml workflow.
 #
 # Required env vars:
 #   E2E_ROLE_ARN    — IAM role ARN to assume (grants access to the test account)

package/dist/lib/errors/config.d.ts

@@ -1,49 +0,0 @@
-import { ZodError } from 'zod';
-/**
- * Base class for all config-related errors
- */
-export declare abstract class ConfigError extends Error {
-    protected constructor(message: string);
-}
-/**
- * Thrown when a config file doesn't exist
- */
-export declare class ConfigNotFoundError extends ConfigError {
-    readonly filePath: string;
-    readonly fileType: string;
-    constructor(filePath: string, fileType: string);
-}
-/**
- * Thrown when a config file can't be read
- */
-export declare class ConfigReadError extends ConfigError {
-    readonly filePath: string;
-    readonly cause: unknown;
-    constructor(filePath: string, cause: unknown);
-}
-/**
- * Thrown when a config file can't be written
- */
-export declare class ConfigWriteError extends ConfigError {
-    readonly filePath: string;
-    readonly cause: unknown;
-    constructor(filePath: string, cause: unknown);
-}
-/**
- * Thrown when config validation fails
- */
-export declare class ConfigValidationError extends ConfigError {
-    readonly filePath: string;
-    readonly fileType: string;
-    readonly zodError: ZodError;
-    constructor(filePath: string, fileType: string, zodError: ZodError);
-}
-/**
- * Thrown when JSON parsing fails
- */
-export declare class ConfigParseError extends ConfigError {
-    readonly filePath: string;
-    readonly cause: unknown;
-    constructor(filePath: string, cause: unknown);
-}
-//# sourceMappingURL=config.d.ts.map

package/dist/lib/errors/config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/lib/errors/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAE/B;;GAEG;AACH,8BAAsB,WAAY,SAAQ,KAAK;IAC7C,SAAS,aAAa,OAAO,EAAE,MAAM;CAKtC;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,WAAW;aAEhC,QAAQ,EAAE,MAAM;aAChB,QAAQ,EAAE,MAAM;gBADhB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM;CAInC;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,WAAW;aAE5B,QAAQ,EAAE,MAAM;aACP,KAAK,EAAE,OAAO;gBADvB,QAAQ,EAAE,MAAM,EACP,KAAK,EAAE,OAAO;CAK1C;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,WAAW;aAE7B,QAAQ,EAAE,MAAM;aACP,KAAK,EAAE,OAAO;gBADvB,QAAQ,EAAE,MAAM,EACP,KAAK,EAAE,OAAO;CAK1C;AA8GD;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,WAAW;aAElC,QAAQ,EAAE,MAAM;aAChB,QAAQ,EAAE,MAAM;aAChB,QAAQ,EAAE,QAAQ;gBAFlB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,QAAQ;CAKrC;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,WAAW;aAE7B,QAAQ,EAAE,MAAM;aACP,KAAK,EAAE,OAAO;gBADvB,QAAQ,EAAE,MAAM,EACP,KAAK,EAAE,OAAO;CAK1C"}

package/dist/lib/errors/config.js.map

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

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

@@ -1,16 +0,0 @@
-export declare class PackagingError extends Error {
-    constructor(message: string);
-}
-export declare class MissingDependencyError extends PackagingError {
-    constructor(binary: string, installHint?: string);
-}
-export declare class MissingProjectFileError extends PackagingError {
-    constructor(filePath: string);
-}
-export declare class UnsupportedLanguageError extends PackagingError {
-    constructor(language: string);
-}
-export declare class ArtifactSizeError extends PackagingError {
-    constructor(limitBytes: number, actualBytes: number);
-}
-//# sourceMappingURL=errors.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/lib/packaging/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAK5B;AAED,qBAAa,sBAAuB,SAAQ,cAAc;gBAC5C,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;CAGjD;AAED,qBAAa,uBAAwB,SAAQ,cAAc;gBAC7C,QAAQ,EAAE,MAAM;CAG7B;AAED,qBAAa,wBAAyB,SAAQ,cAAc;gBAC9C,QAAQ,EAAE,MAAM;CAG7B;AAED,qBAAa,iBAAkB,SAAQ,cAAc;gBACvC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;CAGpD"}

package/dist/lib/packaging/errors.js

@@ -1,36 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ArtifactSizeError = exports.UnsupportedLanguageError = exports.MissingProjectFileError = exports.MissingDependencyError = exports.PackagingError = void 0;
-class PackagingError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = this.constructor.name;
-        Error.captureStackTrace(this, this.constructor);
-    }
-}
-exports.PackagingError = PackagingError;
-class MissingDependencyError extends PackagingError {
-    constructor(binary, installHint) {
-        super(installHint ? `${binary} is required. ${installHint}` : `${binary} is required.`);
-    }
-}
-exports.MissingDependencyError = MissingDependencyError;
-class MissingProjectFileError extends PackagingError {
-    constructor(filePath) {
-        super(`Required project file not found: ${filePath}`);
-    }
-}
-exports.MissingProjectFileError = MissingProjectFileError;
-class UnsupportedLanguageError extends PackagingError {
-    constructor(language) {
-        super(`${language} packaging is not supported yet.`);
-    }
-}
-exports.UnsupportedLanguageError = UnsupportedLanguageError;
-class ArtifactSizeError extends PackagingError {
-    constructor(limitBytes, actualBytes) {
-        super(`Packaged artifact exceeds ${limitBytes} bytes (actual: ${actualBytes}).`);
-    }
-}
-exports.ArtifactSizeError = ArtifactSizeError;
-//# sourceMappingURL=errors.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/lib/packaging/errors.ts"],"names":[],"mappings":";;;AAAA,MAAa,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;CACF;AAND,wCAMC;AAED,MAAa,sBAAuB,SAAQ,cAAc;IACxD,YAAY,MAAc,EAAE,WAAoB;QAC9C,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,iBAAiB,WAAW,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,eAAe,CAAC,CAAC;IAC1F,CAAC;CACF;AAJD,wDAIC;AAED,MAAa,uBAAwB,SAAQ,cAAc;IACzD,YAAY,QAAgB;QAC1B,KAAK,CAAC,oCAAoC,QAAQ,EAAE,CAAC,CAAC;IACxD,CAAC;CACF;AAJD,0DAIC;AAED,MAAa,wBAAyB,SAAQ,cAAc;IAC1D,YAAY,QAAgB;QAC1B,KAAK,CAAC,GAAG,QAAQ,kCAAkC,CAAC,CAAC;IACvD,CAAC;CACF;AAJD,4DAIC;AAED,MAAa,iBAAkB,SAAQ,cAAc;IACnD,YAAY,UAAkB,EAAE,WAAmB;QACjD,KAAK,CAAC,6BAA6B,UAAU,mBAAmB,WAAW,IAAI,CAAC,CAAC;IACnF,CAAC;CACF;AAJD,8CAIC"}