@meshagent/meshagent 0.27.0 → 0.28.0

package/CHANGELOG.md

@@ -1,3 +1,12 @@
+## [0.28.0]
+- BREAKING: AgentChatContext and TaskContext were removed from the TypeScript agent API, and RemoteTaskRunner.ask now accepts only argument payloads.
+
+## [0.27.2]
+- Stability
+
+## [0.27.1]
+- Stability
+
 ## [0.27.0]
 - No Node.js/TypeScript source changes were introduced in this range; updates are dependency-focused.
 - Updated third-party Node dev dependency `mocha` from `^11.1.0` to `^11.3.0` across SDK packages.

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

@@ -1,44 +1,31 @@
 import { RoomClient } from "./room-client";
-import { Response } from "./response";
-export declare class AgentDescription {
-    readonly name: string;
-    readonly title: string;
-    readonly description: string;
-    readonly outputSchema?: Record<string, any>;
-    readonly inputSchema?: Record<string, any>;
-    readonly labels: string[];
-    readonly supportsTools: boolean;
-    constructor({ name, title, description, outputSchema, inputSchema, labels, supportsTools, }: {
-        name: string;
-        title: string;
-        description: string;
-        outputSchema?: Record<string, any>;
-        inputSchema?: Record<string, any>;
-        labels?: string[];
-        supportsTools: boolean;
-    });
-    toJson(): Record<string, any>;
-    static fromJson(a: Record<string, any>): AgentDescription;
-}
+import { Content } from "./response";
+import { ToolContentSpec } from "./tool-content-type";
 export declare class ToolDescription {
     title: string;
     name: string;
     description: string;
-    inputSchema: Record<string, any>;
+    inputSpec?: ToolContentSpec;
+    outputSpec?: ToolContentSpec;
     defs?: Record<string, any>;
     thumbnailUrl?: string;
     pricing?: string;
     supportsContext?: boolean;
-    constructor({ title, name, description, inputSchema, thumbnailUrl, defs, pricing, supportsContext }: {
+    constructor({ title, name, description, inputSchema, inputSpec, outputSpec, outputSchema, thumbnailUrl, defs, pricing, supportsContext }: {
         title: string;
         name: string;
         description: string;
-        inputSchema: Record<string, any>;
+        inputSchema?: Record<string, any>;
+        inputSpec?: ToolContentSpec;
+        outputSpec?: ToolContentSpec;
+        outputSchema?: Record<string, any>;
         thumbnailUrl?: string;
         defs?: Record<string, any>;
         pricing?: string;
         supportsContext?: boolean;
     });
+    get inputSchema(): Record<string, any> | undefined;
+    get outputSchema(): Record<string, any> | undefined;
 }
 export declare class ToolkitDescription {
     readonly title: string;
@@ -87,5 +74,5 @@ export declare class AgentsClient {
         toolkit: string;
         tool: string;
         arguments: Record<string, any>;
-    }): Promise<Response>;
+    }): Promise<Content>;
 }

package/dist/browser/agent-client.js

