@yak-io/javascript 0.8.0 → 0.10.0

package/dist/toolset.d.ts

@@ -0,0 +1,45 @@
+import type { ToolAdapter, YakToolset } from "./types/tools.js";
+/**
+ * Compose client-side {@link ToolAdapter}s into ONE merged tool manifest and ONE
+ * routed `onToolCall`. This is the single injection point for "available tools"
+ * into the iframe: every adapter — client-side (GraphQL/REST/custom, run by your own
+ * `execute` callback) or server-relayed ({@link createYakServerAdapter}) — contributes
+ * its tools to the merged manifest and its executor to the routed handler. Because every
+ * tool now flows through `onToolCall`, they all surface through `onToolCallComplete` /
+ * `useYakToolEvent`.
+ *
+ * @example
+ * ```tsx
+ * const toolset = createYakToolset([
+ *   createYakServerAdapter({ endpoint: "/api/yak" }),               // tRPC + custom server tools
+ *   createGraphQLToolAdapter({ name: "shop", schema, execute: runShopQuery }),
+ *   createRESTToolAdapter({ name: "billing", spec, execute: callBillingApi }),
+ * ]);
+ *
+ * <YakProvider
+ *   getConfig={async () => ({ routes, ...(await toolset.getConfig()) })}
+ *   onToolCall={toolset.onToolCall}
+ * />;
+ * ```
+ */
+export declare function createYakToolset(adapters: ToolAdapter[]): YakToolset;
+/** Config for {@link createYakServerAdapter}. */
+export type YakServerAdapterConfig = {
+    /**
+     * Endpoint mounting `createYakHandler` / `createNextYakHandler`. GET returns the
+     * tool manifest; POST `{ name, args }` executes a tool. Default: `"/api/yak"`.
+     */
+    endpoint?: string;
+    /** Stable id for diagnostics. Default: `"server"`. */
+    id?: string;
+    /** Extra headers (e.g. auth) applied to both the GET manifest load and POST execution. */
+    headers?: HeadersInit | (() => HeadersInit | Promise<HeadersInit>);
+};
+/**
+ * Bridge a server-side yak handler ({@link createYakHandler} /
+ * `createNextYakHandler`, e.g. fronting the `@yak-io/trpc` adapter) into a
+ * client-side {@link ToolAdapter}, so server-relayed tools merge into the same
+ * manifest + `onToolCall` as browser-executed adapters.
+ */
+export declare function createYakServerAdapter(config?: YakServerAdapterConfig): ToolAdapter;
+//# sourceMappingURL=toolset.d.ts.map

package/dist/toolset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolset.d.ts","sourceRoot":"","sources":["../src/toolset.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,WAAW,EAIX,UAAU,EACX,MAAM,kBAAkB,CAAC;AAO1B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,UAAU,CA4DpE;AAED,iDAAiD;AACjD,MAAM,MAAM,sBAAsB,GAAG;IACnC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0FAA0F;IAC1F,OAAO,CAAC,EAAE,WAAW,GAAG,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;CACpE,CAAC;AAgBF;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,GAAE,sBAA2B,GAAG,WAAW,CA8BvF"}

package/dist/toolset.js

