widespread-tools 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,15 @@
-# Temporary Holding Version
+# widespread-tools
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Thin JS helpers for wiring the [Widespread](https://github.com/TerexitariusStomp/widespread-bridge)
+MCP server into agent frameworks. Non-custodial — client-held Ed25519 keys.
+
+```js
+import { mcpConfig, rpc } from "widespread-tools";
+
+// LangChain / Vercel / OpenAI Agents — pass mcpConfig.remote to your MCP client
+// or call tools directly:
+const tools = await rpc("tools/list");
+```
+
+Remote endpoint: `https://widespread-bridge.widespread.workers.dev/mcp`
+Local key-holding server: `uvx widespread-mcp` · Install page: https://widespread-bridge.widespread.workers.dev/install

package/index.js

@@ -0,0 +1,37 @@
+/**
+ * widespread-tools — thin helpers for wiring the Widespread MCP server into
+ * agent frameworks (LangChain, Vercel AI SDK, OpenAI Agents, etc.).
+ * Non-custodial: keys stay client-side; the bridge only verifies signatures.
+ */
+
+export const MCP_URL = "https://widespread-bridge.widespread.workers.dev/mcp";
+export const OPENAPI_URL = "https://widespread-bridge.widespread.workers.dev/openapi.json";
+
+/** MCP client config — pass to any MCP-aware framework client. */
+export const mcpConfig = {
+  remote: { type: "streamable-http", url: MCP_URL },
+  local: { command: "uvx", args: ["widespread-mcp"] },
+};
+
+/** Tool names exposed on the remote endpoint. */
+export const TOOLS = [
+  "feed_search", "feed_get", "feed_stats", "runners_list",
+  "wide_markets", "wide_bounties",
+  "wide_agent_challenge", "wide_agent_register",
+  "wide_claim", "wide_ship_prepare", "wide_ship_submit", "wide_status",
+];
+
+/** JSON-RPC call helper for the remote endpoint. */
+export async function rpc(method, params = {}, { url = MCP_URL } = {}) {
+  const res = await fetch(url, {
+    method: "POST",
+    headers: {
+      "content-type": "application/json",
+      accept: "application/json, text/event-stream",
+    },
+    body: JSON.stringify({ jsonrpc: "2.0", id: 1, method, params }),
+  });
+  const text = await res.text();
+  const m = text.match(/^data: (.*)$/m);
+  return JSON.parse(m ? m[1] : text);
+}

package/package.json

@@ -1,6 +1,12 @@
 {
   "name": "widespread-tools",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Widespread protocol client helpers — MCP endpoint config + tool descriptors for LangChain/Vercel AI SDK/agents",
+  "license": "MIT",
+  "author": "TerexitariusStomp",
+  "type": "module",
+  "main": "index.js",
+  "exports": { ".": "./index.js" },
+  "repository": { "type": "git", "url": "https://github.com/TerexitariusStomp/widespread-bridge" },
+  "keywords": ["mcp", "agents", "bounties", "llm", "tools"]
+}