@aws/agentcore 0.14.0 → 0.14.1

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

@@ -1,3 +1,2 @@
-export * from './config';
 export * from './types';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC"}

package/dist/lib/errors/index.js

@@ -14,6 +14,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./config"), exports);
 __exportStar(require("./types"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/errors/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,0CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/errors/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB"}

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

@@ -1,63 +1,183 @@
+import { ZodError } from 'zod';
+export type ErrorSource = 'user' | 'client' | 'service' | 'unknown';
+export interface BaseErrorOptions extends ErrorOptions {
+    errorSource?: ErrorSource;
+}
+interface InternalErrorOptions extends BaseErrorOptions {
+    defaultSource: ErrorSource;
+}
+export declare abstract class BaseError extends Error {
+    readonly errorSource: ErrorSource;
+    protected constructor(message: string, options: InternalErrorOptions);
+}
+/**
+ * Converts an unknown thrown value to an Error instance.
+ * Use in catch blocks to ensure the error field is always an Error object.
+ */
+export declare function toError(err: unknown): Error;
 /**
  * Error indicating no agentcore project was found in the working directory.
  */
-export declare class NoProjectError extends Error {
-    constructor(message?: string);
+export declare class NoProjectError extends BaseError {
+    constructor(message?: string, options?: BaseErrorOptions);
 }
 /**
  * Error thrown when an agent with the same name already exists.
  */
-export declare class AgentAlreadyExistsError extends Error {
-    constructor(agentName: string);
+export declare class AgentAlreadyExistsError extends BaseError {
+    constructor(agentName: string, options?: BaseErrorOptions);
 }
 /**
  * Error indicating an AWS permissions failure (AccessDenied / AccessDeniedException).
  */
-export declare class AccessDeniedError extends Error {
-    constructor(message: string, options?: ErrorOptions);
+export declare class AccessDeniedError extends BaseError {
+    constructor(message: string, options?: BaseErrorOptions);
 }
 /**
  * Error indicating missing system dependencies required for an operation.
  */
-export declare class DependencyCheckError extends Error {
-    constructor(errors: string[]);
+export declare class DependencyCheckError extends BaseError {
+    constructor(errors: string[], options?: BaseErrorOptions);
 }
 /**
- * Error indicating git repository initialization failed.
+ * Error indicating a referenced resource could not be found.
  */
-export declare class GitInitError extends Error {
-    constructor(message: string);
+export declare class ResourceNotFoundError extends BaseError {
+    constructor(message: string, options?: BaseErrorOptions);
 }
 /**
- * Error indicating a referenced resource could not be found.
+ * Error indicating invalid input or configuration values.
  */
-export declare class ResourceNotFoundError extends Error {
-    constructor(message: string);
+export declare class ValidationError extends BaseError {
+    constructor(message: string, options?: BaseErrorOptions);
 }
-export declare class ValidationError extends Error {
-    constructor(message: string, options?: ErrorOptions);
+/**
+ * Error thrown when AWS credentials are not configured or invalid.
+ * Supports both a short message (for interactive mode) and detailed message (for CLI mode).
+ */
+export declare class AwsCredentialsError extends BaseError {
+    readonly shortMessage: string;
+    constructor(shortMessage: string, detailedMessage?: string, options?: BaseErrorOptions);
 }
 /**
- * Error indicating a network connection failure (e.g., server not reachable).
+ * Error indicating a packaging operation failed.
  */
-export declare class ConnectionError extends Error {
-    constructor(message: string, options?: ErrorOptions);
+export declare class PackagingError extends BaseError {
+    constructor(message: string, options?: BaseErrorOptions);
 }
 /**
- * Converts an unknown thrown value to an Error instance.
- * Use in catch blocks to ensure the error field is always an Error object.
+ * Error indicating the packaged artifact exceeds the size limit.
  */
-export declare function toError(err: unknown): Error;
+export declare class ArtifactSizeError extends PackagingError {
+    constructor(limitBytes: number, actualBytes: number, options?: BaseErrorOptions);
+}
+/**
+ * Error indicating a required binary or tool is not installed.
+ */
+export declare class MissingDependencyError extends PackagingError {
+    constructor(binary: string, installHint?: string, options?: BaseErrorOptions);
+}
+/**
+ * Error indicating a required project file is missing.
+ */
+export declare class MissingProjectFileError extends PackagingError {
+    constructor(filePath: string, options?: BaseErrorOptions);
+}
+/**
+ * Error indicating the project language is not supported for packaging.
+ */
+export declare class UnsupportedLanguageError extends PackagingError {
+    constructor(language: string, options?: BaseErrorOptions);
+}
+/**
+ * Base class for all config-related errors.
+ */
+export declare abstract class ConfigError extends BaseError {
+    protected constructor(message: string, options?: BaseErrorOptions);
+}
+/**
+ * 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);
+}
+/**
+ * Error indicating git repository initialization failed.
+ */
+export declare class GitInitError extends BaseError {
+    constructor(message: string, options?: BaseErrorOptions);
+}
 /**
  * Error indicating a resource conflict (e.g., already exists).
  */
-export declare class ConflictError extends Error {
-    constructor(message: string);
+export declare class ConflictError extends BaseError {
+    constructor(message: string, options?: BaseErrorOptions);
 }
 /**
  * Error indicating an operation timed out or exceeded retry limits.
  */
-export declare class TimeoutError extends Error {
-    constructor(message: string);
+export declare class TimeoutError extends BaseError {
+    constructor(message: string, options?: BaseErrorOptions);
+}
+/**
+ * Error thrown when the dev server returns a non-OK HTTP response.
+ */
+export declare class ServerError extends BaseError {
+    readonly statusCode: number;
+    constructor(statusCode: number, body: string, options?: BaseErrorOptions);
+}
+/**
+ * Error thrown when the connection to the dev server fails.
+ */
+export declare class ConnectionError extends BaseError {
+    constructor(message: string, options?: BaseErrorOptions);
+}
+/**
+ * Error indicating polling timed out.
+ */
+export declare class PollTimeoutError extends BaseError {
+    constructor(timeoutMs: number, options?: BaseErrorOptions);
+}
+/**
+ * Error indicating polling exhausted all retry attempts.
+ */
+export declare class PollExhaustedError extends BaseError {
+    constructor(maxAttempts: number, options?: BaseErrorOptions);
 }
+export {};
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/errors/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,CAAC,EAAE,MAAM;CAI7B;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,SAAS,EAAE,MAAM;CAI9B;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,MAAM,EAAE,MAAM,EAAE;CAI7B;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAE3C;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/errors/types.ts"],"names":[],"mappings":"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"}

package/dist/lib/errors/types.js

@@ -1,109 +1,284 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TimeoutError = exports.ConflictError = exports.ConnectionError = exports.ValidationError = exports.ResourceNotFoundError = exports.GitInitError = exports.DependencyCheckError = exports.AccessDeniedError = exports.AgentAlreadyExistsError = exports.NoProjectError = void 0;
+exports.PollExhaustedError = exports.PollTimeoutError = exports.ConnectionError = exports.ServerError = exports.TimeoutError = exports.ConflictError = exports.GitInitError = exports.ConfigParseError = exports.ConfigValidationError = exports.ConfigWriteError = exports.ConfigReadError = exports.ConfigNotFoundError = exports.ConfigError = exports.UnsupportedLanguageError = exports.MissingProjectFileError = exports.MissingDependencyError = exports.ArtifactSizeError = exports.PackagingError = exports.AwsCredentialsError = exports.ValidationError = exports.ResourceNotFoundError = exports.DependencyCheckError = exports.AccessDeniedError = exports.AgentAlreadyExistsError = exports.NoProjectError = exports.BaseError = void 0;
 exports.toError = toError;
+const zod_js_1 = require("./zod.js");
+class BaseError extends Error {
+    errorSource;
+    constructor(message, options) {
+        super(message, options);
+        this.name = this.constructor.name;
+        this.errorSource = options.errorSource ?? options.defaultSource;
+    }
+}
+exports.BaseError = BaseError;
+/**
+ * Converts an unknown thrown value to an Error instance.
+ * Use in catch blocks to ensure the error field is always an Error object.
+ */
+function toError(err) {
+    return err instanceof Error ? err : new Error(String(err));
+}
+// --- User errors ---
 /**
  * Error indicating no agentcore project was found in the working directory.
  */
-class NoProjectError extends Error {
-    constructor(message) {
-        super(message ?? 'No agentcore project found. Run "agentcore create" first.');
-        this.name = 'NoProjectError';
+class NoProjectError extends BaseError {
+    constructor(message, options) {
+        super(message ?? 'No agentcore project found. Run "agentcore create" first.', {
+            defaultSource: 'user',
+            ...options,
+        });
     }
 }
 exports.NoProjectError = NoProjectError;
 /**
  * Error thrown when an agent with the same name already exists.
  */
-class AgentAlreadyExistsError extends Error {
-    constructor(agentName) {
-        super(`An agent named "${agentName}" already exists in the schema.`);
-        this.name = 'AgentAlreadyExistsError';
+class AgentAlreadyExistsError extends BaseError {
+    constructor(agentName, options) {
+        super(`An agent named "${agentName}" already exists in the schema.`, { defaultSource: 'user', ...options });
     }
 }
 exports.AgentAlreadyExistsError = AgentAlreadyExistsError;
 /**
  * Error indicating an AWS permissions failure (AccessDenied / AccessDeniedException).
  */
-class AccessDeniedError extends Error {
+class AccessDeniedError extends BaseError {
     constructor(message, options) {
-        super(message, options);
-        this.name = 'AccessDeniedError';
+        super(message, { defaultSource: 'user', ...options });
     }
 }
 exports.AccessDeniedError = AccessDeniedError;
 /**
  * Error indicating missing system dependencies required for an operation.
  */
-class DependencyCheckError extends Error {
-    constructor(errors) {
-        super(errors.join('\n'));
-        this.name = 'DependencyCheckError';
+class DependencyCheckError extends BaseError {
+    constructor(errors, options) {
+        super(errors.join('\n'), { defaultSource: 'user', ...options });
     }
 }
 exports.DependencyCheckError = DependencyCheckError;
 /**
- * Error indicating git repository initialization failed.
+ * Error indicating a referenced resource could not be found.
  */
-class GitInitError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'GitInitError';
+class ResourceNotFoundError extends BaseError {
+    constructor(message, options) {
+        super(message, { defaultSource: 'user', ...options });
     }
 }
-exports.GitInitError = GitInitError;
+exports.ResourceNotFoundError = ResourceNotFoundError;
 /**
- * Error indicating a referenced resource could not be found.
+ * Error indicating invalid input or configuration values.
  */
-class ResourceNotFoundError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'ResourceNotFoundError';
+class ValidationError extends BaseError {
+    constructor(message, options) {
+        super(message, { defaultSource: 'user', ...options });
     }
 }
-exports.ResourceNotFoundError = ResourceNotFoundError;
-class ValidationError extends Error {
+exports.ValidationError = ValidationError;
+/**
+ * Error thrown when AWS credentials are not configured or invalid.
+ * Supports both a short message (for interactive mode) and detailed message (for CLI mode).
+ */
+class AwsCredentialsError extends BaseError {
+    shortMessage;
+    constructor(shortMessage, detailedMessage, options) {
+        super(detailedMessage ?? shortMessage, { defaultSource: 'user', ...options });
+        this.shortMessage = shortMessage;
+    }
+}
+exports.AwsCredentialsError = AwsCredentialsError;
+/**
+ * Error indicating a packaging operation failed.
+ */
+class PackagingError extends BaseError {
     constructor(message, options) {
-        super(message, options);
-        this.name = 'ValidationError';
+        super(message, { defaultSource: 'user', ...options });
     }
 }
-exports.ValidationError = ValidationError;
+exports.PackagingError = PackagingError;
+/**
+ * Error indicating the packaged artifact exceeds the size limit.
+ */
+class ArtifactSizeError extends PackagingError {
+    constructor(limitBytes, actualBytes, options) {
+        super(`Packaged artifact exceeds ${limitBytes} bytes (actual: ${actualBytes}).`, options);
+    }
+}
+exports.ArtifactSizeError = ArtifactSizeError;
+/**
+ * Error indicating a required binary or tool is not installed.
+ */
+class MissingDependencyError extends PackagingError {
+    constructor(binary, installHint, options) {
+        super(installHint ? `${binary} is required. ${installHint}` : `${binary} is required.`, options);
+    }
+}
+exports.MissingDependencyError = MissingDependencyError;
+/**
+ * Error indicating a required project file is missing.
+ */
+class MissingProjectFileError extends PackagingError {
+    constructor(filePath, options) {
+        super(`Required project file not found: ${filePath}`, options);
+    }
+}
+exports.MissingProjectFileError = MissingProjectFileError;
 /**
- * Error indicating a network connection failure (e.g., server not reachable).
+ * Error indicating the project language is not supported for packaging.
  */
-class ConnectionError extends Error {
+class UnsupportedLanguageError extends PackagingError {
+    constructor(language, options) {
+        super(`${language} packaging is not supported yet.`, options);
+    }
+}
+exports.UnsupportedLanguageError = UnsupportedLanguageError;
+// --- Config errors (user) ---
+/**
+ * Base class for all config-related errors.
+ */
+class ConfigError extends BaseError {
     constructor(message, options) {
-        super(message, options);
-        this.name = 'ConnectionError';
+        super(message, { defaultSource: 'user', ...options });
     }
 }
-exports.ConnectionError = ConnectionError;
+exports.ConfigError = ConfigError;
 /**
- * Converts an unknown thrown value to an Error instance.
- * Use in catch blocks to ensure the error field is always an Error object.
+ * Thrown when a config file doesn't exist.
  */
-function toError(err) {
-    return err instanceof Error ? err : new Error(String(err));
+class ConfigNotFoundError extends ConfigError {
+    filePath;
+    fileType;
+    constructor(filePath, fileType) {
+        super(`${fileType} config file not found at: ${filePath}`);
+        this.filePath = filePath;
+        this.fileType = fileType;
+    }
+}
+exports.ConfigNotFoundError = ConfigNotFoundError;
+/**
+ * Thrown when a config file can't be read.
+ */
+class ConfigReadError extends ConfigError {
+    filePath;
+    cause;
+    constructor(filePath, cause) {
+        const message = cause instanceof Error ? cause.message : String(cause);
+        super(`Failed to read config file at ${filePath}: ${message}`);
+        this.filePath = filePath;
+        this.cause = cause;
+    }
+}
+exports.ConfigReadError = ConfigReadError;
+/**
+ * Thrown when a config file can't be written.
+ */
+class ConfigWriteError extends ConfigError {
+    filePath;
+    cause;
+    constructor(filePath, cause) {
+        const message = cause instanceof Error ? cause.message : String(cause);
+        super(`Failed to write config file at ${filePath}: ${message}`);
+        this.filePath = filePath;
+        this.cause = cause;
+    }
+}
+exports.ConfigWriteError = ConfigWriteError;
+/**
+ * Thrown when config validation fails.
+ */
+class ConfigValidationError extends ConfigError {
+    filePath;
+    fileType;
+    zodError;
+    constructor(filePath, fileType, zodError) {
+        super(`${filePath}:\n${(0, zod_js_1.formatZodErrors)(zodError.issues)}`);
+        this.filePath = filePath;
+        this.fileType = fileType;
+        this.zodError = zodError;
+    }
+}
+exports.ConfigValidationError = ConfigValidationError;
+/**
+ * Thrown when JSON parsing fails.
+ */
+class ConfigParseError extends ConfigError {
+    filePath;
+    cause;
+    constructor(filePath, cause) {
+        const message = cause instanceof Error ? cause.message : String(cause);
+        super(`Failed to parse JSON in config file at ${filePath}: ${message}`);
+        this.filePath = filePath;
+        this.cause = cause;
+    }
+}
+exports.ConfigParseError = ConfigParseError;
+// --- Client errors ---
+/**
+ * Error indicating git repository initialization failed.
+ */
+class GitInitError extends BaseError {
+    constructor(message, options) {
+        super(message, { defaultSource: 'client', ...options });
+    }
 }
+exports.GitInitError = GitInitError;
+// --- Service errors ---
 /**
  * Error indicating a resource conflict (e.g., already exists).
  */
-class ConflictError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'ConflictError';
+class ConflictError extends BaseError {
+    constructor(message, options) {
+        super(message, { defaultSource: 'user', ...options });
     }
 }
 exports.ConflictError = ConflictError;
 /**
  * Error indicating an operation timed out or exceeded retry limits.
  */
-class TimeoutError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'TimeoutError';
+class TimeoutError extends BaseError {
+    constructor(message, options) {
+        super(message, { defaultSource: 'service', ...options });
     }
 }
 exports.TimeoutError = TimeoutError;
+/**
+ * Error thrown when the dev server returns a non-OK HTTP response.
+ */
+class ServerError extends BaseError {
+    statusCode;
+    constructor(statusCode, body, options) {
+        super(body || `Server returned ${statusCode}`, { defaultSource: 'client', ...options });
+        this.statusCode = statusCode;
+    }
+}
+exports.ServerError = ServerError;
+/**
+ * Error thrown when the connection to the dev server fails.
+ */
+class ConnectionError extends BaseError {
+    constructor(message, options) {
+        super(message, { defaultSource: 'client', ...options });
+    }
+}
+exports.ConnectionError = ConnectionError;
+/**
+ * Error indicating polling timed out.
+ */
+class PollTimeoutError extends BaseError {
+    constructor(timeoutMs, options) {
+        super(`Polling timed out after ${timeoutMs}ms`, { defaultSource: 'service', ...options });
+    }
+}
+exports.PollTimeoutError = PollTimeoutError;
+/**
+ * Error indicating polling exhausted all retry attempts.
+ */
+class PollExhaustedError extends BaseError {
+    constructor(maxAttempts, options) {
+        super(`Polling exhausted after ${maxAttempts} attempts`, { defaultSource: 'service', ...options });
+    }
+}
+exports.PollExhaustedError = PollExhaustedError;
 //# sourceMappingURL=types.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/errors/types.ts"],"names":[],"mappings":";;;AAiFA,0BAEC;AAnFD;;GAEG;AACH,MAAa,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAgB;QAC1B,KAAK,CAAC,OAAO,IAAI,2DAA2D,CAAC,CAAC;QAC9E,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AALD,wCAKC;AAED;;GAEG;AACH,MAAa,uBAAwB,SAAQ,KAAK;IAChD,YAAY,SAAiB;QAC3B,KAAK,CAAC,mBAAmB,SAAS,iCAAiC,CAAC,CAAC;QACrE,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AALD,0DAKC;AAED;;GAEG;AACH,MAAa,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AALD,8CAKC;AAED;;GAEG;AACH,MAAa,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,MAAgB;QAC1B,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AALD,oDAKC;AAED;;GAEG;AACH,MAAa,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AALD,oCAKC;AAED;;GAEG;AACH,MAAa,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AALD,sDAKC;AAED,MAAa,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AALD,0CAKC;AAED;;GAEG;AACH,MAAa,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AALD,0CAKC;AAED;;;GAGG;AACH,SAAgB,OAAO,CAAC,GAAY;IAClC,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,MAAa,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AALD,sCAKC;AAED;;GAEG;AACH,MAAa,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AALD,oCAKC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/errors/types.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,8 @@
+/**
+ * Zod error formatting utilities for human-readable validation messages.
+ */
+/**
+ * Format all issues from a ZodError into a newline-separated list.
+ */
+export declare function formatZodErrors(issues: unknown[]): string;
+//# sourceMappingURL=zod.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"zod.d.ts","sourceRoot":"","sources":["../../../src/lib/errors/zod.ts"],"names":[],"mappings":"AAAA;;GAEG;AA8GH;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAEzD"}