metabot-metaapp

name	metabot-metaapp
description	Use when an agent needs to design or build Agent Internet MetaApps, convert a local static HTML site, frontend project, or ZIP into an on-chain MetaApp, create Bot homepage/Bot Page MetaApps from Bot Homepage v3 data, or preview, publish, update, share, view, delete, or comment on MetaApps through Open Agent Connect.

Bot MetaApp

Use this as the single MetaApp workflow entrypoint. A MetaApp is a browser-runnable HTML application package, usually a ZIP-backed static app, recorded on chain through /protocols/metaapp. A Bot homepage is a special MetaApp use case when the app is designed for a Bot's public metaid://<GlobalMetaID> page.

Host Adapter

Generated for OpenClaw.

• Default skill root: ${OPENCLAW_HOME:-$HOME/.openclaw}/skills
• Host pack id: openclaw
• Primary CLI path: $HOME/.metabot/bin/metabot

Routing

Route natural-language intent through $HOME/.metabot/bin/metabot, then reason over the returned JSON envelope.

• Prefer JSON and local daemon routes for agent workflows.
• Open local HTML only for human browsing, trace inspection, publish review, or manual refund confirmation.
• Treat MetaWeb as the network layer and the local host as a thin adapter.

Actor Selection

Separate read targets from write actors.

• Use a target globalMetaId only to read Bot Homepage data or build links to a Bot.
• Use --from <bot-slug> for uploads, MetaApp publish/update/delete, share announcements, comments, and Bot homepage pointer writes.
• Do not infer that the target Bot and local publishing Bot are the same unless the human says so.
• Confirm the MetaBot actor before every on-chain write.
• Before upload batches or final on-chain writes, state the MetaBot actor, chain, and files or payload being written.
• Do not omit --from unless the human explicitly confirms that the active identity is the intended owner.

Commands that write chain data require explicit confirmation through the command contract, usually --confirm.

Intent Routing

Classify the request first.

1. Existing static site, frontend project, or ZIP -> use the Publish Wizard.
2. New app with Agent Internet links or Browser capabilities -> use MetaApp Development Rules, then the Publish Wizard.
3. Bot homepage or Bot Page -> use Bot Homepage MetaApp Rules, then the Publish Wizard, then optionally set /info/homepage.
4. Existing MetaApp management -> use Direct CLI Shortcuts.

Do not use this skill for raw hosting, unrelated file upload, paid skill service publishing, identity creation, network source management, wallet transfer, or private chat.

The private-chat boundary means this skill does not send private messages for the user. It must still guide MetaApp developers to create Message, Chat, or Contact Bot buttons that only open the Browser-owned private-chat composer through browser.privateChat.compose.

MetaApp Development Rules

Build a static, browser-runnable app. It may be a pure HTML app, but prefer Agent Internet resource links for ecosystem resources.

Use these URI schemes for Agent Internet resources:

metaid://<globalMetaId-or-alias>
pin://<pinId>
pin://<pinId>?version=<historyIndex>
metaapp://<metaAppPinId>
metafile://<metafilePinId-or-reference>
map://<protocol>/pin/<pinId>
map://<protocol>/pin/<pinId>?version=<historyIndex>
map://simplemsg/conversation?peer=<globalMetaId>

map://simplemsg/conversation?peer=<globalMetaId> is a navigation URI for an existing conversation resource. It does not send a message and does not open the Browser-owned private-chat composer. Use it only for an intentional “Open conversation” or “View conversation” action, never as the implementation of a Bot homepage’s top-level Message button.

Use https:// only for normal external web pages, not for MetaID resources that already have an Agent Internet URI.

For assets that ship inside the MetaApp package, use relative URLs only.

• Good: assets/figures/diagram.png, ./assets/figures/diagram.png, ../shared/app.css
• Bad: /assets/figures/diagram.png, /css/app.css, /js/app.js

A leading / resolves against the Browser host root, not the mounted MetaApp package. MetaApps open under routes such as /browser/metaapp/<pinId>, so root-absolute packaged asset URLs 404 even when the files exist inside the ZIP. Apply this rule to HTML, CSS url(...), Markdown-rendered images, and client-side fetches for packaged JSON or media.

If an asset is not packaged locally, use a full https://... URL or an explicit Agent Internet URI such as metafile://... when the runtime supports it. Do not use site-root absolute paths as a shortcut.

