dsh-realtime-agent 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Travis Driessen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,97 @@
-# Temporary Holding Version
+# dsh-realtime-agent
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**The consumer for the [`dsh-realtime`](../realtime) seam: it answers what the voice model delegates.**
+
+A voice model that can hand work to the host is only useful if something picks it up. This plugin
+holds a live session, records the conversation, and when the model raises a delegation it asks the
+application — and then **either delivers the answer or says plainly that it cannot.**
+
+## Why the delegation is the whole point
+
+Everything else about realtime voice is transport. A fast handshake and clean audio are table stakes;
+the thing that makes a voice model an *agent* is that it can ask for something in the middle of a
+conversation and keep talking while it waits.
+
+The protocol makes that deliberately hard to fudge. `session.delegation.created` carries
+**metadata only** — `{id, target, offsetMs}` — and **no task text**:
+
+```ts
+interface RealtimeDelegation {
+  id: string
+  target: 'client' | 'responses'
+  offsetMs: number
+}
+```
+
+So intent has to be reconstructed. This plugin carries the conversation it has transcribed alongside
+the delegation, because the consumer knows the conversation and only the application knows its own
+state. Neither can do it alone, which is why the request carries one and is handed to the other.
+
+## Answering
+
+Listen on the bus. Listeners run in order, and the **first to return a non-empty answer wins** — that
+is Cordis `serial` dispatch, so several responders can be registered and each can decline by
+returning nothing:
+
+```ts
+ctx.on('realtime-agent/delegation', async (request) => {
+  // request: { id, offsetMs, transcript, sessionId }
+  const answer = await lookSomethingUp(request.transcript)
+  return answer === undefined ? undefined : { text: answer, mode: 'spoken' }
+})
+```
+
+`mode: 'spoken'` sends the text as commentary, which the model **says aloud** — use it when the person
+in the conversation is waiting. `silent` (the default) sends it as thinking, which the model may use
+without announcing it.
+
+## Failing closed, out loud
+
+Returning nothing is a decline, and it is never silent. If every responder declines, none is
+registered, the responder throws, or the answer does not arrive within `delegationTimeoutMs`, the
+model is told:
+
+> *"Sorry — I can't take care of that right now."*
+
+That is the seam's first invariant made audible: an unresolvable or erroring delegation **never
+auto-approves**. The two failure modes it rules out are a fabricated answer and a silence the person
+on the other end reads as comprehension.
+
+## Configuration
+
+```yaml
+- name: dsh-realtime-agent
+  config:
+    provider: openai-live     # the registered realtime route
+    model: gpt-live-1
+    voice: marin              # optional; omitted keeps the provider default
+    instructions: '…'         # optional; opening instructions for the session
+    autoStart: false          # mounting must not, by itself, open a socket or spend credit
+    delegationTimeoutMs: 10000
+    maxTranscriptChars: 6000
+```
+
+A session is opened only when `autoStart` is set. `maxTranscriptChars` bounds the transcript carried
+on each request: it is the **oldest** lines that are dropped, and the most recent line is always kept,
+because a buffer that can hold nothing can answer nothing.
+
+## How answers are kept deliverable
+
+- **A long answer is cut, not rejected.** The seam bounds an append at 2000 characters and *throws*
+  past it; a clearly-marked prefix beats losing the answer to an exception raised inside a handler.
+- **A bad responder is a decline.** A synchronous throw, a rejection, or a malformed return all lead
+  to the same honest notice rather than to an exception escaping the adapter's callback.
+- **The bound is unref'd.** A timeout that loses the race cannot hold the process open, and there is
+  no timer id to clear — so no failure path can leak one.
+- **A closed session is not answered into.** Speaking into a released transport would raise a failure
+  from inside a handler, so the handler declines to act instead.
+
+## Tested
+
+Per-file 100% coverage on all four axes, enforced. The delegation path is covered end to end through
+the real seam, a real `serial` dispatch and a real session — including every way of declining, the
+timeout, a responder that throws, and an answer longer than the seam allows.
+
+## Licence
+
+MIT.

package/lib/bridge.d.ts

