@axiom-lattice/protocols 4.11.0 → 6.0.0

package/dist/index.mjs

@@ -2,15 +2,11 @@
 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 */;
 }
@@ -579,6 +575,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);
@@ -941,6 +1039,32 @@ function resolveRunScope(runConfig) {
   };
 }
 
+// src/RunCancelProtocol.ts
+import { z } from "zod";
+var MAX_FIELD_LENGTH = 64 * 1024;
+var boundedString = z.string().min(1).max(MAX_FIELD_LENGTH);
+var RUN_CANCEL_REASONS = ["abort", "a2a.cancel", "shutdown"];
+var runCancelSignalSchema = z.object({
+  commandId: boundedString,
+  tenantId: boundedString,
+  assistantId: boundedString,
+  threadId: boundedString,
+  runId: boundedString,
+  reason: z.enum(RUN_CANCEL_REASONS),
+  createdAt: boundedString
+}).strict();
+var interruptAnswerKeySchema = z.object({
+  tenantId: boundedString,
+  assistantId: boundedString,
+  threadId: boundedString,
+  interruptId: boundedString
+}).strict();
+var a2aEventCursorSchema = 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";
@@ -977,6 +1101,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;
@@ -996,26 +1121,46 @@ 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;
 export {
   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,
@@ -1025,13 +1170,19 @@ export {
   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,
@@ -1040,16 +1191,18 @@ export {
   getSubAgentsFromConfig,
   getToolsFromConfig,
   hasTools,
+  interruptAnswerKeySchema,
   isA2ARemoteAgentConfig,
   isDeepAgentConfig,
   isExecutionResultEventKey,
   isMcpUiRef,
   isProcessingAgentConfig,
   isProjectRoomEventId,
-  isTeamAgentConfig,
   isWorkflowAgentConfig,
   isWorkspacePublicRoomProjectId,
+  normalizeChannelReplyJobListLimit,
   normalizeTaskMetadataScalar,
+  observabilityDashboardElementKey,
   parseAgentWebAppGenUIBlock,
   parseMcpUiRef,
   parseModelKey,
@@ -1062,11 +1215,14 @@ export {
   replaceTaskBeliefState,
   requireProjectTaskWorkItemStore,
   resolveRunScope,
+  runCancelSignalSchema,
   snapshotExactArray,
   snapshotExactRecord,
   snapshotProjectRoomBotMembershipRealtime,
   snapshotProjectRoomMembershipRealtime,
   snapshotProjectRoomMessageRealtime,
+  storeExpiresAt,
+  storePaginationValue,
   taskBeliefStatesEqual,
   threadAffinityHeaders,
   toModelKey,