@parall/parall 1.32.1 → 1.33.0

package/dist/index.bundle.mjs

@@ -27092,6 +27092,7 @@ var ENDPOINTS = {
   MACHINE_AGENT_DAEMON_CONFIG: (orgId, machineId, agentId) => `${API_BASE}/orgs/${orgId}/machines/${machineId}/agents/${agentId}/daemon-config`,
   MACHINE_AGENT_WORKSPACE_SETUP: (orgId, machineId, agentId) => `${API_BASE}/orgs/${orgId}/machines/${machineId}/agents/${agentId}/workspace/setup`,
   MACHINE_LLM_SOURCE: (orgId, machineId) => `${API_BASE}/orgs/${orgId}/machines/${machineId}/llm-source`,
+  MACHINE_PROVIDER_ENABLED: (orgId, machineId) => `${API_BASE}/orgs/${orgId}/machines/${machineId}/provider-enabled`,
   MACHINE_RUNTIME_AUTH: (orgId, machineId) => `${API_BASE}/orgs/${orgId}/machines/${machineId}/runtime-auth`,
   MACHINE_KEYS: (orgId, machineId) => `${API_BASE}/orgs/${orgId}/machines/${machineId}/keys`,
   MACHINE_KEY: (orgId, machineId, keyId) => `${API_BASE}/orgs/${orgId}/machines/${machineId}/keys/${keyId}`,
@@ -27105,8 +27106,9 @@ var ENDPOINTS = {
   MACHINES_ME: `${API_BASE}/machines/me`,
   MACHINES_ME_AGENTS: `${API_BASE}/machines/me/agents`,
   MACHINES_ME_HEALTH: `${API_BASE}/machines/me/health`,
-  MACHINES_ME_CLIP_INSTALLS: `${API_BASE}/machines/me/clip-installs`,
-  MACHINES_ME_CLIP_INSTALL_DONE: (clipId) => `${API_BASE}/machines/me/clip-installs/${clipId}/installed`,
+  MACHINES_ME_CLIPS: `${API_BASE}/machines/me/clips`,
+  MACHINES_ME_BROWSER_PROFILES: `${API_BASE}/machines/me/browser-profiles`,
+  MACHINES_ME_BROWSER_PROFILE_STATUS: (profileId) => `${API_BASE}/machines/me/browser-profiles/${profileId}/status`,
   MACHINES_ME_AGENT_LAUNCH_CREDENTIAL: (agentId) => `${API_BASE}/machines/me/agents/${agentId}/launch-credential`,
   MACHINES_ME_AGENT_WORKSPACE_STATE: (agentId) => `${API_BASE}/machines/me/agents/${agentId}/workspace-state`,
   MACHINES_ME_WS_TICKET: `${API_BASE}/machines/me/ws/ticket`,
@@ -27205,6 +27207,7 @@ var ENDPOINTS = {
   DISPATCH_RECEIVED: (orgId) => `${API_BASE}/orgs/${orgId}/dispatch/received`,
   DISPATCH_ACK: (orgId) => `${API_BASE}/orgs/${orgId}/dispatch/ack`,
   DISPATCH_ACK_BY_ID: (orgId, id) => `${API_BASE}/orgs/${orgId}/dispatch/${id}/ack`,
+  DISPATCH_EXPIRE: (orgId) => `${API_BASE}/orgs/${orgId}/dispatch/expire`,
   DISPATCH_BY_MESSAGES: (orgId) => `${API_BASE}/orgs/${orgId}/dispatch/by-messages`,
   // Unread
   UNREAD: `${API_BASE}/me/unread`,
@@ -27243,6 +27246,13 @@ var ENDPOINTS = {
   AGENT_CLIP: (orgId, agentId, clipId) => `${CLIP_BASE}/orgs/${orgId}/agents/${agentId}/clips/${clipId}`,
   CLIP_INVOKE: (orgId) => `${CLIP_BASE}/orgs/${orgId}/invoke`,
   CLIP_ONLINE: (orgId) => `${CLIP_BASE}/orgs/${orgId}/online`,
+  BROWSER_PROFILES: (orgId) => `${CLIP_BASE}/orgs/${orgId}/browser-profiles`,
+  BROWSER_PROFILE: (orgId, profileId) => `${CLIP_BASE}/orgs/${orgId}/browser-profiles/${profileId}`,
+  BROWSER_PROFILE_OPEN: (orgId, profileId) => `${CLIP_BASE}/orgs/${orgId}/browser-profiles/${profileId}/open`,
+  BROWSER_PROFILE_STOP: (orgId, profileId) => `${CLIP_BASE}/orgs/${orgId}/browser-profiles/${profileId}/stop`,
+  BROWSER_PROFILE_RESET: (orgId, profileId) => `${CLIP_BASE}/orgs/${orgId}/browser-profiles/${profileId}/reset`,
+  BROWSER_PROFILE_CONSENTS: (orgId, profileId) => `${CLIP_BASE}/orgs/${orgId}/browser-profiles/${profileId}/consents`,
+  BROWSER_PROFILE_CONSENT: (orgId, profileId, clipId) => `${CLIP_BASE}/orgs/${orgId}/browser-profiles/${profileId}/consents/${clipId}`,
   // Clip registry (global, served by clip-service → Pinix Hub proxy)
   CLIP_REGISTRY: () => `${CLIP_BASE}/registry/clips`
 };
@@ -27317,9 +27327,10 @@ var WS_EVENTS = {
   MACHINE_FILESYSTEM_BROWSE: "machine.filesystem.browse",
   MACHINE_UPDATE: "machine.update",
   MACHINE_CONFIG_UPDATED: "machine.config.updated",
-  MACHINE_CLIP_INSTALL: "machine.clip.install",
+  MACHINE_CLIP_SYNC: "machine.clip.sync",
+  MACHINE_BROWSER_PROFILE_LIFECYCLE: "machine.browser_profile.lifecycle",
   AGENT_NEW_SESSION: "agent.new_session",
-  CLIP_INSTALLED: "clip.installed",
+  CLIP_CREATED: "clip.created",
   CLIP_REMOVED: "clip.removed",
   CLIP_UPDATED: "clip.updated"
 };
@@ -27772,8 +27783,8 @@ var ParallClient = class _ParallClient {
     const res = await this.request("GET", ENDPOINTS.CHAT_MEMBERS(orgId, chatId));
     return res.data;
   }
-  async addChatMember(orgId, chatId, userId, role) {
-    return this.request("POST", ENDPOINTS.CHAT_MEMBERS(orgId, chatId), { user_id: userId, role });
+  async addChatMember(orgId, chatId, userId) {
+    return this.request("POST", ENDPOINTS.CHAT_MEMBERS(orgId, chatId), { user_id: userId });
   }
   async removeChatMember(orgId, chatId, userId) {
     return this.request("DELETE", ENDPOINTS.CHAT_MEMBER(orgId, chatId, userId));
@@ -28032,6 +28043,16 @@ var ParallClient = class _ParallClient {
       llm_source: llmSource
     });
   }
+  /**
+   * Toggle whether the machine contributes its local clips as a hub provider
+   * — org-admin-gated (RequireOrgAdmin), like all machine management. See
+   * docs/engineering-design/clip-provider-sharing-design.md.
+   */
+  async patchMachineProviderEnabled(orgId, machineId, providerEnabled) {
+    return this.request("PATCH", ENDPOINTS.MACHINE_PROVIDER_ENABLED(orgId, machineId), {
+      provider_enabled: providerEnabled
+    });
+  }
   /** Get machine-level runtime auth state. */
   async getMachineRuntimeAuth(orgId, machineId) {
     return this.request("GET", ENDPOINTS.MACHINE_RUNTIME_AUTH(orgId, machineId));
@@ -28065,25 +28086,39 @@ var ParallClient = class _ParallClient {
     const res = await this.request("GET", ENDPOINTS.MACHINES_ME_AGENTS);
     return res.data;
   }
-  /** `GET /machines/me/clip-installs` — registry clips this machine should
-   * install but hasn't yet (durable reconcile, mck_-authed). */
-  async listClipInstalls() {
-    const res = await this.request("GET", ENDPOINTS.MACHINES_ME_CLIP_INSTALLS);
+  /** `GET /machines/me/clips` — executable Clip definitions assigned to this machine. */
+  async listMachineClips() {
+    const res = await this.request("GET", ENDPOINTS.MACHINES_ME_CLIPS);
     return res.data;
   }
-  /** `POST /machines/me/clip-installs/{clipId}/installed` — report a finished install. */
-  async reportClipInstall(clipId, version) {
-    return this.request("POST", ENDPOINTS.MACHINES_ME_CLIP_INSTALL_DONE(clipId), version ? { version } : void 0);
+  /** `GET /machines/me/browser-profiles` — browser profiles hosted by this machine. */
+  async listMachineBrowserProfiles() {
+    const res = await this.request("GET", ENDPOINTS.MACHINES_ME_BROWSER_PROFILES);
+    return res.data;
+  }
+  /** `POST /machines/me/browser-profiles/{profileId}/status` — report runtime status. */
+  async reportBrowserProfileStatus(profileId, status, errorMsg) {
+    await this.request("POST", ENDPOINTS.MACHINES_ME_BROWSER_PROFILE_STATUS(profileId), {
+      status,
+      ...errorMsg ? { error_msg: errorMsg } : {}
+    });
   }
   /**
-   * `POST /machines/me/health` — bump the Machine's `updated_at` to now.
-   * Body is intentionally empty; the server ignores any payload. The
-   * daemon should call this on a fixed cadence (e.g. every 30s) so an
-   * external observer can detect a wedged supervisor.
+   * `POST /machines/me/health` — bump the Machine's `updated_at` to now and
+   * report daemon state. The daemon should call this on a fixed cadence (e.g.
+   * every 30s) so an external observer can detect a wedged supervisor. Both
+   * fields are optional and only persisted when changed:
+   *  - `daemonVersion` — the running bundle/launcher version.
+   *  - `selfUpdateCapable` — whether the daemon can act on a machine.update
+   *    signal (true under a service manager, false for bare `npx` foreground).
    */
-  async postMachineHeartbeat(daemonVersion) {
-    const body = daemonVersion ? { daemon_version: daemonVersion } : void 0;
-    return this.request("POST", ENDPOINTS.MACHINES_ME_HEALTH, body);
+  async postMachineHeartbeat(opts) {
+    const body = {};
+    if (opts?.daemonVersion)
+      body.daemon_version = opts.daemonVersion;
+    if (opts?.selfUpdateCapable !== void 0)
+      body.self_update_capable = opts.selfUpdateCapable;
+    return this.request("POST", ENDPOINTS.MACHINES_ME_HEALTH, Object.keys(body).length > 0 ? body : void 0);
   }
   async reportAgentWorkspaceState(agentId, state) {
     const res = await this.request("PUT", ENDPOINTS.MACHINES_ME_AGENT_WORKSPACE_STATE(agentId), state);
@@ -28185,6 +28220,10 @@ var ParallClient = class _ParallClient {
   async ackDispatchByID(orgId, id) {
     return this.request("POST", ENDPOINTS.DISPATCH_ACK_BY_ID(orgId, id));
   }
+  async expireDispatch(orgId, maxAgeHours) {
+    const params = maxAgeHours !== void 0 ? { max_age_hours: String(maxAgeHours) } : void 0;
+    return this.request("POST", ENDPOINTS.DISPATCH_EXPIRE(orgId), void 0, params);
+  }
   async getDispatchByMessages(orgId, chatId, messageIds) {
     const params = { chat_id: chatId, message_ids: messageIds.join(",") };
     return this.request("GET", ENDPOINTS.DISPATCH_BY_MESSAGES(orgId), void 0, params);
@@ -28665,6 +28704,41 @@ var ParallClient = class _ParallClient {
     const resp = await this.request("GET", ENDPOINTS.CLIP_ONLINE(orgId));
     return resp.data;
   }
+  async listBrowserProfiles(orgId) {
+    const resp = await this.request("GET", ENDPOINTS.BROWSER_PROFILES(orgId));
+    return resp.data;
+  }
+  async createBrowserProfile(orgId, req) {
+    return this.request("POST", ENDPOINTS.BROWSER_PROFILES(orgId), req);
+  }
+  async getBrowserProfile(orgId, profileId) {
+    return this.request("GET", ENDPOINTS.BROWSER_PROFILE(orgId, profileId));
+  }
+  async updateBrowserProfile(orgId, profileId, req) {
+    return this.request("PATCH", ENDPOINTS.BROWSER_PROFILE(orgId, profileId), req);
+  }
+  async deleteBrowserProfile(orgId, profileId) {
+    await this.request("DELETE", ENDPOINTS.BROWSER_PROFILE(orgId, profileId));
+  }
+  async openBrowserProfile(orgId, profileId, req = {}) {
+    return this.request("POST", ENDPOINTS.BROWSER_PROFILE_OPEN(orgId, profileId), req);
+  }
+  async stopBrowserProfile(orgId, profileId) {
+    return this.request("POST", ENDPOINTS.BROWSER_PROFILE_STOP(orgId, profileId), {});
+  }
+  async resetBrowserProfile(orgId, profileId) {
+    return this.request("POST", ENDPOINTS.BROWSER_PROFILE_RESET(orgId, profileId));
+  }
+  async listBrowserProfileConsents(orgId, profileId) {
+    const resp = await this.request("GET", ENDPOINTS.BROWSER_PROFILE_CONSENTS(orgId, profileId));
+    return resp.data;
+  }
+  async grantBrowserProfileConsent(orgId, profileId, req) {
+    return this.request("POST", ENDPOINTS.BROWSER_PROFILE_CONSENTS(orgId, profileId), req);
+  }
+  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);
@@ -30648,8 +30722,28 @@ var ParallAgentGateway = class {
     return dispatched;
   }
   async catchUpFromDispatch() {
+    const OVERFLOW_THRESHOLD = 500;
+    const EXPIRE_AGE_HOURS = 24;
+    const CATCHUP_MAX = 10;
+    let expireSummary = null;
+    let overflowMode = false;
+    try {
+      const { count } = await this.opts.client.getDispatchPendingCount(this.opts.config.org_id);
+      if (count > OVERFLOW_THRESHOLD) {
+        overflowMode = true;
+        const result = await this.opts.client.expireDispatch(this.opts.config.org_id, EXPIRE_AGE_HOURS);
+        if (result.total > 0) {
+          this.opts.log?.warn(`dispatch catch-up overflow: ${count} pending, expired ${result.total} events older than ${EXPIRE_AGE_HOURS}h`);
+          expireSummary = this.buildOfflineSummary(result.groups);
+        }
+      }
+    } catch (err) {
+      this.opts.log?.warn(`dispatch catch-up overflow check failed: ${String(err)}`);
+    }
     let cursor;
     let processed = 0;
+    let skipped = 0;
+    const skippedByType = /* @__PURE__ */ new Map();
     do {
       const page = await this.opts.client.getDispatch(this.opts.config.org_id, {
         limit: 50,
@@ -30658,6 +30752,17 @@ var ParallAgentGateway = class {
       for (const item of page.data ?? []) {
         if (this.shuttingDown)
           break;
+        if (overflowMode && processed >= CATCHUP_MAX) {
+          try {
+            await this.opts.client.ackDispatchByID(this.opts.config.org_id, item.id);
+            skipped++;
+            const key = item.event_type;
+            skippedByType.set(key, (skippedByType.get(key) ?? 0) + 1);
+          } catch {
+            this.opts.log?.warn(`catch-up skip ack failed for ${item.id}, leaving pending`);
+          }
+          continue;
+        }
         processed++;
         try {
           let dispatched = false;
@@ -30732,9 +30837,52 @@ var ParallAgentGateway = class {
       }
       cursor = !this.shuttingDown && page.has_more ? page.next_cursor : void 0;
     } while (cursor);
-    if (processed > 0) {
-      this.opts.log?.info(`dispatch catch-up: processed ${processed}`);
+    if (expireSummary || skipped > 0) {
+      const parts = [];
+      if (expireSummary)
+        parts.push(expireSummary);
+      if (skipped > 0) {
+        const recentLines = [...skippedByType.entries()].map(([type, count]) => `- ${count} recent ${type.replace(".", " ").replace("_", " ")} events`).join("\n");
+        parts.push(expireSummary ? `Additionally, ${skipped} recent events exceeded the catch-up limit and were skipped:
+${recentLines}` : `[Offline Summary] You were offline. ${skipped} pending events exceeded the catch-up limit and were skipped:
+${recentLines}
+
+Use your tools (read messages, check tasks) to review anything still relevant.`);
+      }
+      const fullSummary = parts.join("\n\n");
+      this.pendingRestartNotification = this.pendingRestartNotification ? `${this.pendingRestartNotification}
+
+${fullSummary}` : fullSummary;
+    }
+    if (processed > 0 || skipped > 0) {
+      this.opts.log?.info(`dispatch catch-up: processed ${processed}, skipped ${skipped}`);
+    }
+  }
+  buildOfflineSummary(groups) {
+    const lines = [
+      "[Offline Summary] You were offline and had a large backlog of pending events. The following old events were skipped:"
+    ];
+    for (const g of groups) {
+      const age = this.formatAge(g.oldest);
+      if (g.chat_id && g.event_type === "message") {
+        const name = g.chat_name ?? g.chat_id;
+        lines.push(`- ${g.count} messages in "${name}" (oldest: ${age})`);
+      } else {
+        const label = g.event_type.replace(".", " ").replace("_", " ");
+        lines.push(`- ${g.count} ${label} events (oldest: ${age})`);
+      }
     }
+    lines.push("");
+    lines.push("These events were too old to process individually. Use your tools (read messages, check tasks) to review anything still relevant.");
+    return lines.join("\n");
+  }
+  formatAge(iso) {
+    const ms = Date.now() - new Date(iso).getTime();
+    const hours = Math.floor(ms / 36e5);
+    if (hours < 24)
+      return `${hours}h ago`;
+    const days = Math.floor(hours / 24);
+    return `${days}d ago`;
   }
   async handleHello(data) {
     const { client, config, log } = this.opts;

package/package.json

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