@@ -0,0 +1,41 @@
+import { type RealtimeDelegation, type RealtimeSession } from 'dsh-realtime';
+import type { AgentTranscriptLine, DelegationAnswer, DelegationRequest } from './types.ts';
+/**
+ * Spoken when a delegation could not be answered.
+ *
+ * Never silent, and never a fabricated answer. The seam's first invariant is that an unresolvable or
+ * erroring delegation never auto-approves; the honest complement is that the model is told so out
+ * loud, because the person in the conversation is the one waiting.
+ */
+export declare const UNANSWERED_NOTICE = "Sorry \u2014 I can't take care of that right now.";
+/**
+ * Ask the application for an answer.
+ *
+ * Synchronous and asynchronous responders are both acceptable, and a decline is `undefined`.
+ */
+export interface DelegationAsker {
+    (request: DelegationRequest): DelegationAnswer | undefined | Promise<DelegationAnswer | undefined>;
+}
+/**
+ * Cut an answer to the seam's append bound.
+ *
+ * A bound applied here rather than at the append is deliberate: the append would *throw*, and losing a
+ * long answer entirely is worse than delivering a marked prefix of it.
+ * @param text - the answer.
+ * @param maxChars - ceiling, defaulting to the seam's own bound.
+ * @returns the text, or a marked prefix of it no longer than `maxChars`.
+ */
+export declare function boundAppend(text: string, maxChars?: number): string;
+/**
+ * Answer one delegation, or tell the model plainly that it could not be answered.
+ *
+ * Dispatched rather than returned: the caller is a session handler, which cannot await.
+ * @param session - the live session the delegation arrived on.
+ * @param delegation - the delegation, whose `id` is carried back on the answer.
+ * @param transcript - the conversation so far, as the responder will see it.
+ * @param ask - how to reach a responder.
+ * @param timeoutMs - bound on waiting for one.
+ * @returns a promise settling once the session has been answered.
+ */
+export declare function answerDelegation(session: Pick<RealtimeSession, 'id' | 'appendCommentary' | 'appendThinking'>, delegation: RealtimeDelegation, transcript: readonly AgentTranscriptLine[], ask: DelegationAsker, timeoutMs: number): Promise<void>;
+//# sourceMappingURL=bridge.d.ts.map

package/lib/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,kBAAkB,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9F,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAE1F;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,sDAAiD,CAAA;AAK/E;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,CAAC,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,GAAG,SAAS,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAA;CACnG;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAyB,GAAG,MAAM,CAKrF;AAmBD;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,GAAG,kBAAkB,GAAG,gBAAgB,CAAC,EAC5E,UAAU,EAAE,kBAAkB,EAC9B,UAAU,EAAE,SAAS,mBAAmB,EAAE,EAC1C,GAAG,EAAE,eAAe,EACpB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CA0Bf"}

package/lib/bridge.js

