@meshagent/meshagent 0.31.1 → 0.31.3

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [0.31.3]
+- Stability
+
+## [0.31.2]
+- Stability
+
 ## [0.31.1]
 - Stability
 

package/dist/browser/index.d.ts

@@ -10,6 +10,7 @@ export * from './developer-client';
 export * from './document';
 export * from './meshagent-client';
 export * from './messaging-client';
+export * from './memory-client';
 export * from './participant-token';
 export * from './participant';
 export * from './protocol';
@@ -22,6 +23,7 @@ export * from './room-server-client';
 export * from './runtime';
 export * from './schema';
 export * from './storage-client';
+export * from './services-client';
 export * from './secrets-client';
 export * from './stream-controller';
 export * from './sync-client';

package/dist/browser/index.js

@@ -26,6 +26,7 @@ __exportStar(require("./developer-client"), exports);
 __exportStar(require("./document"), exports);
 __exportStar(require("./meshagent-client"), exports);
 __exportStar(require("./messaging-client"), exports);
+__exportStar(require("./memory-client"), exports);
 __exportStar(require("./participant-token"), exports);
 __exportStar(require("./participant"), exports);
 __exportStar(require("./protocol"), exports);
@@ -38,6 +39,7 @@ __exportStar(require("./room-server-client"), exports);
 __exportStar(require("./runtime"), exports);
 __exportStar(require("./schema"), exports);
 __exportStar(require("./storage-client"), exports);
+__exportStar(require("./services-client"), exports);
 __exportStar(require("./secrets-client"), exports);
 __exportStar(require("./stream-controller"), exports);
 __exportStar(require("./sync-client"), exports);

package/dist/browser/memory-client.d.ts

@@ -0,0 +1,23 @@
+import { RoomClient } from "./room-client";
+export declare class MemoryClient {
+    private readonly room;
+    constructor({ room }: {
+        room: RoomClient;
+    });
+    private unexpectedResponse;
+    private invoke;
+    list(params?: {
+        namespace?: string[] | null;
+    }): Promise<string[]>;
+    create(params: {
+        name: string;
+        namespace?: string[] | null;
+        overwrite?: boolean;
+        ignoreExists?: boolean;
+    }): Promise<void>;
+    drop(params: {
+        name: string;
+        namespace?: string[] | null;
+        ignoreMissing?: boolean;
+    }): Promise<void>;
+}

package/dist/browser/memory-client.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryClient = void 0;
+const response_1 = require("./response");
+const room_server_client_1 = require("./room-server-client");
+class MemoryClient {
+    constructor({ room }) {
+        this.room = room;
+    }
+    unexpectedResponse(operation) {
+        return new room_server_client_1.RoomServerException(`unexpected return type from memory.${operation}`);
+    }
+    async invoke(operation, input) {
+        const response = await this.room.invoke({
+            toolkit: "memory",
+            tool: operation,
+            input,
+        });
+        if (response instanceof response_1.JsonContent) {
+            return response;
+        }
+        if (response instanceof response_1.EmptyContent) {
+            return null;
+        }
+        throw this.unexpectedResponse(operation);
+    }
+    async list(params) {
+        const response = await this.invoke("list", {
+            namespace: params?.namespace ?? null,
+        });
+        if (!(response instanceof response_1.JsonContent)) {
+            throw this.unexpectedResponse("list");
+        }
+        const memories = response.json["memories"];
+        if (!Array.isArray(memories)) {
+            return [];
+        }
+        return memories.filter((value) => typeof value === "string");
+    }
+    async create(params) {
+        await this.invoke("create", {
+            name: params.name,
+            namespace: params.namespace ?? null,
+            overwrite: params.overwrite ?? false,
+            ignore_exists: params.ignoreExists ?? false,
+        });
+    }
+    async drop(params) {
+        await this.invoke("drop", {
+            name: params.name,
+            namespace: params.namespace ?? null,
+            ignore_missing: params.ignoreMissing ?? false,
+        });
+    }
+}
+exports.MemoryClient = MemoryClient;

package/dist/browser/messaging-client.d.ts

@@ -21,15 +21,19 @@ export declare class MessagingClient extends EventEmitter<RoomMessageEvent> {
         room: RoomClient;
     });
     private _messageInput;
+    private _removeParticipant;
+    private _resolveMessageRecipient;
+    private _participantNotFound;
     createStream({ to, header }: {
         to: Participant;
         header: Record<string, any>;
     }): Promise<MessageStreamWriter>;
