@parall/parall 1.49.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`,
@@ -51609,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`,
@@ -52129,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) {
@@ -53472,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));
@@ -55142,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.
@@ -55163,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");
@@ -58078,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" };
     }
@@ -60250,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 = []) {
@@ -60531,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");
@@ -60627,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.49.0",
+  "version": "1.50.0",
   "description": "OpenClaw channel plugin for Parall IM",
   "license": "MIT",
   "repository": {
@@ -16,8 +16,8 @@
     "openclaw.plugin.json"
   ],
   "dependencies": {
-    "@parall/agent-core": "1.49.0",
-    "@parall/sdk": "1.49.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/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, {