@@ -0,0 +1,81 @@
+import { MAX_APPEND_CHARS } from 'dsh-realtime';
+/**
+ * Spoken when a delegation could not be answered.
+ *
+ * Never silent, and never a fabricated answer. The seam's first invariant is that an unresolvable or
+ * erroring delegation never auto-approves; the honest complement is that the model is told so out
+ * loud, because the person in the conversation is the one waiting.
+ */
+export const UNANSWERED_NOTICE = "Sorry — I can't take care of that right now.";
+/** Appended to an answer cut to fit the seam's append bound, so a reader knows it is partial. */
+const TRUNCATION_MARKER = ' [truncated]';
+/**
+ * Cut an answer to the seam's append bound.
+ *
+ * A bound applied here rather than at the append is deliberate: the append would *throw*, and losing a
+ * long answer entirely is worse than delivering a marked prefix of it.
+ * @param text - the answer.
+ * @param maxChars - ceiling, defaulting to the seam's own bound.
+ * @returns the text, or a marked prefix of it no longer than `maxChars`.
+ */
+export function boundAppend(text, maxChars = MAX_APPEND_CHARS) {
+    if (text.length <= maxChars)
+        return text;
+    // A ceiling shorter than the marker itself can only carry the marker's own prefix.
+    if (maxChars <= TRUNCATION_MARKER.length)
+        return TRUNCATION_MARKER.slice(0, maxChars);
+    return text.slice(0, maxChars - TRUNCATION_MARKER.length) + TRUNCATION_MARKER;
+}
+/**
+ * Run the asker, turning any failure into a decline.
+ *
+ * A responder that throws must not become an exception the adapter's handler sees, and must not be
+ * mistaken for an answer: failing to answer and choosing not to answer lead to the same honest notice.
+ * @param ask - the asker.
+ * @param request - what to ask.
+ * @returns the answer, or `undefined` when the asker failed.
+ */
+function settled(ask, request) {
+    try {
+        return Promise.resolve(ask(request)).catch(() => undefined);
+    }
+    catch {
+        return Promise.resolve(undefined);
+    }
+}
+/**
+ * Answer one delegation, or tell the model plainly that it could not be answered.
+ *
+ * Dispatched rather than returned: the caller is a session handler, which cannot await.
+ * @param session - the live session the delegation arrived on.
+ * @param delegation - the delegation, whose `id` is carried back on the answer.
+ * @param transcript - the conversation so far, as the responder will see it.
+ * @param ask - how to reach a responder.
+ * @param timeoutMs - bound on waiting for one.
+ * @returns a promise settling once the session has been answered.
+ */
+export async function answerDelegation(session, delegation, transcript, ask, timeoutMs) {
+    const request = {
+        id: delegation.id,
+        offsetMs: delegation.offsetMs,
+        transcript,
+        sessionId: session.id,
+    };
+    // An unref'd bound, so a timer that loses the race cannot hold the process open — and so there is
+    // no id to clear, which means no failure path can leak one.
+    const expired = new Promise((resolve) => {
+        setTimeout(() => { resolve(undefined); }, timeoutMs).unref();
+    });
+    const answer = await Promise.race([settled(ask, request), expired]);
+    const text = typeof answer?.text === 'string' ? answer.text.trim() : '';
+    if (text.length === 0) {
+        await session.appendCommentary(UNANSWERED_NOTICE, delegation.id);
+        return;
+    }
+    if (answer?.mode === 'spoken') {
+        await session.appendCommentary(boundAppend(text), delegation.id);
+        return;
+    }
+    await session.appendThinking(boundAppend(text), delegation.id);
+}
+//# sourceMappingURL=bridge.js.map