-    sendMessage({ to, type, message, attachment }: {
+    sendMessage({ to, type, message, attachment, ignoreOffline }: {
         to: Participant;
         type: string;
         message: Record<string, any>;
         attachment?: Uint8Array;
+        ignoreOffline?: boolean;
     }): Promise<void>;
     enable(onStreamAccept?: (reader: MessageStreamReader) => void): Promise<void>;
     disable(): Promise<void>;

package/dist/browser/messaging-client.js

@@ -5,6 +5,7 @@ const uuid_1 = require("uuid");
 const event_emitter_1 = require("./event-emitter");
 const participant_1 = require("./participant");
 const room_event_1 = require("./room-event");
+const room_server_client_1 = require("./room-server-client");
 const utils_1 = require("./utils");
 const stream_controller_1 = require("./stream-controller");
 const completer_1 = require("./completer");
@@ -51,6 +52,37 @@ class MessagingClient extends event_emitter_1.EventEmitter {
         }
         return input;
     }
+    _removeParticipant(participantId) {
+        const participant = this._participants[participantId];
+        if (participant === undefined) {
+            return undefined;
+        }
+        participant._setOnline(false);
+        delete this._participants[participantId];
+        for (const [streamId, reader] of Object.entries(this._streamReaders)) {
+            if (reader._to.id !== participant.id) {
+                continue;
+            }
+            reader._controller.close();
+            delete this._streamReaders[streamId];
+        }
+        return participant;
+    }
+    _resolveMessageRecipient(to) {
+        if (!(to instanceof participant_1.RemoteParticipant)) {
+            return to;
+        }
+        if (to.online === false) {
+            return null;
+        }
+        return this._participants[to.id] ?? null;
+    }
+    _participantNotFound(ignoreOffline) {
+        if (ignoreOffline) {
+            return null;
+        }
+        throw new room_server_client_1.RoomServerException("the participant was not found");
+    }
     async createStream({ to, header }) {
         const streamId = (0, uuid_1.v4)();
         const completer = new completer_1.Completer();
@@ -62,12 +94,16 @@ class MessagingClient extends event_emitter_1.EventEmitter {
         });
         return completer.fut;
     }
