@yak-io/javascript 0.10.0 → 0.11.0

package/dist/index.server.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/server/sources.ts", "../src/server/createYakHandler.ts"],
+  "sourcesContent": ["import type { RouteInfo } from \"../types/routes.js\";\nimport type { ToolDefinition, ToolExecutor, ToolManifest } from \"../types/tools.js\";\n\nexport type RouteSource = {\n  id?: string;\n  getRoutes: () => Promise<RouteInfo[]>;\n};\n\ntype RouteSourceFn = () => Promise<RouteInfo[]>;\n\ntype RouteSourceInputItem = RouteSource | RouteSourceFn | RouteInfo[];\n\nexport type RouteSourceInput = RouteSourceInputItem | RouteSourceInputItem[];\n\nexport type ToolSource = {\n  id?: string;\n  getTools: () => Promise<ToolDefinition[]>;\n  executeTool?: ToolExecutor;\n};\n\ntype ToolSourceFn = () => Promise<ToolDefinition[] | ToolManifest>;\n\ntype ToolSourceInputItem =\n  | ToolSource\n  | ToolSourceFn\n  | ToolDefinition[]\n  | ToolManifest\n  | {\n      getTools: ToolSourceFn;\n      executeTool?: ToolExecutor;\n    };\n\nexport type ToolSourceInput = ToolSourceInputItem | ToolSourceInputItem[];\n\nfunction isRouteSource(value: unknown): value is RouteSource {\n  return Boolean(\n    value &&\n      typeof value === \"object\" &&\n      \"getRoutes\" in value &&\n      typeof (value as RouteSource).getRoutes === \"function\"\n  );\n}\n\nfunction isRouteInfoArray(value: unknown): value is RouteInfo[] {\n  return Array.isArray(value) && value.every((route) => route && typeof route.path === \"string\");\n}\n\nfunction normalizeRouteSourceItem(item: RouteSourceInputItem, index: number): RouteSource {\n  if (isRouteSource(item)) {\n    return {\n      id: item.id ?? `route-source-${index}`,\n      getRoutes: item.getRoutes,\n    };\n  }\n\n  if (typeof item === \"function\") {\n    return {\n      id: `route-fn-${index}`,\n      getRoutes: item,\n    };\n  }\n\n  if (isRouteInfoArray(item)) {\n    return {\n      id: `route-static-${index}`,\n      getRoutes: async () => item,\n    };\n  }\n\n  throw new Error(\"Unsupported route source input\");\n}\n\nexport function normalizeRouteSources(input: RouteSourceInput): RouteSource[] {\n  if (Array.isArray(input)) {\n    if (input.length === 0) {\n      return [];\n    }\n    if (isRouteInfoArray(input)) {\n      return [normalizeRouteSourceItem(input, 0)];\n    }\n    return (input as RouteSourceInputItem[]).map((item, index) =>\n      normalizeRouteSourceItem(item, index)\n    );\n  }\n\n  return [normalizeRouteSourceItem(input, 0)];\n}\n\nfunction isToolSource(value: unknown): value is ToolSource {\n  return Boolean(\n    value &&\n      typeof value === \"object\" &&\n      \"getTools\" in value &&\n      typeof (value as ToolSource).getTools === \"function\"\n  );\n}\n\nfunction isToolManifest(value: unknown): value is ToolManifest {\n  return Boolean(value && typeof value === \"object\" && \"tools\" in value);\n}\n\nfunction isToolDefinitionArray(value: unknown): value is ToolDefinition[] {\n  return Array.isArray(value) && value.every((tool) => tool && typeof tool.name === \"string\");\n}\n\nfunction toToolDefinitions(result: unknown): ToolDefinition[] {\n  if (isToolDefinitionArray(result)) {\n    return result;\n  }\n  if (isToolManifest(result)) {\n    return result.tools;\n  }\n  throw new Error(\"Tool source must resolve to ToolDefinition[] or ToolManifest\");\n}\n\nfunction normalizeToolSourceItem(item: ToolSourceInputItem, index: number): ToolSource {\n  if (isToolSource(item)) {\n    return {\n      id: item.id ?? `tool-source-${index}`,\n      getTools: async () => {\n        const result = await item.getTools();\n        return toToolDefinitions(result);\n      },\n      executeTool: item.executeTool,\n    };\n  }\n\n  if (typeof item === \"function\") {\n    return {\n      id: `tool-fn-${index}`,\n      getTools: async () => {\n        const result = await item();\n        return toToolDefinitions(result);\n      },\n    };\n  }\n\n  if (isToolDefinitionArray(item)) {\n    return {\n      id: `tool-static-${index}`,\n      getTools: async () => item,\n    };\n  }\n\n  if (isToolManifest(item)) {\n    return {\n      id: `tool-manifest-${index}`,\n      getTools: async () => item.tools,\n    };\n  }\n\n  if (\n    item &&\n    typeof item === \"object\" &&\n    \"getTools\" in item &&\n    typeof item.getTools === \"function\"\n  ) {\n    return {\n      id: (item as { id?: string }).id ?? `tool-wrapper-${index}`,\n      getTools: async () => {\n        const result = await item.getTools();\n        return toToolDefinitions(result);\n      },\n      executeTool: item.executeTool,\n    };\n  }\n\n  throw new Error(\"Unsupported tool source input\");\n}\n\nexport function normalizeToolSources(input?: ToolSourceInput): ToolSource[] {\n  if (!input) {\n    return [];\n  }\n  if (Array.isArray(input)) {\n    if (input.length === 0) {\n      return [];\n    }\n    if (isToolDefinitionArray(input)) {\n      return [normalizeToolSourceItem(input, 0)];\n    }\n    return (input as ToolSourceInputItem[]).map((item, index) =>\n      normalizeToolSourceItem(item, index)\n    );\n  }\n\n  return [normalizeToolSourceItem(input, 0)];\n}\n", "import type { ChatConfig } from \"../types/config.js\";\nimport type { RouteInfo, RouteManifest } from \"../types/routes.js\";\nimport type { ToolCallResult, ToolDefinition, ToolManifest } from \"../types/tools.js\";\nimport type { RouteSource, RouteSourceInput, ToolSource, ToolSourceInput } from \"./sources.js\";\nimport { normalizeRouteSources, normalizeToolSources } from \"./sources.js\";\n\nexport type YakHandlerConfig = {\n  routes: RouteSourceInput;\n  tools?: ToolSourceInput;\n};\n\nexport function createYakHandler(config: YakHandlerConfig) {\n  const routeSources = normalizeRouteSources(config.routes);\n  const toolSources = normalizeToolSources(config.tools);\n\n  const GET = async function handleConfig(_req: Request): Promise<Response> {\n    const chatConfig: ChatConfig = {\n      routes: await buildRouteManifest(routeSources),\n    };\n\n    if (toolSources.length > 0) {\n      const { manifest } = await buildToolRegistry(toolSources);\n      chatConfig.tools = manifest;\n    }\n\n    return jsonResponse(chatConfig, 200, {\n      \"Cache-Control\": \"no-store\",\n    });\n  };\n\n  const POST = async function handleToolCall(req: Request): Promise<Response> {\n    if (toolSources.length === 0) {\n      return errorResponse(\"Tool execution is not configured\", 501);\n    }\n\n    let payload: unknown;\n\n    try {\n      payload = await req.json();\n    } catch {\n      return errorResponse(\"Invalid JSON payload\", 400);\n    }\n\n    if (!isHostToolCallPayload(payload)) {\n      return errorResponse(\"Invalid tool call payload\", 400);\n    }\n\n    try {\n      const { lookup } = await buildToolRegistry(toolSources);\n      const owner = lookup.get(payload.name);\n\n      if (!owner) {\n        return createToolErrorResponse(`Tool '${payload.name}' is not registered`);\n      }\n\n      if (!owner.executeTool) {\n        return createToolErrorResponse(`Tool '${payload.name}' does not expose an executor`);\n      }\n\n      const result = await owner.executeTool(payload.name, payload.args, req);\n\n      const successResult: ToolCallResult = {\n        ok: true,\n        result,\n      };\n\n      return jsonResponse(successResult);\n    } catch (error) {\n      return createToolErrorResponse(extractErrorMessage(error));\n    }\n  };\n\n  return { GET, POST };\n}\n\nexport type YakConfigHandlerConfig = {\n  routes: RouteSourceInput;\n  tools?: ToolSourceInput;\n};\n\nexport function createYakConfigHandler(config: YakConfigHandlerConfig) {\n  const routeSources = normalizeRouteSources(config.routes);\n  const toolSources = normalizeToolSources(config.tools);\n\n  return async function handleConfig(_req: Request): Promise<Response> {\n    const chatConfig: ChatConfig = {\n      routes: await buildRouteManifest(routeSources),\n    };\n\n    if (toolSources.length > 0) {\n      const { manifest } = await buildToolRegistry(toolSources);\n      chatConfig.tools = manifest;\n    }\n\n    return jsonResponse(chatConfig, 200, {\n      \"Cache-Control\": \"no-store\",\n    });\n  };\n}\n\nexport type YakToolsHandlerConfig = {\n  tools: ToolSourceInput;\n};\n\nexport function createYakToolsHandler(config: YakToolsHandlerConfig) {\n  const toolSources = normalizeToolSources(config.tools);\n\n  if (toolSources.length === 0) {\n    throw new Error(\"createYakToolsHandler requires at least one tool source\");\n  }\n\n  return async function handleTools(req: Request): Promise<Response> {\n    let payload: unknown;\n\n    try {\n      payload = await req.json();\n    } catch {\n      return errorResponse(\"Invalid JSON payload\", 400);\n    }\n\n    if (!isHostToolCallPayload(payload)) {\n      return errorResponse(\"Invalid tool call payload\", 400);\n    }\n\n    try {\n      const { lookup } = await buildToolRegistry(toolSources);\n      const owner = lookup.get(payload.name);\n\n      if (!owner) {\n        return createToolErrorResponse(`Tool '${payload.name}' is not registered`);\n      }\n\n      if (!owner.executeTool) {\n        return createToolErrorResponse(`Tool '${payload.name}' does not expose an executor`);\n      }\n\n      const result = await owner.executeTool(payload.name, payload.args, req);\n      const successResult: ToolCallResult = {\n        ok: true,\n        result,\n      };\n\n      return jsonResponse(successResult);\n    } catch (error) {\n      return createToolErrorResponse(extractErrorMessage(error));\n    }\n  };\n}\n\nasync function buildRouteManifest(routeSources: RouteSource[]): Promise<RouteManifest> {\n  const entries = await Promise.all(\n    routeSources.map(async (source) => ({\n      id: source.id ?? \"routes\",\n      routes: await source.getRoutes(),\n    }))\n  );\n\n  const merged: RouteInfo[] = [];\n  const seen = new Set<string>();\n\n  for (const entry of entries) {\n    for (const route of entry.routes) {\n      const key = route.path;\n      if (!seen.has(key)) {\n        seen.add(key);\n        merged.push(route);\n      }\n    }\n  }\n\n  merged.sort((a, b) => a.path.localeCompare(b.path));\n\n  return {\n    routes: merged,\n    generated_at: new Date().toISOString(),\n    sources: entries.map((entry) => ({ id: entry.id, count: entry.routes.length })),\n  };\n}\n\ntype ToolRegistry = {\n  manifest: ToolManifest;\n  lookup: Map<string, ToolSource>;\n};\n\nasync function buildToolRegistry(toolSources: ToolSource[]): Promise<ToolRegistry> {\n  const entries = await Promise.all(\n    toolSources.map(async (source) => ({\n      id: source.id ?? \"tools\",\n      source,\n      tools: await source.getTools(),\n    }))\n  );\n\n  const manifestTools: ToolDefinition[] = [];\n  const lookup = new Map<string, ToolSource>();\n\n  for (const entry of entries) {\n    for (const tool of entry.tools) {\n      manifestTools.push(tool);\n      lookup.set(tool.name, entry.source);\n    }\n  }\n\n  return {\n    manifest: {\n      tools: manifestTools,\n      generated_at: new Date().toISOString(),\n      sources: entries.map((entry) => ({ id: entry.id, count: entry.tools.length })),\n    },\n    lookup,\n  };\n}\n\n/**\n * Payload received from the host (id is optional since YakClient handles correlation)\n */\ntype HostToolCallPayload = {\n  name: string;\n  args: unknown;\n};\n\nfunction isHostToolCallPayload(payload: unknown): payload is HostToolCallPayload {\n  return (\n    typeof payload === \"object\" &&\n    payload !== null &&\n    typeof (payload as HostToolCallPayload).name === \"string\" &&\n    \"args\" in payload\n  );\n}\n\nfunction extractErrorMessage(error: unknown): string {\n  if (error instanceof Error) {\n    return error.message;\n  }\n  if (typeof error === \"string\") {\n    return error;\n  }\n  return \"An unknown error occurred\";\n}\n\nfunction jsonResponse(body: unknown, status = 200, headers: Record<string, string> = {}): Response {\n  return new Response(JSON.stringify(body), {\n    status,\n    headers: {\n      \"Content-Type\": \"application/json\",\n      ...headers,\n    },\n  });\n}\n\nfunction errorResponse(message: string, status: number): Response {\n  return jsonResponse({ error: message }, status);\n}\n\nfunction createToolErrorResponse(error: string): Response {\n  const errorResult: ToolCallResult = {\n    ok: false,\n    error,\n  };\n\n  return jsonResponse(errorResult);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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/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;YA2BX,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yak-io/javascript",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Core JavaScript SDK for embedding yak chatbot",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",
@@ -30,18 +30,20 @@
     "LICENSE"
   ],
   "sideEffects": false,
