@stage-labs/metro 0.1.0-beta.231 → 0.1.0-beta.233

package/package.json

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

@@ -1,6 +1,6 @@
 ---
 name: stage
-description: How to use Stage channels (XMTP groups, https://stage.box) through metro. Create a channel, rename it, add or remove members, set labels and assignees, read its info, and send, reply, react, unreact, delete and read messages. Works only when this agent has an XMTP account in metro.
+description: How to use Stage channels (XMTP groups, https://stage.box) through metro. Create a channel, rename it, add or remove members, set labels and assignees, read its info, and send, reply, react, unreact, delete and read messages, and post frames (interactive ChatKit widget views). Works only when this agent has an XMTP account in metro.
 ---
 
 Stage (https://stage.box) is a messenger built on XMTP. A Stage channel is an XMTP group. You use it with the metro tools below (`mcp__metro__<name>`).
@@ -40,3 +40,20 @@ Move it from Backlog or To-do to In progress, then In review, then Done. Use Blo
 - History: `read {"line": "…", "limit": 20}`.
 - Poll: `ask {"line": "…", "question": "Ship today?", "options": ["Yes", "No"]}`.
 - File: `create_upload {"name": "report.pdf"}`, run the `curl` line it returns in a shell, then `send {"line": "…", "attachments": [{"upload": "<upload_id>"}]}`. Files that are not images are refused over about 190 KiB.
+
+**Frames.** A frame is a small interactive view: a report, a choice, a form. Stage shows it in the chat as a card with a title and a description, and opens it full screen on a tap.
+- Send: `send {"line": "…", "frame": {"title": "Deploy", "description": "Version 2.4 is ready", "widget": {…}}}`. A frame goes with `send`, like a file: there is no separate tool. `title` and `description` are optional: they come from the first `Title` and text in the widget when missing. With `text` as well, the text goes first, and the `message_id` you get back is the frame's.
+- `widget` is OpenAI ChatKit widget JSON, with ChatKit's names and props (https://openai.github.io/chatkit-js/): a `Card`, `ListView` or `Basic` root, with `Row`, `Col`, `Box`, `Text`, `Title`, `Caption`, `Markdown`, `Badge`, `Icon`, `Image`, `Button`, `Divider`, `Spacer`, `Form`, `Input`, `Textarea`, `Select`, `DatePicker`, `Checkbox`, `RadioGroup` and `Table`. Images must be `https://`. Number spacing is in steps of 4px. At most 64K characters, 16 levels deep and 500 nodes. Stage shows a small notice for anything it does not know.
+- Example, the arguments of one `send`:
+  ```json
+  {"line": "…", "frame": {"widget": {"type": "Card", "children": [
+    {"type": "Title", "value": "Deploy version 2.4?"},
+    {"type": "Text", "value": "3 fixes, no migration.", "color": "secondary"},
+    {"type": "Input", "name": "note", "placeholder": "Note (optional)"},
+    {"type": "Row", "children": [
+      {"type": "Button", "label": "Deploy", "onClickAction": {"type": "deploy", "payload": {"version": "2.4"}}},
+      {"type": "Button", "label": "Not now", "color": "secondary", "onClickAction": {"type": "deploy.cancel"}}
+    ]}
+  ]}}}
+  ```
+- A tap comes back to you as a reply to the frame: `Frame action: deploy {"version":"2.4","note":"…"} (tapped "Deploy")`. The values of the fields (`Input`, `Select`, `Checkbox`, …) are added to the payload by their `name`. `Button.onClickAction`, `ListViewItem.onClickAction`, a `Card` `confirm`/`cancel` (`{"label", "action"}`) and a `Form` `onSubmitAction` send one. Answer it like any message.

package/runtime/node_modules/@metro-labs/core/src/stations/types.ts

@@ -112,6 +112,7 @@ export interface Station {
   readsProfiles?: boolean;
   readFilters?: ReadonlySet<ReadFilter>;
   approvals?: boolean;
+  sendsFrames?: boolean;
   attachmentMode: AttachmentMode;
   forget?: (accountId: string) => void;
   forgetExcept?: (keptAccountIds: readonly string[]) => void;

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

@@ -160,7 +160,11 @@ const PRIOR_METRO: ReadonlySet<string> = new Set([
   '5ce3f76d610aae91adc922d0edc6c8be1f27aa2fec4a5e3a6d6231a04fb9310b',
   'b910597d24f31fa479b130a2545f94dd23684d802d99e36b637fc57c818a33be',
 ]);
-const PRIOR_STAGE: ReadonlySet<string> = new Set(['dd7d30474765de3865ddc87c1cf3220161ded09502027cdff18597e5df0aab43']);
+const PRIOR_STAGE: ReadonlySet<string> = new Set([
+  'dd7d30474765de3865ddc87c1cf3220161ded09502027cdff18597e5df0aab43',
+  '47439ecbe661ca70471a6839ab30a963714c296ad8c14ca23c6eebc3929038cc',
+  'e3b8f9bbdb205311bc643aaf91d9d903a91204fd5b55ca949b85cdfa6fd00136',
+]);
 const PRIOR_MEMORY: ReadonlySet<string> = new Set();
 
 interface ShippedSkill {

package/runtime/node_modules/@metro-labs/daemon/src/mcp/call-tools.ts

@@ -60,6 +60,21 @@ function assertDelivered(
     );
 }
 
+const frameOf = (m: MessageArgs): Record<string, unknown> =>
+  m.a.frame === undefined ? {} : { frame: m.a.frame };
+
+const sentLabels = (m: MessageArgs, text: string | undefined): string[] => [
+  ...(text ? ['text'] : []),
+  ...(m.a.frame === undefined ? [] : ['frame']),
+];
+
+function nativeBody(m: MessageArgs, text: string | undefined, replyTo: string | undefined): Record<string, unknown> {
+  const body: Record<string, unknown> = { line: m.line, ...frameOf(m) };
+  if (text) body.text = text;
+  if (text && replyTo) body.replyTo = replyTo;
+  return body;
+}
+
 async function sendNative(
   m: MessageArgs,
   text: string | undefined,
@@ -67,16 +82,9 @@ async function sendNative(
   atts: ResolvedAttachment[],
 ): Promise<Sent> {
   const { line, ctx, station } = m;
-  const labels: string[] = [];
+  const labels = sentLabels(m, text);
   let messageId: string | undefined;
-  if (text) {
-    const response = await ctx.call(
-      'send',
-      replyTo ? { line, text, replyTo } : { line, text },
-    );
-    messageId = messageIdOf(response);
-    labels.push('text');
-  }
+  if (labels.length) messageId = messageIdOf(await ctx.call('send', nativeBody(m, text, replyTo)));
   if (!atts.length) return { labels, messageId };
   const delivered = station.sendAttachments
     ? await station.sendAttachments(line, atts, ctx)
@@ -93,7 +101,7 @@ async function sendForwarded(
   atts: ResolvedAttachment[],
 ): Promise<Sent> {
   const { line, ctx, station } = m;
-  const args: Record<string, unknown> = { line };
+  const args: Record<string, unknown> = { line, ...frameOf(m) };
   if (text) args.text = text;
   if (typeof m.a.subject === 'string' && m.a.subject.trim() !== '') args.subject = m.a.subject;
   if (replyTo) args.replyTo = replyTo;
@@ -101,8 +109,7 @@ async function sendForwarded(
   const response = await ctx.call('send', args);
   const messageId = messageIdOf(response);
   const thread = threadOf(response, line);
-  const labels: string[] = [];
-  if (text) labels.push('text');
+  const labels = sentLabels(m, text);
   if (atts.length) {
     const delivered = deliveredLabels(response);
     assertDelivered(station, delivered, atts);
@@ -116,6 +123,16 @@ const unsupported = (station: Station, atts: CanonicalAttachment[]): string =>
     .map((a) => kindOf(a.mime ?? '', a.path ?? a.url ?? a.name ?? ''))
     .join(', ')}); send a link in \`text\` instead`;
 
+const NOTHING_TO_SEND = 'send requires `text`, `attachments` or `frame`';
+
+function refusal(m: MessageArgs, text: string | undefined, requested: CanonicalAttachment[]): string | undefined {
+  if (!text && !requested.length && m.a.frame === undefined) return NOTHING_TO_SEND;
+  if (m.a.frame !== undefined && m.station.sendsFrames !== true)
+    return `${m.station.name} cannot send a frame; frames are Stage (XMTP) only`;
+  if (requested.length && m.station.attachmentMode === 'none') return unsupported(m.station, requested);
+  return undefined;
+}
+
 function noteSent(m: MessageArgs, messageId: string | undefined): void {
   if (messageId !== undefined) m.onSent?.(messageId);
 }
@@ -124,10 +141,8 @@ async function handleSend(m: MessageArgs): Promise<ToolResult> {
   const text = m.a.text as string | undefined;
   const replyTo = m.a.reply_to as string | undefined;
   const requested = (m.a.attachments as CanonicalAttachment[] | undefined) ?? [];
-  if (!text && !requested.length)
-    return errResult('send requires `text` or `attachments`');
-  if (requested.length && m.station.attachmentMode === 'none')
-    return errResult(unsupported(m.station, requested));
+  const refused = refusal(m, text, requested);
+  if (refused !== undefined) return errResult(refused);
   const atts = await resolveAttachments(requested, {
     allowed: allowedAgents(currentIdentity()),
   });
@@ -138,8 +153,7 @@ async function handleSend(m: MessageArgs): Promise<ToolResult> {
     const sent = native
       ? await sendNative(m, text, replyTo, atts)
       : await sendForwarded(m, text, replyTo, atts);
-    if (!sent.labels.length)
-      return errResult('send requires `text` or `attachments`');
+    if (!sent.labels.length) return errResult(NOTHING_TO_SEND);
     noteSent(m, sent.messageId);
     const done = withId(`sent: ${sent.labels.join(', ')}`, sent.messageId);
     return ok(sent.thread === undefined ? done : `${done} — new thread line: ${sent.thread}`);

package/runtime/node_modules/@metro-labs/daemon/src/mcp/permission-prompt.ts

@@ -37,6 +37,17 @@ function channelOf(input: Record<string, unknown>): string | undefined {
   return typeof input.station === 'string' && input.station !== '' ? input.station : undefined;
 }
 
+function argText(value: unknown): string | undefined {
+  const plain = valueText(value);
+  if (plain !== undefined || value === null || typeof value !== 'object') return plain;
+  return JSON.stringify(value);
+}
+
+function fieldText(key: string, value: unknown): string | undefined {
+  if (key === 'attachments' && Array.isArray(value)) return `${String(value.length)} file(s)`;
+  return key === 'frame' ? argText(value) : valueText(value);
+}
+
 function metroLines(tool: string, input: Record<string, unknown>): string[] {
   const lines = [`Approval needed: ${tool}`];
   const channel = channelOf(input);
@@ -44,7 +55,7 @@ function metroLines(tool: string, input: Record<string, unknown>): string[] {
   const keys = [...LEAD, ...Object.keys(input).filter((k) => !LEAD.includes(k))];
   for (const key of keys) {
     if (PLACE.has(key)) continue;
-    const text = key === 'attachments' && Array.isArray(input.attachments) ? `${String(input.attachments.length)} file(s)` : valueText(input[key]);
+    const text = fieldText(key, input[key]);
     if (text !== undefined) lines.push(`${key === 'text' ? 'Text' : key}: ${key === 'text' ? `"${shorten(text)}"` : shorten(text)}`);
   }
   return lines;
@@ -52,12 +63,6 @@ function metroLines(tool: string, input: Record<string, unknown>): string[] {
 
 const ARGS_MAX = 8;
 
-function argText(value: unknown): string | undefined {
-  const plain = valueText(value);
-  if (plain !== undefined || value === null || typeof value !== 'object') return plain;
-  return JSON.stringify(value);
-}
-
 function connectorLines(name: string, tool: string, input: Record<string, unknown> | undefined): string[] {
   const lines = [`Approval needed: ${tool}`, `Connector: ${name}`];
   const args = Object.entries(input ?? {}).flatMap(([key, value]) => {

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

@@ -34,7 +34,7 @@ export const COMMON_TOOLS: ToolDef[] = [
     group: 'write',
     description:
       'Send a message (and/or media) to a Metro conversation. Args: line, text?, reply_to?, ' +
-      'subject?, attachments?. The station is derived from the line. Outlook and Gmail: send to ' +
+      'subject?, attachments?, frame?. The station is derived from the line. Outlook and Gmail: send to ' +
       'metro://<outlook|gmail>/<account>/<email address> to start a new email (subject defaults to the ' +
       'first line of text); the result names the new thread line. Each attachment names EXACTLY ONE ' +
       'source, and the choice matters: `upload` (an `upload_id` from `create_upload`, the ' +
@@ -42,7 +42,8 @@ export const COMMON_TOOLS: ToolDef[] = [
       '`data` (base64 inline -- TINY FILES ONLY, a few KB, because the base64 has to be ' +
       'written out verbatim in the call and longer than that it corrupts); `url` (the daemon ' +
       'fetches it, so the file must already be public); `path` (resolved on the DAEMON host, ' +
-      'which is not your machine). At least one of text/attachments is required. ' +
+      'which is not your machine). Stage (XMTP) only: `frame` posts an interactive view. At least one ' +
+      'of text/attachments/frame is required. ' +
       'The success line names each attachment the station actually delivered; a station that ' +
       'cannot carry a file errors instead of reporting success.',
     inputSchema: {
@@ -66,6 +67,28 @@ 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 that Stage shows as a card (title and ' +
+            'description) and opens full screen. `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. A tap 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,
+            },
+            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).' },
+          },
+          required: ['widget'],
+        },
       },
       required: ['line'],
     },

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

@@ -12,7 +12,8 @@ import {
 import { convOf, type Account } from './accounts.js';
 import { resolveMsgId } from './wire.js';
 import { emitOutbound } from './emit.js';
-import { PollCodec, buildPollContent, encodeDeleteMessage } from './codecs.js';
+import { FrameCodec, PollCodec, buildPollContent, encodeDeleteMessage } from './codecs.js';
+import { buildFrameContent } from './frames.js';
 import { convHandlers } from './actions-conv.js';
 import { messagingAliases } from '@metro-labs/core/stations/messaging-normalize';
 import { TrainError } from '@metro-labs/core/train-error';
@@ -30,10 +31,18 @@ const badArgs = (message: string): TrainError =>
 
 async function send(id: string, args: Args): Promise<void> {
   const { line, text } = args as { line: string; text: string };
+  const built = args.frame === undefined ? undefined : buildFrameContent(args.frame);
   const { acct, conv } = await convOf(line);
   if (!conv) throw noConv(line);
-  const messageId = await conv.sendText(text);
-  emitOutbound(acct.cfg.id, line, messageId, text);
+  let messageId: string | undefined;
+  if (text || !built) {
+    messageId = await conv.sendText(text);
+    emitOutbound(acct.cfg.id, line, messageId, text);
+  }
+  if (built) {
+    messageId = await conv.send(new FrameCodec().encode(built.frame));
+    emitOutbound(acct.cfg.id, line, messageId, `Frame: ${built.title}`);
+  }
   respond(id, { result: { messageId } });
 }
 

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

@@ -164,6 +164,40 @@ export const SignatureReferenceCodec =
     c.signature ? `[Signature] ${c.signature}` : '[Signature]',
   );
 
+export const ContentTypeFrame: ContentTypeId = {
+  authorityId: 'stage.box',
+  typeId: 'frame',
+  versionMajor: 1,
+  versionMinor: 0,
+};
+export interface FrameContent {
+  title?: string;
+  description?: string;
+  widget: Record<string, unknown>;
+}
+export const frameFallback = (c: FrameContent): string => {
+  const head = c.title ? `Frame: ${c.title}` : 'Frame';
+  return c.description ? `${head}\n${c.description}` : head;
+};
+export const FrameCodec = makeJsonCodec<FrameContent>(ContentTypeFrame, frameFallback);
+
+export const ContentTypeFrameAction: ContentTypeId = {
+  authorityId: 'stage.box',
+  typeId: 'frameAction',
+  versionMajor: 1,
+  versionMinor: 0,
+};
+export interface FrameActionContent {
+  frameId: string;
+  action: { type: string; payload?: Record<string, unknown> };
+  label?: string;
+}
+export const frameActionText = (c: FrameActionContent): string => {
+  const payload = c.action.payload === undefined ? '' : ` ${JSON.stringify(c.action.payload)}`;
+  return `Frame action: ${c.action.type}${payload}`;
+};
+const FrameActionCodec = makeJsonCodec<FrameActionContent>(ContentTypeFrameAction, frameActionText);
+
 const ContentTypeDeleteMessage: ContentTypeId = {
   authorityId: 'xmtp.org',
   typeId: 'deleteMessage',
@@ -195,4 +229,6 @@ export const CODECS = (): ContentCodec[] => [
   new PollCodec(),
   new SignatureRequestCodec(),
   new SignatureReferenceCodec(),
+  new FrameCodec(),
+  new FrameActionCodec(),
 ];

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

@@ -9,6 +9,8 @@ import {
 } from './attachments.js';
 import { reportAttachment } from '@metro-labs/core/stations/train-events';
 import { sentByMe } from './wire.js';
+import { frameActionText, frameFallback, type FrameContent } from './codecs.js';
+import { asFrameAction } from './frames.js';
 
 export interface EnvelopeCtx {
   accountId: string;
@@ -300,6 +302,32 @@ function refEnvelope(
   return undefined;
 }
 
+function frameEnvelope(
+  base: Record<string, unknown>,
+  typeId: string,
+  c: object,
+): Record<string, unknown> | undefined {
+  if (typeId === 'frame') {
+    const f = c as Partial<FrameContent>;
+    const frame: FrameContent = {
+      ...(typeof f.title === 'string' ? { title: f.title } : {}),
+      ...(typeof f.description === 'string' ? { description: f.description } : {}),
+      widget: typeof f.widget === 'object' && f.widget !== null ? f.widget : {},
+    };
+    return { ...base, text: frameFallback(frame), payload: { contentType: typeId, frame: c } };
+  }
+  const a = typeId === 'frameAction' ? asFrameAction(c) : undefined;
+  if (!a) return undefined;
+  const label = a.label ? ` (tapped "${a.label}")` : '';
+  return {
+    ...base,
+    text: `${frameActionText(a)}${label}`,
+    event: { type: 'reply', replyTo: a.frameId },
+    ...(sentByMe(a.frameId) ? { reply_to_self: true } : {}),
+    payload: { contentType: typeId, frameAction: a, replyTo: a.frameId },
+  };
+}
+
 export function typedEnvelope(
   base: Record<string, unknown>,
   typeId: string | undefined,
@@ -311,6 +339,7 @@ export function typedEnvelope(
   if (typeId === 'poll') return pollPayload(base, typeId, c);
   return (
     attachmentEnvelope(base, typeId ?? '', c, ctx) ??
-    refEnvelope(base, typeId, c)
+    refEnvelope(base, typeId, c) ??
+    frameEnvelope(base, typeId ?? '', c)
   );
 }

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

@@ -0,0 +1,99 @@
+import { TrainError } from '@metro-labs/core/train-error';
+import type { FrameActionContent, FrameContent } from './codecs.js';
+
+export const FRAME_MAX_CHARS = 64 * 1024;
+const MAX_TITLE = 200;
+const MAX_DESCRIPTION = 1000;
+const SUMMARY_SCAN = 80;
+const TEXT_TYPES = new Set(['Text', 'Caption', 'Markdown']);
+
+type Node = Record<string, unknown>;
+
+const isNode = (v: unknown): v is Node =>
+  typeof v === 'object' && v !== null && !Array.isArray(v);
+
+const bad = (message: string): TrainError => new TrainError('INVALID_ARGS', message);
+
+function plain(value: unknown): string {
+  if (typeof value !== 'string') return '';
+  return value
+    .replace(/!?\[([^\]]*)\]\([^)]*\)/g, '$1')
+    .replace(/^\s*(?:#{1,6}|>)\s*/gm, '')
+    .replace(/[*_`~]/g, '')
+    .replace(/\s+/g, ' ')
+    .trim();
+}
+
+function childrenOf(node: Node): Node[] {
+  const c = node.children;
+  if (Array.isArray(c)) return c.filter(isNode);
+  return isNode(c) ? [c] : [];
+}
+
+export function frameSummary(widget: Node): { title?: string; description?: string } {
+  const titles: string[] = [];
+  const texts: string[] = [];
+  const stack: Node[] = [widget];
+  for (let seen = 0; stack.length > 0 && seen < SUMMARY_SCAN; seen += 1) {
+    const node = stack.pop();
+    if (!node) break;
+    const value = plain(node.value);
+    if (node.type === 'Title' && value) titles.push(value);
+    if (typeof node.type === 'string' && TEXT_TYPES.has(node.type) && value) texts.push(value);
+    stack.push(...childrenOf(node).reverse());
+  }
+  const title = titles[0] ?? texts[0];
+  return { title, description: texts.find((t) => t !== title) };
+}
+
+function clip(value: unknown, max: number, name: string): string | undefined {
+  if (value === undefined) return undefined;
+  if (typeof value !== 'string') throw bad(`frame ${name} must be a string`);
+  const out = value.trim().slice(0, max);
+  return out === '' ? undefined : out;
+}
+
+function parseJson(raw: unknown, name: string): unknown {
+  if (typeof raw !== 'string') return raw;
+  try {
+    return JSON.parse(raw);
+  } catch {
+    throw bad(`${name} is not valid JSON`);
+  }
+}
+
+function parseWidget(raw: unknown): Node {
+  const widget = parseJson(raw, 'frame widget');
+  if (!isNode(widget) || typeof widget.type !== 'string' || widget.type === '')
+    throw bad('frame widget must be a ChatKit widget object with a `type` (Card, ListView or Basic)');
+  const chars = JSON.stringify(widget).length;
+  if (chars > FRAME_MAX_CHARS)
+    throw bad(`frame widget is ${chars} characters; the limit is ${FRAME_MAX_CHARS}`);
+  return widget;
+}
+
+export function buildFrameContent(raw: unknown): { frame: FrameContent; title: string } {
+  const args = parseJson(raw, 'frame');
+  if (!isNode(args)) throw bad('frame must be an object: {widget, title?, description?}');
+  const widget = parseWidget(args.widget);
+  const derived = frameSummary(widget);
+  const title = clip(args.title, MAX_TITLE, 'title') ?? derived.title?.slice(0, MAX_TITLE);
+  const description = clip(args.description, MAX_DESCRIPTION, 'description') ?? derived.description?.slice(0, MAX_DESCRIPTION);
+  const frame: FrameContent = {
+    ...(title ? { title } : {}),
+    ...(description && description !== title ? { description } : {}),
+    widget,
+  };
+  return { frame, title: title ?? 'Frame' };
+}
+
+export function asFrameAction(c: object): FrameActionContent | undefined {
+  const v = c as Partial<FrameActionContent>;
+  if (typeof v.frameId !== 'string' || !isNode(v.action) || typeof v.action.type !== 'string') return undefined;
+  const payload = isNode(v.action.payload) ? v.action.payload : undefined;
+  return {
+    frameId: v.frameId,
+    action: payload ? { type: v.action.type, payload } : { type: v.action.type },
+    ...(typeof v.label === 'string' && v.label ? { label: v.label } : {}),
+  };
+}

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

@@ -13,6 +13,7 @@ export const xmtpStation: Station = {
   readsProfiles: true,
   resolvesSenders: true,
   claimsName: true,
+  sendsFrames: true,
   sendAttachments: xmtpSendAttachments,
   tools: XMTP_TOOLS,
 };

package/runtime/runtime.json

@@ -1,3 +1,3 @@
 {
-  "version": "0.1.0-beta.231"
+  "version": "0.1.0-beta.233"
 }