@agentick/core 0.0.1

package/dist/types.d.ts

@@ -0,0 +1,442 @@
+/**
+ * Model Plugin Types
+ *
+ * Defines types for AI model components (generation, streaming, tool calling)
+ *
+ * ## Provider Options Architecture
+ *
+ * The engine supports three levels of provider-specific options, each with its own interface
+ * that can be extended via module augmentation:
+ *
+ * 1. **ProviderClientOptions** - Client initialization options
+ *    - Used when creating the underlying provider client (OpenAI, GoogleGenAI, Anthropic, HuggingFace, etc.)
+ *    - Passed to adapter constructors or factory functions
+ *    - Examples: API keys, base URLs, organization IDs, timeout settings
+ *
+ * 2. **ProviderGenerationOptions** - Model generation/operation options
+ *    - Used for model generation/streaming calls and other operations
+ *    - Passed via `ModelInput.providerOptions`
+ *    - Can include provider-specific parameters for generateImage, editImage, countTokens, etc.
+ *    - Merged into provider-specific request parameters in adapter's `prepareInput()` method
+ *
+ * 3. **ProviderToolOptions** - Tool definition options
+ *    - Used for tool definitions to customize how tools are presented to the provider
+ *    - Passed via `ToolMetadata.providerOptions` or `ToolDefinition.providerOptions`
+ *    - Allows provider-specific tool configuration (e.g., OpenAI's tool types, function descriptions)
+ *    - Merged into provider-specific tool definitions in adapter's `prepareInput()` method
+ *
+ * Each adapter extends these interfaces using module augmentation:
+ * ```typescript
+ * declare module 'agentick' {
+ *   interface ProviderClientOptions {
+ *     openai?: OpenAIAdapterConfig;
+ *   }
+ *   interface ProviderGenerationOptions {
+ *     openai?: OpenAIGenerationOptions;
+ *   }
+ *   interface ProviderToolOptions {
+ *     openai?: OpenAIToolOptions;
+ *   }
+ * }
+ * ```
+ */
+import { type Message, type ContentBlock, type GeneratedImageBlock } from "@agentick/shared";
+import type { Procedure, UserContext } from "@agentick/kernel";
+import type { ProcedureGraph, ProcedureNode } from "@agentick/kernel";
+import type { ChannelService } from "./channels/service";
+import type { ExecutionHandleImpl } from "./engine/execution-handle";
+import type { ExecutionHandle as EngineExecutionHandle } from "./engine/execution-types";
+import type { EventEmitter } from "node:events";
+import type { ContextMetadata, ContextMetrics } from "@agentick/kernel";
+export interface EngineContextMetadata extends ContextMetadata {
+}
+export interface EngineContextMetrics extends ContextMetrics {
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+        reasoningTokens: number;
+        totalTokens: number;
+        cachedInputTokens: number;
+        [key: string]: number;
+    };
+}
+/**
+ * Module augmentation: Extend KernelContext with Engine-specific properties.
+ * This allows Engine to add fields to KernelContext without modifying Kernel types.
+ * These fields are optional and only present when Engine is being used.
+ *
+ * Note: We cannot override executionHandle (it's EventEmitter in Kernel),
+ * but in Engine code we know it's always ExecutionHandleImpl and use type guards/assertions.
+ */
+declare module "@agentick/core" {
+    interface KernelContext {
+        /**
+         * Parent execution PID for child executions.
+         * Set by Engine when creating child executions.
+         */
+        parentPid?: string;
+        /**
+         * Parent execution handle for child executions.
+         * Set by Engine when creating child executions.
+         */
+        parentHandle?: EngineExecutionHandle;
+    }
+}
+/**
+ * EngineContext is KernelContext with Engine-specific augmentations.
+ *
+ * Unlike simple `extends KernelContext`, we explicitly redeclare all KernelContext
+ * properties to ensure TypeScript properly recognizes them across package boundaries.
+ * This avoids issues where module augmentation doesn't propagate correctly.
+ *
+ * Engine augments KernelContext via module augmentation to add:
+ * - executionType, parentPid, parentHandle (for child executions)
+ *
+ * This interface narrows executionHandle from EventEmitter to ExecutionHandleImpl
+ * for better type safety in Engine code. This is valid because ExecutionHandleImpl
+ * extends EventEmitter, making it a subtype.
+ */
+export interface EngineContext {
+    /** Unique request ID for this execution context */
+    requestId: string;
+    /** Trace ID for distributed tracing */
+    traceId: string;
+    /** User context information */
+    user?: UserContext;
+    /** Arbitrary metadata stored in the context */
+    metadata: EngineContextMetadata;
+    /** Metrics collected during execution */
+    metrics: EngineContextMetrics;
+    /** Global Request Bus for event emission */
+    events: EventEmitter;
+    /** Cancellation signal */
+    signal?: AbortSignal;
+    /**
+     * Channel service for bidirectional communication (optional).
+     * Injected by Engine when channels are configured.
+     *
+     * Provides access to:
+     * - Router registry: `ctx.channels?.getRouter('channel-name')`
+     * - Event dispatch: `ctx.channels?.handleEvent(...)`
+     * - Transport: `ctx.channels?.getTransport()`
+     * - Low-level methods: `publish()`, `subscribe()`, `waitForResponse()`
+     */
+    channels?: ChannelService;
+    /**
+     * Procedure graph for tracking procedure execution hierarchy.
+     * Automatically initialized when first procedure is executed.
+     */
+    procedureGraph?: ProcedureGraph;
+    /**
+     * Current procedure PID (for tracking nested procedures).
+     */
+    procedurePid?: string;
+    /** Current procedure node in the execution graph */
+    procedureNode?: ProcedureNode;
+    /**
+     * Origin procedure node - the root procedure that initiated this execution chain.
+     * Undefined for the root procedure itself (since it IS the origin).
+     * Set automatically by ExecutionTracker when procedures are executed.
+     */
+    origin?: ProcedureNode;
+    /**
+     * Current execution ID. Set when entering an execution boundary.
+     * All procedures within this execution share this ID.
+     */
+    executionId?: string;
+    /**
+     * Type of execution at this boundary (e.g., 'engine', 'model', 'component_tool', 'harness').
+     * Only meaningful at execution boundaries.
+     */
+    executionType?: string;
+    /**
+     * Parent execution ID for nested executions (e.g., component_tool called from engine).
+     * Enables DevTools to show execution hierarchy.
+     */
+    parentExecutionId?: string;
+    /**
+     * Parent execution PID for child executions.
+     * Set by Engine when creating child executions.
+     */
+    parentPid?: string;
+    /**
+     * Parent execution handle for child executions.
+     * Set by Engine when creating child executions.
+     */
+    parentHandle?: EngineExecutionHandle;
+    /**
+     * Execution handle narrowed to ExecutionHandleImpl (Engine's concrete implementation).
+     * In Engine, executionHandle is always ExecutionHandleImpl, not just EventEmitter.
+     */
+    executionHandle?: ExecutionHandleImpl;
+}
+/**
+ * Base interface for provider-specific client initialization options.
+ * Used when creating the underlying provider client (OpenAI, GoogleGenAI, Anthropic, etc.).
+ * Each adapter can extend this interface using module augmentation to add their provider key.
+ *
+ * Example:
+ * ```typescript
+ * declare module 'agentick' {
+ *   interface ProviderClientOptions {
+ *     openai?: OpenAI.ClientOptions;
+ *   }
+ * }
+ * ```
+ */
+export interface ProviderClientOptions {
+    [provider: string]: any;
+}
+/**
+ * Base interface for provider-specific generation options.
+ * Used for model generation/streaming calls and other operations (generateImage, editImage, countTokens, etc.).
+ * Each adapter can extend this interface using module augmentation to add their provider key.
+ *
+ * Example:
+ * ```typescript
+ * declare module 'agentick' {
+ *   interface ProviderGenerationOptions {
+ *     openai?: Partial<OpenAI.Chat.Completions.ChatCompletionCreateParams>;
+ *   }
+ * }
+ * ```
+ */
+export interface ProviderGenerationOptions {
+    [provider: string]: any;
+}
+/**
+ * Base interface for provider-specific tool options.
+ * Used for tool definitions to customize how tools are presented to the provider.
+ * Each adapter can extend this interface using module augmentation to add their provider key.
+ *
+ * Example:
+ * ```typescript
+ * declare module 'agentick' {
+ *   interface ProviderToolOptions {
+ *     openai?: OpenAIToolOptions;
+ *   }
+ * }
+ * ```
+ */
+export interface ProviderToolOptions {
+    [provider: string]: any;
+}
+/**
+ * Base interface for library client initialization options.
+ * Used when creating library adapter instances.
+ * Each adapter package extends this interface using module augmentation.
+ *
+ * Example:
+ * ```typescript
+ * declare module 'agentick' {
+ *   interface LibraryClientOptions {
+ *     'ai-sdk'?: {
+ *       telemetry?: { isEnabled?: boolean };
+ *     };
+ *   }
+ * }
+ * ```
+ */
+export interface LibraryClientOptions {
+    [library: string]: unknown;
+}
+/**
+ * Base interface for library generation options.
+ * Used for per-request library-specific configuration.
+ * Passed via `ModelInput.libraryOptions`.
+ * Each adapter package extends this interface using module augmentation.
+ *
+ * Example:
+ * ```typescript
+ * declare module 'agentick' {
+ *   interface LibraryGenerationOptions {
+ *     'ai-sdk'?: {
+ *       maxSteps?: number;
+ *       experimental?: { toolCallStreaming?: boolean };
+ *       providerOptions?: Record<string, unknown>;
+ *     };
+ *   }
+ * }
+ * ```
+ */
+export interface LibraryGenerationOptions {
+    [library: string]: unknown;
+}
+/**
+ * Base interface for library tool options.
+ * Used for tool-specific library configuration.
+ * Passed via `ToolMetadata.libraryOptions` or `ToolDefinition.libraryOptions`.
+ * Each adapter package extends this interface using module augmentation.
+ *
+ * Example:
+ * ```typescript
+ * declare module 'agentick' {
+ *   interface LibraryToolOptions {
+ *     'ai-sdk'?: {
+ *       maxDuration?: number;
+ *     };
+ *     langchain?: {
+ *       callbacks?: CallbackHandler[];
+ *     };
+ *   }
+ * }
+ * ```
+ */
+export interface LibraryToolOptions {
+    [library: string]: unknown;
+}
+/** Simple delimiter - string or start/end pair */
+export type DelimiterConfig = string | {
+    start: string;
+    end: string;
+};
+/** Per-block-type delimiter configuration */
+export interface EventBlockDelimiters {
+    /** Delimiter for user_action blocks */
+    user_action?: DelimiterConfig;
+    /** Delimiter for system_event blocks */
+    system_event?: DelimiterConfig;
+    /** Delimiter for state_change blocks */
+    state_change?: DelimiterConfig;
+    /** Delimiter for text blocks (or any block type not specified) */
+    default?: DelimiterConfig;
+}
+/**
+ * Tool execution configuration options.
+ * Controls how tools are executed by the Engine.
+ */
+export interface ToolExecutionOptions {
+    /**
+     * Execute tools in parallel when possible.
+     * When true (default), independent tool calls are executed concurrently.
+     * Set to false for tools with side effects that must run sequentially.
+     * @default true
+     */
+    parallel?: boolean;
+    /**
+     * Maximum number of concurrent tool executions when parallel is true.
+     * @default 10
+     */
+    maxConcurrent?: number;
+    /**
+     * Default timeout for tool execution in milliseconds.
+     * Can be overridden per-tool via tool definition.
+     * @default 30000 (30 seconds)
+     */
+    defaultTimeoutMs?: number;
+    /**
+     * Whether to continue execution if a tool fails.
+     * When true, failed tools return error results but don't stop the tick.
+     * @default true
+     */
+    continueOnError?: boolean;
+}
+export interface ImageGenerationInput {
+    messages: string | string[] | Message[];
+    negative_prompt?: string;
+    size?: ImageSize | string;
+    quality?: ImageQuality;
+    n?: number;
+    style?: string;
+    seed?: number;
+    model?: string;
+    outputType?: "url" | "blob";
+    providerOptions?: Record<string, any>;
+}
+export interface ImageGenerationOutput {
+    images: GeneratedImageBlock[];
+    model: string;
+    metadata: {
+        createdAt: string;
+        usage?: {
+            imagesGenerated: number;
+            creditsUsed?: number;
+        };
+    };
+    raw: any;
+}
+export interface ImageEditInput extends ImageGenerationInput {
+    image: ContentBlock;
+    referenceImages?: GeneratedImageBlock[];
+    mask?: ContentBlock;
+}
+export interface ImageVariationInput {
+    image: ContentBlock;
+    n?: number;
+    size?: ImageSize | string;
+    model?: string;
+    providerOptions?: Record<string, any>;
+}
+export declare enum ImageSize {
+    SMALL = "256x256",
+    MEDIUM = "512x512",
+    LARGE = "1024x1024",
+    EXTRA_LARGE = "2048x2048",
+    SQUARE = "square",
+    PORTRAIT = "portrait",
+    LANDSCAPE = "landscape",
+    AUTO = "auto"
+}
+export declare enum ImageQuality {
+    STANDARD = "standard",
+    HD = "hd",
+    ULTRA_HD = "ultra_hd"
+}
+export declare enum ImageOperation {
+    GENERATE = "generate",
+    EDIT = "edit",
+    VARIATION = "variation"
+}
+export interface ImageGenerationAdapter {
+    generate: Procedure<(input: ImageGenerationInput) => ImageGenerationOutput>;
+    edit?: Procedure<(input: ImageEditInput) => ImageGenerationOutput>;
+    variation?: Procedure<(input: ImageVariationInput) => ImageGenerationOutput>;
+}
+export interface EmbeddingInput {
+    texts: string | string[] | ContentBlock[];
+    model?: string;
+    dimensions?: number;
+    user?: string;
+    encodingFormat?: "float" | "base64";
+    providerOptions?: Record<string, any>;
+}
+export interface EmbeddingOutput {
+    embeddings: number[][];
+    model: string;
+    usage?: {
+        tokens: number;
+        cost?: number;
+    };
+    raw: any;
+}
+export interface SimilarityInput {
+    query: string;
+    candidates: string[];
+    model?: string;
+    top_k?: number;
+    threshold?: number;
+}
+export interface SimilarityResult {
+    query: string;
+    results: Array<{
+        text: string;
+        score: number;
+        index: number;
+    }>;
+    model: string;
+    raw: {
+        query_embedding: number[];
+        candidate_embeddings: number[][];
+    };
+}
+export interface EmbeddingAdapter {
+    embed: Procedure<(input: EmbeddingInput) => EmbeddingOutput>;
+    similarity?: Procedure<(input: SimilarityInput) => SimilarityResult>;
+}
+export declare function cosineSimilarity(a: number[], b: number[]): number;
+export declare function findSimilar(queryEmbedding: number[], candidateEmbeddings: number[][], candidates: string[], topK?: number, threshold?: number): Array<{
+    text: string;
+    score: number;
+    index: number;
+}>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,97 @@
+/**
+ * Model Plugin Types
+ *
+ * Defines types for AI model components (generation, streaming, tool calling)
+ *
+ * ## Provider Options Architecture
+ *
+ * The engine supports three levels of provider-specific options, each with its own interface
+ * that can be extended via module augmentation:
+ *
+ * 1. **ProviderClientOptions** - Client initialization options
+ *    - Used when creating the underlying provider client (OpenAI, GoogleGenAI, Anthropic, HuggingFace, etc.)
+ *    - Passed to adapter constructors or factory functions
+ *    - Examples: API keys, base URLs, organization IDs, timeout settings
+ *
+ * 2. **ProviderGenerationOptions** - Model generation/operation options
+ *    - Used for model generation/streaming calls and other operations
+ *    - Passed via `ModelInput.providerOptions`
+ *    - Can include provider-specific parameters for generateImage, editImage, countTokens, etc.
+ *    - Merged into provider-specific request parameters in adapter's `prepareInput()` method
+ *
+ * 3. **ProviderToolOptions** - Tool definition options
+ *    - Used for tool definitions to customize how tools are presented to the provider
+ *    - Passed via `ToolMetadata.providerOptions` or `ToolDefinition.providerOptions`
+ *    - Allows provider-specific tool configuration (e.g., OpenAI's tool types, function descriptions)
+ *    - Merged into provider-specific tool definitions in adapter's `prepareInput()` method
+ *
+ * Each adapter extends these interfaces using module augmentation:
+ * ```typescript
+ * declare module 'agentick' {
+ *   interface ProviderClientOptions {
+ *     openai?: OpenAIAdapterConfig;
+ *   }
+ *   interface ProviderGenerationOptions {
+ *     openai?: OpenAIGenerationOptions;
+ *   }
+ *   interface ProviderToolOptions {
+ *     openai?: OpenAIToolOptions;
+ *   }
+ * }
+ * ```
+ */
+import {} from "@agentick/shared";
+export var ImageSize;
+(function (ImageSize) {
+    ImageSize["SMALL"] = "256x256";
+    ImageSize["MEDIUM"] = "512x512";
+    ImageSize["LARGE"] = "1024x1024";
+    ImageSize["EXTRA_LARGE"] = "2048x2048";
+    ImageSize["SQUARE"] = "square";
+    ImageSize["PORTRAIT"] = "portrait";
+    ImageSize["LANDSCAPE"] = "landscape";
+    ImageSize["AUTO"] = "auto";
+})(ImageSize || (ImageSize = {}));
+export var ImageQuality;
+(function (ImageQuality) {
+    ImageQuality["STANDARD"] = "standard";
+    ImageQuality["HD"] = "hd";
+    ImageQuality["ULTRA_HD"] = "ultra_hd";
+})(ImageQuality || (ImageQuality = {}));
+export var ImageOperation;
+(function (ImageOperation) {
+    ImageOperation["GENERATE"] = "generate";
+    ImageOperation["EDIT"] = "edit";
+    ImageOperation["VARIATION"] = "variation";
+})(ImageOperation || (ImageOperation = {}));
+// ============================================================================
+// Utility Functions
+// ============================================================================
+export function cosineSimilarity(a, b) {
+    if (a.length !== b.length) {
+        throw new Error("Vectors must have same length");
+    }
+    let dotProduct = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dotProduct += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    if (normA === 0 || normB === 0) {
+        return 0;
+    }
+    return dotProduct / (Math.sqrt(normA) * Math.sqrt(normB));
+}
+export function findSimilar(queryEmbedding, candidateEmbeddings, candidates, topK = 5, threshold) {
+    const similarities = candidateEmbeddings.map((embedding, index) => ({
+        text: candidates[index],
+        score: cosineSimilarity(queryEmbedding, embedding),
+        index,
+    }));
+    similarities.sort((a, b) => b.score - a.score);
+    const filtered = threshold ? similarities.filter((s) => s.score >= threshold) : similarities;
+    return filtered.slice(0, topK);
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,OAAO,EAA6D,MAAM,kBAAkB,CAAC;AA+Z7F,MAAM,CAAN,IAAY,SASX;AATD,WAAY,SAAS;IACnB,8BAAiB,CAAA;IACjB,+BAAkB,CAAA;IAClB,gCAAmB,CAAA;IACnB,sCAAyB,CAAA;IACzB,8BAAiB,CAAA;IACjB,kCAAqB,CAAA;IACrB,oCAAuB,CAAA;IACvB,0BAAa,CAAA;AACf,CAAC,EATW,SAAS,KAAT,SAAS,QASpB;AAED,MAAM,CAAN,IAAY,YAIX;AAJD,WAAY,YAAY;IACtB,qCAAqB,CAAA;IACrB,yBAAS,CAAA;IACT,qCAAqB,CAAA;AACvB,CAAC,EAJW,YAAY,KAAZ,YAAY,QAIvB;AAED,MAAM,CAAN,IAAY,cAIX;AAJD,WAAY,cAAc;IACxB,uCAAqB,CAAA;IACrB,+BAAa,CAAA;IACb,yCAAuB,CAAA;AACzB,CAAC,EAJW,cAAc,KAAd,cAAc,QAIzB;AA0DD,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,MAAM,UAAU,gBAAgB,CAAC,CAAW,EAAE,CAAW;IACvD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1B,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACrB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IAED,IAAI,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,UAAU,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,cAAwB,EACxB,mBAA+B,EAC/B,UAAoB,EACpB,OAAe,CAAC,EAChB,SAAkB;IAElB,MAAM,YAAY,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAClE,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC;QACvB,KAAK,EAAE,gBAAgB,CAAC,cAAc,EAAE,SAAS,CAAC;QAClD,KAAK;KACN,CAAC,CAAC,CAAC;IAEJ,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAE/C,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;IAE7F,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AACjC,CAAC"}

package/dist/utils/abort-utils.d.ts

@@ -0,0 +1,5 @@
+export declare function mergeAbortSignals(signals: AbortSignal[]): AbortSignal;
+import { AbortError } from "@agentick/shared";
+export { AbortError };
+export declare function isAbortError(error: any): boolean;
+//# sourceMappingURL=abort-utils.d.ts.map

package/dist/utils/abort-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort-utils.d.ts","sourceRoot":"","sources":["../../src/utils/abort-utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,WAAW,CAsCrE;AAED,OAAO,EAAE,UAAU,EAAsC,MAAM,kBAAkB,CAAC;AAElF,OAAO,EAAE,UAAU,EAAE,CAAC;AAEtB,wBAAgB,YAAY,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAShD"}

package/dist/utils/abort-utils.js

@@ -0,0 +1,50 @@
+export function mergeAbortSignals(signals) {
+    if (signals.length === 0) {
+        return new AbortController().signal; // Never-aborting signal
+    }
+    if (signals.length === 1) {
+        return signals[0];
+    }
+    // Create a new controller for the merged signal
+    const mergedController = new AbortController();
+    // Track if we've already aborted (to avoid multiple abort calls)
+    let aborted = false;
+    // Abort handler that aborts the merged signal
+    const abortHandler = () => {
+        if (!aborted) {
+            aborted = true;
+            mergedController.abort();
+            // Clean up listeners (they'll be removed when signals abort anyway, but be explicit)
+            for (const signal of signals) {
+                signal.removeEventListener("abort", abortHandler);
+            }
+        }
+    };
+    // Add abort listeners to all signals
+    for (const signal of signals) {
+        // If any signal is already aborted, abort immediately
+        if (signal.aborted) {
+            abortHandler();
+            return mergedController.signal;
+        }
+        signal.addEventListener("abort", abortHandler);
+    }
+    return mergedController.signal;
+}
+import { AbortError, isAbortError as isSharedAbortError } from "@agentick/shared";
+export { AbortError };
+export function isAbortError(error) {
+    if (!error)
+        return false;
+    // Check for our AbortError class first
+    if (isSharedAbortError(error))
+        return true;
+    // Legacy checks for compatibility
+    if (error.name === "AbortError")
+        return true;
+    if (error.name === "DOMException" && error.code === 20)
+        return true; // AbortError DOMException code
+    const message = String(error.message || error);
+    return message.toLowerCase().includes("abort") || message.toLowerCase().includes("cancelled");
+}
+//# sourceMappingURL=abort-utils.js.map

package/dist/utils/abort-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort-utils.js","sourceRoot":"","sources":["../../src/utils/abort-utils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,iBAAiB,CAAC,OAAsB;IACtD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,eAAe,EAAE,CAAC,MAAM,CAAC,CAAC,wBAAwB;IAC/D,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,gDAAgD;IAChD,MAAM,gBAAgB,GAAG,IAAI,eAAe,EAAE,CAAC;IAE/C,iEAAiE;IACjE,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,8CAA8C;IAC9C,MAAM,YAAY,GAAG,GAAG,EAAE;QACxB,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,IAAI,CAAC;YACf,gBAAgB,CAAC,KAAK,EAAE,CAAC;YACzB,qFAAqF;YACrF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,qCAAqC;IACrC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,sDAAsD;QACtD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,YAAY,EAAE,CAAC;YACf,OAAO,gBAAgB,CAAC,MAAM,CAAC;QACjC,CAAC;QACD,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,gBAAgB,CAAC,MAAM,CAAC;AACjC,CAAC;AAED,OAAO,EAAE,UAAU,EAAE,YAAY,IAAI,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAElF,OAAO,EAAE,UAAU,EAAE,CAAC;AAEtB,MAAM,UAAU,YAAY,CAAC,KAAU;IACrC,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,uCAAuC;IACvC,IAAI,kBAAkB,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,kCAAkC;IAClC,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;QAAE,OAAO,IAAI,CAAC;IAC7C,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,IAAI,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC,CAAC,+BAA+B;IACpG,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC;IAC/C,OAAO,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAChG,CAAC"}

package/dist/utils/classify-error.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Error categories for recovery decisions.
+ *
+ * Intentionally NOT `AgentickErrorCode` — categories drive recovery logic,
+ * codes are structured error identity.
+ */
+export type ErrorCategory = "NETWORK_ERROR" | "RATE_LIMIT_ERROR" | "GUARD_DENIED" | "AUTH_ERROR" | "VALIDATION_ERROR" | "TIMEOUT_ERROR" | "ABORT_ERROR" | "APPLICATION_ERROR" | "UNKNOWN_ERROR";
+/**
+ * Classify an error for recovery handling.
+ *
+ * Superset of all classification checks used across the codebase
+ * (engine error middleware, tool executor, etc.).
+ */
+export declare function classifyError(error: any): ErrorCategory;
+/**
+ * Determine if an error is recoverable.
+ */
+export declare function isRecoverableError(error: any): boolean;
+//# sourceMappingURL=classify-error.d.ts.map

package/dist/utils/classify-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify-error.d.ts","sourceRoot":"","sources":["../../src/utils/classify-error.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GACrB,eAAe,GACf,kBAAkB,GAClB,cAAc,GACd,YAAY,GACZ,kBAAkB,GAClB,eAAe,GACf,aAAa,GACb,mBAAmB,GACnB,eAAe,CAAC;AAEpB;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,aAAa,CA4CvD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAmCtD"}