@crvouga/mockingbird-service-livekit 2.1.0 → 2.2.0

package/dist/{chunk-2GG6WCKV.js → chunk-LCGGA6VQ.js}

@@ -3,7 +3,7 @@ import {
   createRuntime,
   parseDuration,
   resolveAdminPrefix
-} from "./chunk-RIGGRABC.js";
+} from "./chunk-FPXRYSAN.js";
 
 // ../../adapters/node/dist/cli.js
 import { readFile as readFile2 } from "node:fs/promises";
@@ -818,4 +818,4 @@ export {
   createServer2 as createServer,
   serveTarget
 };
-//# sourceMappingURL=chunk-2GG6WCKV.js.map
+//# sourceMappingURL=chunk-LCGGA6VQ.js.map

package/dist/cli.js

@@ -3,8 +3,8 @@ import {
   runCli,
   serveCommand,
   serveTarget
-} from "./chunk-2GG6WCKV.js";
-import "./chunk-RIGGRABC.js";
+} from "./chunk-LCGGA6VQ.js";
+import "./chunk-FPXRYSAN.js";
 
 // src/cli.ts
 var code = await runCli(

package/dist/index.d.ts

@@ -818,8 +818,8 @@ type OpenAPIDocument = {
 };
 
 declare const document: OpenAPIDocument;
-declare const operationIds: readonly ["RoomService", "EgressService", "SipService"];
-declare const supportedOperationIds: readonly ["RoomService", "EgressService", "SipService"];
+declare const operationIds: readonly ["CreateDispatch", "ListDispatch", "DeleteDispatch", "RoomService", "EgressService", "SipService"];
+declare const supportedOperationIds: readonly ["CreateDispatch", "ListDispatch", "DeleteDispatch", "RoomService", "EgressService", "SipService"];
 
 /** Bind values accepted by Mockingbird's SQLite port (matches sqlite-mem / better-sqlite3). */
 type SqliteValue = null | number | bigint | string | Uint8Array | boolean;
@@ -897,8 +897,42 @@ type AsyncResource = {
     input: Record<string, unknown>;
     error?: string;
 };
+declare const JOB_STATUSES: readonly ["JS_PENDING", "JS_RUNNING", "JS_SUCCESS", "JS_FAILED"];
+type JobStatus = (typeof JOB_STATUSES)[number];
+type AgentJob = {
+    id: string;
+    dispatchId: string;
+    type: "JT_ROOM";
+    room: Omit<LiveKitRoom, "creationTime"> & {
+        creationTime: string;
+    };
+    metadata: string;
+    agentName: string;
+    state: {
+        status: JobStatus;
+        error: string;
+        startedAt: string;
+        endedAt: string;
+        updatedAt: string;
+        participantIdentity: string;
+        workerId: string;
+        agentId: string;
+    };
+};
+type AgentDispatch = {
+    id: string;
+    agentName: string;
+    room: string;
+    metadata: string;
+    state: {
+        jobs: AgentJob[];
+        createdAt: string;
+        deletedAt: string;
+    };
+};
 declare class LiveKitState {
     readonly rooms: Collection<LiveKitRoom>;
+    readonly dispatches: Collection<AgentDispatch>;
     readonly participants: Collection<LiveKitParticipant & {
         room: string;
     }>;
@@ -991,6 +1025,16 @@ declare class LiveKitAPI {
         kind: "egress" | "sip";
         roomName?: string;
     } | undefined;
+    /** Script a single room job; workers and media transport are outside the mock. */
+    assignJob(dispatchId: string, input: {
+        status?: JobStatus;
+        workerId?: string;
+        agentId?: string;
+        participantIdentity?: string;
+        error?: string;
+    }): AgentJob | undefined;
+    private dispatchView;
+    private dispatchService;
     private authorize;
     private roomService;
     private asyncService;
@@ -998,4 +1042,4 @@ declare class LiveKitAPI {
 }
 
 export { LIVEKIT_NAMESPACE, LIVEKIT_PRESETS, LiveKitAPI, createRuntime, document, operationIds, supportedOperationIds };
-export type { AsyncResource, DataMessage, LiveKitAPIOptions, LiveKitEvent, LiveKitParticipant, LiveKitRoom, LiveKitRuntime, LiveKitRuntimeOptions, LiveKitTrack };
+export type { AgentDispatch, AgentJob, AsyncResource, DataMessage, JobStatus, LiveKitAPIOptions, LiveKitEvent, LiveKitParticipant, LiveKitRoom, LiveKitRuntime, LiveKitRuntimeOptions, LiveKitTrack };

package/dist/index.js

@@ -6,7 +6,7 @@ import {
   document,
   operationIds,
   supportedOperationIds
-} from "./chunk-RIGGRABC.js";
+} from "./chunk-FPXRYSAN.js";
 export {
   LIVEKIT_NAMESPACE,
   LIVEKIT_PRESETS,

package/dist/server.d.ts

@@ -1331,8 +1331,42 @@ type AsyncResource = {
     input: Record<string, unknown>;
     error?: string;
 };
+declare const JOB_STATUSES: readonly ["JS_PENDING", "JS_RUNNING", "JS_SUCCESS", "JS_FAILED"];
+type JobStatus = (typeof JOB_STATUSES)[number];
+type AgentJob = {
+    id: string;
+    dispatchId: string;
+    type: "JT_ROOM";
+    room: Omit<LiveKitRoom, "creationTime"> & {
+        creationTime: string;
+    };
+    metadata: string;
+    agentName: string;
+    state: {
+        status: JobStatus;
+        error: string;
+        startedAt: string;
+        endedAt: string;
+        updatedAt: string;
+        participantIdentity: string;
+        workerId: string;
+        agentId: string;
+    };
+};
+type AgentDispatch = {
+    id: string;
+    agentName: string;
+    room: string;
+    metadata: string;
+    state: {
+        jobs: AgentJob[];
+        createdAt: string;
+        deletedAt: string;
+    };
+};
 declare class LiveKitState {
     readonly rooms: Collection<LiveKitRoom>;
+    readonly dispatches: Collection<AgentDispatch>;
     readonly participants: Collection<LiveKitParticipant & {
         room: string;
     }>;
@@ -1404,6 +1438,16 @@ declare class LiveKitAPI {
         kind: "egress" | "sip";
         roomName?: string;
     } | undefined;
+    /** Script a single room job; workers and media transport are outside the mock. */
+    assignJob(dispatchId: string, input: {
+        status?: JobStatus;
+        workerId?: string;
+        agentId?: string;
+        participantIdentity?: string;
+        error?: string;
+    }): AgentJob | undefined;
+    private dispatchView;
+    private dispatchService;
     private authorize;
     private roomService;
     private asyncService;

package/dist/server.js

@@ -2,8 +2,8 @@ import {
   DEFAULT_PORT,
   createServer,
   serveTarget
-} from "./chunk-2GG6WCKV.js";
-import "./chunk-RIGGRABC.js";
+} from "./chunk-LCGGA6VQ.js";
+import "./chunk-FPXRYSAN.js";
 export {
   DEFAULT_PORT,
   createServer,

package/openapi.yaml

@@ -2,10 +2,85 @@ openapi: 3.1.0
 info:
   title: LiveKit Server API (Mockingbird subset)
   version: "2.19.1"
-  description: Twirp JSON room, participant, egress, and SIP contract.
+  description: Twirp JSON room, participant, agent dispatch, egress, and SIP contract.
 servers:
   - url: https://example.livekit.cloud
 paths:
+  /twirp/livekit.AgentDispatchService/CreateDispatch:
+    post:
+      operationId: CreateDispatch
+      description: Agent dispatch with a signed roomAdmin JWT; protobuf JSON names accept snake_case or camelCase.
+      security:
+        - bearerAuth: []
+      x-mockingbird:
+        supported: true
+        parity: { enabled: true, safe: false }
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema: { $ref: "#/components/schemas/CreateDispatchRequest" }
+      responses:
+        "200":
+          description: Protobuf JSON result
+          content:
+            application/json:
+              schema: { $ref: "#/components/schemas/AgentDispatch" }
+        "400": { $ref: "#/components/responses/TwirpError" }
+        "401": { $ref: "#/components/responses/TwirpError" }
+        "404": { $ref: "#/components/responses/TwirpError" }
+        "429": { $ref: "#/components/responses/TwirpError" }
+        "500": { $ref: "#/components/responses/TwirpError" }
+  /twirp/livekit.AgentDispatchService/ListDispatch:
+    post:
+      operationId: ListDispatch
+      description: Agent dispatch with a signed roomAdmin JWT; protobuf JSON names accept snake_case or camelCase.
+      security:
+        - bearerAuth: []
+      x-mockingbird:
+        supported: true
+        parity: { enabled: true, safe: true }
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema: { $ref: "#/components/schemas/ListDispatchRequest" }
+      responses:
+        "200":
+          description: Protobuf JSON result
+          content:
+            application/json:
+              schema: { $ref: "#/components/schemas/DispatchPage" }
+        "400": { $ref: "#/components/responses/TwirpError" }
+        "401": { $ref: "#/components/responses/TwirpError" }
+        "404": { $ref: "#/components/responses/TwirpError" }
+        "429": { $ref: "#/components/responses/TwirpError" }
+        "500": { $ref: "#/components/responses/TwirpError" }
+  /twirp/livekit.AgentDispatchService/DeleteDispatch:
+    post:
+      operationId: DeleteDispatch
+      description: Agent dispatch with a signed roomAdmin JWT; protobuf JSON names accept snake_case or camelCase.
+      security:
+        - bearerAuth: []
+      x-mockingbird:
+        supported: true
+        parity: { enabled: true, safe: false }
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema: { $ref: "#/components/schemas/DeleteDispatchRequest" }
+      responses:
+        "200":
+          description: Protobuf JSON result
+          content:
+            application/json:
+              schema: { $ref: "#/components/schemas/AgentDispatch" }
+        "400": { $ref: "#/components/responses/TwirpError" }
+        "401": { $ref: "#/components/responses/TwirpError" }
+        "404": { $ref: "#/components/responses/TwirpError" }
+        "429": { $ref: "#/components/responses/TwirpError" }
+        "500": { $ref: "#/components/responses/TwirpError" }
   /twirp/livekit.RoomService/{method}:
     post:
       operationId: RoomService
@@ -35,3 +110,110 @@ paths:
       requestBody: { required: true, content: { application/json: { schema: { type: object, additionalProperties: true } } } }
       responses:
         "200": { description: Protobuf JSON response, content: { application/json: { schema: { type: object, additionalProperties: true } } } }
+components:
+  securitySchemes:
+    bearerAuth: { type: http, scheme: bearer, bearerFormat: JWT }
+  responses:
+    TwirpError:
+      description: Twirp error
+      content:
+        application/json:
+          schema: { $ref: "#/components/schemas/TwirpError" }
+  schemas:
+    TwirpError:
+      type: object
+      required: [code, msg, meta]
+      properties:
+        code: { type: string }
+        msg: { type: string }
+        meta: { type: object, additionalProperties: { type: string } }
+    RoomName: { type: string, minLength: 1, maxLength: 128 }
+    CreateDispatchRequest:
+      type: object
+      required: [room]
+      anyOf:
+        - required: [agentName]
+        - required: [agent_name]
+      properties:
+        room: { $ref: "#/components/schemas/RoomName" }
+        agentName: { type: string, minLength: 1, maxLength: 128 }
+        agent_name: { type: string, minLength: 1, maxLength: 128 }
+        metadata: { type: string, maxLength: 1024 }
+    ListDispatchRequest:
+      type: object
+      required: [room]
+      properties:
+        room: { $ref: "#/components/schemas/RoomName" }
+        dispatchId:
+          type: string
+          x-mockingbird-resource-ref: { type: agent_dispatch, missing: AD_missing }
+        dispatch_id:
+          type: string
+          x-mockingbird-resource-ref: { type: agent_dispatch, missing: AD_missing }
+    DeleteDispatchRequest:
+      allOf:
+        - $ref: "#/components/schemas/ListDispatchRequest"
+        - type: object
+          anyOf:
+            - required: [dispatchId]
+            - required: [dispatch_id]
+    AgentDispatch:
+      type: object
+      required: [id, agentName, room, metadata, state]
+      properties:
+        id:
+          type: string
+          x-mockingbird-resource: { type: agent_dispatch, identity: true }
+        agentName: { type: string }
+        room: { type: string }
+        metadata: { type: string }
+        state:
+          type: object
+          required: [jobs, createdAt, deletedAt]
+          properties:
+            createdAt:
+              type: string
+              pattern: "^[0-9]+$"
+              x-mockingbird-volatile: { kind: timestamp }
+            deletedAt:
+              type: string
+              pattern: "^[0-9]+$"
+              x-mockingbird-volatile: { kind: timestamp }
+            jobs:
+              type: array
+              items: { $ref: "#/components/schemas/AgentJob" }
+    AgentJob:
+      type: object
+      required: [id, dispatchId, type, room, metadata, agentName, state]
+      properties:
+        id: { type: string }
+        dispatchId: { type: string }
+        type: { type: string, enum: [JT_ROOM] }
+        room:
+          type: object
+          required: [sid, name, creationTime]
+          properties:
+            sid: { type: string }
+            name: { type: string }
+            creationTime: { type: string }
+        metadata: { type: string }
+        agentName: { type: string }
+        state:
+          type: object
+          required: [status, error, startedAt, endedAt, updatedAt, participantIdentity, workerId, agentId]
+          properties:
+            status: { type: string, enum: [JS_PENDING, JS_RUNNING, JS_SUCCESS, JS_FAILED] }
+            error: { type: string }
+            startedAt: { type: string }
+            endedAt: { type: string }
+            updatedAt: { type: string }
+            participantIdentity: { type: string }
+            workerId: { type: string }
+            agentId: { type: string }
+    DispatchPage:
+      type: object
+      required: [agentDispatches]
+      properties:
+        agentDispatches:
+          type: array
+          items: { $ref: "#/components/schemas/AgentDispatch" }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crvouga/mockingbird-service-livekit",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Stateful LiveKit mock with Twirp room APIs, JWT grants, participants, data, SIP/egress controls, and signed webhooks.",
   "license": "MIT",
   "type": "module",
@@ -111,6 +111,7 @@
     "@crvouga/mockingbird-sqlite": "0.0.0-development",
     "@crvouga/mockingbird-testing": "0.1.0",
     "fast-check": "4.9.0",
-    "livekit-server-sdk": "2.19.1"
+    "livekit-server-sdk": "2.19.1",
+    "livekit-reconciliation": "npm:livekit-server-sdk@2.19.0"
   }
 }