Merge pull request #1861 from InteropIO/metadata-updates-2026-04-22

Docs and metadata updates

Author: kriswest

Contributing_Guide.md

@@ -88,8 +88,8 @@ export class DefaultAppSupport implements AppSupport {
           instanceId: app.instanceId,
         },
         context,
+        metadata: metadata ?? {},
       },
-      metadata,
       meta: this.messaging.createMeta(),
     };
 
@@ -128,7 +128,6 @@ export class DefaultAppSupport implements AppSupport {
         provider: 'unknown',
         appMetadata: { appId: 'unknown', instanceId: 'unknown' },
         optionalFeatures: {
-          OriginatingAppMetadata: false,
           UserChannelMembershipAPIs: false,
           DesktopAgentBridging: false,
         },

packages/fdc3-agent-proxy/src/apps/DefaultAppSupport.ts

@@ -1,4 +1,11 @@
-import { ContextHandler, DisplayMetadata, Listener, Channel, EventHandler } from '@finos/fdc3-standard';
+import {
+  ContextHandler,
+  DisplayMetadata,
+  Listener,
+  Channel,
+  EventHandler,
+  AppProvidableContextMetadata,
+} from '@finos/fdc3-standard';
 import { Context } from '@finos/fdc3-context';
 import { Messaging } from '../Messaging';
 import { DefaultContextListener } from '../listeners/DefaultContextListener';
@@ -39,12 +46,13 @@ export class DefaultChannel implements Channel {
     this.addContextListener = this.addContextListener.bind(this);
   }
 
-  async broadcast(context: Context): Promise<void> {
+  async broadcast(context: Context, metadata?: AppProvidableContextMetadata): Promise<void> {
     const request: BroadcastRequest = {
       meta: this.messaging.createMeta(),
       payload: {
         channelId: this.id,
         context,
+        metadata: metadata ?? {},
       },
       type: 'broadcastRequest',
     };

packages/fdc3-agent-proxy/src/channels/DefaultChannel.ts

@@ -135,7 +135,7 @@ export class DefaultIntentSupport implements IntentSupport {
   async raiseIntent(
     intent: string,
     context: Context,
-    app: AppIdentifier,
+    app?: AppIdentifier | null,
     metadata?: AppProvidableContextMetadata
   ): Promise<IntentResolution> {
     const meta = this.messaging.createMeta();
@@ -144,7 +144,7 @@ export class DefaultIntentSupport implements IntentSupport {
       payload: {
         intent,
         context,
-        app,
+        app: app || undefined,
         metadata: {
           traceId: metadata?.traceId ?? v4(),
         },
@@ -195,9 +195,9 @@ export class DefaultIntentSupport implements IntentSupport {
       payload: {
         context,
         app,
-      },
-      metadata: {
-        traceId: metadata?.traceId ?? v4(),
+        metadata: {
+          traceId: metadata?.traceId ?? v4(),
+        },
       },
       meta,
     };

packages/fdc3-agent-proxy/src/intents/DefaultIntentSupport.ts

@@ -58,9 +58,9 @@ export class DefaultContextListener
 
   action(m: BroadcastEvent): void {
     const metadata: DesktopAgentProvidableContextMetadata = {
-      source: m.payload.originatingApp,
-      timestamp: m.meta.timestamp,
-      traceId: m.metadata?.traceId,
+      source: m.payload.metadata?.source,
+      timestamp: m.payload.metadata?.timestamp ?? m.meta.timestamp,
+      traceId: m.payload.metadata?.traceId,
     };
     this.handler(m.payload.context, metadata);
   }

packages/fdc3-agent-proxy/src/listeners/DefaultContextListener.ts

@@ -34,9 +34,9 @@ export class DefaultIntentListener extends AbstractListener<IntentHandler, AddIn
 
   action(m: IntentEvent): void {
     const done = this.handler(m.payload.context, {
-      source: m.payload.originatingApp as AppIdentifier,
-      timestamp: m.meta.timestamp,
-      traceId: m.metadata?.traceId ?? v4(),
+      source: m.payload.metadata?.source as AppIdentifier,
+      timestamp: m.payload.metadata?.timestamp ?? m.meta.timestamp,
+      traceId: m.payload.metadata?.traceId ?? v4(),
     });
 
     this.handleIntentResult(done, m);
@@ -54,7 +54,6 @@ export class DefaultIntentListener extends AbstractListener<IntentHandler, AddIn
         intentEventUuid: m.meta.eventUuid,
         raiseIntentRequestUuid: m.payload.raiseIntentRequestUuid,
       },
-      metadata: m.metadata,
     };
 
     return out;

packages/fdc3-agent-proxy/src/listeners/DefaultIntentListener.ts

@@ -51,6 +51,12 @@ Given(
       payload: {
         channelId: handleResolve(channel, this),
         context: contextMap[context],
+        metadata: {
+          timestamp: new Date(),
+          source: this.messaging!.getAppIdentifier(),
+          traceId: this.messaging!.createUUID(),
+          signature: '',
+        },
       },
       type: 'broadcastEvent',
     } as BroadcastEvent;

packages/fdc3-agent-proxy/test/step-definitions/channels.steps.ts

@@ -147,13 +147,14 @@ Given(
         timestamp: new Date(),
       },
       payload: {
-        originatingApp: {
-          appId: 'some-app-id',
-          desktopAgent: 'some-desktop-agent',
-        },
         context: handleResolve(context, this),
         intent,
         raiseIntentRequestUuid: 'request-id',
+        metadata: {
+          timestamp: new Date(),
+          source: this.messaging!.getAppIdentifier(),
+          traceId: this.messaging!.createUUID(),
+        },
       },
     };
 

packages/fdc3-agent-proxy/test/step-definitions/intents.steps.ts

@@ -29,7 +29,6 @@ export class GetInfo implements AutomaticResponse {
           fdc3Version: '2.0',
           optionalFeatures: {
             DesktopAgentBridging: false,
-            OriginatingAppMetadata: true,
             UserChannelMembershipAPIs: true,
           },
           provider: 'cucumber-provider',

packages/fdc3-agent-proxy/test/support/responses/GetInfo.ts

@@ -205,7 +205,6 @@ Given('A Dummy Desktop Agent in {string}', async function (this: CustomWorld, fi
         fdc3Version: '2.0',
         optionalFeatures: {
           DesktopAgentBridging: false,
-          OriginatingAppMetadata: false,
           UserChannelMembershipAPIs: false,
         },
         appMetadata: {