@bowmark/web 1.24.1 → 1.24.2

package/dist/session.js

@@ -48,6 +48,26 @@ function libraryProxy(dispatch) {
     };
     return node([]);
 }
+/** `get_library` is real, and it is not here.
+ *
+ * It is an MCP tool and `GET /v1/library?query=`, never an export of this
+ * package — so `bowmark.get_library({ query })` raises the bad-path error above
+ * and, until 2026-09-19, said nothing about where the thing actually lives. A
+ * newcomer who hit it read an 88,000-line generated `.d.ts` by hand instead.
+ *
+ * A LOCAL COPY on purpose: this package has zero runtime dependencies,
+ * deliberately and permanently, so it cannot import `OTHER_CHANNEL` from
+ * `@bowmark/runtime`. `tests/unit/other-channel-hint.test.ts` holds the three
+ * copies (here, the Python client, the runtime) to the same names.
+ * `agents/richard/problems/newcomer-get-library-shown-as-callable-in-own-code.md`. */
+const OTHER_CHANNEL = new Set(["get_library", "getLibrary"]);
+function otherChannelSuffix(first) {
+    if (first === undefined || !OTHER_CHANNEL.has(first))
+        return "";
+    return (" — `get_library` is a DISCOVERY channel, not something this package exports: it is an MCP " +
+        "tool your agent calls directly, and `GET /v1/library?query=…` over HTTP with your " +
+        "`BOWMARK_API_KEY`. Read the library BEFORE you write the call, then call what you came for.");
+}
 /** One dispatch: validate the path, refuse a non-wire argument, then send it. */
 function dispatchThrough(send) {
     // `async`, so EVERY refusal is a rejected promise rather than a synchronous
@@ -61,7 +81,8 @@ function dispatchThrough(send) {
         // real call is `<unit>.<fn>` or `providers.<id>.<fn>`. Saying so here costs a
         // round trip nothing and names the shape.
         if (path.length < 2) {
-            throw new BowmarkError(`${label} is not a callable path. Call a function on a unit — bowmark.music.search(…) or bowmark.providers.gymshark.search(…).`, { code: "bad_path", path: label });
+            throw new BowmarkError(`${label} is not a callable path. Call a function on a unit — bowmark.music.search(…) or bowmark.providers.gymshark.search(…).` +
+                otherChannelSuffix(path[0]), { code: "bad_path", path: label });
         }
         // BEFORE the request, deliberately. A guard that ran server-side would report
         // a mangled value as a capability failure, after it had been metered.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bowmark/web",
-  "version": "1.24.1",
+  "version": "1.24.2",
   "type": "module",
   "description": "The public client for the Bowmark capability library — real TypeScript for the whole bowmark.* surface, with no Bowmark source on the caller's disk. ZERO runtime dependencies, deliberately and permanently.",
   "license": "MIT",