@axlsdk/axl 0.1.1 → 0.2.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,6 +1068,8 @@ type ExecuteOptions = {
 declare class AxlRuntime extends EventEmitter {
     private config;
     private workflows;
+    private tools;
+    private agents;
     private providerRegistry;
     private stateStore;
     private executions;
@@ -1087,7 +1093,27 @@ 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;
+    /** 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 +1159,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 +1445,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 +1482,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 +1530,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 +1602,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,6 +1068,8 @@ type ExecuteOptions = {
 declare class AxlRuntime extends EventEmitter {
     private config;
     private workflows;
+    private tools;
+    private agents;
     private providerRegistry;
     private stateStore;
     private executions;
@@ -1087,7 +1093,27 @@ 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;
+    /** 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 +1159,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 +1445,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 +1482,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 +1530,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 +1602,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.js

@@ -1,6 +1,6 @@
 import {
   __require
-} from "./chunk-EE2BCC37.js";
+} from "./chunk-JBLQKU6X.js";
 
 // src/tool.ts
 var DEFAULT_MAX_STRING_LENGTH = 1e4;
@@ -102,6 +102,48 @@ function tool(config) {
   };
 }
 
+// src/providers/retry.ts
+var RETRYABLE_STATUS_CODES = /* @__PURE__ */ new Set([429, 503, 529]);
+var MAX_RETRIES = 2;
+var BASE_DELAY_MS = 1e3;
+function sleep2(ms, signal) {
+  return new Promise((resolve) => {
+    if (signal?.aborted) {
+      resolve();
+      return;
+    }
+    const timer = setTimeout(resolve, ms);
+    signal?.addEventListener(
+      "abort",
+      () => {
+        clearTimeout(timer);
+        resolve();
+      },
+      { once: true }
+    );
+  });
+}
+async function fetchWithRetry(input, init, maxRetries = MAX_RETRIES) {
+  for (let attempt = 0; ; attempt++) {
+    const res = await fetch(input, init);
+    if (res.ok || !RETRYABLE_STATUS_CODES.has(res.status) || attempt >= maxRetries) {
+      return res;
+    }
+    if (init?.signal?.aborted) {
+      return res;
+    }
+    const retryAfter = res.headers.get("retry-after");
+    let delay;
+    if (retryAfter && !isNaN(Number(retryAfter))) {
+      delay = Number(retryAfter) * 1e3;
+    } else {
+      delay = BASE_DELAY_MS * 2 ** attempt;
+    }
+    delay *= 0.75 + Math.random() * 0.5;
+    await sleep2(delay, init?.signal ?? void 0);
+  }
+}
+
 // src/providers/openai.ts
 var OPENAI_PRICING = {
   "gpt-4o": [25e-7, 1e-5],
@@ -161,7 +203,7 @@ var OpenAIProvider = class {
   // ---------------------------------------------------------------------------
   async chat(messages, options) {
     const body = this.buildRequestBody(messages, options, false);
-    const res = await fetch(`${this.baseUrl}/chat/completions`, {
+    const res = await fetchWithRetry(`${this.baseUrl}/chat/completions`, {
       method: "POST",
       headers: {
         "Content-Type": "application/json",
@@ -209,7 +251,7 @@ var OpenAIProvider = class {
   // ---------------------------------------------------------------------------
   async *stream(messages, options) {
     const body = this.buildRequestBody(messages, options, true);
-    const res = await fetch(`${this.baseUrl}/chat/completions`, {
+    const res = await fetchWithRetry(`${this.baseUrl}/chat/completions`, {
       method: "POST",
       headers: {
         "Content-Type": "application/json",
@@ -368,7 +410,7 @@ var OpenAIResponsesProvider = class {
   // ---------------------------------------------------------------------------
   async chat(messages, options) {
     const body = this.buildRequestBody(messages, options, false);
-    const res = await fetch(`${this.baseUrl}/responses`, {
+    const res = await fetchWithRetry(`${this.baseUrl}/responses`, {
       method: "POST",
       headers: {
         "Content-Type": "application/json",
@@ -390,7 +432,7 @@ var OpenAIResponsesProvider = class {
   // ---------------------------------------------------------------------------
   async *stream(messages, options) {
     const body = this.buildRequestBody(messages, options, true);
-    const res = await fetch(`${this.baseUrl}/responses`, {
+    const res = await fetchWithRetry(`${this.baseUrl}/responses`, {
       method: "POST",
       headers: {
         "Content-Type": "application/json",
@@ -702,7 +744,7 @@ var AnthropicProvider = class {
   async chat(messages, options) {
     this.currentModel = options.model;
     const body = this.buildRequestBody(messages, options, false);
-    const res = await fetch(`${this.baseUrl}/messages`, {
+    const res = await fetchWithRetry(`${this.baseUrl}/messages`, {
       method: "POST",
       headers: this.buildHeaders(),
       body: JSON.stringify(body),
@@ -721,7 +763,7 @@ var AnthropicProvider = class {
   // ---------------------------------------------------------------------------
   async *stream(messages, options) {
     const body = this.buildRequestBody(messages, options, true);
-    const res = await fetch(`${this.baseUrl}/messages`, {
+    const res = await fetchWithRetry(`${this.baseUrl}/messages`, {
       method: "POST",
       headers: this.buildHeaders(),
       body: JSON.stringify(body),
@@ -1072,7 +1114,7 @@ var GeminiProvider = class {
   // ---------------------------------------------------------------------------
   async chat(messages, options) {
     const body = this.buildRequestBody(messages, options);
-    const res = await fetch(`${this.baseUrl}/models/${options.model}:generateContent`, {
+    const res = await fetchWithRetry(`${this.baseUrl}/models/${options.model}:generateContent`, {
       method: "POST",
       headers: this.buildHeaders(),
       body: JSON.stringify(body),
@@ -1091,7 +1133,7 @@ var GeminiProvider = class {
   // ---------------------------------------------------------------------------
   async *stream(messages, options) {
     const body = this.buildRequestBody(messages, options);
-    const res = await fetch(
+    const res = await fetchWithRetry(
       `${this.baseUrl}/models/${options.model}:streamGenerateContent?alt=sse`,
       {
         method: "POST",
@@ -2173,7 +2215,8 @@ Please fix and try again.`;
                 span.setAttribute("axl.tool.duration", Date.now() - toolStart2);
                 const isError = r && typeof r === "object" && "error" in r;
                 span.setAttribute("axl.tool.success", !isError);
-                if (isError) span.setStatus("error", r.error);
+                if (isError)
+                  span.setStatus("error", r.error);
                 return r;
               }
             ) : await executeOverride();
@@ -2285,7 +2328,9 @@ Please fix and try again.`;
               try {
                 const mcpResult = await this.mcpManager.callTool(toolName, toolArgs);
                 toolResult2 = mcpResult;
-                resultContent2 = mcpResult.content.map((c) => c.type === "text" ? c.text : `[${c.type}]`).join("\n");
+                resultContent2 = mcpResult.content.map(
+                  (c) => c.type === "text" ? c.text : `[${c.type}]`
+                ).join("\n");
                 if (mcpResult.isError) {
                   resultContent2 = `Error: ${resultContent2}`;
                 }
@@ -2327,7 +2372,11 @@ Please fix and try again.`;
               span.setAttribute("axl.tool.duration", Date.now() - toolStart);
               const isError = r.toolResult && typeof r.toolResult === "object" && "error" in r.toolResult;
               span.setAttribute("axl.tool.success", !isError);
-              if (isError) span.setStatus("error", r.toolResult.error);
+              if (isError)
+                span.setStatus(
+                  "error",
+                  r.toolResult.error
+                );
               return r;
             }
           ) : await executeTool();
@@ -3306,6 +3355,10 @@ var MemoryStore = class {
   async deleteMemory(scope, key) {
     this.memories.get(scope)?.delete(key);
   }
+  // ── Sessions (Studio introspection) ─────────────────────────────────
+  async listSessions() {
+    return [...this.sessions.keys()];
+  }
   // ── Lifecycle ──────────────────────────────────────────────────────
   async close() {
   }
@@ -3534,6 +3587,11 @@ var SQLiteStore = class {
     const rows = stmt.all();
     return rows.map((r) => r.execution_id);
   }
+  // ── Sessions (Studio introspection) ────────────────────────────────────
+  async listSessions() {
+    const rows = this.db.prepare("SELECT session_id FROM sessions").all();
+    return rows.map((r) => r.session_id);
+  }
   // ── Memory ────────────────────────────────────────────────────────────
   async saveMemory(scope, key, value) {
     this.db.prepare(
@@ -3567,7 +3625,8 @@ var RedisStore = class {
   constructor(url) {
     let Redis;
     try {
-      Redis = __require("ioredis").default ?? __require("ioredis");
+      const mod = __require("ioredis");
+      Redis = mod.default ?? mod;
     } catch {
       throw new Error("ioredis is required for RedisStore. Install it with: npm install ioredis");
     }
@@ -3617,6 +3676,7 @@ var RedisStore = class {
   // ── Sessions ─────────────────────────────────────────────────────────
   async saveSession(sessionId, history) {
     await this.client.set(this.sessionKey(sessionId), JSON.stringify(history));
+    await this.client.sadd("axl:session-ids", sessionId);
   }
   async getSession(sessionId) {
     const raw = await this.client.get(this.sessionKey(sessionId));
@@ -3625,6 +3685,7 @@ var RedisStore = class {
   async deleteSession(sessionId) {
     await this.client.del(this.sessionKey(sessionId));
     await this.client.del(this.sessionMetaKey(sessionId));
+    await this.client.srem("axl:session-ids", sessionId);
   }
   async saveSessionMeta(sessionId, key, value) {
     await this.client.hset(this.sessionMetaKey(sessionId), key, JSON.stringify(value));
@@ -3661,6 +3722,10 @@ var RedisStore = class {
   async listPendingExecutions() {
     return this.client.smembers(this.pendingExecSetKey());
   }
+  // ── Sessions (Studio introspection) ────────────────────────────────────
+  async listSessions() {
+    return this.client.smembers("axl:session-ids");
+  }
   /** Close the Redis connection. */
   async close() {
     await this.client.quit();
@@ -4489,7 +4554,7 @@ async function createSpanManager(config) {
   if (!config?.enabled) {
     return new NoopSpanManager();
   }
-  const { OTelSpanManager: OTelSpanManager2 } = await import("./span-manager-LGX7QHZ7.js");
+  const { OTelSpanManager: OTelSpanManager2 } = await import("./span-manager-3IKXXUTZ.js");
   return OTelSpanManager2.create(config);
 }
 
@@ -4505,6 +4570,8 @@ function hashInput(input) {
 var AxlRuntime = class extends EventEmitter2 {
   config;
   workflows = /* @__PURE__ */ new Map();
+  tools = /* @__PURE__ */ new Map();
+  agents = /* @__PURE__ */ new Map();
   providerRegistry;
   stateStore;
   executions = /* @__PURE__ */ new Map();
@@ -4559,9 +4626,56 @@ var AxlRuntime = class extends EventEmitter2 {
     }
   }
   /** Register a workflow with the runtime. */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   register(workflow2) {
     this.workflows.set(workflow2.name, workflow2);
   }
+  /** Register standalone tools for Studio introspection and direct testing. */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  registerTool(...tools) {
+    for (const t of tools) {
+      this.tools.set(t.name, t);
+    }
+  }
+  /** Register standalone agents for Studio playground and introspection. */
+  registerAgent(...agents) {
+    for (const a of agents) {
+      this.agents.set(a._name, a);
+    }
+  }
+  // ── Introspection (used by Studio) ────────────────────────────────
+  /** Get all registered workflow names. */
+  getWorkflowNames() {
+    return [...this.workflows.keys()];
+  }
+  /** Get a registered workflow by name. */
+  getWorkflow(name) {
+    return this.workflows.get(name);
+  }
+  /** Get all registered workflows. */
+  getWorkflows() {
+    return [...this.workflows.values()];
+  }
+  /** Get all registered standalone tools. */
+  getTools() {
+    return [...this.tools.values()];
+  }
+  /** Get a registered standalone tool by name. */
+  getTool(name) {
+    return this.tools.get(name);
+  }
+  /** Get all registered standalone agents. */
+  getAgents() {
+    return [...this.agents.values()];
+  }
+  /** Get a registered standalone agent by name. */
+  getAgent(name) {
+    return this.agents.get(name);
+  }
+  /** Get all execution info (running + completed). */
+  getExecutions() {
+    return [...this.executions.values()];
+  }
   /** Register a custom provider instance. */
   registerProvider(name, provider) {
     this.providerRegistry.registerInstance(name, provider);
@@ -5260,6 +5374,7 @@ export {
   createSpanManager,
   defineConfig,
   tool,
-  workflow
+  workflow,
+  zodToJsonSchema
 };
 //# sourceMappingURL=index.js.map