@axiom-lattice/protocols 4.11.0 → 6.0.0

package/dist/index.js

@@ -24,17 +24,22 @@ __export(index_exports, {
   AFFINITY_MISS_CODE: () => AFFINITY_MISS_CODE,
   AGENT_AFFINITY_HEADER: () => AGENT_AFFINITY_HEADER,
   AgentType: () => AgentType,
+  CHANNEL_REPLY_JOB_LIST_LIMIT_DEFAULT: () => CHANNEL_REPLY_JOB_LIST_LIMIT_DEFAULT,
+  CHANNEL_REPLY_JOB_LIST_LIMIT_MAX: () => CHANNEL_REPLY_JOB_LIST_LIMIT_MAX,
+  CHANNEL_REPLY_JOB_LIST_LIMIT_MIN: () => CHANNEL_REPLY_JOB_LIST_LIMIT_MIN,
   ChannelBindingMigrationConflictError: () => ChannelBindingMigrationConflictError,
   DuplicateChannelBindingSubjectError: () => DuplicateChannelBindingSubjectError,
   EXECUTION_RESULT_EVENT_KEY_PATTERN: () => EXECUTION_RESULT_EVENT_KEY_PATTERN,
   EXECUTION_RESULT_EVENT_KEY_PATTERN_SOURCE: () => EXECUTION_RESULT_EVENT_KEY_PATTERN_SOURCE,
   EXECUTION_RESULT_EVENT_KEY_PREFIX: () => EXECUTION_RESULT_EVENT_KEY_PREFIX,
   InvalidProjectCapabilityBundleConfigError: () => InvalidProjectCapabilityBundleConfigError,
+  LANGFUSE_OBSERVABILITY_DASHBOARD_VERSION: () => LANGFUSE_OBSERVABILITY_DASHBOARD_VERSION,
   LoggerType: () => LoggerType,
   MAX_PENDING_EXECUTION_RESULTS_LIMIT: () => MAX_PENDING_EXECUTION_RESULTS_LIMIT,
   McpMessageType: () => McpMessageType,
   MemoryType: () => MemoryType,
   MessageChunkTypes: () => MessageChunkTypes,
+  OBSERVABILITY_DASHBOARD_ELEMENT_KEY_PREFIX: () => OBSERVABILITY_DASHBOARD_ELEMENT_KEY_PREFIX,
   PROJECT_ROOM_TASK_DELEGATED_LABEL: () => PROJECT_ROOM_TASK_DELEGATED_LABEL,
   PROJECT_ROOM_TASK_DELEGATED_SEPARATOR: () => PROJECT_ROOM_TASK_DELEGATED_SEPARATOR,
   PROJECT_ROOM_USER_CHANNEL_PROJECT: () => PROJECT_ROOM_USER_CHANNEL_PROJECT,
@@ -44,13 +49,19 @@ __export(index_exports, {
   ProjectTaskStoreUnsupportedError: () => ProjectTaskStoreUnsupportedError,
   QueueType: () => QueueType,
   REPLICA_HEADER: () => REPLICA_HEADER,
+  STORE_IDENTITY_SEPARATOR: () => STORE_IDENTITY_SEPARATOR,
   ScheduleExecutionType: () => ScheduleExecutionType,
   ScheduleType: () => ScheduleType,
   ScheduledTaskStatus: () => ScheduledTaskStatus,
+  StoreValidationError: () => StoreValidationError,
   UIComponentType: () => UIComponentType,
   WORKSPACE_PUBLIC_ROOM_PROJECT_PREFIX: () => WORKSPACE_PUBLIC_ROOM_PROJECT_PREFIX,
+  a2aEventCursorSchema: () => a2aEventCursorSchema,
   affinityEchoHeaders: () => affinityEchoHeaders,
   assertGenericProjectConfig: () => assertGenericProjectConfig,
+  assertStoreIdentity: () => assertStoreIdentity,
+  assertStoreNamespacePrefix: () => assertStoreNamespacePrefix,
+  assertValidCreateChannelReplyJobInput: () => assertValidCreateChannelReplyJobInput,
   buildAffinityMissChunk: () => buildAffinityMissChunk,
   createAgentWebAppStreamProjectionContext: () => createAgentWebAppStreamProjectionContext,
   descriptorDataValue: () => descriptorDataValue,
@@ -59,16 +70,18 @@ __export(index_exports, {
   getSubAgentsFromConfig: () => getSubAgentsFromConfig,
   getToolsFromConfig: () => getToolsFromConfig,
   hasTools: () => hasTools,
+  interruptAnswerKeySchema: () => interruptAnswerKeySchema,
   isA2ARemoteAgentConfig: () => isA2ARemoteAgentConfig,
   isDeepAgentConfig: () => isDeepAgentConfig,
   isExecutionResultEventKey: () => isExecutionResultEventKey,
   isMcpUiRef: () => isMcpUiRef,
   isProcessingAgentConfig: () => isProcessingAgentConfig,
   isProjectRoomEventId: () => isProjectRoomEventId,
-  isTeamAgentConfig: () => isTeamAgentConfig,
   isWorkflowAgentConfig: () => isWorkflowAgentConfig,
   isWorkspacePublicRoomProjectId: () => isWorkspacePublicRoomProjectId,
+  normalizeChannelReplyJobListLimit: () => normalizeChannelReplyJobListLimit,
   normalizeTaskMetadataScalar: () => normalizeTaskMetadataScalar,
+  observabilityDashboardElementKey: () => observabilityDashboardElementKey,
   parseAgentWebAppGenUIBlock: () => parseAgentWebAppGenUIBlock,
   parseMcpUiRef: () => parseMcpUiRef,
   parseModelKey: () => parseModelKey,
@@ -81,11 +94,14 @@ __export(index_exports, {
   replaceTaskBeliefState: () => replaceTaskBeliefState,
   requireProjectTaskWorkItemStore: () => requireProjectTaskWorkItemStore,
   resolveRunScope: () => resolveRunScope,
+  runCancelSignalSchema: () => runCancelSignalSchema,
   snapshotExactArray: () => snapshotExactArray,
   snapshotExactRecord: () => snapshotExactRecord,
   snapshotProjectRoomBotMembershipRealtime: () => snapshotProjectRoomBotMembershipRealtime,
   snapshotProjectRoomMembershipRealtime: () => snapshotProjectRoomMembershipRealtime,
   snapshotProjectRoomMessageRealtime: () => snapshotProjectRoomMessageRealtime,
+  storeExpiresAt: () => storeExpiresAt,
+  storePaginationValue: () => storePaginationValue,
   taskBeliefStatesEqual: () => taskBeliefStatesEqual,
   threadAffinityHeaders: () => threadAffinityHeaders,
   toModelKey: () => toModelKey,
@@ -99,15 +115,11 @@ module.exports = __toCommonJS(index_exports);
 var AgentType = /* @__PURE__ */ ((AgentType2) => {
   AgentType2["REACT"] = "react";
   AgentType2["DEEP_AGENT"] = "deep_agent";
-  AgentType2["TEAM"] = "team";
   AgentType2["PROCESSING"] = "processing";
   AgentType2["A2A_REMOTE"] = "a2a_remote";
   AgentType2["WORKFLOW"] = "workflow";
   return AgentType2;
 })(AgentType || {});
-function isTeamAgentConfig(config) {
-  return config.type === "team" /* TEAM */;
-}
 function isA2ARemoteAgentConfig(config) {
   return config.type === "a2a_remote" /* A2A_REMOTE */;
 }
@@ -676,6 +688,108 @@ function isRecord2(value) {
 var PROJECT_ROOM_TASK_DELEGATED_LABEL = "Task delegated";
 var PROJECT_ROOM_TASK_DELEGATED_SEPARATOR = " \xB7 ";
 
+// src/StoreProtocol.ts
+var STORE_IDENTITY_SEPARATOR = "";
+var StoreValidationError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.code = "STORE_IDENTITY_INVALID";
+    this.name = "StoreValidationError";
+  }
+};
+function validStoreSegment(value) {
+  return typeof value === "string" && value.length > 0 && !value.includes(STORE_IDENTITY_SEPARATOR);
+}
+function assertStoreIdentity(namespace, key) {
+  if (!Array.isArray(namespace) || namespace.length === 0) {
+    throw new StoreValidationError("namespace must be a non-empty string array");
+  }
+  for (const segment of namespace) {
+    if (!validStoreSegment(segment)) {
+      throw new StoreValidationError(
+        "namespace segments must be non-empty strings without the reserved separator"
+      );
+    }
+  }
+  if (!validStoreSegment(key)) {
+    throw new StoreValidationError(
+      "key must be a non-empty string without the reserved separator"
+    );
+  }
+}
+function assertStoreNamespacePrefix(prefix) {
+  if (!Array.isArray(prefix)) {
+    throw new StoreValidationError("namespace prefix must be a string array");
+  }
+  for (const segment of prefix) {
+    if (!validStoreSegment(segment)) {
+      throw new StoreValidationError(
+        "namespace segments must be non-empty strings without the reserved separator"
+      );
+    }
+  }
+}
+function storeExpiresAt(ttlMinutes, now = /* @__PURE__ */ new Date()) {
+  if (ttlMinutes === void 0) return void 0;
+  if (typeof ttlMinutes !== "number" || !Number.isFinite(ttlMinutes) || ttlMinutes <= 0) {
+    throw new StoreValidationError("ttlMinutes must be a positive number");
+  }
+  const expiresAt = new Date(now.getTime() + ttlMinutes * 6e4);
+  if (!Number.isFinite(expiresAt.getTime()) || expiresAt.getUTCFullYear() > 9999) {
+    throw new StoreValidationError("ttlMinutes is out of range");
+  }
+  return expiresAt;
+}
+function storePaginationValue(value, fallback) {
+  if (value === void 0) return fallback;
+  if (!Number.isSafeInteger(value) || value < 0) {
+    throw new StoreValidationError("limit/offset must be a non-negative safe integer");
+  }
+  return value;
+}
+
+// src/ChannelReplyJobProtocol.ts
+var CHANNEL_REPLY_JOB_LIST_LIMIT_MIN = 1;
+var CHANNEL_REPLY_JOB_LIST_LIMIT_MAX = 200;
+var CHANNEL_REPLY_JOB_LIST_LIMIT_DEFAULT = 100;
+function normalizeChannelReplyJobListLimit(limit) {
+  if (limit === void 0 || !Number.isFinite(limit)) {
+    return CHANNEL_REPLY_JOB_LIST_LIMIT_DEFAULT;
+  }
+  return Math.min(
+    CHANNEL_REPLY_JOB_LIST_LIMIT_MAX,
+    Math.max(CHANNEL_REPLY_JOB_LIST_LIMIT_MIN, Math.trunc(limit))
+  );
+}
+function assertValidCreateChannelReplyJobInput(input) {
+  if (input === null || typeof input !== "object") {
+    throw new Error("ChannelReplyJob create input is required");
+  }
+  const required = [
+    ["runId", input.runId],
+    ["tenantId", input.tenantId],
+    ["assistantId", input.assistantId],
+    ["threadId", input.threadId],
+    ["adapterChannel", input.adapterChannel],
+    ["channelInstallationId", input.channelInstallationId],
+    ["inputMessageId", input.inputMessageId]
+  ];
+  for (const [field, value] of required) {
+    if (typeof value !== "string" || value.trim() === "") {
+      throw new Error(`ChannelReplyJob requires a non-empty ${field}`);
+    }
+  }
+  if (typeof input.replyTarget !== "object" || input.replyTarget === null || Array.isArray(input.replyTarget)) {
+    throw new Error("ChannelReplyJob requires a replyTarget object");
+  }
+  if (typeof input.availableAt !== "number" || !Number.isFinite(input.availableAt)) {
+    throw new Error("ChannelReplyJob requires a finite availableAt");
+  }
+  if (input.streamCursor !== void 0 && input.streamCursor !== null && typeof input.streamCursor !== "string") {
+    throw new Error("ChannelReplyJob streamCursor must be a string");
+  }
+}
+
 // src/ExactDataSnapshot.ts
 function ownDescriptorField(descriptor, key) {
   const field = Object.getOwnPropertyDescriptor(descriptor, key);
@@ -1038,6 +1152,32 @@ function resolveRunScope(runConfig) {
   };
 }
 
+// src/RunCancelProtocol.ts
+var import_zod = require("zod");
+var MAX_FIELD_LENGTH = 64 * 1024;
+var boundedString = import_zod.z.string().min(1).max(MAX_FIELD_LENGTH);
+var RUN_CANCEL_REASONS = ["abort", "a2a.cancel", "shutdown"];
+var runCancelSignalSchema = import_zod.z.object({
+  commandId: boundedString,
+  tenantId: boundedString,
+  assistantId: boundedString,
+  threadId: boundedString,
+  runId: boundedString,
+  reason: import_zod.z.enum(RUN_CANCEL_REASONS),
+  createdAt: boundedString
+}).strict();
+var interruptAnswerKeySchema = import_zod.z.object({
+  tenantId: boundedString,
+  assistantId: boundedString,
+  threadId: boundedString,
+  interruptId: boundedString
+}).strict();
+var a2aEventCursorSchema = import_zod.z.object({
+  taskId: boundedString,
+  lastEventId: boundedString,
+  updatedAt: boundedString
+}).strict();
+
 // src/AgentAffinity.ts
 var AGENT_AFFINITY_HEADER = "x-axiom-affinity";
 var REPLICA_HEADER = "x-axiom-replica";
@@ -1074,6 +1214,7 @@ function effectiveGrants(record) {
 
 // src/McpUiProtocol.ts
 var MODES = ["inline", "fullscreen", "pip"];
+var MAX_MCP_UI_SCOPE_LENGTH = 4096;
 var isObj = (v) => typeof v === "object" && v !== null;
 function isMcpUiRef(value) {
   return parseMcpUiRef(value) !== null;
@@ -1093,27 +1234,47 @@ function parseMcpUiRef(value) {
     };
   }
   if (value.kind === "plugin" && typeof value.pluginType === "string" && typeof value.resource === "string") {
-    return { kind: "plugin", pluginType: value.pluginType, resource: value.resource, displayMode, ...title ? { title } : {} };
+    const scope = typeof value.scope === "string" && value.scope.length > 0 && value.scope.length <= MAX_MCP_UI_SCOPE_LENGTH ? value.scope : void 0;
+    return {
+      kind: "plugin",
+      pluginType: value.pluginType,
+      resource: value.resource,
+      displayMode,
+      ...title ? { title } : {},
+      ...scope ? { scope } : {}
+    };
   }
   return null;
 }
+
+// src/ObservabilityDashboardProtocol.ts
+var OBSERVABILITY_DASHBOARD_ELEMENT_KEY_PREFIX = "observability_dashboard_";
+function observabilityDashboardElementKey(provider) {
+  return `${OBSERVABILITY_DASHBOARD_ELEMENT_KEY_PREFIX}${provider}`;
+}
+var LANGFUSE_OBSERVABILITY_DASHBOARD_VERSION = 3;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AFFINITY_ECHO_HEADER,
   AFFINITY_MISS_CODE,
   AGENT_AFFINITY_HEADER,
   AgentType,
+  CHANNEL_REPLY_JOB_LIST_LIMIT_DEFAULT,
+  CHANNEL_REPLY_JOB_LIST_LIMIT_MAX,
+  CHANNEL_REPLY_JOB_LIST_LIMIT_MIN,
   ChannelBindingMigrationConflictError,
   DuplicateChannelBindingSubjectError,
   EXECUTION_RESULT_EVENT_KEY_PATTERN,
   EXECUTION_RESULT_EVENT_KEY_PATTERN_SOURCE,
   EXECUTION_RESULT_EVENT_KEY_PREFIX,
   InvalidProjectCapabilityBundleConfigError,
+  LANGFUSE_OBSERVABILITY_DASHBOARD_VERSION,
   LoggerType,
   MAX_PENDING_EXECUTION_RESULTS_LIMIT,
   McpMessageType,
   MemoryType,
   MessageChunkTypes,
+  OBSERVABILITY_DASHBOARD_ELEMENT_KEY_PREFIX,
   PROJECT_ROOM_TASK_DELEGATED_LABEL,
   PROJECT_ROOM_TASK_DELEGATED_SEPARATOR,
   PROJECT_ROOM_USER_CHANNEL_PROJECT,
@@ -1123,13 +1284,19 @@ function parseMcpUiRef(value) {
   ProjectTaskStoreUnsupportedError,
   QueueType,
   REPLICA_HEADER,
+  STORE_IDENTITY_SEPARATOR,
   ScheduleExecutionType,
   ScheduleType,
   ScheduledTaskStatus,
+  StoreValidationError,
   UIComponentType,
   WORKSPACE_PUBLIC_ROOM_PROJECT_PREFIX,
+  a2aEventCursorSchema,
   affinityEchoHeaders,
   assertGenericProjectConfig,
+  assertStoreIdentity,
+  assertStoreNamespacePrefix,
+  assertValidCreateChannelReplyJobInput,
   buildAffinityMissChunk,
   createAgentWebAppStreamProjectionContext,
   descriptorDataValue,
@@ -1138,16 +1305,18 @@ function parseMcpUiRef(value) {
   getSubAgentsFromConfig,
   getToolsFromConfig,
   hasTools,
+  interruptAnswerKeySchema,
   isA2ARemoteAgentConfig,
   isDeepAgentConfig,
   isExecutionResultEventKey,
   isMcpUiRef,
   isProcessingAgentConfig,
   isProjectRoomEventId,
-  isTeamAgentConfig,
   isWorkflowAgentConfig,
   isWorkspacePublicRoomProjectId,
+  normalizeChannelReplyJobListLimit,
   normalizeTaskMetadataScalar,
+  observabilityDashboardElementKey,
   parseAgentWebAppGenUIBlock,
   parseMcpUiRef,
   parseModelKey,
@@ -1160,11 +1329,14 @@ function parseMcpUiRef(value) {
   replaceTaskBeliefState,
   requireProjectTaskWorkItemStore,
   resolveRunScope,
+  runCancelSignalSchema,
   snapshotExactArray,
   snapshotExactRecord,
   snapshotProjectRoomBotMembershipRealtime,
   snapshotProjectRoomMembershipRealtime,
   snapshotProjectRoomMessageRealtime,
+  storeExpiresAt,
+  storePaginationValue,
   taskBeliefStatesEqual,
   threadAffinityHeaders,
   toModelKey,