@masons/agent-network 0.6.15 → 0.6.17

package/dist/_vendor/runtime-adapter-client/types.js

@@ -0,0 +1,33 @@
+export const RUNTIME_ASSIGNMENT_FAILURE_CATEGORIES = [
+    "assignment_in_progress",
+    "target_unavailable_before_acceptance",
+    "acceptance_rejected",
+    "processing_failed_or_expired",
+    "reply_handle_stale",
+];
+export const RUNTIME_PROCESSING_STATES = [
+    "assigned_to_runtime_target",
+    "adapter_accepted",
+    "processing_started",
+    "reply_requested",
+    "reply_emitted",
+    "processing_failed",
+    "waiting_for_runtime_capability",
+    "target_lost_before_acceptance",
+    "processing_interrupted",
+    "expired",
+];
+export const ADAPTER_RUNTIME_PROCESSING_STATES = [
+    "adapter_accepted",
+    "processing_started",
+    "processing_failed",
+    "waiting_for_runtime_capability",
+    "target_lost_before_acceptance",
+    "processing_interrupted",
+    "expired",
+];
+export const SYSTEM_RUNTIME_PROCESSING_STATES = [
+    "assigned_to_runtime_target",
+    "reply_requested",
+    "reply_emitted",
+];

package/dist/_vendor/runtime-adapter-client/work-target.d.ts

@@ -0,0 +1,5 @@
+import type { RuntimeWorkTargetRef } from "./types.js";
+export declare function parseRuntimeWorkTargetRef(value: unknown): RuntimeWorkTargetRef | null;
+export declare function isRuntimeWorkTargetRef(value: unknown): value is RuntimeWorkTargetRef;
+export declare function sameRuntimeWorkTargetRef(left: RuntimeWorkTargetRef, right: RuntimeWorkTargetRef): boolean;
+//# sourceMappingURL=work-target.d.ts.map

package/dist/_vendor/runtime-adapter-client/work-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-target.d.ts","sourceRoot":"","sources":["../../../src/_vendor/runtime-adapter-client/work-target.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,GACb,oBAAoB,GAAG,IAAI,CAiC7B;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,oBAAoB,CAE/B;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,oBAAoB,EAC1B,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAeT"}

package/dist/_vendor/runtime-adapter-client/work-target.js

@@ -0,0 +1,47 @@
+export function parseRuntimeWorkTargetRef(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return null;
+    const raw = value;
+    if (raw.kind !== "projection_endpoint" ||
+        typeof raw.projection_endpoint_id !== "string" ||
+        raw.projection_endpoint_id.trim().length === 0) {
+        return null;
+    }
+    const projectionEndpointId = raw.projection_endpoint_id.trim();
+    if (raw.background_exchange_mode === "resident_endpoint") {
+        if (raw.runtime_session_id !== undefined)
+            return null;
+        return {
+            kind: "projection_endpoint",
+            projection_endpoint_id: projectionEndpointId,
+            background_exchange_mode: "resident_endpoint",
+        };
+    }
+    if ((raw.background_exchange_mode === "adapter_managed_turn" ||
+        raw.background_exchange_mode === "session_attached_pull") &&
+        typeof raw.runtime_session_id === "string" &&
+        raw.runtime_session_id.trim().length > 0) {
+        return {
+            kind: "projection_endpoint",
+            projection_endpoint_id: projectionEndpointId,
+            runtime_session_id: raw.runtime_session_id.trim(),
+            background_exchange_mode: raw.background_exchange_mode,
+        };
+    }
+    return null;
+}
+export function isRuntimeWorkTargetRef(value) {
+    return parseRuntimeWorkTargetRef(value) !== null;
+}
+export function sameRuntimeWorkTargetRef(left, right) {
+    if (left.kind !== right.kind ||
+        left.projection_endpoint_id !== right.projection_endpoint_id ||
+        left.background_exchange_mode !== right.background_exchange_mode) {
+        return false;
+    }
+    if (left.background_exchange_mode === "resident_endpoint") {
+        return right.background_exchange_mode === "resident_endpoint";
+    }
+    return (right.background_exchange_mode === left.background_exchange_mode &&
+        left.runtime_session_id === right.runtime_session_id);
+}

