@dexto/core 1.5.7 → 1.6.0

package/dist/tools/internal-tools/implementations/ask-user-tool.js

@@ -1,34 +0,0 @@
-import "../../../chunk-PTJYTZNU.js";
-import { z } from "zod";
-const AskUserInputSchema = z.object({
-  question: z.string().describe("The question or prompt to display to the user"),
-  schema: z.object({
-    type: z.literal("object"),
-    properties: z.record(z.unknown()),
-    required: z.array(z.string()).optional()
-  }).passthrough().describe(
-    'JSON Schema defining form fields. Use descriptive property names as labels (e.g., "favorite_team", "World Cup winner country") - NOT generic names like "q1". Use "enum" for dropdowns, "boolean" for yes/no, "number" for numeric inputs, "string" for text. Include "required" array for mandatory fields.'
-  )
-}).strict();
-function createAskUserTool(approvalManager) {
-  return {
-    id: "ask_user",
-    description: 'Collect structured input from the user through a form interface. ONLY use this tool when you need: 1) Multiple fields at once (e.g., name + email + preferences), 2) Pre-defined options/choices (use enum for dropdowns like ["small","medium","large"]), 3) Specific data types with validation (boolean for yes/no, number for quantities). DO NOT use for simple conversational questions - just ask those naturally in your response. This tool is for form-like data collection, not chat. Examples: collecting user profile info, configuration settings, or selecting from preset options.',
-    inputSchema: AskUserInputSchema,
-    execute: async (input, context) => {
-      const { question, schema } = input;
-      const elicitationRequest = {
-        schema,
-        prompt: question,
-        serverName: "Dexto Agent"
-      };
-      if (context?.sessionId !== void 0) {
-        elicitationRequest.sessionId = context.sessionId;
-      }
-      return approvalManager.getElicitationData(elicitationRequest);
-    }
-  };
-}
-export {
-  createAskUserTool
-};

package/dist/tools/internal-tools/implementations/delegate-to-url-tool.cjs

