@stage-labs/metro 0.1.0-beta.257 → 0.1.0-beta.258

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stage-labs/metro",
-  "version": "0.1.0-beta.257",
+  "version": "0.1.0-beta.258",
   "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.257",
+  "version": "0.1.0-beta.258",
   "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

@@ -14,17 +14,20 @@ Stage (https://stage.box) is a messenger built on XMTP. A Stage channel is an XM
 - Rename: `set_channel_metadata {"line": "…", "name": "New title"}`. No tool sets the description or the picture.
 - 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`, `appData` and the members (`inboxId`, `address`). `list_members {"line": "…"}` gives the members only.
+- 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.
 - 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, 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.
+**Labels, assignees, category, status and priority.** They live in the channel's metadata, and Stage shows them on the channel.
+- Labels: `set_channel_metadata {"line": "…", "metadata": {"labels": ["Bug"]}}`. 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.
+- Category: `set_channel_metadata {"line": "…", "metadata": {"category": "Clients"}}`.
+- Status: `set_channel_metadata {"line": "…", "metadata": {"status": "In review"}}`.
+- Category and status are each one free-form string per channel. Both are trimmed, whitespace is collapsed, and text is truncated to 24 characters. `""` or `null` clears either field. `group_info` returns them as `category` and `status`.
+- Priority: `set_channel_metadata {"line": "…", "metadata": {"priority": "High"}}`. Exactly `Urgent`, `High`, `Medium` or `Low` after trimming surrounding whitespace; empty text or `null` clears it. `group_info` returns it as `priority`.
+- Each key you send replaces that whole value. 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:
+**Task status labels.** Keep the owner's existing workflow. For a label-based task workflow, keep exactly one of these status labels, plus any project labels:
 - `🗒️ Backlog`
 - `🎯 To-do`
 - `🚧 In progress`
@@ -34,6 +37,8 @@ Stage (https://stage.box) is a messenger built on XMTP. A Stage channel is an XM
 
 Move it from Backlog or To-do to In progress, then In review, then Done. Use Blocked while you wait on someone. To change it, read `group_info`, swap the old status for the new one in `labels`, keep the other labels, and send the whole list with `set_channel_metadata` `metadata.labels`.
 
+The separate `metadata.status` and `metadata.priority` fields are optional. Status is free-form, not limited to the label names above. Do not migrate or remove existing labels unless asked.
+
 **Messages.**
 - Send: `send {"line": "…", "text": "Hello"}`. Reply with a quote: `reply {"line": "…", "message_id": "…", "text": "…"}`.
 - React: `react {"line": "…", "message_id": "…", "emoji": "👍"}`. `unreact` takes the same shape.

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

@@ -167,6 +167,7 @@ const PRIOR_STAGE: ReadonlySet<string> = new Set([
   '08a30f5cd5cf8013ab70c1fa9e1109018c0337552296a8efe5c0cf543b284991',
   'f87e9494ea6151d140b742c1b88b4f435ae653559be641fddc2160cd24dd4e1b',
   'cb4307b016855c1a09d48bc8b3924a3080bd78b205963df3d6f20401d0486df9',
+  'f2be51c5290d2e61b47f10c379fa45d051a59a6b3f06d99174c2a170074bc8f5',
 ]);
 const PRIOR_MEMORY: ReadonlySet<string> = new Set(['08795399635c8cdec2b50cb4e336f89ae880f3997ae52560ef647a9cdc8f1b08']);
 

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

@@ -107,6 +107,8 @@ async function applyChannelMeta(
 function metaFields(merged: Record<string, unknown>): {
   labels: string[];
   category: string | undefined;
+  status: string | undefined;
+  priority: string | undefined;
   github: string | undefined;
   preview: string | undefined;
   assigned: unknown;
@@ -114,6 +116,8 @@ function metaFields(merged: Record<string, unknown>): {
   return {
     labels: Array.isArray(merged.labels) ? (merged.labels as string[]) : [],
     category: typeof merged.category === 'string' ? merged.category : undefined,
+    status: typeof merged.status === 'string' ? merged.status : undefined,
+    priority: typeof merged.priority === 'string' ? merged.priority : 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

@@ -93,7 +93,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, category, github, preview } = readAppData(rawAppData);
+  const { labels, category, status, priority, github, preview } = readAppData(rawAppData);
   return {
     line,
     id: conv.id,
@@ -103,6 +103,8 @@ export async function buildGroupInfo(
     memberCount: inboxIds.length,
     labels,
     category,
+    status,
+    priority,
     github,
     preview,
     assigned: Object.hasOwn(appData, 'assigned') ? appData.assigned : [],

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

@@ -13,6 +13,8 @@ export interface GroupLike {
 const MAX_LABELS = 16;
 const MAX_LABEL_LEN = 24;
 const MAX_APP_DATA_BYTES = 8192;
+export const PRIORITIES = ['Urgent', 'High', 'Medium', 'Low'] as const;
+type Priority = (typeof PRIORITIES)[number];
 
 function cleanLabel(raw: string): string {
   return raw.trim().replace(/\s+/g, ' ').slice(0, MAX_LABEL_LEN);
@@ -74,13 +76,19 @@ function trimmedString(v: unknown): string | undefined {
   return typeof v === 'string' && v.trim() ? v.trim() : undefined;
 }
 
-function cleanCategory(v: unknown): string | undefined {
+function cleanMetadataText(v: unknown): string | undefined {
   return typeof v === 'string' ? cleanLabel(v) || undefined : undefined;
 }
 
+function cleanPriority(value: unknown): Priority | undefined {
+  return PRIORITIES.find((priority) => priority === (typeof value === 'string' ? value.trim() : value));
+}
+
 export function readAppData(appData: string | undefined): {
   labels: string[];
   category?: string;
+  status?: string;
+  priority?: Priority;
   github?: string;
   preview?: string;
 } {
@@ -91,7 +99,9 @@ export function readAppData(appData: string | undefined): {
     const rec = p as Record<string, unknown>;
     return {
       labels: cleanLabels(rec.labels),
-      category: cleanCategory(rec.category),
+      category: cleanMetadataText(rec.category),
+      status: cleanMetadataText(rec.status),
+      priority: cleanPriority(rec.priority),
       github: trimmedString(rec.github),
       preview: trimmedString(rec.preview),
     };
@@ -107,11 +117,20 @@ function checkedLabels(value: unknown): string[] {
   return cleanLabels(value);
 }
 
-function checkedCategory(value: unknown): string | undefined {
+function checkedMetadataText(key: string, value: unknown): string | undefined {
   if (value !== undefined && value !== null && typeof value !== 'string') {
-    throw new TrainError('INVALID_ARGS', 'category must be a string or null');
+    throw new TrainError('INVALID_ARGS', `${key} must be a string or null`);
+  }
+  return cleanMetadataText(value);
+}
+
+function checkedPriority(value: unknown): Priority | undefined {
+  if (value === undefined || value === null || (typeof value === 'string' && !value.trim())) return undefined;
+  const priority = cleanPriority(value);
+  if (!priority) {
+    throw new TrainError('INVALID_ARGS', 'priority must be Urgent, High, Medium, Low, or null');
   }
-  return cleanCategory(value);
+  return priority;
 }
 
 const KNOWN_FIELDS = new Map<string, (value: unknown) => unknown>([
@@ -119,7 +138,9 @@ const KNOWN_FIELDS = new Map<string, (value: unknown) => unknown>([
   ['assigned', normalizeAssigned],
   ['github', (value) => normalizeGithubUrl(value) || undefined],
   ['preview', (value) => normalizePreviewUrl(value) || undefined],
-  ['category', checkedCategory],
+  ['category', (value) => checkedMetadataText('category', value)],
+  ['status', (value) => checkedMetadataText('status', value)],
+  ['priority', checkedPriority],
 ]);
 
 function applyMergeKey(

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

@@ -1,4 +1,5 @@
 import type { StationTool } from '@metro-labs/core/stations/types';
+import { PRIORITIES } from './labels.js';
 import {
   str,
   setChannelMetadata,
@@ -114,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, github, preview, ' +
+      '{line, id, account, version (dm|group), name, 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 ' +
@@ -172,10 +173,11 @@ export const XMTP_TOOLS: StationTool[] = [
       '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, ' +
-      'assigned and category inside metadata. assigned replaces the array with normalized lowercase ' +
+      'assigned, category, status and priority inside metadata. assigned replaces the array with normalized lowercase ' +
       'Ethereum addresses of current members. Read group_info and union existing IDs to ' +
-      '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 ' +
+      'add assignees. category and status are each one free-form string per channel, trimmed, ' +
+      'whitespace collapsed and truncated to 24 characters. priority is trimmed and must be Urgent, High, Medium or Low. ' +
+      '"" or null clears category, status or priority. 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: {
@@ -193,8 +195,17 @@ export const XMTP_TOOLS: StationTool[] = [
               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.',
+              type: ['string', 'null'],
+              description: 'One free-form category, trimmed, whitespace collapsed, truncated to 24 characters. "" or null clears it.',
+            },
+            status: {
+              type: ['string', 'null'],
+              description: 'One free-form status, trimmed, whitespace collapsed, truncated to 24 characters. "" or null clears it.',
+            },
+            priority: {
+              type: ['string', 'null'],
+              enum: [...PRIORITIES, '', null],
+              description: 'One priority: Urgent, High, Medium or Low. Surrounding whitespace is trimmed; empty or null clears it.',
             },
             github: { type: 'string' },
             preview: { type: 'string' },

package/runtime/runtime.json

@@ -1,3 +1,3 @@
 {
-  "version": "0.1.0-beta.257"
+  "version": "0.1.0-beta.258"
 }