@elevasis/sdk 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -1,79 +1,5 @@
 import { z } from 'zod';
 
-/**
- * Error categories for observability grouping and classification.
- * Used to categorize errors in the execution_errors table metadata.
- */
-type ExecutionErrorCategory = 'llm' | 'tool' | 'workflow' | 'agent' | 'validation' | 'system';
-/**
- * Abstract base class for all execution engine errors.
- * Enforces contract for execution_errors table insertion with explicit type,
- * severity, category, and context properties.
- *
- * All execution engine errors MUST extend this class to ensure proper error
- * tracking and observability in the execution_errors table.
- *
- * @example
- * ```typescript
- * export class MyExecutionError extends ExecutionError {
- *   readonly type = 'my_execution_error' as const
- *   readonly severity = 'warning' as const
- *   readonly category = 'workflow' as const
- *
- *   constructor(message: string, context?: Record<string, unknown>) {
- *     super(message, context)
- *   }
- * }
- * ```
- */
-declare abstract class ExecutionError extends Error {
-    /**
-     * Error type identifier for execution_errors table.
-     * Should be a unique, snake_case string that identifies this specific error class.
-     * Used for filtering, aggregation, and error-specific handling in observability systems.
-     */
-    abstract readonly type: string;
-    /**
-     * Error severity level for execution_errors table.
-     * - critical: System failures, auth issues, resource exhaustion - execution cannot continue
-     * - warning: Transient failures, configuration errors - execution may retry or requires user correction
-     * - info: Validation failures, expected user errors - user/developer action needed
-     */
-    abstract readonly severity: 'critical' | 'warning' | 'info';
-    /**
-     * Error category for observability grouping.
-     * Used to categorize errors in dashboards and analytics.
-     */
-    abstract readonly category: ExecutionErrorCategory;
-    /**
-     * Additional context/metadata for the error.
-     * Stored in execution_errors.metadata JSONB column.
-     */
-    readonly context?: Record<string, unknown>;
-    /**
-     * @param message - Human-readable error message
-     * @param context - Additional context/metadata for observability
-     */
-    constructor(message: string, context?: Record<string, unknown>);
-    /**
-     * Indicates whether this error type is retryable.
-     * Default: false (safe default - only retry when explicitly safe to do so)
-     *
-     * Subclasses should override to return true for retryable scenarios:
-     * - Network/infrastructure errors (exponential backoff)
-     * - Rate limiting (linear backoff)
-     * - Service availability (exponential backoff)
-     * - Circuit breaker (circuit breaker's own delay)
-     *
-     * DO NOT retry:
-     * - Authentication/authorization errors
-     * - Validation errors
-     * - Configuration errors
-     * - Resource exhaustion errors
-     */
-    isRetryable(): boolean;
-}
-
 /**
  * Workflow-specific logging types
  */
@@ -525,16 +451,16 @@ interface WorkflowStepDefinition {
     description: string;
 }
 type StepHandler = (input: unknown, context: ExecutionContext) => Promise<unknown>;