package/lib/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAiD,MAAM,cAAc,CAAA;AAG9F;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,8CAA8C,CAAA;AAE/E,iGAAiG;AACjG,MAAM,iBAAiB,GAAG,cAAc,CAAA;AAWxC;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,QAAQ,GAAW,gBAAgB;IAC3E,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,IAAI,CAAA;IACxC,mFAAmF;IACnF,IAAI,QAAQ,IAAI,iBAAiB,CAAC,MAAM;QAAE,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;IACrF,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,GAAG,iBAAiB,CAAC,MAAM,CAAC,GAAG,iBAAiB,CAAA;AAC/E,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,OAAO,CAAC,GAAoB,EAAE,OAA0B;IAC/D,IAAI,CAAC;QACH,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IACnC,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAA4E,EAC5E,UAA8B,EAC9B,UAA0C,EAC1C,GAAoB,EACpB,SAAiB;IAEjB,MAAM,OAAO,GAAsB;QACjC,EAAE,EAAE,UAAU,CAAC,EAAE;QACjB,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,UAAU;QACV,SAAS,EAAE,OAAO,CAAC,EAAE;KACtB,CAAA;IAED,kGAAkG;IAClG,4DAA4D;IAC5D,MAAM,OAAO,GAAG,IAAI,OAAO,CAAY,CAAC,OAAO,EAAE,EAAE;QACjD,UAAU,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAAA,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,KAAK,EAAE,CAAA;IAC7D,CAAC,CAAC,CAAA;IAEF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,CAAA;IACnE,MAAM,IAAI,GAAG,OAAO,MAAM,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IAEvE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,OAAO,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,UAAU,CAAC,EAAE,CAAC,CAAA;QAChE,OAAM;IACR,CAAC;IACD,IAAI,MAAM,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,OAAO,CAAC,gBAAgB,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,EAAE,CAAC,CAAA;QAChE,OAAM;IACR,CAAC;IACD,MAAM,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,EAAE,CAAC,CAAA;AAChE,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,102 @@
+/**
+ * The realtime agent consumer: answers what the voice model delegates.
+ *
+ * A **function plugin** on the `dsh-realtime` seam. It holds a live session, records the conversation,
+ * and when the model raises a delegation it asks the application — over the event bus, with `serial`
+ * semantics so the first responder to answer wins — and delivers the result, or says plainly that it
+ * cannot be handled.
+ *
+ * Per the harness convention it named-exports `name` / `inject` / `Config` / `apply` and has **no
+ * default export** — adding one makes the Loader discard this plugin's namespace, so the plugin would
+ * load and contribute nothing.
+ *
+ * An application answers by listening:
+ *
+ * ```ts
+ * ctx.on('realtime-agent/delegation', (request) => {
+ *   return { text: lookItUp(request.transcript), mode: 'spoken' }
+ * })
+ * ```
+ *
+ * @module dsh-realtime-agent
+ */
+import Schema from '@deepseek-ai/schemastery';
+import type { Context } from '@deepseek-ai/cordis';
+import type { RealtimeSession, RealtimeSessionHandlers } from 'dsh-realtime';
+import { type DelegationAsker } from './bridge.ts';
+import { TranscriptBuffer } from './transcript.ts';
+import type { DelegationAnswer, DelegationRequest, RealtimeAgentConfig } from './types.ts';
+declare module '@deepseek-ai/cordis' {
+    interface Events {
+        /**
+         * Dispatched when the voice model delegates work, awaited with **serial** semantics: listeners run
+         * in order, and the first to return a non-empty answer wins.
+         *
+         * Return `undefined` to decline and let a later responder try. If every listener declines — or none
+         * is registered — the model is told out loud that the request could not be handled.
+         */
+        'realtime-agent/delegation'(request: DelegationRequest): DelegationAnswer | undefined | Promise<DelegationAnswer | undefined>;
+        /** A session-scoped failure the adapter contained rather than throwing. */
+        'realtime-agent/error'(error: Error): void;
+    }
+}
+export * from './types.ts';
+export { answerDelegation, boundAppend, UNANSWERED_NOTICE, type DelegationAsker } from './bridge.ts';
+export { TranscriptBuffer } from './transcript.ts';
+export { voiceToolDefinitions, type VoiceToolDeps } from './tools.ts';
+/** Plugin name, as it appears in Loader diagnostics. */
+export declare const name = "realtime-agent";
+/** This plugin drives the realtime seam and publishes tools, so it waits for both. */
+export declare const inject: string[];
+/**
+ * Validated configuration.
+ *
+ * `autoStart` defaults to `false`: mounting this plugin must not, by itself, open a socket or spend
+ * credit. `voice` and `instructions` are omitted unless set, so the provider default applies rather
+ * than an empty string the provider would reject.
+ */
+export declare const Config: Schema<Schemastery.ObjectS<NoInfer<{
+    provider: Schema<string, string, "defined">;
+    model: Schema<string, string, "defined">;
+    voice: Schema<string, string, "plain">;
+    instructions: Schema<string, string, "plain">;
+    autoStart: Schema<boolean, boolean, "defined">;
+    delegationTimeoutMs: Schema<number, number, "defined">;
+    maxTranscriptChars: Schema<number, number, "defined">;
+}>>, Schemastery.ObjectT<NoInfer<{
+    provider: Schema<string, string, "defined">;
+    model: Schema<string, string, "defined">;
+    voice: Schema<string, string, "plain">;
+    instructions: Schema<string, string, "plain">;
+    autoStart: Schema<boolean, boolean, "defined">;
+    delegationTimeoutMs: Schema<number, number, "defined">;
+    maxTranscriptChars: Schema<number, number, "defined">;
+}>>, "plain">;
+/** What {@link createHandlers} needs. Injected rather than closed over, so the handlers are testable. */
+export interface HandlerDeps {
+    /** The conversation recorded so far. */
+    readonly transcript: TranscriptBuffer;
+    /** The live session a handler should act on, or `undefined` when there is none. */
+    readonly session: () => RealtimeSession | undefined;
+    /** How to reach a responder. */
+    readonly ask: DelegationAsker;
+    /** Bound on waiting for one. */
+    readonly timeoutMs: number;
+    /** Called when the session ended, so the caller can drop its reference. */
+    readonly onClosed: () => void;
+    /** Where a session-scoped failure is reported. */
+    readonly onSessionError: (error: Error) => void;
+}
+/**
+ * Build the session handlers.
+ * @param deps - the session, the transcript and the asker.
+ * @returns handlers the adapter can invoke for the life of the session.
+ */
+export declare function createHandlers(deps: HandlerDeps): RealtimeSessionHandlers;
+/**
+ * Hold a session and bridge what the voice model delegates.
+ * @param ctx - the Cordis context, which must already provide the `realtime` service.
+ * @param config - validated configuration.
+ */
+export declare function apply(ctx: Context, config: RealtimeAgentConfig): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,MAAM,MAAM,0BAA0B,CAAA;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAsB,eAAe,EAAE,uBAAuB,EAAsB,MAAM,cAAc,CAAA;AACpH,OAAO,EAAoB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAA;AAEpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAE1F,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,MAAM;QACd;;;;;;WAMG;QACH,2BAA2B,CAAC,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,GAAG,SAAS,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAA;QAC7H,2EAA2E;QAC3E,sBAAsB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;KAC3C;CACF;AAED,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAA;AACpG,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,EAAE,oBAAoB,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAA;AAErE,wDAAwD;AACxD,eAAO,MAAM,IAAI,mBAAmB,CAAA;AAEpC,sFAAsF;AACtF,eAAO,MAAM,MAAM,UAAwB,CAAA;AAE3C;;;;;;GAMG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;aAQjB,CAAA;AAEF,yGAAyG;AACzG,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAA;IACrC,mFAAmF;IACnF,QAAQ,CAAC,OAAO,EAAE,MAAM,eAAe,GAAG,SAAS,CAAA;IACnD,gCAAgC;IAChC,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAA;IAC7B,gCAAgC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAA;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,cAAc,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;CAChD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,uBAAuB,CAkBzE;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,mBAAmB,GAAG,IAAI,CA0DrE"}

