Developer

Overview

The DeveloperClient is the Room API for structured developer logs. Use it to send logs into the Developer Console and subscribe to live logs from other participants in the room.

CLI commands

Start with the CLI help, then use the main live-log command:

bash

meshagent room developer --help
meshagent room developer --room myroom

Why use the Developer API?

Debug agents, tools, and services while a room is live.
Send structured log payloads instead of plain text so downstream tools can filter or render them.
Watch a room log stream from the CLI or SDK during development.

How it works

The Developer API is event-oriented. Producers call log (or convenience helpers such as info) to emit structured events, and consumers call logs() to subscribe to the live stream.

Permissions and grants

Developer logs are controlled by the developer grant on the participant token. In practice, developer.logs enables emitting and consuming developer-log events for the room. See API Scopes and Service YAML.

Streaming Logs

logs() Opens a streamed subscription to developer logs for the room. Stop receiving logs by closing the stream or breaking iteration.

meshagent room developer \
  --room myroom

async for event in room.developer.logs():
    print(f"[{event.type}] {event.data}")

for await (const event of room.developer.logs()) {
  console.log(`[${event.type}]`, event.data);
}

for await (const event of room.developer.logs()) {
  console.log(`[${event.type}]`, event.data);
}

await for (final event in room.developer.logs()) {
  print("[${event.type}] ${event.data}");
}

await foreach (var log in room.Developer.Logs())
{
  Console.WriteLine($"[{log.Type}] {log.Data}");
}

API reference

Use the methods below to emit structured developer logs or subscribe to the live room log stream.

`log(type, data)`

Description: Emit a developer log event.
Parameters:
- type: A log category string (for example, "info" or "error").
- data: A JSON-serializable payload with any extra fields.
Returns: None

await room.developer.log(type="info", data={"message": "Hello from DeveloperClient!"})

await room.developer.log("info", { message: "Hello from DeveloperClient!" });

await room.developer.log("info", { message: "Hello from DeveloperClient!" });

await room.developer.log("info", {"message": "Hello from DeveloperClient!"});

await room.Developer.Log("info", new Dictionary<string, object?>
{
  ["message"] = "Hello from DeveloperClient!"
});

`log_nowait(type, data)`

Description: Fire-and-forget log emission without awaiting a response.
Availability: Python and .NET SDKs.
Parameters:
- type: A log category string.
- data: A JSON-serializable payload.
Returns: None

room.developer.log_nowait(type="info", data={"message": "Log without await"})

room.Developer.LogNowait("info", new Dictionary<string, object?>
{
  ["message"] = "Log without await"
});

`info(...)`, `warning(...)`, `error(...)`

Description: Convenience helpers for emitting structured logs with common severity labels.
Availability: Python and Dart SDKs.
Parameters:
- message: Human-readable text.
- extra (optional): Additional fields to include with the log.
Returns: None

room.developer.info("Background sync started", extra={"phase": "init"})
room.developer.warning("Retrying sync", extra={"attempt": 2})
room.developer.error("Sync failed", extra={"reason": "timeout"})

await room.developer.info("Background sync started", extra: {"phase": "init"});
await room.developer.warning("Retrying sync", extra: {"attempt": 2});
await room.developer.error("Sync failed", extra: {"reason": "timeout"});

`logs()`

Description: Open a streamed subscription to developer logs for the room.
Parameters: None.
Returns: A stream / async iterator of log events.

meshagent room developer \
  --room myroom

async for event in room.developer.logs():
    print(event.type, event.data)

for await (const event of room.developer.logs()) {
  console.log(event.type, event.data);
}

for await (const event of room.developer.logs()) {
  console.log(event.type, event.data);
}

await for (final event in room.developer.logs()) {
  print(event.type);
}

await foreach (var log in room.Developer.Logs())
{
  Console.WriteLine(log.Type);
}

Introduction

Rooms

Agents & Tools

Deploy & Manage

Projects

Product Interfaces

Developer Reference

Overview

CLI commands

Why use the Developer API?

How it works

Permissions and grants

Streaming Logs

API reference

`log(type, data)`

`log_nowait(type, data)`

`info(...)`, `warning(...)`, `error(...)`

`logs()`

​Overview

​CLI commands

​Why use the Developer API?

​How it works

​Permissions and grants

​Streaming Logs

​API reference

​log(type, data)

​log_nowait(type, data)

​info(...), warning(...), error(...)

​logs()

​Related guides

Overview

CLI commands

Why use the Developer API?

How it works

Permissions and grants

Streaming Logs

API reference

`log(type, data)`

`log_nowait(type, data)`

`info(...)`, `warning(...)`, `error(...)`

`logs()`

Related guides