@parall/claude-agent 1.48.0 → 1.50.0

package/dist/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import * as os from 'node:os';
-import { ParallAgentGateway, capabilityBinDir, configureHttpKeepAlive, createPlatformConfigManager, createLogger, createOtelLogger, childLogger, deriveModelIsPin, materializeChannelCapabilities, resolveRuntimeModel, parseShutdownDeadlineMs, parseForkDeadlineMs, parseDispatchDeadlineMs, parseProviderConfig, clearAllProviderCreds, llmSource, initAgentTelemetry, } from '@parall/agent-core';
+import { ParallAgentGateway, capabilityBinDir, configureHttpKeepAlive, createPlatformConfigManager, createLogger, createOtelLogger, childLogger, deriveModelIsPin, materializeChannelCapabilities, resolveRuntimeModel, parseShutdownDeadlineMs, parseForkDeadlineMs, parseDispatchDeadlineMs, parseProviderConfig, clearAllProviderCreds, llmSource, identityFromMe, initAgentTelemetry, } from '@parall/agent-core';
 import { ApiError, ParallClient, ParallWs } from '@parall/sdk';
 import { buildClaudeRuntimeKey, contextFilePathForSession, dispatchContextDirPath, resolveClaudeAgentConfig, resolveWsUrl, sessionStateFilePathForRuntime, stepIdFilePathForSession, } from './config.js';
 import { ClaudeCodeAdapter } from './dispatch.js';
