agent-relay 11.8.0 → 11.8.2

package/dist/index.cjs

@@ -182,6 +182,8 @@ __export(index_exports, {
   MessageReadPredicate: () => MessageReadPredicate,
   OBSERVABILITY_UNAVAILABLE: () => OBSERVABILITY_UNAVAILABLE,
   RELAYCAST_SDK_VERSION: () => RELAYCAST_SDK_VERSION,
+  RELAY_ATTEST_SESSION_ID_ENV: () => RELAY_ATTEST_SESSION_ID_ENV,
+  RELAY_OBSERVER_SCOPES: () => RELAY_OBSERVER_SCOPES,
   RELAY_SERVICE_FAILURE_MESSAGE: () => RELAY_SERVICE_FAILURE_MESSAGE,
   RelayCapabilityError: () => RelayCapabilityError,
   RelayError: () => RelayError,
@@ -214,6 +216,7 @@ __export(index_exports, {
   createLogger: () => createLogger,
   createNotifyHandler: () => createNotifyHandler,
   createObserverEventSource: () => createObserverEventSource,
+  createObserverToken: () => createObserverToken,
   createRealtimeClient: () => createRealtimeClient,
   createRequestEnvelope: () => createRequestEnvelope,
   createRequestHandler: () => createRequestHandler,
@@ -222,6 +225,7 @@ __export(index_exports, {
   createWorkspace: () => createWorkspace,
   createWorkspaceClient: () => createWorkspaceClient,
   createWorkspaceFacade: () => createWorkspaceFacade,
+  currentReplaySessionRef: () => currentReplaySessionRef,
   defineHarness: () => defineHarness,
   findGitRoot: () => findGitRoot,
   formatAgentHandle: () => formatAgentHandle,
@@ -246,6 +250,7 @@ __export(index_exports, {
   isPlaceholderTargetFast: () => isPlaceholderTargetFast,
   isSpawnOrReleaseCommandFast: () => isSpawnOrReleaseCommandFast,
   isValidAgentName: () => isValidAgentName,
+  listObserverTokens: () => listObserverTokens,
   logAndTraceError: () => logAndTraceError,
   logRelayHandlerError: () => logRelayHandlerError,
   mapModelToCli: () => mapModelToCli,
@@ -276,10 +281,13 @@ __export(index_exports, {
   printUpdateNotification: () => printUpdateNotification,
   reduceAgentActivity: () => reduceAgentActivity,
   registerFacadeAction: () => registerFacadeAction,
+  replayMessageMetadata: () => replayMessageMetadata,
   resetPatternMetrics: () => resetPatternMetrics,
   resolveAgentName: () => resolveAgentName,
   resolveAgentToken: () => resolveAgentToken,
   resolveCommand: () => resolveCommand,
+  resolveReplaySessionRef: () => resolveReplaySessionRef,
+  revokeObserverToken: () => revokeObserverToken,
   routerLog: () => routerLog,
   safeRelayErrorMessage: () => safeRelayErrorMessage,
   stripAnsiFast: () => stripAnsiFast,
@@ -295,7 +303,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // ../../node_modules/@relaycast/sdk/dist/version.js
-var SDK_VERSION = "8.1.0";
+var SDK_VERSION = "8.2.0";
 
 // ../../node_modules/zod/v4/classic/external.js
 var external_exports = {};
@@ -14883,6 +14891,7 @@ var ReactionGroupSchema = external_exports.object({
 });
 
 // ../../node_modules/@relaycast/types/dist/agent.js
+var AGENT_RECOVERY_PROOF_HASH_PATTERN = /^[a-f0-9]{64}$/;
 var AgentTypeSchema = external_exports.enum(["agent", "human", "system"]);
 var AgentStatusSchema = external_exports.enum(["online", "offline", "away"]);
 var AgentSchema = external_exports.object({
@@ -14914,7 +14923,9 @@ var CreateAgentRequestSchema = external_exports.object({
   persona: external_exports.string().optional(),
   metadata: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
   skills: external_exports.array(AgentSkillInputSchema).optional(),
-  capabilities: external_exports.record(external_exports.string(), external_exports.unknown()).optional()
+  capabilities: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
+  recovery_proof_hash: external_exports.string().regex(AGENT_RECOVERY_PROOF_HASH_PATTERN).optional(),
+  work_unit_id: external_exports.string().min(1).optional()
 });
 var CreateAgentResponseSchema = external_exports.object({
   id: external_exports.string(),
@@ -15131,6 +15142,33 @@ var SessionMessagesResultSchema = external_exports.object({
 });
 
 // ../../node_modules/@relaycast/types/dist/workspace.js
+var WORKSPACE_CREATION_SOURCES = [
+  "api",
+  "sdk",
+  "cli",
+  "mcp",
+  "ci",
+  "relayflow",
+  "dashboard",
+  "other"
+];
+var WorkspaceCreationSourceSchema = external_exports.enum(WORKSPACE_CREATION_SOURCES);
+var WORKSPACE_USAGE_CLASSIFICATIONS = ["internal", "external", "unknown"];
+var WorkspaceUsageClassificationSchema = external_exports.enum(WORKSPACE_USAGE_CLASSIFICATIONS);
+var provenanceIdentifier = external_exports.string().min(1).max(256).regex(/^[A-Za-z0-9._:/@-]+$/, "must contain only letters, numbers, dot, underscore, colon, slash, @, or dash");
+var WorkspaceProvenanceInputSchema = external_exports.object({
+  source: WorkspaceCreationSourceSchema,
+  origin_id: provenanceIdentifier.optional(),
+  classification: WorkspaceUsageClassificationSchema.optional()
+});
+var WorkspaceProvenanceSchema = WorkspaceProvenanceInputSchema.extend({
+  source_basis: external_exports.enum(["declared", "origin_client", "default"]),
+  origin_actor: external_exports.string().optional(),
+  actor_user_id: external_exports.string().optional(),
+  actor_machine_id: external_exports.string().optional(),
+  actor_org_id: external_exports.string().optional(),
+  actor_org_slug: external_exports.string().optional()
+});
 var WorkspaceSchema = external_exports.object({
   id: external_exports.string(),
   name: external_exports.string(),
@@ -15141,11 +15179,17 @@ var WorkspaceSchema = external_exports.object({
   effective_retention: external_exports.object({
     messages: EffectiveMessageRetentionSchema
   }).optional(),
-  expires_at: external_exports.string().nullable().optional()
+  expires_at: external_exports.string().nullable().optional(),
+  provenance: WorkspaceProvenanceSchema.nullable().default(null),
+  usage_classification: WorkspaceUsageClassificationSchema.default("unknown"),
+  classification_source: external_exports.enum(["creator", "operator", "unclassified"]).default("unclassified"),
+  classification_reason: external_exports.string().nullable().default(null),
+  classified_at: external_exports.string().nullable().default(null)
 });
 var CreateWorkspaceRequestSchema = external_exports.object({
   name: external_exports.string(),
-  expires_in_seconds: external_exports.number().int().min(60).max(30 * 24 * 60 * 60).optional()
+  expires_in_seconds: external_exports.number().int().min(60).max(30 * 24 * 60 * 60).optional(),
+  provenance: WorkspaceProvenanceInputSchema.optional()
 });
 var CreateWorkspaceResponseSchema = external_exports.object({
   workspace_id: external_exports.string(),
@@ -15972,6 +16016,8 @@ var SERVER_TELEMETRY_EVENTS = [
   "relaycast_server_legacy_identity_claimed",
   "relaycast_server_agent_deleted",
   "relaycast_server_agent_token_rotated",
+  "relaycast_server_agent_identity_taken_over",
+  "relaycast_server_agent_token_revoked",
   "relaycast_server_channel_created",
   "relaycast_server_channel_updated",
   "relaycast_server_channel_topic_updated",
@@ -16196,6 +16242,15 @@ var FleetAgentRegisterMessageSchema = external_exports.object({
   session_ref: external_exports.string().optional(),
   resumable: external_exports.boolean().optional()
 }).strict();
+var FleetAgentRecoverMessageSchema = external_exports.object({
+  ...FleetRequestEnvelopeFields,
+  type: external_exports.literal("agent.recover"),
+  name: external_exports.string(),
+  expected_agent_id: external_exports.string(),
+  invocation_id: external_exports.string().optional(),
+  session_ref: external_exports.string().optional(),
+  resumable: external_exports.boolean().optional()
+}).strict();
 var FleetAgentDeregisterMessageSchema = external_exports.object({
   ...FleetRequestEnvelopeFields,
   type: external_exports.literal("agent.deregister"),
@@ -16300,6 +16355,7 @@ var FleetBrokerToRelaycastNonActionResultMessageSchema = external_exports.discri
   FleetNodeDeregisterMessageSchema,
   FleetNodeSpawnMessageSchema,
   FleetAgentRegisterMessageSchema,
+  FleetAgentRecoverMessageSchema,
   FleetAgentDeregisterMessageSchema,
   FleetDeliveryAckMessageSchema,
   FleetInventorySyncMessageSchema
@@ -17227,6 +17283,14 @@ var AgentClient = class {
   async heartbeat() {
     await this.presence.heartbeat();
   }
+  /** Authenticated self-rollover for this agent identity. */
+  async rotateToken(name) {
+    return this.client.post(`/v1/agents/${encodeURIComponent(name)}/rotate-token`, {});
+  }
+  /** Enroll or rotate this agent's server-owned recovery verifier. */
+  async enrollRecoveryCredential(data) {
+    return this.client.post("/v1/agent/recovery-credential", data);
+  }
   /**
    * Tear down this client's WebSocket and mark the agent offline.
    *
@@ -17958,12 +18022,17 @@ function emitCompatibilityTelemetry(event, metadata = {}) {
   const detail = { event, metadata };
   target.dispatchEvent(new CustomEventCtor(COMPAT_EVENT_NAME, { detail }));
 }
-function appendLegacySuffix(baseName) {
-  const suffix = Math.random().toString(16).slice(2, 6).padEnd(4, "0");
-  return `${baseName}-${suffix}`;
-}
-function isNameConflictError(err) {
-  return err instanceof RelayError && err.code === "name_conflict";
+
+// ../../node_modules/@relaycast/sdk/dist/workspace-provenance.js
+function toWorkspaceProvenanceInput(provenance) {
+  if (!provenance) {
+    return { source: "sdk" };
+  }
+  const { originId, ...wireProvenance } = provenance;
+  return {
+    ...wireProvenance,
+    ...originId !== void 0 ? { origin_id: originId } : {}
+  };
 }
 
 // ../../node_modules/@relaycast/sdk/dist/relay.js
@@ -18065,7 +18134,8 @@ var RelayCast = class _RelayCast {
       },
       body: JSON.stringify({
         name,
-        ...resolved.expiresInSeconds !== void 0 ? { expires_in_seconds: resolved.expiresInSeconds } : {}
+        ...resolved.expiresInSeconds !== void 0 ? { expires_in_seconds: resolved.expiresInSeconds } : {},
+        provenance: toWorkspaceProvenanceInput(resolved.provenance)
       })
     });
     let parsed;
@@ -18146,53 +18216,18 @@ var RelayCast = class _RelayCast {
       workspaceId: await this.resolveWorkspaceId()
     };
   }
-  async registerWithLegacySuffix(data) {
-    const maxAttempts = 5;
-    let candidateName = data.name;
-    for (let attempt = 0; attempt <= maxAttempts; attempt += 1) {
-      try {
-        return await this.agents.register({ ...data, name: candidateName });
-      } catch (err) {
-        if (!isNameConflictError(err) || attempt === maxAttempts) {
-          throw err;
-        }
-        candidateName = appendLegacySuffix(data.name);
-      }
-    }
-    throw new RelayError("transport_error", "Failed to register agent identity after suffix retries");
-  }
   registerTypedIdentity(type, data) {
     return this.agents.register({ ...data, type });
   }
   async registerAgent(data) {
-    const { strict, ...request } = data;
-    if (strict) {
-      return this.agents.register(request);
-    }
-    emitCompatibilityTelemetry("agents.registerAgent.legacy_suffix", {
-      requested_name: data.name
-    });
-    return this.registerWithLegacySuffix(request);
+    const { strict: _strict, ...request } = data;
+    return this.agents.register(request);
   }
   async registerOrRotate(data) {
-    try {
-      return await this.registerAgent({ ...data, strict: true });
-    } catch (err) {
-      if (isNameConflictError(err)) {
-        const agent = await this.agents.get(data.name);
-        const { token } = await this.agents.rotateToken(agent.name);
-        this.rememberIdentity(agent.id, agent.name);
-        const createdAt = agent.createdAt ?? agent.lastSeen;
-        return {
-          id: agent.id,
-          name: agent.name,
-          token,
-          status: agent.status,
-          createdAt
-        };
-      }
-      throw err;
-    }
+    emitCompatibilityTelemetry("agents.registerOrRotate.deprecated", {
+      replacement: "agents.register or agents.recover"
+    });
+    return this.registerAgent(data);
   }
   async resolveIdentity() {
     return this.resolveIdentityInternal();
@@ -18378,15 +18413,23 @@ var RelayCast = class _RelayCast {
     },
     get: (name) => this.client.get(`/v1/agents/${encodeURIComponent(name)}`),
     me: (apiToken) => (apiToken ? this.client.withApiKey(apiToken) : this.client).get("/v1/agent"),
-    rotateToken: (name) => this.client.post(`/v1/agents/${encodeURIComponent(name)}/rotate-token`, {}),
+    rotateToken: (name, agentToken) => this.client.withApiKey(agentToken).post(`/v1/agents/${encodeURIComponent(name)}/rotate-token`, {}),
+    recover: async ({ name, ...data }) => {
+      const result = await this.client.post(`/v1/agents/${encodeURIComponent(name)}/recover`, data);
+      this.rememberIdentity(result.agentId, result.name);
+      return result;
+    },
+    takeOver: ({ name, ...data }) => this.client.post(`/v1/agents/${encodeURIComponent(name)}/takeover`, data),
+    revokeToken: ({ name, ...data }) => this.client.post(`/v1/agents/${encodeURIComponent(name)}/revoke-token`, data),
+    enrollRecoveryCredential: (data, agentToken) => this.client.withApiKey(agentToken).post("/v1/agent/recovery-credential", data),
     update: (name, data) => this.client.patch(`/v1/agents/${encodeURIComponent(name)}`, data),
     delete: (name) => this.client.delete(`/v1/agents/${encodeURIComponent(name)}`),
     presence: () => this.client.get("/v1/agents/presence"),
     registerOrGet: async (data) => {
       emitCompatibilityTelemetry("agents.registerOrGet.deprecated", {
-        replacement: "agents.registerOrRotate"
+        replacement: "agents.register or agents.recover"
       });
-      return this.registerOrRotate(data);
+      return this.agents.register(data);
     },
     registerAgent: (data) => this.registerAgent(data),
     registerOrRotate: (data) => this.registerOrRotate(data),
@@ -19133,6 +19176,28 @@ function relaycastWorkspaceTelemetryOptions(explicit = {}, env = defaultEnv()) {
   return identity;
 }
 
+// ../sdk/dist/messaging/session-ref.js
+var RELAY_ATTEST_SESSION_ID_ENV = "RELAY_ATTEST_SESSION_ID";
+var MAX_SESSION_REF_LENGTH = 255;
+function resolveReplaySessionRef(value) {
+  const sessionRef = value?.trim();
+  if (!sessionRef || Array.from(sessionRef).length > MAX_SESSION_REF_LENGTH)
+    return void 0;
+  return sessionRef;
+}
+function currentReplaySessionRef() {
+  return resolveReplaySessionRef(typeof process === "undefined" ? void 0 : process.env[RELAY_ATTEST_SESSION_ID_ENV]);
+}
+function replayMessageMetadata(metadata, ...rest) {
+  if (metadata && Object.hasOwn(metadata, "session_ref"))
+    return metadata;
+  const sessionRef = rest.length === 0 ? currentReplaySessionRef() : rest[0];
+  const normalized = resolveReplaySessionRef(sessionRef);
+  if (!normalized)
+    return metadata;
+  return { ...metadata ?? {}, session_ref: normalized };
+}
+
 // ../sdk/dist/messaging/normalize.js
 function isRecord2(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
@@ -20631,6 +20696,7 @@ var RelaycastMessagingClient = class {
   placementTtlMs;
   maxQueuedPlacements;
   placementLog;
+  sessionRef;
   queuedPlacements = 0;
   eventHandlers = /* @__PURE__ */ new Map();
   eventUnsubscribe;
@@ -20641,6 +20707,7 @@ var RelaycastMessagingClient = class {
     this.placementTtlMs = options.placementTtlMs ?? 60 * 60 * 1e3;
     this.maxQueuedPlacements = options.maxQueuedPlacements ?? 100;
     this.placementLog = options.placementLog;
+    this.sessionRef = options.sessionRef === void 0 ? currentReplaySessionRef() : resolveReplaySessionRef(options.sessionRef);
     const durable = this.deliverySurface() !== void 0;
     this.capabilities = {
       serverDeliveryState: durable,
@@ -20723,6 +20790,7 @@ var RelaycastMessagingClient = class {
       const message = await this.requireAgentClient("messages.send").send(input.channel, input.text, definedOptions({
         attachments: serializeAttachmentInputs(input.attachments),
         blocks: input.blocks,
+        data: replayMessageMetadata(input.metadata, this.sessionRef),
         mode: input.mode,
         idempotencyKey: input.idempotencyKey
       }));
@@ -20735,7 +20803,11 @@ var RelaycastMessagingClient = class {
     },
     get: async (id) => normalizeMessage(await this.relaycast.messages.get(id)),
     reply: async (input) => {
-      const message = await this.requireAgentClient("messages.reply").reply(input.messageId, input.text, definedOptions({ blocks: input.blocks, idempotencyKey: input.idempotencyKey }));
+      const message = await this.requireAgentClient("messages.reply").reply(input.messageId, input.text, definedOptions({
+        blocks: input.blocks,
+        data: replayMessageMetadata(input.metadata, this.sessionRef),
+        idempotencyKey: input.idempotencyKey
+      }));
       return normalizeMessage(message, {
         kind: "thread_reply",
         parentId: input.messageId,
@@ -20745,6 +20817,7 @@ var RelaycastMessagingClient = class {
     direct: async (input) => {
       const response = await this.requireAgentClient("messages.direct").dm(input.to, input.text, definedOptions({
         attachments: serializeAttachmentInputs(input.attachments),
+        data: replayMessageMetadata(input.metadata, this.sessionRef),
         mode: input.mode,
         idempotencyKey: input.idempotencyKey
       }));
@@ -20758,6 +20831,7 @@ var RelaycastMessagingClient = class {
       }
       const response = await agent.dms.sendMessage(conversationId, input.text, definedOptions({
         attachments: serializeAttachmentInputs(input.attachments),
+        data: replayMessageMetadata(input.metadata, this.sessionRef),
         mode: input.mode,
         idempotencyKey: input.idempotencyKey
       }));
@@ -21453,6 +21527,45 @@ var RelaycastMessagingClient = class {
 
 // ../sdk/dist/messaging/thin-client.js
 var RELAYCAST_SDK_VERSION = SDK_VERSION;
+var RELAY_OBSERVER_SCOPES = [
+  "stream:read",
+  "messages:read",
+  "threads:read",
+  "dms:read",
+  "channels:read",
+  "search:read",
+  "agents:read",
+  "nodes:read",
+  "deliveries:read",
+  "activity:read",
+  "files:read",
+  "reactions:read"
+];
+function observerTokenClient(workspaceKey, options) {
+  return new RelayCast(clientConfig(workspaceKey, options));
+}
+async function createObserverToken(options) {
+  const client = observerTokenClient(options.workspaceKey, options);
+  return client.observerTokens.create({
+    name: options.name,
+    ...options.description === void 0 ? {} : { description: options.description },
+    scopes: [...options.scopes ?? RELAY_OBSERVER_SCOPES],
+    // `include_dms` defaults to false server-side, but send it explicitly so the
+    // token's stored filters record the decision rather than an absence.
+    filters: {
+      includeDms: options.filters?.includeDms === true,
+      ...options.filters?.channelNames?.length ? { channelNames: options.filters.channelNames } : {},
+      ...options.filters?.agentIds?.length ? { agentIds: options.filters.agentIds } : {}
+    },
+    ...options.expiresAt === void 0 ? {} : { expiresAt: options.expiresAt }
+  });
+}
+async function listObserverTokens(options) {
+  return observerTokenClient(options.workspaceKey, options).observerTokens.list();
+}
+async function revokeObserverToken(options) {
+  await observerTokenClient(options.workspaceKey, options).observerTokens.revoke(options.id);
+}
 function pickTelemetryOverrides(options) {
   return {
     ...options.originActor === void 0 ? {} : { originActor: options.originActor },
@@ -21475,9 +21588,59 @@ function createWorkspaceClient(options) {
 }
 function createAgentClient(options) {
   const relay = new RelayCast(clientConfig(options.agentToken, options));
-  return relay.as(options.agentToken, {
+  const raw = relay.as(options.agentToken, {
     autoHeartbeatMs: options.autoHeartbeatMs ?? false
   });
+  const sessionRef = options.sessionRef === void 0 ? currentReplaySessionRef() : resolveReplaySessionRef(options.sessionRef);
+  if (!sessionRef)
+    return raw;
+  return stampAgentClientWithReplaySession(raw, sessionRef);
+}
+function stampAgentClientWithReplaySession(client, sessionRef) {
+  const stampData = (data) => replayMessageMetadata(data, sessionRef);
+  const withStampedData = (options, invoke) => {
+    const merged = { ...options ?? {} };
+    const stamped = stampData(options?.data);
+    if (stamped === void 0)
+      delete merged.data;
+    else
+      merged.data = stamped;
+    return invoke(merged);
+  };
+  let wrappedDms;
+  const dmsProxy = () => {
+    const target = client.dms;
+    if (!target)
+      return target;
+    wrappedDms ??= new Proxy(target, {
+      get(dms, prop) {
+        if (prop === "sendMessage") {
+          return (conversationId, text, options) => withStampedData(options, (opts) => dms.sendMessage(conversationId, text, opts));
+        }
+        const value = Reflect.get(dms, prop, dms);
+        return typeof value === "function" ? value.bind(dms) : value;
+      }
+    });
+    return wrappedDms;
+  };
+  return new Proxy(client, {
+    get(target, prop) {
+      switch (prop) {
+        case "send":
+          return (channel, text, options) => withStampedData(options, (opts) => target.send(channel, text, opts));
+        case "reply":
+          return (messageId, text, options) => withStampedData(options, (opts) => target.reply(messageId, text, opts));
+        case "dm":
+          return (to, text, options) => withStampedData(options, (opts) => target.dm(to, text, opts));
+        case "dms":
+          return dmsProxy();
+        default: {
+          const value = Reflect.get(target, prop, target);
+          return typeof value === "function" ? value.bind(target) : value;
+        }
+      }
+    }
+  });
 }
 function createRealtimeClient(options) {
   return new WsClient({
@@ -21986,7 +22149,8 @@ function createEnrichedMessages(base, resolveFrom) {
         text,
         attachments: sendInput.attachments,
         mode: sendInput.mode,
-        idempotencyKey: sendInput.idempotencyKey
+        idempotencyKey: sendInput.idempotencyKey,
+        metadata: sendInput.metadata
       });
     }
     if (isChannelTarget(sendInput.to)) {
@@ -21996,7 +22160,8 @@ function createEnrichedMessages(base, resolveFrom) {
         blocks: sendInput.blocks,
         attachments: sendInput.attachments,
         mode: sendInput.mode,
-        idempotencyKey: sendInput.idempotencyKey
+        idempotencyKey: sendInput.idempotencyKey,
+        metadata: sendInput.metadata
       });
     }
     return messages.direct({
@@ -22004,7 +22169,8 @@ function createEnrichedMessages(base, resolveFrom) {
       text,
       attachments: sendInput.attachments,
       mode: sendInput.mode,
-      idempotencyKey: sendInput.idempotencyKey
+      idempotencyKey: sendInput.idempotencyKey,
+      metadata: sendInput.metadata
     });
   };
   enriched.reply = async (input) => {
@@ -22013,7 +22179,8 @@ function createEnrichedMessages(base, resolveFrom) {
       messageId: resolveMessageId(input.messageId ?? input.thread),
       text: input.text,
       blocks: input.blocks,
-      idempotencyKey: input.idempotencyKey
+      idempotencyKey: input.idempotencyKey,
+      metadata: input.metadata
     });
   };
   enriched.react = (async (arg1, arg2) => {
@@ -22031,7 +22198,8 @@ function createEnrichedMessages(base, resolveFrom) {
       text: input.text ?? input.msg ?? "",
       attachments: input.attachments,
       mode: input.mode,
-      idempotencyKey: input.idempotencyKey
+      idempotencyKey: input.idempotencyKey,
+      metadata: input.metadata
     });
   };
   return enriched;
@@ -24140,6 +24308,8 @@ function generateRequestId(prefix = "") {
   MessageReadPredicate,
   OBSERVABILITY_UNAVAILABLE,
   RELAYCAST_SDK_VERSION,
+  RELAY_ATTEST_SESSION_ID_ENV,
+  RELAY_OBSERVER_SCOPES,
   RELAY_SERVICE_FAILURE_MESSAGE,
   RelayCapabilityError,
   RelayError,
@@ -24172,6 +24342,7 @@ function generateRequestId(prefix = "") {
   createLogger,
   createNotifyHandler,
   createObserverEventSource,
+  createObserverToken,
   createRealtimeClient,
   createRequestEnvelope,
   createRequestHandler,
@@ -24180,6 +24351,7 @@ function generateRequestId(prefix = "") {
   createWorkspace,
   createWorkspaceClient,
   createWorkspaceFacade,
+  currentReplaySessionRef,
   defineHarness,
   findGitRoot,
   formatAgentHandle,
@@ -24204,6 +24376,7 @@ function generateRequestId(prefix = "") {
   isPlaceholderTargetFast,
   isSpawnOrReleaseCommandFast,
   isValidAgentName,
+  listObserverTokens,
   logAndTraceError,
   logRelayHandlerError,
   mapModelToCli,
@@ -24234,10 +24407,13 @@ function generateRequestId(prefix = "") {
   printUpdateNotification,
   reduceAgentActivity,
   registerFacadeAction,
+  replayMessageMetadata,
   resetPatternMetrics,
   resolveAgentName,
   resolveAgentToken,
   resolveCommand,
+  resolveReplaySessionRef,
+  revokeObserverToken,
   routerLog,
   safeRelayErrorMessage,
   stripAnsiFast,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-relay",
-  "version": "11.8.0",
+  "version": "11.8.2",
   "description": "Real-time agent-to-agent communication system",
   "type": "module",
   "main": "dist/index.cjs",
@@ -43,14 +43,14 @@
     "pack:validate": "npm pack --dry-run"
   },
   "dependencies": {
-    "@agent-relay/cloud": "11.8.0",
-    "@agent-relay/config": "11.8.0",
-    "@agent-relay/fleet": "11.8.0",
-    "@agent-relay/harness-driver": "11.8.0",
-    "@agent-relay/harnesses": "11.8.0",
-    "@agent-relay/sdk": "11.8.0",
-    "@agent-relay/session": "11.8.0",
-    "@agent-relay/utils": "11.8.0",
+    "@agent-relay/cloud": "11.8.2",
+    "@agent-relay/config": "11.8.2",
+    "@agent-relay/fleet": "11.8.2",
+    "@agent-relay/harness-driver": "11.8.2",
+    "@agent-relay/harnesses": "11.8.2",
+    "@agent-relay/sdk": "11.8.2",
+    "@agent-relay/session": "11.8.2",
+    "@agent-relay/utils": "11.8.2",
     "@modelcontextprotocol/sdk": "^1.23.0",
     "@relayfile/client": "^0.10.27",
     "@relayflows/cli": "1.0.1",