-  "main": "./dist/index.js",
+  "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
       "default": "./dist/index.js"
     },
     "./server": {
       "types": "./dist/index.server.d.ts",
       "import": "./dist/index.server.js",
+      "require": "./dist/index.server.cjs",
       "default": "./dist/index.server.js"
     },
     "./package.json": "./package.json"
@@ -65,7 +67,7 @@
   },
   "homepage": "https://docs.yak.io/docs/sdks/javascript",
   "scripts": {
-    "build": "tsc",
+    "build": "node ../../scripts/build-package.mjs && tsc --emitDeclarationOnly",
     "check-types": "tsc --noEmit",
     "test": "vitest run",
     "lint": "biome lint ./src --fix",

package/dist/client.js

@@ -1,524 +0,0 @@
-import { isYakLoggingEnabled, logger } from "./logger.js";
-import { debounce, extractPageContext } from "./page-context.js";
-import { EMBED_PROTOCOL_VERSION } from "./version.js";
-/** localStorage key for the per-app signed session token. */
-const SESSION_STORAGE_KEY = (appId) => `yak:session:${appId}`;
-/** localStorage key for the per-app active-conversation pointer. */
-const CONVERSATION_POINTER_KEY = (appId) => `yak:conversation:${appId}`;
-/** Read a stored session token for this app, if any. SSR-safe. */
-function readStoredSessionToken(appId) {
-    if (typeof window === "undefined" || typeof window.localStorage === "undefined")
-        return undefined;
-    try {
-        return window.localStorage.getItem(SESSION_STORAGE_KEY(appId)) ?? undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
-function writeStoredSessionToken(appId, token) {
-    if (typeof window === "undefined" || typeof window.localStorage === "undefined")
-        return;
-    try {
-        window.localStorage.setItem(SESSION_STORAGE_KEY(appId), token);
-    }
-    catch {
-        // localStorage can throw in private-browsing modes; silently ignore.
-    }
-}
-function readStoredConversationPointer(appId) {
-    if (typeof window === "undefined" || typeof window.localStorage === "undefined")
-        return undefined;
-    try {
-        return window.localStorage.getItem(CONVERSATION_POINTER_KEY(appId)) ?? undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
-function writeStoredConversationPointer(appId, pointer) {
-    if (typeof window === "undefined" || typeof window.localStorage === "undefined")
-        return;
-    try {
-        window.localStorage.setItem(CONVERSATION_POINTER_KEY(appId), pointer);
-    }
-    catch {
-        // localStorage can throw in private-browsing modes; silently ignore.
-    }
-}
-function clearStoredConversationPointer(appId) {
-    if (typeof window === "undefined" || typeof window.localStorage === "undefined")
-        return;
-    try {
-        window.localStorage.removeItem(CONVERSATION_POINTER_KEY(appId));
-    }
-    catch {
-        // localStorage can throw in private-browsing modes; silently ignore.
-    }
-}
-/** Production chat origin — where the widget iframe loads from by default. */
-const DEFAULT_CHAT_ORIGIN = "https://chat.yak.io";
-/**
- * Resolves the iframe origin when no explicit `origin` is configured. Points at
- * a local chat UI during yak's own local development; production otherwise.
- * Integrators override the result with the `origin` config option.
- */
-function getDefaultIframeOrigin() {
-    if (typeof window !== "undefined" &&
-        (window.location.hostname === "localhost" || window.location.hostname === "127.0.0.1") &&
-        typeof window.__YAK_INTERNAL_DEV__ !== "undefined") {
-        return "http://localhost:3001";
-    }
-    return DEFAULT_CHAT_ORIGIN;
-}
-export class YakClient {
-    config;
-    iframeWindow = null;
-    isWidgetOpen = false;
-    readyTarget = null;
-    unexpectedOriginLogged = false;
-    lastUrl = " ";
-    debouncedSendContext;
-    observer = null;
-    constructor(config) {
-        this.config = config;
-        this.debouncedSendContext = debounce(() => {
-            logger.debug("DOM mutation detected, sending page context");
-            this.sendPageContext();
-        }, 2000);
-    }
-    updateConfig(newConfig) {
-        this.config = { ...this.config, ...newConfig };
-        // Resend config when the iframe is ready and we have anything to deliver —
-        // tool/route manifests, or a user identity that needs to land in the
-        // widget so persistence/history light up.
-        if (this.readyTarget && (this.config.chatConfig || this.config.user)) {
-            this.sendConfigToIframe(this.readyTarget.window, this.readyTarget.origin);
-        }
-    }
-    /**
-     * Get the iframe origin URL (base URL for the chat widget). Recomputed on
-     * each call so environment-dependent defaults resolve correctly.
-     */
-    getIframeOrigin() {
-        return this.config.origin ?? getDefaultIframeOrigin();
-    }
-    /**
-     * Get the full iframe embed URL for the chatbot
-     *
-     * @example
-     * ```ts
-     * const client = new YakClient({ appId: "my-app" });
-     * const iframeSrc = client.getEmbedUrl();
-     * // Returns: "https://chat.yak.io/embed/v1/my-app"
-     * ```
-     */
-    getEmbedUrl() {
-        const origin = this.getIframeOrigin();
-        const baseUrl = `${origin}/embed/v${EMBED_PROTOCOL_VERSION}/${encodeURIComponent(this.config.appId)}`;
-        const params = new URLSearchParams();
-        const theme = this.config.theme;
-        if (theme?.colorMode && theme.colorMode !== "system") {
-            params.set("colorMode", theme.colorMode);
-        }
-        this.appendThemeColors(params, theme?.light, "light");
-        this.appendThemeColors(params, theme?.dark, "dark");
-        // Pass debug flag to iframe so it can enable logging immediately
-        if (isYakLoggingEnabled()) {
-            params.set("yakDebug", "1");
-        }
-        const queryString = params.toString();
-        return queryString ? `${baseUrl}?${queryString}` : baseUrl;
-    }
-    /**
-     * Append theme color parameters to a URLSearchParams object
-     */
-    appendThemeColors(params, colors, prefix) {
-        if (!colors)
-            return;
-        const map = [
-            [`${prefix}Bg`, colors.background],
-            [`${prefix}Border`, colors.border],
-            [`${prefix}MessageBg`, colors.messageBackground],
-            [`${prefix}Placeholder`, colors.placeholderColor],
-            [`${prefix}SubmitBtn`, colors.submitButtonColor],
-            [`${prefix}SubmitBtnText`, colors.submitButtonTextColor],
-            [`${prefix}HeaderIcon`, colors.headerIconColor],
-        ];
-        for (const [key, value] of map) {
-            if (value)
-                params.set(key, value);
-        }
-    }
-    /**
-     * Get the app ID
-     */
-    getAppId() {
-        return this.config.appId;
-    }
-    /**
-     * Get the current theme configuration
-     */
-    getTheme() {
-        return this.config.theme;
-    }
-    /**
-     * Send a prompt message to the chatbot iframe
-     * Note: The iframe must be ready to receive messages (onReady callback must have fired)
-     *
-     * @example
-     * ```ts
-     * const client = new YakClient({ appId: "my-app", onReady: () => {
-     *   client.sendPrompt("Help me with my order");
-     * }});
-     * ```
-     */
-    sendPrompt(prompt) {
-        if (!this.iframeWindow) {
-            logger.warn("Cannot send prompt: iframe not ready");
-            return;
-        }
-        const message = {
-            type: "yak:prompt",
-            payload: { prompt },
-        };
-        this.iframeWindow.postMessage(message, this.getIframeOrigin());
-    }
-    /**
-     * Send a focus request to the chatbot iframe
-     * This will focus the chat input field
-     */
-    sendFocus() {
-        if (!this.iframeWindow) {
-            logger.warn("Cannot send focus: iframe not ready");
-            return;
-        }
-        const message = {
-            type: "yak:focus",
-        };
-        this.iframeWindow.postMessage(message, this.getIframeOrigin());
-    }
-    /**
-     * Check if the iframe is ready to receive messages
-     */
-    isReady() {
-        return this.readyTarget !== null;
-    }
-    setIframeWindow(window) {
-        this.iframeWindow = window;
-        if (!window) {
-            this.readyTarget = null;
-        }
-    }
-    setWidgetOpen(isOpen) {
-        this.isWidgetOpen = isOpen;
-        if (isOpen && this.readyTarget && this.config.chatConfig) {
-            this.sendConfigToIframe(this.readyTarget.window, this.readyTarget.origin);
-        }
-        if (isOpen) {
-            this.startObserving();
-        }
-        else {
-            this.stopObserving();
-        }
-    }
-    mount() {
-        if (typeof window !== "undefined") {
-            window.addEventListener("message", this.handleMessage);
-            window.addEventListener("popstate", this.handlePopState);
-        }
-    }
-    unmount() {
-        if (typeof window !== "undefined") {
-            window.removeEventListener("message", this.handleMessage);
-            window.removeEventListener("popstate", this.handlePopState);
-        }
-        this.stopObserving();
-    }
-    startObserving() {
-        if (typeof window === "undefined" || !this.iframeWindow)
-            return;
-        // Initial check
-        const currentUrl = window.location.href;
-        if (currentUrl !== this.lastUrl) {
-            this.lastUrl = currentUrl;
-            logger.debug("URL changed, sending page context");
-            this.sendPageContext();
-        }
-        if (this.observer)
-            return;
-        this.observer = new MutationObserver((mutations) => {
-            const hasSubstantialChanges = mutations.some((mutation) => mutation.type === "childList" &&
-                (mutation.addedNodes.length > 0 || mutation.removedNodes.length > 0));
-            if (hasSubstantialChanges) {
-                this.debouncedSendContext();
-            }
-        });
-        this.observer.observe(document.body, {
-            childList: true,
-            subtree: true,
-        });
-    }
-    stopObserving() {
-        if (this.observer) {
-            this.observer.disconnect();
-            this.observer = null;
-        }
-    }
-    handlePopState = () => {
-        logger.debug("Navigation detected, sending page context");
-        this.sendPageContext();
-    };
-    handleMessage = (event) => {
-        if (typeof window === "undefined")
-            return;
-        if (!this.isWidgetOpen && event.data?.type !== "yak:ready") {
-            return;
-        }
-        const hostOrigin = window.location.origin;
-        const allowedOrigins = new Set();
-        allowedOrigins.add(this.getIframeOrigin());
-        if (hostOrigin) {
-            allowedOrigins.add(hostOrigin);
-        }
-        if (!allowedOrigins.has(event.origin)) {
-            if (!this.unexpectedOriginLogged) {
-                logger.warn(`Ignoring message from unexpected origin: ${event.origin}, allowed: ${Array.from(allowedOrigins).join(", ")}`);
-                this.unexpectedOriginLogged = true;
-            }
-            return;
-        }
-        // Validate message structure
-        if (!event.data || typeof event.data !== "object" || !("type" in event.data)) {
-            // Filter out known browser extension messages
-            const data = event.data;
-            const isReactDevTools = data?.source === "react-devtools-content-script" ||
-                data?.source === "react-devtools-bridge" ||
-                data?.source === "react-devtools-inject-backend";
-            const isReduxDevTools = data?.source === "@devtools-page";
-            if (isReactDevTools || isReduxDevTools) {
-                return;
-            }
-            return;
-        }
-        const message = event.data;
-        const targetWindow = (event.source && "postMessage" in event.source ? event.source : null) ??
-            this.iframeWindow;
-        const targetOrigin = this.getIframeOrigin();
-        logger.debug("Message received from iframe:", message.type);
-        switch (message.type) {
-            case "yak:ready": {
-                logger.debug("Iframe ready, sending config");
-                if (targetWindow) {
-                    this.readyTarget = { window: targetWindow, origin: targetOrigin };
-                    this.sendConfigToIframe(targetWindow, targetOrigin);
-                    // Send initial page context after config
-                    setTimeout(() => this.sendPageContext(), 100);
-                    // Mark iframe as ready after config is sent
-                    setTimeout(() => this.config.onReady?.(), 200);
-                }
-                else {
-                    logger.warn("Unable to send config: iframe window not registered yet");
-                }
-                break;
-            }
-            case "yak:tool_call": {
-                const { id, name, args } = message.payload;
-                void this.handleToolCall(id, name, args);
-                break;
-            }
-            case "yak:redirect": {
-                const { path } = message.payload;
-                logger.debug("Redirect request received:", path);
-                if (!this.isAllowedRedirect(path)) {
-                    logger.warn("Blocked potentially unsafe redirect:", path);
-                    break;
-                }
-                if (this.config.onRedirect) {
-                    this.config.onRedirect(path);
-                }
-                else if (typeof window !== "undefined") {
-                    window.location.assign(path);
-                }
-                break;
-            }
-            case "yak:session": {
-                const { sessionToken } = message.payload;
-                logger.debug("Session token received from iframe; persisting");
-                writeStoredSessionToken(this.config.appId, sessionToken);
-                break;
-            }
-            case "yak:conversation": {
-                const { pointer } = message.payload;
-                if (pointer === null) {
-                    logger.debug("Conversation pointer cleared by iframe");
-                    clearStoredConversationPointer(this.config.appId);
-                }
-                else {
-                    logger.debug("Conversation pointer received from iframe; persisting");
-                    writeStoredConversationPointer(this.config.appId, pointer);
-                }
-                break;
-            }
-            case "yak:close": {
-                logger.debug("Close message received from iframe");
-                this.config.onClose?.();
-                break;
-            }
-            default:
-                logger.debug("Unknown message type:", message.type);
-                break;
-        }
-    };
-    sendConfigToIframe(targetWindow, targetOrigin) {
-        // Get logging enabled state from window flag
-        const loggingEnabled = typeof window !== "undefined" && typeof window.__YAK_LOGGING_ENABLED__ === "boolean"
-            ? window.__YAK_LOGGING_ENABLED__
-            : undefined;
-        const storedSessionToken = readStoredSessionToken(this.config.appId);
-        const storedConversationPointer = readStoredConversationPointer(this.config.appId);
-        const configMessage = {
-            type: "yak:config",
-            payload: {
-                version: EMBED_PROTOCOL_VERSION,
-                appId: this.config.appId,
-                theme: this.config.theme,
-                toolManifest: this.config.chatConfig?.tools ?? undefined,
-                routeManifest: this.config.chatConfig?.routes ?? undefined,
-                options: this.config.options,
-                loggingEnabled,
-                user: this.config.user,
-                sessionToken: storedSessionToken,
-                conversationPointer: storedConversationPointer,
-            },
-        };
-        logger.debug("Posting config to iframe origin:", {
-            origin: targetOrigin,
-            version: EMBED_PROTOCOL_VERSION,
-            hasToolManifest: Boolean(this.config.chatConfig?.tools),
-            toolCount: this.config.chatConfig?.tools?.tools.length ?? 0,
-            hasRouteManifest: Boolean(this.config.chatConfig?.routes),
-        });
-        targetWindow.postMessage(configMessage, targetOrigin);
-    }
-    sendPageContext() {
-        if (!this.iframeWindow)
-            return;
-        try {
-            const pageContext = extractPageContext();
-            const message = {
-                type: "yak:page_context",
-                payload: pageContext,
-            };
-            logger.debug("Sending page context to iframe:", {
-                url: pageContext.url,
-                title: pageContext.title,
-                textLength: pageContext.text.length,
-            });
-            this.iframeWindow.postMessage(message, this.getIframeOrigin());
-        }
-        catch (error) {
-            logger.error("Error extracting page context:", error);
-        }
-    }
-    async handleToolCall(id, name, args) {
-        logger.debug(`Tool call received: ${name}`, { id, args });
-        if (!this.config.onToolCall) {
-            logger.error("Tool call received but no onToolCall handler configured");
-            this.sendToolResultToIframe(id, false, undefined, "No tool call handler configured");
-            this.config.onToolCallComplete?.({
-                name,
-                args,
-                ok: false,
-                error: "No tool call handler configured",
-            });
-            return;
-        }
-        try {
-            const result = await this.config.onToolCall(name, args);
-            logger.debug(`Tool call succeeded: ${name}`, { id });
-            this.sendToolResultToIframe(id, true, result);
-            this.config.onToolCallComplete?.({ name, args, ok: true, result });
-        }
-        catch (error) {
-            const errorMessage = this.extractErrorMessage(error);
-            logger.error(`Tool call failed: ${name}`, { id, error });
-            this.sendToolResultToIframe(id, false, undefined, errorMessage);
-            this.config.onToolCallComplete?.({ name, args, ok: false, error: errorMessage });
-        }
-    }
-    sendToolResultToIframe(id, ok, result, error) {
-        if (!this.iframeWindow)
-            return;
-        if (ok) {
-            // Serialize result to remove non-cloneable values (functions, etc.)
-            // postMessage uses structured clone which cannot handle functions
-            const safeResult = this.toSerializable(result);
-            const message = {
-                type: "yak:tool_result",
-                payload: { id, ok: true, result: safeResult },
-            };
-            this.iframeWindow.postMessage(message, this.getIframeOrigin());
-        }
-        else {
-            const message = {
-                type: "yak:tool_result",
-                payload: { id, ok: false, error: error ?? "Unknown error" },
-            };
-            this.iframeWindow.postMessage(message, this.getIframeOrigin());
-        }
-    }
-    /**
-     * Convert a value to a serializable form by stripping functions and other non-cloneable values.
-     * Uses JSON.parse(JSON.stringify()) which handles most cases.
-     */
-    toSerializable(value) {
-        if (value === undefined || value === null) {
-            return value;
-        }
-        try {
-            return JSON.parse(JSON.stringify(value));
-        }
-        catch {
-            // If JSON serialization fails, return a string representation
-            logger.warn("Failed to serialize tool result, returning string representation");
-            return String(value);
-        }
-    }
-    extractErrorMessage(error) {
-        if (error instanceof Error) {
-            return error.message;
-        }
-        if (typeof error === "string") {
-            return error;
-        }
-        return "Unknown error";
-    }
-    /**
-     * Validates that a redirect path is safe (relative path or same-origin).
-     * Blocks absolute URLs to external domains to prevent open redirect attacks.
-     */
-    isAllowedRedirect(path) {
-        // Allow relative paths that don't start with // (protocol-relative URLs)
-        if (path.startsWith("/") && !path.startsWith("//")) {
-            return true;
-        }
-        // Allow hash-only and query-only paths
-        if (path.startsWith("#") || path.startsWith("?")) {
-            return true;
-        }
-        // For absolute URLs, verify same origin
-        if (typeof window !== "undefined") {
-            try {
-                const url = new URL(path, window.location.origin);
-                return url.origin === window.location.origin;
-            }
-            catch {
-                // Invalid URL - block it
-                return false;
-            }
-        }
-        // In non-browser environments, only allow relative paths
-        return false;
-    }
-}