@tutti-os/agent-activity-core 0.0.222 → 0.0.224

package/dist/index.js

@@ -1,3 +1,151 @@
+// src/liveProtocolRevision.gen.ts
+var AGENT_ACTIVITY_LIVE_PROTOCOL_REVISION = "sha256:d6d418949c61ff09";
+
+// src/activityValueParsing.ts
+function cloneJSONValue(value) {
+  if (Array.isArray(value)) return value.map(cloneJSONValue);
+  if (value !== null && typeof value === "object") {
+    return Object.fromEntries(
+      Object.entries(value).map(([key, entry]) => [
+        key,
+        cloneJSONValue(entry)
+      ])
+    );
+  }
+  return value;
+}
+function recordValue(value) {
+  return typeof value === "object" && value !== null ? value : null;
+}
+function stringValue(value) {
+  return typeof value === "string" ? value.trim() : "";
+}
+function nullableStringValue(value) {
+  return typeof value === "string" ? value : value === null ? null : void 0;
+}
+function numberValue(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function messageVersionValue(source) {
+  return numberValue(source.version) ?? numberValue(source.seq) ?? 0;
+}
+
+// src/liveEventParsing.ts
+function parseAgentActivityMessageDeltaEvent(value) {
+  const event = recordValue2(value);
+  const data = recordValue2(event?.data);
+  if (event?.eventType !== "message_delta" || !data || !nonEmptyString(event.workspaceId) || !nonEmptyString(event.agentSessionId) || data.workspaceId !== event.workspaceId || data.agentSessionId !== event.agentSessionId || !nonEmptyString(data.messageId) || !nonEmptyString(data.turnId) || !nonEmptyString(data.role) || !nonEmptyString(data.kind) || !positiveSafeInteger(data.occurredAtUnixMs)) {
+    return null;
+  }
+  const content = parseContentOperation(data.content);
+  if (data.content !== void 0 && !content) {
+    return null;
+  }
+  const toolOutput = parseToolOutputOperation(data.toolOutput);
+  if (data.toolOutput !== void 0 && !toolOutput || toolOutput && data.kind !== "tool_call") {
+    return null;
+  }
+  const payloadSet = data.payloadSet === void 0 ? void 0 : recordValue2(data.payloadSet);
+  if (data.payloadSet !== void 0 && !payloadSet) {
+    return null;
+  }
+  const payloadUnset = stringArray(data.payloadUnset);
+  if (data.payloadUnset !== void 0 && !payloadUnset) {
+    return null;
+  }
+  const semantics = data.semantics === void 0 ? void 0 : recordValue2(data.semantics);
+  if (data.semantics !== void 0 && !semantics) {
+    return null;
+  }
+  if (data.status !== void 0 && typeof data.status !== "string" || !optionalNonNegativeSafeInteger(data.startedAtUnixMs) || !optionalNonNegativeSafeInteger(data.completedAtUnixMs)) {
+    return null;
+  }
+  if (!content && !toolOutput && !payloadSet && !payloadUnset && data.status === void 0 && !semantics && data.startedAtUnixMs === void 0 && data.completedAtUnixMs === void 0) {
+    return null;
+  }
+  return {
+    workspaceId: event.workspaceId,
+    agentSessionId: event.agentSessionId,
+    eventType: "message_delta",
+    data: {
+      workspaceId: data.workspaceId,
+      agentSessionId: data.agentSessionId,
+      messageId: data.messageId,
+      turnId: data.turnId,
+      role: data.role,
+      kind: data.kind,
+      occurredAtUnixMs: data.occurredAtUnixMs,
+      ...content ? { content } : {},
+      ...toolOutput ? { toolOutput } : {},
+      ...payloadSet ? {
+        payloadSet: cloneJSONValue(payloadSet)
+      } : {},
+      ...payloadUnset ? { payloadUnset } : {},
+      ...typeof data.status === "string" ? { status: data.status } : {},
+      ...semantics ? {
+        semantics: cloneJSONValue(
+          semantics
+        )
+      } : {},
+      ...typeof data.startedAtUnixMs === "number" ? { startedAtUnixMs: data.startedAtUnixMs } : {},
+      ...typeof data.completedAtUnixMs === "number" ? { completedAtUnixMs: data.completedAtUnixMs } : {}
+    }
+  };
+}
+function parseToolOutputOperation(value) {
+  if (value === void 0) return null;
+  const operation = recordValue2(value);
+  if (!operation || typeof operation.text !== "string") return null;
+  if (operation.operation === "set" && operation.offsetBytes === void 0) {
+    return { operation: "set", text: operation.text };
+  }
+  if (operation.operation === "append_text" && operation.text.length > 0 && nonNegativeSafeInteger(operation.offsetBytes)) {
+    return {
+      operation: "append_text",
+      text: operation.text,
+      offsetBytes: operation.offsetBytes
+    };
+  }
+  return null;
+}
+function parseContentOperation(value) {
+  if (value === void 0) return null;
+  const operation = recordValue2(value);
+  if (!operation) return null;
+  if (operation.operation === "append_text" && typeof operation.text === "string") {
+    return { operation: "append_text", text: operation.text };
+  }
+  if (operation.operation === "set" && Object.prototype.hasOwnProperty.call(operation, "value")) {
+    return {
+      operation: "set",
+      value: cloneJSONValue(operation.value)
+    };
+  }
+  return null;
+}
+function recordValue2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
+}
+function nonEmptyString(value) {
+  return typeof value === "string" && value.trim().length > 0;
+}
+function positiveSafeInteger(value) {
+  return typeof value === "number" && Number.isSafeInteger(value) && value > 0;
+}
+function nonNegativeSafeInteger(value) {
+  return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+}
+function optionalNonNegativeSafeInteger(value) {
+  return value === void 0 || typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+}
+function stringArray(value) {
+  if (value === void 0) return null;
+  if (!Array.isArray(value) || value.length === 0 || value.some((item) => !nonEmptyString(item))) {
+    return null;
+  }
+  return [...new Set(value)];
+}
+
 // src/capabilityReferences.ts
 function normalizeAgentActivityCapabilityReferences(references) {
   if (!references?.length) return [];
@@ -716,8 +864,8 @@ function areJsonLikeValuesEqual(left, right) {
     }
     return true;
   }
