@aws/agentcore 1.0.0-preview.2 → 1.0.0-preview.20

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

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

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

@@ -0,0 +1,259 @@
+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 BaseError {
+    constructor(message?: string, options?: BaseErrorOptions);
+}
+/**
+ * Error thrown when an agent with the same name already exists.
+ */
+export declare class AgentAlreadyExistsError extends BaseError {
+    constructor(agentName: string, options?: BaseErrorOptions);
+}
+/**
+ * Error indicating an AWS permissions failure (AccessDenied / AccessDeniedException).
+ */
+export declare class AccessDeniedError extends BaseError {
+    constructor(message: string, options?: BaseErrorOptions);
+}
+/**
+ * Error thrown when a secret value cannot be encrypted before writing to disk
+ * (e.g. the machine encryption key could not be created/read).
+ */
+export declare class SecretEncryptionError extends BaseError {
+    constructor(message: string, options?: BaseErrorOptions);
+}
+/**
+ * Error thrown when a stored secret value cannot be decrypted (missing/changed
+ * machine key, or corrupted ciphertext).
+ */
+export declare class SecretDecryptionError extends BaseError {
+    constructor(message: string, options?: BaseErrorOptions);
+}
+/**
+ * Error indicating missing system dependencies required for an operation.
+ */
+export declare class DependencyCheckError extends BaseError {
+    constructor(errors: string[], options?: BaseErrorOptions);
+}
+/**
+ * Error indicating a referenced resource could not be found.
+ */
+export declare class ResourceNotFoundError extends BaseError {
+    constructor(message: string, options?: BaseErrorOptions);
+}
+/**
+ * Error indicating a job (recommendation / batch evaluation) was not found locally or on the service.
+ */
+export declare class JobNotFoundError extends BaseError {
+    constructor(message: string, options?: BaseErrorOptions);
+}
+/**
+ * Error indicating invalid input or configuration values.
+ */
+export declare class ValidationError extends BaseError {
+    constructor(message: string, options?: BaseErrorOptions);
+}
+/**
+ * Error thrown when CDK synth fails because the project's installed `@aws/agentcore-cdk`
+ * construct is older than the running CLI and rejects a config key the CLI legitimately writes.
+ *
+ * The CLI strict-validates agentcore.json against its own schema during preflight, *before*
+ * synth. So an "unknown keys (remove)" failure reaching synth proves the key is valid to the
+ * CLI but unknown to the older bundled construct — i.e. version skew, not a bad config.
+ */
+export declare class StaleCdkConstructError extends BaseError {
+    constructor(rejectedKeys: string[], installedVersion: string | undefined, options?: BaseErrorOptions);
+}
+/**
+ * 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 thrown when non-AWS credentials are missing but required.. (ex. API Keys)
+ */
+export declare class MissingCredentialsError extends BaseError {
+    constructor(message: string, options?: BaseErrorOptions);
+}
+/**
+ * Error indicating a packaging operation failed.
+ */
+export declare class PackagingError extends BaseError {
+    constructor(message: string, options?: BaseErrorOptions);
+}
+/**
+ * Error indicating the packaged artifact exceeds the size limit.
+ */
+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.
+ */
+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 BaseError {
+    constructor(message: string, options?: BaseErrorOptions);
+}
+/**
+ * Error indicating an operation timed out or exceeded retry limits.
+ */
+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 DevServerError 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 DevServerConnectionError extends BaseError {
+    constructor(message: string, options?: BaseErrorOptions);
+}
+/**
+ * Error indicating an AWS service gave back a 5xx or malforned response.
+ */
+export declare class ServiceError extends BaseError {
+    constructor(message: string, options?: BaseErrorOptions);
+}
+/**
+ * Error indicating a request was throttled or rate-limited.
+ */
+export declare class ThrottlingError extends BaseError {
+    constructor(message: string, options?: BaseErrorOptions);
+}
+/**
+ * Error indicating a service quota or limit was exceeded.
+ */
+export declare class ServiceQuotaError 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);
+}
+/**
+ * Thrown when starting or driving a Bedrock Knowledge Base ingestion job
+ * fails. Default source is 'service' because most ingestion failures are
+ * AWS-side (validation, throttling, KB not ready). Pre-flight failures from
+ * the CLI side (KB not deployed, no data sources recorded) override to 'user'.
+ */
+export declare class IngestionError extends BaseError {
+    constructor(message: string, options?: BaseErrorOptions);
+}
+export declare class ShellKickedError extends BaseError {
+    constructor(options?: BaseErrorOptions);
+}
+/**
+ * Error indicating user cancellation interuption
+ */
+export declare class UserCancellationError extends BaseError {
+    constructor(options?: BaseErrorOptions);
+}
+export declare class ExportHarnessError extends BaseError {
+    constructor(message: string, options?: BaseErrorOptions);
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,402 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExportHarnessError = exports.UserCancellationError = exports.ShellKickedError = exports.IngestionError = exports.PollExhaustedError = exports.PollTimeoutError = exports.ServiceQuotaError = exports.ThrottlingError = exports.ServiceError = exports.DevServerConnectionError = exports.DevServerError = exports.TimeoutError = exports.ConflictError = exports.GitInitError = exports.ConfigParseError = exports.ConfigValidationError = exports.ConfigWriteError = exports.ConfigReadError = exports.ConfigNotFoundError = exports.UnsupportedLanguageError = exports.MissingProjectFileError = exports.MissingDependencyError = exports.ArtifactSizeError = exports.PackagingError = exports.MissingCredentialsError = exports.AwsCredentialsError = exports.StaleCdkConstructError = exports.ValidationError = exports.JobNotFoundError = exports.ResourceNotFoundError = exports.DependencyCheckError = exports.SecretDecryptionError = exports.SecretEncryptionError = 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 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 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 BaseError {
+    constructor(message, options) {
+        super(message, { defaultSource: 'user', ...options });
+    }
+}
+exports.AccessDeniedError = AccessDeniedError;
+/**
+ * Error thrown when a secret value cannot be encrypted before writing to disk
+ * (e.g. the machine encryption key could not be created/read).
+ */
+class SecretEncryptionError extends BaseError {
+    constructor(message, options) {
+        super(message, { defaultSource: 'client', ...options });
+    }
+}
+exports.SecretEncryptionError = SecretEncryptionError;
+/**
+ * Error thrown when a stored secret value cannot be decrypted (missing/changed
+ * machine key, or corrupted ciphertext).
+ */
+class SecretDecryptionError extends BaseError {
+    constructor(message, options) {
+        super(message, { defaultSource: 'user', ...options });
+    }
+}
+exports.SecretDecryptionError = SecretDecryptionError;
+/**
+ * Error indicating missing system dependencies required for an operation.
+ */
+class DependencyCheckError extends BaseError {
+    constructor(errors, options) {
+        super(errors.join('\n'), { defaultSource: 'user', ...options });
+    }
+}
+exports.DependencyCheckError = DependencyCheckError;
+/**
+ * Error indicating a referenced resource could not be found.
+ */
+class ResourceNotFoundError extends BaseError {
+    constructor(message, options) {
+        super(message, { defaultSource: 'user', ...options });
+    }
+}
+exports.ResourceNotFoundError = ResourceNotFoundError;
+/**
+ * Error indicating a job (recommendation / batch evaluation) was not found locally or on the service.
+ */
+class JobNotFoundError extends BaseError {
+    constructor(message, options) {
+        super(message, { defaultSource: 'user', ...options });
+    }
+}
+exports.JobNotFoundError = JobNotFoundError;
+/**
+ * Error indicating invalid input or configuration values.
+ */
+class ValidationError extends BaseError {
+    constructor(message, options) {
+        super(message, { defaultSource: 'user', ...options });
+    }
+}
+exports.ValidationError = ValidationError;
+/**
+ * Error thrown when CDK synth fails because the project's installed `@aws/agentcore-cdk`
+ * construct is older than the running CLI and rejects a config key the CLI legitimately writes.
+ *
+ * The CLI strict-validates agentcore.json against its own schema during preflight, *before*
+ * synth. So an "unknown keys (remove)" failure reaching synth proves the key is valid to the
+ * CLI but unknown to the older bundled construct — i.e. version skew, not a bad config.
+ */
+class StaleCdkConstructError extends BaseError {
+    constructor(rejectedKeys, installedVersion, options) {
+        const keyList = rejectedKeys.map(k => `"${k}"`).join(', ');
+        const versionPart = installedVersion ? ` (currently ${installedVersion})` : '';
+        super(`CDK synth rejected ${keyList}, which this CLI writes but the project's installed ` +
+            `@aws/agentcore-cdk${versionPart} does not recognize. If you did not hand-edit ` +
+            `agentcore.json, the bundled CDK constructs are likely behind the CLI. Run ` +
+            `\`npm update @aws/agentcore-cdk\` in agentcore/cdk/, then re-run \`agentcore deploy\`.`, { defaultSource: 'user', ...options });
+    }
+}
+exports.StaleCdkConstructError = StaleCdkConstructError;
+/**
+ * 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 thrown when non-AWS credentials are missing but required.. (ex. API Keys)
+ */
+class MissingCredentialsError extends BaseError {
+    constructor(message, options) {
+        super(message, { defaultSource: 'user', ...options });
+    }
+}
+exports.MissingCredentialsError = MissingCredentialsError;
+/**
+ * Error indicating a packaging operation failed.
+ */
+class PackagingError extends BaseError {
+    constructor(message, options) {
+        super(message, { defaultSource: 'user', ...options });
+    }
+}
+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 the project language is not supported for packaging.
+ */
+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, { defaultSource: 'user', ...options });
+    }
+}
+/**
+ * Thrown when a config file doesn't exist.
+ */
+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;
+/**
+ * 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 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 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 DevServerError extends BaseError {
+    statusCode;
+    constructor(statusCode, body, options) {
+        super(body || `Server returned ${statusCode}`, { defaultSource: 'client', ...options });
+        this.statusCode = statusCode;
+    }
+}
+exports.DevServerError = DevServerError;
+/**
+ * Error thrown when the connection to the dev server fails.
+ */
+class DevServerConnectionError extends BaseError {
+    constructor(message, options) {
+        super(message, { defaultSource: 'client', ...options });
+    }
+}
+exports.DevServerConnectionError = DevServerConnectionError;
+/**
+ * Error indicating an AWS service gave back a 5xx or malforned response.
+ */
+class ServiceError extends BaseError {
+    constructor(message, options) {
+        super(message, { defaultSource: 'service', ...options });
+    }
+}
+exports.ServiceError = ServiceError;
+/**
+ * Error indicating a request was throttled or rate-limited.
+ */
+class ThrottlingError extends BaseError {
+    constructor(message, options) {
+        super(message, { defaultSource: 'service', ...options });
+    }
+}
+exports.ThrottlingError = ThrottlingError;
+/**
+ * Error indicating a service quota or limit was exceeded.
+ */
+class ServiceQuotaError extends BaseError {
+    constructor(message, options) {
+        super(message, { defaultSource: 'service', ...options });
+    }
+}
+exports.ServiceQuotaError = ServiceQuotaError;
+/**
+ * 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;
+/**
+ * Thrown when starting or driving a Bedrock Knowledge Base ingestion job
+ * fails. Default source is 'service' because most ingestion failures are
+ * AWS-side (validation, throttling, KB not ready). Pre-flight failures from
+ * the CLI side (KB not deployed, no data sources recorded) override to 'user'.
+ */
+class IngestionError extends BaseError {
+    constructor(message, options) {
+        super(message, { defaultSource: 'service', ...options });
+    }
+}
+exports.IngestionError = IngestionError;
+class ShellKickedError extends BaseError {
+    constructor(options) {
+        super('Shell session was taken over by another client (close code 4000)', {
+            defaultSource: 'service',
+            ...options,
+        });
+    }
+}
+exports.ShellKickedError = ShellKickedError;
+/**
+ * Error indicating user cancellation interuption
+ */
+class UserCancellationError extends BaseError {
+    constructor(options) {
+        super(`User cancelled`, { defaultSource: 'user', ...options });
+    }
+}
+exports.UserCancellationError = UserCancellationError;
+class ExportHarnessError extends BaseError {
+    constructor(message, options) {
+        super(message, { defaultSource: 'client', ...options });
+    }
+}
+exports.ExportHarnessError = ExportHarnessError;
+//# sourceMappingURL=types.js.map