@@ -0,0 +1,119 @@
+import { logger } from "./logger.js";
+/**
+ * Compose client-side {@link ToolAdapter}s into ONE merged tool manifest and ONE
+ * routed `onToolCall`. This is the single injection point for "available tools"
+ * into the iframe: every adapter — client-side (GraphQL/REST/custom, run by your own
+ * `execute` callback) or server-relayed ({@link createYakServerAdapter}) — contributes
+ * its tools to the merged manifest and its executor to the routed handler. Because every
+ * tool now flows through `onToolCall`, they all surface through `onToolCallComplete` /
+ * `useYakToolEvent`.
+ *
+ * @example
+ * ```tsx
+ * const toolset = createYakToolset([
+ *   createYakServerAdapter({ endpoint: "/api/yak" }),               // tRPC + custom server tools
+ *   createGraphQLToolAdapter({ name: "shop", schema, execute: runShopQuery }),
+ *   createRESTToolAdapter({ name: "billing", spec, execute: callBillingApi }),
+ * ]);
+ *
+ * <YakProvider
+ *   getConfig={async () => ({ routes, ...(await toolset.getConfig()) })}
+ *   onToolCall={toolset.onToolCall}
+ * />;
+ * ```
+ */
+export function createYakToolset(adapters) {
+    let cache = null;
+    async function resolve(force = false) {
+        if (cache && !force)
+            return cache;
+        cache = await Promise.all(adapters.map(async (adapter) => ({ adapter, tools: await adapter.getTools() })));
+        return cache;
+    }
+    async function getConfig() {
+        // Refresh on every config load — tools may depend on page/user.
+        const resolved = await resolve(true);
+        const tools = [];
+        const seen = new Set();
+        for (const { adapter, tools: adapterTools } of resolved) {
+            for (const tool of adapterTools) {
+                if (seen.has(tool.name)) {
+                    logger.warn(`Duplicate tool name "${tool.name}"; keeping the first and ignoring the one from adapter "${adapter.id ?? "unknown"}".`);
+                    continue;
+                }
+                seen.add(tool.name);
+                tools.push(tool);
+            }
+        }
+        return {
+            tools: {
+                tools,
+                sources: resolved.map(({ adapter, tools: adapterTools }, index) => ({
+                    id: adapter.id ?? `adapter-${index}`,
+                    count: adapterTools.length,
+                })),
+            },
+        };
+    }
+    const onToolCall = async (name, args) => {
+        // Fast path: explicit ownership predicates need no resolution.
+        for (const adapter of adapters) {
+            if (adapter.ownsTool?.(name)) {
+                return adapter.execute(name, args);
+            }
+        }
+        // Otherwise route by the adapter's resolved tool names.
+        const resolved = await resolve();
+        for (const { adapter, tools } of resolved) {
+            if (adapter.ownsTool)
+                continue; // already consulted above
+            if (tools.some((tool) => tool.name === name)) {
+                return adapter.execute(name, args);
+            }
+        }
+        throw new Error(`Unknown tool: ${name}`);
+    };
+    return { getConfig, onToolCall };
+}
+async function buildHeaders(source, base) {
+    const headers = new Headers(base);
+    const resolved = typeof source === "function" ? await source() : source;
+    if (resolved) {
+        for (const [key, value] of new Headers(resolved)) {
+            headers.set(key, value);
+        }
+    }
+    return headers;
+}
+/**
+ * Bridge a server-side yak handler ({@link createYakHandler} /
+ * `createNextYakHandler`, e.g. fronting the `@yak-io/trpc` adapter) into a
+ * client-side {@link ToolAdapter}, so server-relayed tools merge into the same
+ * manifest + `onToolCall` as browser-executed adapters.
+ */
+export function createYakServerAdapter(config = {}) {
+    const endpoint = config.endpoint ?? "/api/yak";
+    return {
+        id: config.id ?? "server",
+        getTools: async () => {
+            const res = await fetch(endpoint, { headers: await buildHeaders(config.headers) });
+            if (!res.ok) {
+                throw new Error(`Failed to load tools from ${endpoint} (${res.status})`);
+            }
+            const chatConfig = (await res.json());
+            return chatConfig.tools?.tools ?? [];
+        },
+        execute: async (name, args) => {
+            const res = await fetch(endpoint, {
+                method: "POST",
+                headers: await buildHeaders(config.headers, { "Content-Type": "application/json" }),
+                body: JSON.stringify({ name, args }),
+            });
+            const data = (await res.json().catch(() => ({})));
+            if (!res.ok || !data.ok) {
+                throw new Error(data.error ?? `Tool "${name}" failed (${res.status})`);
+            }
+            return data.result;
+        },
+    };
+}

package/dist/types/config.d.ts

@@ -1,15 +1,13 @@
 import type { RouteManifest } from "./routes.js";
