@agent-cards/sdk 0.23.28 → 0.24.1

package/dist/voice-stream.generated.js

@@ -1,170 +0,0 @@
-// GENERATED by scripts/generate-voice-stream.mjs from packages/voice/src/core/stream.ts. Do not edit; edit the source and rebuild.
-/**
- * The streaming door, from either side: the person's
- * answer goes to the verifier as it is spoken, over one WebSocket, and the
- * verifier says `hearing` the moment the key word is out and `verdict` when it
- * has closed the span. One call serves a live microphone and a finished
- * recording alike: a buffer pushed in one go and ended is a short stream.
- *
- * Uses the platform's WebSocket (Node 22, React Native, the browser). The
- * credential rides in the first frame, never in a header, so every platform
- * behaves the same.
- */
-import { AgentcardError } from './voice-types.js';
-export const CHANNEL_KINDS = ['builtin', 'wired', 'bluetooth', 'unknown'];
-/** The receipt as the verifier sends it, every field a string, or null for anything else: a receipt with a piece missing cannot be checked, so it is not carried. */
-function receiptOf(r) {
-    if (!r || typeof r !== 'object')
-        return null;
-    const { payload, signature, alg, kid } = r;
-    return typeof payload === 'string' && typeof signature === 'string' && typeof alg === 'string' && typeof kid === 'string' ? { payload, signature, alg, kid } : null;
-}
-function toArrayBuffer(chunk) {
-    if (chunk instanceof ArrayBuffer)
-        return chunk;
-    return chunk.buffer.slice(chunk.byteOffset, chunk.byteOffset + chunk.byteLength);
-}
-/** Opens the door and hands back the handle. The first frame names the challenge; bytes follow. */
-export function openStream(input) {
-    const WS = input.WebSocket ?? globalThis.WebSocket;
-    if (!WS)
-        throw new AgentcardError('no_websocket', 'This runtime has no WebSocket; the streaming door needs one.');
-    const ws = new WS(input.stream_url);
-    ws.binaryType = 'arraybuffer';
-    const listeners = { hearing: [], verdict: [], error: [] };
-    // Audio chunks and, ahead of the first sealed chunk, the `sealed` text frame: sent in the order they were queued.
-    const queue = [];
-    let open = false, ended = false, settled = false, sealed = false;
-    let channelKind = input.channel && CHANNEL_KINDS.includes(input.channel) ? input.channel : undefined;
-    // A channel named after the open goes as its own text frame; one named before rides the first frame.
-    let channelPending = null;
-    let resolveVerdict, rejectVerdict;
-    const verdictPromise = new Promise((resolve, reject) => { resolveVerdict = resolve; rejectVerdict = reject; });
-    verdictPromise.catch(() => { });
-    const fail = (err) => {
-        if (settled)
-            return;
-        settled = true;
-        for (const fn of listeners.error)
-            fn(err);
-        rejectVerdict(err);
-    };
-    const flush = () => { while (open && queue.length)
-        ws.send(queue.shift()); };
-    ws.onopen = () => {
-        // No token on the frame when the caller has none: a fronting door may carry the credential on the upgrade instead.
-        ws.send(JSON.stringify({ authorization_id: input.authorization_id, challenge_id: input.challenge_id, lang: input.lang, format: input.format, ...(input.token ? { token: input.token } : {}), ...(channelKind ? { channel: channelKind } : {}) }));
-        open = true;
-        if (channelPending) {
-            ws.send(JSON.stringify({ type: 'channel', kind: channelPending }));
-            channelPending = null;
-        }
-        flush();
-        if (ended)
-            ws.send(JSON.stringify({ type: 'end' }));
-    };
-    ws.onmessage = (ev) => {
-        if (typeof ev.data !== 'string')
-            return;
-        let msg;
-        try {
-            msg = JSON.parse(ev.data);
-        }
-        catch {
-            return;
-        }
-        if (msg.type === 'hearing') {
-            const h = { heard_count: Math.max(0, Math.floor(Number(msg.heard_count)) || 0) };
-            for (const fn of listeners.hearing)
-                fn(h);
-        }
-        else if (msg.type === 'verdict') {
-            if (settled)
-                return;
-            settled = true;
-            const receipt = receiptOf(msg.receipt);
-            const v = {
-                accepted: msg.accepted === true, spent: true,
-                approved_with: typeof msg.approved_with === 'string' ? msg.approved_with : null,
-                reason: String(msg.reason ?? ''), bits: msg.bits ?? { words: 0, voice: 0, total: 0 },
-                cos: typeof msg.cos === 'number' ? msg.cos : null, z: typeof msg.z === 'number' ? msg.z : null,
-                speech_s: Number(msg.speech_s ?? 0), ms: Number(msg.ms ?? 0), since_end_ms: Number(msg.since_end_ms ?? 0), closed_by: String(msg.closed_by ?? ''),
-                ...(receipt ? { receipt } : {}),
-            };
-            for (const fn of listeners.verdict)
-                fn(v);
-            resolveVerdict(v);
-        }
-        else if (msg.type === 'error') {
-            fail(new AgentcardError(String(msg.code ?? 'verifier_error'), String(msg.message ?? 'The verifier refused the stream.')));
-        }
-    };
-    ws.onerror = () => fail(new AgentcardError('unreachable', 'The verifier could not be reached.'));
-    ws.onclose = () => fail(new AgentcardError('stream_closed', 'The verifier closed the stream without a verdict.'));
-    const handle = {
-        format: input.format,
-        push(chunk) { if (ended || settled)
-            return; queue.push(toArrayBuffer(chunk)); flush(); },
-        end() { if (ended)
-            return; ended = true; if (open) {
-            flush();
-            ws.send(JSON.stringify({ type: 'end' }));
-        } },
-        channel(kind) {
-            if (settled || ended || !CHANNEL_KINDS.includes(kind))
-                return;
-            if (!open) {
-                channelKind = kind;
-                channelPending = null;
-                return;
-            }
-            channelKind = kind;
-            ws.send(JSON.stringify({ type: 'channel', kind }));
-        },
-        seal(head) {
-            if (settled || ended || sealed || typeof head.eph !== 'string' || !head.eph)
-                return;
-            sealed = true;
-            const kid = typeof head.kid === 'string' && head.kid ? head.kid : null;
-            queue.push(JSON.stringify({ type: 'sealed', alg: head.alg, eph: head.eph, ...(kid ? { kid } : {}) }));
-            flush();
-        },
-        on(event, fn) { listeners[event].push(fn); return handle; },
-        verdict: () => verdictPromise,
-        close() { if (!settled) {
-            settled = true;
-            rejectVerdict(new AgentcardError('stream_closed', 'The stream was closed before a verdict.'));
-        } try {
-            ws.close();
-        }
-        catch { /* already closed */ } },
-    };
-    return handle;
-}
-const PCM16_16K_BYTES_PER_MS = 32;
-/**
- * A finished recording through the same door. For `pcm16-16k` with `chunkMs`
- * the bytes go in timed chunks, as a microphone would send them; otherwise
- * the whole buffer goes at once. Ends the stream and resolves the verdict.
- */
-export async function streamBuffer(handle, bytes, chunkMs) {
-    const u8 = bytes instanceof Uint8Array ? bytes : new Uint8Array(bytes);
-    if (chunkMs && chunkMs > 0 && handle.format === 'pcm16-16k') {
-        const step = PCM16_16K_BYTES_PER_MS * chunkMs;
-        for (let i = 0; i < u8.length; i += step) {
-            handle.push(u8.subarray(i, Math.min(u8.length, i + step)));
-            if (i + step < u8.length)
-                await new Promise((r) => setTimeout(r, chunkMs));
-        }
-    }
-    else {
-        handle.push(u8);
-    }
-    handle.end();
-    return handle.verdict();
-}
-/** The verifier's streaming address from its origin (`/v1/stream` appended) or a full address, as given. */
-export function streamAddress(verifierUrl) {
-    const trimmed = verifierUrl.replace(/\/+$/, '');
-    return /\/v1\/stream$/.test(trimmed) ? trimmed : trimmed + '/v1/stream';
-}