package/dist/channel-setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel-setup.d.ts","sourceRoot":"","sources":["../src/channel-setup.ts"],"names":[],"mappings":"AAgBA,UAAU,wBAAwB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IAMnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAuBD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAKD,wBAAgB,6BAA6B,IAAI,wBAAwB,CAKxE;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CAsC7B;AAED,wBAAgB,qBAAqB,IAAI,kBAAkB,GAAG,IAAI,CAejE;AAED,wBAAgB,yBAAyB,IAAI,kBAAkB,GAAG,IAAI,CAMrE;AAkED,wBAAgB,4BAA4B,IAAI,IAAI,CAGnD;AAED,eAAO,MAAM,oBAAoB,QAAqB,CAAC"}
+{"version":3,"file":"channel-setup.d.ts","sourceRoot":"","sources":["../src/channel-setup.ts"],"names":[],"mappings":"AAgBA,UAAU,wBAAwB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IAMnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAuBD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAKD,wBAAgB,6BAA6B,IAAI,wBAAwB,CAKxE;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CAqC7B;AAED,wBAAgB,qBAAqB,IAAI,kBAAkB,GAAG,IAAI,CAejE;AAED,wBAAgB,yBAAyB,IAAI,kBAAkB,GAAG,IAAI,CAMrE;AAkED,wBAAgB,4BAA4B,IAAI,IAAI,CAGnD;AAED,eAAO,MAAM,oBAAoB,QAAqB,CAAC"}

package/dist/channel-setup.js

