@yak-io/javascript 0.10.0 → 0.10.1

package/dist/tool-name.d.ts

@@ -1,10 +1,21 @@
 /**
- * Generates a tool ID from a tool name using a 32-bit hash.
- * Format: `yt_<8-char-hex-hash>`.
+ * Convert a host tool name into a model-facing function name.
  *
- * The hash is deterministic so chat and voice always derive the same id for
- * the same tool name — this is what lets the mint route, the iframe, and the
- * SDK all agree on which decorated id maps back to which host tool name.
+ * We sanitise to the allowed function-name charset (rather than hashing to an opaque
+ * `yt_<hex>`), so the model keeps the semantic signal of a readable name — e.g.
+ * `orders.list` → `orders_list`.
+ *
+ * This is a pure per-name transform; uniqueness across a manifest (and avoiding the
+ * reserved `redirect` name / `mcp__` namespace) is handled by the caller via
+ * {@link uniqueToolId}. Each runtime (the chat-ui iframe and this SDK's voice session)
+ * decorates and reverse-maps with its own manifest, so the ids never need to match
+ * across paths — only to be self-consistent within one.
  */
 export declare function generateToolId(originalName: string): string;
+/**
+ * Resolve a collision-free, model-safe id for a host tool name, given the ids already
+ * taken in this manifest (seed `used` with reserved names like `redirect`). Host ids must
+ * never start with the `mcp__` namespace, which the dispatcher routes on.
+ */
+export declare function uniqueToolId(originalName: string, used: Set<string>): string;
 //# sourceMappingURL=tool-name.d.ts.map

