@agentick/shared 0.0.1

package/dist/errors.js

@@ -0,0 +1,529 @@
+/**
+ * Agentick Error Hierarchy
+ *
+ * Structured error classes for consistent error handling across the framework.
+ * All errors extend AgentickError which provides:
+ * - Unique error codes for programmatic handling
+ * - Rich metadata for debugging
+ * - Serialization support for client/server communication
+ * - Type guards for catching specific error types
+ *
+ * @example Throwing errors
+ * ```typescript
+ * throw new NotFoundError('model', 'gpt-4', 'Model not found in registry');
+ * throw new ValidationError('messages', 'array', 'Messages must be an array');
+ * throw new AbortError('User cancelled operation');
+ * ```
+ *
+ * @example Catching specific errors
+ * ```typescript
+ * try {
+ *   await engine.execute(input);
+ * } catch (error) {
+ *   if (isAbortError(error)) {
+ *     // Handle cancellation
+ *   } else if (isNotFoundError(error)) {
+ *     // Handle missing resource
+ *   } else if (isAgentickError(error)) {
+ *     // Handle any Agentick error
+ *     console.log(error.code, error.toJSON());
+ *   }
+ * }
+ * ```
+ */
+/**
+ * Base class for all Agentick errors.
+ * Provides consistent structure, serialization, and type identification.
+ */
+export class AgentickError extends Error {
+    /** Unique error code for programmatic handling */
+    code;
+    /** Additional error details */
+    details;
+    /** Original error that caused this error */
+    cause;
+    constructor(code, message, details = {}, cause) {
+        super(message);
+        this.name = "AgentickError";
+        this.code = code;
+        this.details = details;
+        this.cause = cause;
+        // Maintain proper prototype chain
+        Object.setPrototypeOf(this, new.target.prototype);
+        // Capture stack trace (V8 engines - Node.js specific)
+        const ErrorWithCapture = Error;
+        if (typeof ErrorWithCapture.captureStackTrace === "function") {
+            ErrorWithCapture.captureStackTrace(this, new.target);
+        }
+    }
+    /**
+     * Serialize error for transport (JSON-safe)
+     */
+    toJSON() {
+        const serialized = {
+            name: this.name,
+            code: this.code,
+            message: this.message,
+        };
+        if (Object.keys(this.details).length > 0) {
+            serialized.details = this.details;
+        }
+        if (this.cause) {
+            if (this.cause instanceof AgentickError) {
+                serialized.cause = this.cause.toJSON();
+            }
+            else if (this.cause instanceof Error) {
+                serialized.cause = {
+                    message: this.cause.message,
+                    name: this.cause.name,
+                };
+            }
+        }
+        if (this.stack) {
+            serialized.stack = this.stack;
+        }
+        return serialized;
+    }
+    /**
+     * Create error from serialized format
+     */
+    static fromJSON(json) {
+        const cause = json.cause
+            ? json.cause.code
+                ? AgentickError.fromJSON(json.cause)
+                : new Error(json.cause.message)
+            : undefined;
+        return new AgentickError(json.code, json.message, json.details, cause);
+    }
+}
+// =============================================================================
+// Abort/Cancellation Errors
+// =============================================================================
+/**
+ * Error thrown when an operation is aborted or cancelled.
+ *
+ * @example
+ * ```typescript
+ * throw new AbortError('User cancelled the operation');
+ * throw new AbortError('Operation timed out', 'ABORT_TIMEOUT', { timeoutMs: 30000 });
+ * ```
+ */
+export class AbortError extends AgentickError {
+    constructor(message = "Operation aborted", code = "ABORT_CANCELLED", details = {}, cause) {
+        super(code, message, details, cause);
+        this.name = "AbortError";
+    }
+    /**
+     * Create from an AbortSignal's reason
+     */
+    static fromSignal(signal) {
+        const reason = signal.reason;
+        if (reason instanceof AbortError) {
+            return reason;
+        }
+        const message = reason instanceof Error ? reason.message : String(reason || "Operation aborted");
+        return new AbortError(message, "ABORT_SIGNAL", {}, reason instanceof Error ? reason : undefined);
+    }
+    /**
+     * Create a timeout abort error
+     */
+    static timeout(timeoutMs) {
+        return new AbortError(`Operation timed out after ${timeoutMs}ms`, "ABORT_TIMEOUT", {
+            timeoutMs,
+        });
+    }
+}
+/**
+ * Error thrown when a required resource cannot be found.
+ *
+ * @example
+ * ```typescript
+ * throw new NotFoundError('model', 'gpt-4');
+ * throw new NotFoundError('tool', 'search', 'Tool not found in registry');
+ * throw new NotFoundError('execution', 'exec-123', 'Parent execution not found');
+ * ```
+ */
+export class NotFoundError extends AgentickError {
+    /** Type of resource that was not found */
+    resourceType;
+    /** Identifier of the resource */
+    resourceId;
+    constructor(resourceType, resourceId, message, cause) {
+        const codeMap = {
+            model: "NOT_FOUND_MODEL",
+            tool: "NOT_FOUND_TOOL",
+            agent: "NOT_FOUND_AGENT",
+            execution: "NOT_FOUND_EXECUTION",
+            channel: "NOT_FOUND_RESOURCE",
+            session: "NOT_FOUND_RESOURCE",
+            procedure: "NOT_FOUND_RESOURCE",
+            "mcp-client": "NOT_FOUND_RESOURCE",
+            scope: "NOT_FOUND_RESOURCE",
+            resource: "NOT_FOUND_RESOURCE",
+        };
+        super(codeMap[resourceType], message || `${resourceType} '${resourceId}' not found`, { resourceType, resourceId }, cause);
+        this.name = "NotFoundError";
+        this.resourceType = resourceType;
+        this.resourceId = resourceId;
+    }
+}
+// =============================================================================
+// Validation Errors
+// =============================================================================
+/**
+ * Error thrown when input validation fails.
+ *
+ * @example
+ * ```typescript
+ * throw new ValidationError('messages', 'Messages are required');
+ * throw new ValidationError('handler', 'Handler function required', { expected: 'function' });
+ * throw new ValidationError('input.model', 'Model identifier must be provided');
+ * ```
+ */
+export class ValidationError extends AgentickError {
+    /** Field or parameter that failed validation */
+    field;
+    /** Expected type or format (optional) */
+    expected;
+    /** Actual value received (optional) */
+    received;
+    constructor(field, message, options = {}, cause) {
+        const code = options.code || "VALIDATION_REQUIRED";
+        super(code, message, {
+            field,
+            ...(options.expected && { expected: options.expected }),
+            ...(options.received && { received: options.received }),
+        }, cause);
+        this.name = "ValidationError";
+        this.field = field;
+        this.expected = options.expected;
+        this.received = options.received;
+    }
+    /**
+     * Create a "required" validation error
+     */
+    static required(field, message) {
+        return new ValidationError(field, message || `${field} is required`, {
+            code: "VALIDATION_REQUIRED",
+        });
+    }
+    /**
+     * Create a "type mismatch" validation error
+     */
+    static type(field, expected, received) {
+        const msg = received
+            ? `${field} must be ${expected}, received ${received}`
+            : `${field} must be ${expected}`;
+        return new ValidationError(field, msg, {
+            expected,
+            received,
+            code: "VALIDATION_TYPE",
+        });
+    }
+}
+// =============================================================================
+// State/Lifecycle Errors
+// =============================================================================
+/**
+ * Error thrown when an operation is attempted in an invalid state.
+ *
+ * @example
+ * ```typescript
+ * throw new StateError('streaming', 'completed', 'Cannot send message to completed execution');
+ * throw new StateError('initializing', 'ready', 'Engine is still initializing');
+ * ```
+ */
+export class StateError extends AgentickError {
+    /** Current state */
+    current;
+    /** Expected/required state (optional) */
+    expectedState;
+    constructor(current, expectedState, message, code = "STATE_INVALID", cause) {
+        super(code, message, { current, ...(expectedState && { expectedState }) }, cause);
+        this.name = "StateError";
+        this.current = current;
+        this.expectedState = expectedState;
+    }
+    /**
+     * Create error for "not ready" state
+     */
+    static notReady(component, current) {
+        return new StateError(current, "ready", `${component} is not ready (current state: ${current})`, "STATE_NOT_READY");
+    }
+    /**
+     * Create error for "already complete" state
+     */
+    static alreadyComplete(operation) {
+        return new StateError("complete", undefined, `Cannot ${operation}: already complete`, "STATE_ALREADY_COMPLETE");
+    }
+}
+// =============================================================================
+// Transport/Network Errors
+// =============================================================================
+/**
+ * Error thrown for network/transport failures.
+ *
+ * @example
+ * ```typescript
+ * throw new TransportError('timeout', 'Request timed out after 30000ms');
+ * throw new TransportError('connection', 'SSE connection error');
+ * throw new TransportError('response', 'No response body');
+ * ```
+ */
+export class TransportError extends AgentickError {
+    /** Type of transport error */
+    transportCode;
+    /** HTTP status code if applicable */
+    statusCode;
+    constructor(transportCode, message, options = {}, cause) {
+        const codeMap = {
+            timeout: "TRANSPORT_TIMEOUT",
+            connection: "TRANSPORT_CONNECTION",
+            response: "TRANSPORT_RESPONSE",
+            parse: "TRANSPORT_PARSE",
+        };
+        super(codeMap[transportCode], message, {
+            transportCode,
+            ...(options.statusCode && { statusCode: options.statusCode }),
+            ...(options.url && { url: options.url }),
+            ...(options.method && { method: options.method }),
+        }, cause);
+        this.name = "TransportError";
+        this.transportCode = transportCode;
+        this.statusCode = options.statusCode;
+    }
+    /**
+     * Create a timeout error
+     */
+    static timeout(timeoutMs, url) {
+        return new TransportError("timeout", `Request timeout after ${timeoutMs}ms`, { url });
+    }
+    /**
+     * Create a connection error
+     */
+    static connection(message, url, cause) {
+        return new TransportError("connection", message, { url }, cause);
+    }
+    /**
+     * Create an HTTP error (non-2xx response)
+     */
+    static http(statusCode, url, message) {
+        return new TransportError("response", message || `HTTP ${statusCode}`, {
+            statusCode,
+            url,
+        });
+    }
+}
+// =============================================================================
+// Adapter/Provider Errors
+// =============================================================================
+/**
+ * Error thrown by model adapters for provider-specific errors.
+ *
+ * @example
+ * ```typescript
+ * throw new AdapterError('openai', 'No message in response', 'ADAPTER_RESPONSE');
+ * throw new AdapterError('google', 'Rate limit exceeded', 'ADAPTER_RATE_LIMIT', { retryAfter: 60 });
+ * throw new AdapterError('anthropic', 'Content blocked', 'ADAPTER_CONTENT_FILTER');
+ * ```
+ */
+export class AdapterError extends AgentickError {
+    /** Provider name (openai, google, anthropic, etc.) */
+    provider;
+    /** Provider-specific error code */
+    providerErrorCode;
+    constructor(provider, message, code = "ADAPTER_RESPONSE", details = {}, cause) {
+        super(code, message, { provider, ...details }, cause);
+        this.name = "AdapterError";
+        this.provider = provider;
+        this.providerErrorCode = details["providerErrorCode"];
+    }
+    /**
+     * Create a rate limit error
+     */
+    static rateLimit(provider, retryAfter) {
+        return new AdapterError(provider, retryAfter ? `Rate limit exceeded. Retry after ${retryAfter}s` : "Rate limit exceeded", "ADAPTER_RATE_LIMIT", { retryAfter });
+    }
+    /**
+     * Create a content filter error
+     */
+    static contentFiltered(provider, reason) {
+        return new AdapterError(provider, reason || "Content was filtered by provider", "ADAPTER_CONTENT_FILTER", { reason });
+    }
+    /**
+     * Create a context length error
+     */
+    static contextLength(provider, maxTokens, requestedTokens) {
+        return new AdapterError(provider, `Context length exceeded. Max: ${maxTokens}${requestedTokens ? `, Requested: ${requestedTokens}` : ""}`, "ADAPTER_CONTEXT_LENGTH", { maxTokens, requestedTokens });
+    }
+}
+// =============================================================================
+// Context Errors
+// =============================================================================
+/**
+ * Error thrown when context is missing or invalid.
+ *
+ * @example
+ * ```typescript
+ * throw new ContextError('Context not found. Ensure you are running within Context.run()');
+ * throw new ContextError('Invalid context: missing required field', 'CONTEXT_INVALID');
+ * ```
+ */
+export class ContextError extends AgentickError {
+    constructor(message, code = "CONTEXT_NOT_FOUND", details = {}, cause) {
+        super(code, message, details, cause);
+        this.name = "ContextError";
+    }
+    /**
+     * Create "context not found" error with helpful message
+     */
+    static notFound() {
+        return new ContextError("Context not found. Ensure you are running within a Context.run() block or using a Kernel Procedure.", "CONTEXT_NOT_FOUND");
+    }
+}
+// =============================================================================
+// Reactivity Errors
+// =============================================================================
+/**
+ * Error thrown for reactivity/signal system issues.
+ *
+ * @example
+ * ```typescript
+ * throw new ReactivityError('Circular dependency detected in computed signal');
+ * throw new ReactivityError('Attempted to set disposed signal', 'REACTIVITY_DISPOSED');
+ * ```
+ */
+export class ReactivityError extends AgentickError {
+    constructor(message, code = "REACTIVITY_CIRCULAR", details = {}, cause) {
+        super(code, message, details, cause);
+        this.name = "ReactivityError";
+    }
+    /**
+     * Create circular dependency error
+     */
+    static circular(signalName) {
+        return new ReactivityError(signalName
+            ? `Circular dependency detected in computed signal '${signalName}'`
+            : "Circular dependency detected in computed signal", "REACTIVITY_CIRCULAR", { signalName });
+    }
+}
+// =============================================================================
+// Guard/Access Control Errors
+// =============================================================================
+/**
+ * Error thrown when a guard denies access to a procedure or resource.
+ *
+ * @example
+ * ```typescript
+ * throw GuardError.role(['admin', 'moderator']);
+ * throw GuardError.denied('Insufficient permissions', { resource: 'settings' });
+ * ```
+ */
+export class GuardError extends AgentickError {
+    /** Type of guard that denied access */
+    guardType;
+    constructor(message, guardType, details = {}, cause) {
+        super("GUARD_DENIED", message, { ...details, ...(guardType && { guardType }) }, cause);
+        this.name = "GuardError";
+        this.guardType = guardType;
+    }
+    /**
+     * Create a role-based guard error
+     */
+    static role(roles) {
+        return new GuardError(`Requires one of roles [${roles.join(", ")}]`, "role", { roles });
+    }
+    /**
+     * Create a custom guard denied error
+     */
+    static denied(reason, details) {
+        return new GuardError(reason, "custom", details);
+    }
+}
+// =============================================================================
+// Type Guards
+// =============================================================================
+/**
+ * Check if error is any Agentick error
+ */
+export function isAgentickError(error) {
+    return error instanceof AgentickError;
+}
+/**
+ * Check if error is an AbortError
+ */
+export function isAbortError(error) {
+    return error instanceof AbortError;
+}
+/**
+ * Check if error is a NotFoundError
+ */
+export function isNotFoundError(error) {
+    return error instanceof NotFoundError;
+}
+/**
+ * Check if error is a ValidationError
+ */
+export function isValidationError(error) {
+    return error instanceof ValidationError;
+}
+/**
+ * Check if error is a StateError
+ */
+export function isStateError(error) {
+    return error instanceof StateError;
+}
+/**
+ * Check if error is a TransportError
+ */
+export function isTransportError(error) {
+    return error instanceof TransportError;
+}
+/**
+ * Check if error is an AdapterError
+ */
+export function isAdapterError(error) {
+    return error instanceof AdapterError;
+}
+/**
+ * Check if error is a ContextError
+ */
+export function isContextError(error) {
+    return error instanceof ContextError;
+}
+/**
+ * Check if error is a ReactivityError
+ */
+export function isReactivityError(error) {
+    return error instanceof ReactivityError;
+}
+/**
+ * Check if error is a GuardError
+ */
+export function isGuardError(error) {
+    return error instanceof GuardError;
+}
+// =============================================================================
+// Utility Functions
+// =============================================================================
+/**
+ * Ensure a value is an Error, wrapping if necessary.
+ * Useful for catch blocks that might receive non-Error values.
+ */
+export function ensureError(value) {
+    if (value instanceof Error) {
+        return value;
+    }
+    return new Error(String(value));
+}
+/**
+ * Wrap any error as an Agentick error if it isn't already.
+ */
+export function wrapAsAgentickError(error, defaultCode = "STATE_INVALID") {
+    if (error instanceof AgentickError) {
+        return error;
+    }
+    const err = ensureError(error);
+    return new AgentickError(defaultCode, err.message, {}, err);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/identity.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Symbol-based identity utilities for minification-safe type checking.
+ *
+ * Functions can be marked with symbols to identify them even after minification
+ * where function names are mangled.
+ *
+ * @example
+ * ```typescript
+ * // Define a symbol for your component type
+ * const MY_COMPONENT_SYMBOL = Symbol.for('agentick.myComponent');
+ *
+ * // Mark the component
+ * export const MyComponent = markWithSymbol(MY_COMPONENT_SYMBOL, (props) => {
+ *   return createElement(MyComponent, props);
+ * });
+ *
+ * // Check identity (minification-safe)
+ * if (hasSymbol(someFunction, MY_COMPONENT_SYMBOL)) {
+ *   // It's a MyComponent
+ * }
+ * ```
+ */
+/**
+ * Symbol used to mark host primitive components.
+ * These are structural primitives that should be handled by the renderer,
+ * not executed as functions.
+ */
+export declare const HOST_PRIMITIVE_SYMBOL: unique symbol;
+/**
+ * Symbol used to mark semantic components.
+ */
+export declare const SEMANTIC_COMPONENT_SYMBOL: unique symbol;
+/**
+ * Symbol used to mark content components.
+ */
+export declare const CONTENT_COMPONENT_SYMBOL: unique symbol;
+/**
+ * Check if a value has a specific symbol marker.
+ *
+ * @param value - The value to check
+ * @param symbol - The symbol to look for
+ * @returns True if the value has the symbol marker
+ */
+export declare function hasSymbol(value: unknown, symbol: symbol): boolean;
+/**
+ * Mark a function with a symbol for identity checking.
+ * Returns the same function with the symbol attached.
+ *
+ * @param symbol - The symbol to attach
+ * @param fn - The function to mark
+ * @returns The same function with the symbol attached
+ */
+export declare function markWithSymbol<T extends Function>(symbol: symbol, fn: T): T;
+/**
+ * Mark a function as a host primitive.
+ * Host primitives are structural components that should be handled by the
+ * renderer directly, not executed as functions.
+ *
+ * @param fn - The function to mark as a host primitive
+ * @returns The same function marked as a host primitive
+ */
+export declare function markAsHostPrimitive<T extends Function>(fn: T): T;
+/**
+ * Check if a value is a host primitive component.
+ * Minification-safe - uses symbol identity, not function name.
+ *
+ * @param value - The value to check
+ * @returns True if it's a host primitive
+ */
+export declare function isHostPrimitive(value: unknown): boolean;
+/**
+ * Mark a function as a semantic component.
+ *
+ * @param fn - The function to mark
+ * @returns The same function marked as a semantic component
+ */
+export declare function markAsSemanticComponent<T extends Function>(fn: T): T;
+/**
+ * Check if a value is a semantic component.
+ *
+ * @param value - The value to check
+ * @returns True if it's a semantic component
+ */
+export declare function isSemanticComponent(value: unknown): boolean;
+/**
+ * Mark a function as a content component.
+ *
+ * @param fn - The function to mark
+ * @returns The same function marked as a content component
+ */
+export declare function markAsContentComponent<T extends Function>(fn: T): T;
+/**
+ * Check if a value is a content component.
+ *
+ * @param value - The value to check
+ * @returns True if it's a content component
+ */
+export declare function isContentComponent(value: unknown): boolean;
+//# sourceMappingURL=identity.d.ts.map

package/dist/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,eAAuC,CAAC;AAE1E;;GAEG;AACH,eAAO,MAAM,yBAAyB,eAA2C,CAAC;AAElF;;GAEG;AACH,eAAO,MAAM,wBAAwB,eAA0C,CAAC;AAEhF;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAIjE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAG3E;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,QAAQ,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAEhE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEvD;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,QAAQ,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAEpE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE3D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,QAAQ,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAEnE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE1D"}