-declare enum StepType {
+declare enum StepType$1 {
     LINEAR = "linear",
     CONDITIONAL = "conditional"
 }
 interface LinearNext {
-    type: StepType.LINEAR;
+    type: StepType$1.LINEAR;
     target: string;
 }
 interface ConditionalNext {
-    type: StepType.CONDITIONAL;
+    type: StepType$1.CONDITIONAL;
     routes: Array<{
         condition: (data: unknown) => boolean;
         target: string;
@@ -1162,44 +1088,6 @@ interface Tool {
  * Used across platform tools and integration tools
  */
 type ToolingErrorType = 'service_unavailable' | 'permission_denied' | 'adapter_not_found' | 'method_not_found' | 'tool_not_found' | 'credentials_missing' | 'credentials_invalid' | 'rate_limit_exceeded' | 'server_unavailable' | 'auth_error' | 'api_error' | 'validation_error' | 'network_error' | 'timeout_error' | 'unknown_error';
-/**
- * Tooling error class
- * Provides structured error information for tool failures across all tool types
- *
- * Severity mapping:
- * - critical: credentials_missing, credentials_invalid, permission_denied, auth_error,
- *            adapter_not_found, method_not_found, tool_not_found
- * - info: validation_error
- * - warning: All other types (retryable transient errors)
- *
- * Category: tool (tool execution errors)
- */
-declare class ToolingError extends ExecutionError {
-    readonly errorType: ToolingErrorType;
-    readonly details?: unknown | undefined;
-    readonly type: "tooling_error";
-    readonly category: "tool";
-    constructor(errorType: ToolingErrorType, message: string, details?: unknown | undefined);
-    /**
-     * Derive severity based on error type
-     */
-    get severity(): 'critical' | 'warning' | 'info';
-    /**
-     * Check if error is retryable
-     */
-    isRetryable(): boolean;
-    /**
-     * Convert to JSON for logging
-     */
-    toJSON(): {
-        name: string;
-        type: ToolingErrorType;
-        message: string;
-        severity: "critical" | "warning" | "info";
-        category: "tool";
-        details: unknown;
-    };
-}
 
 /**
  * Supported integration types
@@ -1557,5 +1445,31 @@ interface ElevasConfig {
     };
 }
 
+/**
+ * Runtime values for SDK developers.
+ *
+ * These are standalone definitions (not re-exported from @repo/core)
+ * to avoid pulling in the entire execution engine dependency tree (~3.5MB).
+ * Values are identical to their @repo/core counterparts.
+ */
+/** Step connection type for multi-step workflows */
+declare enum StepType {
+    LINEAR = "linear",
+    CONDITIONAL = "conditional"
+}
+/** Base error class for execution errors */
+declare class ExecutionError extends Error {
+    readonly type: string;
+    readonly context?: Record<string, unknown>;
+    constructor(message: string, context?: Record<string, unknown>);
+    isRetryable(): boolean;
+}
+/** Error thrown from tool execution handlers */
+declare class ToolingError extends ExecutionError {
+    readonly errorType: string;
+    readonly details?: unknown;
+    constructor(errorType: string, message: string, details?: unknown);
+}
+
 export { ExecutionError, StepType, ToolingError };
 export type { AgentConfig, AgentConstraints, AgentDefinition, ConditionalNext, Contract, DomainDefinition, ElevasConfig, EventTriggerConfig, ExecutionContext, ExecutionInterface, ExecutionMetadata, FormField, FormFieldType, FormSchema, IntegrationDefinition, LLMModel, LinearNext, ModelConfig, NextConfig, OrganizationResources, ResourceDefinition, ResourceDomain, ResourceMetricsConfig, ResourceStatus, ResourceType, ScheduleTriggerConfig, StepHandler, Tool, ToolExecutionOptions, ToolingErrorType, TriggerConfig, TriggerDefinition, WebhookProviderType, WebhookTriggerConfig, WorkflowConfig, WorkflowDefinition, WorkflowStep };

package/dist/index.js

@@ -1 +1,33 @@
+// src/runtime.ts
+var StepType = /* @__PURE__ */ ((StepType2) => {
+  StepType2["LINEAR"] = "linear";
+  StepType2["CONDITIONAL"] = "conditional";
+  return StepType2;
+})(StepType || {});
+var ExecutionError = class extends Error {
+  type;
+  context;
+  constructor(message, context) {
+    super(message);
+    this.name = this.constructor.name;
+    this.type = "execution_error";
+    this.context = context;
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, this.constructor);
+    }
+  }
+  isRetryable() {
+    return false;
+  }
+};
+var ToolingError = class extends ExecutionError {
+  errorType;
+  details;
+  constructor(errorType, message, details) {
+    super(message, { type: errorType, details });
+    this.errorType = errorType;
+    this.details = details;
+  }
+};
 
+export { ExecutionError, StepType, ToolingError };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevasis/sdk",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "SDK for building Elevasis organization resources",
   "type": "module",
   "exports": {