@@ -1,192 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var delegate_to_url_tool_exports = {};
-__export(delegate_to_url_tool_exports, {
-  createDelegateToUrlTool: () => createDelegateToUrlTool
-});
-module.exports = __toCommonJS(delegate_to_url_tool_exports);
-var import_zod = require("zod");
-var import_errors = require("../../../errors/index.js");
-const DelegateToUrlInputSchema = import_zod.z.object({
-  url: import_zod.z.string().url().describe(
-    'The A2A-compliant agent URL (e.g., "http://localhost:3001" or "https://agent.example.com"). The tool will automatically append the correct JSON-RPC endpoint.'
-  ),
-  message: import_zod.z.string().min(1).describe(
-    "The message or task to delegate to the agent. This will be sent as natural language input."
-  ),
-  sessionId: import_zod.z.string().optional().describe(
-    "Optional session ID for maintaining conversation state across multiple delegations to the same agent"
-  ),
-  timeout: import_zod.z.number().optional().default(3e4).describe("Request timeout in milliseconds (default: 30000)")
-}).strict();
-class SimpleA2AClient {
-  url;
-  timeout;
-  constructor(url, timeout = 3e4) {
-    this.url = url.replace(/\/$/, "");
-    this.timeout = timeout;
-  }
-  /**
-   * Send a message to the A2A agent using JSON-RPC 2.0
-   */
-  async sendMessage(message, sessionId) {
-    const messageId = this.generateId();
-    const taskId = sessionId || this.generateId();
-    const a2aMessage = {
-      role: "user",
-      parts: [
-        {
-          kind: "text",
-          text: message
-        }
-      ],
-      messageId,
-      taskId,
-      contextId: taskId,
-      kind: "message"
-    };
-    const rpcRequest = {
-      jsonrpc: "2.0",
-      id: this.generateId(),
-      method: "message/send",
-      params: {
-        message: a2aMessage,
-        configuration: {
-          blocking: true
-          // Wait for completion
-        }
-      }
-    };
-    const endpoints = [
-      `${this.url}/v1/jsonrpc`,
-      // A2A v0.3.0 JSON-RPC endpoint
-      `${this.url}/jsonrpc`
-      // Alternative path
-    ];
-    let lastError = null;
-    for (const endpoint of endpoints) {
-      try {
-        const controller = new AbortController();
-        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
-        const response = await fetch(endpoint, {
-          method: "POST",
-          headers: {
-            "Content-Type": "application/json",
-            "User-Agent": "@dexto/core"
-          },
-          body: JSON.stringify(rpcRequest),
-          signal: controller.signal
-        });
-        clearTimeout(timeoutId);
-        if (!response.ok) {
-          lastError = new Error(
-            `HTTP ${response.status}: ${response.statusText} (tried ${endpoint})`
-          );
-          continue;
-        }
-        const data = await response.json();
-        if ("error" in data && data.error) {
-          throw new Error(
-            `Agent returned error: ${data.error.message || "Unknown error"}`
-          );
-        }
-        if ("result" in data) {
-          return this.extractTaskResponse(data.result);
-        }
-        return data;
-      } catch (error) {
-        if (error instanceof Error && error.name === "AbortError") {
-          throw new import_errors.DextoRuntimeError(
-            `Delegation timeout after ${this.timeout}ms`,
-            import_errors.ErrorScope.TOOLS,
-            import_errors.ErrorType.TIMEOUT,
-            "DELEGATION_TIMEOUT"
-          );
-        }
-        lastError = error instanceof Error ? error : new Error(String(error));
-      }
-    }
-    throw new import_errors.DextoRuntimeError(
-      `Failed to connect to agent at ${this.url}. Tried endpoints: ${endpoints.join(", ")}. Last error: ${lastError?.message || "Unknown error"}`,
-      import_errors.ErrorScope.TOOLS,
-      import_errors.ErrorType.THIRD_PARTY,
-      "DELEGATION_FAILED"
-    );
-  }
-  /**
-   * Extract response text from A2A Task structure
-   */
-  extractTaskResponse(task) {
-    if (task.history && Array.isArray(task.history)) {
-      const agentMessages = task.history.filter((m) => m.role === "agent");
-      if (agentMessages.length > 0) {
-        const lastMessage = agentMessages[agentMessages.length - 1];
-        if (lastMessage.parts && Array.isArray(lastMessage.parts)) {
-          const textParts = lastMessage.parts.filter((p) => p.kind === "text").map((p) => p.text);
-          if (textParts.length > 0) {
-            return textParts.join("\n");
-          }
-        }
-      }
-    }
-    return JSON.stringify(task, null, 2);
-  }
-  /**
-   * Generate unique ID
-   */
-  generateId() {
-    return `${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;
-  }
-}
-function createDelegateToUrlTool() {
-  return {
-    id: "delegate_to_url",
-    description: 'Delegate a task to another A2A-compliant agent at a specific URL. Supports STATEFUL multi-turn conversations via sessionId parameter. USAGE: (1) First delegation: provide url + message. Tool returns a response AND a sessionId. (2) Follow-up: use the SAME sessionId to continue the conversation with that agent. The agent remembers previous context. EXAMPLE: First call {url: "http://agent:3001", message: "Analyze data X"} returns {sessionId: "xyz", response: "..."}. Second call {url: "http://agent:3001", message: "What was the top insight?", sessionId: "xyz"}. The agent will remember the first analysis and can answer specifically.',
-    inputSchema: DelegateToUrlInputSchema,
-    execute: async (input, _context) => {
-      const { url, message, sessionId, timeout } = input;
-      try {
-        const client = new SimpleA2AClient(url, timeout);
-        const effectiveSessionId = sessionId || `delegation-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
-        const response = await client.sendMessage(message, effectiveSessionId);
-        return {
-          success: true,
-          agentUrl: url,
-          sessionId: effectiveSessionId,
-          response,
-          _hint: sessionId ? "Continued existing conversation" : "Started new conversation - use this sessionId for follow-ups"
-        };
-      } catch (error) {
-        if (error instanceof import_errors.DextoRuntimeError) {
-          throw error;
-        }
-        throw new import_errors.DextoRuntimeError(
-          `Delegation failed: ${error instanceof Error ? error.message : String(error)}`,
-          import_errors.ErrorScope.TOOLS,
-          import_errors.ErrorType.SYSTEM,
-          "DELEGATION_ERROR"
-        );
-      }
-    }
-  };
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  createDelegateToUrlTool
-});

