@runappsai/sdk 0.7.3 → 0.7.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runappsai/sdk",
-  "version": "0.7.3",
+  "version": "0.7.5",
   "description": "JavaScript / TypeScript client for the RunApps AI Gateway",
   "license": "MIT",
   "author": "RunApps",

package/src/chat.ts

@@ -40,9 +40,34 @@ export interface ChatTool {
     name: string;
     description?: string;
     parameters?: Record<string, unknown>;
+    /**
+     * Guarantee arguments that validate against `parameters` (strict tool
+     * use). The schema should list `required` fields and close every
+     * object with `additionalProperties: false`.
+     */
+    strict?: boolean;
   };
 }
 
+/**
+ * Constrains the reply. `json_schema` makes the reply a JSON document
+ * matching `schema` (structured outputs: on Claude it becomes
+ * `output_config.format`, and objects that leave `additionalProperties`
+ * unset are closed for you); `json_object` asks for any JSON object.
+ */
+export type ChatResponseFormat =
+  | { type: "text" }
+  | { type: "json_object" }
+  | {
+      type: "json_schema";
+      json_schema: {
+        name: string;
+        description?: string;
+        schema: Record<string, unknown>;
+        strict?: boolean;
+      };
+    };
+
 export interface StreamOptions {
   include_usage: boolean;
 }
@@ -108,6 +133,8 @@ export interface ChatCompletionParams {
   n?: number;
   tools?: ChatTool[];
   tool_choice?: unknown;
+  /** Structured outputs — see {@link ChatResponseFormat}. */
+  response_format?: ChatResponseFormat;
   user?: string;
   metadata?: Record<string, unknown>;
   stream?: boolean;

package/src/index.ts

@@ -55,6 +55,7 @@ export type {
   ChatMessage,
   ContentPart,
   ChatTool,
+  ChatResponseFormat,
   StreamOptions,
   ChatCompletionParams,
   ChatToolCall,

package/src/realtime.ts

@@ -19,7 +19,9 @@ import type { Transport } from "./transport.js";
  *   → response.cancel                    interrupt the reply
  *   → session.close                      (close() sends it)
  *   ← session.created
- *   ← conversation.item.input_audio_transcription.delta / .completed   (what the user said)
+ *   ← conversation.item.input_audio_transcription.delta / .completed   (what the user said:
+ *        delta = only the new text, as OpenAI's Realtime API; transcript = the
+ *        sentence so far; completed.transcript = the final sentence)
  *   ← response.output_text.delta / .done                                (what the model says)
  *   ← response.output_audio.delta        {delta: base64 PCM16, 24 kHz mono by default}
  *   ← response.done                      one turn finished, with token usage
@@ -36,8 +38,9 @@ import type { Transport } from "./transport.js";
  * `session.mode: "transcription"`, `session.hotwords` (array or
  * comma-separated string) favours words, and only the
  * `…input_audio_transcription.started / .delta / .completed` events come
- * back — `.delta` holds the sentence so far, `.completed` a finished
- * sentence with `start_ms` / `end_ms`. `commitAudio()` or `close()` ends
+ * back — `.delta` carries the new text in `delta` (append it) and the
+ * sentence so far, revisions included, in `transcript`; `.completed` a
+ * finished sentence (`transcript`) with `start_ms` / `end_ms`. `commitAudio()` or `close()` ends
  * the audio; the last sentence settles before the session closes.
  */