@@ -29,7 +29,6 @@ export async function startOrGetChannelSetup(options) {
     const session = await beginBridgeHandoff({
         apiHost: options.apiHost,
         idpBaseUrl: options.idpBaseUrl,
-        sessionTopology: "single_session",
     });
     const record = {
         session,

package/dist/channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EAEd,MAAM,kCAAkC,CAAC;AAY1C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AA2C9D,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,IAAI,CAEvD;AAOD,wBAAgB,2BAA2B,IAAI,OAAO,CAIrD;AAGD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAE/D;AAaD,iBAAS,iCAAiC,CACxC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6BzB;AAED,eAAO,MAAM,4CAA4C,0CACtB,CAAC;AA0dpC,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAAC,mBAAmB,CA4NlE,CAAC"}
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EAEd,MAAM,kCAAkC,CAAC;AAa1C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAkD9D,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,IAAI,CAEvD;AAOD,wBAAgB,2BAA2B,IAAI,OAAO,CAIrD;AAGD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAE/D;AAaD,iBAAS,iCAAiC,CACxC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6BzB;AAED,eAAO,MAAM,4CAA4C,0CACtB,CAAC;AA+gBpC,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAAC,mBAAmB,CAiRlE,CAAC"}

package/dist/channel.js

@@ -1,15 +1,17 @@
 import { randomUUID } from "node:crypto";
 import createDebug from "debug";
-import { clearConnectorClient, clearConversationManager, extractNetworkConfig, getDmScope, initConnectorClient, initConversationManager, initToolConfig, isIdentityLinksConfigured, requirePluginRuntime, } from "./config.js";
+import { clearConnectorClient, clearConversationManager, extractNetworkConfig, getDmScope, initConnectorClient, initConversationManager, initToolConfig, isIdentityLinksConfigured, requirePlatformConfig, requirePluginRuntime, } from "./config.js";
 import { ConnectorClient } from "./connector-client.js";
 import { ConversationManager } from "./conversation-manager.js";
 import { clearEnvironmentContext } from "./environment-context.js";
 import { extractHandleFromAddress } from "./handle-utils.js";
 import { clearOwnerState, isOwnerAddress, markOwnerAddress, setCurrentTurnIsOwner, setCurrentTurnOwnerSignal, } from "./owner-session-state.js";
+import { ServicesRetainedRecipientConsumer, } from "./services-retained-recipient.js";
 import { createReplyTraceMetadata, ensureTraceMetadata, } from "./trace-metadata.js";
-import { setCurrentTurnSender, setCurrentTurnSenderAddress, } from "./turn-context.js";
+import { setCurrentTurnReplyRoute, setCurrentTurnSender, setCurrentTurnSenderAddress, } from "./turn-context.js";
 import { checkForUpdate } from "./update-check.js";
 const dbg = createDebug("agent-network:channel");
+const SERVICES_RETAINED_INBOX_PEER = "agent-network:services-retained-node-inbox";
 let notificationAttempted = false;
 let identityLinkingNudgePending = false;
 let storedOwnerPassportAddress = null;
@@ -110,7 +112,7 @@ function isDuplicate(from, content, sentAt) {
     }
     return false;
 }
-async function handleAddressedMessage(event, conversationManager, client, ctx) {
+async function handleAddressedMessage(event, conversationManager, client, ctx, options = {}) {
     const fromAddress = event.from;
     dbg("routing inbound message from=%s contentLength=%d", fromAddress, event.content.length);
     const inboundTrace = ensureTraceMetadata(event.metadata);
@@ -121,16 +123,21 @@ async function handleAddressedMessage(event, conversationManager, client, ctx) {
             console.warn(`[agent-network:channel] invalid traceparent from=${fromAddress} traceId=${inboundTrace.traceId} spanName=receive`);
         }
     }
-    if (isDuplicate(fromAddress, event.content, event.sentAt)) {
+    if (!options.servicesRetained &&
+        isDuplicate(fromAddress, event.content, event.sentAt)) {
         dbg("duplicate message suppressed from=%s sentAt=%s", fromAddress, event.sentAt);
-        return;
+        return true;
     }
     const inboundCorrelationId = typeof metadata.correlation_id === "string"
         ? metadata.correlation_id
         : undefined;
     const inboundMessageId = typeof event.messageId === "string" ? event.messageId : undefined;
-    const nodeRef = tryProjectNodeRef(metadata);
-    if (nodeRef) {
+    const nodeRef = options.servicesRetained ? null : tryProjectNodeRef(metadata);
+    if (options.servicesRetained) {
+        setCurrentTurnIsOwner(false);
+        setCurrentTurnOwnerSignal(null);
+    }
+    else if (nodeRef) {
         setCurrentTurnIsOwner(false);
         setCurrentTurnOwnerSignal(null);
         dbg("Full Node sender: kind=%s mstpAddress=%s handle=%s", nodeRef.kind, nodeRef.mstpAddress, nodeRef.handle ?? "(absent)");
@@ -161,35 +168,39 @@ async function handleAddressedMessage(event, conversationManager, client, ctx) {
             setCurrentTurnOwnerSignal(null);
         }
     }
-    const contact = nodeRef
-        ? deriveNodeName(nodeRef, fromAddress)
-        : deriveSenderName(event);
-    if (!conversationManager.getContactByAddress(fromAddress)) {
-        conversationManager.registerInbound(contact, fromAddress);
+    const contact = options.senderName ??
+        (nodeRef ? deriveNodeName(nodeRef, fromAddress) : deriveSenderName(event));
+    const replyAddress = options.routableReplyAddress ??
+        (options.servicesRetained ? undefined : fromAddress);
+    setCurrentTurnReplyRoute(replyAddress ? "routable" : "unavailable");
+    if (replyAddress && !conversationManager.getContactByAddress(replyAddress)) {
+        conversationManager.registerInbound(contact, replyAddress);
     }
-    setCurrentTurnSender(conversationManager.getContactByAddress(fromAddress) ?? null);
-    setCurrentTurnSenderAddress(fromAddress);
+    setCurrentTurnSender(contact);
+    setCurrentTurnSenderAddress(replyAddress ?? null);
     let runtime;
     try {
         runtime = requirePluginRuntime();
     }
     catch {
         dbg("plugin runtime not available, dropping message from=%s", fromAddress);
-        return;
+        return false;
     }
     if (!runtime.channel) {
         dbg("channelRuntime not available, dropping message from=%s", fromAddress);
-        return;
+        return false;
     }
-    const senderId = fromAddress;
+    const senderId = options.runtimePeerId ?? fromAddress;
     const senderName = contact;
-    conversationManager.recordInboundEnvelope(fromAddress, {
-        traceparent: typeof metadata.traceparent === "string"
-            ? metadata.traceparent
-            : undefined,
-        correlationId: inboundCorrelationId,
-        messageId: inboundMessageId,
-    });
+    if (replyAddress) {
+        conversationManager.recordInboundEnvelope(replyAddress, {
+            traceparent: typeof metadata.traceparent === "string"
+                ? metadata.traceparent
+                : undefined,
+            correlationId: inboundCorrelationId,
+            messageId: inboundMessageId,
+        });
+    }
     try {
         const route = await runtime.channel.routing.resolveAgentRoute({
             cfg: ctx.cfg,
@@ -211,7 +222,8 @@ async function handleAddressedMessage(event, conversationManager, client, ctx) {
             Timestamp: event.sentAt ? new Date(event.sentAt).getTime() : Date.now(),
             Provider: "agent-network",
             Surface: "agent-network",
-            MessageSid: `an:${extractHandleFromAddress(fromAddress)}:${randomUUID()}`,
+            MessageSid: options.messageSid ??
+                `an:${extractHandleFromAddress(fromAddress)}:${randomUUID()}`,
             CommandAuthorized: true,
             OriginatingChannel: "agent-network",
             OriginatingTo: senderId,
@@ -230,9 +242,11 @@ async function handleAddressedMessage(event, conversationManager, client, ctx) {
                 console.error(`[agent-network:${ctx.accountId}] session record error:`, err);
             },
         });
-        client.sendTyping(fromAddress, true);
+        if (replyAddress)
+            client.sendTyping(replyAddress, true);
         let replyDelivered = false;
         let suppressedBlocks = 0;
+        let dispatchError;
         try {
             await runtime.channel.reply.dispatchReplyWithBufferedBlockDispatcher({
                 ctx: msgCtx,
@@ -242,6 +256,10 @@ async function handleAddressedMessage(event, conversationManager, client, ctx) {
                         const text = payload.text;
                         if (!text)
                             return;
+                        if (!replyAddress) {
+                            suppressedBlocks++;
+                            return;
+                        }
                         if (!conversationManager.hasConversation(senderId)) {
                             suppressedBlocks++;
                             return;
@@ -250,7 +268,7 @@ async function handleAddressedMessage(event, conversationManager, client, ctx) {
                             correlationId: inboundCorrelationId,
                             messageId: inboundMessageId,
                         });
-                        const deliverResult = await conversationManager.send(senderId, text, replyTrace.metadata);
+                        const deliverResult = await conversationManager.send(replyAddress, text, replyTrace.metadata);
                         if (deliverResult.status === "sent") {
                             replyDelivered = true;
                         }
@@ -260,26 +278,49 @@ async function handleAddressedMessage(event, conversationManager, client, ctx) {
                         dbg("deliver reply senderId=%s status=%s contentLength=%d traceId=%s originalTraceId=%s spanName=send", senderId, deliverResult.status, text.length, replyTrace.traceId, replyTrace.originalTraceId ?? "(absent)");
                     },
                     onError: (err) => {
+                        dispatchError = err;
                         console.error(`[agent-network:${ctx.accountId}] dispatch error:`, err);
                     },
                 },
             });
+            if (dispatchError)
+                throw dispatchError;
             if (suppressedBlocks > 0) {
-                console.warn(`[agent-network:${ctx.accountId}] reply suppressed (conversation ended) from=${senderId} blocks=${suppressedBlocks}`);
+                console.warn(options.servicesRetained
+                    ? `[agent-network:${ctx.accountId}] reply not routed for Services-retained message: canonical envelope has no reply address blocks=${suppressedBlocks}`
+                    : `[agent-network:${ctx.accountId}] reply suppressed (conversation ended) from=${senderId} blocks=${suppressedBlocks}`);
             }
             else if (!replyDelivered) {
                 console.log(`[agent-network:${ctx.accountId}] dispatch completed without in-turn reply text from=${senderId} (tool-path reply or silence)`);
             }
         }
         finally {
-            client.sendTyping(fromAddress, false);
+            if (replyAddress)
+                client.sendTyping(replyAddress, false);
             conversationManager.commitEndedConversations();
         }
+        return true;
     }
     catch (err) {
         console.error(`[agent-network:${ctx.accountId}] inbound dispatch failed from=${fromAddress}:`, err);
+        return false;
     }
 }
+function servicesRetainedSenderName(message) {
+    const { display_name: displayName, handle } = message.envelope.sender;
+    if (displayName && handle)
+        return `${displayName} (handle: ${handle})`;
+    return displayName ?? handle ?? "MASONS sender unavailable";
+}
+function servicesRetainedBody(message) {
+    const sender = servicesRetainedSenderName(message);
+    const displayName = message.envelope.sender.display_name;
+    const handle = message.envelope.sender.handle;
+    return [
+        `[MASONS canonical message_ref=${JSON.stringify(message.envelope.message_ref)}; sender_display_name=${displayName === undefined ? "absent" : JSON.stringify(displayName)}; sender_handle=${handle === undefined ? "absent" : JSON.stringify(handle)}; sender_label=${JSON.stringify(sender)}; content_type=${JSON.stringify(message.contentType)}]`,
+        message.envelope.content,
+    ].join("\n\n");
+}
 const accounts = new Map();
 export const agentNetworkChannel = {
     id: "agent-network",
@@ -354,9 +395,35 @@ export const agentNetworkChannel = {
             const { connectorUrl, token } = ctx.account;
             const client = new ConnectorClient(connectorUrl, token);
             const conversationManager = new ConversationManager(client);
+            const servicesRetainedRecipient = new ServicesRetainedRecipientConsumer({
+                apiHost: requirePlatformConfig().apiHost,
+                runtimeKey: token,
+                logger: {
+                    info: (message) => console.log(`[agent-network:${ctx.accountId}] ${message}`),
+                    warn: (message) => console.warn(`[agent-network:${ctx.accountId}] ${message}`),
+                    error: (message, error) => console.error(`[agent-network:${ctx.accountId}] ${message}`, error ?? ""),
+                },
+                present: async (message) => handleAddressedMessage({
+                    event: "MESSAGE_RECEIVED",
+                    messageId: message.envelope.message_ref,
+                    from: SERVICES_RETAINED_INBOX_PEER,
+                    content: servicesRetainedBody(message),
+                    contentType: message.contentType,
+                    metadata: {},
+                    ...(message.envelope.sent_at && {
+                        sentAt: message.envelope.sent_at,
+                    }),
+                }, conversationManager, client, ctx, {
+                    runtimePeerId: SERVICES_RETAINED_INBOX_PEER,
+                    senderName: servicesRetainedSenderName(message),
+                    messageSid: `an:${message.envelope.message_ref}`,
+                    servicesRetained: true,
+                }),
+            });
             const state = {
                 client,
                 conversationManager,
+                servicesRetainedRecipient,
             };
             accounts.set(ctx.accountId, state);
             client.on("message_received", async (event) => {
@@ -364,6 +431,12 @@ export const agentNetworkChannel = {
                     return;
                 await handleAddressedMessage(event, conversationManager, client, ctx);
             });
+            client.on("custody_pending", () => {
+                void servicesRetainedRecipient.requestDrain();
+            });
+            client.on("connected", () => {
+                void servicesRetainedRecipient.requestDrain();
+            });
             client.on("delivery_pending", (event) => {
                 dbg("legacy delivery_pending ignored count=%d upTo=%s", event.count, event.upTo);
             });
@@ -375,6 +448,7 @@ export const agentNetworkChannel = {
                 console.error(`[agent-network:${ctx.accountId}]`, err.message);
             });
             ctx.abortSignal.addEventListener("abort", () => {
+                void servicesRetainedRecipient.stop();
                 client.disconnect();
             }, { once: true });
             const networkCfg = extractNetworkConfig(ctx.cfg);
@@ -384,6 +458,7 @@ export const agentNetworkChannel = {
             dbg("connected account=%s", ctx.accountId);
             initConnectorClient(client);
             initConversationManager(conversationManager);
+            void servicesRetainedRecipient.start();
             await new Promise((resolve) => {
                 if (ctx.abortSignal.aborted) {
                     resolve();
@@ -398,6 +473,7 @@ export const agentNetworkChannel = {
             dbg("stopping account %s", ctx.accountId);
             const state = accounts.get(ctx.accountId);
             if (state) {
+                await state.servicesRetainedRecipient.stop();
                 clearConversationManager();
                 clearConnectorClient();
                 state.client.removeAllListeners();

package/dist/cli-setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-setup.d.ts","sourceRoot":"","sources":["../src/cli-setup.ts"],"names":[],"mappings":"AAyFA,UAAU,eAAe;IACvB,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC9B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAOD,UAAU,gBAAgB;IACxB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAiFD,wBAAsB,KAAK,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmEhE"}
+{"version":3,"file":"cli-setup.d.ts","sourceRoot":"","sources":["../src/cli-setup.ts"],"names":[],"mappings":"AAyFA,UAAU,eAAe;IACvB,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC9B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAOD,UAAU,gBAAgB;IACxB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAgFD,wBAAsB,KAAK,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmEhE"}

package/dist/cli-setup.js

@@ -7,7 +7,6 @@ async function serverBridgeHandoffFlow(apiHost, idpBaseUrl, runtime, channelInpu
         apiHost,
         idpBaseUrl,
         channelInput,
-        sessionTopology: "single_session",
     });
     runtime.writeStdout([
         "",

package/dist/connector-client.d.ts

@@ -1,5 +1,5 @@
 import { EventEmitter } from "node:events";
-import { type AddressedMessageEvent, type DeliveryPendingEvent, type DeliveryStatusEvent, type SendAckEvent, type StructuredErrorEvent } from "./types.js";
+import { type AddressedMessageEvent, type CustodyPendingEvent, type DeliveryPendingEvent, type DeliveryStatusEvent, type SendAckEvent, type StructuredErrorEvent } from "./types.js";
 export declare class ConnectorError extends Error {
     readonly code: string;
     readonly to?: string;
@@ -7,6 +7,7 @@ export declare class ConnectorError extends Error {
 }
 type ConnectorClientEvents = {
     message_received: (event: AddressedMessageEvent) => void;
+    custody_pending: (event: CustodyPendingEvent) => void;
     send_ack: (event: SendAckEvent) => void;
     delivery_pending: (event: DeliveryPendingEvent) => void;
     delivery_status: (event: DeliveryStatusEvent) => void;

package/dist/connector-client.d.ts.map

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

package/dist/connector-client.js

@@ -3,7 +3,7 @@ import { EventEmitter } from "node:events";
 import createDebug from "debug";
 import WebSocket from "ws";
 import { setEnvironmentContext } from "./environment-context.js";
-import { CURRENT_PROTOCOL_VERSION, isAddressedMessage, isDeliveryCursor, isDeliveryPending, isDeliverySkip, isDeliveryStatus, isRegisterAck, isSendAck, isStructuredError, REGISTER_ACK_TIMEOUT_MS, SEND_ACK_TIMEOUT_MS, } from "./types.js";
+import { CURRENT_PROTOCOL_VERSION, isAddressedMessage, isCustodyPending, isDeliveryCursor, isDeliveryPending, isDeliverySkip, isDeliveryStatus, isRegisterAck, isSendAck, isStructuredError, REGISTER_ACK_TIMEOUT_MS, SEND_ACK_TIMEOUT_MS, } from "./types.js";
 import { PLUGIN_VERSION } from "./version.js";
 const dbg = createDebug("agent-network:connector");
 const dbgMsg = createDebug("agent-network:connector:msg");
@@ -201,6 +201,11 @@ export class ConnectorClient extends EventEmitter {
             this.handleAddressedMessage(parsed);
             return;
         }
+        if (isCustodyPending(parsed)) {
+            dbg("CUSTODY_PENDING");
+            this.emit("custody_pending", parsed);
+            return;
+        }
         if (isDeliveryPending(parsed)) {
             dbg("DELIVERY_PENDING count=%d upTo=%s", parsed.count, parsed.upTo);
             this.emit("delivery_pending", parsed);

package/dist/handoff.d.ts

@@ -3,7 +3,6 @@ export declare const DEFAULT_IDP_BASE_URL = "https://preview.masons.ai";
 export declare const HANDOFF_TIMEOUT_MS: number;
 export declare class SetupFlowError extends Error {
 }
-export type AgentSessionTopology = "single_session" | "multi_session";
 export interface BridgeHandoffResult {
     token: string;
     agent: {
@@ -23,7 +22,6 @@ export interface BeginBridgeHandoffOptions {
     apiHost: string;
     idpBaseUrl: string;
     channelInput?: string;
-    sessionTopology?: AgentSessionTopology;
 }
 export declare function beginBridgeHandoff(options: BeginBridgeHandoffOptions): Promise<BridgeHandoffSession>;
 export declare function completeBridgeHandoff(session: BridgeHandoffSession): Promise<BridgeHandoffResult>;

package/dist/handoff.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handoff.d.ts","sourceRoot":"","sources":["../src/handoff.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,SAAS,EAEf,MAAM,aAAa,CAAC;AAerB,eAAO,MAAM,oBAAoB,8BAA8B,CAAC;AAiBhE,eAAO,MAAM,kBAAkB,QAAgB,CAAC;AAKhD,qBAAa,cAAe,SAAQ,KAAK;CAAG;AAY5C,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG,eAAe,CAAC;AAEtE,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1D;AAQD,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAOhB,UAAU,EAAE,SAAS,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,oBAAoB,CAAC;CACxC;AAMD,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,oBAAoB,CAAC,CAyD/B;AAKD,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAmC9B"}
+{"version":3,"file":"handoff.d.ts","sourceRoot":"","sources":["../src/handoff.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,SAAS,EAEf,MAAM,aAAa,CAAC;AAerB,eAAO,MAAM,oBAAoB,8BAA8B,CAAC;AAiBhE,eAAO,MAAM,kBAAkB,QAAgB,CAAC;AAKhD,qBAAa,cAAe,SAAQ,KAAK;CAAG;AAY5C,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1D;AAQD,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAOhB,UAAU,EAAE,SAAS,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAMD,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,oBAAoB,CAAC,CAsD/B;AAKD,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAmC9B"}

package/dist/handoff.js

@@ -21,9 +21,6 @@ export async function beginBridgeHandoff(options) {
             headers: { "content-type": "application/json" },
             body: JSON.stringify({
                 cli_pubkey: cliPubkeySpki,
-                ...(options.sessionTopology !== undefined
-                    ? { session_topology: options.sessionTopology }
-                    : {}),
             }),
         });
         if (!initRes.ok) {

package/dist/plugin.d.ts

@@ -1,4 +1,4 @@
-export declare function buildInteractionContext(channelId: string | undefined, turnSender: string | null, turnSenderAddress: string | null): string | undefined;
+export declare function buildInteractionContext(channelId: string | undefined, turnSender: string | null, turnSenderAddress: string | null, turnReplyRoute?: "routable" | "unavailable" | null): string | undefined;
 interface OpenClawPluginApi {
     runtime: unknown;
     registerChannel(opts: {

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAqFA,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,iBAAiB,EAAE,MAAM,GAAG,IAAI,GAC/B,MAAM,GAAG,SAAS,CA6EpB;AAKD,UAAU,iBAAiB;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACjD,YAAY,CACV,IAAI,EAAE,OAAO,EACb,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3C,IAAI,CAAC;IACR,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GAAG,IAAI,CAAC;CACnE;AAED,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAaI,iBAAiB;CAqYhC,CAAC;AAEF,eAAe,MAAM,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAsFA,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,iBAAiB,EAAE,MAAM,GAAG,IAAI,EAChC,cAAc,GAAE,UAAU,GAAG,aAAa,GAAG,IAAW,GACvD,MAAM,GAAG,SAAS,CA+EpB;AAKD,UAAU,iBAAiB;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACjD,YAAY,CACV,IAAI,EAAE,OAAO,EACb,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3C,IAAI,CAAC;IACR,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GAAG,IAAI,CAAC;CACnE;AAED,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAaI,iBAAiB;CA2YhC,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/plugin.js

@@ -7,7 +7,7 @@ import { ownerNotesQueue } from "./owner-notes.js";
 import { consumeCurrentTurnIsOwner, consumeCurrentTurnOwnerSignal, } from "./owner-session-state.js";
 import { sentMessageBuffer } from "./sent-message-buffer.js";
 import { registerTools } from "./tools.js";
-import { consumeCurrentTurnSender, consumeCurrentTurnSenderAddress, setCurrentTurnChannelId, setCurrentTurnIsOwnerForTools, setCurrentTurnOwnerSignalForTools, } from "./turn-context.js";
+import { consumeCurrentTurnReplyRoute, consumeCurrentTurnSender, consumeCurrentTurnSenderAddress, setCurrentTurnChannelId, setCurrentTurnIsOwnerForTools, setCurrentTurnOwnerSignalForTools, } from "./turn-context.js";
 import { getUpdateInfo } from "./update-check.js";
 import { PLUGIN_VERSION } from "./version.js";
 function formatTimeAgo(timestamp) {
@@ -38,7 +38,7 @@ function drainAndFormatNotes(reportInstruction) {
         reportInstruction);
 }
 const MAX_INTERACTIONS = 5;
-export function buildInteractionContext(channelId, turnSender, turnSenderAddress) {
+export function buildInteractionContext(channelId, turnSender, turnSenderAddress, turnReplyRoute = null) {
     const cm = getConversationManager();
     if (!cm)
         return undefined;
@@ -71,7 +71,9 @@ export function buildInteractionContext(channelId, turnSender, turnSenderAddress
             : turnSender;
         return (`${header}\n${lines.join("\n")}\n` +
             `[This turn] From ${from}. ${initiated}\n` +
-            "Your text reply goes to this sender. " +
+            (turnReplyRoute === "unavailable"
+                ? "No reply route is available for this message. "
+                : "Your text reply goes to this sender. ") +
             "To report to your owner: masons_note_for_owner.");
     }
     if (isNetworkTurn) {
@@ -143,6 +145,7 @@ const plugin = {
             const turnOwnerSignal = consumeCurrentTurnOwnerSignal();
             const turnSender = consumeCurrentTurnSender();
             const turnSenderAddress = consumeCurrentTurnSenderAddress();
+            const turnReplyRoute = consumeCurrentTurnReplyRoute();
             setCurrentTurnChannelId(channelId ?? null);
             setCurrentTurnIsOwnerForTools(turnIsOwner);
             setCurrentTurnOwnerSignalForTools(turnOwnerSignal);
@@ -209,11 +212,15 @@ const plugin = {
                     }
                     else {
                         dynamicContext =
-                            "[Agent Network — Routing] This turn was triggered by a message " +
-                                "on the agent network. Your text reply will be sent to that sender — " +
-                                "your owner (Principal) will NOT see it. To report something to your owner, " +
-                                "call masons_note_for_owner.";
-                        const interactionCtx = buildInteractionContext(channelId, turnSender, turnSenderAddress);
+                            turnReplyRoute === "unavailable"
+                                ? "[Agent Network — Services-retained message] This canonical message carries no reply address. " +
+                                    "A plain text reply will NOT be routed to its sender. Do not infer or fabricate an address or Session. " +
+                                    "Treat the message as inbound information; to report something to your owner, call masons_note_for_owner."
+                                : "[Agent Network — Routing] This turn was triggered by a message " +
+                                    "on the agent network. Your text reply will be sent to that sender — " +
+                                    "your owner (Principal) will NOT see it. To report something to your owner, " +
+                                    "call masons_note_for_owner.";
+                        const interactionCtx = buildInteractionContext(channelId, turnSender, turnSenderAddress, turnReplyRoute);
                         if (interactionCtx) {
                             dynamicContext += `\n\n${interactionCtx}`;
                         }

package/dist/services-retained-recipient.d.ts

@@ -0,0 +1,58 @@
+import { type RuntimeExactTargetPresentationEnvelopeV1 } from "./_vendor/runtime-adapter-client/index.js";
+export interface ServicesRetainedRecipientPresentation {
+    contentType: string;
+    envelope: RuntimeExactTargetPresentationEnvelopeV1;
+}
+export interface ServicesRetainedRecipientLogger {
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string, error?: unknown): void;
+}
+export interface ServicesRetainedRecipientOptions {
+    apiHost: string;
+    runtimeKey: string;
+    present: (message: ServicesRetainedRecipientPresentation) => Promise<boolean>;
+    logger: ServicesRetainedRecipientLogger;
+    endpointNonce?: string;
+    retryDelayMs?: number;
+    minimumHeartbeatDelayMs?: number;
+    fetch?: typeof fetch;
+}
+export declare class ServicesRetainedRecipientConsumer {
+    private readonly clientConfig;
+    private readonly runtimeKey;
+    private readonly present;
+    private readonly logger;
+    private readonly endpointNonce;
+    private readonly retryDelayMs;
+    private readonly minimumHeartbeatDelayMs;
+    private endpoint;
+    private presentedOffer;
+    private acquirePermanentlyBlocked;
+    private consumptionPermanentlyBlocked;
+    private consecutiveHeartbeatNotFound;
+    private stopped;
+    private activationPromise;
+    private drainPromise;
+    private drainRequested;
+    private activationRetryTimer;
+    private drainRetryTimer;
+    private heartbeatTimer;
+    private stopPromise;
+    constructor(options: ServicesRetainedRecipientOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    requestDrain(): Promise<void>;
+    private activate;
+    private drain;
+    private consumePresentedOffer;
+    private scheduleHeartbeat;
+    private heartbeat;
+    private recoverEndpoint;
+    private scheduleActivationRetry;
+    private scheduleDrainRetry;
+    private clearActivationRetryTimer;
+    private clearDrainRetryTimer;
+    private clearHeartbeatTimer;
+}
+//# sourceMappingURL=services-retained-recipient.d.ts.map

package/dist/services-retained-recipient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"services-retained-recipient.d.ts","sourceRoot":"","sources":["../src/services-retained-recipient.ts"],"names":[],"mappings":"AACA,OAAO,EAML,KAAK,wCAAwC,EAI9C,MAAM,2CAA2C,CAAC;AAKnD,MAAM,WAAW,qCAAqC;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,wCAAwC,CAAC;CACpD;AAED,MAAM,WAAW,+BAA+B;IAC9C,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC/C;AAED,MAAM,WAAW,gCAAgC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,CAAC,OAAO,EAAE,qCAAqC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9E,MAAM,EAAE,+BAA+B,CAAC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAaD,qBAAa,iCAAiC;IAC5C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAC1D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8C;IACtE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IACzD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAS;IAEjD,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,yBAAyB,CAAS;IAC1C,OAAO,CAAC,6BAA6B,CAAS;IAC9C,OAAO,CAAC,4BAA4B,CAAK;IACzC,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,iBAAiB,CAA8B;IACvD,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,oBAAoB,CAA8C;IAC1E,OAAO,CAAC,eAAe,CAA8C;IACrE,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,WAAW,CAA8B;gBAErC,OAAO,EAAE,gCAAgC;IAc/C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAiCrB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;YAerB,QAAQ;YAoDR,KAAK;YA0EL,qBAAqB;IAwDnC,OAAO,CAAC,iBAAiB;YAcX,SAAS;IAgCvB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,uBAAuB;IAS/B,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,yBAAyB;IAKjC,OAAO,CAAC,oBAAoB;IAK5B,OAAO,CAAC,mBAAmB;CAI5B"}