@xpert-ai/chatkit-types 0.6.2 → 0.7.0

package/dist/index.js

@@ -1,5 +1,8 @@
 import { CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED, ChatMessageEventTypeEnum, ChatMessageStepCategory, ChatMessageTypeEnum, STATE_VARIABLE_HUMAN } from "./constants.js";
 import "@langchain/core/messages/tool";
+function isApprovalHostReference(value) {
+  return !!value && typeof value === "object" && "kind" in value && typeof value.kind === "string" && value.kind.length > 0 && "id" in value && typeof value.id === "string" && value.id.length > 0 && "expiresAt" in value && typeof value.expiresAt === "number" && Number.isFinite(value.expiresAt);
+}
 function isLocalizedText(value) {
   return typeof value === "string" || !!value && typeof value === "object" && !Array.isArray(value) && Object.values(value).every((item) => typeof item === "string" || item === void 0);
 }
@@ -129,9 +132,7 @@ function normalizeHITLRequest(value) {
   const normalizedActionRequests = actionRequests.map(
     normalizeHITLActionRequest
   );
-  const normalizedReviewConfigs = reviewConfigs.map(
-    normalizeHITLReviewConfig
-  );
+  const normalizedReviewConfigs = reviewConfigs.map(normalizeHITLReviewConfig);
   if (normalizedActionRequests.some((request) => request === null) || normalizedReviewConfigs.some((config2) => config2 === null)) {
     return null;
   }
@@ -139,6 +140,12 @@ function normalizeHITLRequest(value) {
     actionRequests: normalizedActionRequests,
     reviewConfigs: normalizedReviewConfigs
   };
+  if (value.host !== void 0) {
+    if (!isApprovalHostReference(value.host)) return null;
+    normalizedRequest.host = value.host;
+  }
+  if (typeof value.toolCallId === "string")
+    normalizedRequest.toolCallId = value.toolCallId;
   const elicitation = normalizeHITLMCPElicitation(value.elicitation);
   if (!elicitation || normalizedRequest.actionRequests.length !== 1) {
     return normalizedRequest;
@@ -603,6 +610,222 @@ function getMessageSkillUsages(message) {
 }
 const TOOL_OUTPUT_PRESENTATION_TYPE = "xpert.tool-output";
 const TOOL_OUTPUT_PRESENTATION_VERSION = 1;
+function parseFileActivityContent(value) {
+  if (!value || typeof value !== "object") return null;
+  const part = value;
+  if (part.type !== "file_activity" || typeof part.id !== "string" || !part.id || !part.data || typeof part.data !== "object") return null;
+  const data = part.data;
+  if (data.version !== 1 || data.receiptId !== part.id || typeof data.toolCallId !== "string" || !data.toolCallId || typeof data.updatedAt !== "string" || !Number.isFinite(Date.parse(data.updatedAt))) return null;
+  const base = { version: 1, receiptId: part.id, toolCallId: data.toolCallId, updatedAt: data.updatedAt };
+  let receipt;
+  if (data.kind === "changes" && ["bounded", "partial", "unavailable"].includes(data.coverage) && Array.isArray(data.fileChanges)) {
+    const fileChanges = normalizeFileChanges(data.fileChanges);
+    if (fileChanges.length !== data.fileChanges.length) return null;
+    receipt = { ...base, kind: "changes", coverage: data.coverage, fileChanges };
+  } else if (data.kind === "delivery" && data.status === "success" && Array.isArray(data.outputs)) {
+    const outputs = normalizeFileOutputs(data.outputs);
+    if (outputs.length !== data.outputs.length) return null;
+    receipt = { ...base, kind: "delivery", status: "success", outputs };
+  } else if (data.kind === "delivery" && data.status === "error" && typeof data.error === "string") {
+    receipt = { ...base, kind: "delivery", status: "error", error: data.error };
+  } else return null;
+  return {
+    id: part.id,
+    type: "file_activity",
+    data: receipt,
+    ...typeof part.messageId === "string" ? { messageId: part.messageId } : {},
+    ...typeof part.executionId === "string" ? { executionId: part.executionId } : {},
+    ...typeof part.agentKey === "string" ? { agentKey: part.agentKey } : {},
+    ...typeof part.parentExecutionId === "string" ? { parentExecutionId: part.parentExecutionId } : {},
+    ...typeof part.runId === "string" ? { runId: part.runId } : {}
+  };
+}
+function getLegacyFileActivityContribution(value) {
+  var _a;
+  if (!value || typeof value !== "object") return null;
+  const part = value;
+  const step = part.type === "component" ? part.data : value;
+  if (!step || typeof step !== "object") return null;
+  const summary = step.taskSummary ?? ((_a = step._meta) == null ? void 0 : _a["xpertai/taskSummary"]);
+  const id = part.id ?? step.id;
+  return (summary == null ? void 0 : summary.version) === 1 && summary.fileActivityVersion === 1 && typeof summary.fileActivityToolCallId === "string" && Boolean(summary.fileActivityToolCallId) && typeof id === "string" && id !== summary.fileActivityToolCallId ? summary : null;
+}
+function isFileActivityContent(value) {
+  return Boolean(value && typeof value === "object" && "type" in value && value.type === "file_activity") || getLegacyFileActivityContribution(value) !== null;
+}
+function getFileActivityContribution(value) {
+  const part = parseFileActivityContent(value);
+  if (!part) return getLegacyFileActivityContribution(value);
+  const receipt = part.data;
+  return {
+    version: 1,
+    fileActivityVersion: 1,
+    fileActivityToolCallId: receipt.toolCallId,
+    ...receipt.kind === "changes" ? { fileChanges: receipt.fileChanges, fileChangeCoverage: receipt.coverage } : receipt.status === "success" ? { outputs: receipt.outputs } : {}
+  };
+}
+function upsertFileActivityContent(content, receipt) {
+  const index = content.findIndex((item) => {
+    var _a;
+    return ((_a = parseFileActivityContent(item)) == null ? void 0 : _a.id) === receipt.id;
+  });
+  if (index < 0) return [...content, receipt];
+  const previous = parseFileActivityContent(content[index]);
+  if (previous && Date.parse(previous.data.updatedAt) >= Date.parse(receipt.data.updatedAt)) return content;
+  return content.map((item, position) => position === index ? receipt : item);
+}
+function fileChangeRangeKey(resource) {
+  return JSON.stringify([resource.first.artifactId, resource.first.artifactVersionId, resource.last.artifactId, resource.last.artifactVersionId]);
+}
+const writeTools = /* @__PURE__ */ new Set(["sandbox_write_file", "sandbox_append_file", "sandbox_edit_file", "sandbox_multi_edit_file"]);
+function normalizeFileChanges(value) {
+  if (!Array.isArray(value)) return [];
+  return value.filter((item) => {
+    if (!item || typeof item !== "object") return false;
+    const change = item;
+    return typeof change.id === "string" && typeof change.workspacePath === "string" && typeof change.title === "string" && ["added", "modified", "deleted", "unknown"].includes(change.operation ?? "") && ["observed", "legacy"].includes(change.coverage ?? "") && (!change.resource || change.resource.type === "file_change" && validVersion(change.resource.first) && validVersion(change.resource.last)) && validRevision(change.before) && validRevision(change.after);
+  }).map(({ id, title, workspacePath, operation, before, after, resource, coverage, messageId, startedAt, updatedAt }) => ({
+    id,
+    title,
+    workspacePath,
+    operation,
+    before: compactRevision(before),
+    after: compactRevision(after),
+    resource,
+    coverage,
+    messageId,
+    startedAt,
+    updatedAt
+  }));
+}
+function compactRevision(value) {
+  return value ? { sha256: value.sha256, size: value.size } : value;
+}
+function normalizeFileOutputs(value) {
+  if (!Array.isArray(value)) return [];
+  return value.flatMap((item) => {
+    if (!item || typeof item !== "object") return [];
+    const output = compactOutput(item);
+    return output ? [output] : [];
+  });
+}
+function compactOutput(value) {
+  if (!value || typeof value.id !== "string" || typeof value.title !== "string" || !["file", "image", "document", "spreadsheet", "presentation", "site", "url", "mcp_app"].includes(value.kind) || value.status !== void 0 && value.status !== "success") return null;
+  const ref = value.resource;
+  const resource = (ref == null ? void 0 : ref.type) === "artifact" && typeof ref.artifactId === "string" ? { type: "artifact", artifactId: ref.artifactId, ...typeof ref.artifactVersionId === "string" ? { artifactVersionId: ref.artifactVersionId } : {} } : (ref == null ? void 0 : ref.type) === "workspace_file" && typeof ref.workspacePath === "string" ? { type: "workspace_file", workspacePath: ref.workspacePath, fileAssetId: ref.fileAssetId, storageFileId: ref.storageFileId } : (ref == null ? void 0 : ref.type) === "url" && typeof ref.url === "string" ? { type: "url", url: ref.url } : void 0;
+  if (!resource) return null;
+  const { id, kind, title, description, status, origin, workspacePath, mimeType, size, sha256, messageId, updatedAt } = value;
+  return { id, kind, title, description, status, resource, origin, workspacePath, mimeType, size, sha256, messageId, updatedAt };
+}
+function validVersion(value) {
+  return Boolean(value && typeof value.artifactId === "string" && typeof value.artifactVersionId === "string");
+}
+function validRevision(value) {
+  return value == null || typeof value.sha256 === "string" && /^[a-f0-9]{64}$/.test(value.sha256) && Number.isSafeInteger(value.size) && value.size >= 0;
+}
+function mergeFileChanges(items) {
+  const byPath = /* @__PURE__ */ new Map();
+  for (const item of [...items].sort((a, b) => (a.startedAt ?? a.updatedAt ?? "").localeCompare(b.startedAt ?? b.updatedAt ?? ""))) {
+    const previous = byPath.get(item.workspacePath);
+    if (!previous || previous.coverage === "legacy") {
+      byPath.set(item.workspacePath, item);
+      continue;
+    }
+    if (item.coverage === "legacy") continue;
+    const latest = (item.updatedAt ?? "") >= (previous.updatedAt ?? "") ? item : previous;
+    const earliest = (item.startedAt ?? item.updatedAt ?? "") < (previous.startedAt ?? previous.updatedAt ?? "") ? item : previous;
+    const before = earliest.before;
+    const after = latest.after;
+    byPath.set(item.workspacePath, {
+      ...latest,
+      before,
+      after,
+      startedAt: earliest.startedAt ?? earliest.updatedAt,
+      operation: before === null ? "added" : after === null ? "deleted" : "modified",
+      resource: earliest.resource && latest.resource ? { type: "file_change", first: earliest.resource.first, last: latest.resource.last } : latest.resource
+    });
+  }
+  return [...byPath.values()].filter((item) => {
+    var _a, _b;
+    return item.coverage === "legacy" || ((_a = item.before) == null ? void 0 : _a.sha256) !== ((_b = item.after) == null ? void 0 : _b.sha256);
+  }).sort((a, b) => (b.updatedAt ?? "").localeCompare(a.updatedAt ?? ""));
+}
+function projectMessageFileActivity(message, contribution) {
+  var _a, _b, _c, _d, _e;
+  const parts = Array.isArray(message.content) ? message.content : [];
+  const observed = [];
+  const legacyChanges = [];
+  const legacyOutputIds = /* @__PURE__ */ new Set();
+  const date = message.updatedAt ?? message.createdAt;
+  const updatedAt = date instanceof Date ? date.toISOString() : date;
+  const observedToolCalls = new Set(parts.flatMap((part) => {
+    var _a2, _b2, _c2;
+    const summary = getFileActivityContribution(part) ?? ((_a2 = part.data) == null ? void 0 : _a2.taskSummary) ?? ((_c2 = (_b2 = part.data) == null ? void 0 : _b2._meta) == null ? void 0 : _c2["xpertai/taskSummary"]);
+    return (summary == null ? void 0 : summary.fileActivityToolCallId) ? [summary.fileActivityToolCallId] : [];
+  }));
+  for (const part of parts) {
+    const receipt = getFileActivityContribution(part);
+    if (receipt) {
+      observed.push(receipt);
+      continue;
+    }
+    if ((part == null ? void 0 : part.type) !== "component" || !part.data) continue;
+    const data = part.data;
+    const explicit = data.taskSummary ?? ((_a = data._meta) == null ? void 0 : _a["xpertai/taskSummary"]);
+    if ((explicit == null ? void 0 : explicit.version) === 1) observed.push(explicit);
+    if (!writeTools.has(data.tool ?? "") || data.status !== "success") continue;
+    const path = (_b = data.input) == null ? void 0 : _b.file_path;
+    if (typeof path !== "string" || !path || path.startsWith("/") || path.split("/").includes("..")) continue;
+    legacyOutputIds.add(`workspace-file:${path}`);
+    if ((explicit == null ? void 0 : explicit.fileActivityVersion) === 1 || part.id && observedToolCalls.has(part.id)) continue;
+    legacyChanges.push({ id: `file-change:${path}`, title: path, workspacePath: path, operation: "unknown", coverage: "legacy", messageId: message.id, updatedAt });
+  }
+  if (!observed.length && !legacyOutputIds.size && !((_c = contribution.outputs) == null ? void 0 : _c.length) && !((_d = contribution.fileChanges) == null ? void 0 : _d.length)) return contribution;
+  const outputs = [...contribution.outputs ?? [], ...observed.flatMap((item) => item.outputs ?? [])];
+  const byId = /* @__PURE__ */ new Map();
+  for (const raw of outputs) {
+    const output = compactOutput(raw);
+    if (!output) continue;
+    if (legacyOutputIds.has(output.id) && output.origin !== "tool" && output.origin !== "integration") continue;
+    if ((((_e = byId.get(output.id)) == null ? void 0 : _e.updatedAt) ?? "") > (output.updatedAt ?? updatedAt ?? "")) continue;
+    byId.set(output.id, { ...output, origin: output.origin ?? "legacy", messageId: message.id ?? output.messageId, updatedAt: output.updatedAt ?? updatedAt });
+  }
+  const changes = mergeFileChanges([
+    ...legacyChanges,
+    ...normalizeFileChanges(contribution.fileChanges),
+    ...observed.flatMap((item) => normalizeFileChanges(item.fileChanges))
+  ].map((item) => ({ ...item, messageId: message.id ?? item.messageId })));
+  const coverage = [contribution.fileChangeCoverage, ...observed.map((item) => item.fileChangeCoverage)];
+  const fileChangeCoverage = coverage.includes("unavailable") ? "unavailable" : coverage.includes("partial") ? "partial" : coverage.includes("bounded") ? "bounded" : void 0;
+  return { ...contribution, fileActivityVersion: 1, fileChangeCoverage, outputs: [...byId.values()], fileChanges: changes };
+}
+function parseFileChangeReport(value) {
+  if (!value || typeof value !== "object") return null;
+  const report = value;
+  const revision = (item) => item === null || Boolean(item && validRevision(item) && (item.text === void 0 || typeof item.text === "string" && item.text.length <= 32768));
+  return report.schema === "xpert.file-change.v1" && typeof report.workspacePath === "string" && revision(report.before) && revision(report.after) ? report : null;
+}
+const MAX_DIFF_CELLS = 4e6;
+function countFileChangeLines(report) {
+  var _a, _b;
+  if (report.before && report.before.text === void 0 || report.after && report.after.text === void 0) return { status: "unavailable" };
+  const lines = (text) => text ? text.replace(/\r\n/g, "\n").replace(/\n$/, "").split("\n") : [];
+  const before = lines(((_a = report.before) == null ? void 0 : _a.text) ?? ""), after = lines(((_b = report.after) == null ? void 0 : _b.text) ?? "");
+  let start = 0, endBefore = before.length, endAfter = after.length;
+  while (start < endBefore && start < endAfter && before[start] === after[start]) start++;
+  while (endBefore > start && endAfter > start && before[endBefore - 1] === after[endAfter - 1]) {
+    endBefore--;
+    endAfter--;
+  }
+  const n = endBefore - start, m = endAfter - start;
+  if (n * m > MAX_DIFF_CELLS) return { status: "unavailable" };
+  let previous = new Uint32Array(m + 1), current = new Uint32Array(m + 1);
+  for (let i = 0; i < n; i++) {
+    for (let j = 0; j < m; j++) current[j + 1] = before[start + i] === after[start + j] ? previous[j] + 1 : Math.max(previous[j + 1], current[j]);
+    [previous, current] = [current, previous];
+  }
+  return { status: "ready", added: m - previous[m], removed: n - previous[m] };
+}
 export {
   CHATKIT_TASK_SUMMARY_OPEN_RESOURCE_EFFECT,
   CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED,
@@ -624,12 +847,18 @@ export {
   TOOL_OUTPUT_PRESENTATION_VERSION,
   chatSkillUsageKey,
   clampPetPosition,
+  countFileChangeLines,
+  fileChangeRangeKey,
+  getFileActivityContribution,
+  getLegacyFileActivityContribution,
   getMessageSkillUsages,
   getPinnedPetPosition,
+  isApprovalHostReference,
   isClientToolInterrupt,
   isClientToolInterruptPayload,
   isClientToolInterruptTask,
   isClientToolRequest,
+  isFileActivityContent,
   isHITLDecisionType,
   isHITLInterrupt,
   isHITLInterruptPayload,
@@ -645,15 +874,22 @@ export {
   isToolCallInterruptTask,
   isToolCallRequest,
   mergeChatSkillUsages,
+  mergeFileChanges,
   mergePetSpriteAtlas,
   normalizeBoundsPadding,
   normalizeChatSkillUsages,
+  normalizeFileChanges,
+  normalizeFileOutputs,
   normalizeHITLRequest,
   normalizePetOptions,
   normalizeRequestLanguage,
   normalizeThreadReference,
+  parseFileActivityContent,
+  parseFileChangeReport,
   petSpriteAtlas,
+  projectMessageFileActivity,
   resolveLocalizedText,
-  resolvePetCharacter
+  resolvePetCharacter,
+  upsertFileActivityContent
 };
 //# sourceMappingURL=index.js.map