instar 0.28.89 → 0.28.90

package/dist/server/routes.js

@@ -10306,11 +10306,48 @@ export function createRoutes(ctx) {
     // HTTP endpoint.
     router.post('/threadline/relay-send', async (req, res) => {
         const relayClient = ctx.threadlineRelayClient;
-        const { targetAgent, message, threadId, waitForReply, timeoutSeconds } = req.body;
+        const { targetAgent, message, threadId, waitForReply, timeoutSeconds, originTopicId, purpose, } = req.body;
         if (!targetAgent || !message) {
             res.status(400).json({ success: false, error: 'Missing required fields: targetAgent, message' });
             return;
         }
+        // THREAD-TOPIC-LINKAGE-SPEC.md: validate the optional originTopicId early.
+        // We accept either number or numeric string; ignore on type mismatch (the
+        // send still goes through, just without topic linkage).
+        let resolvedOriginTopicId;
+        if (originTopicId !== undefined && originTopicId !== null) {
+            const asNum = typeof originTopicId === 'number' ? originTopicId : Number(originTopicId);
+            if (Number.isFinite(asNum) && Number.isInteger(asNum) && asNum > 0) {
+                resolvedOriginTopicId = asNum;
+            }
+        }
+        const resolvedPurpose = typeof purpose === 'string' && purpose.trim().length > 0
+            ? purpose.trim().slice(0, 1024)
+            : undefined;
+        /**
+         * Outbound origin capture (spec §5.2). Idempotent: handler returns the
+         * existing commitment when one already exists for this threadId, so 4
+         * call-sites below are safe.
+         */
+        const captureOrigin = async (effThreadId, remoteAgentDisplay) => {
+            if (!ctx.topicLinkageHandler)
+                return;
+            if (!resolvedOriginTopicId)
+                return;
+            try {
+                ctx.topicLinkageHandler.captureOriginOnSend({
+                    threadId: effThreadId,
+                    remoteAgent: remoteAgentDisplay,
+                    remoteAgentDisplayName: remoteAgentDisplay,
+                    originTopicId: resolvedOriginTopicId,
+                    purpose: resolvedPurpose,
+                    subject: 'Threadline conversation',
+                });
+            }
+            catch (err) {
+                console.warn(`[relay-send] captureOrigin failed for thread ${effThreadId}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        };
         // Validate message size (64KB limit matching inbound)
         if (Buffer.byteLength(message, 'utf-8') > 64 * 1024) {
             res.status(413).json({ success: false, error: 'Message too large (64KB limit)' });
@@ -10589,6 +10626,7 @@ export function createRoutes(ctx) {
                                             outcome,
                                         }).catch(() => { });
                                     }
+                                    await captureOrigin(effectiveThreadId, localTarget.name);
                                     if (waitForReply) {
                                         const reply = await waitForThreadlineReply(ctx, localTarget.name, effectiveThreadId, timeoutSeconds);
                                         res.json({
@@ -10600,6 +10638,7 @@ export function createRoutes(ctx) {
                                             deliveryOutcome: outcome,
                                             threadline: tl,
                                             reply,
+                                            topicLinkageStamped: resolvedOriginTopicId !== undefined,
                                         });
                                     }
                                     else {
@@ -10611,6 +10650,7 @@ export function createRoutes(ctx) {
                                             deliveryPath: 'local',
                                             deliveryOutcome: outcome,
                                             threadline: tl,
+                                            topicLinkageStamped: resolvedOriginTopicId !== undefined,
                                         });
                                     }
                                     return;
@@ -10699,6 +10739,7 @@ export function createRoutes(ctx) {
                     outcome: 'relay-sent',
                 }).catch(() => { });
             }
+            await captureOrigin(effectiveRelayThreadId, targetAgent);
             if (waitForReply) {
                 const reply = await waitForThreadlineReply(ctx, resolvedId, effectiveRelayThreadId, timeoutSeconds);
                 res.json({
@@ -10708,6 +10749,7 @@ export function createRoutes(ctx) {
                     resolvedAgent: resolvedId,
                     deliveryPath: 'relay',
                     reply,
+                    topicLinkageStamped: resolvedOriginTopicId !== undefined,
                 });
             }
             else {
@@ -10717,6 +10759,7 @@ export function createRoutes(ctx) {
                     threadId: effectiveRelayThreadId,
                     resolvedAgent: resolvedId,
                     deliveryPath: 'relay',
+                    topicLinkageStamped: resolvedOriginTopicId !== undefined,
                 });
             }
         }