package/dist/tools/internal-tools/implementations/delegate-to-url-tool.d.ts

@@ -1,33 +0,0 @@
-import { InternalTool } from '../../types.js';
-/**
- * Internal tool for agent-to-agent delegation
- *
- * Delegates tasks to other A2A-compliant agents at known URLs.
- * Supports stateful multi-turn conversations via sessionId parameter.
- *
- * Features:
- * - A2A Protocol v0.3.0 compliant (JSON-RPC 2.0 transport)
- * - Stateful conversations with session management
- * - Automatic endpoint discovery (/v1/jsonrpc, /jsonrpc)
- * - Configurable timeouts and error handling
- *
- * @example
- * ```typescript
- * // Single delegation
- * delegate_to_url({
- *   url: "http://pdf-analyzer:3001",
- *   message: "Extract all tables from the Q4 sales report"
- * })
- * → Returns: {sessionId: "delegation-xyz", response: "..."}
- *
- * // Multi-turn conversation (use same sessionId)
- * delegate_to_url({
- *   url: "http://pdf-analyzer:3001",
- *   message: "Which table had the highest values?",
- *   sessionId: "delegation-xyz"
- * })
- * → Agent remembers the previous extraction and can answer specifically
- * ```
- */
-export declare function createDelegateToUrlTool(): InternalTool;
-//# sourceMappingURL=delegate-to-url-tool.d.ts.map

package/dist/tools/internal-tools/implementations/delegate-to-url-tool.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"delegate-to-url-tool.d.ts","sourceRoot":"","sources":["../../../../src/tools/internal-tools/implementations/delegate-to-url-tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAwB,MAAM,gBAAgB,CAAC;AA8MpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,uBAAuB,IAAI,YAAY,CA8CtD"}

package/dist/tools/internal-tools/implementations/delegate-to-url-tool.js