@@ -1,55 +1,57 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AgentsClient = exports.ToolkitConfiguration = exports.ToolkitDescription = exports.ToolDescription = exports.AgentDescription = void 0;
-class AgentDescription {
-    constructor({ name, title, description, outputSchema, inputSchema, labels, supportsTools, }) {
-        this.name = name;
-        this.title = title;
-        this.description = description;
-        this.outputSchema = outputSchema;
-        this.inputSchema = inputSchema;
-        this.labels = Array.isArray(labels) ? labels : [];
-        this.supportsTools = supportsTools ?? false;
-    }
-    toJson() {
-        return {
-            name: this.name,
-            title: this.title,
-            description: this.description,
-            input_schema: this.inputSchema,
-            output_schema: this.outputSchema,
-            labels: this.labels,
-            supports_tools: this.supportsTools,
-        };
-    }
-    static fromJson(a) {
-        let labels = [];
-        if (Array.isArray(a["labels"])) {
-            labels = a["labels"].filter((item) => typeof item === "string");
-        }
-        return new AgentDescription({
-            name: a["name"],
-            title: a["title"] ?? "",
-            description: a["description"] ?? "",
-            inputSchema: a["input_schema"] ?? undefined,
-            outputSchema: a["output_schema"] ?? undefined,
-            supportsTools: a["supports_tools"] === true,
-            labels,
-        });
-    }
-}
-exports.AgentDescription = AgentDescription;
+exports.AgentsClient = exports.ToolkitConfiguration = exports.ToolkitDescription = exports.ToolDescription = void 0;
+const tool_content_type_1 = require("./tool-content-type");
 class ToolDescription {
-    constructor({ title, name, description, inputSchema, thumbnailUrl, defs, pricing, supportsContext }) {
+    constructor({ title, name, description, inputSchema, inputSpec, outputSpec, outputSchema, thumbnailUrl, defs, pricing, supportsContext }) {
         this.title = title;
         this.name = name;
         this.description = description;
-        this.inputSchema = inputSchema;
+        if (inputSpec !== undefined && inputSchema !== undefined) {
+            this.inputSpec = new tool_content_type_1.ToolContentSpec({
+                types: [...inputSpec.types],
+                stream: inputSpec.stream,
+                schema: inputSchema,
+            });
+        }
+        else if (inputSpec !== undefined) {
+            this.inputSpec = inputSpec;
+        }
+        else if (inputSchema !== undefined) {
+            this.inputSpec = new tool_content_type_1.ToolContentSpec({
+                types: ["json"],
+                stream: false,
+                schema: inputSchema,
+            });
+        }
+        if (outputSpec !== undefined && outputSchema !== undefined) {
+            this.outputSpec = new tool_content_type_1.ToolContentSpec({
+                types: [...outputSpec.types],
+                stream: outputSpec.stream,
+                schema: outputSchema,
+            });
+        }
+        else if (outputSpec !== undefined) {
+            this.outputSpec = outputSpec;
+        }
+        else if (outputSchema !== undefined) {
+            this.outputSpec = new tool_content_type_1.ToolContentSpec({
+                types: ["json"],
+                stream: false,
+                schema: outputSchema,
+            });
+        }
         this.thumbnailUrl = thumbnailUrl;
         this.defs = defs;
         this.pricing = pricing;
         this.supportsContext = supportsContext ?? false;
     }
+    get inputSchema() {
+        return this.inputSpec?.schema;
+    }
+    get outputSchema() {
+        return this.outputSpec?.schema;
+    }
 }
 exports.ToolDescription = ToolDescription;
 class ToolkitDescription {
@@ -78,9 +80,12 @@ class ToolkitDescription {
                 name: tool.name,
                 title: tool.title,
                 description: tool.description,
-                input_schema: tool.inputSchema,
+                input_spec: tool.inputSpec?.toJson(),
+                output_spec: tool.outputSpec?.toJson(),
                 thumbnail_url: tool.thumbnailUrl,
                 defs: tool.defs,
+                pricing: tool.pricing,
+                supports_context: tool.supportsContext,
             })),
         };
     }
@@ -99,10 +104,13 @@ class ToolkitDescription {
                     name: tool["name"],
                     description: tool["description"],
                     inputSchema: tool["input_schema"],
+                    inputSpec: tool_content_type_1.ToolContentSpec.fromJson(tool["input_spec"]),
+                    outputSchema: tool["output_schema"],
+                    outputSpec: tool_content_type_1.ToolContentSpec.fromJson(tool["output_spec"]),
                     thumbnailUrl: tool["thumbnail_url"],
                     defs: tool["defs"],
                     pricing: tool["pricing"],
-                    supportsContext: tool["supportsContext"],
+                    supportsContext: tool["supports_context"] ?? tool["supportsContext"],
                 }));
             }
         }
