@xpert-ai/chatkit-types 0.6.1 → 0.6.3

package/dist/index.js

@@ -273,6 +273,26 @@ function normalizeRequestLanguage(locale) {
   }
   return normalized;
 }
+function normalizeThreadReference(value) {
+  if (!value || typeof value !== "object" || !("type" in value) || value.type !== "thread")
+    return null;
+  if (!("conversationId" in value) || !isLocator(value.conversationId) || !("threadId" in value) || !isLocator(value.threadId))
+    return null;
+  if ("label" in value && value.label !== void 0 && (typeof value.label !== "string" || value.label.length > 300))
+    return null;
+  if ("id" in value && value.id !== void 0 && !isLocator(value.id))
+    return null;
+  return {
+    type: "thread",
+    conversationId: value.conversationId.trim(),
+    threadId: value.threadId.trim(),
+    ..."label" in value && typeof value.label === "string" ? { label: value.label.trim() } : {},
+    ..."id" in value && typeof value.id === "string" ? { id: value.id.trim() } : {}
+  };
+}
+function isLocator(value) {
+  return typeof value === "string" && value.trim().length > 0 && value.length <= 128;
+}
 const PET_ANIMATION_NAMES = [
   "idle",
   "running-right",
@@ -524,8 +544,281 @@ function getPinnedPetPosition(pin, size, viewport, padding) {
   }
 }
 const CHATKIT_TASK_SUMMARY_OPEN_RESOURCE_EFFECT = "task_summary.open_resource";
+function chatSkillUsageKey(usage) {
+  return JSON.stringify([
+    usage.source.type,
+    usage.source.id,
+    usage.skillId,
+    usage.version
+  ]);
+}
+function mergeChatSkillUsages(...groups) {
+  const usages = /* @__PURE__ */ new Map();
+  for (const group of groups) {
+    for (const usage of group ?? []) {
+      const key = chatSkillUsageKey(usage);
+      if (!usages.has(key)) usages.set(key, usage);
+    }
+  }
+  return [...usages.values()];
+}
+function normalizeChatSkillUsages(value) {
+  if (!Array.isArray(value)) return [];
+  const usages = [];
+  for (const item of value) {
+    if (!item || typeof item !== "object" || item.activation !== "read")
+      continue;
+    const { source } = item;
+    if (!source || typeof source !== "object" || !["workspace", "project", "assistant", "plugin"].includes(source.type) || typeof source.id !== "string" || !source.id.trim())
+      continue;
+    if (typeof item.skillId !== "string" || !item.skillId.trim() || typeof item.name !== "string" || !item.name.trim() || typeof item.version !== "string" || typeof item.toolCallId !== "string" || !item.toolCallId.trim() || typeof item.loadedAt !== "string" || !Number.isFinite(Date.parse(item.loadedAt)))
+      continue;
+    usages.push({
+      skillId: item.skillId,
+      name: item.name,
+      version: item.version,
+      source: { type: source.type, id: source.id },
+      activation: "read",
+      toolCallId: item.toolCallId,
+      ...typeof item.executionId === "string" && item.executionId ? { executionId: item.executionId } : {},
+      loadedAt: item.loadedAt
+    });
+  }
+  return mergeChatSkillUsages(usages);
+}
+function summarySkillUsages(summary) {
+  return summary && typeof summary === "object" && "version" in summary && summary.version === 1 && "skillUsages" in summary ? normalizeChatSkillUsages(summary.skillUsages) : [];
+}
+function getMessageSkillUsages(message) {
+  var _a;
+  const groups = [summarySkillUsages(message.taskSummary)];
+  if (Array.isArray(message.content)) {
+    for (const part of message.content) {
+      if ((part == null ? void 0 : part.type) === "component" && ((_a = part.data) == null ? void 0 : _a.status) === "success") {
+        groups.push(summarySkillUsages(part.data.taskSummary));
+      }
+    }
+  }
+  return mergeChatSkillUsages(...groups);
+}
 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,
@@ -545,12 +838,19 @@ export {
   STATE_VARIABLE_HUMAN,
   TOOL_OUTPUT_PRESENTATION_TYPE,
   TOOL_OUTPUT_PRESENTATION_VERSION,
+  chatSkillUsageKey,
   clampPetPosition,
+  countFileChangeLines,
+  fileChangeRangeKey,
+  getFileActivityContribution,
+  getLegacyFileActivityContribution,
+  getMessageSkillUsages,
   getPinnedPetPosition,
   isClientToolInterrupt,
   isClientToolInterruptPayload,
   isClientToolInterruptTask,
   isClientToolRequest,
+  isFileActivityContent,
   isHITLDecisionType,
   isHITLInterrupt,
   isHITLInterruptPayload,
@@ -565,13 +865,23 @@ export {
   isToolCallInterruptPayload,
   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