OpenAI GPT-Live Voice Agent

[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_260":261,"_262":263},"routes/_app.x.$handle.$name",{"_105":104,"_38":50,"_113":92,"_33":114,"_13":14,"_115":-5,"_11":116,"_117":118,"_119":120,"_121":122,"_123":124,"_26":-5,"_125":126,"_127":128,"_129":31,"_130":131,"_132":64,"_133":-5,"_134":-5,"_135":136},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":18,"_19":-5},"project",{"_48":49,"_38":50,"_43":51,"_52":-5,"_53":31,"_54":55,"_56":55,"_57":58,"_59":-5,"_19":60,"_61":62,"_63":64,"_65":-5,"_66":-5,"_67":68,"_69":70,"_71":-5,"_72":-5,"_73":-5,"_74":-5,"_75":76,"_77":76,"_78":79,"_80":79,"_81":79,"_82":76,"_83":76,"_84":85,"_86":87,"_88":89,"_90":31},"version",13,"changes",[25],"aiChatInfo",{"_20":21,"_22":-5,"_23":-5,"_24":-5},"userId","aiChatMessageId","0dbb0f99-071e-426d-9966-2c2bf511599b","aiChatThreadId","aiChatThreadUserId","aiChatThreadTitle",{"_26":27,"_28":29,"_30":31,"_32":31,"_33":34,"_35":34},"file",{"_36":37,"_38":34,"_39":26,"_40":42,"_43":44,"_45":14,"_46":47,"_30":31},"previous",{"_36":37,"_38":34,"_39":26,"_40":41},"deleted",false,"deletedHere","path","README.md","latestPath","fileId","01a08d52-52ea-7194-86c2-02433b79a9a3","name","fileType","content","# hello-realtime\n\n**Hello Realtime** is a OpenAI Realtime app that supports both WebRTC and SIP\n(telephone) users. You can access the app via WebRTC at\n[hello-realtime.val.run](https://hello-realtime.val.run), or via SIP by calling\n425-800-0042.\n\nThis demo shows off the new SIP API, the new all-in-one WebRTC API, and the new\nserver-side websocket interface.\n\nIf you remix the app, you'll just need to pop in your own `OPENAI_API_KEY` (from\n[platform.openai.com](https://platform.openai.com)), and if you want SIP, the\n`OPENAI_SIGNING_SECRET`.\n\n## Architecture\n\n1. **WebRTC Flow**:\n - Browser connects to frontend\n - creates WebRTC offer\n - `/rtc` endpoint handles SDP negotiation with OpenAI\n - observer established to monitor session\n2. **SIP Flow**:\n - Phone calls triggers webhook\n - `/sip` endpoint verifies webhook and accepts call\n - observer established to monitor session\n\n## API Endpoints\n\n- `GET /` - serves the WebRTC-based app\n- `POST /rtc` - creates a new WebRTC-based Realtime API session\n - Supports optional `model` URL parameter to override the default model\n - Example: `POST /rtc?model=gpt-4o-realtime-preview`\n- `POST /sip` - handles an incoming Realtime API SIP call\n- `POST /observer` - internal endpoint to establish a Realtime API websocket for\n session control\n\n## Project Structure\n\n```\n├── frontend/ \n│ └── index.html # HTML/JS application for WebRTC\n├── main.tsx # Main entrypoint for the val.town app\n└── routes/\n |\n ├── agent.ts # Realtime API session configuration and tools\n ├── observer.ts # Server-side session control for SIP & WebRTC\n ├── rtc.ts # WebRTC session setup\n ├── sip.ts # SIP webhook handling and session setup\n └── utils.ts # Various HTTP helpers\n```\n\n## File Links\n\n- [`frontend/index.html`](./frontend/index.html)\n- [`main.tsx`](./main.tsx)\n- [`routes/agent.ts`](./routes/agent.ts)\n- [`routes/observer.ts`](./routes/observer.ts)\n- [`routes/rtc.ts`](./routes/rtc.ts)\n- [`routes/sip.ts`](./routes/sip.ts)\n- [`routes/utils.ts`](./routes/utils.ts)","# hello-live\n\n**Hello Live** is an OpenAI GPT-Live app that supports both WebRTC and SIP\n(telephone) users. You can access the app via WebRTC at\n[hello-live.val.run](https://hello-live.val.run), or via SIP by calling\n425-800-0073.\n\nThis demo shows off the GPT-Live WebRTC session API, the SIP webhook flow, and\nthe server-side sideband websocket used to observe and control a session. It\nuses **Responses delegation**: `gpt-live-1` handles the spoken conversation\nwhile a backend Responses model (`gpt-5.6-luna`) handles reasoning and tool\ncalls (e.g. `end_call`).\n\nIf you remix the app, you'll just need to pop in your own `OPENAI_API_KEY` (from\n[platform.openai.com](https://platform.openai.com)), and if you want SIP, the\n`OPENAI_SIGNING_SECRET`. For SIP you also need to subscribe your project's\nwebhook to the `live.transport.incoming` event.\n\n## Architecture\n\n1. **WebRTC Flow**:\n - Browser connects to frontend and creates a WebRTC offer\n - `/rtc` endpoint posts the offer + session config to\n `POST /v1/live/sessions` and returns the SDP answer + session ID\n - sideband observer attached to monitor the session\n2. **SIP Flow**:\n - Phone call triggers the `live.transport.incoming` webhook\n - `/sip` endpoint verifies the webhook and accepts the call with the session\n config\n - sideband observer attached to monitor the session\n3. **Delegation**:\n - GPT-Live delegates tool use to the Responses backend\n - Function calls arrive on the sideband wrapped in `response.event`\n - The observer returns results with `response.item.create` and continues the\n backend with `response.create`\n\n```mermaid\nsequenceDiagram\n participant B as Browser / Phone\n participant V as hello-live (val)\n participant L as GPT-Live\n participant R as Responses backend\n\n B->>V: SDP offer (WebRTC) / webhook (SIP)\n V->>L: POST /v1/live/sessions (or /accept)\n L-->>V: session.id + SDP answer\n V-->>B: SDP answer\n V->>L: attach sideband WS\n L-->>B: audio (greeting)\n B-->>L: \"goodbye\"\n L->>R: delegate\n R-->>L: end_call function call\n L-->>V: response.event (function_call)\n V->>L: response.item.create + response.create\n V->>L: POST /hangup\n L-->>V: session.closed\n```\n\n## API Endpoints\n\n- `GET /` - serves the WebRTC-based app\n- `POST /rtc` - creates a new GPT-Live WebRTC session; body is the SDP offer,\n response is `{ session: { id }, transport: { type: \"webrtc\", sdp } }`\n- `POST /sip` - handles the `live.transport.incoming` webhook for an incoming\n SIP call\n- `POST /observer/:sessionId` - internal endpoint to attach a GPT-Live sideband\n websocket for session control\n\n## Project Structure\n\n```\n├── frontend/\n│ └── index.html # HTML/JS application for WebRTC\n├── main.tsx # Main entrypoint for the val.town app\n└── routes/\n ├── agent.ts # GPT-Live session configuration, delegation, and tools\n ├── observer.ts # Server-side sideband control for SIP & WebRTC\n ├── rtc.ts # WebRTC session setup\n ├── sip.ts # SIP webhook handling and session setup\n └── utils.ts # Various HTTP helpers\n```\n\n## File Links\n\n- [`frontend/index.html`](./frontend/index.html)\n- [`main.tsx`](./main.tsx)\n- [`routes/agent.ts`](./routes/agent.ts)\n- [`routes/observer.ts`](./routes/observer.ts)\n- [`routes/rtc.ts`](./routes/rtc.ts)\n- [`routes/sip.ts`](./routes/sip.ts)\n- [`routes/utils.ts`](./routes/utils.ts)\n\n## TODO\n\n- Drive `audioActive` / `callEnding` from reflected `session.output_audio.delta`\n events so hangup waits for the goodbye to finish playing\n- Send `session.close` from the browser on Stop and wait for `session.closed`\n- Render transcript deltas as captions\n","createdAt",["D",1789095811926],"branchVersion","branchId","5d994488-44c2-4ba1-8f86-50810fea3ff5","id","5a239725-73df-432f-af30-67e6eff074b8","hello-live",["D",1789077377613],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","Sample app for the OpenAI Realtime API","imageUrl","dbe13bc0-4230-11f0-95cd-ab37681351fa","pinnedFileId","01a08d52-52ea-7194-86c2-05042be094d8","pinPreview",true,"pinMigrated","screenshotVersion","likeCount",1,"orgId","9c125825-8df1-4029-a26d-29049e9bd5a3","tursoName","tursoHostname","tursoMeasuredAt","pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_105":104,"_112":108},"org",{"_105":104,"_106":-5,"_107":108,"_19":60,"_109":110,"_111":31},"branch",{"_13":91,"_38":92,"_48":47,"_93":49,"_94":95,"_96":97,"_98":55,"_99":100,"_101":70,"_102":50,"_103":104},"isOwned",31,"main","projectId","forkedBranchId","be33420e-792a-11f0-bfa3-0224a6c84d84","forkedBranchVersion",379,"forkedProjectPrivacy","forkedProjectId","be2e762a-792a-11f0-bfa3-0224a6c84d84","forkedProjectOrgId","projectName","userHandle","jubertioai","handle","displayName","avatar","https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/61901958-12bd-49a3-43e9-2f67f1617200/square512?exp=1789662656&sig=c72cedbc2d188aef4f41429aa806e9f17567325129a7c4eb2971856e8e2f7039","tier","pro","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_48":49,"_38":50,"_43":256,"_52":-5,"_53":31,"_54":55,"_56":55,"_57":58,"_59":-5,"_19":60,"_61":62,"_63":64,"_65":-5,"_66":-5,"_67":68,"_69":70,"_71":-5,"_72":-5,"_73":-5,"_74":-5,"_75":76,"_77":76,"_78":79,"_80":79,"_81":79,"_82":76,"_83":76,"_84":257,"_86":258,"_88":259,"_90":31},"tree",[185,187,193,194],"files",[185,186,187,188,189,190,191,192,193,194],"counts",{"_174":155,"_175":68,"_176":177,"_178":179,"_180":181},"contents",[146,147,148,149],"upstreamProject",{"_48":100,"_38":144,"_57":58,"_59":-5,"_54":55,"_84":145},"upstreamBranch",{"_48":95,"_43":137,"_138":139,"_38":92,"_93":100,"_13":97,"_94":140,"_96":141,"_142":143,"_52":-5,"_90":31,"_54":55,"_103":104,"_69":70,"_102":144},"emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},["D",1755188493466],"updatedAt",["D",1778178264384],"e004ac78-4230-11f0-834a-76b3cceeab13",47,"lockfileKey","1778178275619-esm.town_v_jubertioai_hello-realtime@379-main","hello-realtime",{"_105":104,"_112":108},{"_48":169,"_38":170,"_36":171,"_152":-5,"_46":47,"_45":68,"_153":64,"_43":172,"_13":155,"_39":167,"_40":-5,"_30":31,"_158":-5,"_33":173},{"_48":163,"_38":164,"_36":165,"_152":-5,"_46":47,"_45":68,"_153":64,"_43":166,"_13":155,"_39":167,"_40":-5,"_30":31,"_158":-5,"_33":168},{"_48":160,"_38":34,"_36":37,"_152":-5,"_46":47,"_45":14,"_153":31,"_43":161,"_13":68,"_39":26,"_40":42,"_30":31,"_158":-5,"_33":162},{"_48":150,"_38":151,"_36":62,"_152":-5,"_46":47,"_45":68,"_153":31,"_43":154,"_13":155,"_39":156,"_40":157,"_30":31,"_158":50,"_33":159},"f10e6eca-2f61-4464-9f2f-5623caacfbd9","main.tsx","parentId","latest",["D",1789077377613],0,"http","import { Hono } from \"npm:hono\";\nimport { blob } from \"https://esm.town/v/std/blob\";\nimport { parseVal, serveFile } from \"https://esm.town/v/std/utils/index.ts\";\n// import mcp from \"./routes/mcp.ts\";\nimport rtc from \"./routes/rtc.ts\";\nimport sip from \"./routes/sip.ts\";\nimport observer from \"./routes/observer.ts\";\n\nconst SOURCE_URL = parseVal(Deno.env.get(\"VALTOWN_ENTRYPOINT\")).links.self.val;\n\nconst app = new Hono();\napp.route(\"/rtc\", rtc);\napp.route(\"/sip\", sip);\napp.route(\"/observer\", observer);\n// app.route(\"/mcp\", mcp);\napp.get(\"/source\", (c) => c.redirect(SOURCE_URL));\n\napp.get(\"/\", () => serveFile(\"/frontend/index.html\", import.meta.url));\napp.get(\"/favicon.ico\", async (c) => {\n const entry = parseVal(Deno.env.get(\"VALTOWN_ENTRYPOINT\"));\n const file = await blob.get(`${entry.name}/favicon.ico`);\n if (!file) {\n return c.text(\"favicon not found\", 404);\n }\n return new Response(file.body, {\n headers: {\n \"Content-Type\": \"image/x-icon\",\n \"Cache-Control\": \"public, max-age=31536000, immutable\",\n },\n });\n}); \n \nexport default app.fetch;","label",[151],"48e04926-7987-4b8a-bbf6-f4b71cf836a7",["D",1789095811926],[34],"8d58d695-053e-4f33-867c-e98e00d8a0ce","routes","01a08d52-52ea-7194-86c1-fcfc58d46e7b",["D",1789077377613],"directory",[164],"41ed3c9e-89d8-4495-9e9b-43f929ce1d40","frontend","01a08d52-52ea-7194-86c1-e708aa8c7466",["D",1789077377613],[170],"pulls","branches","forks",2,"envVars",{"_182":177,"_184":155},"connections",{"_182":155,"_183":155},"count","unfilledCount","emptyCount",{"_48":169,"_38":170,"_36":171,"_152":-5,"_46":47,"_45":68,"_153":64,"_43":253,"_13":155,"_39":167,"_40":-5,"_30":31,"_158":-5,"_196":254,"_33":255},{"_48":245,"_38":246,"_36":247,"_152":171,"_46":47,"_45":248,"_153":64,"_43":249,"_13":221,"_39":26,"_40":250,"_30":31,"_158":-5,"_196":251,"_33":252},{"_48":163,"_38":164,"_36":165,"_152":-5,"_46":47,"_45":68,"_153":64,"_43":242,"_13":155,"_39":167,"_40":-5,"_30":31,"_158":-5,"_196":243,"_33":244},{"_48":234,"_38":235,"_36":236,"_152":165,"_46":47,"_45":237,"_153":31,"_43":238,"_13":68,"_39":206,"_40":239,"_30":31,"_158":-5,"_196":240,"_33":241},{"_48":226,"_38":227,"_36":228,"_152":165,"_46":47,"_45":229,"_153":31,"_43":230,"_13":177,"_39":206,"_40":231,"_30":31,"_158":-5,"_196":232,"_33":233},{"_48":218,"_38":219,"_36":220,"_152":165,"_46":47,"_45":221,"_153":64,"_43":222,"_13":68,"_39":206,"_40":223,"_30":31,"_158":-5,"_196":224,"_33":225},{"_48":210,"_38":211,"_36":212,"_152":165,"_46":47,"_45":213,"_153":64,"_43":214,"_13":68,"_39":206,"_40":215,"_30":31,"_158":-5,"_196":216,"_33":217},{"_48":202,"_38":203,"_36":204,"_152":165,"_46":47,"_45":177,"_153":64,"_43":205,"_13":68,"_39":206,"_40":207,"_30":31,"_158":-5,"_196":208,"_33":209},{"_48":160,"_38":34,"_36":37,"_152":-5,"_46":47,"_45":14,"_153":31,"_43":199,"_13":68,"_39":26,"_40":42,"_30":31,"_158":-5,"_196":200,"_33":201},{"_48":150,"_38":151,"_36":62,"_152":-5,"_46":47,"_45":68,"_153":31,"_43":195,"_13":155,"_39":156,"_40":157,"_30":31,"_158":50,"_196":197,"_33":198},["D",1789077377613],"children",[],[151],["D",1789095811926],[],[34],"3c1e587b-f850-47fd-b510-ba9f1f670b00","utils.ts","01a08d52-52ea-7194-86c1-fa926adeaebf",["D",1789089295919],"script","const LIVE_BASE_URL = \"https://api.openai.com/v1/live/sessions\";\nconst LIVE_WS_URL = \"wss://api.openai.com/v1/live/sessions\";\nconst OPENAI_API_KEY = Deno.env.get(\"OPENAI_API_KEY\");\nif (!OPENAI_API_KEY) {\n throw new Error(\"🔴 OpenAI API key not configured\");\n}\n\n// Builds the URL for a GPT-Live API endpoint.\nexport function makeUrl(sessionId?: string, action?: string) {\n if (!sessionId) {\n // create session (POST, WebRTC)\n return LIVE_BASE_URL;\n }\n if (action) {\n // accept, reject, hangup, refer (POST)\n return `${LIVE_BASE_URL}/${sessionId}/${action}`;\n }\n // sideband observer (web socket)\n return `${LIVE_WS_URL}/${sessionId}/attach`;\n}\n\n// Builds the headers for a GPT-Live API endpoint.\nexport function makeHeaders(contentType?: string) {\n const obj: Record = {\n Authorization: `Bearer ${OPENAI_API_KEY}`,\n };\n if (contentType) obj[\"Content-Type\"] = contentType;\n return obj;\n}\n\n// Debug helper for printing GPT-Live API errors.\nexport async function getErrorText(resp: Response) {\n const errBody = await resp.text().catch(() => \"\");\n return `${resp.status} ${resp.statusText}: ${errBody}`;\n}\n",[],[164,203],"987a429d-ec66-4046-9f1e-91220d6c2a49","sip.ts","01a08d52-52ea-7194-86c1-f5950ae11dab",6,["D",1789089296094],"import { Hono } from \"npm:hono\";\nimport { Webhook } from \"npm:svix\";\nimport { makeSession } from \"./agent.ts\";\nimport { getErrorText, makeHeaders, makeUrl } from \"./utils.ts\";\n\nconst sip = new Hono();\n\n// Webhook event types that signal an incoming GPT-Live SIP call.\nconst INCOMING_EVENTS = [\"live.transport.incoming\", \"live.call.incoming\"];\n\n// POST /sip : webhook endpoint\nsip.post(\"/\", async (c) => {\n // Verify the webhook.\n const OPENAI_SIGNING_SECRET = Deno.env.get(\"OPENAI_SIGNING_SECRET\");\n if (!OPENAI_SIGNING_SECRET) {\n console.error(\"🔴 webhook secret not configured\");\n return c.text(\"Internal error\", 500);\n }\n const webhook = new Webhook(OPENAI_SIGNING_SECRET);\n const bodyStr = await c.req.text();\n let sessionId: string | undefined;\n try {\n const headers = Object.fromEntries(c.req.raw.headers.entries());\n const payload: any = webhook.verify(bodyStr, headers);\n\n // Only act on GPT-Live incoming-call events. The same call may also emit a\n // legacy realtime.call.incoming event; acknowledge it but do nothing.\n if (!INCOMING_EVENTS.includes(payload.type)) {\n console.log(\"ℹ️ ignoring webhook event:\", payload.type);\n return c.newResponse(null);\n }\n if (payload.data.type && payload.data.type !== \"sip\") {\n console.log(\"ℹ️ ignoring non-SIP transport:\", payload.data.type);\n return c.newResponse(null);\n }\n\n sessionId = payload.data.session_id;\n const toNumber = getToNumber(payload.data.sip_headers);\n const fromNumber = getFromNumber(payload.data.sip_headers);\n console.log(\"✅ verified webhook:\", sessionId, fromNumber, toNumber);\n } catch (error) {\n console.error(`🔴 verify failed: ${error}`);\n return c.text(\"Invalid signature\", 401);\n }\n\n // Accept the call.\n const url = makeUrl(sessionId, \"accept\");\n const headers = makeHeaders(\"application/json\");\n const body = JSON.stringify({ session: makeSession() });\n const opts = { method: \"POST\", headers, body };\n const resp = await fetch(url, opts);\n if (!resp.ok) {\n console.error(`🔴 accept failed: ${await getErrorText(resp)}`);\n return c.text(\"Internal error\", 500);\n }\n console.log(\"✅ call accepted:\", sessionId);\n\n // Kick off observer in the background (fire-and-forget).\n const selfUrl = new URL(c.req.url);\n fetch(`${selfUrl.origin}/observer/${sessionId}`, { method: \"POST\" })\n .catch((e) => console.error(\"observer start failed:\", e));\n\n return c.newResponse(null);\n});\n\nconst getToNumber = (headers) => getNumberFromSipHeader(headers, \"to\");\nconst getFromNumber = (headers) => getNumberFromSipHeader(headers, \"from\");\n\nfunction getNumberFromSipHeader(headers: any, name: string) {\n const header = getSipHeader(headers, name);\n const match = header?.match(/sip:\\+?(\\d+)@/);\n return match ? `+${match[1]}` : undefined;\n}\n\nfunction getSipHeader(headers: any, name: string) {\n return headers?.find((h) => h.name.toLowerCase() === name)?.value;\n}\n\nexport default sip;\n",[],[164,211],"79541d33-5428-4e63-9cf5-e80266ec9e0c","rtc.ts","01a08d52-52ea-7194-86c1-f11dcf89267e",5,["D",1789089296042],"import { Hono } from \"npm:hono\";\nimport { makeSession } from \"./agent.ts\";\nimport { getErrorText, makeHeaders, makeUrl } from \"./utils.ts\";\n\nconst rtc = new Hono();\n\n// POST /rtc : create a new GPT-Live WebRTC session\nrtc.post(\"/\", async (c) => {\n // Create the session: JSON body with the session config and the SDP offer.\n const body = JSON.stringify({\n session: makeSession(),\n transport: { type: \"webrtc\", sdp: await c.req.text() },\n });\n const opts = { method: \"POST\", headers: makeHeaders(\"application/json\"), body };\n const resp = await fetch(makeUrl(), opts);\n if (!resp.ok) {\n console.error(`🔴 start session failed: ${await getErrorText(resp)}`);\n return c.text(\"Internal error\", 500);\n }\n\n // Response: { session: { id }, transport: { type: \"webrtc\", sdp } }\n const result = await resp.json();\n const sessionId = result?.session?.id;\n console.log(\"✅ session created:\", sessionId);\n\n // Kick off observer in the background (fire-and-forget).\n const selfUrl = new URL(c.req.url);\n fetch(`${selfUrl.origin}/observer/${sessionId}`, { method: \"POST\" })\n .catch((e) => console.error(\"observer start failed:\", e));\n\n return c.json(result, 201);\n});\n\nexport default rtc;\n",[],[164,219],"1acf792a-7420-462e-9a6f-495ff18bd171","observer.ts","01a08d52-52ea-7194-86c1-ef7b6e72cd3b",12,["D",1789090261169],"import { Hono } from \"npm:hono\";\nimport WebSocket from \"npm:ws\";\nimport { createHandler } from \"./agent.ts\";\nimport { makeHeaders, makeUrl } from \"./utils.ts\";\n\nexport interface ObserverHandler {\n onInit(): void;\n onTool(name: string, args: any, callId: string): void;\n onOutputAudioStarted(): void;\n onOutputAudioStopped(): void;\n onOutputAudioCleared(): void;\n}\n\n// ObserverClient attaches a sideband websocket to an existing GPT-Live session.\nexport class ObserverClient {\n private ws: WebSocket;\n private closeResolve: () => void;\n private closePromise: Promise;\n private handler: ObserverHandler;\n\n constructor(sessionId: string) {\n const url = makeUrl(sessionId);\n this.ws = new WebSocket(url, { headers: makeHeaders() });\n this.ws.on(\"open\", () => this.handleOpen());\n this.ws.on(\"message\", (data) => this.handleMessage(JSON.parse(data)));\n this.ws.on(\"error\", (err) => this.handleError(err));\n this.ws.on(\"close\", (ev) => this.handleClose(ev));\n this.closePromise = new Promise((resolve) =>\n this.closeResolve = resolve\n );\n this.handler = createHandler(this, sessionId);\n }\n // Starts or continues delegated backend (Responses) work.\n createResponse() {\n this.sendMessage({ type: \"response.create\" });\n }\n // Returns a function call result to the delegated backend.\n sendToolResult(callId: string, output: string) {\n this.sendMessage({\n type: \"response.item.create\",\n item: { type: \"function_call_output\", call_id: callId, output },\n });\n }\n async waitForClose() {\n await this.closePromise;\n }\n private sendMessage(message: any) {\n this.ws.send(JSON.stringify(message));\n }\n private handleOpen() {\n // The session is already running; do not send session.start.\n console.log(\"✅ websocket connected\");\n this.handler.onInit();\n }\n private async handleMessage(message: any) {\n // Ignore verbose messages: top-level deltas, nested Responses deltas,\n // and reflected input audio.\n const isVerbose = message.type?.endsWith(\".delta\") ||\n message.event?.type?.endsWith(\".delta\") ||\n message.type === \"session.input_audio.append\";\n if (!isVerbose) {\n console.log(message);\n }\n switch (message.type) {\n case \"response.event\": {\n // Nested Responses events arrive wrapped in an envelope.\n const inner = message.event;\n if (\n inner?.type === \"response.output_item.done\" &&\n inner.item?.type === \"function_call\"\n ) {\n this.handler.onTool(\n inner.item.name,\n inner.item.arguments,\n inner.item.call_id,\n );\n }\n break;\n }\n case \"session.closed\":\n console.log(\n `session closed: reason=${message.reason} usage=${\n JSON.stringify(message.usage)\n }`,\n );\n break;\n case \"error\":\n console.error(`🔴 session error: ${JSON.stringify(message.error)}`);\n break;\n }\n }\n private handleError(err: Error) {\n console.error(`🔴 websocket failed: ${err.message}`);\n this.closeResolve();\n }\n private handleClose(e: Event) {\n console.log(`websocket closed: ${e}`);\n this.closeResolve();\n }\n}\n\nconst observer = new Hono();\n\n// POST /observer/:sessionId : self-connect to establish a sideband web socket\nobserver.post(\"/:sessionId\", async (c) => {\n const sessionId = c.req.param(\"sessionId\");\n const client = new ObserverClient(sessionId);\n await client.waitForClose();\n return c.newResponse(null);\n});\n\nexport default observer;\n",[],[164,227],"6804523f-68d3-4129-ab04-6706c1c27013","agent.ts","01a08d52-52ea-7194-86c1-ea635a7ced70",3,["D",1789089295958],"import { ObserverClient, ObserverHandler } from \"./observer.ts\";\nimport { getErrorText, makeHeaders, makeUrl } from \"./utils.ts\";\n\nconst MODEL = \"gpt-live-1\";\nconst BACKEND_MODEL = \"gpt-5.6-luna\";\nconst VOICE = \"marin\";\n\n// Instructions for the GPT-Live voice model: conversation style + when to delegate.\nconst INSTRUCTIONS = `\n As soon as the session starts, without waiting for the user to speak, greet the user in English\n and tell them that they're using GPT-Live, powered by the ${MODEL} model.\n Give them a very brief summary of the benefits of GPT-Live based on the details below,\n and then ask if they have any questions.\n When the user says goodbye or you think the call is over, say a brief goodbye and then\n ask the backend to end the call.\n ---\n GPT-Live is full duplex: it can listen while it speaks, so conversations feel natural.\n It handles the spoken conversation while a separate backend model handles reasoning and tools,\n so the conversation keeps flowing while that work runs in the background.\n`;\n\n// Instructions for the delegated Responses backend: business rules + tool use.\nconst BACKEND_INSTRUCTIONS = `\n You support a live voice conversation. Keep results short and factual.\n When asked to end the call, call the end_call function.\n`;\n\nconst HANGUP_TOOL = {\n type: \"function\",\n name: \"end_call\",\n description: `\n Use this function to hang up the call when the user says goodbye\n or otherwise indicates they are about to end the call.`,\n parameters: { type: \"object\", properties: {}, additionalProperties: false },\n};\n\n// Builds the declarative session configuration for a GPT-Live session.\nexport function makeSession() {\n return {\n model: MODEL,\n instructions: INSTRUCTIONS,\n audio: { output: { voice: VOICE } },\n delegation: {\n type: \"responses\",\n responses: {\n model: BACKEND_MODEL,\n instructions: BACKEND_INSTRUCTIONS,\n tools: [HANGUP_TOOL],\n tool_choice: \"auto\",\n parallel_tool_calls: false,\n },\n },\n };\n}\n\n// AgentHandler implements the agent runtime behavior (tool calling, etc).\nclass AgentHandler implements ObserverHandler {\n private audioActive = false;\n private callEnding = false;\n constructor(private client: ObserverClient, private sessionId: string) {}\n onInit() {\n // Nothing to do: the greeting is baked into the session instructions.\n }\n async onTool(name: string, _args: any, callId: string) {\n if (name == HANGUP_TOOL.name) {\n // Return the tool result and let the backend response finish.\n this.client.sendToolResult(callId, JSON.stringify({ status: \"ok\" }));\n this.client.createResponse();\n // If audio is playing, defer the hangup until it finishes.\n // Otherwise, end the call now.\n if (this.audioActive) {\n this.callEnding = true;\n } else {\n await this.hangup();\n }\n }\n }\n async onOutputAudioStarted() {\n this.audioActive = true;\n }\n async onOutputAudioStopped() {\n // Shut down the call and websocket once audio has finished spooling.\n this.audioActive = false;\n if (this.callEnding) {\n await this.hangup();\n }\n }\n async onOutputAudioCleared() {\n this.audioActive = false;\n }\n private async hangup() {\n const url = makeUrl(this.sessionId, \"hangup\");\n const resp = await fetch(url, { method: \"POST\", headers: makeHeaders() });\n if (!resp.ok) {\n console.error(`🔴 end call failed: ${await getErrorText(resp)}`);\n return;\n }\n\n console.log(\"✅ call ended\");\n }\n}\n\n// Creates the runtime handler for the session.\nexport function createHandler(client: ObserverClient, sessionId: string) {\n return new AgentHandler(client, sessionId);\n}\n",[],[164,235],["D",1789077377613],[188,189,190,191,192],[164],"e176d513-0c31-4ddb-9253-907244e88783","index.html","01a08d52-52ea-7194-86c1-e2418c390e45",11,["D",1789089316618],"\n\n \n \n \n OpenAI GPT-Live Voice Agent\n \n \n \n \n\n

\n\n

\n\n \n \n",[],[170,246],["D",1789077377613],[186],[170],["D",1789077377613],{"_105":104,"_112":108},{"_105":104,"_106":-5,"_107":108,"_19":60,"_109":110,"_111":31},{"_13":91,"_38":92,"_48":47,"_93":49,"_94":95,"_96":97,"_98":55,"_99":100,"_101":70,"_102":50,"_103":104},"ctx",{"_84":-5,"_134":293,"_294":295,"_296":297,"_298":31,"_299":31,"_300":31,"_301":64,"_302":-5,"_303":-7,"_304":-7,"_305":155,"_306":31,"_307":31,"_308":-5,"_309":31,"_310":31,"_311":31,"_312":-5},"ENV",{"_264":265,"_266":267,"_268":92,"_269":270,"_271":272,"_273":274,"_275":276,"_277":278,"_279":280,"_281":282,"_283":284,"_285":286,"_287":288,"_289":290,"_291":292},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","899124c68db8496248a17ee95f074b807335ea7b","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

GPT-Live Agent

Diff · v13