@inferencesh/app 0.1.14 → 0.1.15

package/dist/index.d.ts

@@ -2,7 +2,7 @@ export { File } from "./file.js";
 export type { FileOptions, FileData } from "./file.js";
 export { createFileSchema, isFileSchema, FILE_SCHEMA_MARKER } from "./schema.js";
 export type { Socket, Frame } from "./socket.js";
-export { createStreamSchema, media, pcm16, Live, liveFields, binaryField, STREAM_SCHEMA_MARKER, BINARY_SCHEMA_MARKER, } from "./stream.js";
+export { createStreamSchema, media, pcm16, Live, liveFields, binaryField, STREAM_SCHEMA_MARKER, CLEAR_KEY, BINARY_SCHEMA_MARKER, } from "./stream.js";
 export type { Update } from "./stream.js";
 export { StorageDir, ensureDir } from "./storage.js";
 export type { StorageDirValue } from "./storage.js";

package/dist/index.js

@@ -2,7 +2,7 @@
 export { File } from "./file.js";
 // Zod schema utilities
 export { createFileSchema, isFileSchema, FILE_SCHEMA_MARKER } from "./schema.js";
-export { createStreamSchema, media, pcm16, Live, liveFields, binaryField, STREAM_SCHEMA_MARKER, BINARY_SCHEMA_MARKER, } from "./stream.js";
+export { createStreamSchema, media, pcm16, Live, liveFields, binaryField, STREAM_SCHEMA_MARKER, CLEAR_KEY, BINARY_SCHEMA_MARKER, } from "./stream.js";
 // Storage directories
 export { StorageDir, ensureDir } from "./storage.js";
 // Download utility

package/dist/stream.d.ts

@@ -51,6 +51,11 @@ import type { Socket } from "./socket.js";
  * The kernel's zodToJsonSchema reads this and emits `format: "stream"`.
  */
 export declare const STREAM_SCHEMA_MARKER: unique symbol;
+/**
+ * A control frame, `{"$clear": "audio"}`: drop what has been buffered of a
+ * live output field. Reserved keys start with `$`, which no field name can.
+ */
+export declare const CLEAR_KEY = "$clear";
 /**
  * Marks a binary item schema. The value on `_def` is the content type.
  * The kernel's zodToJsonSchema reads this and emits
@@ -127,6 +132,8 @@ export declare class Live {
     private readonly inBinary;
     private readonly outShape;
     private readonly outBinary;
+    private readonly outLive;
+    private refusedBinary;
     constructor(socket: Socket, inputData: Record<string, unknown>, inputSchema: any, outputSchema: any);
     [Symbol.asyncIterator](): AsyncGenerator<Update, void, undefined>;
     private frames;
@@ -140,5 +147,10 @@ export declare class Live {
      * `await live.send({ effect: "echo" })` are JSON frames. Keys in one call
      * other than the binary field go out together as one JSON frame.
      */
+    /**
+     * Tell the caller to drop what it has buffered of a live output field:
+     * the queued audio of an answer the user just talked over.
+     */
+    clear(field: string): Promise<void>;
     send(fields: Record<string, unknown>): Promise<void>;
 }

package/dist/stream.js

@@ -50,6 +50,11 @@
  * The kernel's zodToJsonSchema reads this and emits `format: "stream"`.
  */
 export const STREAM_SCHEMA_MARKER = Symbol.for("inferencesh.streamSchema");
+/**
+ * A control frame, `{"$clear": "audio"}`: drop what has been buffered of a
+ * live output field. Reserved keys start with `$`, which no field name can.
+ */
+export const CLEAR_KEY = "$clear";
 /**
  * Marks a binary item schema. The value on `_def` is the content type.
  * The kernel's zodToJsonSchema reads this and emits
@@ -213,6 +218,8 @@ export class Live {
     inBinary;
     outShape;
     outBinary;
+    outLive;
+    refusedBinary = false;
     constructor(socket, inputData, inputSchema, outputSchema) {
         this.socket = socket;
         this.input = inputData;
@@ -221,6 +228,7 @@ export class Live {
         this.inBinary = binaryField(inputSchema);
         this.outShape = shapeOf(outputSchema);
         this.outBinary = binaryField(outputSchema);
+        this.outLive = liveFields(outputSchema);
     }
     async *[Symbol.asyncIterator]() {
         for await (const frame of this.frames()) {
@@ -245,7 +253,12 @@ export class Live {
     async read(frame) {
         if (isBinaryFrame(frame)) {
             if (this.inBinary === null) {
-                await this.refuse(null, "this function takes no binary frames");
+                // Once: a caller streaming audio to the wrong function would
+                // otherwise get an error frame for every frame it sends.
+                if (!this.refusedBinary) {
+                    this.refusedBinary = true;
+                    await this.refuse(null, "this function takes no binary frames");
+                }
                 return [];
             }
             return [{ field: this.inBinary, value: toBuffer(frame) }];
@@ -263,30 +276,25 @@ export class Live {
         }
         const updates = [];
         for (const [key, raw] of Object.entries(patch)) {
-            if (Object.prototype.hasOwnProperty.call(this.inLive, key)) {
-                if (key === this.inBinary) {
-                    await this.refuse(key, "send this field's items as binary frames");
-                    continue;
-                }
-                const result = this.inLive[key].safeParse(raw);
-                if (!result.success) {
-                    await this.refuse(key, firstIssue(result));
-                    continue;
-                }
-                updates.push({ field: key, value: result.data });
+            const live = Object.prototype.hasOwnProperty.call(this.inLive, key);
+            if (!live && !Object.prototype.hasOwnProperty.call(this.inShape, key)) {
+                await this.refuse(key, "no such field");
+                continue;
             }
-            else if (Object.prototype.hasOwnProperty.call(this.inShape, key)) {
-                const result = this.inShape[key].safeParse(raw);
-                if (!result.success) {
-                    await this.refuse(key, firstIssue(result));
-                    continue;
-                }
-                this.input[key] = result.data;
-                updates.push({ field: key, value: result.data });
+            if (key === this.inBinary) {
+                await this.refuse(key, "send this field's items as binary frames");
+                continue;
             }
-            else {
-                await this.refuse(key, "no such field");
+            // A live field's items are validated against the item schema, an
+            // ordinary field against its own and then applied to the input.
+            const result = (live ? this.inLive[key] : this.inShape[key]).safeParse(raw);
+            if (!result.success) {
+                await this.refuse(key, firstIssue(result));
+                continue;
             }
+            if (!live)
+                this.input[key] = result.data;
+            updates.push({ field: key, value: result.data });
         }
         return updates;
     }
@@ -301,6 +309,16 @@ export class Live {
      * `await live.send({ effect: "echo" })` are JSON frames. Keys in one call
      * other than the binary field go out together as one JSON frame.
      */
+    /**
+     * Tell the caller to drop what it has buffered of a live output field:
+     * the queued audio of an answer the user just talked over.
+     */
+    async clear(field) {
+        if (!Object.prototype.hasOwnProperty.call(this.outLive, field)) {
+            throw new Error(`the output schema has no live field "${field}"`);
+        }
+        await this.socket.send({ [CLEAR_KEY]: field });
+    }
     async send(fields) {
         const patch = {};
         for (const [key, value] of Object.entries(fields)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inferencesh/app",
-  "version": "0.1.14",
+  "version": "0.1.15",
   "description": "App framework for building inference.sh apps — File handling, output metadata, storage utilities",
   "type": "module",
   "main": "dist/index.js",