-import type { SchemaSource, ToolManifest } from "./tools.js";
+import type { ToolManifest } from "./tools.js";
 /**
- * Combined configuration for the chatbot including routes, tools, and schema sources
+ * Combined configuration for the chatbot including routes and tools.
  */
 export type ChatConfig = {
     /** Route manifest */
     routes: RouteManifest;
-    /** Optional tool manifest (tRPC, GraphQL, etc.) */
+    /** Optional tool manifest (tRPC, GraphQL, REST, custom, etc.) */
     tools?: ToolManifest;
-    /** Optional schema sources (GraphQL SDL, OpenAPI specs) passed as context to the LLM */
-    schemaSources?: SchemaSource[];
 };
 /**
  * Function that provides the chat configuration.

package/dist/types/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,qBAAqB;IACrB,MAAM,EAAE,aAAa,CAAC;IACtB,mDAAmD;IACnD,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,wFAAwF;IACxF,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;CAChC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,qBAAqB;IACrB,MAAM,EAAE,aAAa,CAAC;IACtB,iEAAiE;IACjE,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC"}

package/dist/types/messaging.d.ts

@@ -1,6 +1,6 @@
 import type { EmbedProtocolVersion } from "../version.js";
 import type { RouteManifest } from "./routes.js";
-import type { GraphQLRequest, RESTRequest, SchemaSource, ToolManifest } from "./tools.js";
+import type { ToolManifest } from "./tools.js";
 /**
  * Color values for a single mode (light or dark).
  * Applied as CSS variables within the chat UI.
@@ -88,8 +88,6 @@ export type IframeMessageFromHost = {
         theme?: Theme;
         toolManifest?: ToolManifest;
         routeManifest?: RouteManifest;
-        /** Schema sources passed as context to the LLM */
-        schemaSources?: SchemaSource[];
         /** Chat configuration options */
         options?: ChatOptions;
         /** Logging enabled flag from host (for cross-origin sync) */
@@ -159,20 +157,6 @@ export type IframeMessageToHost = {
         name: string;
         args: unknown;
     };