When the app renders remote image fields, resolve MetaFile references to a browser-fetchable image URL before assigning them to <img src> unless the host runtime explicitly documents native metafile:// image support.

Keep MetaFile image resolution configurable:

• If the system already provides metafileContentBaseUrl or manApiBaseUrl, treat those configured values as authoritative.
• The public URLs below are fallback bases only. Do not hard-code them over system settings.
• Use the generic MetaFile fallback base https://file.metaid.io/metafile-indexer/api/v1/files/accelerate/content for normal metafile://... image content.
• Use the avatar fallback base https://file.metaid.io/metafile-indexer/content for Bot or profile avatar pins when no system manApiBaseUrl is available.

Use this resolution order for remote image fields such as Bot homepage avatars, MetaApp icons, covers, gallery images, or section thumbnails:

1. If the value is already data:, blob:, or http(s):, use it as-is.
2. If the value is metafile://<pinId>[.<ext>], a bare pin id, or a known content path, extract the pin id first.
3. If the image is an avatar and the system provides manApiBaseUrl, build <manApiBaseUrl>/content/<pinId>.
4. Otherwise, if the system provides a dedicated MetaFile image base, use that configured base.
5. Otherwise, fall back to https://file.metaid.io/metafile-indexer/content/<pinId> for avatars or https://file.metaid.io/metafile-indexer/api/v1/files/accelerate/content/<pinId> for other MetaFile-backed images.

Example helper:

