@parall/parall 1.48.0 → 1.50.0

package/dist/gateway.d.ts.map

@@ -1 +1 @@
-{"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,EASL,KAAK,eAAe,EAGrB,MAAM,oBAAoB,CAAC;AAqB5B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AA2KxD,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,CA8KlB;AAED,eAAO,MAAM,aAAa,EAAE,qBAAqB,CAAC,qBAAqB,CAqLtE,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,EAUL,KAAK,eAAe,EAGrB,MAAM,oBAAoB,CAAC;AAqB5B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AA+KxD,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,CA8KlB;AAED,eAAO,MAAM,aAAa,EAAE,qBAAqB,CAAC,qBAAqB,CAmMtE,CAAC"}

package/dist/gateway.js

@@ -1,4 +1,4 @@
-import { ParallAgentGateway, capabilityBinDir, dispatchLaneContextDir, parseShutdownDeadlineMs, parseForkDeadlineMs, parseDispatchDeadlineMs, initAgentTelemetry, createOtelLogger, } from '@parall/agent-core';
+import { ParallAgentGateway, capabilityBinDir, dispatchLaneContextDir, parseShutdownDeadlineMs, parseForkDeadlineMs, parseDispatchDeadlineMs, identityFromMe, initAgentTelemetry, createOtelLogger, } from '@parall/agent-core';
 import { appendPreparedLocalAttachmentRefs, ensureLocalAttachmentGitExclude, pinLocalAttachmentPaths, } from '@parall/agent-core/internal/attachment-input';
 import { ApiError, ParallClient, ParallWs } from '@parall/sdk';
 import * as crypto from 'node:crypto';
@@ -36,9 +36,12 @@ async function getAgentMeWithLegacyFallback(client, orgId) {
             throw err;
         }
         const user = await client.getMe();
-        return { ...user, agent_profile: null };
+        return { ...user, agent_profile: null, public_profile: null };
     }
 }
