@meshagent/meshagent 0.39.2 → 0.39.4

package/CHANGELOG.md

@@ -1,3 +1,13 @@
+## [0.39.4]
+- Updated the Node/TS React dev package dependency graph to the newer `@meshagent/meshagent` and `@meshagent/meshagent-react` versions (`^0.38.4`) and upgraded supporting UI dependencies (including `shadcn` `^4.5.0`, `radix-ui` `^1.4.3`, and `lucide-react` `^0.525.0`).
+- Updated build tooling in the React dev package (new `build:js` / `build:types` scripts using TS configs) to match the updated packaging workflow.
+- Added a new shadcn/radix-based Tabs component for the developer console UI.
+- Added/updated React hooks for terminal/developer-console functionality, including a WASM web terminal integration hook.
+- ESM/CJS compatibility improvements in the TS SDK bundle/entrypoint, and updated TypeScript client service-spec serialization to omit `id` when creating services.
+
+## [0.39.3]
+- Stability
+
 ## [0.39.2]
 - Aligned NodeJS/TypeScript SDK package versions and intra-SDK dependency references to `0.39.1` (from `0.39.0`), including updates to the `meshagent-docs` TypeScript example package.
 

package/README.md

@@ -2,12 +2,11 @@
 
 ## MeshAgent Typescript SDK
 
-See an example: https://github.com/meshagent/meshagent-tailwind/tree/main/example
-
 MeshAgent is your platform to create, deploy, and manage AI agents collaboratively and at scale, securely and in real time. 
 
 MeshAgent removes the infrastructure headaches of building and shipping AI Agents. It spins up secure, real-time "Rooms" that connect humans, agents, and shared context -- letting you launch, share, and refine agents in hours instead of weeks.
 
+
 ---
 
 **Documentation**: [docs.meshagent.com](https://docs.meshagent.com/)
@@ -18,26 +17,140 @@ MeshAgent removes the infrastructure headaches of building and shipping AI Agent
 
 ---
 
-## Why MeshAgent? 
-
-- **Real-time multi-user "Rooms" for true human-AI teamwork**: Secure workspaces, "Rooms", automatically spin-up when someone joins, tracking presence, chat, documents, and agent activity, and disappear when everyone leaves -- so people and agents stay in sync. 
-
-- **Accelerated feedback loop and shortened development cycle**: Invite a colleague or stakeholder into the MeshAgent Studio Room so they can see, hear, and interact with your agent immediately -- letting you demo, gather feedback, and iterate on the agent on the same day.
-
-- **Shareable links that showcase your agent**: After you deploy an agent, MeshAgent provides you a URL so colleagues or customers can jump straight into the Room, try the agent, and give feedback -- no code checkout, IDE, or GPU required. 
-
-- **Reusable and extensibly agent tools**: MeshAgent ships prebuilt, reusable toolkits for common Room interactions (e.g., file and document handling, media generation, dynamic UI interactions) and high-demand tasks (e.g., web search or document-to-Markdown conversion). Support for custom tools and the Model Context Protocol (MCP) enables you to seamlessly integrate any MCP-compatible service into a Room without changes to your applications. Tools are centrally managed like agents, allowing you to deploy them once and reuse them effortlessly.
-
-- **Built-in Observability**: Streaming logs and traces give you real-time insight into every message, agent action, and error. 
-
-- **Secure and elastic by default**: Project-scoped keys, on-demand provisioning, and auto-scaling infrastructure keep Rooms private, secure, and ready for your usage needs.
-
-- **Support across languages**: The same feature set (Rooms, Agents, Tools, Messaging, Queues, Storage, Documents, etc.) is exposed through official Python, Javascript, Typescript, and Dart SDKs, so every team member can work in their preferred language. 
-
-## Getting Setup
-
-Follow our [Getting Started Documentation](https://docs.meshagent.com/introduction/get_started) to setup your MeshAgent account, create your first project, and start building agents!
+## Get Started
+
+Install the MeshAgent CLI, connect it to your account, then run a minimal toolkit locally with the TypeScript SDK.
+
+### 1. Install the MeshAgent CLI
+
+Use the install path that matches your environment:
+
+```bash
+# macOS
+brew tap meshagent/homebrew-meshagent
+brew install meshagent
+
+# Windows
+choco install meshagent
+
+# Other platforms
+pipx install "meshagent[cli]" --include-deps
+pipx ensurepath
+```
+
+Then sign in and activate a project:
+
+```bash
+meshagent setup
+```
+
+### 2. Install the TypeScript SDK
+
+```bash
+npm install @meshagent/meshagent
+```
+
+### 3. Create `example.js`
+
+```js
+const process = require("node:process");
+
+const {
+    JsonContent,
+    RoomClient,
+    Tool,
+    Toolkit,
+    startHostedToolkit,
+} = require("@meshagent/meshagent");
+
+const inputSchema = {
+    type: "object",
+    required: ["message"],
+    additionalProperties: false,
+    properties: {
+        message: {
+            type: "string",
+            description: "Message to echo back.",
+        },
+    },
+};
+
+class EchoTool extends Tool {
+    constructor() {
+        super({
+            name: "echo",
+            title: "Echo",
+            description: "Echoes a message and adds the hosting participant name.",
+            inputSchema,
+        });
+    }
+
+    async execute({ message }) {
+        return new JsonContent({
+            json: {
+                message,
+                hostedBy: process.env.MESHAGENT_PARTICIPANT_NAME ?? "toolkit-host",
+            },
+        });
+    }
+}
+
+async function main() {
+    let room;
+    let hostedToolkit;
+
+    try {
+        room = new RoomClient();
+        await room.start();
+
+        const toolkit = new Toolkit({
+            name: "simple-echo",
+            title: "Simple Echo Toolkit",
+            description: "A minimal toolkit hosted from a Node process.",
+            tools: [new EchoTool()],
+        });
+
+        hostedToolkit = await startHostedToolkit({
+            room,
+            toolkit,
+            public_: true,
+        });
+
+        const result = await room.agents.invokeTool({
+            toolkit: "simple-echo",
+            tool: "echo",
+            arguments: {
+                message: "hello from startHostedToolkit",
+            },
+        });
+
+        if (!(result instanceof JsonContent)) {
+            throw new Error(`Expected JsonContent, got ${result.constructor.name}.`);
+        }
+
+        process.stdout.write(`${JSON.stringify(result.json, null, 2)}\n`);
+    } finally {
+        await hostedToolkit?.stop();
+        room?.dispose();
+    }
+}
+
+main().catch((error) => {
+    console.error(error);
+    process.exit(1);
+});
+```
+
+### 4. Run the example
+
+```bash
+meshagent room connect --project-id <project-id> --room <room-name> -- node example.js
+```
+
+`meshagent room connect` starts the local Node process with the MeshAgent room environment already configured, so `RoomClient()` can connect without any extra setup in your code. If you already activated a project with `meshagent setup`, you can omit `--project-id`.
 
 ## Next Steps and Examples
 
 To see examples of agents in action and to start building your own agents check out the MeshAgent docs at [docs.meshagent.com](https://docs.meshagent.com/)
+
+See an example: https://github.com/meshagent/meshagent-tailwind/tree/main/example