@@ -115,10 +123,13 @@ class ToolkitDescription {
                     name: toolName,
                     description: tool["description"],
                     inputSchema: tool["input_schema"],
+                    inputSpec: tool_content_type_1.ToolContentSpec.fromJson(tool["input_spec"]),
+                    outputSchema: tool["output_schema"],
+                    outputSpec: tool_content_type_1.ToolContentSpec.fromJson(tool["output_spec"]),
                     thumbnailUrl: tool["thumbnail_url"],
                     defs: tool["defs"],
                     pricing: tool["pricing"],
-                    supportsContext: tool["supportsContext"],
+                    supportsContext: tool["supports_context"] ?? tool["supportsContext"],
                 }));
             }
         }
@@ -185,7 +196,15 @@ class AgentsClient {
         return toolkits;
     }
     async invokeTool(params) {
-        return await this.client.sendRequest("agent.invoke_tool", params);
+        const request = {
+            toolkit: params.toolkit,
+            tool: params.tool,
+            arguments: {
+                type: "json",
+                json: params.arguments,
+            },
+        };
+        return await this.client.sendRequest("agent.invoke_tool", request);
     }
 }
 exports.AgentsClient = AgentsClient;

package/dist/browser/agent.d.ts

@@ -1,47 +1,27 @@
 import { RoomClient } from "./room-client";
 import { RequiredToolkit } from "./requirement";
-import { Response } from "./response";
-export declare class AgentChatContext {
-    messages: Array<Record<string, any>>;
-    readonly systemRole: string;
-    constructor({ messages, systemRole }: {
-        messages?: Array<Record<string, any>>;
-        systemRole?: string;
-    });
-    appendRules(rules: string[]): void;
-    appendUserMessage(message: string): void;
-    appendUserImage(url: string): void;
-    copy(): AgentChatContext;
-    toJson(): Record<string, any>;
-    static fromJson(json: Record<string, any>): AgentChatContext;
-}
-export declare class TaskContext {
-    private readonly _jwt;
-    private readonly _chat;
-    private readonly _apiUrl;
-    constructor({ chat, jwt, api_url }: {
-        chat: AgentChatContext;
-        jwt: string;
-        api_url: string;
-    });
-    get chat(): AgentChatContext;
-    get jwt(): string;
-    get api_url(): string;
-}
+import { Content } from "./response";
+import { ToolContentSpec } from "./tool-content-type";
 export declare abstract class Tool {
     readonly name: string;
     readonly description: string;
     readonly title: string;
-    readonly inputSchema: Record<string, any>;
+    readonly inputSpec?: ToolContentSpec;
+    readonly outputSpec?: ToolContentSpec;
     readonly thumbnailUrl?: string;
-    constructor({ name, description, title, inputSchema, thumbnailUrl }: {
+    constructor({ name, description, title, inputSchema, inputSpec, outputSpec, outputSchema, thumbnailUrl }: {
         name: string;
         description: string;
         title: string;
-        inputSchema: Record<string, any>;
+        inputSchema?: Record<string, any>;
+        inputSpec?: ToolContentSpec;
+        outputSpec?: ToolContentSpec;
+        outputSchema?: Record<string, any>;
         thumbnailUrl?: string;
     });
-    abstract execute(arguments_: Record<string, any>): Promise<Response>;
+    get inputSchema(): Record<string, any> | undefined;
+    get outputSchema(): Record<string, any> | undefined;
+    abstract execute(arguments_: Record<string, any>): Promise<Content>;
 }
 export declare abstract class Toolkit {
     readonly tools: Tool[];
@@ -52,7 +32,7 @@ export declare abstract class Toolkit {
     });
     getTool(name: string): Tool;
     getTools(): Record<string, any>;
-    execute(name: string, args: Record<string, any>): Promise<Response>;
+    execute(name: string, args: Record<string, any>): Promise<Content>;
 }
 export declare abstract class RemoteToolkit extends Toolkit {
     protected readonly client: RoomClient;
@@ -96,5 +76,5 @@ export declare abstract class RemoteTaskRunner {
     });
     start(): Promise<void>;
     stop(): Promise<void>;
-    abstract ask(context: TaskContext, arguments_: Record<string, any>): Promise<Record<string, any>>;
+    abstract ask(arguments_: Record<string, any>): Promise<Record<string, any>>;
 }

