@vrealtime/server 0.1.0 → 0.2.0

package/dist/capabilities.d.ts

@@ -7,7 +7,7 @@ export interface CapabilityRule {
     token: string;
     available(model: Capabilities): boolean;
 }
-/** Every capability this server implements. None yet. */
+/** Every capability this server implements. */
 export declare const CAPABILITY_RULES: readonly CapabilityRule[];
 /** The tokens sessions of an agent with this model may negotiate. */
 export declare function supportedCapabilities(model: Capabilities, rules?: readonly CapabilityRule[]): ReadonlySet<string>;

package/dist/capabilities.js

@@ -1,5 +1,10 @@
-/** Every capability this server implements. None yet. */
-export const CAPABILITY_RULES = [];
+import { GLOBAL_TOOL_IDS_V1, TOOL_STREAM_V1 } from '@vrealtime/protocol';
+/** Every capability this server implements. */
+export const CAPABILITY_RULES = [
+    // Any model: without argument streaming a call goes straight from start to arguments-complete.
+    { token: TOOL_STREAM_V1, available: () => true },
+    { token: GLOBAL_TOOL_IDS_V1, available: () => true },
+];
 /** The tokens sessions of an agent with this model may negotiate. */
 export function supportedCapabilities(model, rules = CAPABILITY_RULES) {
     return new Set(rules.filter((rule) => rule.available(model)).map((rule) => rule.token));

package/dist/index.js

@@ -1,6 +1,7 @@
 import { startSession, } from '@vrealtime/core';
-import { Inbox, Outbox, decodeAudioFrame, decodeClientMessage, encodeAudioFrame, encodeMessage, negotiateCapabilities, PROTOCOL_VERSION, } from '@vrealtime/protocol';
+import { Inbox, Outbox, decodeAudioFrame, decodeClientMessage, encodeAudioFrame, encodeMessage, negotiateCapabilities, PROTOCOL_VERSION, TOOL_STREAM_V1, } from '@vrealtime/protocol';
 import { supportedCapabilities } from './capabilities.js';
+import { legacyPreview, toolStreamMessage } from './tool-stream.js';
 const PCM24 = { encoding: 'pcm16', sampleRate: 24000, channels: 1 };
 const REFUSED = Symbol('refused');
 const FLUSH_INTERVAL_MS = 10;
@@ -62,10 +63,15 @@ class LiveSession {
         agentSession.on('transcript', (e) => this.send({ type: 'transcript', role: e.role, itemId: e.itemId, text: e.text, final: e.final }));
         agentSession.on('text', (e) => this.send({ type: 'text', responseId: e.responseId, delta: e.delta }));
         agentSession.on('audio', (e) => this.#audio(e));
-        // `arguments` and `preview` are required members on the wire: a missing value is sent as null.
+        // `arguments` is a required member on the wire: a missing value is sent as null.
         agentSession.on('tool.call', (e) => this.send({ type: 'tool.call', callId: e.callId, epoch: e.epoch, turnId: e.turnId, name: e.name, arguments: e.arguments ?? null }));
-        agentSession.on('tool.call.delta', (e) => this.send({ type: 'tool.call.delta', callId: e.callId, epoch: e.epoch, name: e.name, preview: { argumentsDelta: e.argumentsDelta } }));
-        agentSession.on('tool.preview', (e) => this.send({ type: 'tool.call.delta', callId: e.callId, epoch: e.epoch, name: e.name, preview: e.preview ?? null }));
+        // One source for call progress: the full lifecycle with tool-stream-v1, the 1.0 preview without it, never both.
+        const toolStream = this.capabilities.includes(TOOL_STREAM_V1);
+        agentSession.on('tool.stream', (e) => {
+            const message = toolStream ? toolStreamMessage(e) : legacyPreview(e);
+            if (message)
+                this.send(message);
+        });
         agentSession.on('interrupted', (e) => {
             this.#dropAudio(e.epoch);
             this.send({ type: 'interrupted', epoch: e.epoch });

package/dist/tool-stream.d.ts

@@ -0,0 +1,8 @@
+import type { ToolStreamEvent } from '@vrealtime/core';
+import type { ServerMessage, Unsequenced } from '@vrealtime/protocol';
+type Outgoing = Unsequenced<ServerMessage>;
+/** With `tool-stream-v1`: the step as a `tool.stream` message. A server tool's output never leaves the server. */
+export declare function toolStreamMessage(event: ToolStreamEvent): Outgoing;
+/** Without the capability: argument fragments and progress as the `tool.call.delta` preview of protocol 1.0; nothing else is sent. */
+export declare function legacyPreview(event: ToolStreamEvent): Outgoing | undefined;
+export {};

package/dist/tool-stream.js

@@ -0,0 +1,29 @@
+/** With `tool-stream-v1`: the step as a `tool.stream` message. A server tool's output never leaves the server. */
+export function toolStreamMessage(event) {
+    const call = { type: 'tool.stream', callId: event.callId, epoch: event.epoch, turnId: event.turnId, name: event.name };
+    switch (event.phase) {
+        case 'start':
+        case 'cancelled':
+            return { ...call, phase: event.phase };
+        case 'arguments-delta':
+            return { ...call, phase: event.phase, delta: event.delta };
+        // Required members on the wire: a missing value is sent as null.
+        case 'arguments-complete':
+            return { ...call, phase: event.phase, arguments: event.arguments ?? null };
+        case 'progress':
+            return { ...call, phase: event.phase, progress: event.progress ?? null };
+        case 'settled':
+            return event.result.ok ? { ...call, phase: 'settled', ok: true } : { ...call, phase: 'settled', ok: false, code: event.result.code };
+        case 'failed':
+            return { ...call, phase: event.phase, message: event.message };
+    }
+}
+/** Without the capability: argument fragments and progress as the `tool.call.delta` preview of protocol 1.0; nothing else is sent. */
+export function legacyPreview(event) {
+    const call = { type: 'tool.call.delta', callId: event.callId, epoch: event.epoch, name: event.name };
+    if (event.phase === 'arguments-delta')
+        return { ...call, preview: { argumentsDelta: event.delta } };
+    if (event.phase === 'progress')
+        return { ...call, preview: event.progress ?? null };
+    return undefined;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vrealtime/server",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "vRealTime server: attach any WebSocket, Node serve(), Cloudflare Workers and Durable Objects",
   "license": "Apache-2.0",
   "repository": {
@@ -50,8 +50,8 @@
     "build": "tsc -p tsconfig.build.json"
   },
   "dependencies": {
-    "@vrealtime/core": "0.1.0",
-    "@vrealtime/protocol": "0.1.0"
+    "@vrealtime/core": "0.2.0",
+    "@vrealtime/protocol": "0.2.0"
   },
   "peerDependencies": {
     "ws": "^8.0.0"