-    async sendMessage({ to, type, message, attachment }) {
+    async sendMessage({ to, type, message, attachment, ignoreOffline = false }) {
+        const resolvedTo = this._resolveMessageRecipient(to) ?? this._participantNotFound(ignoreOffline);
+        if (resolvedTo === null) {
+            return;
+        }
         await this.client.invoke({
             toolkit: "messaging",
             tool: "send",
             input: this._messageInput({
-                toParticipantId: to.id,
+                toParticipantId: resolvedTo.id,
                 type,
                 message,
                 attachment,
@@ -144,7 +180,7 @@ class MessagingClient extends event_emitter_1.EventEmitter {
     }
     _onParticipantEnabled(message) {
         const data = message.message;
-        const p = new participant_1.RemoteParticipant(this.client, data["id"], data["role"]);
+        const p = new participant_1.RemoteParticipant(this.client, data["id"], data["role"], true);
         for (const [k, v] of Object.entries(data["attributes"] || {})) {
             p._attributes[k] = v;
         }
@@ -162,16 +198,15 @@ class MessagingClient extends event_emitter_1.EventEmitter {
         this.emit("participant_attributes_updated", { message });
     }
     _onParticipantDisabled(message) {
-        const part = this._participants[message.message["id"]];
+        const part = this._removeParticipant(message.message["id"]);
         if (part) {
-            delete this._participants[message.message["id"]];
             this.emit("participant_removed", { message });
         }
     }
     _onMessagingEnabled(message) {
         const participants = message.message["participants"];
         for (const data of participants) {
-            const rp = new participant_1.RemoteParticipant(this.client, data["id"], data["role"]);
+            const rp = new participant_1.RemoteParticipant(this.client, data["id"], data["role"], true);
             for (const [k, v] of Object.entries(data["attributes"] || {})) {
                 rp._attributes[k] = v;
             }
@@ -197,17 +232,23 @@ class MessagingClient extends event_emitter_1.EventEmitter {
                 throw new Error("streams are not allowed by this client");
             }
             this._onStreamAcceptCallback(reader);
-            this.sendMessage({
+            void this.sendMessage({
                 to: from,
                 type: "stream.accept",
                 message: { stream_id: streamId },
+                ignoreOffline: true,
+            }).catch((error) => {
+                console.warn("unable to send stream response", error);
             });
         }
         catch (e) {
-            this.sendMessage({
+            void this.sendMessage({
                 to: from,
                 type: "stream.reject",
                 message: { stream_id: streamId, error: String(e) },
+                ignoreOffline: true,
+            }).catch((error) => {
+                console.warn("unable to send stream response", error);
             });
         }
         this._streamReaders[streamId] = reader;

package/dist/browser/participant-token.js

@@ -3,6 +3,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ParticipantToken = exports.ParticipantGrant = exports.ApiScope = exports.SecretsGrant = exports.AdminGrant = exports.DeveloperGrant = exports.ContainersGrant = exports.StorageGrant = exports.StoragePathGrant = exports.SyncGrant = exports.SyncPathGrant = exports.DatabaseGrant = exports.TableGrant = exports.MessagingGrant = exports.QueuesGrant = exports.LivekitGrant = exports.AgentsGrant = void 0;
 const jose_1 = require("jose");
 const api_keys_1 = require("./api_keys");
+function getEnvValue(name) {
+    if (typeof process === "undefined") {
+        return undefined;
+    }
+    return process.env?.[name];
+}
 class AgentsGrant {
     constructor({ registerAgent, registerPublicToolkit, registerPrivateToolkit, call, useAgents, useTools, } = {}) {
         this.registerAgent = registerAgent ?? true;
@@ -371,7 +377,7 @@ class ParticipantToken {
         let resolvedSecret = token;
         let resolvedKid = this.apiKeyId;
         let resolvedSub = this.projectId;
-        const apiKeyValue = apiKey ?? process.env.MESHAGENT_API_KEY;
+        const apiKeyValue = apiKey ?? getEnvValue("MESHAGENT_API_KEY");
         if (apiKeyValue) {
             const parsed = (0, api_keys_1.parseApiKey)(apiKeyValue);
             resolvedSecret ?? (resolvedSecret = parsed.secret);
@@ -380,7 +386,7 @@ class ParticipantToken {
         }
         let usingDefaultSecret = false;
         if (!resolvedSecret) {
-            const envSecret = process.env.MESHAGENT_SECRET;
+            const envSecret = getEnvValue("MESHAGENT_SECRET");
             if (!envSecret) {
                 throw new Error("ParticipantToken.toJwt: No secret provided. Pass `token`, `apiKey`, or set MESHAGENT_SECRET / MESHAGENT_API_KEY.");
             }

package/dist/browser/participant.d.ts

@@ -10,7 +10,9 @@ export declare abstract class Participant {
 }
 export declare class RemoteParticipant extends Participant {
     readonly role: string;
-    constructor(client: RoomClient, id: string, role: string);
+    online?: boolean;
+    constructor(client: RoomClient, id: string, role: string, online?: boolean);
+    _setOnline(online: boolean): void;
 }
 export declare class LocalParticipant extends Participant {
     constructor(client: RoomClient, id: string);

package/dist/browser/participant.js

@@ -18,9 +18,13 @@ class Participant {
 }
 exports.Participant = Participant;
 class RemoteParticipant extends Participant {
-    constructor(client, id, role) {
+    constructor(client, id, role, online) {
         super(client, id);
         this.role = role;
+        this.online = online;
+    }
+    _setOnline(online) {
+        this.online = online;
     }
 }
 exports.RemoteParticipant = RemoteParticipant;

package/dist/browser/room-client.d.ts

@@ -9,6 +9,8 @@ import { DatabaseClient } from "./database-client";
 import { AgentsClient, ToolkitDescription } from "./agent-client";
 import { SecretsClient } from "./secrets-client";
 import { ContainersClient } from "./containers-client";
+import { MemoryClient } from "./memory-client";
+import { ServicesClient } from "./services-client";
 import { RoomEvent } from "./room-event";
 import { Content } from "./response";
 interface RequestHeader {
@@ -25,6 +27,8 @@ export declare class RoomClient {
     readonly agents: AgentsClient;
     readonly secrets: SecretsClient;
     readonly containers: ContainersClient;
+    readonly memory: MemoryClient;
+    readonly services: ServicesClient;
     private _pendingRequests;
     private _ready;
     private _localParticipant;

package/dist/browser/room-client.js

@@ -14,6 +14,8 @@ const database_client_1 = require("./database-client");
 const agent_client_1 = require("./agent-client");
 const secrets_client_1 = require("./secrets-client");
 const containers_client_1 = require("./containers-client");
+const memory_client_1 = require("./memory-client");
+const services_client_1 = require("./services-client");
 const room_server_client_1 = require("./room-server-client");
 const response_1 = require("./response");
 class RoomClient {
@@ -37,6 +39,8 @@ class RoomClient {
         this.agents = new agent_client_1.AgentsClient({ room: this });
         this.secrets = new secrets_client_1.SecretsClient({ room: this });
         this.containers = new containers_client_1.ContainersClient({ room: this });
+        this.memory = new memory_client_1.MemoryClient({ room: this });
+        this.services = new services_client_1.ServicesClient({ room: this });
     }
     get localParticipant() {
         return this._localParticipant;

package/dist/browser/services-client.d.ts

@@ -0,0 +1,28 @@
+import { ServiceSpec } from "./meshagent-client";
+import { RoomClient } from "./room-client";
+export interface ServiceRuntimeState {
+    serviceId: string;
+    state: string;
+    containerId?: string;
+    restartScheduledAt?: number;
+    startedAt?: number;
+    restartCount: number;
+    lastExitCode?: number;
+    lastExitAt?: number;
+}
+export interface ListServicesResult {
+    services: ServiceSpec[];
+    serviceStates: Record<string, ServiceRuntimeState>;
+}
+export declare class ServicesClient {
+    private readonly room;
+    constructor({ room }: {
+        room: RoomClient;
+    });
+    private unexpectedResponse;
+    list(): Promise<ServiceSpec[]>;
+    listWithState(): Promise<ListServicesResult>;
+    restart(params: {
+        serviceId: string;
+    }): Promise<void>;
+}

package/dist/browser/services-client.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServicesClient = void 0;
+const response_1 = require("./response");
+const room_server_client_1 = require("./room-server-client");
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function toOptionalNumber(value) {
+    return typeof value === "number" ? value : undefined;
+}
+function toOptionalInteger(value) {
+    return typeof value === "number" && Number.isInteger(value) ? value : undefined;
+}
+function parseServiceRuntimeState(value) {
+    if (!isRecord(value) || typeof value["service_id"] !== "string") {
+        throw new room_server_client_1.RoomServerException("unexpected return type from services.list");
+    }
+    const state = value["state"];
+    const containerId = value["container_id"];
+    return {
+        serviceId: value["service_id"],
+        state: typeof state === "string" ? state : "unknown",
+        containerId: typeof containerId === "string" ? containerId : undefined,
+        restartScheduledAt: toOptionalNumber(value["restart_scheduled_at"]),
+        startedAt: toOptionalNumber(value["started_at"]),
+        restartCount: toOptionalInteger(value["restart_count"]) ?? 0,
+        lastExitCode: toOptionalInteger(value["last_exit_code"]),
+        lastExitAt: toOptionalNumber(value["last_exit_at"]),
+    };
+}
+function parseServiceSpecJson(value) {
+    if (typeof value === "string") {
+        const parsed = JSON.parse(value);
+        if (!isRecord(parsed)) {
+            throw new room_server_client_1.RoomServerException("unexpected return type from services.list");
+        }
+        return parsed;
+    }
+    if (!isRecord(value)) {
+        throw new room_server_client_1.RoomServerException("unexpected return type from services.list");
+    }
+    return value;
+}
+class ServicesClient {
+    constructor({ room }) {
+        this.room = room;
+    }
+    unexpectedResponse(operation) {
+        return new room_server_client_1.RoomServerException(`unexpected return type from services.${operation}`);
+    }
+    async list() {
+        return (await this.listWithState()).services;
+    }
+    async listWithState() {
+        const response = await this.room.invoke({
+            toolkit: "services",
+            tool: "list",
+            input: {},
+        });
+        if (!(response instanceof response_1.JsonContent)) {
+            throw this.unexpectedResponse("list");
+        }
+        const servicesRaw = response.json["services_json"];
+        const serviceStatesRaw = response.json["service_states"];
+        if (!Array.isArray(servicesRaw) || !Array.isArray(serviceStatesRaw)) {
+            throw this.unexpectedResponse("list");
+        }
+        const serviceStates = {};
+        for (const item of serviceStatesRaw) {
+            const state = parseServiceRuntimeState(item);
+            serviceStates[state.serviceId] = state;
+        }
+        return {
+            services: servicesRaw.map((item) => parseServiceSpecJson(item)),
+            serviceStates,
+        };
+    }
+    async restart(params) {
+        const response = await this.room.invoke({
+            toolkit: "services",
+            tool: "restart",
+            input: {
+                service_id: params.serviceId,
+            },
+        });
+        if (response instanceof response_1.EmptyContent || response instanceof response_1.JsonContent) {
+            return;
+        }
+        throw this.unexpectedResponse("restart");
+    }
+}
+exports.ServicesClient = ServicesClient;

package/dist/esm/index.d.ts

@@ -10,6 +10,7 @@ export * from './developer-client';
 export * from './document';
 export * from './meshagent-client';
 export * from './messaging-client';
+export * from './memory-client';
 export * from './participant-token';
 export * from './participant';
 export * from './protocol';
@@ -22,6 +23,7 @@ export * from './room-server-client';
 export * from './runtime';
 export * from './schema';
 export * from './storage-client';
+export * from './services-client';
 export * from './secrets-client';
 export * from './stream-controller';
 export * from './sync-client';

package/dist/esm/index.js

@@ -10,6 +10,7 @@ export * from './developer-client';
 export * from './document';
 export * from './meshagent-client';
 export * from './messaging-client';
+export * from './memory-client';
 export * from './participant-token';
 export * from './participant';
 export * from './protocol';
@@ -22,6 +23,7 @@ export * from './room-server-client';
 export * from './runtime';
 export * from './schema';
 export * from './storage-client';
+export * from './services-client';
 export * from './secrets-client';
 export * from './stream-controller';
 export * from './sync-client';

package/dist/esm/memory-client.d.ts

@@ -0,0 +1,23 @@
+import { RoomClient } from "./room-client";
+export declare class MemoryClient {
+    private readonly room;
+    constructor({ room }: {
+        room: RoomClient;
+    });
+    private unexpectedResponse;
+    private invoke;
+    list(params?: {
+        namespace?: string[] | null;
+    }): Promise<string[]>;
+    create(params: {
+        name: string;
+        namespace?: string[] | null;
+        overwrite?: boolean;
+        ignoreExists?: boolean;
+    }): Promise<void>;
+    drop(params: {
+        name: string;
+        namespace?: string[] | null;
+        ignoreMissing?: boolean;
+    }): Promise<void>;
+}

package/dist/esm/memory-client.js

@@ -0,0 +1,52 @@
+import { EmptyContent, JsonContent } from "./response";
+import { RoomServerException } from "./room-server-client";
+export class MemoryClient {
+    constructor({ room }) {
+        this.room = room;
+    }
+    unexpectedResponse(operation) {
+        return new RoomServerException(`unexpected return type from memory.${operation}`);
+    }
+    async invoke(operation, input) {
+        const response = await this.room.invoke({
+            toolkit: "memory",
+            tool: operation,
+            input,
+        });
+        if (response instanceof JsonContent) {
+            return response;
+        }
+        if (response instanceof EmptyContent) {
+            return null;
+        }
+        throw this.unexpectedResponse(operation);
+    }
+    async list(params) {
+        const response = await this.invoke("list", {
+            namespace: params?.namespace ?? null,
+        });
+        if (!(response instanceof JsonContent)) {
+            throw this.unexpectedResponse("list");
+        }
+        const memories = response.json["memories"];
+        if (!Array.isArray(memories)) {
+            return [];
+        }
+        return memories.filter((value) => typeof value === "string");
+    }
+    async create(params) {
+        await this.invoke("create", {
+            name: params.name,
+            namespace: params.namespace ?? null,
+            overwrite: params.overwrite ?? false,
+            ignore_exists: params.ignoreExists ?? false,
+        });
+    }
+    async drop(params) {
+        await this.invoke("drop", {
+            name: params.name,
+            namespace: params.namespace ?? null,
+            ignore_missing: params.ignoreMissing ?? false,
+        });
+    }
+}

package/dist/esm/messaging-client.d.ts

@@ -21,15 +21,19 @@ export declare class MessagingClient extends EventEmitter<RoomMessageEvent> {
         room: RoomClient;
     });
     private _messageInput;
+    private _removeParticipant;
+    private _resolveMessageRecipient;
+    private _participantNotFound;
     createStream({ to, header }: {
         to: Participant;
         header: Record<string, any>;
     }): Promise<MessageStreamWriter>;
-    sendMessage({ to, type, message, attachment }: {
+    sendMessage({ to, type, message, attachment, ignoreOffline }: {
         to: Participant;
         type: string;
         message: Record<string, any>;
         attachment?: Uint8Array;
+        ignoreOffline?: boolean;
     }): Promise<void>;
     enable(onStreamAccept?: (reader: MessageStreamReader) => void): Promise<void>;
     disable(): Promise<void>;