@parall/agent-core 1.56.2 → 1.57.1

package/dist/event-format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-format.d.ts","sourceRoot":"","sources":["../src/event-format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA+B1D,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAChC,MAAM,CAMR;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CA2IzD;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAEtE;AAyGD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAK/D;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CAkBnE"}
+{"version":3,"file":"event-format.d.ts","sourceRoot":"","sources":["../src/event-format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA+B1D,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAChC,MAAM,CAMR;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAoJzD;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAEtE;AAyGD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAK/D;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CAkBnE"}

package/dist/event-format.js

@@ -133,9 +133,18 @@ export function buildEventBody(event) {
         // internal cards/links in the reply body (they are dead links there).
         lines.push(`[Event: channel.message]`);
         const providerLabel = sanitizeMeta(event.channelProvider ?? 'external IM');
-        const convLabel = event.channelExternalConversationId
-            ? `${sanitizeMeta(event.channelExternalConversationId)} (${sanitizeMeta(event.channelConversationType ?? 'conversation')})`
-            : sanitizeMeta(event.channelConversationType ?? 'conversation');
+        const convType = sanitizeMeta(event.channelConversationType ?? 'conversation');
+        const convId = event.channelExternalConversationId
+            ? sanitizeMeta(event.channelExternalConversationId)
+            : undefined;
+        const convName = event.channelExternalConversationName
+            ? sanitizeMeta(event.channelExternalConversationName)
+            : undefined;
+        const convLabel = convName
+            ? `${convName} (${convId ? `${convId}, ` : ''}${convType})`
+            : convId
+                ? `${convId} (${convType})`
+                : convType;
         lines.push(`[Channel: ${providerLabel} | conversation: ${convLabel}]`);
         lines.push(`[From: ${sanitizeMeta(event.senderName)} (external user, not a Parall member)]`);
         if (event.channelExternalMessageId) {

package/dist/gateway-base.js

@@ -2553,9 +2553,7 @@ export class ParallAgentGateway {
             return true;
         }
         this.opts.log?.info(`channel message: ${msg.id} (conversation ${conv.id})`);
-        // Resolve the provider from the conversation's connection for prompt
-        // labeling + the reply-clip hint. The connection id → provider mapping
-        // is stable, so a tiny cache avoids one fetch per message.
+        // Cache connection → provider for prompt labeling and reply hints.
         let provider = this.channelConnectionProviders.get(conv.connection_id);
         if (!provider) {
             try {
@@ -2584,7 +2582,7 @@ export class ParallAgentGateway {
         const event = {
             type: 'channel_message',
             targetId: conv.id,
-            targetName: conv.external_user_name || conv.external_conversation_id,
+            targetName: conv.external_conversation_name || conv.external_user_name || conv.external_conversation_id,
             targetType: 'channel_conversation',
             senderId: msg.external_user_id || 'external',
             senderName: msg.external_user_name || msg.external_user_id || 'external user',
@@ -2594,6 +2592,7 @@ export class ParallAgentGateway {
             channelProvider: provider,
             channelConversationType: conv.conversation_type || undefined,
             channelExternalConversationId: conv.external_conversation_id,
+            channelExternalConversationName: conv.external_conversation_name || undefined,
             channelExternalMessageId: msg.external_message_id,
             channelCliCapable: cliCapable,
             ackSourceType: 'channel_message',

package/dist/types.d.ts

@@ -65,6 +65,8 @@ export type ParallEvent = {
     channelConversationType?: string;
     /** Provider-side conversation id (the reply's addressing target). */
     channelExternalConversationId?: string;
+    /** Provider-side visible conversation name; the stable id remains the reply target. */
+    channelExternalConversationName?: string;
     /** Provider-side message id (in-thread reply target). */
     channelExternalMessageId?: string;
     /** Live capability grant: the `<provider>-cli` capability is active, so

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parall/agent-core",
-  "version": "1.56.2",
+  "version": "1.57.1",
   "description": "Shared agent runtime orchestration helpers for Parall",
   "license": "MIT",
   "repository": {
@@ -36,7 +36,7 @@
     "@opentelemetry/sdk-metrics": "^1.30.0",
     "@opentelemetry/sdk-trace-node": "^1.30.0",
     "undici": "^7.24.8",
-    "@parall/sdk": "1.56.2"
+    "@parall/sdk": "1.57.1"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/src/event-format.ts

@@ -137,9 +137,18 @@ export function buildEventBody(event: ParallEvent): string {
     // internal cards/links in the reply body (they are dead links there).
     lines.push(`[Event: channel.message]`);
     const providerLabel = sanitizeMeta(event.channelProvider ?? 'external IM');
-    const convLabel = event.channelExternalConversationId
-      ? `${sanitizeMeta(event.channelExternalConversationId)} (${sanitizeMeta(event.channelConversationType ?? 'conversation')})`
-      : sanitizeMeta(event.channelConversationType ?? 'conversation');
+    const convType = sanitizeMeta(event.channelConversationType ?? 'conversation');
+    const convId = event.channelExternalConversationId
+      ? sanitizeMeta(event.channelExternalConversationId)
+      : undefined;
+    const convName = event.channelExternalConversationName
+      ? sanitizeMeta(event.channelExternalConversationName)
+      : undefined;
+    const convLabel = convName
+      ? `${convName} (${convId ? `${convId}, ` : ''}${convType})`
+      : convId
+        ? `${convId} (${convType})`
+        : convType;
     lines.push(`[Channel: ${providerLabel} | conversation: ${convLabel}]`);
     lines.push(`[From: ${sanitizeMeta(event.senderName)} (external user, not a Parall member)]`);
     if (event.channelExternalMessageId) {

package/src/gateway-base.ts

@@ -3091,9 +3091,7 @@ export class ParallAgentGateway {
     }
     this.opts.log?.info(`channel message: ${msg.id} (conversation ${conv.id})`);
 
-    // Resolve the provider from the conversation's connection for prompt
-    // labeling + the reply-clip hint. The connection id → provider mapping
-    // is stable, so a tiny cache avoids one fetch per message.
+    // Cache connection → provider for prompt labeling and reply hints.
     let provider = this.channelConnectionProviders.get(conv.connection_id);
     if (!provider) {
       try {
@@ -3128,7 +3126,8 @@ export class ParallAgentGateway {
     const event: ParallEvent = {
       type: 'channel_message',
       targetId: conv.id,
-      targetName: conv.external_user_name || conv.external_conversation_id,
+      targetName:
+        conv.external_conversation_name || conv.external_user_name || conv.external_conversation_id,
       targetType: 'channel_conversation',
       senderId: msg.external_user_id || 'external',
       senderName: msg.external_user_name || msg.external_user_id || 'external user',
@@ -3138,6 +3137,7 @@ export class ParallAgentGateway {
       channelProvider: provider,
       channelConversationType: conv.conversation_type || undefined,
       channelExternalConversationId: conv.external_conversation_id,
+      channelExternalConversationName: conv.external_conversation_name || undefined,
       channelExternalMessageId: msg.external_message_id,
       channelCliCapable: cliCapable,
       ackSourceType: 'channel_message',

package/src/types.ts

@@ -71,6 +71,8 @@ export type ParallEvent = {
   channelConversationType?: string;
   /** Provider-side conversation id (the reply's addressing target). */
   channelExternalConversationId?: string;
+  /** Provider-side visible conversation name; the stable id remains the reply target. */
+  channelExternalConversationName?: string;
   /** Provider-side message id (in-thread reply target). */
   channelExternalMessageId?: string;
   /** Live capability grant: the `<provider>-cli` capability is active, so