-} | {
-    type: "yak:graphql_schema_call";
-    payload: {
-        id: string;
-        schemaName: string;
-        request: GraphQLRequest;
-    };
-} | {
-    type: "yak:rest_schema_call";
-    payload: {
-        id: string;
-        schemaName: string;
-        request: RESTRequest;
-    };
 } | {
     type: "yak:redirect";
     payload: {

package/dist/types/messaging.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messaging.d.ts","sourceRoot":"","sources":["../../src/types/messaging.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"messaging.d.ts","sourceRoot":"","sources":["../../src/types/messaging.ts"],"names":[],"mappings":"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"}

package/dist/types/tools.d.ts

@@ -2,30 +2,6 @@
  * Generic JSON Schema type
  */
 export type JSONSchema = Record<string, unknown>;
-/**
- * GraphQL schema source for providing API context to the LLM
- */
-export type GraphQLSchemaSource = {
-    /** Unique identifier for this schema (used in callbacks) */
-    name: string;
-    type: "graphql";
-    /** The GraphQL schema in SDL format */
-    schema: string;
-};
-/**
- * OpenAPI spec source for providing API context to the LLM
- */
-export type OpenAPISchemaSource = {
-    /** Unique identifier for this schema (used in callbacks) */
-    name: string;
-    type: "openapi";
-    /** OpenAPI spec as JSON object or YAML string */
-    spec: Record<string, unknown> | string;
-};
-/**
- * Union type for schema sources
- */
-export type SchemaSource = GraphQLSchemaSource | OpenAPISchemaSource;
 /**
  * GraphQL request generated by the LLM
  */
@@ -50,24 +26,6 @@ export type RESTRequest = {
     /** Request body */
     body?: unknown;
 };
-/**
- * Handler for GraphQL schema tool calls.
- * The LLM generates the query based on the schema context.
- *
- * @param schemaName - The name of the schema (from SchemaSource.name)
- * @param request - The GraphQL request generated by the LLM
- * @returns The result of executing the GraphQL operation
- */
-export type GraphQLSchemaHandler = (schemaName: string, request: GraphQLRequest) => Promise<unknown>;
-/**
- * Handler for OpenAPI/REST schema tool calls.
- * The LLM generates the request based on the schema context.
- *
- * @param schemaName - The name of the schema (from SchemaSource.name)
- * @param request - The REST request generated by the LLM
- * @returns The result of executing the REST request
- */
-export type RESTSchemaHandler = (schemaName: string, request: RESTRequest) => Promise<unknown>;
 /**
  * Payload for a tool call request from the iframe
  */
@@ -155,4 +113,39 @@ export type ToolCallEvent = {
  * Called after every tool call completes, regardless of success/failure.
  */
 export type ToolCallEventListener = (event: ToolCallEvent) => void;
+/**
+ * Client-side tool adapter — the browser-side analogue of the server `ToolSource`.
+ *
+ * An adapter contributes tool definitions to the single merged manifest injected
+ * into the iframe AND knows how to execute the tools it owns. Adapters are composed
+ * with {@link createYakToolset} into one manifest + one `onToolCall` funnel, so
+ * GraphQL, REST, tRPC (server-relayed via {@link createYakServerAdapter}), and custom
+ * tools all flow through the same path — and therefore all surface through
+ * `onToolCallComplete` / `useYakToolEvent`.
+ */
+export type ToolAdapter = {
+    /** Stable id for diagnostics / manifest source attribution. */
+    id?: string;
+    /** Tool definitions this adapter contributes to the merged manifest. */
+    getTools: () => ToolDefinition[] | Promise<ToolDefinition[]>;
+    /** Execute a tool this adapter owns. Same signature as {@link ToolCallHandler}. */
+    execute: ToolCallHandler;
+    /**
+     * Whether this adapter owns `name`. When omitted, ownership defaults to
+     * membership in the names returned by {@link ToolAdapter.getTools}.
+     */
+    ownsTool?: (name: string) => boolean;
+};
+/**
+ * The result of composing {@link ToolAdapter}s with {@link createYakToolset}:
+ * a merged tool manifest for `getConfig()` and a single routed `onToolCall`.
+ */
+export type YakToolset = {
+    /** Resolved, merged + deduped tool manifest — spread into `getConfig().tools`. */
+    getConfig: () => Promise<{
+        tools: ToolManifest;
+    }>;
+    /** Single routed funnel for `YakProvider.onToolCall` / `YakClientConfig.onToolCall`. */
+    onToolCall: ToolCallHandler;
+};
 //# sourceMappingURL=tools.d.ts.map

package/dist/types/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/types/tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/types/tools.ts"],"names":[],"mappings":"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"}

package/dist/voice-machine.d.ts

@@ -10,11 +10,24 @@
  * delegated to the injected `RealtimeMessageContext` so the function is
  * testable with a plain in-memory mock.
  */
+/**
+ * Lifecycle of a voice session, in order:
+ * - `idle` — no session (the starting and stopped state).
+ * - `connecting` — establishing the WebRTC connection.
+ * - `listening` — connected and capturing the user's speech.
+ * - `thinking` — the model is processing / generating a response.
+ * - `speaking` — the assistant is playing audio back.
+ * - `error` — the session failed; see {@link VoiceMachine.errorMessage}.
+ */
 export type VoiceState = "idle" | "connecting" | "listening" | "thinking" | "speaking" | "error";
 export type VoiceEvent = {
     type: "start";
 } | {
     type: "connected";
+}
+/** An assistant-initiated turn was requested (e.g. the opening greeting). */
+ | {
+    type: "response_requested";
 } | {
     type: "speech_started";
 } | {
@@ -29,8 +42,11 @@ export type VoiceEvent = {
     type: "error";
     message: string;
 };
+/** Snapshot of a voice session's state machine. */
 export interface VoiceMachine {
+    /** Current lifecycle state of the session. */
     state: VoiceState;
+    /** Human-readable failure reason — set only when `state === "error"`. */
     errorMessage?: string;
 }
 export declare const INITIAL_VOICE_MACHINE: VoiceMachine;

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

@@ -1 +1 @@
-{"version":3,"file":"voice-machine.d.ts","sourceRoot":"","sources":["../src/voice-machine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,YAAY,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;AAEjG,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAC1B;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAC1B;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,GACzB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,UAAU,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,qBAAqB,EAAE,YAAgC,CAAC;AAErE,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,GAAG,YAAY,CA4BnF;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mDAAmD;IACnD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IAClC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACrC,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACpE,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1C,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,4EAA4E;IAC5E,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;CACtD;AAmID,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,sBAAsB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAmCf"}
+{"version":3,"file":"voice-machine.d.ts","sourceRoot":"","sources":["../src/voice-machine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,YAAY,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;AAEjG,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE;AACvB,6EAA6E;GAC3E;IAAE,IAAI,EAAE,oBAAoB,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAC1B;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAC1B;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,GACzB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC,mDAAmD;AACnD,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,KAAK,EAAE,UAAU,CAAC;IAClB,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,qBAAqB,EAAE,YAAgC,CAAC;AAErE,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,GAAG,YAAY,CAiCnF;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mDAAmD;IACnD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IAClC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACrC,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACpE,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1C,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,4EAA4E;IAC5E,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;CACtD;AAmID,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,sBAAsB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAmCf"}

package/dist/voice-machine.js

@@ -17,6 +17,11 @@ export function voiceReducer(machine, event) {
             return machine.state === "idle" ? { state: "connecting" } : machine;
         case "connected":
             return machine.state === "connecting" ? { state: "listening" } : machine;
+        case "response_requested":
+            // The assistant is generating an unprompted turn (the opening greeting).
+            // Move to `thinking` so the subsequent `audio_delta` lands on `speaking`,
+            // matching a normal turn; no-op if we're not idling in `listening`.
+            return machine.state === "listening" ? { state: "thinking" } : machine;
         case "speech_started":
             if (machine.state === "idle" || machine.state === "error")
                 return machine;

package/dist/voice-session.d.ts

@@ -1,5 +1,5 @@
 import type { ChatConfig, ChatConfigProvider } from "./types/config.js";
-import type { GraphQLSchemaHandler, RESTSchemaHandler, ToolCallHandler } from "./types/tools.js";
+import type { ToolCallHandler } from "./types/tools.js";
 import { type VoiceMachine } from "./voice-machine.js";
 declare global {
     interface Window {
@@ -11,8 +11,6 @@ export interface YakVoiceSessionConfig {
     appId: string;
     /** Tool call handler. Same shape as `YakClientConfig.onToolCall`. */
     onToolCall?: ToolCallHandler;
-    onGraphQLSchemaCall?: GraphQLSchemaHandler;
-    onRESTSchemaCall?: RESTSchemaHandler;
     onRedirect?: (path: string) => void;
     /**
      * Static chat config (routes + tools). Sent to the mint endpoint so the LLM
@@ -26,8 +24,8 @@ export interface YakVoiceSessionConfig {
      */
     getConfig?: ChatConfigProvider;
     /**
-     * Override the API origin. Defaults to chat.yak.io (prod), chat.yak.supply
-     * (dev stage), or http://localhost:3001 when `__YAK_INTERNAL_DEV__` is set.
+     * Override the API origin (where voice sessions are minted). Defaults to
+     * `https://chat.yak.io`. Most integrators never set this.
      */
     apiOrigin?: string;
 }
@@ -48,18 +46,16 @@ export declare class YakVoiceSession {
     private toolNameById;
     constructor(config: YakVoiceSessionConfig);
     /**
-     * Resolve the API origin lazily on each call. The internal-dev flag
-     * (`window.__YAK_INTERNAL_DEV__`) is often set in a `useEffect` that fires
-     * after this session is constructed, so resolving at construction would
-     * bake in the production URL.
+     * Resolve the API origin lazily on each call. Environment-dependent defaults
+     * (e.g. a local chat UI) may not be ready at construction time, so resolving
+     * eagerly would risk baking in the production URL.
      */
     private get apiOrigin();
     /** Update mutable config fields (handlers, getConfig). */
     updateConfig(patch: Partial<YakVoiceSessionConfig>): void;
     getState(): VoiceMachine;
     /**
-     * The current API origin (`chat.yak.io`, `chat.yak.supply`, or
-     * `http://localhost:3001` when `__YAK_INTERNAL_DEV__` is set). Useful for
+     * The current API origin (defaults to `https://chat.yak.io`). Useful for
      * building URLs to static assets like the brand logo.
      */
     getApiOrigin(): string;
@@ -85,9 +81,11 @@ export declare class YakVoiceSession {
     private execMcpTool;
     private mintToken;
     /**
-     * Decorate the host's tool manifest + schema sources with hashed ids and
-     * populate `this.toolNameById` for reverse lookup. Mirrors the decoration
-     * the chat-ui iframe applies before sending tools to `/api/chat`.
+     * 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.
      */
     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,EAEV,oBAAoB,EAEpB,iBAAiB,EACjB,eAAe,EAEhB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAKL,KAAK,YAAY,EAElB,MAAM,oBAAoB,CAAC;AAK5B,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,oBAAoB,CAAC,EAAE,OAAO,CAAC;KAChC;CACF;AAkBD,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,mBAAmB,CAAC,EAAE,oBAAoB,CAAC;IAC3C,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;IACrC,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;AA2DD,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;;;;;OAKG;IACH,OAAO,KAAK,SAAS,GAEpB;IAED,0DAA0D;IACnD,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG,IAAI;IAIzD,QAAQ,IAAI,YAAY;IAI/B;;;;OAIG;IACI,YAAY,IAAI,MAAM;IAItB,aAAa,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,IAAI;IAO9D;;;OAGG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA+InC,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;IAsC3B;;;;OAIG;YACW,WAAW;YAwBX,SAAS;IAuBvB;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;YA4BhB,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;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"}

package/dist/voice-session.js

@@ -4,18 +4,18 @@ import { generateToolId } 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";
-function getApiOrigin() {
-    if (typeof window !== "undefined") {
-        const hostname = window.location.hostname;
-        if (hostname.endsWith(".yak.supply") || hostname === "yak.supply") {
-            return "https://chat.yak.supply";
-        }
-        if ((hostname === "localhost" || hostname === "127.0.0.1") &&
-            typeof window.__YAK_INTERNAL_DEV__ !== "undefined") {
-            return "http://localhost:3001";
-        }
+const DEFAULT_API_ORIGIN = "https://chat.yak.io";
+/**
+ * Resolves the API origin when no explicit `apiOrigin` is configured. Points at
+ * a local chat UI during yak's own local development; production otherwise.
+ */
+function getDefaultApiOrigin() {
+    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 "https://chat.yak.io";
+    return DEFAULT_API_ORIGIN;
 }
 const EMPTY_RESOURCES = {
     pc: null,
@@ -56,13 +56,12 @@ export class YakVoiceSession {
         this.attachPageHide();
     }
     /**
-     * Resolve the API origin lazily on each call. The internal-dev flag
-     * (`window.__YAK_INTERNAL_DEV__`) is often set in a `useEffect` that fires
-     * after this session is constructed, so resolving at construction would
-     * bake in the production URL.
+     * Resolve the API origin lazily on each call. Environment-dependent defaults
+     * (e.g. a local chat UI) may not be ready at construction time, so resolving
+     * eagerly would risk baking in the production URL.
      */
     get apiOrigin() {
-        return this.config.apiOrigin ?? getApiOrigin();
+        return this.config.apiOrigin ?? getDefaultApiOrigin();
     }
     /** Update mutable config fields (handlers, getConfig). */
     updateConfig(patch) {
@@ -72,8 +71,7 @@ export class YakVoiceSession {
         return this.machine;
     }
     /**
-     * The current API origin (`chat.yak.io`, `chat.yak.supply`, or
-     * `http://localhost:3001` when `__YAK_INTERNAL_DEV__` is set). Useful for
+     * The current API origin (defaults to `https://chat.yak.io`). Useful for
      * building URLs to static assets like the brand logo.
      */
     getApiOrigin() {
@@ -102,7 +100,6 @@ export class YakVoiceSession {
                 logger.debug("Voice: getConfig() resolved", {
                     toolCount: chatConfig?.tools?.tools.length ?? 0,
                     routeCount: chatConfig?.routes?.routes.length ?? 0,
-                    hasSchemas: !!chatConfig?.schemaSources?.length,
                 });
             }
             catch (err) {
@@ -113,7 +110,6 @@ export class YakVoiceSession {
             logger.debug("Voice: using static chatConfig", {
                 toolCount: chatConfig.tools?.tools.length ?? 0,
                 routeCount: chatConfig.routes?.routes.length ?? 0,
-                hasSchemas: !!chatConfig.schemaSources?.length,
             });
         }
         else {
@@ -197,6 +193,17 @@ export class YakVoiceSession {
         dataChannel.onopen = () => {
             logger.debug("Voice: data channel opened");
             this.dispatch({ type: "connected" });
+            // Kick off an opening greeting so the assistant speaks first instead of
+            // waiting silently for the user. The minted session already carries the
+            // full instructions (persona, governance, language, "first turn" rule),
+            // so a bare `response.create` is enough — do NOT attach response-level
+            // instructions here, which would replace the session instructions.
+            // Skip it when the app's voice intro is "none" (`autoGreet === false`);
+            // a missing flag defaults to greeting for back-compat.
+            if (mint.autoGreet !== false) {
+                this.dispatch({ type: "response_requested" });
+                this.sendOverDataChannel({ type: "response.create" });
+            }
         };
         dataChannel.onclose = () => {
             logger.debug("Voice: data channel closed");
@@ -313,14 +320,6 @@ export class YakVoiceSession {
             }
             return { success: true, redirected: true, path };
         }
-        if (name.startsWith("graphql_") && this.config.onGraphQLSchemaCall) {
-            const schemaName = name.slice("graphql_".length);
-            return await this.config.onGraphQLSchemaCall(schemaName, args);
-        }
-        if (name.startsWith("rest_") && this.config.onRESTSchemaCall) {
-            const schemaName = name.slice("rest_".length);
-            return await this.config.onRESTSchemaCall(schemaName, args);
-        }
         if (this.config.onToolCall) {
             return await this.config.onToolCall(name, args);
         }
@@ -364,7 +363,6 @@ export class YakVoiceSession {
                 pageContext,
                 toolManifest: decoratedManifest,
                 routeManifest: chatConfig?.routes,
-                schemaSources: chatConfig?.schemaSources,
             }),
         });
         if (!res.ok) {
@@ -374,9 +372,11 @@ export class YakVoiceSession {
         return (await res.json());
     }
     /**
-     * Decorate the host's tool manifest + schema sources with hashed ids and
-     * populate `this.toolNameById` for reverse lookup. Mirrors the decoration
-     * the chat-ui iframe applies before sending tools to `/api/chat`.
+     * 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.
      */
     buildDecoratedManifest(chatConfig) {
         this.toolNameById.clear();
@@ -385,19 +385,7 @@ export class YakVoiceSession {
             this.toolNameById.set(id, t.name);
             return { ...t, id };
         });
-        const decoratedSchemaTools = (chatConfig?.schemaSources ?? []).map((source) => {
-            const name = source.type === "graphql" ? `graphql_${source.name}` : `rest_${source.name}`;
-            const id = generateToolId(name);
-            this.toolNameById.set(id, name);
-            return {
-                id,
-                name,
-                description: source.type === "graphql"
-                    ? `Execute GraphQL operations against ${source.name}`
-                    : `Make REST API calls to ${source.name}`,
-            };
-        });
-        return { tools: [...decoratedHostTools, ...decoratedSchemaTools] };
+        return { tools: decoratedHostTools };
     }
     async exchangeSdp(offer, clientSecret) {
         const sdpResponse = await fetch(`${REALTIME_CALLS_URL}?model=${DEFAULT_REALTIME_MODEL}`, {