package/dist/tool-name.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-name.d.ts","sourceRoot":"","sources":["../src/tool-name.ts"],"names":[],"mappings":"AAcA;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAG3D"}
+{"version":3,"file":"tool-name.d.ts","sourceRoot":"","sources":["../src/tool-name.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAG3D;AAKD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAc5E"}

package/dist/tool-name.js

@@ -1,24 +1,42 @@
-const TOOL_NAME_PREFIX = "yt_";
+/** OpenAI/Realtime function names must match `^[a-zA-Z0-9_-]{1,64}$`. */
+const MAX_TOOL_NAME_LENGTH = 64;
 /**
- * Simple 32-bit hash function (djb2 variant).
- * Produces consistent hash values for the same input string.
+ * Convert a host tool name into a model-facing function name.
+ *
+ * We sanitise to the allowed function-name charset (rather than hashing to an opaque
+ * `yt_<hex>`), so the model keeps the semantic signal of a readable name — e.g.
+ * `orders.list` → `orders_list`.
+ *
+ * This is a pure per-name transform; uniqueness across a manifest (and avoiding the
+ * reserved `redirect` name / `mcp__` namespace) is handled by the caller via
+ * {@link uniqueToolId}. Each runtime (the chat-ui iframe and this SDK's voice session)
+ * decorates and reverse-maps with its own manifest, so the ids never need to match
+ * across paths — only to be self-consistent within one.
  */
-function hash32(str) {
-    let hash = 5381;
-    for (let i = 0; i < str.length; i++) {
-        hash = ((hash << 5) + hash + str.charCodeAt(i)) >>> 0;
-    }
-    return hash;
+export function generateToolId(originalName) {
+    const sanitized = originalName.replace(/[^A-Za-z0-9_-]/g, "_").slice(0, MAX_TOOL_NAME_LENGTH);
+    return sanitized.length > 0 ? sanitized : "tool";
 }
+/** The MCP namespace prefix the voice/chat dispatchers route on. */
+const MCP_NAMESPACE_PREFIX = "mcp__";
 /**
- * Generates a tool ID from a tool name using a 32-bit hash.
- * Format: `yt_<8-char-hex-hash>`.
- *
- * The hash is deterministic so chat and voice always derive the same id for
- * the same tool name — this is what lets the mint route, the iframe, and the
- * SDK all agree on which decorated id maps back to which host tool name.
+ * Resolve a collision-free, model-safe id for a host tool name, given the ids already
+ * taken in this manifest (seed `used` with reserved names like `redirect`). Host ids must
+ * never start with the `mcp__` namespace, which the dispatcher routes on.
  */
-export function generateToolId(originalName) {
-    const hashValue = hash32(originalName);
-    return `${TOOL_NAME_PREFIX}${hashValue.toString(16).padStart(8, "0")}`;
+export function uniqueToolId(originalName, used) {
+    let base = generateToolId(originalName);
+    if (base.startsWith(MCP_NAMESPACE_PREFIX)) {
+        base = `t_${base}`.slice(0, MAX_TOOL_NAME_LENGTH);
+    }
+    if (!used.has(base))
+        return base;
+    for (let i = 2; i < 1000; i++) {
+        const suffix = `_${i}`;
+        const candidate = `${base.slice(0, MAX_TOOL_NAME_LENGTH - suffix.length)}${suffix}`;
+        if (!used.has(candidate))
+            return candidate;
+    }
+    // Pathological fallback — vanishingly unlikely in practice.
+    return `${base.slice(0, 56)}_${used.size}`;
 }

package/dist/voice-session.d.ts

@@ -81,11 +81,11 @@ export declare class YakVoiceSession {
     private execMcpTool;
     private mintToken;
     /**
-     * Decorate the host's tool manifest with hashed ids and populate
-     * `this.toolNameById` for reverse lookup. Mirrors the decoration the chat-ui
-     * iframe applies before sending tools to `/api/chat`. GraphQL/REST tools are
-     * ordinary manifest entries here (contributed by their adapters), so no
-     * special-casing is needed.
+     * Decorate the host's tool manifest with readable, collision-free model-facing ids
+     * and populate `this.toolNameById` for reverse lookup. Mirrors the decoration the
+     * chat-ui iframe applies before sending tools to `/api/chat`. GraphQL/REST tools are
+     * ordinary manifest entries here (contributed by their adapters), so no special-casing
+     * is needed.
      */
     private buildDecoratedManifest;
     private exchangeSdp;

package/dist/voice-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"voice-session.d.ts","sourceRoot":"","sources":["../src/voice-session.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAExE,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAKL,KAAK,YAAY,EAElB,MAAM,oBAAoB,CAAC;AAQ5B,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,oBAAoB,CAAC,EAAE,OAAO,CAAC;KAChC;CACF;AAiBD,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;AAEjE,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC;;;OAGG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;;OAIG;IACH,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAiED,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,iBAAiB,CAAqB;IAC9C,OAAO,CAAC,SAAS,CAAiC;IAClD,OAAO,CAAC,eAAe,CAA6B;IACpD,6EAA6E;IAC7E,OAAO,CAAC,KAAK,CAAkC;IAC/C;;;;OAIG;IACH,OAAO,CAAC,YAAY,CAA6B;gBAErC,MAAM,EAAE,qBAAqB;IAKzC;;;;OAIG;IACH,OAAO,KAAK,SAAS,GAEpB;IAED,0DAA0D;IACnD,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG,IAAI;IAIzD,QAAQ,IAAI,YAAY;IAI/B;;;OAGG;IACI,YAAY,IAAI,MAAM;IAItB,aAAa,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,IAAI;IAO9D;;;OAGG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwJnC,oDAAoD;IACvC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAMlC,2FAA2F;IACpF,OAAO,IAAI,IAAI;IAWtB,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,eAAe;IAqBvB,OAAO,CAAC,mBAAmB;YAeb,aAAa;IA8B3B;;;;OAIG;YACW,WAAW;YAwBX,SAAS;IAsBvB;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;YAchB,WAAW;IAmBzB,OAAO,CAAC,kBAAkB;YAWZ,gBAAgB;YA2BhB,QAAQ;YAuCR,QAAQ;IAMtB,OAAO,CAAC,QAAQ;IAahB,OAAO,CAAC,sBAAsB;IAQ9B,OAAO,CAAC,cAAc;CAevB"}
+{"version":3,"file":"voice-session.d.ts","sourceRoot":"","sources":["../src/voice-session.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAExE,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAKL,KAAK,YAAY,EAElB,MAAM,oBAAoB,CAAC;AAQ5B,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,oBAAoB,CAAC,EAAE,OAAO,CAAC;KAChC;CACF;AAiBD,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;AAEjE,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC;;;OAGG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;;OAIG;IACH,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAiED,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,iBAAiB,CAAqB;IAC9C,OAAO,CAAC,SAAS,CAAiC;IAClD,OAAO,CAAC,eAAe,CAA6B;IACpD,6EAA6E;IAC7E,OAAO,CAAC,KAAK,CAAkC;IAC/C;;;;OAIG;IACH,OAAO,CAAC,YAAY,CAA6B;gBAErC,MAAM,EAAE,qBAAqB;IAKzC;;;;OAIG;IACH,OAAO,KAAK,SAAS,GAEpB;IAED,0DAA0D;IACnD,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG,IAAI;IAIzD,QAAQ,IAAI,YAAY;IAI/B;;;OAGG;IACI,YAAY,IAAI,MAAM;IAItB,aAAa,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,IAAI;IAO9D;;;OAGG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwJnC,oDAAoD;IACvC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAMlC,2FAA2F;IACpF,OAAO,IAAI,IAAI;IAWtB,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,eAAe;IAqBvB,OAAO,CAAC,mBAAmB;YAeb,aAAa;IA8B3B;;;;OAIG;YACW,WAAW;YAwBX,SAAS;IAsBvB;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;YAgBhB,WAAW;IAmBzB,OAAO,CAAC,kBAAkB;YAWZ,gBAAgB;YA2BhB,QAAQ;YAuCR,QAAQ;IAMtB,OAAO,CAAC,QAAQ;IAahB,OAAO,CAAC,sBAAsB;IAQ9B,OAAO,CAAC,cAAc;CAevB"}

package/dist/voice-session.js

@@ -1,6 +1,6 @@
 import { logger } from "./logger.js";
 import { extractPageContext } from "./page-context.js";
-import { generateToolId } from "./tool-name.js";
+import { uniqueToolId } from "./tool-name.js";
 import { handleRealtimeMessage, INITIAL_VOICE_MACHINE, voiceReducer, } from "./voice-machine.js";
 const DEFAULT_REALTIME_MODEL = "gpt-realtime";
 const REALTIME_CALLS_URL = "https://api.openai.com/v1/realtime/calls";
@@ -296,7 +296,7 @@ export class YakVoiceSession {
         }
     }
     async routeToolCall(idOrName, args) {
-        // The model calls us back using the decorated id (e.g. yt_abc12345).
+        // The model calls us back using the decorated id (e.g. orders_list).
         // Resolve it to the original host tool name; fall back to the raw value
         // (it might be `redirect` or some non-decorated name).
         const name = this.toolNameById.get(idOrName) ?? idOrName;
@@ -372,16 +372,18 @@ export class YakVoiceSession {
         return (await res.json());
     }
     /**
-     * Decorate the host's tool manifest with hashed ids and populate
-     * `this.toolNameById` for reverse lookup. Mirrors the decoration the chat-ui
-     * iframe applies before sending tools to `/api/chat`. GraphQL/REST tools are
-     * ordinary manifest entries here (contributed by their adapters), so no
-     * special-casing is needed.
+     * Decorate the host's tool manifest with readable, collision-free model-facing ids
+     * and populate `this.toolNameById` for reverse lookup. Mirrors the decoration the
+     * chat-ui iframe applies before sending tools to `/api/chat`. GraphQL/REST tools are
+     * ordinary manifest entries here (contributed by their adapters), so no special-casing
+     * is needed.
      */
     buildDecoratedManifest(chatConfig) {
         this.toolNameById.clear();
+        const used = new Set(["redirect"]);
         const decoratedHostTools = (chatConfig?.tools?.tools ?? []).map((t) => {
-            const id = generateToolId(t.name);
+            const id = uniqueToolId(t.name, used);
+            used.add(id);
             this.toolNameById.set(id, t.name);
             return { ...t, id };
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yak-io/javascript",
-  "version": "0.10.0",
+  "version": "0.10.1",
   "description": "Core JavaScript SDK for embedding yak chatbot",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",