@stage-labs/metro 0.1.0-beta.285 → 0.1.0-beta.286

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stage-labs/metro",
-  "version": "0.1.0-beta.285",
+  "version": "0.1.0-beta.286",
   "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.285",
+  "version": "0.1.0-beta.286",
   "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/node_modules/@metro-labs/daemon/src/mcp/frame-schema.ts

@@ -0,0 +1,40 @@
+export const frameSchema = {
+  type: 'object',
+  description:
+    'Stage (XMTP) only: a frame, a small interactive view. Stage shows it in the chat at image size ' +
+    '(400 x 400 at most, its start screen, clipped with a fade) and opens it full screen on a tap; its ' +
+    'buttons work only there. `widget` is OpenAI ChatKit widget JSON (a Card, ListView ' +
+    'or Basic root, 64K characters at most); a missing `title` or `description` is taken from the ' +
+    'widget. Or give `screens` instead of `widget` for several screens in one frame. A tap there comes back ' +
+    'to you as a reply to the frame: "Frame action: <type> <payload ' +
+    "JSON>\". It is sent after the text, and the message_id returned is the frame's. The stage " +
+    'skill lists the widget nodes, with an example.',
+  properties: {
+    widget: {
+      type: 'object',
+      description:
+        'ChatKit widget JSON, e.g. {"type":"Card","children":[{"type":"Title","value":"Deploy?"},' +
+        '{"type":"Button","label":"Ship it","onClickAction":{"type":"deploy","payload":{"env":"prod"}}}]}.',
+      additionalProperties: true,
+    },
+    screens: {
+      type: 'object',
+      description:
+        'Instead of `widget`: up to 50 screens by id, each a widget or {"title", "widget"}, 64K ' +
+        'characters in all. An action {"type":"frame.open","payload":{"screen":"<id>"}} opens a ' +
+        'screen and {"type":"frame.back"} goes back, in Stage, with no message to you.',
+      additionalProperties: true,
+    },
+    start: { type: 'string', description: 'Required with `screens`: the id of the first screen.' },
+    title: { type: 'string', description: 'Card title in the chat (200 characters at most).' },
+    description: { type: 'string', description: 'Card description in the chat (1000 characters at most).' },
+    source: {
+      type: 'object',
+      description:
+        'Optional: {"url": "https://…"}, a node URL that serves this widget live (2048 characters at most). ' +
+        'Add to dashboard on the frame then adds a live widget loaded from that URL instead of a copy.',
+      properties: { url: { type: 'string' } },
+      required: ['url'],
+    },
+  },
+} as const;

package/runtime/node_modules/@metro-labs/daemon/src/mcp/tool-schemas.ts

@@ -1,5 +1,6 @@
 import type { ToolDef } from './tool-def.js';
 import { attachmentItem, CREATE_UPLOAD_TOOL } from './attachment-schema.js';
+import { frameSchema } from './frame-schema.js';
 import { speechSchema } from './speech-schema.js';
 
 const lineProp = {
@@ -69,38 +70,7 @@ export const COMMON_TOOLS: ToolDef[] = [
           description: 'Optional files to attach.',
           items: attachmentItem,
         },
-        frame: {
-          type: 'object',
-          description:
-            'Stage (XMTP) only: a frame, a small interactive view. Stage shows it in the chat at image size ' +
-            '(400 x 400 at most, its start screen, clipped with a fade) and opens it full screen on a tap; its ' +
-            'buttons work only there. `widget` is OpenAI ChatKit widget JSON (a Card, ListView ' +
-            'or Basic root, 64K characters at most); a missing `title` or `description` is taken from the ' +
-            'widget. Or give `screens` instead of `widget` for several screens in one frame. A tap there comes back ' +
-            'to you as a reply to the frame: "Frame action: <type> <payload ' +
-            "JSON>\". It is sent after the text, and the message_id returned is the frame's. The stage " +
-            'skill lists the widget nodes, with an example.',
-          properties: {
-            widget: {
-              type: 'object',
-              description:
-                'ChatKit widget JSON, e.g. {"type":"Card","children":[{"type":"Title","value":"Deploy?"},' +
-                '{"type":"Button","label":"Ship it","onClickAction":{"type":"deploy","payload":{"env":"prod"}}}]}.',
-              additionalProperties: true,
-            },
-            screens: {
-              type: 'object',
-              description:
-                'Instead of `widget`: up to 50 screens by id, each a widget or {"title", "widget"}, 64K ' +
-                'characters in all. An action {"type":"frame.open","payload":{"screen":"<id>"}} opens a ' +
-                'screen and {"type":"frame.back"} goes back, in Stage, with no message to you.',
-              additionalProperties: true,
-            },
-            start: { type: 'string', description: 'Required with `screens`: the id of the first screen.' },
-            title: { type: 'string', description: 'Card title in the chat (200 characters at most).' },
-            description: { type: 'string', description: 'Card description in the chat (1000 characters at most).' },
-          },
-        },
+        frame: frameSchema,
         wallet: {
           type: 'object',
           description:

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

@@ -196,6 +196,7 @@ export interface FrameContent {
   widget?: Record<string, unknown>;
   screens?: Record<string, unknown>;
   start?: string;
+  source?: { url: string };
 }
 export const frameFallback = (c: FrameContent): string => {
   const head = c.title ? `Frame: ${c.title}` : 'Frame';

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

@@ -7,6 +7,7 @@ const MAX_SCREEN_ID = 120;
 const FRAME_OPEN = 'frame.open';
 const MAX_TITLE = 200;
 const MAX_DESCRIPTION = 1000;
+const MAX_SOURCE_URL = 2048;
 const SUMMARY_SCAN = 80;
 const TEXT_TYPES = new Set(['Text', 'Caption', 'Markdown']);
 
@@ -150,6 +151,16 @@ function frameBody(args: Node): FrameBody {
   return parseScreens(args.screens, args.start);
 }
 
+function sourcePart(raw: unknown): Pick<FrameContent, 'source'> {
+  if (raw === undefined) return {};
+  const url = isNode(raw) && typeof raw.url === 'string' ? raw.url.trim() : '';
+  if (url.length > MAX_SOURCE_URL)
+    throw bad(`frame source url is ${url.length} characters; the limit is ${MAX_SOURCE_URL}`);
+  if (!URL.canParse(url) || new URL(url).protocol !== 'https:')
+    throw bad('frame source must be {"url": "https://…"}, the node that serves this widget');
+  return { source: { url } };
+}
+
 export function buildFrameContent(raw: unknown): { frame: FrameContent; title: string } {
   const args = parseJson(raw, 'frame');
   if (!isNode(args))
@@ -162,6 +173,7 @@ export function buildFrameContent(raw: unknown): { frame: FrameContent; title: s
     ...(title ? { title } : {}),
     ...(description && description !== title ? { description } : {}),
     ...body.content,
+    ...sourcePart(args.source),
   };
   return { frame, title: title ?? 'Frame' };
 }

package/runtime/runtime.json

@@ -1,3 +1,3 @@
 {
-  "version": "0.1.0-beta.285"
+  "version": "0.1.0-beta.286"
 }

package/runtime/sdk-runner/runner.json

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