-  const leftRecord = recordValue(left);
-  const rightRecord = recordValue(right);
+  const leftRecord = recordValue3(left);
+  const rightRecord = recordValue3(right);
   if (!leftRecord || !rightRecord) {
     return false;
   }
@@ -732,43 +880,14 @@ function areJsonLikeValuesEqual(left, right) {
   }
   return true;
 }
-function recordValue(value) {
-  return typeof value === "object" && value !== null ? value : null;
-}
-
-// src/activityValueParsing.ts
-function cloneJSONValue(value) {
-  if (Array.isArray(value)) return value.map(cloneJSONValue);
-  if (value !== null && typeof value === "object") {
-    return Object.fromEntries(
-      Object.entries(value).map(([key, entry]) => [
-        key,
-        cloneJSONValue(entry)
-      ])
-    );
-  }
-  return value;
-}
-function recordValue2(value) {
+function recordValue3(value) {
   return typeof value === "object" && value !== null ? value : null;
 }
-function stringValue(value) {
-  return typeof value === "string" ? value.trim() : "";
-}
-function nullableStringValue(value) {
-  return typeof value === "string" ? value : value === null ? null : void 0;
-}
-function numberValue(value) {
-  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
-}
-function messageVersionValue(source) {
-  return numberValue(source.version) ?? numberValue(source.seq) ?? 0;
-}
 
 // src/inlineActivityMessages.ts
 function parseInlineActivityMessages(event) {
   if (event.eventType === "session_audit") {
-    const audit = recordValue2(event.data.audit);
+    const audit = recordValue(event.data.audit);
     if (!audit) return [];
     return [
       agentActivityMessageFromInlineMessage({
@@ -787,13 +906,13 @@ function parseInlineActivityMessages(event) {
     ].filter((message) => message !== null);
   }
   if (event.eventType !== "message_update") return [];
-  const source = recordValue2(event.data);
+  const source = recordValue(event.data);
   const rawMessages = Array.isArray(source?.messages) ? source.messages : [];
   const eventAgentSessionId = event.agentSessionId.trim();
   const workspaceId = event.workspaceId?.trim() ?? "";
   const messages = [];
   for (const raw of rawMessages) {
-    const record = recordValue2(raw);
+    const record = recordValue(raw);
     if (!record) continue;
     const agentSessionId = stringValue(record.agentSessionId) || eventAgentSessionId;
     const message = agentActivityMessageFromInlineMessage({
@@ -825,10 +944,10 @@ function agentActivityMessageFromInlineMessage(input) {
     role,
     kind,
     status: nullableStringValue(input.message.status),
-    semantics: recordValue2(input.message.semantics) ? cloneJSONValue(
+    semantics: recordValue(input.message.semantics) ? cloneJSONValue(
       input.message.semantics
     ) : void 0,
-    payload: cloneJSONValue(recordValue2(input.message.payload) ?? {}),
+    payload: cloneJSONValue(recordValue(input.message.payload) ?? {}),
     sequence: numberValue(input.message.sequence),
     occurredAtUnixMs,
     createdAtUnixMs: numberValue(input.message.createdAtUnixMs),
@@ -837,6 +956,237 @@ function agentActivityMessageFromInlineMessage(input) {
   };
 }
 
+// src/optimisticMessageOverlay.ts
+function createAgentActivityOptimisticMessageOverlay() {
+  const optimistic = /* @__PURE__ */ new Map();
+  const canonical = /* @__PURE__ */ new Map();
+  return {
+    apply(event) {
+      if (event.eventType !== "message_delta") {
+        return { applied: false, needsReconcile: false };
+      }
+      return applyMessageDelta(event);
+    },
+    reconcile(scope, messages) {
+      const normalized = normalizeCanonicalMessages(scope, messages);
+      const prefix = scopePrefix(scope);
+      deleteScopeEntries(canonical, prefix);
+      for (const message of normalized) {
+        const key = messageKey(message);
+        canonical.set(key, cloneMessage(message));
+      }
+      for (const [key, entry] of optimistic) {
+        if (!key.startsWith(prefix)) {
+          continue;
+        }
+        const canonicalMessage = canonical.get(key);
+        if (!entry.explicitlyTerminal || canonicalMessage !== void 0 && isTerminalMessage(canonicalMessage)) {
+          optimistic.delete(key);
+        }
+      }
+    },
+    reset(scope) {
+      const prefix = scopePrefix(scope);
+      deleteScopeEntries(optimistic, prefix);
+      deleteScopeEntries(canonical, prefix);
+    },
+    project(scope, messages) {
+      const normalized = normalizeCanonicalMessages(scope, messages);
+      const byKey = /* @__PURE__ */ new Map();
+      for (const message of normalized) {
+        byKey.set(messageKey(message), cloneMessage(message));
+      }
+      const prefix = scopePrefix(scope);
+      for (const [key, entry] of optimistic) {
+        if (!key.startsWith(prefix)) {
+          continue;
+        }
+        const base = byKey.get(key) ?? canonical.get(key);
+        byKey.set(
+          key,
+          base ? materialize(base, entry.message, entry.payloadUnset) : cloneMessage(entry.message)
+        );
+      }
+      return [...byKey.values()].sort(compareAgentActivityMessages);
+    }
+  };
+  function applyMessageDelta(event) {
+    const data = event.data;
+    if (data.workspaceId !== event.workspaceId || data.agentSessionId !== event.agentSessionId) {
+      return {
+        applied: false,
+        needsReconcile: true,
+        reason: "identity_mismatch"
+      };
+    }
+    const key = liveMessageKey(event);
+    const existing = optimistic.get(key)?.message ?? canonical.get(key) ?? void 0;
+    if (data.content?.operation === "append_text" && !existing) {
+      return {
+        applied: false,
+        needsReconcile: true,
+        reason: "append_without_anchor"
+      };
+    }
+    if (data.toolOutput?.operation === "append_text" && !existing) {
+      return {
+        applied: false,
+        needsReconcile: true,
+        reason: "append_without_anchor"
+      };
+    }
+    const next = existing ? cloneMessage(existing) : {
+      workspaceId: event.workspaceId,
+      agentSessionId: event.agentSessionId,
+      messageId: data.messageId,
+      version: 0,
+      turnId: data.turnId ?? null,
+      role: data.role,
+      kind: data.kind,
+      payload: {},
+      occurredAtUnixMs: data.occurredAtUnixMs
+    };
+    next.workspaceId = event.workspaceId;
+    next.agentSessionId = event.agentSessionId;
+    next.turnId = data.turnId ?? next.turnId;
+    next.role = data.role;
+    next.kind = data.kind;
+    next.occurredAtUnixMs = Math.max(
+      next.occurredAtUnixMs,
+      data.occurredAtUnixMs
+    );
+    if (data.content?.operation === "append_text") {
+      const currentText = typeof next.payload.text === "string" ? next.payload.text : "";
+      const text2 = currentText + data.content.text;
+      next.payload.text = text2;
+      next.payload.content = text2;
+    } else if (data.content?.operation === "set") {
+      const value = cloneJSONValue(data.content.value);
+      next.payload.content = value;
+      if (typeof value === "string") {
+        next.payload.text = value;
+      } else {
+        delete next.payload.text;
+      }
+    }
+    if (data.toolOutput) {
+      const output = recordValue4(next.payload.output) ?? {};
+      const currentText = typeof output.text === "string" ? output.text : "";
+      if (data.toolOutput.operation === "append_text" && utf8ByteLength(currentText) !== data.toolOutput.offsetBytes) {
+        return {
+          applied: false,
+          needsReconcile: true,
+          reason: "tool_output_offset_mismatch"
+        };
+      }
+      output.text = data.toolOutput.operation === "set" ? data.toolOutput.text : currentText + data.toolOutput.text;
+      next.payload.output = output;
+    }
+    for (const [payloadKey, value] of Object.entries(data.payloadSet ?? {})) {
+      next.payload[payloadKey] = cloneJSONValue(value);
+    }
+    for (const payloadKey of data.payloadUnset ?? []) {
+      delete next.payload[payloadKey];
+    }
+    if (data.status !== void 0) next.status = data.status;
+    if (data.semantics !== void 0) {
+      next.semantics = cloneJSONValue(
+        data.semantics
+      );
+    }
+    if (data.startedAtUnixMs !== void 0) {
+      next.startedAtUnixMs = data.startedAtUnixMs;
+    }
+    if (data.completedAtUnixMs !== void 0) {
+      next.completedAtUnixMs = data.completedAtUnixMs;
+    }
+    const payloadUnset = new Set(optimistic.get(key)?.payloadUnset ?? []);
+    for (const payloadKey of Object.keys(data.payloadSet ?? {})) {
+      payloadUnset.delete(payloadKey);
+    }
+    for (const payloadKey of data.payloadUnset ?? []) {
+      payloadUnset.add(payloadKey);
+    }
+    optimistic.set(key, {
+      message: next,
+      payloadUnset,
+      explicitlyTerminal: (optimistic.get(key)?.explicitlyTerminal ?? false) || deltaIsExplicitlyTerminal(data)
+    });
+    return { applied: true, needsReconcile: false };
+  }
+}
+function recordValue4(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? cloneJSONValue(value) : null;
+}
+function utf8ByteLength(value) {
+  return new TextEncoder().encode(value).byteLength;
+}
+function materialize(canonical, overlay, payloadUnset) {
+  const materialized = {
+    ...canonical,
+    ...overlay,
+    version: canonical.version,
+    sequence: canonical.sequence ?? overlay.sequence,
+    createdAtUnixMs: canonical.createdAtUnixMs ?? overlay.createdAtUnixMs,
+    payload: {
+      ...canonical.payload,
+      ...overlay.payload
+    },
+    semantics: overlay.semantics ?? canonical.semantics
+  };
+  for (const key of payloadUnset) {
+    delete materialized.payload[key];
+  }
+  return materialized;
+}
+function isTerminalMessage(message) {
+  if (message.completedAtUnixMs !== void 0) return true;
+  return isTerminalStatus(message.status);
+}
+function deltaIsExplicitlyTerminal(data) {
+  return data.completedAtUnixMs !== void 0 || isTerminalStatus(data.status);
+}
+function isTerminalStatus(status) {
+  return ["completed", "failed", "canceled", "interrupted"].includes(
+    status ?? ""
+  );
+}
+function liveMessageKey(event) {
+  return `${identityPrefix(event.workspaceId, event.agentSessionId)}${event.data.messageId}`;
+}
+function messageKey(message) {
+  return `${identityPrefix(message.workspaceId ?? "", message.agentSessionId)}${message.messageId}`;
+}
+function identityPrefix(workspaceId, agentSessionId) {
+  return `${workspaceId}\0${agentSessionId}\0`;
+}
+function scopePrefix(scope) {
+  return identityPrefix(scope.workspaceId, scope.agentSessionId);
+}
+function normalizeCanonicalMessages(scope, messages) {
+  return messages.map((message) => {
+    if (message.workspaceId !== void 0 && message.workspaceId !== scope.workspaceId || message.agentSessionId !== scope.agentSessionId) {
+      throw new Error(
+        "canonical Agent activity message is outside the optimistic overlay scope"
+      );
+    }
+    return cloneMessage({
+      ...message,
+      workspaceId: scope.workspaceId
+    });
+  });
+}
+function deleteScopeEntries(entries, prefix) {
+  for (const key of entries.keys()) {
+    if (key.startsWith(prefix)) {
+      entries.delete(key);
+    }
+  }
+}
+function cloneMessage(message) {
+  return mergeAgentActivityMessages([], [message])[0];
+}
+
 // src/pagination.ts
 var DEFAULT_MAX_MESSAGE_PAGES = 1e3;
 function agentActivitySessionMessageWindowFromDescendingPage(page) {
@@ -1034,11 +1384,11 @@ function stringValue2(value) {
 
 // src/usage.ts
 function resolveAgentActivityUsage(input) {
-  const usage = recordValue3(input.sessionUsage);
+  const usage = recordValue5(input.sessionUsage);
   if (!usage) {
     return null;
   }
-  const contextWindow = recordValue3(usage.contextWindow);
+  const contextWindow = recordValue5(usage.contextWindow);
   const usedTokens = finiteNumber(contextWindow?.usedTokens);
   const totalTokens = finiteNumber(contextWindow?.totalTokens);
   const quotas = Array.isArray(usage.quotas) ? usage.quotas.map(normalizeQuota).filter((quota) => quota !== null) : [];
@@ -1054,7 +1404,7 @@ function resolveAgentActivityUsage(input) {
   };
 }
 function normalizeQuota(value) {
-  const record = recordValue3(value);
+  const record = recordValue5(value);
   const quotaType = quotaTypeValue(record?.quotaType);
   if (!record || !quotaType) return null;
   const quota = { quotaType };
@@ -1083,7 +1433,7 @@ function quotaTypeValue(value) {
       return null;
   }
 }
-function recordValue3(value) {
+function recordValue5(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
 }
 function finiteNumber(value) {
@@ -6572,6 +6922,7 @@ function workspaceAgentSessionStatus(session) {
   }
 }
 export {
+  AGENT_ACTIVITY_LIVE_PROTOCOL_REVISION,
   AGENT_CAPABILITY_KEYS,
   AGENT_SESSION_ENGINE_LOCAL_ORIGIN,
   ENGINE_INTENT_BATCH_DELAY_MS,
@@ -6581,6 +6932,7 @@ export {
   canonicalTurnKey,
   cloneAgentActivityMessage,
   compareAgentActivityMessages,
+  createAgentActivityOptimisticMessageOverlay,
   createAgentActivitySnapshotProjector,
   createAgentSessionEngine,
   createEmptyAgentActivitySnapshot,
@@ -6593,6 +6945,7 @@ export {
   normalizeAgentActivityCapabilityReferences,
   normalizeAgentActivityDisplayStatus,
   normalizeAgentActivitySession,
+  parseAgentActivityMessageDeltaEvent,
   parseInlineActivityMessages,
   pendingSubmitRecordListsEqual,
   resolveAgentActivityCapability,