@parall/parall 1.32.1 → 1.34.0

package/dist/gateway.d.ts

@@ -1,7 +1,16 @@
+import type { PluginRuntime } from 'openclaw/plugin-sdk';
 import type { ChannelPlugin } from 'openclaw/plugin-sdk/core';
 /** Extract ChannelGatewayAdapter from ChannelPlugin (removed from public SDK exports in 2026.3.24). */
 type ChannelGatewayAdapter<T = unknown> = NonNullable<ChannelPlugin<T>['gateway']>;
+import { type DispatchAdapter } from '@parall/agent-core';
 import type { ResolvedParallAccount } from './types.js';
+export declare function createOpenClawDispatchAdapter(opts: {
+    core: PluginRuntime;
+    cfg: Record<string, unknown>;
+    accountId: string;
+    sessionsDir: string;
+    workspaceDir: string;
+}): DispatchAdapter;
 export declare const parallGateway: ChannelGatewayAdapter<ResolvedParallAccount>;
 export {};
 //# sourceMappingURL=gateway.d.ts.map

package/dist/gateway.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../src/gateway.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,uGAAuG;AACvG,KAAK,qBAAqB,CAAC,CAAC,GAAG,OAAO,IAAI,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AAgCnF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AA8SxD,eAAO,MAAM,aAAa,EAAE,qBAAqB,CAAC,qBAAqB,CAmJtE,CAAC"}
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../src/gateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,uGAAuG;AACvG,KAAK,qBAAqB,CAAC,CAAC,GAAG,OAAO,IAAI,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AACnF,OAAO,EAOL,KAAK,eAAe,EAGrB,MAAM,oBAAoB,CAAC;AAqB5B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAiKxD,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAClD,IAAI,EAAE,aAAa,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,eAAe,CA0KlB;AAED,eAAO,MAAM,aAAa,EAAE,qBAAqB,CAAC,qBAAqB,CAmJtE,CAAC"}

package/dist/gateway.js

@@ -145,8 +145,41 @@ async function waitForOpenClawSessionId(sessionsDir, sessionKey, timeoutMs = 10_
     }
     return null;
 }
