@toolshed/sources

​

resolveSource(config)

import { resolveSource } from "@toolshed/sources";

const source = await resolveSource({
  type: "openapi",
  id: "petstore",
  namespace: "petstore",
  specUrl: "https://petstore.swagger.io/v2/swagger.json",
});
// source.tools => ToolDefinition[]
// source.invoke(path, args) => Promise<unknown>

​

Source interface

interface Source {
  id: string;
  type: string;
  namespace: string;
  name: string;
  description: string;
  tools: ToolDefinition[];
  authProviders: AuthProvider[];
  invoke(path: string, args: Record<string, unknown>, authToken?: string): Promise<unknown>;
}

​

Adapters

​

OpenAPIAdapter

• Tool paths: namespace.resource.action (e.g., billing.invoices.list)
• Action mapping: GET -> list/get, POST -> create, PUT -> update, PATCH -> patch, DELETE -> delete
• Destructiveness: Derived from HTTP method (GET, HEAD, OPTIONS are safe)

​

GraphQLAdapter

• Tool paths: namespace.field_name (camelCase -> snake_case)
• Destructiveness: Queries are safe, mutations are destructive
• Schema inference: Extracts input types from field arguments

​

MCPAdapter

• Tool paths: namespace.tool_name (normalized to lowercase with underscores)
• Discovery: Calls MCP tools/list via JSON-RPC
• Invocation: Calls MCP tools/call with tool name and arguments
• Destructiveness: Reads annotations.destructiveHint from MCP metadata

​

PluginAdapter

• Tool paths: As defined in the plugin
• Destructiveness: Uses the explicit destructive field on each tool

​

SourceAdapter interface

interface SourceAdapter<T extends SourceConfig> {
  type: T["type"];
  resolve(config: T): Promise<Source>;
}