+// hooks.ts rebuilds the prompt from the process-global identity on EVERY
+// prompt build, so a refreshed identity (via the shared identityFromMe)
+// reaches the very next turn without any restart.
 function buildInboundCtx(core, accountId, event, sessionKey, bodyForAgent, earlierEvents = []) {
     const inboundHistory = earlierEvents.length > 0 ? buildInboundHistory(earlierEvents) : undefined;
     return core.channel.reply.finalizeInboundContext({
@@ -333,11 +336,7 @@ export const parallGateway = {
         });
         const me = await getAgentMeWithLegacyFallback(client, config.org_id);
         const agentUserId = me.id;
-        setAgentIdentity({
-            userId: agentUserId,
-            displayName: me.display_name,
-            description: me.agent_profile?.description ?? undefined,
-        });
+        setAgentIdentity(identityFromMe(me));
         log?.info(`parall[${ctx.accountId}]: authenticated as ${me.display_name} (${agentUserId})`);
         const telemetry = await initAgentTelemetry('parall-openclaw-agent', 'openclaw');
         const otelLog = createOtelLogger('agent', 'openclaw-agent');
@@ -436,7 +435,23 @@ export const parallGateway = {
                 forkDeadlineMs: parseForkDeadlineMs(process.env.PRLL_FORK_DEADLINE_MS),
                 dispatchDeadlineMs: parseDispatchDeadlineMs(process.env.PRLL_DISPATCH_DEADLINE_MS),
                 onConfigUpdate: async () => {
-                    await fetchAndApplyPlatformConfig(configManagerOpts);
+                    // Identity rides the same agent_config.update nudge: refresh the
+                    // process-global identity so the next prompt build (hooks.ts
+                    // before_prompt_build) carries the new title / public description /
+                    // instructions. The finally keeps it running even when the platform
+                    // config refresh throws (their failure domains are independent);
+                    // identity failure keeps the last-known-good value.
+                    try {
+                        await fetchAndApplyPlatformConfig(configManagerOpts);
+                    }
+                    finally {
+                        try {
+                            setAgentIdentity(identityFromMe(await getAgentMeWithLegacyFallback(client, config.org_id)));
+                        }
+                        catch (err) {
+                            log?.warn(`parall[${ctx.accountId}]: /agents/me refetch failed (keeping last-known identity): ${String(err)}`);
+                        }
+                    }
                 },
                 onSessionReady: async ({ activeSessionId }) => {
                     setParallAccountState(ctx.accountId, {

package/dist/index.bundle.mjs

@@ -51291,6 +51291,17 @@ function laneContextFilePath(contextDir, targetUri, threadRootId) {
 
 // ../sdk/dist/types.js
 var MENTION_ALL_USER_ID = "all";
+var MENTION_ALL_HUMANS_USER_ID = "allhuman";
+var MENTION_ALL_AGENTS_USER_ID = "allagent";
+function mentionTargetsUser(mentionUserId, userId, userType) {
+  if (mentionUserId === userId || mentionUserId === MENTION_ALL_USER_ID)
+    return true;
+  if (mentionUserId === MENTION_ALL_HUMANS_USER_ID)
+    return userType === "human";
+  if (mentionUserId === MENTION_ALL_AGENTS_USER_ID)
+    return userType === "agent";
+  return false;
+}
 
 // ../sdk/dist/constants.js
 var API_BASE = "/api/v1";
@@ -51326,6 +51337,12 @@ var ENDPOINTS = {
   ORG_MEMBER: (orgId, userId) => `${API_BASE}/orgs/${orgId}/members/${userId}`,
   ORG_MEMBER_CHATS: (orgId, memberId) => `${API_BASE}/orgs/${orgId}/members/${memberId}/chats`,
   ORG_MEMBER_TASKS: (orgId, memberId) => `${API_BASE}/orgs/${orgId}/members/${memberId}/tasks`,
+  // Org-scoped public profile (title / description). GET readable by every
+  // active member; PATCH is CAS-guarded (expected_version).
+  ORG_MEMBER_PROFILE: (orgId, userId) => `${API_BASE}/orgs/${orgId}/members/${userId}/profile`,
+  // Private agent Instructions — visibility gated server-side
+  // (agent self + Human org admin/owner). Never cached.
+  AGENT_INSTRUCTIONS: (orgId, agentId) => `${API_BASE}/orgs/${orgId}/agents/${agentId}/instructions`,
   REF_SEARCH: (orgId) => `${API_BASE}/orgs/${orgId}/refs/search`,
   // Direct messages (org-scoped, atomic find-or-create + send)
   DM: (orgId) => `${API_BASE}/orgs/${orgId}/dm`,
@@ -51349,6 +51366,8 @@ var ENDPOINTS = {
   MESSAGE_WATCH: (id) => `${API_BASE}/messages/${id}/watch`,
   MESSAGE_WATCHERS: (id) => `${API_BASE}/messages/${id}/watchers`,
   MESSAGE_WATCHING: (id) => `${API_BASE}/messages/${id}/watching`,
+  MESSAGE_REACTIONS: (id) => `${API_BASE}/messages/${id}/reactions`,
+  MESSAGE_REACTION: (id, emoji) => `${API_BASE}/messages/${id}/reactions/${encodeURIComponent(emoji)}`,
   // Upload (org-scoped)
   UPLOAD_PRESIGN: (orgId) => `${API_BASE}/orgs/${orgId}/upload/presign`,
   UPLOAD_COMPLETE: (orgId) => `${API_BASE}/orgs/${orgId}/upload/complete`,
@@ -51586,11 +51605,13 @@ var ENDPOINTS = {
   UNREAD: `${API_BASE}/me/unread`,
   ORG_UNREAD: (orgId) => `${API_BASE}/orgs/${orgId}/unread`,
   CHAT_READ: (orgId, chatId) => `${API_BASE}/orgs/${orgId}/chats/${chatId}/read`,
+  CHAT_READ_ALL: (orgId, chatId) => `${API_BASE}/orgs/${orgId}/chats/${chatId}/read-all`,
   THREAD_UNREAD: (orgId, chatId, threadRootId) => `${API_BASE}/orgs/${orgId}/chats/${chatId}/threads/${threadRootId}/unread`,
   THREAD_READ: (orgId, chatId, threadRootId) => `${API_BASE}/orgs/${orgId}/chats/${chatId}/threads/${threadRootId}/read`,
   // References (org-scoped)
   REFS_RESOLVE: (orgId) => `${API_BASE}/orgs/${orgId}/refs/resolve`,
   REFS_BACKLINKS: (orgId) => `${API_BASE}/orgs/${orgId}/refs/backlinks`,
+  REFS_OUTBOUND: (orgId) => `${API_BASE}/orgs/${orgId}/refs/outbound`,
   REFS_GRAPH: (orgId) => `${API_BASE}/orgs/${orgId}/refs/graph`,
   REFS_CHECK: (orgId) => `${API_BASE}/orgs/${orgId}/refs/check`,
   // Platform config (agent-scoped, not org-scoped)
@@ -51605,6 +51626,11 @@ var ENDPOINTS = {
   SEARCH: (orgId) => `${API_BASE}/orgs/${orgId}/search`,
   // Feature flags (org-scoped, server-evaluated)
   FEATURE_FLAGS: (orgId) => `${API_BASE}/orgs/${orgId}/feature-flags`,
+  // Team templates (org-scoped, owner/admin only)
+  TEMPLATES: (orgId) => `${API_BASE}/orgs/${orgId}/templates`,
+  TEMPLATE: (orgId, templateId) => `${API_BASE}/orgs/${orgId}/templates/${templateId}`,
+  TEMPLATE_DEPLOYMENTS: (orgId) => `${API_BASE}/orgs/${orgId}/template-deployments`,
+  TEMPLATE_DEPLOYMENT: (orgId, deploymentId) => `${API_BASE}/orgs/${orgId}/template-deployments/${deploymentId}`,
   // Billing & Credits (org-scoped)
   BILLING: (orgId) => `${API_BASE}/orgs/${orgId}/billing`,
   BILLING_TRANSACTIONS: (orgId) => `${API_BASE}/orgs/${orgId}/billing/transactions`,
@@ -51652,7 +51678,13 @@ var ENDPOINTS = {
   ORG_EDGE_DEVICE_UNREGISTER: (orgId, edgeId) => `/api/v1/orgs/${orgId}/edge/${edgeId}/unregister`,
   ORG_EDGE_ONBOARDING: (orgId) => `/api/v1/orgs/${orgId}/edge/onboarding`,
   ORG_EDGE_PROFILES: (orgId, edgeId) => `/api/v1/orgs/${orgId}/edge/${edgeId}/profiles`,
+  // 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`,
   ORG_EDGE_EXEC: (orgId) => `/api/v1/orgs/${orgId}/edge/exec`,
+  // Cloud Edge live viewer command (V1b) — api-server, gated on cap:edge-viewer.
+  // Same request/reply shape as the v2 browser-profile viewer, on the v3 edge
+  // pipe. Additive: does NOT replace BROWSER_PROFILE_VIEWER_COMMAND.
+  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
@@ -51675,6 +51707,7 @@ var WS_EVENTS = {
   MESSAGE_PATCH: "message.patch",
   MESSAGE_EDIT: "message.edit",
   MESSAGE_DELETE: "message.delete",
+  MESSAGE_REACTION_UPDATED: "message.reaction.updated",
   TYPING_UPDATE: "typing.update",
   CHAT_UPDATE: "chat.update",
   CHAT_DELETED: "chat.deleted",
@@ -51716,6 +51749,7 @@ var WS_EVENTS = {
   INBOX_UPDATE: "inbox.update",
   INBOX_BULK_UPDATE: "inbox.bulk_update",
   READ_POSITION_UPDATED: "read_position.updated",
+  THREAD_READ_POSITION_UPDATED: "thread_read_position.updated",
   DISPATCH_NEW: "dispatch.new",
   DISPATCH_RECEIVED: "dispatch.received",
   DISPATCH_RESOLVED: "dispatch.resolved",
@@ -51901,7 +51935,7 @@ var ParallClient = class _ParallClient {
       if (qs)
         url += `?${qs}`;
     }
-    const headers = this.buildHeaders(path9);
+    const headers = this.buildHeaders(path9, opts?.headers);
     const timeoutSignal = AbortSignal.timeout(opts?.timeoutMs ?? 15e3);
     const signal = opts?.signal ? AbortSignal.any([opts.signal, timeoutSignal]) : timeoutSignal;
     let res;
@@ -52117,6 +52151,30 @@ var ParallClient = class _ParallClient {
   async updateOrgMember(orgId, userId, role) {
     return this.request("PATCH", ENDPOINTS.ORG_MEMBER(orgId, userId), { role });
   }
+  /** Org-scoped public profile (title / description) of any active member. */
+  async getMemberProfile(orgId, userId) {
+    return this.request("GET", ENDPOINTS.ORG_MEMBER_PROFILE(orgId, userId));
+  }
+  /**
+   * CAS full-replacement of a member's public profile. Humans edit their
+   * own; Human org admins/owners edit agents'. A stale expected_version
+   * gets 409 PROFILE_VERSION_CONFLICT with error.details.current_version.
+   */
+  async updateMemberProfile(orgId, userId, req) {
+    return this.request("PATCH", ENDPOINTS.ORG_MEMBER_PROFILE(orgId, userId), req);
+  }
+  /** Private agent Instructions — agent self or Human org admin/owner only. */
+  async getAgentInstructions(orgId, agentId) {
+    return this.request("GET", ENDPOINTS.AGENT_INSTRUCTIONS(orgId, agentId));
+  }
+  /**
+   * CAS update of the private Instructions (Human org admin/owner only).
+   * A stale expected_version gets 409 INSTRUCTIONS_VERSION_CONFLICT with
+   * error.details.current_version.
+   */
+  async updateAgentInstructions(orgId, agentId, req) {
+    return this.request("PATCH", ENDPOINTS.AGENT_INSTRUCTIONS(orgId, agentId), req);
+  }
   // Member activity surfaces — chats the member participates in within this org,
   // ordered by most recent activity. Powers the member profile Activity tab.
   async getMemberChats(orgId, memberId, params) {
@@ -52307,6 +52365,14 @@ var ParallClient = class _ParallClient {
   async getMessageReplies(id, params) {
     return this.request("GET", ENDPOINTS.MESSAGE_REPLIES(id), void 0, params);
   }
+  // ---- Reactions ----
+  async toggleReaction(messageId, emoji) {
+    return this.request("PUT", ENDPOINTS.MESSAGE_REACTION(messageId, emoji));
+  }
+  async listReactions(messageId) {
+    const res = await this.request("GET", ENDPOINTS.MESSAGE_REACTIONS(messageId));
+    return res.reactions;
+  }
   // ---- File Upload ----
   async getUploadPresignUrl(orgId, req) {
     return this.request("POST", ENDPOINTS.UPLOAD_PRESIGN(orgId), req);
@@ -52682,6 +52748,15 @@ var ParallClient = class _ParallClient {
   async browserViewerCommand(orgId, profileId, req, opts) {
     return this.request("POST", ENDPOINTS.BROWSER_PROFILE_VIEWER_COMMAND(orgId, profileId), req, void 0, false, opts);
   }
+  /**
+   * Drive the Cloud Edge live viewer (V1b, design §6): WebRTC signaling + input +
+   * tab nav for a hosted browser (Cloud Profile). Same request/reply shape as
+   * browserViewerCommand, on the v3 edge pipe; additive — the v2 browser-profile
+   * viewer is unchanged.
+   */
+  async edgeViewerCommand(orgId, edgeId, req, opts) {
+    return this.request("POST", ENDPOINTS.ORG_EDGE_VIEWER_COMMAND(orgId, edgeId), req, void 0, false, opts);
+  }
   async resizeMachine(orgId, machineId, spec) {
     return this.request("PATCH", ENDPOINTS.MACHINE_SPEC(orgId, machineId), spec);
   }
@@ -52708,14 +52783,23 @@ var ParallClient = class _ParallClient {
   }
   // Wiki mount/token methods removed — wiki-service handles all wiki endpoints.
   // ---- Unread ----
-  async getUnreadCounts(orgId) {
+  async getUnreadCounts(orgId, opts) {
     const endpoint = orgId ? ENDPOINTS.ORG_UNREAD(orgId) : ENDPOINTS.UNREAD;
-    const res = await this.request("GET", endpoint);
+    const res = await this.request("GET", endpoint, void 0, {
+      include_thread_replies: opts?.includeThreadReplies ? "true" : void 0
+    });
     return res.data;
   }
   async markRead(orgId, chatId, messageId) {
     return this.request("POST", ENDPOINTS.CHAT_READ(orgId, chatId), { message_id: messageId });
   }
+  /** Mark everything in a chat read: the channel cursor jumps to the latest
+   *  top-level message and every thread cursor to its latest reply, in one
+   *  idempotent call. The server echoes the same per-cursor WS events the
+   *  single-cursor routes emit and auto-clears covered inbox items. */
+  async markAllRead(orgId, chatId) {
+    return this.request("POST", ENDPOINTS.CHAT_READ_ALL(orgId, chatId));
+  }
   async getThreadUnread(orgId, chatId, threadRootId) {
     return this.request("GET", ENDPOINTS.THREAD_UNREAD(orgId, chatId, threadRootId));
   }
@@ -53390,6 +53474,16 @@ var ParallClient = class _ParallClient {
   async getBacklinks(orgId, params) {
     return this.request("GET", ENDPOINTS.REFS_BACKLINKS(orgId), void 0, params);
   }
+  /**
+   * Outbound prll:// refs authored in a set of sources, as raw ref_links rows
+   * (dedupe/group client-side). Pass `{ thread_root_id }` to list a whole
+   * thread's refs (root + all replies, resolved server-side — the client's
+   * reply window may be partial), or `{ source_type, source_ids }` for
+   * explicit sources (max 500; v1 accepts only message sources).
+   */
+  async listOutboundRefs(orgId, req) {
+    return this.request("POST", ENDPOINTS.REFS_OUTBOUND(orgId), req);
+  }
   /**
    * Bounded multi-hop walk of the prll:// reference graph around `uri`. `uri`
    * must be an entity-level prll:// URI — a refined URI (path/query/fragment) is
@@ -53424,6 +53518,22 @@ var ParallClient = class _ParallClient {
   async getFeatureFlags(orgId) {
     return this.request("GET", ENDPOINTS.FEATURE_FLAGS(orgId));
   }
+  // ---- Official Template catalog (org-contextual owner/admin reads + Hire) ----
+  async listOfficialTemplates(orgId) {
+    const response = await this.request("GET", ENDPOINTS.TEMPLATES(orgId));
+    return response.templates ?? [];
+  }
+  async getOfficialTemplate(orgId, templateId) {
+    return this.request("GET", ENDPOINTS.TEMPLATE(orgId, templateId));
+  }
+  async deployTemplate(orgId, request3) {
+    return this.request("POST", ENDPOINTS.TEMPLATE_DEPLOYMENTS(orgId), request3, void 0, false, {
+      timeoutMs: 185e3
+    });
+  }
+  async getTemplateDeployment(orgId, deploymentId) {
+    return this.request("GET", ENDPOINTS.TEMPLATE_DEPLOYMENT(orgId, deploymentId));
+  }
   // ---- Billing & Credits (org-scoped) ----
   async getBilling(orgId) {
     return this.request("GET", ENDPOINTS.BILLING(orgId));
@@ -53669,6 +53779,43 @@ var ParallClient = class _ParallClient {
   async listEdgeProfiles(orgId, edgeId) {
     return this.request("GET", ENDPOINTS.ORG_EDGE_PROFILES(orgId, edgeId));
   }
+  /**
+   * Read a hosted Cloud Profile's egress-proxy status (manager-only: hosted
+   * human maintainer or org admin). Sanitized — the password never comes back.
+   * Typed errors: `EDGE_NOT_HOSTED` (BYOC device), `PROXY_CONFIG_CORRUPT` /
+   * validation codes as 422 when a stored config no longer passes current rules.
+   * `can_mutate` and `lease_status` are the authoritative idle gate; device
+   * list status is not a substitute.
+   */
+  async getEdgeProfileProxy(orgId, edgeId, profileName) {
+    return this.request("GET", ENDPOINTS.ORG_EDGE_PROFILE_PROXY(orgId, edgeId, profileName));
+  }
+  /**
+   * Set/replace the profile's egress proxy (full triple every time) — IDLE
+   * ONLY: while the profile's hosted browser is running (a viewer session is
+   * open or a pod is otherwise live) the server answers 409
+   * `EDGE_PROFILE_IN_USE`; close the viewer, wait for idle scale-to-zero, and
+   * retry. The next cold start uses the new egress; browser login state is
+   * preserved across it. Other typed errors: the validation vocabulary
+   * (`INVALID_PROXY_SERVER`, `PROXY_AUTH_INCOMPLETE`,
+   * `PROXY_SERVER_FORBIDDEN_TARGET`, …), `EDGE_DELETING` (409), and
+   * `SECRETBOX_UNCONFIGURED` (503 — server cannot store credentials safely),
+   * and `EDGE_PROFILE_PROXY_STALE` (409 — expectedVersion lost a tab race).
+   */
+  async setEdgeProfileProxy(orgId, edgeId, profileName, req, expectedVersion) {
+    return this.request("PUT", ENDPOINTS.ORG_EDGE_PROFILE_PROXY(orgId, edgeId, profileName), req, void 0, false, {
+      headers: expectedVersion ? { "If-Match": `"proxy-${expectedVersion}"` } : void 0
+    });
+  }
+  /**
+   * Clear the profile's egress proxy; the next pod start egresses directly.
+   * Idle-only like set — 409 `EDGE_PROFILE_IN_USE` while the browser is live.
+   */
+  async clearEdgeProfileProxy(orgId, edgeId, profileName, expectedVersion) {
+    return this.request("DELETE", ENDPOINTS.ORG_EDGE_PROFILE_PROXY(orgId, edgeId, profileName), void 0, void 0, false, {
+      headers: expectedVersion ? { "If-Match": `"proxy-${expectedVersion}"` } : void 0
+    });
+  }
   /**
    * Execute a registry clip command on an Edge device.
    *
@@ -53737,6 +53884,8 @@ var ApiError = class extends Error {
   status;
   code;
   extras;
+  /** Retry-After delta seconds when the server supplies one. */
+  retryAfterSeconds;
   /** Attempted action (authorization denials) — e.g. "chat.add_member". */
   action;
   /** Target resource URI that was evaluated — e.g. "prll://cht_…". */
@@ -53756,6 +53905,9 @@ function buildApiError(res, rawErrorBody) {
   const errMsg = (typeof errorObj?.message === "string" ? errorObj.message : void 0) ?? (typeof errorBody.message === "string" ? errorBody.message : void 0) ?? (typeof errorBody.error === "string" ? errorBody.error : void 0);
   const errCode = (typeof errorObj?.code === "string" ? errorObj.code : void 0) ?? (typeof errorBody.code === "string" ? errorBody.code : void 0);
   const apiError = new ApiError(res.status, errMsg ?? res.statusText, errCode);
+  const retryAfter = Number(res.headers?.get("Retry-After"));
+  if (Number.isFinite(retryAfter) && retryAfter > 0)
+    apiError.retryAfterSeconds = retryAfter;
   const anchors = errorObj ?? errorBody;
   if (typeof anchors.action === "string")
     apiError.action = anchors.action;
@@ -55052,6 +55204,17 @@ function buildForkResultPrefix(results) {
 }
 
 // ../agent-core/dist/prompt-fragments.js
+function identityFromMe(me) {
+  return {
+    userId: me.id,
+    displayName: me.display_name,
+    title: me.public_profile?.title || void 0,
+    publicDescription: me.public_profile?.description || void 0,
+    // `||` on purpose: an empty-string instructions must also fall back to
+    // the deprecated description alias (empty means "unset" on this wire).
+    instructions: me.agent_profile?.instructions || me.agent_profile?.description || void 0
+  };
+}
 var PRLL_IDENTITY_BASE = `## You on Parall
 
 Parall is a shared workspace where humans and agents work side by side as equals.
@@ -55073,11 +55236,15 @@ function buildIdentity(agent) {
   const name = sanitizeProfileField(agent.displayName);
   const lines = [PRLL_IDENTITY_BASE, "", "### Your Parall Identity", ""];
   lines.push(`You are **${name}** (\`prll://${agent.userId}\`).`);
-  if (agent.description) {
-    const description = sanitizeProfileBlock(agent.description);
-    if (description) {
-      lines.push("", "### Your Agent Profile", "", description);
-    }
+  const title = agent.title ? sanitizeProfileField(agent.title) : "";
+  if (title)
+    lines.push(`Title: ${title}`);
+  const about = agent.publicDescription ? sanitizeProfileField(agent.publicDescription) : "";
+  if (about)
+    lines.push(`About: ${about}`);
+  const instructions = sanitizeProfileBlock(agent.instructions ?? agent.description ?? "");
+  if (instructions) {
+    lines.push("", "### Private instructions from your organization admins", "", instructions);
   }
   lines.push("", `When you see \`${agent.userId}\` or \`prll://${agent.userId}\` in messages, mentions, or events \u2014 that's you.`);
   return lines.join("\n");
@@ -57988,7 +58155,7 @@ var ParallAgentGateway = class {
       return { action: "skip" };
     if (chatInfo.type === "group" && chatInfo.agentRoutingMode !== "active") {
       const mentions = content.mentions ?? [];
-      const isMentioned = mentions.some((mention) => mention.user_id === this.opts.agentUserId || mention.user_id === MENTION_ALL_USER_ID);
+      const isMentioned = mentions.some((mention) => mentionTargetsUser(mention.user_id, this.opts.agentUserId, "agent"));
       if (!isMentioned)
         return { action: "skip" };
     }
@@ -60160,7 +60327,7 @@ async function getAgentMeWithLegacyFallback(client, orgId) {
       throw err;
     }
     const user = await client.getMe();
-    return { ...user, agent_profile: null };
+    return { ...user, agent_profile: null, public_profile: null };
   }
 }
 function buildInboundCtx(core, accountId, event, sessionKey, bodyForAgent, earlierEvents = []) {
@@ -60441,11 +60608,7 @@ var parallGateway = {
     });
     const me = await getAgentMeWithLegacyFallback(client, config.org_id);
     const agentUserId = me.id;
-    setAgentIdentity({
-      userId: agentUserId,
-      displayName: me.display_name,
-      description: me.agent_profile?.description ?? void 0
-    });
+    setAgentIdentity(identityFromMe(me));
     log?.info(`parall[${ctx.accountId}]: authenticated as ${me.display_name} (${agentUserId})`);
     const telemetry = await initAgentTelemetry("parall-openclaw-agent", "openclaw");
     const otelLog = createOtelLogger("agent", "openclaw-agent");
@@ -60537,7 +60700,15 @@ var parallGateway = {
         forkDeadlineMs: parseForkDeadlineMs(process.env.PRLL_FORK_DEADLINE_MS),
         dispatchDeadlineMs: parseDispatchDeadlineMs(process.env.PRLL_DISPATCH_DEADLINE_MS),
         onConfigUpdate: async () => {
-          await fetchAndApplyPlatformConfig(configManagerOpts);
+          try {
+            await fetchAndApplyPlatformConfig(configManagerOpts);
+          } finally {
+            try {
+              setAgentIdentity(identityFromMe(await getAgentMeWithLegacyFallback(client, config.org_id)));
+            } catch (err) {
+              log?.warn(`parall[${ctx.accountId}]: /agents/me refetch failed (keeping last-known identity): ${String(err)}`);
+            }
+          }
         },
         onSessionReady: async ({ activeSessionId }) => {
           setParallAccountState(ctx.accountId, {

package/package.json

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

package/skills/parall-platform/SKILL.md

@@ -19,8 +19,17 @@ parall whoami
 parall members list          # All org members (humans + agents)
 parall agents list           # Agents only
 parall users get prll://usr_xxx     # Get user details by ID
+parall members profile prll://usr_xxx   # A member's public profile (title / about)
+parall agents instructions   # Your own private Instructions (admin-maintained)
 ```
 
+Every member carries an org-scoped public profile: `title` (role, e.g.
+"Platform Lead") and `description` (a short about). `members list` includes
+both — use them to route work to the right person or agent. Your own system
+prompt already contains your public profile and your private Instructions;
+you cannot edit either of them — if yours should change, DM a Human org
+admin and ask.
+
 Create a hosted agent when the user asks for a Parall-managed runtime. Hosted
 provisioning is asynchronous: creation means the agent identity, API key, and
 machine record were accepted, not that the runtime is online yet. Use `--wait`

package/skills/parall-tasks/SKILL.md

@@ -39,7 +39,7 @@ parall tasks list --assignee-id prll://usr_xxx   # first page only (default 20)
 parall tasks subtasks prll://tsk_xxx             # children of a single parent task
 
 # Create a task (add --parent-id to make it a SUBTASK of another task)
-parall tasks create --title "Task title" [--assignee-id prll://usr_xxx] [--parent-id prll://tsk_xxx] [--project-id prll://prj_xxx] [--due-date 2026-08-01]
+parall tasks create --title "Task title" [--assignee-id prll://usr_xxx] [--parent-id prll://tsk_xxx] [--project-id prll://prj_xxx] [--planned-start 2026-07-20] [--due-date 2026-08-01]
 
 # Update task status — add --placement end so the task lands at the end of
 # its NEW status column (a bare --status keeps the old column's sort_order)
@@ -50,6 +50,12 @@ parall tasks update prll://tsk_xxx --status done --placement end
 parall tasks update prll://tsk_xxx --due-date 2026-08-01
 parall tasks update prll://tsk_xxx --due-date none
 
+# Planned start — same grammar as --due-date; must be on or before the due
+# date when both are set. This is the planned schedule's left-edge date,
+# NOT when work actually began (that stays on lifecycle timestamps)
+parall tasks update prll://tsk_xxx --planned-start 2026-07-20
+parall tasks update prll://tsk_xxx --planned-start none
+
 # Move a task to the end of its status column
 parall tasks update prll://tsk_xxx --placement end
 

package/src/gateway.ts

@@ -10,6 +10,7 @@ import {
   parseShutdownDeadlineMs,
   parseForkDeadlineMs,
   parseDispatchDeadlineMs,
+  identityFromMe,
   initAgentTelemetry,
   createOtelLogger,
   type DispatchAdapter,
@@ -73,10 +74,14 @@ async function getAgentMeWithLegacyFallback(client: ParallClient, orgId: string)
       throw err;
     }
     const user = await client.getMe();
-    return { ...user, agent_profile: null };
+    return { ...user, agent_profile: null, public_profile: null };
   }
 }
 
+// hooks.ts rebuilds the prompt from the process-global identity on EVERY
+// prompt build, so a refreshed identity (via the shared identityFromMe)
+// reaches the very next turn without any restart.
+
 function buildInboundCtx(
   core: PluginRuntime,
   accountId: string,
@@ -408,11 +413,7 @@ export const parallGateway: ChannelGatewayAdapter<ResolvedParallAccount> = {
 
     const me = await getAgentMeWithLegacyFallback(client, config.org_id);
     const agentUserId = me.id;
-    setAgentIdentity({
-      userId: agentUserId,
-      displayName: me.display_name,
-      description: me.agent_profile?.description ?? undefined,
-    });
+    setAgentIdentity(identityFromMe(me));
     log?.info(`parall[${ctx.accountId}]: authenticated as ${me.display_name} (${agentUserId})`);
 
     const telemetry = await initAgentTelemetry('parall-openclaw-agent', 'openclaw');
@@ -518,7 +519,25 @@ export const parallGateway: ChannelGatewayAdapter<ResolvedParallAccount> = {
         forkDeadlineMs: parseForkDeadlineMs(process.env.PRLL_FORK_DEADLINE_MS),
         dispatchDeadlineMs: parseDispatchDeadlineMs(process.env.PRLL_DISPATCH_DEADLINE_MS),
         onConfigUpdate: async () => {
-          await fetchAndApplyPlatformConfig(configManagerOpts);
+          // Identity rides the same agent_config.update nudge: refresh the
+          // process-global identity so the next prompt build (hooks.ts
+          // before_prompt_build) carries the new title / public description /
+          // instructions. The finally keeps it running even when the platform
+          // config refresh throws (their failure domains are independent);
+          // identity failure keeps the last-known-good value.
+          try {
+            await fetchAndApplyPlatformConfig(configManagerOpts);
+          } finally {
+            try {
+              setAgentIdentity(
+                identityFromMe(await getAgentMeWithLegacyFallback(client, config.org_id)),
+              );
+            } catch (err) {
+              log?.warn(
+                `parall[${ctx.accountId}]: /agents/me refetch failed (keeping last-known identity): ${String(err)}`,
+              );
+            }
+          }
         },
         onSessionReady: async ({ activeSessionId }) => {
           setParallAccountState(ctx.accountId, {