-function createOpenClawDispatchAdapter(opts) {
+export function createOpenClawDispatchAdapter(opts) {
     const activeStreams = new Map();
+    let configFallbackWarned = false;
+    /**
+     * Resolve the config for one dispatch. OpenClaw hot-reloads
+     * `agents.defaults.model` / `models.providers` WITHOUT restarting channel
+     * plugins, so the `ctx.cfg` snapshot captured at startAccount goes stale the
+     * moment the operator switches the agent's model — every run would keep the
+     * old model until the whole gateway restarts. `core.config.current()` is the
+     * host's live (hot-reload-refreshed) config; fall back to the startup
+     * snapshot on hosts that predate the API. The fallback warns once per
+     * degradation streak (latch resets on success) — silently dispatching with
+     * the stale snapshot would recreate the invisible model-switch mismatch this
+     * function exists to fix.
+     */
+    function resolveDispatchConfig(log) {
+        try {
+            const current = opts.core.config?.current?.();
+            if (current && typeof current === 'object') {
+                configFallbackWarned = false;
+                return current;
+            }
+            if (!configFallbackWarned) {
+                configFallbackWarned = true;
+                log?.warn?.(`parall[${opts.accountId}]: config.current() unavailable on this host — dispatching with the startup config snapshot; model switches need a gateway restart until then`);
+            }
+        }
+        catch (err) {
+            if (!configFallbackWarned) {
+                configFallbackWarned = true;
+                log?.warn?.(`parall[${opts.accountId}]: config.current() failed (${String(err)}) — dispatching with the startup config snapshot; model switches need a gateway restart until then`);
+            }
+        }
+        return opts.cfg;
+    }
     return {
         abortDispatch(sessionKey) {
             activeStreams.get(sessionKey)?.fail(new Error('dispatch deadline exceeded'));
@@ -172,7 +205,7 @@ function createOpenClawDispatchAdapter(opts) {
                 let turnGroupKey = '';
                 const run = opts.core.channel.reply.dispatchReplyWithBufferedBlockDispatcher({
                     ctx: buildInboundCtx(opts.core, opts.accountId, event, sessionKey, promptBody, earlierEvents),
-                    cfg: opts.cfg,
+                    cfg: resolveDispatchConfig(context.log),
                     dispatcherOptions: {
                         deliver: async (payload) => {
                             const replyText = payload.text?.trim();

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`,
@@ -27223,6 +27226,8 @@ var ENDPOINTS = {
   PUSH_VAPID_KEY: `${API_BASE}/push/vapid-key`,
   // Notification preferences
   NOTIFICATION_PREFERENCES: `${API_BASE}/notification-preferences`,
+  // Unified search (messages + tasks + wiki, org-scoped)
+  SEARCH: (orgId) => `${API_BASE}/orgs/${orgId}/search`,
   // Feature flags (org-scoped, server-evaluated)
   FEATURE_FLAGS: (orgId) => `${API_BASE}/orgs/${orgId}/feature-flags`,
   // Billing & Credits (org-scoped)
@@ -27243,6 +27248,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 +27329,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"
 };
@@ -27348,8 +27361,13 @@ var ParallClient = class _ParallClient {
   /** Proactive refresh when token expires within this window (seconds). */
   static REFRESH_THRESHOLD_S = 5 * 60;
   static normalizeFetchError(err) {
-    if (typeof DOMException !== "undefined" && err instanceof DOMException && (err.name === "TimeoutError" || err.name === "AbortError")) {
-      return new ApiError(0, "Request timed out", "REQUEST_TIMEOUT");
+    if (typeof DOMException !== "undefined" && err instanceof DOMException) {
+      if (err.name === "TimeoutError") {
+        return new ApiError(0, "Request timed out", "REQUEST_TIMEOUT");
+      }
+      if (err.name === "AbortError") {
+        return new ApiError(0, "Request aborted", "REQUEST_ABORTED");
+      }
     }
     const apiError = new ApiError(0, "Network request failed", "NETWORK_ERROR");
     if (err instanceof Error && err.message && err.message !== "Failed to fetch") {
@@ -27456,13 +27474,15 @@ var ParallClient = class _ParallClient {
         url += `?${qs}`;
     }
     const headers = this.buildHeaders();
+    const timeoutSignal = AbortSignal.timeout(opts?.timeoutMs ?? 15e3);
+    const signal = opts?.signal ? AbortSignal.any([opts.signal, timeoutSignal]) : timeoutSignal;
     let res;
     try {
       res = await fetch(url, {
         method,
         headers,
         body: body ? JSON.stringify(body) : void 0,
-        signal: AbortSignal.timeout(opts?.timeoutMs ?? 15e3)
+        signal
       });
     } catch (err) {
       throw _ParallClient.normalizeFetchError(err);
@@ -27772,8 +27792,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 +28052,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 +28095,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 +28229,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);
@@ -28382,6 +28430,9 @@ var ParallClient = class _ParallClient {
   async getWikiNodeSections(orgId, wikiId, params) {
     return this.request("GET", ENDPOINTS.WIKI_NODE_SECTIONS(orgId, wikiId), void 0, params);
   }
+  async search(orgId, params, opts) {
+    return this.request("GET", ENDPOINTS.SEARCH(orgId), void 0, params, false, opts);
+  }
   async searchWiki(orgId, wikiId, params) {
     return this.request("GET", ENDPOINTS.WIKI_SEARCH(orgId, wikiId), void 0, params);
   }
@@ -28665,6 +28716,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 +30734,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 +30764,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 +30849,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;
@@ -32259,6 +32419,26 @@ async function waitForOpenClawSessionId(sessionsDir, sessionKey, timeoutMs = 1e4
 }
 function createOpenClawDispatchAdapter(opts) {
   const activeStreams = /* @__PURE__ */ new Map();
+  let configFallbackWarned = false;
+  function resolveDispatchConfig(log) {
+    try {
+      const current = opts.core.config?.current?.();
+      if (current && typeof current === "object") {
+        configFallbackWarned = false;
+        return current;
+      }
+      if (!configFallbackWarned) {
+        configFallbackWarned = true;
+        log?.warn?.(`parall[${opts.accountId}]: config.current() unavailable on this host \u2014 dispatching with the startup config snapshot; model switches need a gateway restart until then`);
+      }
+    } catch (err) {
+      if (!configFallbackWarned) {
+        configFallbackWarned = true;
+        log?.warn?.(`parall[${opts.accountId}]: config.current() failed (${String(err)}) \u2014 dispatching with the startup config snapshot; model switches need a gateway restart until then`);
+      }
+    }
+    return opts.cfg;
+  }
   return {
     abortDispatch(sessionKey) {
       activeStreams.get(sessionKey)?.fail(new Error("dispatch deadline exceeded"));
@@ -32284,7 +32464,7 @@ function createOpenClawDispatchAdapter(opts) {
         let turnGroupKey = "";
         const run = opts.core.channel.reply.dispatchReplyWithBufferedBlockDispatcher({
           ctx: buildInboundCtx(opts.core, opts.accountId, event, sessionKey, promptBody, earlierEvents),
-          cfg: opts.cfg,
+          cfg: resolveDispatchConfig(context2.log),
           dispatcherOptions: {
             deliver: async (payload) => {
               const replyText = payload.text?.trim();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parall/parall",
-  "version": "1.32.1",
+  "version": "1.34.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.34.0",
+    "@parall/sdk": "1.34.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/src/gateway.ts

@@ -195,7 +195,7 @@ async function waitForOpenClawSessionId(
   return null;
 }
 
-function createOpenClawDispatchAdapter(opts: {
+export function createOpenClawDispatchAdapter(opts: {
   core: PluginRuntime;
   cfg: Record<string, unknown>;
   accountId: string;
@@ -203,6 +203,43 @@ function createOpenClawDispatchAdapter(opts: {
   workspaceDir: string;
 }): DispatchAdapter {
   const activeStreams = new Map<string, ReturnType<typeof createRuntimeEventStream>>();
+  let configFallbackWarned = false;
+
+  /**
+   * Resolve the config for one dispatch. OpenClaw hot-reloads
+   * `agents.defaults.model` / `models.providers` WITHOUT restarting channel
+   * plugins, so the `ctx.cfg` snapshot captured at startAccount goes stale the
+   * moment the operator switches the agent's model — every run would keep the
+   * old model until the whole gateway restarts. `core.config.current()` is the
+   * host's live (hot-reload-refreshed) config; fall back to the startup
+   * snapshot on hosts that predate the API. The fallback warns once per
+   * degradation streak (latch resets on success) — silently dispatching with
+   * the stale snapshot would recreate the invisible model-switch mismatch this
+   * function exists to fix.
+   */
+  function resolveDispatchConfig(log?: { warn?: (msg: string) => void }): Record<string, unknown> {
+    try {
+      const current = opts.core.config?.current?.();
+      if (current && typeof current === 'object') {
+        configFallbackWarned = false;
+        return current as unknown as Record<string, unknown>;
+      }
+      if (!configFallbackWarned) {
+        configFallbackWarned = true;
+        log?.warn?.(
+          `parall[${opts.accountId}]: config.current() unavailable on this host — dispatching with the startup config snapshot; model switches need a gateway restart until then`,
+        );
+      }
+    } catch (err) {
+      if (!configFallbackWarned) {
+        configFallbackWarned = true;
+        log?.warn?.(
+          `parall[${opts.accountId}]: config.current() failed (${String(err)}) — dispatching with the startup config snapshot; model switches need a gateway restart until then`,
+        );
+      }
+    }
+    return opts.cfg;
+  }
 
   return {
     abortDispatch(sessionKey: string): void {
@@ -238,7 +275,7 @@ function createOpenClawDispatchAdapter(opts: {
             promptBody,
             earlierEvents,
           ),
-          cfg: opts.cfg,
+          cfg: resolveDispatchConfig(context.log),
           dispatcherOptions: {
             deliver: async (payload: { text?: string }) => {
               const replyText = payload.text?.trim();