@agtlantis/core 0.5.0 → 0.5.1

package/dist/errors/index.d.ts

@@ -0,0 +1,4 @@
+export { ExecutionErrorCode, ConfigurationErrorCode, FileErrorCode, type AgtlantisErrorCode, } from './types.js';
+export type { AgtlantisErrorOptions, ExecutionErrorOptions, ConfigurationErrorOptions, FileErrorOptions, } from './types.js';
+export { AgtlantisError, ExecutionError, ConfigurationError, FileError, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,aAAa,EACb,KAAK,kBAAkB,GACxB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,qBAAqB,EACrB,qBAAqB,EACrB,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,SAAS,GACV,MAAM,YAAY,CAAC"}

package/dist/errors/index.js

@@ -0,0 +1,3 @@
+export { ExecutionErrorCode, ConfigurationErrorCode, FileErrorCode, } from './types.js';
+export { AgtlantisError, ExecutionError, ConfigurationError, FileError, } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,aAAa,GAEd,MAAM,YAAY,CAAC;AASpB,OAAO,EACL,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,SAAS,GACV,MAAM,YAAY,CAAC"}

package/dist/errors/types.d.ts

@@ -0,0 +1,69 @@
+export declare enum ExecutionErrorCode {
+    EXECUTION_ERROR = "EXECUTION_ERROR",
+    STREAM_ERROR = "STREAM_ERROR",
+    RESULT_EXTRACTION_ERROR = "RESULT_EXTRACTION_ERROR",
+    CANCELLED = "CANCELLED",
+    VALIDATION_ERROR = "VALIDATION_ERROR"
+}
+export declare enum ConfigurationErrorCode {
+    CONFIG_ERROR = "CONFIG_ERROR",
+    MISSING_API_KEY = "MISSING_API_KEY",
+    INVALID_CONFIG = "INVALID_CONFIG",
+    MISSING_REQUIRED = "MISSING_REQUIRED"
+}
+export declare enum FileErrorCode {
+    FILE_ERROR = "FILE_ERROR",
+    UPLOAD_ERROR = "UPLOAD_ERROR",
+    DELETE_ERROR = "DELETE_ERROR",
+    NOT_FOUND = "NOT_FOUND",
+    TOO_LARGE = "TOO_LARGE",
+    UNSUPPORTED_TYPE = "UNSUPPORTED_TYPE"
+}
+export type AgtlantisErrorCode = ExecutionErrorCode | ConfigurationErrorCode | FileErrorCode;
+export interface AgtlantisErrorOptions<TCode extends AgtlantisErrorCode = AgtlantisErrorCode> {
+    code: TCode;
+    cause?: Error;
+    context?: Record<string, unknown>;
+}
+export interface ErrorOptions<TCode extends AgtlantisErrorCode> {
+    code?: TCode;
+    cause?: Error;
+    context?: Record<string, unknown>;
+}
+export type ExecutionErrorOptions = ErrorOptions<ExecutionErrorCode>;
+export type ConfigurationErrorOptions = ErrorOptions<ConfigurationErrorCode>;
+export type FileErrorOptions = ErrorOptions<FileErrorCode>;
+/**
+ * Base error class for all Agtlantis errors.
+ * Provides structured error information including error code and optional context.
+ */
+export declare class AgtlantisError<TCode extends AgtlantisErrorCode = AgtlantisErrorCode> extends Error {
+    readonly code: TCode;
+    readonly cause?: Error;
+    readonly context?: Record<string, unknown>;
+    constructor(message: string, options: AgtlantisErrorOptions<TCode>);
+    get isRetryable(): boolean;
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Error thrown during agent execution (streaming failures, result extraction, cancellation).
+ */
+export declare class ExecutionError extends AgtlantisError<ExecutionErrorCode> {
+    constructor(message: string, options?: ExecutionErrorOptions);
+    static from(error: unknown, code?: ExecutionErrorCode, context?: Record<string, unknown>): ExecutionError;
+}
+/**
+ * Error thrown when configuration is invalid or missing (API keys, model names).
+ */
+export declare class ConfigurationError extends AgtlantisError<ConfigurationErrorCode> {
+    constructor(message: string, options?: ConfigurationErrorOptions);
+    static from(error: unknown, code?: ConfigurationErrorCode, context?: Record<string, unknown>): ConfigurationError;
+}
+/**
+ * Error thrown during file operations (upload, delete, not found, size limits).
+ */
+export declare class FileError extends AgtlantisError<FileErrorCode> {
+    constructor(message: string, options?: FileErrorOptions);
+    static from(error: unknown, code?: FileErrorCode, context?: Record<string, unknown>): FileError;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/errors/types.ts"],"names":[],"mappings":"AAEA,oBAAY,kBAAkB;IAC5B,eAAe,oBAAoB;IACnC,YAAY,iBAAiB;IAC7B,uBAAuB,4BAA4B;IACnD,SAAS,cAAc;IACvB,gBAAgB,qBAAqB;CACtC;AAED,oBAAY,sBAAsB;IAChC,YAAY,iBAAiB;IAC7B,eAAe,oBAAoB;IACnC,cAAc,mBAAmB;IACjC,gBAAgB,qBAAqB;CACtC;AAED,oBAAY,aAAa;IACvB,UAAU,eAAe;IACzB,YAAY,iBAAiB;IAC7B,YAAY,iBAAiB;IAC7B,SAAS,cAAc;IACvB,SAAS,cAAc;IACvB,gBAAgB,qBAAqB;CACtC;AAED,MAAM,MAAM,kBAAkB,GAAG,kBAAkB,GAAG,sBAAsB,GAAG,aAAa,CAAC;AAE7F,MAAM,WAAW,qBAAqB,CAAC,KAAK,SAAS,kBAAkB,GAAG,kBAAkB;IAC1F,IAAI,EAAE,KAAK,CAAC;IACZ,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,YAAY,CAAC,KAAK,SAAS,kBAAkB;IAC5D,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,MAAM,qBAAqB,GAAG,YAAY,CAAC,kBAAkB,CAAC,CAAC;AACrE,MAAM,MAAM,yBAAyB,GAAG,YAAY,CAAC,sBAAsB,CAAC,CAAC;AAC7E,MAAM,MAAM,gBAAgB,GAAG,YAAY,CAAC,aAAa,CAAC,CAAC;AAE3D;;;GAGG;AACH,qBAAa,cAAc,CAAC,KAAK,SAAS,kBAAkB,GAAG,kBAAkB,CAAE,SAAQ,KAAK;IAC9F,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,SAAkB,KAAK,CAAC,EAAE,KAAK,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE3C,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,CAAC,KAAK,CAAC,EAYjE;IAED,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUhC;CACF;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,cAAc,CAAC,kBAAkB,CAAC;IACpE,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,EAO/D;IAED,MAAM,CAAC,IAAI,CACT,KAAK,EAAE,OAAO,EACd,IAAI,GAAE,kBAAuD,EAC7D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,cAAc,CAKhB;CACF;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,cAAc,CAAC,sBAAsB,CAAC;IAC5E,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,yBAA8B,EAOnE;IAED,MAAM,CAAC,IAAI,CACT,KAAK,EAAE,OAAO,EACd,IAAI,GAAE,sBAA4D,EAClE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,kBAAkB,CAKpB;CACF;AAED;;GAEG;AACH,qBAAa,SAAU,SAAQ,cAAc,CAAC,aAAa,CAAC;IAC1D,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,EAO1D;IAED,MAAM,CAAC,IAAI,CACT,KAAK,EAAE,OAAO,EACd,IAAI,GAAE,aAAwC,EAC9C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,SAAS,CAKX;CACF"}

package/dist/errors/types.js

@@ -0,0 +1,119 @@
+import { wrapAsError } from './utils.js';
+export { ExecutionErrorCode };
+var ExecutionErrorCode;
+(function (ExecutionErrorCode) {
+    ExecutionErrorCode["EXECUTION_ERROR"] = "EXECUTION_ERROR";
+    ExecutionErrorCode["STREAM_ERROR"] = "STREAM_ERROR";
+    ExecutionErrorCode["RESULT_EXTRACTION_ERROR"] = "RESULT_EXTRACTION_ERROR";
+    ExecutionErrorCode["CANCELLED"] = "CANCELLED";
+    ExecutionErrorCode["VALIDATION_ERROR"] = "VALIDATION_ERROR";
+})(ExecutionErrorCode || (ExecutionErrorCode = {}));
+export { ConfigurationErrorCode };
+var ConfigurationErrorCode;
+(function (ConfigurationErrorCode) {
+    ConfigurationErrorCode["CONFIG_ERROR"] = "CONFIG_ERROR";
+    ConfigurationErrorCode["MISSING_API_KEY"] = "MISSING_API_KEY";
+    ConfigurationErrorCode["INVALID_CONFIG"] = "INVALID_CONFIG";
+    ConfigurationErrorCode["MISSING_REQUIRED"] = "MISSING_REQUIRED";
+})(ConfigurationErrorCode || (ConfigurationErrorCode = {}));
+export { FileErrorCode };
+var FileErrorCode;
+(function (FileErrorCode) {
+    FileErrorCode["FILE_ERROR"] = "FILE_ERROR";
+    FileErrorCode["UPLOAD_ERROR"] = "UPLOAD_ERROR";
+    FileErrorCode["DELETE_ERROR"] = "DELETE_ERROR";
+    FileErrorCode["NOT_FOUND"] = "NOT_FOUND";
+    FileErrorCode["TOO_LARGE"] = "TOO_LARGE";
+    FileErrorCode["UNSUPPORTED_TYPE"] = "UNSUPPORTED_TYPE";
+})(FileErrorCode || (FileErrorCode = {}));
+/**
+ * Base error class for all Agtlantis errors.
+ * Provides structured error information including error code and optional context.
+ */
+export class AgtlantisError extends Error {
+    code;
+    cause;
+    context;
+    constructor(message, options) {
+        super(message);
+        this.name = 'AgtlantisError';
+        this.code = options.code;
+        this.cause = options.cause;
+        this.context = options.context;
+        // V8-specific stack trace capture
+        const ErrorWithCapture = Error;
+        ErrorWithCapture.captureStackTrace?.(this, this.constructor);
+    }
+    get isRetryable() {
+        return false;
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            isRetryable: this.isRetryable,
+            context: this.context,
+            cause: this.cause?.message,
+            stack: this.stack,
+        };
+    }
+}
+/**
+ * Error thrown during agent execution (streaming failures, result extraction, cancellation).
+ */
+export class ExecutionError extends AgtlantisError {
+    constructor(message, options = {}) {
+        super(message, {
+            code: options.code ?? ExecutionErrorCode.EXECUTION_ERROR,
+            cause: options.cause,
+            context: options.context,
+        });
+        this.name = 'ExecutionError';
+    }
+    static from(error, code = ExecutionErrorCode.EXECUTION_ERROR, context) {
+        if (error instanceof ExecutionError) {
+            return error;
+        }
+        return wrapAsError(error, ExecutionError, { code, context });
+    }
+}
+/**
+ * Error thrown when configuration is invalid or missing (API keys, model names).
+ */
+export class ConfigurationError extends AgtlantisError {
+    constructor(message, options = {}) {
+        super(message, {
+            code: options.code ?? ConfigurationErrorCode.CONFIG_ERROR,
+            cause: options.cause,
+            context: options.context,
+        });
+        this.name = 'ConfigurationError';
+    }
+    static from(error, code = ConfigurationErrorCode.CONFIG_ERROR, context) {
+        if (error instanceof ConfigurationError) {
+            return error;
+        }
+        return wrapAsError(error, ConfigurationError, { code, context });
+    }
+}
+/**
+ * Error thrown during file operations (upload, delete, not found, size limits).
+ */
+export class FileError extends AgtlantisError {
+    constructor(message, options = {}) {
+        super(message, {
+            code: options.code ?? FileErrorCode.FILE_ERROR,
+            cause: options.cause,
+            context: options.context,
+        });
+        this.name = 'FileError';
+    }
+    static from(error, code = FileErrorCode.FILE_ERROR, context) {
+        if (error instanceof FileError) {
+            return error;
+        }
+        return wrapAsError(error, FileError, { code, context });
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/errors/types.js.map

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

package/dist/errors/utils.d.ts

@@ -0,0 +1,17 @@
+import type { AgtlantisError, AgtlantisErrorCode, AgtlantisErrorOptions } from './types.js';
+/**
+ * Wraps an unknown error as a specific AgtlantisError subclass.
+ * Internal utility - not part of public API.
+ *
+ * @param error - The unknown error to wrap
+ * @param ErrorClass - The error class constructor to use
+ * @param options - Error options including code and optional context
+ * @returns A new instance of the specified error class
+ *
+ * @internal
+ */
+export declare function wrapAsError<T extends AgtlantisError<TCode>, TCode extends AgtlantisErrorCode>(error: unknown, ErrorClass: new (message: string, options: AgtlantisErrorOptions<TCode>) => T, options: {
+    code: TCode;
+    context?: Record<string, unknown>;
+}): T;
+//# sourceMappingURL=utils.d.ts.map

package/dist/errors/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/errors/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAE5F;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CACzB,CAAC,SAAS,cAAc,CAAC,KAAK,CAAC,EAC/B,KAAK,SAAS,kBAAkB,EAEhC,KAAK,EAAE,OAAO,EACd,UAAU,EAAE,KAAK,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,CAAC,KAAK,CAAC,KAAK,CAAC,EAC7E,OAAO,EAAE;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC1D,CAAC,CAGH"}

package/dist/errors/utils.js

@@ -0,0 +1,16 @@
+/**
+ * Wraps an unknown error as a specific AgtlantisError subclass.
+ * Internal utility - not part of public API.
+ *
+ * @param error - The unknown error to wrap
+ * @param ErrorClass - The error class constructor to use
+ * @param options - Error options including code and optional context
+ * @returns A new instance of the specified error class
+ *
+ * @internal
+ */
+export function wrapAsError(error, ErrorClass, options) {
+    const cause = error instanceof Error ? error : new Error(String(error));
+    return new ErrorClass(cause.message, { ...options, cause });
+}
+//# sourceMappingURL=utils.js.map

package/dist/errors/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/errors/utils.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAIzB,KAAc,EACd,UAA6E,EAC7E,OAA2D,EACxD;IACH,MAAM,KAAK,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACxE,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;AAAA,CAC7D"}

package/dist/execution/constants.d.ts

@@ -0,0 +1,7 @@
+export declare const ERRORS: {
+    readonly ALREADY_CONSUMED: "Execution already consumed";
+    readonly METADATA_NOT_AVAILABLE: "Metadata not available yet. Consume the execution first.";
+    readonly NO_RESULT: "No result available";
+    readonly UNKNOWN_ERROR: "Execution failed with unknown error";
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/execution/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/execution/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;;;;;CAMT,CAAC"}

package/dist/execution/constants.js

@@ -0,0 +1,7 @@
+export const ERRORS = {
+    ALREADY_CONSUMED: 'Execution already consumed',
+    METADATA_NOT_AVAILABLE: 'Metadata not available yet. Consume the execution first.',
+    NO_RESULT: 'No result available',
+    UNKNOWN_ERROR: 'Execution failed with unknown error',
+};
+//# sourceMappingURL=constants.js.map

package/dist/execution/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/execution/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,gBAAgB,EAAE,4BAA4B;IAC9C,sBAAsB,EACpB,0DAA0D;IAC5D,SAAS,EAAE,qBAAqB;IAChC,aAAa,EAAE,qCAAqC;CAC5C,CAAC"}

package/dist/execution/index.d.ts

@@ -0,0 +1,8 @@
+export type { Execution, ExecutionOptions, SimpleExecution, StreamingExecution, SessionStreamGeneratorFn, ExecutionStatus, ExecutionResult, SimpleResult, StreamingResult, DistributiveOmit, SessionEvent, SessionEventInput, EmittableEventInput, ReservedEventType, CompletionEvent, ErrorEvent, ExtractResult, } from './types.js';
+export { StreamingExecutionHost } from './streaming-host.js';
+export { SimpleExecutionHost } from './simple-host.js';
+export { ERRORS } from './constants.js';
+export { getDuration, combineSignals } from './utils.js';
+export { isAbortError, normalizeError, determineResultStatus, createHookRunner, type HookRunner } from './shared.js';
+export { mapExecution, mapExecutionResult, type ReplaceResult } from './mapping.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/execution/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,wBAAwB,EAExB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,eAAe,EAEf,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EAEjB,eAAe,EACf,UAAU,EACV,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAErH,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/execution/index.js

@@ -0,0 +1,7 @@
+export { StreamingExecutionHost } from './streaming-host.js';
+export { SimpleExecutionHost } from './simple-host.js';
+export { ERRORS } from './constants.js';
+export { getDuration, combineSignals } from './utils.js';
+export { isAbortError, normalizeError, determineResultStatus, createHookRunner } from './shared.js';
+export { mapExecution, mapExecutionResult } from './mapping.js';
+//# sourceMappingURL=index.js.map

package/dist/execution/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,gBAAgB,EAAmB,MAAM,aAAa,CAAC;AAErH,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAsB,MAAM,cAAc,CAAC"}

package/dist/execution/mapping.d.ts

@@ -0,0 +1,17 @@
+import type { StreamingExecution, SimpleExecution, CompletionEvent, ExtractResult } from './types.js';
+export type ReplaceResult<TEvent extends {
+    type: string;
+}, U> = Exclude<TEvent, {
+    type: 'complete';
+}> | CompletionEvent<U>;
+export declare function mapExecution<TEvent extends {
+    type: string;
+}, UEvent extends {
+    type: string;
+}>(execution: StreamingExecution<TEvent>, fn: (event: TEvent) => UEvent | Promise<UEvent>): StreamingExecution<UEvent>;
+export declare function mapExecution<A, B>(execution: SimpleExecution<A>, fn: (result: A) => B | Promise<B>): SimpleExecution<B>;
+export declare function mapExecutionResult<TEvent extends {
+    type: string;
+}, U>(execution: StreamingExecution<TEvent>, fn: (result: ExtractResult<TEvent>) => U | Promise<U>): StreamingExecution<ReplaceResult<TEvent, U>>;
+export declare function mapExecutionResult<A, B>(execution: SimpleExecution<A>, fn: (result: A) => B | Promise<B>): SimpleExecution<B>;
+//# sourceMappingURL=mapping.d.ts.map

package/dist/execution/mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.d.ts","sourceRoot":"","sources":["../../src/execution/mapping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,kBAAkB,EAClB,eAAe,EAIf,eAAe,EAEf,aAAa,EAChB,MAAM,YAAY,CAAC;AAGpB,MAAM,MAAM,aAAa,CAAC,MAAM,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,IACtD,OAAO,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC,GACrC,eAAe,CAAC,CAAC,CAAC,CAAC;AAMzB,wBAAgB,YAAY,CAAC,MAAM,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EACzF,SAAS,EAAE,kBAAkB,CAAC,MAAM,CAAC,EACrC,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GAChD,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAE9B,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,EAC7B,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC,EAC7B,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAClC,eAAe,CAAC,CAAC,CAAC,CAAC;AAgBtB,wBAAgB,kBAAkB,CAAC,MAAM,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,EACjE,SAAS,EAAE,kBAAkB,CAAC,MAAM,CAAC,EACrC,EAAE,EAAE,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACtD,kBAAkB,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;AAEhD,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,CAAC,EACnC,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC,EAC7B,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAClC,eAAe,CAAC,CAAC,CAAC,CAAC"}

package/dist/execution/mapping.js

@@ -0,0 +1,197 @@
+import { normalizeError } from './shared.js';
+export function mapExecution(execution, fn) {
+    if ('stream' in execution) {
+        return mapStreamingExecution(execution, fn);
+    }
+    return mapSimpleExecution(execution, fn);
+}
+export function mapExecutionResult(execution, fn) {
+    if ('stream' in execution) {
+        return mapStreamingExecutionResult(execution, fn);
+    }
+    return mapSimpleExecution(execution, fn);
+}
+// ============================================================================
+// Internal: Streaming — full event mapping
+// ============================================================================
+function mapStreamingExecution(execution, fn) {
+    return {
+        stream() {
+            const original = execution.stream();
+            return {
+                [Symbol.asyncIterator]() {
+                    const iter = original[Symbol.asyncIterator]();
+                    return {
+                        async next() {
+                            const { value, done } = await iter.next();
+                            if (done)
+                                return { value: undefined, done: true };
+                            const event = value;
+                            if (event.type === 'error') {
+                                return { value: event, done: false };
+                            }
+                            const { metrics, ...pureEvent } = event;
+                            try {
+                                const mapped = await fn(pureEvent);
+                                return {
+                                    value: { ...mapped, metrics },
+                                    done: false,
+                                };
+                            }
+                            catch (err) {
+                                const errorEvent = {
+                                    type: 'error',
+                                    error: normalizeError(err),
+                                    metrics,
+                                };
+                                return { value: errorEvent, done: false };
+                            }
+                        },
+                    };
+                },
+            };
+        },
+        async result() {
+            const original = await execution.result();
+            if (original.status !== 'succeeded') {
+                return original;
+            }
+            try {
+                const mappedEvents = [];
+                for (const event of original.events) {
+                    if (event.type === 'error') {
+                        mappedEvents.push(event);
+                        continue;
+                    }
+                    const { metrics, ...pureEvent } = event;
+                    const mapped = await fn(pureEvent);
+                    mappedEvents.push({ ...mapped, metrics });
+                }
+                const completionEvent = mappedEvents.find(e => e.type === 'complete');
+                return {
+                    status: 'succeeded',
+                    value: completionEvent.data,
+                    events: mappedEvents,
+                    summary: original.summary,
+                };
+            }
+            catch (err) {
+                return {
+                    status: 'failed',
+                    error: normalizeError(err),
+                    events: original.events,
+                    summary: original.summary,
+                };
+            }
+        },
+        cancel: () => execution.cancel(),
+        cleanup: () => execution.cleanup(),
+        [Symbol.asyncDispose]: () => execution[Symbol.asyncDispose](),
+    };
+}
+// ============================================================================
+// Internal: Streaming — result-only mapping
+// ============================================================================
+function mapStreamingExecutionResult(execution, fn) {
+    return {
+        stream() {
+            const original = execution.stream();
+            return {
+                [Symbol.asyncIterator]() {
+                    const iter = original[Symbol.asyncIterator]();
+                    return {
+                        async next() {
+                            const { value, done } = await iter.next();
+                            if (done)
+                                return { value: undefined, done: true };
+                            const event = value;
+                            if (event.type === 'complete') {
+                                const { metrics, ...rest } = event;
+                                try {
+                                    const mapped = await fn(rest.data);
+                                    return {
+                                        value: { type: 'complete', data: mapped, summary: rest.summary, metrics },
+                                        done: false,
+                                    };
+                                }
+                                catch (err) {
+                                    const errorEvent = {
+                                        type: 'error',
+                                        error: normalizeError(err),
+                                        metrics,
+                                    };
+                                    return { value: errorEvent, done: false };
+                                }
+                            }
+                            return { value: event, done: false };
+                        },
+                    };
+                },
+            };
+        },
+        async result() {
+            const original = await execution.result();
+            if (original.status !== 'succeeded') {
+                return original;
+            }
+            try {
+                const mapped = await fn(original.value);
+                const mappedEvents = original.events.map(event => {
+                    if (event.type === 'complete') {
+                        return { ...event, data: mapped };
+                    }
+                    return event;
+                });
+                return {
+                    status: 'succeeded',
+                    value: mapped,
+                    events: mappedEvents,
+                    summary: original.summary,
+                };
+            }
+            catch (err) {
+                return {
+                    status: 'failed',
+                    error: normalizeError(err),
+                    events: original.events,
+                    summary: original.summary,
+                };
+            }
+        },
+        cancel: () => execution.cancel(),
+        cleanup: () => execution.cleanup(),
+        [Symbol.asyncDispose]: () => execution[Symbol.asyncDispose](),
+    };
+}
+// ============================================================================
+// Internal: Simple execution mapping (shared by both mapExecution and mapExecutionResult)
+// ============================================================================
+function mapSimpleExecution(execution, fn) {
+    return {
+        async result() {
+            const original = await execution.result();
+            if (original.status !== 'succeeded') {
+                return original;
+            }
+            try {
+                const mapped = await fn(original.value);
+                return {
+                    status: 'succeeded',
+                    value: mapped,
+                    summary: original.summary,
+                };
+            }
+            catch (err) {
+                return {
+                    status: 'failed',
+                    error: normalizeError(err),
+                    summary: original.summary,
+                };
+            }
+        },
+        cancel: () => execution.cancel(),
+        cleanup: () => execution.cleanup(),
+        [Symbol.asyncDispose]: () => execution[Symbol.asyncDispose](),
+    };
+}
+//# sourceMappingURL=mapping.js.map

package/dist/execution/mapping.js.map

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

package/dist/execution/shared.d.ts

@@ -0,0 +1,86 @@
+import type { ExecutionStatus } from './types.js';
+/**
+ * Shared utilities for execution hosts.
+ *
+ * These functions extract common patterns from SimpleExecutionHost and
+ * StreamingExecutionHost to reduce code duplication and ensure consistent
+ * behavior across both implementations.
+ */
+/**
+ * Checks if an error is an abort-related error.
+ *
+ * An error is considered abort-related if either:
+ * - The error has the name 'AbortError' (standard for AbortController)
+ * - The signal has been aborted (covers edge cases where error name differs)
+ *
+ * @param error - The error to check
+ * @param signal - The AbortSignal associated with the execution
+ * @returns true if this is an abort-related error
+ */
+export declare function isAbortError(error: unknown, signal: AbortSignal): boolean;
+/**
+ * Normalizes an unknown error to an Error instance.
+ *
+ * If the error is already an Error instance, it's returned as-is.
+ * Otherwise, it's converted to a string and wrapped in a new Error.
+ *
+ * @param error - The unknown error to normalize
+ * @returns A proper Error instance
+ */
+export declare function normalizeError(error: unknown): Error;
+/**
+ * Determines the execution status based on the execution state.
+ *
+ * Status determination priority:
+ * 1. If user called cancel() OR the operation was aborted → 'canceled'
+ * 2. If there's an error → 'failed'
+ * 3. Otherwise → 'succeeded'
+ *
+ * Note: The 'aborted' flag takes precedence over 'hasError' because
+ * AbortError is treated as a normal cancellation, not a failure.
+ *
+ * @param cancelRequested - Whether cancel() was explicitly called
+ * @param aborted - Whether the signal was aborted (includes external abort)
+ * @param hasError - Whether the execution ended with an error
+ * @returns The appropriate execution status
+ */
+export declare function determineResultStatus(cancelRequested: boolean, aborted: boolean, hasError: boolean): ExecutionStatus;
+/**
+ * Return type for createHookRunner utility.
+ */
+export type HookRunner = {
+    /**
+     * Ensures hooks run exactly once.
+     * Safe to call multiple times - only executes on first call.
+     */
+    ensureRun: () => Promise<void>;
+    /**
+     * Check if hooks have already been run.
+     */
+    hasRun: () => boolean;
+};
+/**
+ * Creates a hook runner that ensures hooks run exactly once.
+ *
+ * This utility encapsulates the common pattern of running cleanup hooks
+ * with a guard flag to prevent double execution. Both SimpleExecutionHost
+ * and StreamingExecutionHost use this pattern for onDone hooks.
+ *
+ * @param runHooks - The async function to run hooks
+ * @returns Object with ensureRun() and hasRun() methods
+ *
+ * @example
+ * ```typescript
+ * const hookRunner = createHookRunner(async () => {
+ *   await session.runOnDoneHooks();
+ * });
+ *
+ * // In finally block or cleanup:
+ * await hookRunner.ensureRun();
+ *
+ * // Safe to call multiple times - only executes once
+ * await hookRunner.ensureRun(); // no-op
+ * ```
+ */
+export declare function createHookRunner(runHooks: () => Promise<void>): HookRunner;
+//# sourceMappingURL=shared.d.ts.map

package/dist/execution/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/execution/shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;;;GAMG;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAKzE;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAEpD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,OAAO,EACxB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,OAAO,GAChB,eAAe,CAajB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB;;;OAGG;IACH,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B;;OAEG;IACH,MAAM,EAAE,MAAM,OAAO,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,CAY1E"}