@parall/daemon 1.52.1 → 1.53.0

package/bundle/parall-claude-agent.js

@@ -51511,6 +51511,8 @@ var ENDPOINTS = {
   SLACK_HISTORY: (orgId) => `${API_BASE}/orgs/${orgId}/agents/me/slack/history`,
   SLACK_MEMBERS: (orgId) => `${API_BASE}/orgs/${orgId}/agents/me/slack/members`,
   SLACK_STATUS: (orgId) => `${API_BASE}/orgs/${orgId}/agents/me/slack/status`,
+  // WeChat tier-B read verb (agent-only; internal research preview).
+  WECHAT_CONTACTS: (orgId) => `${API_BASE}/orgs/${orgId}/agents/me/wechat/contacts`,
   // Invitations (org-scoped, admin)
   ORG_INVITATIONS: (orgId) => `${API_BASE}/orgs/${orgId}/invitations`,
   ORG_INVITATION: (orgId, invId) => `${API_BASE}/orgs/${orgId}/invitations/${invId}`,
@@ -51672,8 +51674,6 @@ var ENDPOINTS = {
   // Live viewer command — on api-server (API_BASE), not clip-service: it rides
   // the machine control-plane request/reply bridge that lives in api-server.
   BROWSER_PROFILE_VIEWER_COMMAND: (orgId, profileId) => `${API_BASE}/orgs/${orgId}/browser-profiles/${profileId}/viewer/command`,
-  // Clip registry (global, served by clip-service → Pinix Hub proxy)
-  CLIP_REGISTRY: () => `${CLIP_BASE}/registry/clips`,
   // Edge device endpoints
   ORG_EDGE: (orgId) => `/api/v1/orgs/${orgId}/edge`,
   ORG_EDGE_DEVICES: (orgId) => `/api/v1/orgs/${orgId}/edge/devices`,
@@ -51690,15 +51690,20 @@ var ENDPOINTS = {
   ORG_EDGE_VIEWER_COMMAND: (orgId, edgeId) => `/api/v1/orgs/${orgId}/edge/${edgeId}/viewer/command`,
   CLIP_CONNECTIONS: (orgId, clipId) => `/api/v1/orgs/${orgId}/clip-registry/${clipId}/connections`,
   CLIP_CONNECTION: (orgId, connId) => `/api/v1/orgs/${orgId}/clip-connections/${connId}`,
-  // Clip registry (v3, org-scoped, served by api-server — `crg_` entries; the
-  // Pinix Hub catalog proxy above is a different, id-less surface)
+  // Clip registry (v3, org-scoped, served by api-server — `crg_` entries)
   ORG_CLIP_REGISTRY: (orgId) => `/api/v1/orgs/${orgId}/clip-registry`,
+  ORG_CLIP_REGISTRY_CLIP: (orgId, clipId) => `/api/v1/orgs/${orgId}/clip-registry/${clipId}`,
+  ORG_CLIP_REGISTRY_PUBLISH: (orgId) => `/api/v1/orgs/${orgId}/clip-registry/publish`,
   ORG_CLIP_INSTALL: (orgId) => `/api/v1/orgs/${orgId}/clips/install`,
   ORG_CLIPS_INSTALLED: (orgId) => `/api/v1/orgs/${orgId}/clips/installed`,
+  ORG_CLIP_UNINSTALL: (orgId, clipId) => `/api/v1/orgs/${orgId}/clips/${clipId}/uninstall`,
+  // Per-org agent exec access for one clip (default all agents; PUT human-only)
+  ORG_CLIP_EXEC_ACCESS: (orgId, clipId) => `/api/v1/orgs/${orgId}/clips/${clipId}/exec-access`,
   // MCP clip server config (cap:clip-mcp; publisher-org only — cross-org gets
   // 403 MCP_CROSS_ORG_DISABLED on the whole family, reads included)
   ORG_CLIP_MCP_CONFIG: (orgId, clipId) => `/api/v1/orgs/${orgId}/clip-registry/${clipId}/mcp-config`,
-  ORG_CLIP_MCP_TOOLS_REFRESH: (orgId, clipId) => `/api/v1/orgs/${orgId}/clip-registry/${clipId}/mcp-config/tools/refresh`
+  ORG_CLIP_MCP_TOOLS_REFRESH: (orgId, clipId) => `/api/v1/orgs/${orgId}/clip-registry/${clipId}/mcp-config/tools/refresh`,
+  ORG_CLIP_MCP_OAUTH_DISCONNECT: (orgId, clipId) => `/api/v1/orgs/${orgId}/clip-registry/${clipId}/mcp-config/oauth/disconnect`
 };
 var WS_EVENTS = {
   // Client -> Server
@@ -53194,6 +53199,14 @@ var ParallClient = class _ParallClient {
   async setSlackStatus(orgId, input) {
     await this.request("POST", ENDPOINTS.SLACK_STATUS(orgId), input);
   }
+  /**
+   * WeChat tier-B read verb (agent-only; internal research preview): the
+   * account's address book — friend wxids, saved group room ids, followed
+   * official accounts. Same live gate as the send verb.
+   */
+  async listWechatContacts(orgId) {
+    return this.request("GET", ENDPOINTS.WECHAT_CONTACTS(orgId));
+  }
   async listChannelConversations(orgId, connectionId) {
     return this.request("GET", ENDPOINTS.CHANNEL_CONNECTION_CONVERSATIONS(orgId, connectionId));
   }
@@ -53732,17 +53745,11 @@ var ParallClient = class _ParallClient {
   async revokeBrowserProfileConsent(orgId, profileId, clipId) {
     await this.request("DELETE", ENDPOINTS.BROWSER_PROFILE_CONSENT(orgId, profileId, clipId));
   }
-  async listRegistryClips(q) {
-    const url = ENDPOINTS.CLIP_REGISTRY() + (q ? `?q=${encodeURIComponent(q)}` : "");
-    const resp = await this.request("GET", url);
-    return resp.data;
-  }
   // ---- Clip registry (v3, api-server org registry — `crg_` entries) ----
   /**
    * List registry clips visible to the org: its own plus public+approved
    * cross-org entries. This is the surface `installRegistryClip` and clip
-   * connections operate on — NOT the Pinix catalog proxy
-   * ({@link listRegistryClips}), whose entries carry no `crg_` id.
+   * connections operate on.
    */
   async listOrgRegistryClips(orgId) {
     const resp = await this.request("GET", `${ENDPOINTS.ORG_CLIP_REGISTRY(orgId)}?limit=100`);
@@ -53757,11 +53764,58 @@ var ParallClient = class _ParallClient {
   async installRegistryClip(orgId, clipId) {
     return this.request("POST", ENDPOINTS.ORG_CLIP_INSTALL(orgId), { clip_id: clipId });
   }
+  /**
+   * Remove an org's install of a registry clip. Keyed by the REGISTRY id
+   * (`crg_`), the same id {@link installRegistryClip} takes — the v2
+   * `deleteClip` operates on a different table and cannot reach these.
+   */
+  async uninstallRegistryClip(orgId, clipId) {
+    await this.request("DELETE", ENDPOINTS.ORG_CLIP_UNINSTALL(orgId, clipId));
+  }
   /** List the org's installed registry clips (full entries). */
   async listInstalledRegistryClips(orgId) {
     const resp = await this.request("GET", ENDPOINTS.ORG_CLIPS_INSTALLED(orgId));
     return resp ?? [];
   }
+  /**
+   * Fetch one registry clip by its `crg_` id. For a clip OWNED by the calling
+   * org the entry additionally carries `review_status`/`review_note` — the
+   * state of the latest submitted version and the reviewer's rejection
+   * feedback. This is the polling surface for "did platform review approve my
+   * public publish yet"; cross-org callers see only public+approved entries
+   * and never any review-state fields.
+   */
+  async getRegistryClip(orgId, clipId) {
+    return this.request("GET", ENDPOINTS.ORG_CLIP_REGISTRY_CLIP(orgId, clipId));
+  }
+  /**
+   * Publish (create, or author-only update) a clip in the org registry,
+   * replacing its whole file set. See {@link PublishRegistryClipRequest} for
+   * the visibility/review semantics; the returned entry carries
+   * `review_status` when a public publish queued a review submission — poll
+   * {@link getRegistryClip} for the outcome.
+   */
+  async publishRegistryClip(orgId, req) {
+    return this.request("POST", ENDPOINTS.ORG_CLIP_REGISTRY_PUBLISH(orgId), req, void 0, false, {
+      timeoutMs: 6e4
+    });
+  }
+  /**
+   * Read a clip's per-org agent exec access. Org-member readable (agents
+   * included, so a denied agent can learn why exec answered
+   * `CLIP_AGENT_NOT_ALLOWED`).
+   */
+  async getClipAgentExecAccess(orgId, clipId) {
+    return this.request("GET", ENDPOINTS.ORG_CLIP_EXEC_ACCESS(orgId, clipId));
+  }
+  /**
+   * Replace a clip's per-org agent exec access. Human-only (agent principals
+   * get 403); under `all_agents` the `agent_ids` must be empty. Every granted
+   * id must be an active agent of this org (else `400 INVALID_INPUT`).
+   */
+  async putClipAgentExecAccess(orgId, clipId, access) {
+    return this.request("PUT", ENDPOINTS.ORG_CLIP_EXEC_ACCESS(orgId, clipId), access);
+  }
   // ---- Edge devices ----
   async listEdgeDevices(orgId) {
     return this.request("GET", ENDPOINTS.ORG_EDGE_DEVICES(orgId));
@@ -54511,10 +54565,16 @@ function buildSendMessageHint(event) {
         const replyTo = event.channelExternalMessageId ? ` --reply-to "${event.channelExternalMessageId}"` : "";
         return `
 <system-reminder>To reply, use the platform verb: \`parall slack send${channelArg}${replyTo} --text <your reply>\`. In channels --reply-to is REQUIRED (the reply lands in that message's thread); in DMs it is optional (DMs are linear). \`parall slack send\` is the ONLY outbound path \u2014 your plain text output is NOT delivered to the external conversation.</system-reminder>`;
+      }
+      if (event.channelProvider === "wechat") {
+        const toArg = event.channelExternalConversationId ? ` --to "${event.channelExternalConversationId}"` : " --to <wxid from this event>";
+        const atArg = event.channelConversationType === "group" ? event.senderId && event.senderId !== "external" ? ` --at "${event.senderId}"` : " --at <wxid of the person you are answering>" : "";
+        return `
+<system-reminder>To reply, use the platform verb: \`parall wechat send${toArg}${atArg} --text <your reply>\`. In group chats, --at @-mentions the person you are answering. \`parall wechat send\` is the ONLY outbound path \u2014 your plain text output is NOT delivered to the external conversation.</system-reminder>`;
       }
       if (!event.channelProvider) {
         return `
-<system-reminder>To reply, use the channel capability granted in your system prompt \u2014 for Feishu conversations that is \`lark-cli im\`, for Slack it is \`parall slack send\` (pass the message id from this event as --reply-to). That capability is the ONLY outbound path \u2014 your plain text output is NOT delivered to the external conversation.</system-reminder>`;
+<system-reminder>To reply, use the channel capability granted in your system prompt \u2014 for Feishu conversations that is \`lark-cli im\`, for Slack it is \`parall slack send\` (pass the message id from this event as --reply-to), for WeChat it is \`parall wechat send\`. That capability is the ONLY outbound path \u2014 your plain text output is NOT delivered to the external conversation.</system-reminder>`;
       }
       const convRef = event.channelExternalConversationId ? `chat_id "${event.channelExternalConversationId}"` : "the conversation id named in this event";
       const threadAlt = event.channelExternalMessageId ? ` To reply threaded to this specific message, reference message_id "${event.channelExternalMessageId}".` : "";
@@ -54993,13 +55053,33 @@ var LaneLedger = class {
 };
 
 // ts/agent-core/dist/gateway-lane-flow.js
+function shiftMainBufferGroup(host, groupKey, preserveInjectedFrameBoundary) {
+  const events = [];
+  while (host.dispatchState.mainBuffer[0] && host.dispatchGroupKey(host.dispatchState.mainBuffer[0]) === groupKey && (!preserveInjectedFrameBoundary || events.length === 0)) {
+    events.push(host.dispatchState.mainBuffer.shift());
+  }
+  return events;
+}
+function hasUninjectedSameLaneEventAhead(host, event) {
+  const eventIndex = host.dispatchState.mainBuffer.lastIndexOf(event);
+  if (eventIndex <= 0)
+    return false;
+  const groupKey = host.dispatchGroupKey(event);
+  return host.dispatchState.mainBuffer.slice(0, eventIndex).some((buffered) => host.dispatchGroupKey(buffered) === groupKey && !host.injectedMainBufferEvents.has(buffered));
+}
 async function steerLaneMessage(host, event) {
   const { laneLedger: ledger, opts } = host;
   const adapter = opts.dispatchAdapter;
   if (!ledger || !adapter.enqueueDuringDispatch)
     return;
+  if (hasUninjectedSameLaneEventAhead(host, event))
+    return;
   const folded = await ledger.steerLive(event);
-  if (folded && await adapter.enqueueDuringDispatch(opts.runtimeKey, buildEventBody(event), folded.inputLifecycle)) {
+  if (!folded)
+    return;
+  const injected = await adapter.enqueueDuringDispatch(opts.runtimeKey, buildEventBody(event), folded.inputLifecycle);
+  if (injected) {
+    host.injectedMainBufferEvents.add(event);
     opts.log?.info(`steer folded+injected for ${event.messageId} (will drain for bookkeeping)`);
   }
 }
@@ -55935,9 +56015,12 @@ import * as path2 from "node:path";
 import { fileURLToPath } from "node:url";
 var CAPABILITY_FEISHU_CLI = "feishu-cli";
 var CAPABILITY_SLACK_SEND = "slack-send";
+var CAPABILITY_WECHAT_SEND = "wechat-send";
 function channelCapabilityKeyFor(provider) {
   if (provider === "slack")
     return CAPABILITY_SLACK_SEND;
+  if (provider === "wechat")
+    return CAPABILITY_WECHAT_SEND;
   return `${provider}-cli`;
 }
 var CHANNEL_POINTER_MAGIC = "parall channel capability pointer";
@@ -57120,6 +57203,7 @@ var ParallAgentGateway = class {
   // (stable mapping; avoids one connection fetch per inbound message).
   channelConnectionProviders = /* @__PURE__ */ new Map();
   dispatchedMessages = /* @__PURE__ */ new Set();
+  injectedMainBufferEvents = /* @__PURE__ */ new WeakSet();
   // Per-WorkItem failure backoff for typed dispatch consumption — see
   // LaneFlowHost.typedRedriveBackoff in gateway-lane-flow.ts.
   typedRedriveBackoff = /* @__PURE__ */ new Map();
@@ -58332,13 +58416,10 @@ var ParallAgentGateway = class {
           break;
         }
         const groupKey = this.dispatchGroupKey(this.dispatchState.mainBuffer[0]);
-        const events = [];
-        while (this.dispatchState.mainBuffer[0] && this.dispatchGroupKey(this.dispatchState.mainBuffer[0]) === groupKey) {
-          events.push(this.dispatchState.mainBuffer.shift());
-        }
+        const hasPendingInjections = this.opts.dispatchAdapter.hasPendingInjections?.(this.opts.runtimeKey) ?? false;
+        const events = shiftMainBufferGroup(this.laneFlowHost(), groupKey, hasPendingInjections && this.opts.dispatchAdapter.inputLifecycleMode === "explicit");
         const event = events[events.length - 1];
         const earlier = events.slice(0, -1);
-        const hasPendingInjections = this.opts.dispatchAdapter.hasPendingInjections?.(this.opts.runtimeKey) ?? false;
         const pendingFork = hasPendingInjections ? [] : this.dispatchState.pendingForkResults.splice(0);
         const forkPrefix = buildForkResultPrefix(pendingFork);
         this.dispatchState.mainCurrentTargetId = event.targetId;
@@ -59051,7 +59132,7 @@ var ParallAgentGateway = class {
       }
     }
     const keys = this.opts.getCapabilityKeys?.() ?? [];
-    const cliCapable = provider ? keys.includes(channelCapabilityKeyFor(provider)) : keys.some((k) => k.endsWith("-cli") || k === CAPABILITY_SLACK_SEND);
+    const cliCapable = provider ? keys.includes(channelCapabilityKeyFor(provider)) : keys.some((k) => k.endsWith("-cli") || k === CAPABILITY_SLACK_SEND || k === CAPABILITY_WECHAT_SEND);
     const event = {
       type: "channel_message",
       targetId: conv.id,
@@ -60377,41 +60458,55 @@ CLI command results are JSON on stdout; mutation commands may emit auxiliary hin
 var PARALL_CLIPS_SKILL = `# Parall Clips
 
 Clips are packaged capabilities that let agents operate external systems \u2014
-APIs and websites \u2014 through named commands installed in the org.
+APIs, websites, remote tools \u2014 through named commands installed in the org.
 
 ## Discover
 
 \`\`\`bash
-parall clip list            # clips installed in this org
-parall clip info <alias>    # commands, params, version
+parall clip list               # installed clips + each clip's connections
+parall clip info <clip>        # commands + per-command params (manifest)
+parall clip connections <clip> # one clip's connections, full rows
+parall clip tools <clip>       # MCP clips only: live tool schemas
 \`\`\`
 
-## Invoke
+\`clip list\` answers both discovery questions at once: WHICH clip (name,
+description, version) and WHERE it can run \u2014 every connection with its
+\`ccn_\u2026\` id, alias, and target kind:
 
-\`\`\`bash
-parall clip invoke <alias> <command> [input] [--timeout <ms>]   # timeout default 30s
-# input: JSON string or plain text, per the command's params in \`info\`
-parall clip invoke github-tools list-repos '{"org":"acme"}'
-\`\`\`
-
-Results are JSON on stdout; failures print an error.
+- \`cloud\` \u2014 an org-shared cloud profile (a maintainer's signed-in browser)
+- \`desktop\` \u2014 a member's own device (only its owner can exec through it)
+- \`mcp\` \u2014 a remote MCP tool server
+- \`device\` \u2014 a device whose placement could not be resolved just now (the
+  device list was unavailable); don't guess which kind it is \u2014 re-run
+  discovery, and treat a persistent \`device\` like an unverified target
+- \`orphaned\` \u2014 the target device is gone; the connection is unusable
 
-## Execute on an Edge device (registry clips)
+Pick the connection whose alias names the account/device the task needs
+(e.g. \`ins-nyc\` vs \`ins-boston\`). A row without an alias can only be
+referenced by \`ccn_\` id \u2014 when aliases are missing and several connections
+could match, ask a human to name them in the Clip Console rather than
+guessing which signed-in account you are about to act through.
 
-Registry clips run on an Edge \u2014 a member's desktop, or an org-shared cloud
-profile. **Name the target explicitly.** A cloud profile has NO implicit
-route; omitting the target entirely is a desktop-only legacy form that
-reaches just YOUR OWN online desktop device \u2014 never a shared cloud profile.
+## Execute
 
 \`\`\`bash
-parall clip exec <clip> <command> [args] --connection <id|alias>  # the normal form
+parall clip exec <clip> <command> [args] --connection <ccn_|alias>  # the normal form
 parall clip exec browser-tools screenshot '{"url":"\u2026"}' --connection cloud-main
 \`\`\`
 
+Build \`args\` as JSON per the command's params from \`clip info\` (or the
+tool's \`inputSchema\` from \`clip tools\` for MCP clips \u2014 tool names are NOT
+frozen in the manifest, so never guess a tool name or its argument shape).
+Results are JSON on stdout; failures print a typed error.
+
+**Name the target explicitly.** A cloud profile has NO implicit route;
+omitting the target entirely is a desktop-only legacy form that reaches just
+YOUR OWN online desktop device \u2014 never a shared cloud profile.
+
 - A cloud (hosted) profile is reachable ONLY via \`--connection\` \u2014 the clip
-  connection its maintainer bound (\`ccn_\u2026\` id or alias). That binding IS your
-  authorization; without one the server answers \`HOSTED_CONNECTION_REQUIRED\`
-  and the fix is to ask an owner/admin to bind the clip, never to retry.
+  connection its maintainer bound. That binding IS your authorization;
+  without one the server answers \`HOSTED_CONNECTION_REQUIRED\` and the fix
+  is to ask an owner/admin to bind the clip, never to retry.
 - \`--edge <edgeId>\` targets only a desktop device YOU own.
 - Waiting on a cloud profile is handled by the CLI: \`EDGE_ACTIVATING\` (cold
   start), \`EDGE_BUSY\` (another exec is running) and
@@ -60423,19 +60518,10 @@ parall clip exec browser-tools screenshot '{"url":"\u2026"}' --connection cloud-
 
 ## MCP clips (remote tool servers)
 
-Some registry clips are backed by a remote MCP server instead of an Edge
-device. The command is an MCP tool name and the args are that tool's JSON
-arguments \u2014 but **MCP tool names are NOT frozen in \`clip info\`, so discover
-them first; never guess a tool name or its argument shape**. Before invoking,
-find the connection AND the tool schemas:
-
-\`\`\`bash
-parall clip connections <alias>   # the ccn_ id / alias to pass to --connection
-parall clip tools <alias>         # tool names + descriptions + inputSchema (JSON)
-\`\`\`
-
-Read each tool's \`inputSchema\` from \`clip tools\` to build valid args, then
-exec against that explicit target \u2014 same form as an Edge clip:
+A connection with target \`mcp\` routes to a remote MCP server; the command
+is an MCP tool name and the args are that tool's JSON arguments. Read each
+tool's \`inputSchema\` from \`clip tools\` first, then exec against the
+explicit target \u2014 the same form as any other clip:
 
 \`\`\`bash
 parall clip exec <clip> <tool> [json-args] --connection <ccn_|alias>
@@ -60453,13 +60539,11 @@ parall clip exec <clip> <tool> [json-args] --connection <ccn_|alias>
 
 ## Behavior rules
 
-- An authorization error (clip not bound to you) is a fail-fast: ask the
-  clip's owner or an admin to bind it \u2014 do not retry or work around it.
-- If the executing runtime is offline or the call times out, report that
+- An authorization error (\`HOSTED_CONNECTION_REQUIRED\`, \`FORBIDDEN\`) is a
+  fail-fast: ask the clip's maintainer or an org admin to bind the clip or
+  grant the connection \u2014 do not retry or work around it.
+- If the target device is offline or the call times out, report that
   plainly; do not queue, and never fabricate a result for a run that errored.
-- Hosted browser activation is handled by the CLI: it waits (bounded) while a
-  cold hosted browser starts, so if the invoke still fails, report the error \u2014
-  do not blind-retry in a loop.
 - **\`OUTCOME_UNKNOWN\` is never retryable.** It means the command was
   dispatched and MAY HAVE EXECUTED even though no result came back. Retrying
   could post, order or delete twice. Verify the effect through the system you
@@ -60475,10 +60559,274 @@ parall clip exec <clip> <tool> [json-args] --connection <ccn_|alias>
 - A clip may act through a person's real logged-in account \u2014 outward,
   irreversible, or spending actions (post, order, delete, pay) get the same
   caution as any shared-state change: confirm when intent isn't explicit.
+  The connection's alias/target tells you WHICH account you are acting as \u2014
+  if that is ambiguous, resolve it with a human before acting, not after.
 - Reach for \`parall clip list\` whenever a task needs capabilities beyond
   built-in tools.
 `;
 
+// ts/agent-core/dist/skills/parall-clip-authoring.js
+var PARALL_CLIP_AUTHORING_SKILL = `# Authoring a Parall Clip (v3)
+
+Write a **registry (v3) clip**. This skill is for CREATING clips; to DISCOVER
+and CALL clips that are already installed, use the Parall Clips skill instead.
+
+Two kinds of clip exist, and this document covers authoring both:
+
+- A **browser clip** \u2014 the main subject here \u2014 is a folder of named commands
+  that run on an Edge (a member's desktop or an org-shared cloud profile) and
+  drive a real browser session: one manifest (\`manifest.json\` or \`site.json\`,
+  either name works) + one \`.js\` file per command + optional \`_\`-prefixed
+  helpers. The Edge runs each command's JS in a sandbox with a browser handle
+  bound to the target profile.
+- An **MCP clip** is a manifest-ONLY declaration pointing at a remote MCP tool
+  server \u2014 no \`.js\` files; its tools come live from that server's own
+  \`tools/list\`, never from the manifest. See "MCP clips" below.
+
+## Project layout
+
+\`\`\`
+my-clip/
+\u251C\u2500\u2500 manifest.json     # name, description, version, command params
+\u251C\u2500\u2500 _helpers.js       # OPTIONAL \u2014 any _-prefixed file is auto-injected into every command
+\u251C\u2500\u2500 search.js         # one command = one file; filename (minus .js) IS the command name
+\u2514\u2500\u2500 profile.js        # another command
+\`\`\`
+
+## manifest.json
+
+\`\`\`json
+{
+  "name": "twitter",
+  "description": "Twitter / X",
+  "version": "1.0.0",
+  "commands": {
+    "search": {
+      "description": "Search tweets",
+      "params": {
+        "query": { "type": "string", "required": true },
+        "count": { "type": "number", "required": false }
+      }
+    },
+    "profile": {
+      "description": "Fetch a user profile",
+      "params": { "handle": { "type": "string", "required": true } }
+    }
+  }
+}
+\`\`\`
+
+- \`commands\` keys MUST match the \`.js\` filenames (\`search\` \u2194 \`search.js\`).
+- \`params\` is the input contract the caller sees in \`clip info\`; validate them in code too.
+- **No top-level \`"type"\` needed for a browser clip** \u2014 omitting it means
+  browser. The only accepted values are \`"browser"\` and \`"mcp"\` (for the
+  latter, see "MCP clips" below). **\`"type": "clip"\` is the legacy Pinix v2
+  package value and is refused at publish** \u2014 don't copy it in from an older
+  clip.
+
+## A command file
+
+\`\`\`js
+// search.js \u2014 a command is a single async function of (args).
+// The code does NOT know or pick the profile; the Edge binds it per invocation.
+//
+// SHAPE, not a runnable Twitter client: the "..." parts (the GraphQL path,
+// parseTweets' body) are what you fill in per target site. Deliberately not
+// pinned to a real X endpoint \u2014 a site's internal API paths rotate, and a
+// stale one baked into this skill would teach a URL that 404s.
+module.exports = async function (args) {
+  if (!args.query) return { error: "Missing argument: query" };
+
+  const tab = await browser.open("https://x.com");
+  // Everything after open() goes in try/finally: an early return or a thrown
+  // fetch would otherwise leak the tab, and the Edge is long-lived.
+  try {
+    const ct0 = await tab.cookie("ct0");
+    if (!ct0) return { error: "Not logged in" };
+
+    const data = await tab.fetch("/i/api/graphql/.../SearchTimeline?...", {
+      headers: twitterHeaders(ct0), // from _helpers.js, auto-injected
+    });
+    return { query: args.query, tweets: parseTweets(data) };
+  } finally {
+    await tab.close();
+  }
+};
+\`\`\`
+
+Return a plain JSON-serializable object. A thrown error surfaces to the caller as
+\`SCRIPT_ERROR\`; a returned \`{ error: "..." }\` is your own typed failure \u2014 prefer it
+for expected cases (not logged in, missing arg).
+
+## Helpers (\`_\`-prefixed)
+
+Any file whose name starts with \`_\` is NOT a command. Its top-level functions are
+injected into every command's scope \u2014 no import/require needed:
+
+\`\`\`js
+// _helpers.js
+function twitterHeaders(ct0) {
+  return { "X-Csrf-Token": ct0, "X-Twitter-Auth-Type": "OAuth2Session" };
+}
+function parseTweets(data) { /* ... */ }
+\`\`\`
+
+## Runtime API (globals available in every command)
+
+- \`browser.open(url)\` \u2192 tab handle \xB7 \`browser.tabs()\` \u2192 open tabs
+- \`tab.cookie(name)\` \xB7 \`tab.fetch(url, opts)\` (in-browser fetch, carries the session)
+- \`tab.eval(expr)\` (escape hatch) \xB7 \`tab.click(sel)\` \xB7 \`tab.fill(sel, text)\` \xB7 \`tab.navigate(url)\`
+- \`tab.waitForSelector(sel)\` \xB7 \`tab.getTitle()\` \xB7 \`tab.getURL()\` \xB7 \`tab.screenshot()\` \xB7 \`tab.close()\`
+- \`fetch\` \u2014 runtime-side HTTP, does NOT go through the browser (no session)
+- \`console\` \u2014 logs \xB7 \`args\` \u2014 the invocation input
+
+**Prefer \`tab.fetch\` over \`tab.eval\`**: fetch reuses the logged-in session and
+returns structured data; eval is the last resort. Always \`tab.close()\` what you
+open, and do it in a \`finally\` \u2014 an early return or a thrown fetch is exactly
+when the tab leaks.
+
+## Develop \u2192 publish \u2192 iterate
+
+Use the platform \`parall clip\` subcommands \u2014 they reuse the credentials you
+already have (\`PRLL_API_KEY\` / \`PRLL_ORG_ID\`), so there is nothing to install
+or configure.
+
+> A separate **standalone \`parall-clip\`** binary also exists (the Edge-side
+> authoring tool). It takes the SAME operations but a DIFFERENT argument shape \u2014
+> \`parall-clip exec <clip> <cmd> --query "AI" --count 10\` passes one flag per
+> param, while \`parall clip exec\` takes a single JSON blob. Do not mix the two
+> forms; everything below is the platform CLI.
+
+1. **Publish** the clip directory to the org registry. Publishing is not a
+   release step here \u2014 it is the edit loop's SAVE button, because exec only
+   ever sees published files:
+
+   \`\`\`sh
+   parall clip publish ./my-clip/
+   \`\`\`
+
+   It packages the directory (the manifest plus the directory's top-level
+   \`.js\` files; an MCP clip is manifest-only) and POSTs it for you (5 MB cap).
+   \`name\` is the org-wide upsert key \u2014 manifest fields win, else the directory
+   name / \`0.0.1\` / \`private\` fill the gaps. Re-publishing an existing name is
+   **author-only** and REPLACES the file set. Publishing into YOUR org makes it
+   usable there immediately (same-org self-reference, no review);
+   \`"visibility": "public"\` additionally submits the version for platform
+   review before it can spread cross-org.
+
+   Programmatic equivalent (what \`publish\` calls under the hood \u2014 use only if
+   you can't run the CLI). Send it verbatim-shaped: \`visibility\` is exactly
+   one of \`"private"\` / \`"public"\`, and \`files\` maps each filename to its
+   source as a string:
+
+   \`\`\`
+   POST /api/v1/orgs/{orgId}/clip-registry/publish
+   {
+     "name": "twitter",
+     "description": "Twitter / X",
+     "version": "1.0.0",
+     "visibility": "private",
+     "manifest": {
+       "name": "twitter",
+       "version": "1.0.0",
+       "commands": { "search": { "description": "Search tweets" } }
+     },
+     "files": { "search.js": "module.exports = async function (args) { return {}; };" }
+   }
+   \`\`\`
+
+2. **Exec** a command against a real target. Args are ONE argument \u2014 a JSON
+   string (or plain text for a single-value command), not per-param flags:
+
+   \`\`\`sh
+   parall clip exec <clip> <command> '{"query":"AI","count":10}' --connection <ccn_id|alias>
+   # or route to a desktop (BYOC) device you own: --edge <edge-id>
+   # --connection and --edge are mutually exclusive; --timeout <ms> defaults to 30000
+   \`\`\`
+
+   A **cloud (hosted) profile is reachable ONLY via \`--connection\`** \u2014 the
+   binding its maintainer created IS the authorization. With neither flag the
+   server resolves only your own online desktop device, never a cloud profile.
+   Discover the bindings with \`parall clip connections <clip>\`.
+
+3. **Iterate**: edit locally \u2192 \`parall clip publish\` again \u2192 re-exec. Exec
+   resolves the file set from the REGISTRY, server-side \u2014 your own org always
+   runs the live working copy, i.e. the latest publish. It NEVER reads your
+   local directory: an edit you did not re-publish silently runs the previous
+   version.
+
+## Install model & self-development (v3)
+
+- Installing a clip is a **reference**, not a copy \u2014 the JS lives once in the Market DB.
+- **Your own org** always executes its **live working copy** (latest published files),
+  so re-publishing is your edit loop.
+- **Other orgs** installing your \`public\` clip execute only the **approved snapshot**
+  (\`approved_version_id\`); unreviewed public edits are invisible/unexecutable cross-org.
+- To customize someone else's public clip: install \u2192 **fetch its effective
+  file set** \u2192 modify \u2192 **publish into your OWN org** (a derived private
+  entry). You cannot edit a published clip in place. The CLI has no files
+  subcommand (\`clip info\` returns only the manifest) \u2014 read the source via
+  the API:
+
+  \`\`\`
+  GET /api/v1/orgs/{orgId}/clip-registry/{clipId}/files
+  \`\`\`
+
+  It returns exactly what you may read and execute: your own clip \u2192 the live
+  working copy; an installed public clip \u2192 the approved snapshot.
+
+## MCP clips (manifest-only)
+
+An MCP clip declares a remote MCP tool server. There is nothing to code: no
+\`.js\` files (the no-scripts refusal at publish applies to browser clips only),
+and the folder is just a manifest:
+
+\`\`\`json
+{
+  "name": "linear",
+  "description": "Linear (MCP)",
+  "version": "1.0.0",
+  "type": "mcp",
+  "mcp": { "server_url": "https://mcp.linear.app/mcp", "auth": "oauth" }
+}
+\`\`\`
+
+- The \`mcp\` block takes ONLY \`server_url\` and \`auth\` (\`"none" | "bearer" |
+  "api_key" | "oauth"\`). Any other key is refused at publish \u2014 a credential
+  belongs to the installing org's own configuration, NEVER to the clip
+  definition.
+- \`server_url\` must be an absolute **https** URL with no embedded credentials,
+  query, or fragment. It is review material, frozen with the approved version.
+- Do NOT put the server in the top-level \`server\` / \`auth\` manifest keys \u2014
+  those are legacy Edge-manifest fields nothing reads. Only the \`mcp\` block
+  declares the server.
+- Both fields are optional, but what you declare is LOCKED: the installing
+  org's config must match it, and changing the URL or auth mode means
+  republishing.
+- Entering the credential / completing OAuth is a HUMAN step in the Clip
+  Console (the config-write endpoints are session-only \u2014 an API key cannot
+  call them). Once configured, discover the live tool schemas with
+  \`parall clip tools <clip>\` and exec like any other clip.
+- Publish is the same command: \`parall clip publish ./my-clip/\`.
+
+## Cloud (hosted) vs desktop (BYOC) Edge
+
+The same command JS runs on either. Hosted profiles are org-shared cloud browsers
+reachable ONLY via an explicit \`--connection\`; cloud state lives in S3 and is
+hydrated per pod. Your code never touches this \u2014 it just gets a \`browser\`/\`tab\`
+bound to whatever profile the connection selected.
+
+## Constraints
+
+- Browser clips: one command = one file; keep a command's work self-contained
+  (open what you need, close it, return). The Edge is stateless about your code
+  between calls.
+- Never embed credentials in the clip source \u2014 rely on the profile's logged-in
+  session (\`tab.cookie\` / \`tab.fetch\`). Published source is visible to installers.
+- Exec has a timeout (default 30s, caller-set up to 120s). Long scrapes should page,
+  not block.
+`;
+
 // ts/agent-core/dist/skills/index.js
 var SKILLS = [
   {
@@ -60508,8 +60856,13 @@ var SKILLS = [
   },
   {
     name: "parall-clips",
-    description: "Parall clip operations: list installed clips, invoke clip commands, inspect clip details. Use when: the task requires external capabilities (GitHub, web search, etc.), user asks about available tools/clips, or you need to call a clip command.",
+    description: "Parall clip operations: list installed clips and their connections, inspect clip commands/tools, execute clip commands on an explicit connection. Use when: the task requires external capabilities (GitHub, web search, etc.), user asks about available tools/clips, or you need to call a clip command. For WRITING a new clip, use parall-clip-authoring instead.",
     content: PARALL_CLIPS_SKILL
+  },
+  {
+    name: "parall-clip-authoring",
+    description: "Authoring a v3 registry clip: write manifest.json + command .js files + _helpers, drive the browser/tab runtime API, publish the directory to the org registry with `parall clip publish` \u2014 or declare a manifest-only MCP clip pointing at a remote tool server. Use when: user asks to write/create/build a new clip, author a clip command, package a browser automation as a clip, declare an MCP clip, or publish a clip. For CALLING clips that already exist, use parall-clips instead.",
+    content: PARALL_CLIP_AUTHORING_SKILL
   }
 ];
 function writeSkillFiles(targetDir) {
@@ -61189,6 +61542,15 @@ var ClaudeInputRegistry = class {
   getByCommand(commandUuid) {
     return this.byCommand.get(commandUuid);
   }
+  findOverlapping(dispatchEventIds) {
+    const ids = new Set(dispatchEventIds);
+    for (const delivery of this.byKey.values()) {
+      if (delivery.lifecycle?.dispatchEventIds.some((id) => ids.has(id))) {
+        return delivery;
+      }
+    }
+    return void 0;
+  }
   values() {
     return this.byKey.values();
   }
@@ -61815,6 +62177,12 @@ var ClaudeCodeAdapter = class {
         return;
       }
     }
+    if (existingState && inputLifecycle) {
+      const overlap = existingState.inputs.findOverlapping(inputLifecycle.dispatchEventIds);
+      if (overlap) {
+        throw new Error(`buffered Claude delivery ${deliveryKey} overlaps active input ${overlap.deliveryKey}; refusing duplicate stdin write`);
+      }
+    }
     let promptBody = bodyForAgent;
     let releasePreparedAttachments = () => {
     };