@stage-labs/metro 0.1.0-beta.320 → 0.1.0-beta.321

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stage-labs/metro",
-  "version": "0.1.0-beta.320",
+  "version": "0.1.0-beta.321",
   "description": "The metro command line: run your agent on this machine, relaying its chat channels and connectors to Claude Code.",
   "license": "MIT",
   "repository": {

package/runtime/node_modules/@metro-labs/daemon/src/claude/setup.ts

@@ -154,6 +154,7 @@ const PRIOR_STAGE: ReadonlySet<string> = new Set([
   'f2be51c5290d2e61b47f10c379fa45d051a59a6b3f06d99174c2a170074bc8f5',
   '4c727aa110c9023371cfb364f3304ad9db22cdf2501208ef1e42e6ccc245b00f',
   'f3901d8a4537441b1d7fe8e4073322a97b779472df6b4a8e0f2091ab5ab0ae09',
+  'af22c346df478fd249cc6931d4cf1dab4e091682e422f1bd27af0a08781e189d',
 ]);
 const PRIOR_MEMORY: ReadonlySet<string> = new Set(['08795399635c8cdec2b50cb4e336f89ae880f3997ae52560ef647a9cdc8f1b08']);
 

package/runtime/node_modules/@metro-labs/xmtp/src/actions-meta.ts

@@ -25,7 +25,11 @@ async function applyNameAndDescription(
   group: GroupLike,
   name: string | undefined,
   description: string | undefined,
+  verb: string,
 ): Promise<void> {
+  if (description !== undefined && typeof group.updateDescription !== 'function') {
+    throw new TrainError('INVALID_ARGS', `${verb} target does not support native group descriptions`);
+  }
   if (
     typeof name === 'string' &&
     name &&
@@ -88,7 +92,7 @@ async function applyChannelMeta(
     }
   }
 
-  await applyNameAndDescription(group, name, description);
+  await applyNameAndDescription(group, name, description, verb);
   const merged = await applyMergedAppData(
     group as GroupLike & { updateAppData: (s: string) => Promise<void> },
     appData,
@@ -139,6 +143,9 @@ export async function updateChannelMeta(id: string, args: Args): Promise<void> {
   if (name !== undefined && typeof name !== 'string') {
     throw new TrainError('INVALID_ARGS', 'name must be a string');
   }
+  if (description !== undefined && typeof description !== 'string') {
+    throw new TrainError('INVALID_ARGS', 'description must be a string');
+  }
   const task = () => applyChannelMeta({ line, name, description, appData }, 'updateChannelMeta');
   const previous = metadataWrites.get(key);
   const pending = previous ? previous.then(task, task) : task();

package/runtime/node_modules/@metro-labs/xmtp/src/conv-helpers.ts

@@ -100,6 +100,7 @@ export async function buildGroupInfo(
     account: acct.cfg.id,
     version: isDm ? 'dm' : 'group',
     name: resolvedName ?? '',
+    description: 'description' in conv ? conv.description : '',
     memberCount: inboxIds.length,
     labels,
     category,

package/runtime/node_modules/@metro-labs/xmtp/src/tools-handlers.ts

@@ -12,6 +12,9 @@ export const str = (v: unknown): string => (typeof v === 'string' ? v : '');
 
 function channelAppData(a: Record<string, unknown>): Record<string, unknown> {
   const appData = a.metadata === undefined ? {} : { ...metadataPatch(a.metadata) };
+  if (Object.hasOwn(appData, 'description')) {
+    throw new TrainError('INVALID_ARGS', 'Use top-level description for the native XMTP group description, not metadata.description');
+  }
   for (const key of ['labels', 'github', 'preview']) {
     if (!Object.hasOwn(a, key)) continue;
     if (Object.hasOwn(appData, key)) {
@@ -29,18 +32,23 @@ export async function setChannelMetadata(
 ) {
   const line = str(a.line);
   if (!line) return ctx.err('set_channel_metadata requires `line`');
-  if (Object.hasOwn(a, 'name') && typeof a.name !== 'string') {
-    return ctx.err('set_channel_metadata name must be a string');
-  }
+  const invalidField = ['name', 'description'].find(
+    (field) => Object.hasOwn(a, field) && typeof a[field] !== 'string',
+  );
+  if (invalidField) return ctx.err(`set_channel_metadata ${invalidField} must be a string`);
   const appData = channelAppData(a);
   const metaName = a.name;
   const hasName = typeof metaName === 'string' && metaName.length > 0;
-  if (!hasName && Object.keys(appData).length === 0)
+  const hasDescription = typeof a.description === 'string';
+  const hasAppData = Object.keys(appData).length > 0;
+  if (!hasName && !hasDescription && !hasAppData)
     return ctx.err(
-      'set_channel_metadata requires at least one of `metadata`, `github`, `preview`, `name`, `labels`',
+      'set_channel_metadata requires at least one of `metadata`, `github`, `preview`, `name`, `description`, `labels`',
     );
-  const callArgs: Record<string, unknown> = { line, appData };
+  const callArgs: Record<string, unknown> = { line };
+  if (hasAppData) callArgs.appData = appData;
   if (hasName) callArgs.name = metaName;
+  if (hasDescription) callArgs.description = a.description;
   return ctx.okJson(await ctx.call('updateChannelMeta', callArgs));
 }
 

package/runtime/node_modules/@metro-labs/xmtp/src/tools.ts

@@ -115,7 +115,7 @@ export const XMTP_TOOLS: StationTool[] = [
     group: 'read',
     description:
       "Read an XMTP channel's current metadata + membership. Args: line (required). Returns " +
-      '{line, id, account, version (dm|group), name, memberCount, labels, category, status, priority, github, preview, ' +
+      '{line, id, account, version (dm|group), name, description (native XMTP group description, empty for DMs), memberCount, labels, category, status, priority, github, preview, ' +
       'assigned, appData (stored JSON object), rawAppData (stored JSON string), ' +
       'members:[{inboxId, address}]}. Syncs first and fails if metadata cannot be read. ' +
       'xmtp-only (daemon `groupInfo`). Use before ' +
@@ -170,7 +170,9 @@ export const XMTP_TOOLS: StationTool[] = [
     group: 'write',
     description:
       "Update an existing channel's metadata. Args: line (required, the metro:// line), and " +
-      'any of metadata? (JSON object), github? (url), preview? (url), name? (string). ' +
+      'any of metadata? (JSON object), github? (url), preview? (url), name? (string), description? (string). ' +
+      'Top-level description updates the standard XMTP group description shown in Stage; "" clears it. ' +
+      'Use group_info.description for native readback. metadata.description is refused; it is not the visible description. ' +
       'metadata is a shallow appData patch: omitted keys are preserved, supplied nested ' +
       'values replace that key, and null deletes custom keys. v is reserved. Put labels, ' +
       'assigned, category, status and priority inside metadata. assigned replaces the array with normalized lowercase ' +
@@ -226,6 +228,10 @@ export const XMTP_TOOLS: StationTool[] = [
           description: 'Linked preview URL ("" to clear).',
         },
         name: { type: 'string', description: 'New channel name.' },
+        description: {
+          type: 'string',
+          description: 'Standard XMTP group description shown in Stage. "" clears it. Omit to preserve it; never put it inside metadata.',
+        },
       },
       required: ['line'],
     },

package/runtime/runtime.json

@@ -1,3 +1,3 @@
 {
-  "version": "0.1.0-beta.320"
+  "version": "0.1.0-beta.321"
 }

package/runtime/sdk-runner/runner.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.1.0-beta.320",
+  "version": "0.1.0-beta.321",
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "0.3.287",
     "@modelcontextprotocol/sdk": "^1.29.0",

package/skills/STAGE.md

@@ -11,10 +11,11 @@ Stage (https://stage.box) is a messenger built on XMTP. A Stage channel is an XM
 
 **Channels.**
 - Create: `create_group {"station": "xmtp", "name": "Launch plan", "members": ["0x…"]}`. Members are 0x addresses or XMTP inbox ids. It returns the new `line` and `id`.
-- Rename: `set_channel_metadata {"line": "…", "name": "New title"}`. No tool sets the description or the picture.
+- Rename: `set_channel_metadata {"line": "…", "name": "New title"}`. No tool sets the picture.
+- Description: `set_channel_metadata {"line": "…", "description": "What this channel is for"}` sets the standard XMTP group description shown in Stage. `""` clears it. Read `group_info.description` to check it saved. Never put it in `metadata.description`: that is not the visible description and is refused.
 - Add or remove people: `add_members {"line": "…", "members": ["0x…"]}`. `remove_members` takes the same shape.
 - Leave: `close_channel {"line": "…", "removeSelf": true}`.
-- Read: `group_info {"line": "…"}` gives the name, `labels`, `assigned`, `category`, `status`, `priority`, `appData` and the members (`inboxId`, `address`). `list_members {"line": "…"}` gives the members only.
+- Read: `group_info {"line": "…"}` gives the name, native `description`, `labels`, `assigned`, `category`, `status`, `priority`, `appData` and the members (`inboxId`, `address`). `list_members {"line": "…"}` gives the members only.
 - Direct chat: `dm {"address": "0x…"}` opens a 1:1 chat and returns its line.
 - With several XMTP accounts, add `"account": "<id>"` to `create_group` and `dm`.