@stage-labs/metro 0.1.0-beta.248 → 0.1.0-beta.249

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stage-labs/metro",
-  "version": "0.1.0-beta.248",
+  "version": "0.1.0-beta.249",
   "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/marketplace/plugin/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "metro",
-  "version": "0.1.0-beta.248",
+  "version": "0.1.0-beta.249",
   "description": "Metro for Claude Code, installed by the metro daemon on this machine: every connector the agent holds as its own MCP server relayed through the daemon, the orchestrator-only guard on the main thread, and the standing rules loaded at each session start. No vendor credential ever sits in a config file.",
   "author": {
     "name": "Bonustrack",

package/runtime/marketplace/plugin/STAGE.md

@@ -18,9 +18,10 @@ Stage (https://stage.box) is a messenger built on XMTP. A Stage channel is an XM
 - 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`.
 
-**Labels and assignees.** They live in the channel's metadata, and Stage shows them on the channel.
+**Labels, assignees and category.** They live in the channel's metadata, and Stage shows them on the channel.
 - Labels: `set_channel_metadata {"line": "…", "metadata": {"labels": ["🚧 In progress", "Metro"]}}`. At most 16 labels of 24 characters each.
 - Assignees: `set_channel_metadata {"line": "…", "metadata": {"assigned": ["0x…"]}}`. Only 0x addresses of current members.
+- Category: `set_channel_metadata {"line": "…", "metadata": {"category": "Clients"}}`. One per channel, 24 characters at most; `""` clears it. `group_info` returns it as `category`.
 - Each key you send replaces that whole list. Keys you leave out stay as they are. To add one label or one assignee, read `group_info` first and send the old list plus the new one. `[]` clears a list. Read `group_info` again to check it saved.
 
 **Task status labels.** When a channel is a task, keep exactly one of these status labels, plus any project labels:

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

@@ -105,12 +105,14 @@ async function applyChannelMeta(
 
 function metaFields(merged: Record<string, unknown>): {
   labels: string[];
+  category: string | undefined;
   github: string | undefined;
   preview: string | undefined;
   assigned: unknown;
 } {
   return {
     labels: Array.isArray(merged.labels) ? (merged.labels as string[]) : [],
+    category: typeof merged.category === 'string' ? merged.category : undefined,
     github: typeof merged.github === 'string' ? merged.github : undefined,
     preview: typeof merged.preview === 'string' ? merged.preview : undefined,
     assigned: Object.hasOwn(merged, 'assigned') ? merged.assigned : [],

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

@@ -89,7 +89,7 @@ export async function buildGroupInfo(
   const gn = (conv as unknown as { name?: string | (() => Promise<string>) })
     .name;
   const resolvedName = typeof gn === 'function' ? await gn() : (gn ?? '');
-  const { labels, github, preview } = readAppData(rawAppData);
+  const { labels, category, github, preview } = readAppData(rawAppData);
   return {
     line,
     id: conv.id,
@@ -98,6 +98,7 @@ export async function buildGroupInfo(
     name: resolvedName ?? '',
     memberCount: inboxIds.length,
     labels,
+    category,
     github,
     preview,
     assigned: Object.hasOwn(appData, 'assigned') ? appData.assigned : [],

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

@@ -14,13 +14,17 @@ const MAX_LABELS = 16;
 const MAX_LABEL_LEN = 24;
 const MAX_APP_DATA_BYTES = 8192;
 
+function cleanLabel(raw: string): string {
+  return raw.trim().replace(/\s+/g, ' ').slice(0, MAX_LABEL_LEN);
+}
+
 function cleanLabels(raw: unknown): string[] {
   if (!Array.isArray(raw)) return [];
   const out: string[] = [];
   const seen = new Set<string>();
   for (const item of raw) {
     if (typeof item !== 'string') continue;
-    const label = item.trim().replace(/\s+/g, ' ').slice(0, MAX_LABEL_LEN);
+    const label = cleanLabel(item);
     const key = label.toLowerCase();
     if (!label || seen.has(key)) continue;
     seen.add(key);
@@ -70,8 +74,13 @@ function trimmedString(v: unknown): string | undefined {
   return typeof v === 'string' && v.trim() ? v.trim() : undefined;
 }
 
+function cleanCategory(v: unknown): string | undefined {
+  return typeof v === 'string' ? cleanLabel(v) || undefined : undefined;
+}
+
 export function readAppData(appData: string | undefined): {
   labels: string[];
+  category?: string;
   github?: string;
   preview?: string;
 } {
@@ -82,6 +91,7 @@ export function readAppData(appData: string | undefined): {
     const rec = p as Record<string, unknown>;
     return {
       labels: cleanLabels(rec.labels),
+      category: cleanCategory(rec.category),
       github: trimmedString(rec.github),
       preview: trimmedString(rec.preview),
     };
@@ -97,33 +107,30 @@ function checkedLabels(value: unknown): string[] {
   return cleanLabels(value);
 }
 
+function checkedCategory(value: unknown): string | undefined {
+  if (value !== undefined && value !== null && typeof value !== 'string') {
+    throw new TrainError('INVALID_ARGS', 'category must be a string or null');
+  }
+  return cleanCategory(value);
+}
+
+const KNOWN_FIELDS = new Map<string, (value: unknown) => unknown>([
+  ['labels', checkedLabels],
+  ['assigned', normalizeAssigned],
+  ['github', (value) => normalizeGithubUrl(value) || undefined],
+  ['preview', (value) => normalizePreviewUrl(value) || undefined],
+  ['category', checkedCategory],
+]);
+
 function applyMergeKey(
   merged: Record<string, unknown>,
   k: string,
   v: unknown,
 ): void {
-  if (k === 'labels') {
-    merged.labels = checkedLabels(v);
-    return;
-  }
-  if (k === 'assigned') {
-    merged.assigned = normalizeAssigned(v);
-    return;
-  }
-  if (k === 'github') {
-    const g = normalizeGithubUrl(v);
-    if (g) merged.github = g;
-    else delete merged.github;
-    return;
-  }
-  if (k === 'preview') {
-    const p = normalizePreviewUrl(v);
-    if (p) merged.preview = p;
-    else delete merged.preview;
-    return;
-  }
-  if (v === undefined || v === null) Reflect.deleteProperty(merged, k);
-  else Object.defineProperty(merged, k, { value: v, enumerable: true, configurable: true, writable: true });
+  const normalize = KNOWN_FIELDS.get(k);
+  const value = normalize ? normalize(v) : v;
+  if (value === undefined || value === null) Reflect.deleteProperty(merged, k);
+  else Object.defineProperty(merged, k, { value, enumerable: true, configurable: true, writable: true });
 }
 
 export function mergeAppData(

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

@@ -114,7 +114,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, github, preview, ' +
+      '{line, id, account, version (dm|group), name, memberCount, labels, category, 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 ' +
@@ -171,10 +171,11 @@ export const XMTP_TOOLS: StationTool[] = [
       "Update an existing channel's metadata. Args: line (required, the metro:// line), and " +
       'any of metadata? (JSON object), github? (url), preview? (url), name? (string). ' +
       '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 ' +
-      'and assigned inside metadata. assigned replaces the array with normalized lowercase ' +
+      'values replace that key, and null deletes custom keys. v is reserved. Put labels, ' +
+      'assigned and category inside metadata. assigned replaces the array with normalized lowercase ' +
       'Ethereum addresses of current members. Read group_info and union existing IDs to ' +
-      'add assignees. labels remains a legacy top-level alias. Duplicate top-level/metadata ' +
+      'add assignees. category is one string per channel (24 characters at most); "" or null ' +
+      'clears it. labels remains a legacy top-level alias. Duplicate top-level/metadata ' +
       'label/link aliases are refused. All fields use one updateChannelMeta call. xmtp-only. ' +
       'Returns updated metadata. Reread group_info to verify persistence.',
     inputSchema: {
@@ -191,6 +192,10 @@ export const XMTP_TOOLS: StationTool[] = [
               description: 'Replacement assignee list. Current member Ethereum addresses only. [] clears.',
               items: { type: 'string', pattern: '^0x[0-9a-fA-F]{40}$' },
             },
+            category: {
+              type: 'string',
+              description: 'The one category of the channel, 24 characters at most. "" clears it.',
+            },
             github: { type: 'string' },
             preview: { type: 'string' },
           },

package/runtime/runtime.json

@@ -1,3 +1,3 @@
 {
-  "version": "0.1.0-beta.248"
+  "version": "0.1.0-beta.249"
 }