@elevasis/sdk 0.4.5 → 0.4.7

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 
 /**
- * Workflow-specific logging types
+ * Workflow-specific logging types and utilities
  */
 
 interface WorkflowExecutionContext {
@@ -677,16 +677,12 @@ interface WorkflowStepDefinition {
     description: string;
 }
 type StepHandler = (input: unknown, context: ExecutionContext) => Promise<unknown>;
-declare enum StepType$1 {
-    LINEAR = "linear",
-    CONDITIONAL = "conditional"
-}
 interface LinearNext {
-    type: StepType$1.LINEAR;
+    type: 'linear';
     target: string;
 }
 interface ConditionalNext {
-    type: StepType$1.CONDITIONAL;
+    type: 'conditional';
     routes: Array<{
         condition: (data: unknown) => boolean;
         target: string;
@@ -717,6 +713,63 @@ interface WorkflowDefinition {
     interface?: ExecutionInterface;
 }
 
+/**
+ * Generic LLM Types
+ * Universal interfaces for LLM interaction across all resource types
+ */
+/**
+ * Standard chat message format
+ * Compatible with OpenAI, Anthropic, and other providers
+ */
+interface LLMMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+/**
+ * Generic LLM generation request
+ * Usable by agents, workflows, tools, etc.
+ */
+interface LLMGenerateRequest {
+    messages: LLMMessage[];
+    responseSchema: unknown;
+    maxTokens?: number;
+    temperature?: number;
+    topP?: number;
+    signal?: AbortSignal;
+}
+/**
+ * Generic LLM generation response
+ * Usage field is internal-only (stripped by UniversalLLMAdapter wrapper)
+ */
+interface LLMGenerateResponse<T = unknown> {
+    output: T;
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+        totalTokens: number;
+    };
+    cost?: number;
+}
+/**
+ * LLM Adapter interface
+ * Generic primitive for all resource types (agents, workflows, tools)
+ *
+ * Design principles:
+ * - Single method: generate() - the core LLM primitive
+ * - Generic return type for type safety
+ * - Universal format (not agent-specific)
+ * - Standard message-based input (OpenAI-compatible)
+ */
+interface LLMAdapter {
+    /**
+     * Generate structured output from prompt using LLM
+     *
+     * @param request - Generation request with messages and response schema
+     * @returns Generated output (typed) with optional usage metadata
+     */
+    generate<T = unknown>(request: LLMGenerateRequest): Promise<LLMGenerateResponse<T>>;
+}
+
 /**
  * Memory type definitions
  * Types for agent memory management with semantic entry types
@@ -946,6 +999,16 @@ interface KnowledgeContent {
  * Types for autonomous agents with tools, memory, and constraints
  */
 
+/**
+ * Factory function for creating LLM adapters.
+ * Injected into the Agent class to decouple the engine from server-only provider SDKs.
+ * - API process: provides createLLMAdapter (real SDKs + process.env API keys)
+ * - SDK worker: provides PostMessageLLMAdapter (proxies via platform.call)
+ *
+ * Uses `any` for optional params so both the real createLLMAdapter (with typed
+ * AIUsageCollector/AICallContext) and the worker proxy (which ignores them) satisfy the type.
+ */
+type LLMAdapterFactory = (config: ModelConfig, ...args: any[]) => LLMAdapter;
 interface AgentConfig extends ResourceDefinition {
     type: 'agent';
     systemPrompt: string;
@@ -1040,6 +1103,7 @@ interface IterationContext {
     iteration: number;
     logger: AgentScopedLogger;
     modelConfig: ModelConfig;
+    adapterFactory: LLMAdapterFactory;
     knowledgeMap?: KnowledgeMap;
 }
 
@@ -1065,10 +1129,10 @@ interface RemoteOrgConfig {
     bundlePath: string;
     /** Deployment record ID */
     deploymentId: string;
-    /** Developer-provided environment variables injected into the worker */
-    envVars?: Record<string, string>;
     /** Platform tool name -> credential name mapping */
     toolCredentials?: Record<string, string>;
+    /** SDK version used to deploy this bundle */
+    sdkVersion?: string;
 }
 /**
  * Organization-specific resource collection
@@ -1931,10 +1995,11 @@ interface ElevasConfig {
  * Values are identical to their core package counterparts.
  */
 /** Step connection type for multi-step workflows */
-declare enum StepType {
-    LINEAR = "linear",
-    CONDITIONAL = "conditional"
-}
+declare const StepType: {
+    readonly LINEAR: "linear";
+    readonly CONDITIONAL: "conditional";
+};
+type StepType = typeof StepType[keyof typeof StepType];
 /** Base error class for execution errors */
 declare class ExecutionError extends Error {
     readonly type: string;
@@ -1950,4 +2015,4 @@ declare class ToolingError extends ExecutionError {
 }
 
 export { ExecutionError, RegistryValidationError, ResourceRegistry, 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 };
+export type { AgentConfig, AgentConstraints, AgentDefinition, ConditionalNext, Contract, DomainDefinition, ElevasConfig, EventTriggerConfig, ExecutionContext, ExecutionInterface, ExecutionMetadata, FormField, FormFieldType, FormSchema, IntegrationDefinition, LLMAdapterFactory, 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

@@ -8,11 +8,10 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
 });
 
 // src/runtime.ts
-var StepType = /* @__PURE__ */ ((StepType2) => {
-  StepType2["LINEAR"] = "linear";
-  StepType2["CONDITIONAL"] = "conditional";
-  return StepType2;
-})(StepType || {});
+var StepType = {
+  LINEAR: "linear",
+  CONDITIONAL: "conditional"
+};
 var ExecutionError = class extends Error {
   type;
   context;
@@ -201,7 +200,7 @@ var GPT5OptionsSchema = z.object({
 var GPT5ConfigSchema = z.object({
   model: z.enum(["gpt-5", "gpt-5-mini"]),
   provider: z.enum(["openai"]),
-  apiKey: z.string().min(1),
+  apiKey: z.string(),
   temperature: z.literal(1),
   // Required to be exactly 1
   maxTokens: z.number().min(4e3).optional(),
@@ -231,7 +230,7 @@ var OpenRouterConfigSchema = z.object({
     "openrouter/x-ai/grok-4.1-fast"
   ]),
   provider: z.literal("openrouter"),
-  apiKey: z.string().min(1),
+  apiKey: z.string(),
   temperature: z.number().min(0).max(2).optional(),
   maxTokens: z.number().min(500).optional(),
   topP: z.number().min(0).max(1).optional(),
@@ -244,7 +243,7 @@ var GoogleOptionsSchema = z.object({
 var GoogleConfigSchema = z.object({
   model: z.enum(["gemini-3-flash-preview"]),
   provider: z.literal("google"),
-  apiKey: z.string().min(1),
+  apiKey: z.string(),
   temperature: z.literal(1).optional(),
   // Must be 1 for Gemini 3 (changing degrades performance)
   maxTokens: z.number().min(500).optional(),
@@ -255,7 +254,7 @@ var AnthropicOptionsSchema = z.object({});
 var AnthropicConfigSchema = z.object({
   model: z.enum(["claude-opus-4-5", "claude-sonnet-4-5", "claude-haiku-4-5"]),
   provider: z.literal("anthropic"),
-  apiKey: z.string().min(1),
+  apiKey: z.string(),
   temperature: z.number().min(0).max(1).optional(),
   maxTokens: z.number().min(1e3).optional(),
   // Anthropic requires max_tokens
@@ -2801,6 +2800,12 @@ var zodToJsonSchema = (schema, options) => {
   return combined;
 };
 
+// ../core/src/execution/engine/workflow/types.ts
+var StepType2 = {
+  LINEAR: "linear",
+  CONDITIONAL: "conditional"
+};
+
 // ../core/src/execution/engine/base/serialization.ts
 function serializeDefinition(definition, options) {
   const opts = {
@@ -2885,13 +2890,13 @@ function serializeKnowledgeMap(km, ctx) {
 }
 function serializeNextConfig(nextConfig, _context) {
   if (!nextConfig) return null;
-  if (nextConfig.type === "linear" /* LINEAR */) {
+  if (nextConfig.type === StepType2.LINEAR) {
     return {
       type: nextConfig.type,
       target: nextConfig.target
     };
   }
-  if (nextConfig.type === "conditional" /* CONDITIONAL */) {
+  if (nextConfig.type === StepType2.CONDITIONAL) {
     return {
       type: nextConfig.type,
       routes: nextConfig.routes?.map((route) => ({
@@ -2943,7 +2948,7 @@ function isKnowledgeMapObject(value) {
   return value && typeof value === "object" && "nodes" in value && typeof value.nodes === "object";
 }
 function isNextConfigObject(value) {
-  return value && typeof value === "object" && "type" in value && (value.type === "linear" /* LINEAR */ || value.type === "conditional" /* CONDITIONAL */);
+  return value && typeof value === "object" && "type" in value && (value.type === StepType2.LINEAR || value.type === StepType2.CONDITIONAL);
 }
 function isSecretKey(key) {
   const lower = key.toLowerCase();