@@ -1,169 +0,0 @@
-import "../../../chunk-PTJYTZNU.js";
-import { z } from "zod";
-import { DextoRuntimeError, ErrorScope, ErrorType } from "../../../errors/index.js";
-const DelegateToUrlInputSchema = z.object({
-  url: z.string().url().describe(
-    'The A2A-compliant agent URL (e.g., "http://localhost:3001" or "https://agent.example.com"). The tool will automatically append the correct JSON-RPC endpoint.'
-  ),
-  message: z.string().min(1).describe(
-    "The message or task to delegate to the agent. This will be sent as natural language input."
-  ),
-  sessionId: z.string().optional().describe(
-    "Optional session ID for maintaining conversation state across multiple delegations to the same agent"
-  ),
-  timeout: z.number().optional().default(3e4).describe("Request timeout in milliseconds (default: 30000)")
-}).strict();
-class SimpleA2AClient {
-  url;
-  timeout;
-  constructor(url, timeout = 3e4) {
-    this.url = url.replace(/\/$/, "");
-    this.timeout = timeout;
-  }
-  /**
-   * Send a message to the A2A agent using JSON-RPC 2.0
-   */
-  async sendMessage(message, sessionId) {
-    const messageId = this.generateId();
-    const taskId = sessionId || this.generateId();
-    const a2aMessage = {
-      role: "user",
-      parts: [
-        {
-          kind: "text",
-          text: message
-        }
-      ],
-      messageId,
-      taskId,
-      contextId: taskId,
-      kind: "message"
-    };
-    const rpcRequest = {
-      jsonrpc: "2.0",
-      id: this.generateId(),
-      method: "message/send",
-      params: {
-        message: a2aMessage,
-        configuration: {
-          blocking: true
-          // Wait for completion
-        }
-      }
-    };
-    const endpoints = [
-      `${this.url}/v1/jsonrpc`,
-      // A2A v0.3.0 JSON-RPC endpoint
-      `${this.url}/jsonrpc`
-      // Alternative path
-    ];
-    let lastError = null;
-    for (const endpoint of endpoints) {
-      try {
-        const controller = new AbortController();
-        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
-        const response = await fetch(endpoint, {
-          method: "POST",
-          headers: {
-            "Content-Type": "application/json",
-            "User-Agent": "@dexto/core"
-          },
-          body: JSON.stringify(rpcRequest),
-          signal: controller.signal
-        });
-        clearTimeout(timeoutId);
-        if (!response.ok) {
-          lastError = new Error(
-            `HTTP ${response.status}: ${response.statusText} (tried ${endpoint})`
-          );
-          continue;
-        }
-        const data = await response.json();
-        if ("error" in data && data.error) {
-          throw new Error(
-            `Agent returned error: ${data.error.message || "Unknown error"}`
-          );
-        }
-        if ("result" in data) {
-          return this.extractTaskResponse(data.result);
-        }
-        return data;
-      } catch (error) {
-        if (error instanceof Error && error.name === "AbortError") {
-          throw new DextoRuntimeError(
-            `Delegation timeout after ${this.timeout}ms`,
-            ErrorScope.TOOLS,
-            ErrorType.TIMEOUT,
-            "DELEGATION_TIMEOUT"
-          );
-        }
-        lastError = error instanceof Error ? error : new Error(String(error));
-      }
-    }
-    throw new DextoRuntimeError(
-      `Failed to connect to agent at ${this.url}. Tried endpoints: ${endpoints.join(", ")}. Last error: ${lastError?.message || "Unknown error"}`,
-      ErrorScope.TOOLS,
-      ErrorType.THIRD_PARTY,
-      "DELEGATION_FAILED"
-    );
-  }
-  /**
-   * Extract response text from A2A Task structure
-   */
-  extractTaskResponse(task) {
-    if (task.history && Array.isArray(task.history)) {
-      const agentMessages = task.history.filter((m) => m.role === "agent");
-      if (agentMessages.length > 0) {
-        const lastMessage = agentMessages[agentMessages.length - 1];
-        if (lastMessage.parts && Array.isArray(lastMessage.parts)) {
-          const textParts = lastMessage.parts.filter((p) => p.kind === "text").map((p) => p.text);
-          if (textParts.length > 0) {
-            return textParts.join("\n");
-          }
-        }
-      }
-    }
-    return JSON.stringify(task, null, 2);
-  }
-  /**
-   * Generate unique ID
-   */
-  generateId() {
-    return `${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;
-  }
-}
-function createDelegateToUrlTool() {
-  return {
-    id: "delegate_to_url",
-    description: 'Delegate a task to another A2A-compliant agent at a specific URL. Supports STATEFUL multi-turn conversations via sessionId parameter. USAGE: (1) First delegation: provide url + message. Tool returns a response AND a sessionId. (2) Follow-up: use the SAME sessionId to continue the conversation with that agent. The agent remembers previous context. EXAMPLE: First call {url: "http://agent:3001", message: "Analyze data X"} returns {sessionId: "xyz", response: "..."}. Second call {url: "http://agent:3001", message: "What was the top insight?", sessionId: "xyz"}. The agent will remember the first analysis and can answer specifically.',
-    inputSchema: DelegateToUrlInputSchema,
-    execute: async (input, _context) => {
-      const { url, message, sessionId, timeout } = input;
-      try {
-        const client = new SimpleA2AClient(url, timeout);
-        const effectiveSessionId = sessionId || `delegation-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
-        const response = await client.sendMessage(message, effectiveSessionId);
-        return {
-          success: true,
-          agentUrl: url,
-          sessionId: effectiveSessionId,
-          response,
-          _hint: sessionId ? "Continued existing conversation" : "Started new conversation - use this sessionId for follow-ups"
-        };
-      } catch (error) {
-        if (error instanceof DextoRuntimeError) {
-          throw error;
-        }
-        throw new DextoRuntimeError(
-          `Delegation failed: ${error instanceof Error ? error.message : String(error)}`,
-          ErrorScope.TOOLS,
-          ErrorType.SYSTEM,
-          "DELEGATION_ERROR"
-        );
-      }
-    }
-  };
-}
-export {
-  createDelegateToUrlTool
-};

package/dist/tools/internal-tools/implementations/get-resource-tool.cjs

