@parall/parall 1.55.5 → 1.56.0

package/dist/index.bundle.mjs

@@ -51519,6 +51519,8 @@ function buildEventBody(event) {
       ].filter(Boolean).join(" | ");
       lines.push(`[Thread: ${threadMeta}]`);
     }
+    if (event.deliveryReason)
+      lines.push(`[Delivery: ${sanitizeMeta(event.deliveryReason)}]`);
     if (event.unreadCount != null && event.unreadCount > 1) {
       const countStr = event.unreadCount >= 1e3 ? "999+" : String(event.unreadCount);
       const sinceStr = event.unreadSince ? ` | since: prll://${event.unreadSince}` : "";
@@ -51890,6 +51892,7 @@ var ENDPOINTS = {
   TASKS: (orgId) => `${API_BASE}/orgs/${orgId}/tasks`,
   TASK_SUBTASK_SUMMARY: (orgId) => `${API_BASE}/orgs/${orgId}/tasks/subtask-summary`,
   TASK: (orgId, taskId) => `${API_BASE}/orgs/${orgId}/tasks/${taskId}`,
+  TASK_MOVE: (orgId, taskId) => `${API_BASE}/orgs/${orgId}/tasks/${taskId}/move`,
   TASK_ARCHIVE: (orgId, taskId) => `${API_BASE}/orgs/${orgId}/tasks/${taskId}/archive`,
   TASK_RESTORE: (orgId, taskId) => `${API_BASE}/orgs/${orgId}/tasks/${taskId}/restore`,
   TASK_WATCH: (orgId, taskId) => `${API_BASE}/orgs/${orgId}/tasks/${taskId}/watch`,
@@ -52019,6 +52022,8 @@ var ENDPOINTS = {
   WIKI_ACCESS_POLICY: (orgId, wikiId) => `${WIKI_BASE}/orgs/${orgId}/wikis/${wikiId}/access-policy`,
   WIKI_ACCESS_POLICY_MEMBERS: (orgId, wikiId) => `${WIKI_BASE}/orgs/${orgId}/wikis/${wikiId}/access-policy/members`,
   WIKI_MEMBERSHIP_SELF: (orgId, wikiId) => `${WIKI_BASE}/orgs/${orgId}/wikis/${wikiId}/membership/self`,
+  // Library-level star (self-scoped bookmark; POST = star, DELETE = unstar).
+  WIKI_STARS_SELF: (orgId, wikiId) => `${WIKI_BASE}/orgs/${orgId}/wikis/${wikiId}/stars/self`,
   WIKI_MEMBERS: (orgId, wikiId) => `${WIKI_BASE}/orgs/${orgId}/wikis/${wikiId}/members`,
   WIKI_ACCESS_STATUS: (orgId, wikiId) => `${WIKI_BASE}/orgs/${orgId}/wikis/${wikiId}/access-status`,
   WIKI_ACCESS_REQUESTS: (orgId, wikiId) => `${WIKI_BASE}/orgs/${orgId}/wikis/${wikiId}/access-requests`,
@@ -52153,6 +52158,8 @@ var ENDPOINTS = {
   ORG_MANAGED_ALIAS: (orgId, aliasName) => `/api/v1/orgs/${orgId}/aliases/${encodeURIComponent(aliasName)}`,
   ORG_BROWSER_ALIAS_EXECUTIONS: (orgId) => `/api/v1/orgs/${orgId}/executions`,
   ORG_BROWSER_ALIAS_EXECUTION: (orgId, requestId) => `/api/v1/orgs/${orgId}/executions/${encodeURIComponent(requestId)}`,
+  ORG_BROWSER_USE_OPERATIONS: (orgId) => `/api/v1/orgs/${orgId}/browser-use/operations`,
+  ORG_BROWSER_USE_OPERATION: (orgId, operationId) => `/api/v1/orgs/${orgId}/browser-use/operations/${encodeURIComponent(operationId)}`,
   // Per-profile egress proxy (hosted Cloud Profiles; manager-only, human-only).
   ORG_EDGE_PROFILE_PROXY: (orgId, edgeId, profileName) => `/api/v1/orgs/${orgId}/edge/${edgeId}/profiles/${encodeURIComponent(profileName)}/proxy`,
   // Per-profile one-shot cookie seed (hosted Cloud Profiles; manager-only,
@@ -52167,6 +52174,8 @@ var ENDPOINTS = {
   CLIP_CONNECTION: (orgId, connId) => `/api/v1/orgs/${orgId}/clip-connections/${connId}`,
   // Clip registry (v3, org-scoped, served by api-server — `crg_` entries)
   ORG_CLIP_REGISTRY: (orgId) => `/api/v1/orgs/${orgId}/clip-registry`,
+  ORG_CLIP_REGISTRY_RESOLVE: (orgId) => `/api/v1/orgs/${orgId}/clip-registry/resolve`,
+  ORG_CLIP_REGISTRY_SEARCH: (orgId) => `/api/v1/orgs/${orgId}/clip-registry/search`,
   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`,
@@ -52300,6 +52309,15 @@ var ProjectTaskClient = class {
   async deleteTask(orgId, taskId, opts) {
     return this.request("DELETE", ENDPOINTS.TASK(orgId, taskId), void 0, opts?.force ? { force: "true" } : void 0);
   }
+  /**
+   * Moves a task and its whole subtree into another project (renumbering it
+   * there; old identifiers stay resolvable as aliases). The caller needs
+   * update access on the task (source project membership) and read access to
+   * the target project.
+   */
+  async moveTask(orgId, taskId, data) {
+    return this.request("POST", ENDPOINTS.TASK_MOVE(orgId, taskId), data);
+  }
   async archiveTask(orgId, taskId) {
     return this.request("POST", ENDPOINTS.TASK_ARCHIVE(orgId, taskId));
   }
@@ -54158,6 +54176,17 @@ var ParallClient = class _ParallClient extends AttachmentClient {
   async leaveWiki(orgId, wikiId) {
     await this.request("DELETE", ENDPOINTS.WIKI_MEMBERSHIP_SELF(orgId, wikiId));
   }
+  /** Star a library for the caller (sidebar Starred group). Idempotent —
+   *  re-starring is a 204 no-op. Requires read access; hidden private
+   *  libraries answer 404 like absent IDs. */
+  async starWiki(orgId, wikiId) {
+    await this.request("POST", ENDPOINTS.WIKI_STARS_SELF(orgId, wikiId));
+  }
+  /** Remove the caller's star. Idempotent — unstarring a never-starred
+   *  library is a 204 no-op. */
+  async unstarWiki(orgId, wikiId) {
+    await this.request("DELETE", ENDPOINTS.WIKI_STARS_SELF(orgId, wikiId));
+  }
   async getWikiMembers(orgId, wikiId) {
     const res = await this.request("GET", ENDPOINTS.WIKI_MEMBERS(orgId, wikiId));
     return res.data ?? [];
@@ -54511,6 +54540,31 @@ var ParallClient = class _ParallClient extends AttachmentClient {
     const resp = await this.request("GET", `${ENDPOINTS.ORG_CLIP_REGISTRY(orgId)}?limit=100`);
     return resp ?? [];
   }
+  /**
+   * Resolve an exact `<publisher org, name>` reference to its registry entry —
+   * the npm-style point read. Deliberately independent of catalog size: no
+   * Search, no pagination, same read-visibility boundary as `getRegistryClip`
+   * (cross-org requires public + approved). 404 `NOT_FOUND` when the publisher
+   * org has no visible clip of that exact name.
+   */
+  async resolveRegistryClip(orgId, publisherOrgId, name) {
+    const params = new URLSearchParams({ org_id: publisherOrgId, name });
+    return this.request("GET", `${ENDPOINTS.ORG_CLIP_REGISTRY_RESOLVE(orgId)}?${params}`);
+  }
+  /**
+   * Server-side fuzzy discovery over the visible registry (name/description
+   * substring match), paginated. The discovery verb: rows carry the `crg_` id
+   * that {@link installRegistryClip} takes.
+   */
+  async searchOrgRegistryClips(orgId, query, opts) {
+    const params = new URLSearchParams({ q: query });
+    if (opts?.limit !== void 0)
+      params.set("limit", String(opts.limit));
+    if (opts?.offset !== void 0)
+      params.set("offset", String(opts.offset));
+    const resp = await this.request("GET", `${ENDPOINTS.ORG_CLIP_REGISTRY_SEARCH(orgId)}?${params}`);
+    return resp ?? [];
+  }
   /**
    * Install a registry clip into the org (a reference in `clip_installs`, not a
    * copy). Idempotent: installing an already-installed clip returns the same
@@ -54694,6 +54748,16 @@ var ParallClient = class _ParallClient extends AttachmentClient {
   async getBrowserAliasExecution(orgId, requestId) {
     return this.request("GET", ENDPOINTS.ORG_BROWSER_ALIAS_EXECUTION(orgId, requestId));
   }
+  /** Accept one idempotent Browser Use operation for an explicit Profile.
+   * The Server resolves Profile→Edge; callers never select an Edge directly. */
+  async createBrowserUseOperation(orgId, request3) {
+    return this.request("POST", ENDPOINTS.ORG_BROWSER_USE_OPERATIONS(orgId), request3);
+  }
+  /** Recover the durable receipt. Successful data is present only inside the
+   * Server's short encrypted result TTL; terminal proof remains afterwards. */
+  async getBrowserUseOperation(orgId, operationId) {
+    return this.request("GET", ENDPOINTS.ORG_BROWSER_USE_OPERATION(orgId, operationId));
+  }
   /**
    * Read a hosted Cloud Profile's egress-proxy status (manager-only: hosted
    * human maintainer or org admin). Sanitized — the password never comes back.
@@ -58958,11 +59022,28 @@ var ParallAgentGateway = class {
     const hasAttachments = message.attachments?.length;
     if (!body && !hasAttachments)
       return { action: "skip" };
-    if (chatInfo.type === "group" && chatInfo.agentRoutingMode !== "active") {
-      const mentions = content.mentions ?? [];
-      const isMentioned = mentions.some((mention) => mentionTargetsUser(mention.user_id, this.opts.agentUserId, "agent"));
-      if (!isMentioned)
+    const mentions = content.mentions ?? [];
+    const isMentioned = mentions.some((mention) => mentionTargetsUser(mention.user_id, this.opts.agentUserId, "agent"));
+    let deliveryReason;
+    if (message.thread_root_id) {
+      if (isMentioned) {
+        deliveryReason = "mention";
+      } else {
+        let watching;
+        try {
+          watching = await this.opts.client.isWatchingThread(message.thread_root_id);
+        } catch {
+          return { action: "retry" };
+        }
+        if (!watching)
+          return { action: "skip" };
+        deliveryReason = "watcher";
+      }
+    } else if (chatInfo.type === "group") {
+      if (chatInfo.agentRoutingMode !== "active" && !isMentioned)
         return { action: "skip" };
+      if (isMentioned)
+        deliveryReason = "mention";
     }
     const attachments = (message.attachments ?? []).map((a) => ({
       id: a.id,
@@ -59003,6 +59084,7 @@ var ParallAgentGateway = class {
         messageId: message.id,
         body: body || "[attachment]",
         threadRootId: message.thread_root_id ?? void 0,
+        deliveryReason,
         noReply: message.hints?.no_reply ?? false,
         attachments: attachments.length > 0 ? attachments : void 0,
         sentAt: message.created_at,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parall/parall",
-  "version": "1.55.5",
+  "version": "1.56.0",
   "description": "OpenClaw channel plugin for Parall IM",
   "license": "MIT",
   "repository": {
@@ -16,8 +16,8 @@
     "openclaw.plugin.json"
   ],
   "dependencies": {
-    "@parall/agent-core": "1.55.5",
-    "@parall/sdk": "1.55.5"
+    "@parall/agent-core": "1.56.0",
+    "@parall/sdk": "1.56.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/skills/parall-platform/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: parall-platform
-description: "Parall platform queries and lightweight agent provisioning: list org members, agents, chats, read message history, check identity, create another agent, or walk the prll:// reference graph (resolve URIs, backlinks, multi-hop graph). Use when: user asks about org members, who's online, chat history, agent list, creating an agent, identity/auth questions, or you need to find what an entity is connected to / who references it."
+description: "Parall platform queries and lightweight agent provisioning: list org members, agents, chats, read message history, watch/unwatch threads, check identity, create another agent, or walk the prll:// reference graph (resolve URIs, backlinks, multi-hop graph). Use when: user asks about org members, who's online, chat history, agent list, creating an agent, identity/auth questions, you want to follow or mute a thread (e.g. after `[Delivery: watcher]` wake-ups), or you need to find what an entity is connected to / who references it."
 ---
 
 # Parall Platform
@@ -140,7 +140,7 @@ parall dm prll://usr_xxx --text-file /tmp/reply.md
 parall dm "Alice" --text "Hello"
 
 # Thread reply
-parall messages send prll://cht_xxx --text-file /tmp/reply.md --thread-root-id 01JWC...
+parall messages send prll://cht_xxx --text-file /tmp/reply.md --thread-root-id prll://msg_xxx
 
 # FYI message (no response expected — the recipient sees `[Hint: no_reply]`)
 parall messages send prll://cht_xxx --text "FYI: done" --no-reply
@@ -151,6 +151,27 @@ parall messages send prll://cht_xxx --text "FYI: done" --no-reply
 parall no-reply --reason "ack only, nothing to add"
 ```
 
+## Thread Subscriptions
+
+Replying in a thread subscribes you to it: every later reply reaches you as
+`[Event: message.new]` with a `[Thread: ...]` line, marked
+`[Delivery: watcher]`. You are also auto-subscribed when a thread reply
+@-mentions you personally, and when someone replies to a thread whose root
+message you wrote. `[Delivery: mention]` means you were @-mentioned in that
+message.
+
+```bash
+parall messages watch prll://msg_xxx      # follow a thread without replying (ID = the thread's root message)
+parall messages unwatch prll://msg_xxx    # stop receiving a thread's replies
+parall messages watchers prll://msg_xxx   # list who is watching a thread
+```
+
+Unwatch is sticky: no automatic source (including later @-mentions — you
+still get the one-off mention, just no subscription) re-subscribes you.
+Only replying in the thread yourself or an explicit `watch` does. Unwatch
+threads you have nothing more to contribute to instead of ignoring their
+wake-ups.
+
 ## Files & Attachments
 
 Attachments appear in events as `[Attachment: prll://att_xxx | mime | size | name]`.