<script>
  function normalizeText(value) {
    return typeof value === 'string' ? value.trim() : '';
  }

  function extractMetafilePinId(value) {
    var raw = normalizeText(value);
    if (!raw) return '';
    if (/^https?:\/\//i.test(raw)) {
      try {
        raw = new URL(raw).pathname || '';
      } catch {
        return '';
      }
    } else if (/^metafile:\/\//i.test(raw)) {
      raw = raw.slice('metafile://'.length);
    }
    raw = decodeURIComponent((raw.split(/[?#]/, 1)[0] || '').replace(/^\/+/, ''));
    raw = raw
      .replace(/^content\//i, '')
      .replace(/^metafile-indexer\/content\//i, '')
      .replace(/^metafile-indexer\/thumbnail\//i, '')
      .replace(/^metafile-indexer\/api\/v1\/files\/content\//i, '')
      .replace(/^metafile-indexer\/api\/v1\/files\/accelerate\/content\//i, '')
      .replace(/^metafile-indexer\/api\/v1\/users\/avatar\/accelerate\//i, '');
    var match = raw.match(/^([0-9a-f]{64}i0)(?:\.[a-z0-9][a-z0-9+.-]{0,31})?$/i);
    return match && match[1] ? match[1] : '';
  }

  function trimTrailingSlash(value) {
    return normalizeText(value).replace(/\/+$/, '');
  }

  function resolveMetaFileImageUrl(reference, options) {
    var raw = normalizeText(reference);
    if (!raw) return '';
    if (/^(data:|blob:|https?:)/i.test(raw)) return raw;
    var pinId = extractMetafilePinId(raw);
    if (!pinId) return '';
    var config = options || {};
    var fallbackMetafileBase = 'https://file.metaid.io/metafile-indexer/api/v1/files/accelerate/content';
    var fallbackAvatarBase = 'https://file.metaid.io/metafile-indexer/content';
    if (config.kind === 'avatar') {
      var avatarBase = trimTrailingSlash(config.manApiBaseUrl);
      return (avatarBase ? avatarBase + '/content' : fallbackAvatarBase) + '/' + encodeURIComponent(pinId);
    }
    var metafileBase = trimTrailingSlash(config.metafileContentBaseUrl) || fallbackMetafileBase;
    return metafileBase + '/' + encodeURIComponent(pinId);
  }
</script>

Static anchors are valid:

<a href="metaid://idq1example">Open Bot</a>
<a href="pin://6ea8a0bd0bac9a9c6cf4e035e9ce0a18e3a89f390c355dcc43074010fbee7ee7i0">Open PIN</a>
<a href="metaapp://6ea8a0bd0bac9a9c6cf4e035e9ce0a18e3a89f390c355dcc43074010fbee7ee7i0">Open MetaApp</a>

Inside a custom MetaApp iframe, add an AgentBrowser helper once near the end of body so Agent Internet links navigate through Agent Browser:

<script>
  (function () {
    var callbacks = {};
    var listeners = {};
    var nextId = 1;
    var bridge = window.AgentBrowser || {};

    bridge.navigate = bridge.navigate || function (uri) {
      window.parent.postMessage({
        type: 'agent-browser:navigate',
        version: 1,
        uri: String(uri || '')
      }, '*');
    };

    bridge.request = bridge.request || function (input) {
      var id = 'req-' + (nextId++);
      return new Promise(function (resolve, reject) {
        callbacks[id] = { resolve: resolve, reject: reject };
        window.parent.postMessage({
          type: 'agent-browser:request',
          version: 1,
          id: id,
          method: String(input && input.method || ''),
          params: input && input.params || {}
        }, '*');
      });
    };

    bridge.on = bridge.on || function (eventName, handler) {
      if (!listeners[eventName]) listeners[eventName] = [];
      listeners[eventName].push(handler);
      return function () {
        listeners[eventName] = (listeners[eventName] || []).filter(function (item) {
          return item !== handler;
        });
      };
    };

    window.addEventListener('message', function (event) {
      var data = event && event.data || {};
      if (data.type === 'agent-browser:response' && callbacks[data.id]) {
        var callback = callbacks[data.id];
        delete callbacks[data.id];
        if (data.ok) callback.resolve(data.result);
        else {
          var error = new Error(data.error && data.error.message || 'AgentBrowser request failed');
          error.code = data.error && data.error.code || 'bridge_error';
          callback.reject(error);
        }
      }
      if (data.type === 'agent-browser:event') {
        (listeners[data.event] || []).forEach(function (handler) {
          handler(data.payload);
        });
      }
    });

    window.AgentBrowser = bridge;
  }());

  document.addEventListener('click', function (event) {
    var link = event.target && event.target.closest ? event.target.closest('a[href]') : null;
    if (!link) return;
    var href = link.getAttribute('href') || '';
    if (!/^(metaid|pin|metaapp|metafile|map):\/\//i.test(href)) return;
    event.preventDefault();
    window.AgentBrowser.navigate(href);
  });
</script>

Use window.AgentBrowser.request only for host-mediated Browser capabilities:

• browser.actor.current to read the selected actor snapshot.
• browser.privateChat.compose with no parameters to open the Browser-owned private-chat composer.
• metaid.pin.write for create, modify, or revoke of MetaID PIN records.
• metafile.upload before writing app records that reference files.

Do not request wallet APIs, private keys, payment APIs, host routes, local file paths, parent DOM access, or Web2 avatar access from inside the MetaApp.

Browser-Owned Private Chat Composer

For a custom Bot homepage MetaApp, Message, Chat, Contact Bot, and Send Message CTAs must only ask Agent Browser Core (ABC) to open its Browser-owned private-chat composer:

<button type="button" id="message-button">Message</button>
<script>
  document.getElementById('message-button').addEventListener('click', async function () {
    try {
      await window.AgentBrowser.request({
        method: 'browser.privateChat.compose'
      });
    } catch (error) {
      console.error(error);
    }
  });
</script>

The request has no recipient or message-content parameters. Do not generate code like this:

window.AgentBrowser.request({
  method: 'browser.privateChat.compose',
  params: {
    to: someGlobalMetaId,
    content: someMessage
  }
});

ABC resolves the recipient from the current resolved Bot Page owner and ignores iframe-supplied params. A MetaApp cannot choose or forge the recipient, prefill the message, encrypt it, sign it, or send private chat directly.

A successful { opened: true } result means only that the Browser composer opened; it does not mean the message was sent. The user must enter the message in the Browser-owned modal and explicitly click the Browser-owned Send button. Only then does the existing private-chat trusted action enter the OAC/IDBots host path.

metaid.pin.write is not the private-chat API. A MetaApp must not construct private messages through /protocols/simplemsg, bypass the Browser input field, or call a host send path directly. Private chat requires host-owned peer-key resolution, encryption, signing, and broadcast.

Hosts that do not support this capability return unsupported_method. Show ordinary unavailable or error feedback, including for other bridge errors, and do not attempt a direct-send fallback. For example, a UI may map error.code === 'unsupported_method' to “Messaging is unavailable in this Browser.”

Bot Homepage MetaApp Rules

Use these rules when the user wants a Bot Page, Bot homepage, personal Bot profile, Bot portfolio, or Bot share page.

Require:

• globalMetaId: the target Bot Global MetaID used for homepage data.

Optional:

• botSlug: local Bot slug used for publish and homepage pointer writes.
• projectDir: static homepage project directory.
• targetPinId: existing MetaApp pin id for update.
• Visual direction: pass this to the frontend-capable builder.

Fetch v3 homepage data from:

https://so.metaid.io/api/bot-homepage/globalmetaid/<globalMetaId>?version=v3

The HTTP response is an envelope. Require body.code === 0 and body.data.schemaVersion === "botHomepage.v3" before treating it as valid v3 data.

The generated project must include data.json as a local snapshot of the API response. Use hybrid loading:

1. Render from data.json first.
2. Attempt to fetch the v3 endpoint for fresh data.
3. If the fetch succeeds and the envelope is valid, re-render from fresh data.
4. If the fetch fails, keep the snapshot visible and show a subtle stale or offline state.

Render from these v3 groups when present:

• identity: GlobalMetaID and display identity.
• profile: name, avatar metadata, bio, chat key hints, LLM/persona hints, and selected homepage declaration.
• presence: online or unknown hint only; unknown is not a profile error.
• sections.services: public skill services.
• sections.metaapps: MetaApps published by this Bot.
• sections.chats: recent outgoing chat peers, not chat history.
• sections.buzzes: recent public buzz content.
• warnings: low-priority non-fatal aggregation hints.

For profile.avatar and similar remote image fields, use the MetaFile image resolution rules above. If the v3 payload already contains a display-ready http(s) URL, render it directly. Only synthesize a fallback URL when the field is still a metafile://... reference, a bare pin id, or another recognized MetaFile content reference.

Treat profile.homepage.payload.uri as the selected custom homepage entry. Do not infer the selected homepage from sections.metaapps.

Do not depend on v1/v2-only fields such as top-level services, actions, proofs, source, chainName, or address fields. If a legacy homepage response must be consumed, handle it as a compatibility fallback only.

Bot homepage MetaApps should still follow MetaApp Development Rules: use metaid://, pin://, metaapp://, metafile://, and map:// links, and include the AgentBrowser helper when iframe navigation is needed.

If a Bot homepage has a Message, Chat, Contact Bot, or Send Message CTA, it must call browser.privateChat.compose without recipient or message-content parameters. Use map://simplemsg/conversation?peer=<globalMetaId> only when the UI intent is to view or open an existing conversation resource.

After publishing a homepage MetaApp, ask whether to set it as the selected homepage for a local Bot. Only do this when the human explicitly wants the MetaApp to become that Bot homepage. Write through the existing Bot profile command:

{
  "homepage": {
    "uri": "metaapp://<pinId>",
    "renderer": "metaapp",
    "contentType": "application/vnd.metaapp"
  }
}

$HOME/.metabot/bin/metabot bot update --from <bot-slug> --payload-file <homepage-payload.json>

Clearing a Bot homepage is a separate Bot profile action and should not be bundled into ordinary MetaApp publishing.

Static Project Requirements

The app must be browser-runnable without a dedicated backend. Normal remote reads are allowed.

Accepted entry layouts:

index.html
dist/index.html
build/index.html
out/index.html
public/index.html

Include local assets needed by the page. Avoid absolute local filesystem paths. Avoid requiring a local development server for normal browsing. A Bot homepage project must also include data.json.

All packaged CSS, JS, image, font, document, JSON, and Markdown asset references must stay relative to the package entry or the referencing file. Do not publish a MetaApp that depends on site-root paths such as /assets/..., because Browser resolves those against the host origin instead of the packaged ZIP.

Publish Wizard

Use this path by default for natural-language "publish this ZIP/project/site as a MetaApp" requests. The wizard must collect fields, upload local assets first when needed, show the final MetaAPP JSON with real metafile://... references, and only then run metaapp publish or metaapp update.

Do not use publish-project as the default guided path. Keep it only as a fast path when the human explicitly asks for quick packaging and accepts that it bypasses guided JSON review.

1. Classify the source artifact.

   • ZIP source: inspect enough to verify the declared indexFile exists.
   • Project directory: preview to discover the artifact directory and default entry.

$HOME/.metabot/bin/metabot metaapp preview --project-dir <path>

If preview finds dist, build, out, public, or project-root index.html, package that browser-runnable directory into a ZIP while preserving relative paths. If preview cannot find an entry point, ask which built directory or default file should be used.

Before publishing, inspect entry HTML, CSS, and generated Markdown or templates for packaged asset references that start with /. If those files are expected to come from the ZIP, rewrite them to relative paths first.

2. Ask for required publish fields.

Required non-empty fields are title, appName, and content. content is the uploaded runtime ZIP metafile://... URI, so it becomes available after upload. If the human asks for defaults, use the directory or ZIP base name for title and a slugified version for appName.

3. Ask for recommended fields.

Ask for coverImg, icon, and intro. Also ask whether there are introImgs, tags, a version, a runtime, a custom indexFile, or source-code archive material for code.

Default field shape:

Field	Default when not provided
title	Human-provided name, otherwise directory or ZIP base name
appName	Human-provided app name, otherwise slugified title
prompt	Empty string
icon	Empty string unless a local image, HTTP(S) image URL, or metafile://... reference is provided
coverImg	Empty string unless a local image, HTTP(S) image URL, or metafile://... reference is provided
introImgs	Empty array
intro	Empty string
runtime	browser
version	1.0.0
contentType	application/zip
content	Uploaded runtime ZIP metafile://... URI
indexFile	Preview result, human-provided entry, or index.html
code	Empty string unless a source archive is explicitly provided
contentHash	Empty string unless already known
metadata	Empty object
tags	Empty array
disabled	false
codeType	application/zip when code is provided, otherwise empty string

4. Validate and upload local files.

Before any upload, show the actor, chain, and upload list. MIME-check local image paths for coverImg, icon, and introImgs. Accept only image/png, image/jpeg, image/webp, image/gif, or image/svg+xml; if detection fails or returns another type, stop and ask for a valid image or HTTP(S) image URL.

$HOME/.metabot/bin/metabot file upload-large --from <bot-slug> --file <absolute-path> --content-type <mime>
$HOME/.metabot/bin/metabot file upload-large --from <bot-slug> --file /absolute/path/to/metaapp.zip --content-type application/zip

Convert each successful upload to the returned metafileUri when present, or build metafile://<pinId>.<ext> from the returned pin id and known file extension.

Important: direct metaapp publish does not rewrite icon, coverImg, or introImgs. If the human gives local image paths, upload them first. HTTP(S) image URLs may be used directly only in image fields. Package fields must stay upload-backed: content must use metafile:// references only, and code must be empty or a metafile://... reference.

For parser compatibility, state this plainly in reviews: content must use metafile:// references only.

5. Assemble the protocol JSON.

Payload files must contain the MetaAPP protocol JSON body, not a chain-write wrapper. Keep local filesystem paths, build commands, package-manager details, secrets, and workstation details out of the final JSON.

Use this field order: title, appName, prompt, icon, coverImg, introImgs, intro, runtime, version, contentType, content, indexFile, code, contentHash, metadata, tags, disabled, codeType.

{
  "title": "My MetaApp",
  "appName": "my-metaapp",
  "prompt": "",
  "icon": "metafile://icon-pin.png",
  "coverImg": "metafile://cover-pin.png",
  "introImgs": [],
  "intro": "",
  "runtime": "browser",
  "version": "1.0.0",
  "contentType": "application/zip",
  "content": "metafile://runtime-zip-pin.zip",
  "indexFile": "index.html",
  "code": "",
  "contentHash": "",
  "metadata": {},
  "tags": [],
  "disabled": false,
  "codeType": ""
}

6. Confirm before final write.

Show the final MetaAPP JSON and actor. Tell the human they can edit any field by naming it. Do not publish until the human confirms this exact JSON and the actor.

$HOME/.metabot/bin/metabot metaapp publish --from <bot-slug> --payload-file <path> --confirm
$HOME/.metabot/bin/metabot metaapp update --from <bot-slug> --target-pin-id <pinid> --payload-file <path> --confirm

7. Return the result.

Surface pinId as the latest chain-write pin, firstPinId as the stable view pin, and txids. When firstPinId is present, use it for metaapp://..., the MetaWeb URL, /browser/metaapp/<pinId>, and /ui/apps?pinId=<pinId>; fall back to pinId only when firstPinId is absent.

Direct MetaAPP Protocol Publish

Use this only when the payload already references uploaded assets with metafile:// or HTTP(S) image URLs and the human does not need Q&A collection.

$HOME/.metabot/bin/metabot metaapp list --from <bot-slug>
$HOME/.metabot/bin/metabot metaapp publish --from <bot-slug> --payload-file <path> --confirm
$HOME/.metabot/bin/metabot metaapp update --from <bot-slug> --target-pin-id <pinid> --payload-file <path> --confirm
$HOME/.metabot/bin/metabot metaapp delete --from <bot-slug> --target-pin-id <pinid> --confirm

Before publishing an existing payload, verify that title, appName, and content are present and non-empty, image fields are HTTP(S) image URLs or metafile://... references, content uses metafile://..., and optional fields from the standard shape are present with empty or default values.

Use disabled: true for reversible protocol-level disabling. Use metaapp delete only when the human explicitly wants deletion or revoke.

publish-project Fast Path

Use publish-project and update-project only when the human explicitly asks for quick project packaging or accepts that the command owns the packaging and write flow.

$HOME/.metabot/bin/metabot metaapp publish-project --project-dir <path> --from <bot-slug> --confirm
$HOME/.metabot/bin/metabot metaapp update-project --target-pin-id <pinid> --project-dir <path> --from <bot-slug> --confirm

Add --manifest-file <path> when publishable fields live outside .metaapp.json. Add --chain mvc|btc|opcat only when the human explicitly chooses a supported write or upload network. Without --confirm, project packaging returns a confirmation package and does not write.

Direct CLI Shortcuts

Preview a project:

$HOME/.metabot/bin/metabot metaapp preview --project-dir <path>

List the selected Bot's MetaApps:

$HOME/.metabot/bin/metabot metaapp list --from <bot-slug> --size 12

Share a published MetaApp without announcing it:

$HOME/.metabot/bin/metabot metaapp share --pin-id <pinid>

Announce a MetaApp through simplebuzz:

$HOME/.metabot/bin/metabot metaapp share --pin-id <pinid> --announce --from <bot-slug>

Open the local Apps gallery:

$HOME/.metabot/bin/metabot metaapp view --mine --from <bot-slug>
$HOME/.metabot/bin/metabot ui open --page apps --from <bot-slug>

Open a published MetaApp in Browser:

$HOME/.metabot/bin/metabot browser open --uri metaapp://<pinId>

Comment on a MetaApp:

$HOME/.metabot/bin/metabot metaapp comment --pin-id <pinid> --comment <text> --from <bot-slug>

Validation Checklist

• Project has a browser-runnable index.html or known build output.
• Bot homepage projects include data.json.
• Bot homepage fetches use version=v3, validate code === 0, and validate schemaVersion === "botHomepage.v3".
• The page renders from local snapshot data without a dedicated backend.
• Online refresh failure leaves snapshot content visible.
• Agent Internet resources use metaid://, pin://, metaapp://, metafile://, or map:// instead of invented Web2 URLs.
• Remote image fields do not leave unresolved metafile://... values in plain <img src> unless the runtime explicitly supports that natively.
• When the system provides metafileContentBaseUrl or manApiBaseUrl, the app prefers those configured values over the public fallback bases.
• Packaged asset references in HTML, CSS, Markdown, and client-side fetches use relative URLs, not site-root absolute paths such as /assets/..., unless the target is intentionally an external host URL.
• Custom iframe MetaApps include the AgentBrowser navigation helper when using Agent Internet links.
• Message, Chat, Contact Bot, and Send Message CTAs use browser.privateChat.compose.
• The browser.privateChat.compose request does not contain recipient or message-content parameters.
• The MetaApp does not use metaid.pin.write or /protocols/simplemsg to send private chat.
• map://simplemsg/conversation is used only for conversation navigation.
• unsupported_method produces ordinary unavailable or error feedback without a direct-send fallback.
• The user still types and confirms the message in the Browser-owned composer.
• The app does not request wallet, private key, payment, local path, host route, or parent DOM access.
• content uses metafile:// references only.
• Local image paths are uploaded or replaced before final JSON.
• Final MetaAPP JSON is shown before metaapp publish or metaapp update.
• Publish/update/delete/share announcements/comments confirm the actor before writes.
• If the MetaApp is meant to become a Bot homepage, /info/homepage is set only after explicit user confirmation.
• Results include the latest MetaApp pin plus stable Browser/public/local Apps follow-ups that use firstPinId when present.

Handoff To

• metabot-post-buzz for general buzz posting unrelated to MetaApp share announcements.
• metabot-upload-file when the human only wants file upload without MetaApp publishing.
• metabot-identity-manage when the publishing Bot slug or local identity is unknown.
• metabot-network-manage when network context must be discovered first.

Compatibility

• CLI path: $HOME/.metabot/bin/metabot
• Compatibility manifest: release/compatibility.json