package/lib/index.js

@@ -0,0 +1,137 @@
+/**
+ * The realtime agent consumer: answers what the voice model delegates.
+ *
+ * A **function plugin** on the `dsh-realtime` seam. It holds a live session, records the conversation,
+ * and when the model raises a delegation it asks the application — over the event bus, with `serial`
+ * semantics so the first responder to answer wins — and delivers the result, or says plainly that it
+ * cannot be handled.
+ *
+ * Per the harness convention it named-exports `name` / `inject` / `Config` / `apply` and has **no
+ * default export** — adding one makes the Loader discard this plugin's namespace, so the plugin would
+ * load and contribute nothing.
+ *
+ * An application answers by listening:
+ *
+ * ```ts
+ * ctx.on('realtime-agent/delegation', (request) => {
+ *   return { text: lookItUp(request.transcript), mode: 'spoken' }
+ * })
+ * ```
+ *
+ * @module dsh-realtime-agent
+ */
+import Schema from '@deepseek-ai/schemastery';
+import { answerDelegation } from './bridge.js';
+import { voiceToolDefinitions } from './tools.js';
+import { TranscriptBuffer } from './transcript.js';
+export * from './types.js';
+export { answerDelegation, boundAppend, UNANSWERED_NOTICE } from './bridge.js';
+export { TranscriptBuffer } from './transcript.js';
+export { voiceToolDefinitions } from './tools.js';
+/** Plugin name, as it appears in Loader diagnostics. */
+export const name = 'realtime-agent';
+/** This plugin drives the realtime seam and publishes tools, so it waits for both. */
+export const inject = ['realtime', 'tools'];
+/**
+ * Validated configuration.
+ *
+ * `autoStart` defaults to `false`: mounting this plugin must not, by itself, open a socket or spend
+ * credit. `voice` and `instructions` are omitted unless set, so the provider default applies rather
+ * than an empty string the provider would reject.
+ */
+export const Config = Schema.object({
+    provider: Schema.string().default('openai-live').description('Registered realtime route to open a session on'),
+    model: Schema.string().default('gpt-live-1').description('Voice model to request'),
+    voice: Schema.string().required(false).description('Output voice; omitted leaves the provider default'),
+    instructions: Schema.string().required(false).description('Opening instructions for the live session'),
+    autoStart: Schema.boolean().default(false).description('Open a session as soon as the plugin mounts'),
+    delegationTimeoutMs: Schema.number().default(10_000).description('Bound on waiting for a responder'),
+    maxTranscriptChars: Schema.number().default(6_000).description('Character budget for the delegation transcript'),
+});
+/**
+ * Build the session handlers.
+ * @param deps - the session, the transcript and the asker.
+ * @returns handlers the adapter can invoke for the life of the session.
+ */
+export function createHandlers(deps) {
+    return {
+        onTranscript: (fragment) => {
+            deps.transcript.append(fragment.kind, fragment.text, fragment.final);
+        },
+        onDelegation: (delegation) => {
+            const session = deps.session();
+            // A delegation cannot be answered into a session that is gone. Speaking into a closed transport
+            // would be a failure raised from inside a handler, which is the worst place to raise one.
+            if (session === undefined)
+                return;
+            // Handlers are synchronous, so the answer is dispatched rather than awaited. A rejection is
+            // reported rather than thrown: an unanswered delegation is already the failure path.
+            void answerDelegation(session, delegation, deps.transcript.lines(), deps.ask, deps.timeoutMs)
+                .catch(deps.onSessionError);
+        },
+        onClosed: () => { deps.onClosed(); },
+        onError: (error) => { deps.onSessionError(error); },
+    };
+}
+/**
+ * Hold a session and bridge what the voice model delegates.
+ * @param ctx - the Cordis context, which must already provide the `realtime` service.
+ * @param config - validated configuration.
+ */
+export function apply(ctx, config) {
+    const transcript = new TranscriptBuffer(config.maxTranscriptChars);
+    let session;
+    const handlers = createHandlers({
+        transcript,
+        session: () => session,
+        ask: request => ctx.serial('realtime-agent/delegation', request),
+        timeoutMs: config.delegationTimeoutMs,
+        onClosed: () => { session = undefined; },
+        onSessionError: (error) => { ctx.emit('realtime-agent/error', error); },
+    });
+    /**
+     * Open a session, or return the one already open.
+     *
+     * Idempotent on purpose: `voice_start` is safe to call repeatedly, and a model that calls it twice
+     * must not end up with two live sessions it cannot see.
+     */
+    const open = async () => {
+        const current = session;
+        if (current !== undefined)
+            return current;
+        const opened = await ctx.realtime.session({
+            provider: config.provider,
+            model: config.model,
+            ...config.voice === undefined ? {} : { voice: config.voice },
+            ...config.instructions === undefined ? {} : { instructions: config.instructions },
+            handlers,
+        });
+        session = opened;
+        return opened;
+    };
+    /**
+     * Close the session, dropping the reference first.
+     *
+     * Dropping it before the close settles means a delegation arriving during teardown is ignored rather
+     * than answered into a transport that is going away.
+     */
+    const stop = async () => {
+        const current = session;
+        session = undefined;
+        await current?.close();
+    };
+    // Tools are an effect, like every other contribution this plugin makes: the fiber that mounted them
+    // releases them, so there is no separate teardown path to forget.
+    ctx.effect(function* () {
+        const disposers = voiceToolDefinitions({ session: () => session, start: open, stop })
+            .map(definition => ctx.tools.register(definition));
+        yield () => { for (const dispose of disposers)
+            dispose(); };
+    }, 'realtime-agent.tools');
+    if (config.autoStart) {
+        // `apply` is synchronous, so a failed open cannot be thrown from it — it is reported on the bus
+        // instead. The plugin stays valid and a later start may succeed.
+        void open().catch((error) => { ctx.emit('realtime-agent/error', error); });
+    }
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,MAAM,MAAM,0BAA0B,CAAA;AAG7C,OAAO,EAAE,gBAAgB,EAAwB,MAAM,aAAa,CAAA;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAkBlD,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,iBAAiB,EAAwB,MAAM,aAAa,CAAA;AACpG,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,EAAE,oBAAoB,EAAsB,MAAM,YAAY,CAAA;AAErE,wDAAwD;AACxD,MAAM,CAAC,MAAM,IAAI,GAAG,gBAAgB,CAAA;AAEpC,sFAAsF;AACtF,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;AAE3C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,WAAW,CAAC,gDAAgD,CAAC;IAC9G,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,wBAAwB,CAAC;IAClF,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,mDAAmD,CAAC;IACvG,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,2CAA2C,CAAC;IACtG,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,6CAA6C,CAAC;IACrG,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,kCAAkC,CAAC;IACpG,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,gDAAgD,CAAC;CACjH,CAAC,CAAA;AAkBF;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAiB;IAC9C,OAAO;QACL,YAAY,EAAE,CAAC,QAA4B,EAAQ,EAAE;YACnD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAA;QACtE,CAAC;QACD,YAAY,EAAE,CAAC,UAA8B,EAAQ,EAAE;YACrD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAA;YAC9B,gGAAgG;YAChG,0FAA0F;YAC1F,IAAI,OAAO,KAAK,SAAS;gBAAE,OAAM;YACjC,4FAA4F;YAC5F,qFAAqF;YACrF,KAAK,gBAAgB,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC;iBAC1F,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;QAC/B,CAAC;QACD,QAAQ,EAAE,GAAS,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAA,CAAC,CAAC;QACzC,OAAO,EAAE,CAAC,KAAY,EAAQ,EAAE,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAA,CAAC,CAAC;KAChE,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,KAAK,CAAC,GAAY,EAAE,MAA2B;IAC7D,MAAM,UAAU,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAA;IAClE,IAAI,OAAoC,CAAA;IAExC,MAAM,QAAQ,GAAG,cAAc,CAAC;QAC9B,UAAU;QACV,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO;QACtB,GAAG,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,2BAA2B,EAAE,OAAO,CAAC;QAChE,SAAS,EAAE,MAAM,CAAC,mBAAmB;QACrC,QAAQ,EAAE,GAAG,EAAE,GAAG,OAAO,GAAG,SAAS,CAAA,CAAC,CAAC;QACvC,cAAc,EAAE,CAAC,KAAK,EAAE,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAA,CAAC,CAAC;KACvE,CAAC,CAAA;IAEF;;;;;OAKG;IACH,MAAM,IAAI,GAAG,KAAK,IAA8B,EAAE;QAChD,MAAM,OAAO,GAAG,OAAO,CAAA;QACvB,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,OAAO,CAAA;QACzC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC;YACxC,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,GAAG,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE;YAC5D,GAAG,MAAM,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE;YACjF,QAAQ;SACT,CAAC,CAAA;QACF,OAAO,GAAG,MAAM,CAAA;QAChB,OAAO,MAAM,CAAA;IACf,CAAC,CAAA;IAED;;;;;OAKG;IACH,MAAM,IAAI,GAAG,KAAK,IAAmB,EAAE;QACrC,MAAM,OAAO,GAAG,OAAO,CAAA;QACvB,OAAO,GAAG,SAAS,CAAA;QACnB,MAAM,OAAO,EAAE,KAAK,EAAE,CAAA;IACxB,CAAC,CAAA;IAED,oGAAoG;IACpG,kEAAkE;IAClE,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC;QAClB,MAAM,SAAS,GAAG,oBAAoB,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;aAClF,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAA;QACpD,MAAM,GAAG,EAAE,GAAG,KAAK,MAAM,OAAO,IAAI,SAAS;YAAE,OAAO,EAAE,CAAA,CAAC,CAAC,CAAA;IAC5D,CAAC,EAAE,sBAAsB,CAAC,CAAA;IAE1B,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,gGAAgG;QAChG,iEAAiE;QACjE,KAAK,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAY,EAAE,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA;IAClF,CAAC;AACH,CAAC"}

package/lib/tools.d.ts

@@ -0,0 +1,22 @@
+import { type ToolDefinition } from '@deepseek-ai/dsh-tools';
+import type { RealtimeSession } from 'dsh-realtime';
+/** The session controls the voice tools act on. */
+export interface VoiceToolDeps {
+    /** The live session, or `undefined` when none is open. */
+    readonly session: () => RealtimeSession | undefined;
+    /** Open a session, or return the one already open. */
+    readonly start: () => Promise<RealtimeSession>;
+    /** Close the open session, if any. */
+    readonly stop: () => Promise<void>;
+}
+/**
+ * The tools that let an agent drive a voice session.
+ *
+ * Deliberately a small surface with one concern — driving the session — rather than a chat UI in
+ * tool form. Reading what was said needs no tool: a delegation already arrives carrying the
+ * conversation, which is the whole reason the consumer exists.
+ * @param deps - the session controls.
+ * @returns definitions ready to register on the tools service.
+ */
+export declare function voiceToolDefinitions(deps: VoiceToolDeps): ToolDefinition[];
+//# sourceMappingURL=tools.d.ts.map

package/lib/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,cAAc,EAAwB,MAAM,wBAAwB,CAAA;AAC/G,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAqBnD,mDAAmD;AACnD,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,MAAM,eAAe,GAAG,SAAS,CAAA;IACnD,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,CAAA;IAC9C,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CACnC;AAuBD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,aAAa,GAAG,cAAc,EAAE,CA6C1E"}

package/lib/tools.js

@@ -0,0 +1,88 @@
+import { defineTool } from '@deepseek-ai/dsh-tools';
+/**
+ * A canonical output declaration rendered as JSON.
+ *
+ * `defineTool` requires an `output` with a schema **and** a `render` projection, and the harness ships
+ * no helper for the common case — where the value is for the model to read rather than for a bespoke
+ * presenter. Six lines here rather than a dependency on another plugin's private helper.
+ * @param schema - the canonical value's author-facing schema.
+ * @returns the output declaration the tool definition wants.
+ */
+function jsonOutput(schema) {
+    return {
+        schema,
+        render: (_args, value) => [{ type: 'text', text: JSON.stringify(value) }],
+    };
+}
+const STARTED_VALUE = {
+    type: 'object',
+    additionalProperties: false,
+    properties: { sessionId: { type: 'string', required: true } },
+};
+const STOPPED_VALUE = {
+    type: 'object',
+    additionalProperties: false,
+    properties: { closed: { type: 'boolean', required: true } },
+};
+const SAID_VALUE = {
+    type: 'object',
+    additionalProperties: false,
+    properties: {
+        spoken: { type: 'boolean', required: true },
+        characters: { type: 'number', required: true },
+    },
+};
+/**
+ * The tools that let an agent drive a voice session.
+ *
+ * Deliberately a small surface with one concern — driving the session — rather than a chat UI in
+ * tool form. Reading what was said needs no tool: a delegation already arrives carrying the
+ * conversation, which is the whole reason the consumer exists.
+ * @param deps - the session controls.
+ * @returns definitions ready to register on the tools service.
+ */
+export function voiceToolDefinitions(deps) {
+    return [
+        defineTool({
+            name: 'voice_start',
+            description: 'Open the live voice session so you can be heard. Safe to call when one is already open.',
+            parameters: {},
+            output: jsonOutput(STARTED_VALUE),
+            async execute() {
+                const session = await deps.start();
+                return { sessionId: session.id };
+            },
+        }),
+        defineTool({
+            name: 'voice_stop',
+            description: 'End the live voice session. Safe to call when none is open.',
+            parameters: {},
+            output: jsonOutput(STOPPED_VALUE),
+            async execute() {
+                // Reported rather than thrown: stopping a session that is not running has achieved what the
+                // caller asked for, so it is a success that says it had nothing to do.
+                const wasOpen = deps.session() !== undefined;
+                await deps.stop();
+                return { closed: wasOpen };
+            },
+        }),
+        defineTool({
+            name: 'voice_say',
+            description: 'Say something out loud in the live voice session, in your own voice.',
+            parameters: { text: { type: 'string', required: true, description: 'What to say aloud.' } },
+            output: jsonOutput(SAID_VALUE),
+            async execute(args) {
+                const session = deps.session();
+                // Thrown, not returned as a value. A tool-thrown failure is the registry's own failure
+                // channel, and reporting this as a successful result would leave the model believing it had
+                // spoken when nothing was said.
+                if (session === undefined) {
+                    throw new Error('no voice session is open — call voice_start first');
+                }
+                await session.appendCommentary(args.text);
+                return { spoken: true, characters: args.text.length };
+            },
+        }),
+    ];
+}
+//# sourceMappingURL=tools.js.map

package/lib/tools.js.map

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