@@ -17,7 +17,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 resolveProviderEnv() {
@@ -65,11 +65,14 @@ async function main() {
         activeLog = agentLog;
         // Shared by the initial workspace write and the config-refresh rewrite of
         // .parall/system-prompt.md — both need identity + capability fragments.
-        const agentIdentity = {
-            userId: agentUserId,
-            displayName: me.display_name,
-            description: me.agent_profile?.description ?? undefined,
-        };
+        // Mutable on purpose: refreshPlatformConfig refetches it (see
+        // identityFromMe) so profile edits reach the next activation.
+        let agentIdentity = identityFromMe(me);
+        let lastIdentitySnapshot = JSON.stringify(agentIdentity);
+        // Last successful /agents/me profile — deriveModelIsPin's legacy fallback
+        // (old servers omit model_is_pin) must not flip a pinned model to floor
+        // just because one refresh round-trip failed.
+        let lastKnownAgentProfile = me.agent_profile;
         const runtimeKey = config.runtimeKey || buildClaudeRuntimeKey(agentUserId);
         const sessionStateFilePath = sessionStateFilePathForRuntime(config.stateDir, runtimeKey);
         const sessionManager = new ClaudeSessionManager(runtimeKey, sessionStateFilePath, agentLog);
@@ -147,21 +150,25 @@ async function main() {
         // (old server) — skip that round trip otherwise.
         const refreshPlatformConfig = async () => {
             const updated = await configMgr.fetch();
-            let refreshedProfile;
-            if (updated.modelIsPin === undefined) {
-                try {
-                    refreshedProfile = (await getAgentMeWithLegacyFallback(client, config.orgId))
-                        .agent_profile;
-                }
-                catch (err) {
-                    // configMgr.fetch() degrades to cache on failure; mirror that for the
-                    // legacy fallback so a transient /agents/me error doesn't reject this
-                    // config-refresh callback. No profile → deriveModelIsPin treats the
-                    // delivered model as a floor (safe default).
-                    agentLog.warn(`platform config refresh: legacy /agents/me fallback failed: ${String(err)}`);
-                }
+            // Unconditional /agents/me refetch: identity (title / public
+            // description / private instructions) rides the same
+            // agent_config.update nudge as model config. Failure degrades to the
+            // last-known-good identity, mirroring configMgr.fetch()'s cache
+            // fallback, so a transient error never rejects this callback. No
+            // profile → deriveModelIsPin treats the delivered model as a floor
+            // (safe default).
+            let refreshedMe;
+            try {
+                refreshedMe = await getAgentMeWithLegacyFallback(client, config.orgId);
+            }
+            catch (err) {
+                agentLog.warn(`platform config refresh: /agents/me refetch failed (keeping last-known identity): ${String(err)}`);
+            }
+            if (refreshedMe) {
+                agentIdentity = identityFromMe(refreshedMe);
+                lastKnownAgentProfile = refreshedMe.agent_profile;
             }
-            const isPin = deriveModelIsPin(updated, refreshedProfile);
+            const isPin = deriveModelIsPin(updated, lastKnownAgentProfile);
             const localEffort = process.env.CLAUDE_CODE_EFFORT_LEVEL?.trim() || null;
             adapter.updateConfig({
                 model: resolveRuntimeModel(isPin, updated.model, config.model) ?? null,
@@ -196,8 +203,15 @@ async function main() {
                 promptWritten = false;
                 agentLog.warn(`system prompt refresh write failed (retrying next refresh): ${String(err)}`);
             }
-            if (promptWritten && joinedFragments !== lastCapabilityFragments) {
+            // Identity changes ride the same lazy-respawn mechanism as capability
+            // fragments: the live child loaded its prompt at spawn, so a changed
+            // identity marks it for an out-of-turn --resume respawn and the next
+            // activation runs with the new prompt.
+            const identitySnapshot = JSON.stringify(agentIdentity);
+            if (promptWritten &&
+                (joinedFragments !== lastCapabilityFragments || identitySnapshot !== lastIdentitySnapshot)) {
                 lastCapabilityFragments = joinedFragments;
+                lastIdentitySnapshot = identitySnapshot;
                 adapter.requestProcessRestart();
             }
         };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parall/claude-agent",
-  "version": "1.48.0",
+  "version": "1.50.0",
   "description": "Claude Code bridge runtime for self-hosted Parall agents",
   "license": "MIT",
   "repository": {
@@ -25,9 +25,9 @@
     "src"
   ],
   "dependencies": {
-    "@parall/cli": "1.48.0",
-    "@parall/agent-core": "1.48.0",
-    "@parall/sdk": "1.48.0"
+    "@parall/agent-core": "1.50.0",
+    "@parall/cli": "1.50.0",
+    "@parall/sdk": "1.50.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/src/index.ts

@@ -18,6 +18,7 @@ import {
   parseProviderConfig,
   clearAllProviderCreds,
   llmSource,
+  identityFromMe,
   initAgentTelemetry,
 } from '@parall/agent-core';
 import { ApiError, ParallClient, ParallWs } from '@parall/sdk';
@@ -45,10 +46,12 @@ 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 };
   }
 }
 
+type AgentMe = Awaited<ReturnType<typeof getAgentMeWithLegacyFallback>>;
+
 function resolveProviderEnv(): void {
   const pc = parseProviderConfig(process.env);
   if (!pc) return;
@@ -97,11 +100,14 @@ async function main() {
     activeLog = agentLog;
     // Shared by the initial workspace write and the config-refresh rewrite of
     // .parall/system-prompt.md — both need identity + capability fragments.
-    const agentIdentity = {
-      userId: agentUserId,
-      displayName: me.display_name,
-      description: me.agent_profile?.description ?? undefined,
-    };
+    // Mutable on purpose: refreshPlatformConfig refetches it (see
+    // identityFromMe) so profile edits reach the next activation.
+    let agentIdentity = identityFromMe(me);
+    let lastIdentitySnapshot = JSON.stringify(agentIdentity);
+    // Last successful /agents/me profile — deriveModelIsPin's legacy fallback
+    // (old servers omit model_is_pin) must not flip a pinned model to floor
+    // just because one refresh round-trip failed.
+    let lastKnownAgentProfile = me.agent_profile;
     const runtimeKey = config.runtimeKey || buildClaudeRuntimeKey(agentUserId);
     const sessionStateFilePath = sessionStateFilePathForRuntime(config.stateDir, runtimeKey);
     const sessionManager = new ClaudeSessionManager(runtimeKey, sessionStateFilePath, agentLog);
@@ -192,24 +198,26 @@ async function main() {
     // (old server) — skip that round trip otherwise.
     const refreshPlatformConfig = async () => {
       const updated = await configMgr.fetch();
-      let refreshedProfile:
-        | Awaited<ReturnType<typeof getAgentMeWithLegacyFallback>>['agent_profile']
-        | undefined;
-      if (updated.modelIsPin === undefined) {
-        try {
-          refreshedProfile = (await getAgentMeWithLegacyFallback(client, config.orgId))
-            .agent_profile;
-        } catch (err) {
-          // configMgr.fetch() degrades to cache on failure; mirror that for the
-          // legacy fallback so a transient /agents/me error doesn't reject this
-          // config-refresh callback. No profile → deriveModelIsPin treats the
-          // delivered model as a floor (safe default).
-          agentLog.warn(
-            `platform config refresh: legacy /agents/me fallback failed: ${String(err)}`,
-          );
-        }
+      // Unconditional /agents/me refetch: identity (title / public
+      // description / private instructions) rides the same
+      // agent_config.update nudge as model config. Failure degrades to the
+      // last-known-good identity, mirroring configMgr.fetch()'s cache
+      // fallback, so a transient error never rejects this callback. No
+      // profile → deriveModelIsPin treats the delivered model as a floor
+      // (safe default).
+      let refreshedMe: AgentMe | undefined;
+      try {
+        refreshedMe = await getAgentMeWithLegacyFallback(client, config.orgId);
+      } catch (err) {
+        agentLog.warn(
+          `platform config refresh: /agents/me refetch failed (keeping last-known identity): ${String(err)}`,
+        );
+      }
+      if (refreshedMe) {
+        agentIdentity = identityFromMe(refreshedMe);
+        lastKnownAgentProfile = refreshedMe.agent_profile;
       }
-      const isPin = deriveModelIsPin(updated, refreshedProfile);
+      const isPin = deriveModelIsPin(updated, lastKnownAgentProfile);
       const localEffort = process.env.CLAUDE_CODE_EFFORT_LEVEL?.trim() || null;
       adapter.updateConfig({
         model: resolveRuntimeModel(isPin, updated.model, config.model) ?? null,
@@ -243,8 +251,17 @@ async function main() {
         promptWritten = false;
         agentLog.warn(`system prompt refresh write failed (retrying next refresh): ${String(err)}`);
       }
-      if (promptWritten && joinedFragments !== lastCapabilityFragments) {
+      // Identity changes ride the same lazy-respawn mechanism as capability
+      // fragments: the live child loaded its prompt at spawn, so a changed
+      // identity marks it for an out-of-turn --resume respawn and the next
+      // activation runs with the new prompt.
+      const identitySnapshot = JSON.stringify(agentIdentity);
+      if (
+        promptWritten &&
+        (joinedFragments !== lastCapabilityFragments || identitySnapshot !== lastIdentitySnapshot)
+      ) {
         lastCapabilityFragments = joinedFragments;
+        lastIdentitySnapshot = identitySnapshot;
         adapter.requestProcessRestart();
       }
     };