@@ -1,113 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var get_resource_tool_exports = {};
-__export(get_resource_tool_exports, {
-  createGetResourceTool: () => createGetResourceTool
-});
-module.exports = __toCommonJS(get_resource_tool_exports);
-var import_zod = require("zod");
-const GetResourceInputSchema = import_zod.z.object({
-  reference: import_zod.z.string().describe(
-    'The resource reference to access. Formats: "blob:abc123" (from list_resources), "resource_ref:blob:abc123" (from tool annotations)'
-  ),
-  format: import_zod.z.enum(["url", "metadata"]).default("url").describe(
-    'Output format: "url" for a shareable URL (requires remote storage like Supabase), "metadata" for resource information without loading the data'
-  )
-}).strict();
-function createGetResourceTool(resourceManager) {
-  return {
-    id: "get_resource",
-    description: 'Access a stored resource. Use format "url" to get a shareable URL for other agents or external systems (requires remote storage like Supabase). Use format "metadata" to get resource information without loading data. References can be obtained from tool result annotations or list_resources.',
-    inputSchema: GetResourceInputSchema,
-    execute: async (input, _context) => {
-      const { reference, format } = input;
-      try {
-        const blobStore = resourceManager.getBlobStore();
-        const storeType = blobStore.getStoreType();
-        let blobUri = reference;
-        if (blobUri.startsWith("resource_ref:")) {
-          blobUri = blobUri.substring("resource_ref:".length);
-        }
-        if (blobUri.startsWith("@")) {
-          blobUri = blobUri.substring(1);
-        }
-        if (!blobUri.startsWith("blob:")) {
-          blobUri = `blob:${blobUri}`;
-        }
-        const exists = await blobStore.exists(blobUri);
-        if (!exists) {
-          return {
-            success: false,
-            error: `Resource not found: ${reference}`,
-            _hint: "Use list_resources to see available resources"
-          };
-        }
-        if (format === "metadata") {
-          const allBlobs = await blobStore.listBlobs();
-          const blobRef = allBlobs.find((b) => b.uri === blobUri);
-          if (!blobRef) {
-            return {
-              success: false,
-              error: `Resource metadata not found: ${reference}`,
-              _hint: "Use list_resources to see available resources"
-            };
-          }
-          return {
-            success: true,
-            format: "metadata",
-            reference: blobUri,
-            mimeType: blobRef.metadata.mimeType,
-            size: blobRef.metadata.size,
-            filename: blobRef.metadata.originalName,
-            source: blobRef.metadata.source,
-            createdAt: blobRef.metadata.createdAt.toISOString()
-          };
-        }
-        if (storeType === "memory" || storeType === "local") {
-          return {
-            success: false,
-            error: "URL generation not available with local/memory storage",
-            _hint: "Configure remote storage (e.g., Supabase) in your agent config to enable URL sharing. Local storage cannot generate shareable URLs.",
-            storeType
-          };
-        }
-        const blob = await blobStore.retrieve(blobUri, "url");
-        return {
-          success: true,
-          format: "url",
-          url: blob.data,
-          reference: blobUri,
-          mimeType: blob.metadata.mimeType,
-          size: blob.metadata.size,
-          filename: blob.metadata.originalName
-        };
-      } catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        return {
-          success: false,
-          error: `Failed to access resource: ${message}`
-        };
-      }
-    }
-  };
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  createGetResourceTool
-});

package/dist/tools/internal-tools/implementations/get-resource-tool.d.ts

@@ -1,30 +0,0 @@
-import { InternalTool } from '../../types.js';
-import type { ResourceManager } from '../../../resources/manager.js';
-/**
- * Internal tool for accessing resources.
- *
- * This tool provides access to stored resources (images, files, etc.) in formats
- * suitable for sharing or inspection, without loading binary data into context.
- *
- * Formats:
- * - `url`: Returns a shareable URL. Requires remote storage (e.g., Supabase).
- *          Local/memory storage does not support URL generation.
- * - `metadata`: Returns resource information (size, mimeType, filename, etc.)
- *               without loading the actual data.
- *
- * Design principle: Resources exist to keep binary data OUT of the context window.
- * This tool never returns base64 or raw data - use URLs for sharing instead.
- *
- * @example
- * ```typescript
- * // Get a shareable URL for an image
- * get_resource({ reference: 'blob:abc123', format: 'url' })
- * → { success: true, url: 'https://...', mimeType: 'image/png', ... }
- *
- * // Get metadata about a resource
- * get_resource({ reference: 'blob:abc123', format: 'metadata' })
- * → { success: true, mimeType: 'image/png', size: 12345, filename: '...', ... }
- * ```
- */
-export declare function createGetResourceTool(resourceManager: ResourceManager): InternalTool;
-//# sourceMappingURL=get-resource-tool.d.ts.map