package/dist/browser/agent.js

@@ -1,85 +1,56 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RemoteTaskRunner = exports.RemoteToolkit = exports.Toolkit = exports.Tool = exports.TaskContext = exports.AgentChatContext = void 0;
+exports.RemoteTaskRunner = exports.RemoteToolkit = exports.Toolkit = exports.Tool = void 0;
 const response_1 = require("./response");
+const tool_content_type_1 = require("./tool-content-type");
 const utils_1 = require("./utils");
-class AgentChatContext {
-    constructor({ messages, systemRole = "system" }) {
-        this.messages = messages ? [...messages] : [];
-        this.systemRole = systemRole;
-    }
-    appendRules(rules) {
-        let systemMessage = this.messages.find((m) => m["role"] === this.systemRole);
-        if (!systemMessage) {
-            systemMessage = { role: this.systemRole, content: "" };
-            this.messages.push(systemMessage);
-        }
-        const plan = `
-        Rules:
-            -${rules.join("\n-")}
-        `;
-        systemMessage["content"] += plan;
-    }
-    appendUserMessage(message) {
-        this.messages.push({ role: "user", content: message });
-    }
-    appendUserImage(url) {
-        this.messages.push({
-            role: "user",
-            content: [
-                {
-                    type: "image_url",
-                    image_url: { url: url, detail: "auto" },
-                },
-            ],
-        });
-    }
-    copy() {
-        const cloned = JSON.parse(JSON.stringify(this.messages));
-        return new AgentChatContext({
-            messages: cloned,
-            systemRole: this.systemRole,
-        });
-    }
-    toJson() {
-        return {
-            messages: this.messages,
-            system_role: this.systemRole,
-        };
-    }
-    static fromJson(json) {
-        return new AgentChatContext({
-            messages: json["messages"],
-            systemRole: json["system_role"] || "system",
-        });
-    }
-}
-exports.AgentChatContext = AgentChatContext;
-class TaskContext {
-    constructor({ chat, jwt, api_url }) {
-        this._jwt = jwt;
-        this._chat = chat;
-        this._apiUrl = api_url;
-    }
-    get chat() {
-        return this._chat;
-    }
-    get jwt() {
-        return this._jwt;
-    }
-    get api_url() {
-        return this._apiUrl;
-    }
-}
-exports.TaskContext = TaskContext;
 class Tool {
-    constructor({ name, description, title, inputSchema, thumbnailUrl }) {
+    constructor({ name, description, title, inputSchema, inputSpec, outputSpec, outputSchema, thumbnailUrl }) {
         this.name = name;
         this.description = description;
         this.title = title;
-        this.inputSchema = inputSchema;
+        if (inputSpec !== undefined && inputSchema !== undefined) {
+            this.inputSpec = new tool_content_type_1.ToolContentSpec({
+                types: [...inputSpec.types],
+                stream: inputSpec.stream,
+                schema: inputSchema,
+            });
+        }
+        else if (inputSpec !== undefined) {
+            this.inputSpec = inputSpec;
+        }
+        else if (inputSchema !== undefined) {
+            this.inputSpec = new tool_content_type_1.ToolContentSpec({
+                types: ["json"],
+                stream: false,
+                schema: inputSchema,
+            });
+        }
+        if (outputSpec !== undefined && outputSchema !== undefined) {
+            this.outputSpec = new tool_content_type_1.ToolContentSpec({
+                types: [...outputSpec.types],
+                stream: outputSpec.stream,
+                schema: outputSchema,
+            });
+        }
+        else if (outputSpec !== undefined) {
+            this.outputSpec = outputSpec;
+        }
+        else if (outputSchema !== undefined) {
+            this.outputSpec = new tool_content_type_1.ToolContentSpec({
+                types: ["json"],
+                stream: false,
+                schema: outputSchema,
+            });
+        }
         this.thumbnailUrl = thumbnailUrl;
     }
+    get inputSchema() {
+        return this.inputSpec?.schema;
+    }
+    get outputSchema() {
+        return this.outputSpec?.schema;
+    }
 }
 exports.Tool = Tool;
 class Toolkit {
@@ -100,7 +71,8 @@ class Toolkit {
             json[tool.name] = {
                 description: tool.description,
                 title: tool.title,
-                input_schema: tool.inputSchema,
+                input_spec: tool.inputSpec?.toJson(),
+                output_spec: tool.outputSpec?.toJson(),
                 thumbnail_url: tool.thumbnailUrl,
             };
         }
@@ -150,12 +122,32 @@ class RemoteToolkit extends Toolkit {
         try {
             const [message, _] = (0, utils_1.unpackMessage)(data);
             const toolName = message["name"];
-            const args = message["arguments"];
+            const rawArguments = message["arguments"];
+            let args;
+            if (rawArguments &&
+                typeof rawArguments === "object" &&
+                !Array.isArray(rawArguments) &&
+                "type" in rawArguments) {
+                const content = rawArguments;
+                const contentType = content["type"];
+                if (contentType === "json") {
+                    args = content["json"] ?? {};
+                }
+                else if (contentType === "empty") {
+                    args = {};
+                }
+                else {
+                    throw new Error(`tool '${toolName}' requires JSON object input, received content type '${String(contentType)}'`);
+                }
+            }
+            else {
+                args = rawArguments ?? {};
+            }
             const response = await this.execute(toolName, args);
             await this.client.protocol.send("agent.tool_call_response", response.pack(), messageId);
         }
         catch (e) {
-            const err = new response_1.ErrorResponse({ text: String(e) });
+            const err = new response_1.ErrorContent({ text: String(e) });
             await this.client.protocol.send("agent.tool_call_response", err.pack(), messageId);
         }
     }

package/dist/browser/database-client.js

@@ -69,7 +69,7 @@ class DatabaseClient {
             params,
         };
         const response = await this.room.sendRequest("database.sql", payload);
-        if (response instanceof response_1.JsonResponse) {
+        if (response instanceof response_1.JsonContent) {
             if (response?.json?.results) {
                 return response.json.results;
             }
@@ -100,7 +100,7 @@ class DatabaseClient {
             payload.vector = vector;
         }
         const response = await this.room.sendRequest("database.search", payload);
-        if (response instanceof response_1.JsonResponse) {
+        if (response instanceof response_1.JsonContent) {
             if (response?.json?.results) {
                 return response.json.results;
             }

package/dist/browser/index.d.ts

@@ -26,4 +26,5 @@ export * from './stream-controller';
 export * from './sync-client';
 export * from './api_keys';
 export * from './helpers';
+export * from './tool-content-type';
 export * from './utils';

package/dist/browser/index.js

@@ -42,4 +42,5 @@ __exportStar(require("./stream-controller"), exports);
 __exportStar(require("./sync-client"), exports);
 __exportStar(require("./api_keys"), exports);
 __exportStar(require("./helpers"), exports);
+__exportStar(require("./tool-content-type"), exports);
 __exportStar(require("./utils"), exports);

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

@@ -30,6 +30,7 @@ export interface RoomInfo {
     id: string;
     name: string;
     metadata: Record<string, unknown>;
+    annotations: Record<string, string>;
 }
 export interface ProjectRoomGrant {
     room: RoomInfo;
@@ -79,6 +80,7 @@ export interface ServiceMetadata {
 }
 export interface ContainerSpec {
     command?: string | null;
+    working_dir?: string | null;
     image: string;
     environment?: EnvironmentVariable[] | null;
     secrets?: string[];
@@ -137,6 +139,7 @@ export interface ServiceSpec {
 export interface Mailbox {
     address: string;
     room: string;
+    roomId?: string;
     queue: string;
 }
 export interface Balance {
@@ -322,10 +325,14 @@ export declare class Meshagent {
         name: string;
         ifNotExists?: boolean;
         metadata?: Record<string, unknown>;
+        annotations?: Record<string, string>;
         permissions?: Record<string, ApiScope>;
     }): Promise<RoomInfo>;
     getRoom(projectId: string, name: string): Promise<RoomInfo>;
-    updateRoom(projectId: string, roomId: string, name: string): Promise<void>;
+    updateRoom(projectId: string, roomId: string, name: string, options?: {
+        metadata?: Record<string, unknown>;
+        annotations?: Record<string, string>;
+    }): Promise<void>;
     deleteRoom(projectId: string, roomId: string): Promise<void>;
     connectRoom(projectId: string, room: string): Promise<RoomConnectionInfo>;
     createRoomGrant(params: {

package/dist/browser/meshagent-client.js

@@ -176,7 +176,7 @@ class Meshagent {
         if (!data || typeof data !== "object") {
             throw new requirement_1.RoomException("Invalid room payload");
         }
-        const { id, name, metadata } = data;
+        const { id, name, metadata, annotations } = data;
         if (typeof id !== "string" || typeof name !== "string") {
             throw new requirement_1.RoomException("Invalid room payload: missing id or name");
         }
@@ -184,6 +184,7 @@ class Meshagent {
             id,
             name,
             metadata: metadata && typeof metadata === "object" ? metadata : {},
+            annotations: annotations && typeof annotations === "object" ? annotations : {},
         };
     }
     parseProjectRoomGrant(data) {
@@ -710,11 +711,14 @@ class Meshagent {
             if (!item || typeof item !== "object") {
                 throw new requirement_1.RoomException("Invalid mailbox payload");
             }
-            const { address, room, queue } = item;
+            const { address, room, room_id, queue } = item;
             if (typeof address !== "string" || typeof room !== "string" || typeof queue !== "string") {
                 throw new requirement_1.RoomException("Invalid mailbox payload: missing fields");
             }
-            return { address, room, queue };
+            if (room_id !== undefined && typeof room_id !== "string") {
+                throw new requirement_1.RoomException("Invalid mailbox payload: invalid room_id");
+            }
+            return { address, room, roomId: room_id, queue };
         });
     }
     async deleteMailbox(projectId, address) {
@@ -839,11 +843,12 @@ class Meshagent {
         return secrets.map((item) => this.parseSecret(item));
     }
     async createRoom(params) {
-        const { projectId, name, ifNotExists = false, metadata, permissions } = params;
+        const { projectId, name, ifNotExists = false, metadata, annotations, permissions } = params;
         const payload = {
             name,
             if_not_exists: Boolean(ifNotExists),
             metadata,
+            annotations,
         };
         if (permissions) {
             const serialized = {};
@@ -865,10 +870,17 @@ class Meshagent {
         });
         return this.parseRoom(data);
     }
-    async updateRoom(projectId, roomId, name) {
+    async updateRoom(projectId, roomId, name, options = {}) {
+        const payload = { name };
+        if (options.metadata !== undefined) {
+            payload["metadata"] = options.metadata;
+        }
+        if (options.annotations !== undefined) {
+            payload["annotations"] = options.annotations;
+        }
         await this.request(`/accounts/projects/${projectId}/rooms/${roomId}`, {
             method: "PUT",
-            json: { name },
+            json: payload,
             action: "update room",
             responseType: "void",
         });

package/dist/browser/queues-client.js

@@ -36,7 +36,7 @@ class QueuesClient {
             create,
             wait,
         });
-        if (response instanceof response_1.EmptyResponse) {
+        if (response instanceof response_1.EmptyContent) {
             return null;
         }
         else {