@axlsdk/axl 0.1.1 → 0.3.0

package/dist/index.d.cts

@@ -220,7 +220,7 @@ type AgentConfig = {
     system: string | ((ctx: {
         metadata?: Record<string, unknown>;
     }) => string);
-    tools?: Tool[];
+    tools?: Tool<any, any>[];
     handoffs?: HandoffDescriptor[];
     mcp?: string[];
     mcpTools?: string[];
@@ -611,6 +611,8 @@ interface StateStore {
     }>>;
     /** Delete a memory entry by key. */
     deleteMemory?(scope: string, key: string): Promise<void>;
+    /** List all session IDs (used by Studio session browser). */
+    listSessions?(): Promise<string[]>;
     close?(): Promise<void>;
     deleteCheckpoints?(executionId: string): Promise<void>;
 }
@@ -754,6 +756,8 @@ declare class MemoryManager {
     close(): Promise<void>;
 }
 
+/** Convert a Zod schema to JSON Schema (subset). Exported for Studio tool introspection. */
+declare function zodToJsonSchema(schema: z.ZodTypeAny): unknown;
 type WorkflowContextInit = {
     input: unknown;
     executionId: string;
@@ -918,9 +922,9 @@ type RetryPolicy = {
 /** Lifecycle hooks for tool execution. */
 type ToolHooks<TInput = unknown, TOutput = unknown> = {
     /** Transform input before the handler runs. Receives parsed input and workflow context. */
-    before?: (input: TInput, ctx: WorkflowContext) => TInput | Promise<TInput>;
+    before?(input: TInput, ctx: WorkflowContext): TInput | Promise<TInput>;
     /** Transform output after the handler runs. Receives handler result and workflow context. */
-    after?: (output: TOutput, ctx: WorkflowContext) => TOutput | Promise<TOutput>;
+    after?(output: TOutput, ctx: WorkflowContext): TOutput | Promise<TOutput>;
 };
 /** Tool configuration */
 type ToolConfig<TInput extends z.ZodTypeAny, TOutput = unknown> = {
@@ -1064,11 +1068,14 @@ type ExecuteOptions = {
 declare class AxlRuntime extends EventEmitter {
     private config;
     private workflows;
+    private tools;
+    private agents;
     private providerRegistry;
     private stateStore;
     private executions;
     private pendingDecisionResolvers;
     private abortControllers;
+    private registeredEvals;
     private mcpManager?;
     private memoryManager?;
     private spanManager;
@@ -1087,7 +1094,54 @@ declare class AxlRuntime extends EventEmitter {
     getMcpManager(): McpManager | undefined;
     private createStateStore;
     /** Register a workflow with the runtime. */
-    register(workflow: Workflow): void;
+    register(workflow: Workflow<any, any>): void;
+    /** Register standalone tools for Studio introspection and direct testing. */
+    registerTool(...tools: Tool<any, any>[]): void;
+    /** Register standalone agents for Studio playground and introspection. */
+    registerAgent(...agents: Agent[]): void;
+    /** Get all registered workflow names. */
+    getWorkflowNames(): string[];
+    /** Get a registered workflow by name. */
+    getWorkflow(name: string): Workflow | undefined;
+    /** Get all registered workflows. */
+    getWorkflows(): Workflow[];
+    /** Get all registered standalone tools. */
+    getTools(): Tool[];
+    /** Get a registered standalone tool by name. */
+    getTool(name: string): Tool | undefined;
+    /** Get all registered standalone agents. */
+    getAgents(): Agent[];
+    /** Get a registered standalone agent by name. */
+    getAgent(name: string): Agent | undefined;
+    /**
+     * Register an eval config for Studio introspection and execution.
+     * The config should be the result of `defineEval()` from `@axlsdk/eval`.
+     * An optional `executeWorkflow` function can override the default behavior
+     * of calling `runtime.execute()`.
+     */
+    registerEval(name: string, config: unknown, executeWorkflow?: (input: unknown) => Promise<{
+        output: unknown;
+        cost?: number;
+    }>): void;
+    /** Get metadata about all registered evals. */
+    getRegisteredEvals(): Array<{
+        name: string;
+        workflow: string;
+        dataset: string;
+        scorers: string[];
+    }>;
+    /** Get a registered eval config by name. */
+    getRegisteredEval(name: string): {
+        config: unknown;
+        executeWorkflow?: (input: unknown) => Promise<{
+            output: unknown;
+            cost?: number;
+        }>;
+    } | undefined;
+    /** Run a registered eval by name. */
+    runRegisteredEval(name: string): Promise<unknown>;
+    /** Get all execution info (running + completed). */
+    getExecutions(): ExecutionInfo[];
     /** Register a custom provider instance. */
     registerProvider(name: string, provider: Provider): void;
     /** Execute a workflow and return the result. */
@@ -1133,19 +1187,19 @@ declare class AxlRuntime extends EventEmitter {
      */
     eval(config: {
         workflow: string;
-        dataset: any;
-        scorers: any[];
+        dataset: unknown;
+        scorers: unknown[];
         concurrency?: number;
         budget?: string;
-        metadata?: Record<string, any>;
-    }): Promise<any>;
+        metadata?: Record<string, unknown>;
+    }): Promise<unknown>;
     /**
      * Compare two evaluation results to detect regressions and improvements.
      * Requires `axl-eval` as a peer dependency.
      *
      * @see Spec Section 13.6
      */
-    evalCompare(baseline: any, candidate: any): Promise<any>;
+    evalCompare(baseline: unknown, candidate: unknown): Promise<unknown>;
     /**
      * Handle trace event output based on configuration.
      *
@@ -1419,6 +1473,7 @@ declare class MemoryStore implements StateStore {
         value: unknown;
     }>>;
     deleteMemory(scope: string, key: string): Promise<void>;
+    listSessions(): Promise<string[]>;
     close(): Promise<void>;
     deleteCheckpoints(executionId: string): Promise<void>;
     private persistAwaitHumanState;
@@ -1455,6 +1510,7 @@ declare class SQLiteStore implements StateStore {
     saveExecutionState(executionId: string, state: ExecutionState): Promise<void>;
     getExecutionState(executionId: string): Promise<ExecutionState | null>;
     listPendingExecutions(): Promise<string[]>;
+    listSessions(): Promise<string[]>;
     saveMemory(scope: string, key: string, value: unknown): Promise<void>;
     getMemory(scope: string, key: string): Promise<unknown | null>;
     getAllMemory(scope: string): Promise<Array<{
@@ -1502,6 +1558,7 @@ declare class RedisStore implements StateStore {
     saveExecutionState(executionId: string, state: ExecutionState): Promise<void>;
     getExecutionState(executionId: string): Promise<ExecutionState | null>;
     listPendingExecutions(): Promise<string[]>;
+    listSessions(): Promise<string[]>;
     /** Close the Redis connection. */
     close(): Promise<void>;
     deleteCheckpoints(executionId: string): Promise<void>;
@@ -1573,4 +1630,4 @@ declare class NoopSpanManager implements SpanManager {
  */
 declare function createSpanManager(config?: TelemetryConfig): Promise<SpanManager>;
 
-export { type Agent, type AgentConfig, AnthropicProvider, type AskOptions, type AwaitHumanOptions, type AxlConfig, AxlError, AxlRuntime, AxlStream, BudgetExceededError, type BudgetOptions, type BudgetResult, type ChatMessage, type ChatOptions, type Embedder, type ExecutionInfo, type ExecutionState, GeminiProvider, type GuardrailBlockHandler, GuardrailError, type GuardrailResult, type GuardrailsConfig, type HandoffDescriptor, type HandoffRecord, type HumanDecision, InMemoryVectorStore, type InputGuardrail, type MapOptions, MaxTurnsError, McpManager, type McpServer, type McpServerConfig, type McpToolDefinition, type McpToolResult, type MemoryConfig, MemoryManager, MemoryStore, NoConsensus, NoopSpanManager, OpenAIEmbedder, OpenAIProvider, OpenAIResponsesProvider, type OutputGuardrail, type PendingDecision, type Provider, type ProviderAdapter, ProviderRegistry, type ProviderResponse, QuorumNotMet, type RaceOptions, type RecallOptions, RedisStore, type RememberOptions, type Result, type RetryPolicy, SQLiteStore, Session, type SessionOptions, type SpanHandle, type SpanManager, type SpawnOptions, SqliteVectorStore, type StateStore, type StreamChunk, type StreamEvent, type TelemetryConfig, TimeoutError, type Tool, type ToolCallMessage, type ToolConfig, ToolDenied, type ToolHooks, type TraceEvent, type VectorEntry, type VectorResult, type VectorStore, VerifyError, type VerifyOptions, type VoteOptions, type Workflow, type WorkflowConfig, WorkflowContext, type WorkflowContextInit, agent, createSpanManager, defineConfig, tool, workflow };
+export { type Agent, type AgentConfig, AnthropicProvider, type AskOptions, type AwaitHumanOptions, type AxlConfig, AxlError, AxlRuntime, AxlStream, BudgetExceededError, type BudgetOptions, type BudgetResult, type ChatMessage, type ChatOptions, type Embedder, type ExecutionInfo, type ExecutionState, GeminiProvider, type GuardrailBlockHandler, GuardrailError, type GuardrailResult, type GuardrailsConfig, type HandoffDescriptor, type HandoffRecord, type HumanDecision, InMemoryVectorStore, type InputGuardrail, type MapOptions, MaxTurnsError, McpManager, type McpServer, type McpServerConfig, type McpToolDefinition, type McpToolResult, type MemoryConfig, MemoryManager, MemoryStore, NoConsensus, NoopSpanManager, OpenAIEmbedder, OpenAIProvider, OpenAIResponsesProvider, type OutputGuardrail, type PendingDecision, type Provider, type ProviderAdapter, ProviderRegistry, type ProviderResponse, QuorumNotMet, type RaceOptions, type RecallOptions, RedisStore, type RememberOptions, type Result, type RetryPolicy, SQLiteStore, Session, type SessionOptions, type SpanHandle, type SpanManager, type SpawnOptions, SqliteVectorStore, type StateStore, type StreamChunk, type StreamEvent, type TelemetryConfig, TimeoutError, type Tool, type ToolCallMessage, type ToolConfig, ToolDenied, type ToolHooks, type TraceEvent, type VectorEntry, type VectorResult, type VectorStore, VerifyError, type VerifyOptions, type VoteOptions, type Workflow, type WorkflowConfig, WorkflowContext, type WorkflowContextInit, agent, createSpanManager, defineConfig, tool, workflow, zodToJsonSchema };

package/dist/index.d.ts

@@ -220,7 +220,7 @@ type AgentConfig = {
     system: string | ((ctx: {
         metadata?: Record<string, unknown>;
     }) => string);
-    tools?: Tool[];
+    tools?: Tool<any, any>[];
     handoffs?: HandoffDescriptor[];
     mcp?: string[];
     mcpTools?: string[];
@@ -611,6 +611,8 @@ interface StateStore {
     }>>;
     /** Delete a memory entry by key. */
     deleteMemory?(scope: string, key: string): Promise<void>;
+    /** List all session IDs (used by Studio session browser). */
+    listSessions?(): Promise<string[]>;
     close?(): Promise<void>;
     deleteCheckpoints?(executionId: string): Promise<void>;
 }
@@ -754,6 +756,8 @@ declare class MemoryManager {
     close(): Promise<void>;
 }
 
+/** Convert a Zod schema to JSON Schema (subset). Exported for Studio tool introspection. */
+declare function zodToJsonSchema(schema: z.ZodTypeAny): unknown;
 type WorkflowContextInit = {
     input: unknown;
     executionId: string;
@@ -918,9 +922,9 @@ type RetryPolicy = {
 /** Lifecycle hooks for tool execution. */
 type ToolHooks<TInput = unknown, TOutput = unknown> = {
     /** Transform input before the handler runs. Receives parsed input and workflow context. */
-    before?: (input: TInput, ctx: WorkflowContext) => TInput | Promise<TInput>;
+    before?(input: TInput, ctx: WorkflowContext): TInput | Promise<TInput>;
     /** Transform output after the handler runs. Receives handler result and workflow context. */
-    after?: (output: TOutput, ctx: WorkflowContext) => TOutput | Promise<TOutput>;
+    after?(output: TOutput, ctx: WorkflowContext): TOutput | Promise<TOutput>;
 };
 /** Tool configuration */
 type ToolConfig<TInput extends z.ZodTypeAny, TOutput = unknown> = {
@@ -1064,11 +1068,14 @@ type ExecuteOptions = {
 declare class AxlRuntime extends EventEmitter {
     private config;
     private workflows;
+    private tools;
+    private agents;
     private providerRegistry;
     private stateStore;
     private executions;
     private pendingDecisionResolvers;
     private abortControllers;
+    private registeredEvals;
     private mcpManager?;
     private memoryManager?;
     private spanManager;
@@ -1087,7 +1094,54 @@ declare class AxlRuntime extends EventEmitter {
     getMcpManager(): McpManager | undefined;
     private createStateStore;
     /** Register a workflow with the runtime. */
-    register(workflow: Workflow): void;
+    register(workflow: Workflow<any, any>): void;
+    /** Register standalone tools for Studio introspection and direct testing. */
+    registerTool(...tools: Tool<any, any>[]): void;
+    /** Register standalone agents for Studio playground and introspection. */
+    registerAgent(...agents: Agent[]): void;
+    /** Get all registered workflow names. */
+    getWorkflowNames(): string[];
+    /** Get a registered workflow by name. */
+    getWorkflow(name: string): Workflow | undefined;
+    /** Get all registered workflows. */
+    getWorkflows(): Workflow[];
+    /** Get all registered standalone tools. */
+    getTools(): Tool[];
+    /** Get a registered standalone tool by name. */
+    getTool(name: string): Tool | undefined;
+    /** Get all registered standalone agents. */
+    getAgents(): Agent[];
+    /** Get a registered standalone agent by name. */
+    getAgent(name: string): Agent | undefined;
+    /**
+     * Register an eval config for Studio introspection and execution.
+     * The config should be the result of `defineEval()` from `@axlsdk/eval`.
+     * An optional `executeWorkflow` function can override the default behavior
+     * of calling `runtime.execute()`.
+     */
+    registerEval(name: string, config: unknown, executeWorkflow?: (input: unknown) => Promise<{
+        output: unknown;
+        cost?: number;
+    }>): void;
+    /** Get metadata about all registered evals. */
+    getRegisteredEvals(): Array<{
+        name: string;
+        workflow: string;
+        dataset: string;
+        scorers: string[];
+    }>;
+    /** Get a registered eval config by name. */
+    getRegisteredEval(name: string): {
+        config: unknown;
+        executeWorkflow?: (input: unknown) => Promise<{
+            output: unknown;
+            cost?: number;
+        }>;
+    } | undefined;
+    /** Run a registered eval by name. */
+    runRegisteredEval(name: string): Promise<unknown>;
+    /** Get all execution info (running + completed). */
+    getExecutions(): ExecutionInfo[];
     /** Register a custom provider instance. */
     registerProvider(name: string, provider: Provider): void;
     /** Execute a workflow and return the result. */
@@ -1133,19 +1187,19 @@ declare class AxlRuntime extends EventEmitter {
      */
     eval(config: {
         workflow: string;
-        dataset: any;
-        scorers: any[];
+        dataset: unknown;
+        scorers: unknown[];
         concurrency?: number;
         budget?: string;
-        metadata?: Record<string, any>;
-    }): Promise<any>;
+        metadata?: Record<string, unknown>;
+    }): Promise<unknown>;
     /**
      * Compare two evaluation results to detect regressions and improvements.
      * Requires `axl-eval` as a peer dependency.
      *
      * @see Spec Section 13.6
      */
-    evalCompare(baseline: any, candidate: any): Promise<any>;
+    evalCompare(baseline: unknown, candidate: unknown): Promise<unknown>;
     /**
      * Handle trace event output based on configuration.
      *
@@ -1419,6 +1473,7 @@ declare class MemoryStore implements StateStore {
         value: unknown;
     }>>;
     deleteMemory(scope: string, key: string): Promise<void>;
+    listSessions(): Promise<string[]>;
     close(): Promise<void>;
     deleteCheckpoints(executionId: string): Promise<void>;
     private persistAwaitHumanState;
@@ -1455,6 +1510,7 @@ declare class SQLiteStore implements StateStore {
     saveExecutionState(executionId: string, state: ExecutionState): Promise<void>;
     getExecutionState(executionId: string): Promise<ExecutionState | null>;
     listPendingExecutions(): Promise<string[]>;
+    listSessions(): Promise<string[]>;
     saveMemory(scope: string, key: string, value: unknown): Promise<void>;
     getMemory(scope: string, key: string): Promise<unknown | null>;
     getAllMemory(scope: string): Promise<Array<{
@@ -1502,6 +1558,7 @@ declare class RedisStore implements StateStore {
     saveExecutionState(executionId: string, state: ExecutionState): Promise<void>;
     getExecutionState(executionId: string): Promise<ExecutionState | null>;
     listPendingExecutions(): Promise<string[]>;
+    listSessions(): Promise<string[]>;
     /** Close the Redis connection. */
     close(): Promise<void>;
     deleteCheckpoints(executionId: string): Promise<void>;
@@ -1573,4 +1630,4 @@ declare class NoopSpanManager implements SpanManager {
  */
 declare function createSpanManager(config?: TelemetryConfig): Promise<SpanManager>;
 
-export { type Agent, type AgentConfig, AnthropicProvider, type AskOptions, type AwaitHumanOptions, type AxlConfig, AxlError, AxlRuntime, AxlStream, BudgetExceededError, type BudgetOptions, type BudgetResult, type ChatMessage, type ChatOptions, type Embedder, type ExecutionInfo, type ExecutionState, GeminiProvider, type GuardrailBlockHandler, GuardrailError, type GuardrailResult, type GuardrailsConfig, type HandoffDescriptor, type HandoffRecord, type HumanDecision, InMemoryVectorStore, type InputGuardrail, type MapOptions, MaxTurnsError, McpManager, type McpServer, type McpServerConfig, type McpToolDefinition, type McpToolResult, type MemoryConfig, MemoryManager, MemoryStore, NoConsensus, NoopSpanManager, OpenAIEmbedder, OpenAIProvider, OpenAIResponsesProvider, type OutputGuardrail, type PendingDecision, type Provider, type ProviderAdapter, ProviderRegistry, type ProviderResponse, QuorumNotMet, type RaceOptions, type RecallOptions, RedisStore, type RememberOptions, type Result, type RetryPolicy, SQLiteStore, Session, type SessionOptions, type SpanHandle, type SpanManager, type SpawnOptions, SqliteVectorStore, type StateStore, type StreamChunk, type StreamEvent, type TelemetryConfig, TimeoutError, type Tool, type ToolCallMessage, type ToolConfig, ToolDenied, type ToolHooks, type TraceEvent, type VectorEntry, type VectorResult, type VectorStore, VerifyError, type VerifyOptions, type VoteOptions, type Workflow, type WorkflowConfig, WorkflowContext, type WorkflowContextInit, agent, createSpanManager, defineConfig, tool, workflow };
+export { type Agent, type AgentConfig, AnthropicProvider, type AskOptions, type AwaitHumanOptions, type AxlConfig, AxlError, AxlRuntime, AxlStream, BudgetExceededError, type BudgetOptions, type BudgetResult, type ChatMessage, type ChatOptions, type Embedder, type ExecutionInfo, type ExecutionState, GeminiProvider, type GuardrailBlockHandler, GuardrailError, type GuardrailResult, type GuardrailsConfig, type HandoffDescriptor, type HandoffRecord, type HumanDecision, InMemoryVectorStore, type InputGuardrail, type MapOptions, MaxTurnsError, McpManager, type McpServer, type McpServerConfig, type McpToolDefinition, type McpToolResult, type MemoryConfig, MemoryManager, MemoryStore, NoConsensus, NoopSpanManager, OpenAIEmbedder, OpenAIProvider, OpenAIResponsesProvider, type OutputGuardrail, type PendingDecision, type Provider, type ProviderAdapter, ProviderRegistry, type ProviderResponse, QuorumNotMet, type RaceOptions, type RecallOptions, RedisStore, type RememberOptions, type Result, type RetryPolicy, SQLiteStore, Session, type SessionOptions, type SpanHandle, type SpanManager, type SpawnOptions, SqliteVectorStore, type StateStore, type StreamChunk, type StreamEvent, type TelemetryConfig, TimeoutError, type Tool, type ToolCallMessage, type ToolConfig, ToolDenied, type ToolHooks, type TraceEvent, type VectorEntry, type VectorResult, type VectorStore, VerifyError, type VerifyOptions, type VoteOptions, type Workflow, type WorkflowConfig, WorkflowContext, type WorkflowContextInit, agent, createSpanManager, defineConfig, tool, workflow, zodToJsonSchema };