package/dist/tools/internal-tools/implementations/get-resource-tool.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"get-resource-tool.d.ts","sourceRoot":"","sources":["../../../../src/tools/internal-tools/implementations/get-resource-tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAwB,MAAM,gBAAgB,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAyBrE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,qBAAqB,CAAC,eAAe,EAAE,eAAe,GAAG,YAAY,CA2GpF"}

package/dist/tools/internal-tools/implementations/get-resource-tool.js

@@ -1,90 +0,0 @@
-import "../../../chunk-PTJYTZNU.js";
-import { z } from "zod";
-const GetResourceInputSchema = z.object({
-  reference: z.string().describe(
-    'The resource reference to access. Formats: "blob:abc123" (from list_resources), "resource_ref:blob:abc123" (from tool annotations)'
-  ),
-  format: z.enum(["url", "metadata"]).default("url").describe(
-    'Output format: "url" for a shareable URL (requires remote storage like Supabase), "metadata" for resource information without loading the data'
-  )
-}).strict();
-function createGetResourceTool(resourceManager) {
-  return {
-    id: "get_resource",
-    description: 'Access a stored resource. Use format "url" to get a shareable URL for other agents or external systems (requires remote storage like Supabase). Use format "metadata" to get resource information without loading data. References can be obtained from tool result annotations or list_resources.',
-    inputSchema: GetResourceInputSchema,
-    execute: async (input, _context) => {
-      const { reference, format } = input;
-      try {
-        const blobStore = resourceManager.getBlobStore();
-        const storeType = blobStore.getStoreType();
-        let blobUri = reference;
-        if (blobUri.startsWith("resource_ref:")) {
-          blobUri = blobUri.substring("resource_ref:".length);
-        }
-        if (blobUri.startsWith("@")) {
-          blobUri = blobUri.substring(1);
-        }
-        if (!blobUri.startsWith("blob:")) {
-          blobUri = `blob:${blobUri}`;
-        }
-        const exists = await blobStore.exists(blobUri);
-        if (!exists) {
-          return {
-            success: false,
-            error: `Resource not found: ${reference}`,
-            _hint: "Use list_resources to see available resources"
-          };
-        }
-        if (format === "metadata") {
-          const allBlobs = await blobStore.listBlobs();
-          const blobRef = allBlobs.find((b) => b.uri === blobUri);
-          if (!blobRef) {
-            return {
-              success: false,
-              error: `Resource metadata not found: ${reference}`,
-              _hint: "Use list_resources to see available resources"
-            };
-          }
-          return {
-            success: true,
-            format: "metadata",
-            reference: blobUri,
-            mimeType: blobRef.metadata.mimeType,
-            size: blobRef.metadata.size,
-            filename: blobRef.metadata.originalName,
-            source: blobRef.metadata.source,
-            createdAt: blobRef.metadata.createdAt.toISOString()
-          };
-        }
-        if (storeType === "memory" || storeType === "local") {
-          return {
-            success: false,
-            error: "URL generation not available with local/memory storage",
-            _hint: "Configure remote storage (e.g., Supabase) in your agent config to enable URL sharing. Local storage cannot generate shareable URLs.",
-            storeType
-          };
-        }
-        const blob = await blobStore.retrieve(blobUri, "url");
-        return {
-          success: true,
-          format: "url",
-          url: blob.data,
-          reference: blobUri,
-          mimeType: blob.metadata.mimeType,
-          size: blob.metadata.size,
-          filename: blob.metadata.originalName
-        };
-      } catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        return {
-          success: false,
-          error: `Failed to access resource: ${message}`
-        };
-      }
-    }
-  };
-}
-export {
-  createGetResourceTool
-};