Spot it. Save it. Free, local-first Chrome extension for images, videos and prompts. Explore 2,000+ curated cases and connect your library to AI Agents via MCP. 提示词导演
JavaScript ai-artai-videochrome-extensionclaude-codecodexhiggsfieldjimenglocal-firstmcpmidjourneymoodboardprompt-engineeringprompt-libraryprompt-managerreference-libraryseedancevisual-bookmarksweb-clipper
import { normalizeGenerationInfo } from "./image-generation-info.js";
import { normalizeArticleDocument, removeArticleDocumentAsset } from "./article-document.js";
import { LOCAL_ASSET_REFERENCE_RECORD_TYPE } from "./local-media.js";
import { ASSET_IMPORT_FAILURE_CODES } from "./resource-limits.js";
import {
SUPPORTED_ASSET_KINDS,
assetFormatForExtension,
assetFormatForFile,
assetKindFromFileMetadata,
fileExtension,
isReportedMimeCompatible
} from "./asset-formats.js";
const MEDIA_KINDS = new Set(SUPPORTED_ASSET_KINDS);
const STORAGE_MODES = new Set(["managed", "reference"]);
const MEDIA_USAGES = new Set(["content", "poster"]);
const PLAYBACK_MODES = new Set(["local", "embed", "source"]);
const OFFICIAL_EMBED_PROVIDERS = new Set(["youtube", "vimeo", "bilibili", "douyin", "tiktok"]);
const PLAYBACK_CAPABILITIES = new Set(["native", "external", "unknown"]);
const LOCAL_ASSET_LINK_STATUSES = new Set(["relink-required", "linked", "missing", "needs-permission", "changed"]);
const GENERIC_ATTACHMENT_MIME_TYPES = new Set(["application/octet-stream", "application/x-unknown"]);
export const SUPPORTED_MEDIA_KINDS = SUPPORTED_ASSET_KINDS;
export function normalizeMediaAsset(value = {}) {
if (!value || typeof value !== "object" || Array.isArray(value)) return null;
const id = clean(value.id);
if (!id) return null;
const mimeType = clean(value.mimeType).toLocaleLowerCase("en-US");
const sourceTitle = clean(value.sourceTitle);
const requestedSourceFormat = clean(value.sourceFormat).toLocaleLowerCase("en-US").replace(/^\./u, "");
const format = assetFormatForExtension(requestedSourceFormat) ?? assetFormatForFile({ name: sourceTitle, type: mimeType });
const kind = inferKind(value.kind, mimeType, format);
if (!kind) return null;
const localAssetReference = normalizeLocalAssetReference(value, kind);
const genericManagedAttachment = normalizeGenericManagedAttachment(value, { kind, format, mimeType, requestedSourceFormat });
if (kind === "attachment" && !localAssetReference && !genericManagedAttachment &&
(format?.kind !== "attachment" || !isReportedMimeCompatible(format, mimeType))) return null;
const sourceUrl = safeHttpUrl(value.sourceUrl);
const reference = normalizeReference(value.reference, sourceUrl);
const storageMode = kind === "video" || kind === "audio" || kind === "attachment"
? STORAGE_MODES.has(value.storageMode)
? value.storageMode
: kind === "video" && reference.url && !value.assetPath && !value.screenshotPath
? "reference"
: "managed"
: "managed";
const assetPath = safeAssetPath(value.assetPath || value.screenshotPath);
const relativePath = safeAssetPath(value.relativePath);
const width = positiveInteger(value.width);
const height = positiveInteger(value.height);
const durationMs = positiveInteger(value.durationMs);
const byteSize = positiveInteger(value.byteSize);
const usage = MEDIA_USAGES.has(value.usage) ? value.usage : "content";
const generationInfo = kind === "image" && usage === "content" ? normalizeGenerationInfo(value.generationInfo) : null;
const capturedAt = validIso(value.capturedAt) || new Date().toISOString();
return {
id,
kind,
usage,
storageMode,
sourceUrl,
sourceTitle,
sourceAuthor: clean(value.sourceAuthor),
originalWorkUrl: safeHttpUrl(value.originalWorkUrl),
capturedAt,
...(generationInfo ? { generationInfo } : {}),
...(mimeTypeForKind(kind, mimeType, format) || localAssetReference || genericManagedAttachment
? { mimeType: mimeType || "application/octet-stream" }
: {}),
...(format?.kind === kind
? { sourceFormat: requestedSourceFormat || fileExtension(sourceTitle), formatCategory: format.category }
: localAssetReference ? {
sourceFormat: requestedSourceFormat || fileExtension(sourceTitle),
formatCategory: ["local-link", "other-source"].includes(value.formatCategory) ? value.formatCategory : "local-link"
} : genericManagedAttachment ? {
sourceFormat: genericManagedAttachment.sourceFormat,
formatCategory: "other-source"
} : {}),
...(width ? { width } : {}),
...(height ? { height } : {}),
...(durationMs ? { durationMs } : {}),
...(byteSize ? { byteSize } : {}),
...(localAssetReference?.sourceLastModified !== undefined
? { sourceLastModified: localAssetReference.sourceLastModified }
: {}),
...(/^[a-f0-9]{64}$/iu.test(clean(value.contentHash)) ? { contentHash: clean(value.contentHash).toLocaleLowerCase("en-US") } : {}),
...(["source", "css-background", "pixel-fallback"].includes(value.captureMethod) ? { captureMethod: value.captureMethod } : {}),
playbackCapability: storageMode === "reference" && reference.playbackMode !== "embed" && value.playbackCapability === "embedded"
? "external"
: PLAYBACK_CAPABILITIES.has(value.playbackCapability) ? value.playbackCapability
: storageMode === "reference" ? "external" : "unknown",
...(assetPath ? { assetPath } : {}),
...(relativePath ? { relativePath } : {}),
...(clean(value.posterAssetId) ? { posterAssetId: clean(value.posterAssetId) } : {}),
...(Array.isArray(value.processingWarnings) ? { processingWarnings: [...new Set(value.processingWarnings.map(clean).filter(Boolean))] } : {}),
...(kind === "document" && Array.isArray(value.extractionWarnings) ? { extractionWarnings: [...new Set(value.extractionWarnings.map(clean).filter(Boolean))] } : {}),
...(kind === "document" ? { extractedTextFormat: normalizeExtractedTextFormat(value.extractedTextFormat, format) } : {}),
...((usage === "poster" || kind === "image") && clean(value.derivedFromAssetId) ? { derivedFromAssetId: clean(value.derivedFromAssetId) } : {}),
...(kind === "image" && clean(value.derivedFromAssetId) && Number.isFinite(value.frameTimeMs) && value.frameTimeMs >= 0 ? { frameTimeMs: Math.round(value.frameTimeMs) } : {}),
...(kind === "video" && storageMode === "reference" && reference.url ? { reference } : {}),
...(localAssetReference ?? {}),
...(value.palette?.colors?.length ? { palette: structuredClone(value.palette) } : {}),
...((String(value.visionAnalysis?.reconstructionPrompt ?? value.visionAnalysis?.description ?? "").trim()
|| (value.visionAnalysis?.userEdited === true && value.visionAnalysis.reconstructionPrompt === ""))
? { visionAnalysis: structuredClone(value.visionAnalysis) }
: {}),
reviewStatus: value.reviewStatus === "verified" ? "verified" : "unverified"
};
}
export function updateLocalAssetReferenceMetadata(entryValue, assetIdValue, metadata = {}) {
const entry = normalizeEntryMedia(entryValue);
const assetId = clean(assetIdValue);
const index = entry.mediaAssets.findIndex((asset) => asset.id === assetId);
if (index < 0) throw new Error("没有找到这个本机源文件链接");
const current = entry.mediaAssets[index];
if (current.kind !== "attachment" || current.recordType !== LOCAL_ASSET_REFERENCE_RECORD_TYPE) {
throw new Error("只有本机源文件链接可以更新链接状态");
}
const sourceTitle = clean(metadata.sourceTitle).replaceAll("\\", "/").split("/").at(-1) || "";
const byteSize = positiveInteger(metadata.byteSize);
const sourceLastModified = nonNegativeIntegerOrNull(metadata.sourceLastModified);
if (!sourceTitle || !byteSize || sourceLastModified === null) throw new Error("本机源文件核验信息不完整");
let relativePath = current.relativePath;
if (metadata.relativePath !== undefined) {
relativePath = safeAssetPath(metadata.relativePath);
if (!relativePath) throw new Error("本机源文件必须使用安全相对路径");
}
const sourceFormat = clean(metadata.sourceFormat).toLocaleLowerCase("en-US").replace(/^\./u, "") || fileExtension(sourceTitle);
const mimeType = clean(metadata.mimeType).toLocaleLowerCase("en-US") || current.mimeType || "application/octet-stream";
const asset = normalizeMediaAsset({
...current,
storageMode: "reference",
sourceTitle,
relativePath,
sourceFormat,
mimeType,
byteSize,
sourceLastModified,
linkStatus: "linked",
reviewStatus: "unverified"
});
if (!asset) throw new Error("本机源文件链接元数据无效");
entry.mediaAssets[index] = asset;
return { entry, asset };
}
export function normalizeEntryMedia(entryValue = {}) {
const entry = structuredClone(entryValue);
if (entry.sourceFacts) delete entry.sourceFacts.captureWarnings;
const mediaAssets = uniqueMediaAssets(
Array.isArray(entry.mediaAssets) ? entry.mediaAssets : entry.visuals
);
const hasLegacyVisual = entry.hasScreenshot || entry.screenshotPath || entry.visionAnalysis ||
entry.screenshotWidth || entry.screenshotHeight;
if (!mediaAssets.length && hasLegacyVisual) {
const migrated = normalizeMediaAsset({
id: clean(entry.id),
kind: "image",
storageMode: "managed",
sourceUrl: entry.url,
sourceTitle: entry.title,
capturedAt: entry.screenshotUpdatedAt || entry.savedAt,
width: entry.screenshotWidth,
height: entry.screenshotHeight,
mimeType: entry.screenshotMimeType,
byteSize: entry.screenshotByteSize,
palette: entry.palette,
visionAnalysis: entry.visionAnalysis,
reviewStatus: entry.screenshotReviewStatus,
assetPath: entry.screenshotPath
});
if (migrated) mediaAssets.push(migrated);
}
const ids = new Set(mediaAssets.map((item) => item.id));
const contentAssets = mediaAssets.filter((item) => item.usage !== "poster");
const requestedPrimary = clean(entry.primaryMediaId || entry.primaryVisualId);
entry.mediaAssets = mediaAssets;
if (!mediaAssets.some(asset => asset.kind === "image" && asset.id === entry.coverVisualId)) delete entry.coverVisualId;
entry.primaryMediaId = contentAssets.some((item) => item.id === requestedPrimary) ? requestedPrimary : contentAssets[0]?.id || "";
const articleDocument = normalizeArticleDocument(entry.articleDocument);
if (articleDocument) entry.articleDocument = articleDocument;
else delete entry.articleDocument;
entry.timeNotes = normalizeTimeNotes(entry.timeNotes, ids);
entry.mediaPrompts = normalizeMediaPrompts(entry.mediaPrompts, ids);
entry.visualSetAnalyses = normalizeVersionedAnalyses(entry.visualSetAnalyses, "visual-set");
entry.videoAnalyses = normalizeVideoAnalyses(entry.videoAnalyses);
for (const field of [
"visuals", "primaryVisualId", "hasScreenshot", "screenshotWidth", "screenshotHeight",
"screenshotMimeType", "screenshotByteSize", "screenshotReviewStatus", "screenshotUpdatedAt",
"screenshotPath", "screenshotPreviousMetadata", "palette", "visionAnalysis"
]) delete entry[field];
if (entry.primaryMediaId && Array.isArray(entry.facetAssignments)) {
entry.facetAssignments = entry.facetAssignments.map((item) => item?.source === "vision_model" && !item.visualId
? { ...item, visualId: entry.primaryMediaId }
: item);
}
return entry;
}
export function entryMediaAssets(entryValue = {}) {
if (Array.isArray(entryValue?.mediaAssets)) {
const assets = entryValue.mediaAssets;
for (const asset of assets) {
if (!asset || typeof asset !== "object" || Array.isArray(asset)) {
return assets.filter((item) => item && typeof item === "object" && !Array.isArray(item));
}
}
return assets;
}
return normalizeEntryMedia(entryValue).mediaAssets;
}
export function primaryMediaAsset(entryValue = {}) {
const assets = entryMediaAssets(entryValue);
return assets.find((item) => item.id === entryValue?.primaryMediaId && item.usage !== "poster") ??
assets.find((item) => item.usage !== "poster") ?? null;
}
export function caseCoverAsset(entryValue = {}) {
const assets = entryMediaAssets(entryValue);
const selected = assets.find(asset => asset.kind === "image" && asset.id === entryValue.coverVisualId);
const primary = primaryMediaAsset(entryValue);
return selected || (primary?.kind === "image" ? primary : primary?.kind === "video" ? posterAssetForVideo(entryValue, primary) : null)
|| assets.find(asset => asset.kind === "image") || null;
}
export function setCaseCover(entryValue, assetId) {
const entry = normalizeEntryMedia(entryValue);
const asset = entry.mediaAssets.find(item => item.id === assetId && item.kind === "image");
if (!asset) throw new Error("没有找到这张图片");
return { ...entry, coverVisualId: asset.id };
}
export function primaryImageAsset(entryValue = {}) {
const assets = entryMediaAssets(entryValue);
const primary = assets.find((item) => item.id === entryValue?.primaryMediaId && item.kind === "image" && item.usage !== "poster");
return primary ?? assets.find((item) => item.kind === "image" && item.usage !== "poster") ?? null;
}
export function posterAssetForVideo(entryValue = {}, videoValue = {}) {
const assets = entryMediaAssets(entryValue);
const videoId = clean(videoValue.id);
const requested = clean(videoValue.posterAssetId);
return assets.find((item) => item.kind === "image" && item.usage === "poster" &&
(item.id === requested || item.derivedFromAssetId === videoId)) ?? null;
}
export function entryHasMedia(entryValue = {}, kind = "") {
const assets = entryMediaAssets(entryValue).filter((item) => item.usage !== "poster");
return kind ? assets.some((item) => item.kind === kind) : assets.length > 0;
}
export function addEntryMedia(entryValue, assetValue, { makePrimary = false } = {}) {
const entry = normalizeEntryMedia(entryValue);
const asset = normalizeMediaAsset(assetValue);
if (!asset) throw new Error("媒体缺少有效编号或类型");
entry.mediaAssets = [...entry.mediaAssets.filter((item) => item.id !== asset.id), asset];
if (asset.usage !== "poster" && (makePrimary || !entry.primaryMediaId)) entry.primaryMediaId = asset.id;
return entry;
}
export function removeEntryMedia(entryValue, assetId) {
const entry = normalizeEntryMedia(entryValue);
const id = clean(assetId);
const removedIds = new Set([id]);
for (const item of entry.mediaAssets) {
if (item.usage === "poster" && item.derivedFromAssetId === id) removedIds.add(item.id);
}
entry.mediaAssets = entry.mediaAssets.filter((item) => !removedIds.has(item.id));
if (removedIds.has(entry.coverVisualId)) delete entry.coverVisualId;
entry.mediaAssets = entry.mediaAssets.map((item) => {
if (!removedIds.has(item.posterAssetId)) return item;
const next = { ...item };
delete next.posterAssetId;
return next;
});
entry.timeNotes = entry.timeNotes.filter((item) => item.assetId !== id);
entry.mediaPrompts = entry.mediaPrompts.filter((item) => !removedIds.has(item.assetId));
entry.videoAnalyses = entry.videoAnalyses.filter((item) => !removedIds.has(item.assetId));
entry.visualSetAnalyses = visualSetAnalysesForAssets(entry, new Set(entry.mediaAssets.map(asset => asset.id)), true);
for (const removedId of removedIds) entry.articleDocument = removeArticleDocumentAsset(entry.articleDocument, removedId);
if (!entry.articleDocument) delete entry.articleDocument;
if (entry.primaryMediaId === id) entry.primaryMediaId = entry.mediaAssets.find((item) => item.usage !== "poster")?.id || "";
return entry;
}
export function reorderEntryMedia(entryValue, assetIds = []) {
const entry = normalizeEntryMedia(entryValue);
const byId = new Map(entry.mediaAssets.map((item) => [item.id, item]));
const ordered = [];
for (const id of assetIds.map(clean)) {
const asset = byId.get(id);
if (!asset) continue;
ordered.push(asset);
byId.delete(id);
}
entry.mediaAssets = [...ordered, ...byId.values()];
return entry;
}
export function setPrimaryMedia(entryValue, assetId) {
const entry = normalizeEntryMedia(entryValue);
const id = clean(assetId);
if (!entry.mediaAssets.some((item) => item.id === id && item.usage !== "poster")) throw new Error("没有找到这个媒体");
entry.primaryMediaId = id;
return entry;
}
export function updateEntryMedia(entryValue, assetId, updater) {
const entry = normalizeEntryMedia(entryValue);
const id = clean(assetId);
const index = entry.mediaAssets.findIndex((item) => item.id === id);
if (index < 0) throw new Error("没有找到这个媒体");
const updated = normalizeMediaAsset(typeof updater === "function" ? updater(entry.mediaAssets[index]) : updater);
if (!updated || updated.id !== id) throw new Error("媒体更新结果无效");
entry.mediaAssets[index] = updated;
return entry;
}
export function addTimeNote(entryValue, noteValue = {}) {
const entry = normalizeEntryMedia(entryValue);
const assetId = clean(noteValue.assetId);
const asset = entry.mediaAssets.find((item) => item.id === assetId && ["video", "image"].includes(item.kind));
if (!asset) throw new Error("创作备注必须关联当前案例中的图片或视频");
const note = normalizeTimeNote(
{ ...noteValue, id: clean(noteValue.id) || `note:${crypto.randomUUID()}` },
new Set(entry.mediaAssets.map((item) => item.id))
);
if (!note) throw new Error("时间点笔记缺少有效内容");
entry.timeNotes = [...entry.timeNotes.filter((item) => item.id !== note.id), note]
.toSorted((left, right) => left.startMs - right.startMs || left.createdAt.localeCompare(right.createdAt));
return entry;
}
export function removeTimeNote(entryValue, noteId) {
const entry = normalizeEntryMedia(entryValue);
const id = clean(noteId);
entry.timeNotes = entry.timeNotes.filter((item) => item.id !== id);
return entry;
}
export function setEntryMediaPrompt(entryValue, assetIdValue, textValue, source = "manual", { preserveOtherSource = false } = {}) {
const entry = normalizeEntryMedia(entryValue);
const assetId = clean(assetIdValue);
const asset = entry.mediaAssets.find((item) => item.id === assetId && ["image", "video"].includes(item.kind) && item.usage !== "poster");
if (!asset) throw new Error("没有找到对应的内容媒体");
const text = cleanMultiline(textValue);
if (!text && source === "ai-suggestion" && asset.kind === "image" && asset.visionAnalysis) {
asset.visionAnalysis = { ...asset.visionAnalysis, reconstructionPrompt: "", userEdited: true };
}
entry.mediaPrompts = entry.mediaPrompts.filter((item) => item.assetId !== assetId ||
(preserveOtherSource && item.source !== source && !(source === "manual" && item.source === "embedded")));
if (text || source === 'ai-suggestion') entry.mediaPrompts.push({
assetId,
text,
...(!text && source === 'ai-suggestion' ? { cleared: true } : {}),
textRevision: 1,
source: normalizeMediaPromptSource(source),
updatedAt: new Date().toISOString()
});
entry.mediaPrompts.sort(compareMediaPromptSources);
return entry;
}
export function currentVideoReconstruction(entryValue = {}, assetIdValue = "") {
const assetId = clean(assetIdValue);
if (!assetId) return null;
if (!entryMediaAssets(entryValue).some((asset) => asset.id === assetId && asset.kind === "video" && asset.usage !== "poster")) return null;
let current = null;
let currentTime = Number.NEGATIVE_INFINITY;
for (const analysis of normalizeVideoAnalyses(entryValue?.videoAnalyses)) {
if (analysis.assetId !== assetId || !completeVideoReconstruction(analysis)) continue;
const createdTime = Date.parse(analysis.createdAt);
if (createdTime < currentTime) continue;
current = analysis;
currentTime = createdTime;
}
return current ? structuredClone(current) : null;
}
export function editCurrentVideoReconstruction(entryValue, assetIdValue, reconstructionPromptValue) {
const entry = normalizeEntryMedia(entryValue);
const assetId = clean(assetIdValue);
const reconstructionPrompt = cleanMultiline(reconstructionPromptValue);
if (!assetId) throw new Error("没有指定要编辑的视频");
if (!reconstructionPrompt) throw new Error("AI 视觉逆推提示词不能为空");
const current = currentVideoReconstruction(entry, assetId);
if (!current) throw new Error("这个视频还没有可编辑的 AI 视觉逆推提示词");
const editedAt = new Date().toISOString();
entry.videoAnalyses = entry.videoAnalyses.map((analysis) => analysis.id === current.id
? { ...analysis, reconstructionPrompt, userEdited: true, editedAt }
: analysis);
return entry;
}
export function replaceCurrentVideoReconstruction(entryValue, assetIdValue, recordValue = {}) {
const entry = normalizeEntryMedia(entryValue);
const assetId = clean(assetIdValue);
if (!assetId || !entry.mediaAssets.some((asset) => asset.id === assetId && asset.kind === "video" && asset.usage !== "poster")) {
throw new Error("没有找到要保存逆推结果的视频");
}
const current = currentVideoReconstruction(entry, assetId);
const record = {
...structuredClone(recordValue),
id: current?.id || clean(recordValue.id),
assetId,
mode: "visual-reconstruction",
version: Math.max(1, Number(current?.version) + 1 || 1)
};
if (!record.id || !completeVideoReconstruction(record)) throw new Error("视频逆推结果不完整,未保存");
entry.videoAnalyses = current
? entry.videoAnalyses.map((analysis) => analysis.id === current.id ? record : analysis)
: [...entry.videoAnalyses, record];
return entry;
}
export function mediaDescriptions(entryValue = {}) {
return entryMediaAssets(entryValue)
.map((asset) => asset.visionAnalysis?.invalidated || asset.visionAnalysis?.quality === "partial"
? ""
: clean(asset.visionAnalysis?.reconstructionPrompt ?? asset.visionAnalysis?.description))
.filter(Boolean);
}
// Keep cross-image reports as history when only part of their input remains.
// A complete group follows its media; a partial group is never attributed to a subset.
export function visualSetAnalysesForAssets(entry, ids, retainHistory = false) {
return (entry.visualSetAnalyses ?? []).flatMap(analysis => {
const inputs = analysis.imageRoles?.map(role => role.assetId) ?? [];
if (inputs.length && inputs.every(id => ids.has(id))) return [analysis];
if (!retainHistory) return [];
return [inputs.length ? { ...analysis, invalidated: true } : analysis];
});
}
export function remapMediaAnalysisAssets(entry, assetIdMap) {
const remap = id => assetIdMap[id] ?? id;
const evidence = value => value ? { ...value, ...(Array.isArray(value.assets) ? { assets: value.assets.map(asset => ({ ...asset, assetId: remap(asset.assetId) })) } : {}) } : undefined;
const record = value => ({ ...value, ...(value.inputEvidence ? { inputEvidence: evidence(value.inputEvidence) } : {}) });
return {
...entry,
mediaAssets: entry.mediaAssets.map(asset => ({ ...asset, ...(asset.visionAnalysis ? { visionAnalysis: record(asset.visionAnalysis) } : {}) })),
videoAnalyses: (entry.videoAnalyses ?? []).map(analysis => ({ ...record(analysis), assetId: remap(analysis.assetId) })),
visualSetAnalyses: (entry.visualSetAnalyses ?? []).map(analysis => ({ ...record(analysis),
...(analysis.imageRoles ? { imageRoles: analysis.imageRoles.map(role => ({ ...role, assetId: remap(role.assetId) })) } : {}) }))
};
}
export function mediaKindFromFile(file) {
return assetKindFromFileMetadata(file);
}
function normalizeTimeNotes(values, assetIds) {
const seen = new Set();
return (Array.isArray(values) ? values : []).flatMap((value) => {
const note = normalizeTimeNote(value, assetIds);
if (!note || seen.has(note.id)) return [];
seen.add(note.id);
return [note];
}).toSorted((left, right) => left.startMs - right.startMs || left.createdAt.localeCompare(right.createdAt));
}
function normalizeMediaPromptSource(value) {
return ["webpage", "embedded", "ai-suggestion"].includes(value) ? value : "manual";
}
function compareMediaPromptSources(a, b) {
const sources = ["manual", "webpage", "embedded", "ai-suggestion"];
return sources.indexOf(a.source) - sources.indexOf(b.source);
}
function normalizeMediaPrompts(values, assetIds) {
const seen = new Set();
return (Array.isArray(values) ? values : []).flatMap((value) => {
const assetId = clean(value?.assetId);
const text = cleanMultiline(value?.text);
const source = normalizeMediaPromptSource(value?.source);
const identity = JSON.stringify([assetId, source]);
const cleared = source === 'ai-suggestion' && value.cleared === true;
if (!assetIds.has(assetId) || (!text && !cleared) || seen.has(identity)) return [];
seen.add(identity);
return [{
assetId,
text,
...(cleared ? { cleared: true } : {}),
textRevision: Math.max(1, Math.trunc(Number(value.textRevision) || 1)),
source,
updatedAt: validIso(value.updatedAt) || new Date().toISOString()
}];
}).sort(compareMediaPromptSources);
}
function normalizeVersionedAnalyses(values, kind) {
return (Array.isArray(values) ? values : []).flatMap((value) => {
const id = clean(value?.id);
const text = cleanMultiline(value?.text);
if (!id || !text) return [];
return [{
id,
kind,
text,
assetId: clean(value.assetId),
mode: clean(value.mode),
prompt: cleanMultiline(value.prompt),
sourceKind: clean(value.sourceKind),
version: Math.max(1, positiveInteger(value.version)),
batchIndex: nonNegativeInteger(value.batchIndex),
batchCount: Math.max(1, positiveInteger(value.batchCount)),
model: clean(value.model),
provider: clean(value.provider),
usage: structuredClone(value.usage || {}),
cost: value.cost != null && Number.isFinite(Number(value.cost)) && Number(value.cost) >= 0 ? Number(value.cost) : null,
routing: value.routing && typeof value.routing === "object" && !Array.isArray(value.routing)
? structuredClone(value.routing)
: null,
createdAt: validIso(value.createdAt) || new Date().toISOString(),
...(kind === "visual-set" && Array.isArray(value.imageRoles) ? {
imageRoles: value.imageRoles.map(item => ({ assetId: clean(item.assetId), role: cleanMultiline(item.role) })),
sharedVisualSystem: cleanStrings(value.sharedVisualSystem), differences: cleanStrings(value.differences),
continuity: cleanStrings(value.continuity), compositionRules: cleanStrings(value.compositionRules),
reusablePrompt: cleanMultiline(value.reusablePrompt)
} : {}),
...(value.invalidated === true ? { invalidated: true } : {}),
...(value.inputEvidence ? { inputEvidence: structuredClone(value.inputEvidence) } : {})
}];
});
}
function normalizeVideoAnalyses(values) {
return (Array.isArray(values) ? values : []).flatMap((value) => {
if (!value || typeof value !== "object" || Array.isArray(value)) return [];
const id = clean(value.id);
const text = cleanMultiline(value.text);
const reconstructionPrompt = cleanMultiline(value.reconstructionPrompt);
const mode = clean(value.mode);
if (!id || (!text && !(mode === "visual-reconstruction" && reconstructionPrompt))) return [];
const tags = normalizeVideoReconstructionTags(value.tags);
const uncertainties = normalizeVideoReconstructionUncertainties(value.uncertainties);
const createdAt = validIso(value.createdAt) || new Date().toISOString();
return [{
id,
kind: "video",
...(text ? { text } : {}),
assetId: clean(value.assetId),
mode,
prompt: cleanMultiline(value.prompt),
sourceKind: clean(value.sourceKind),
version: Math.max(1, positiveInteger(value.version)),
batchIndex: nonNegativeInteger(value.batchIndex),
batchCount: Math.max(1, positiveInteger(value.batchCount)),
model: clean(value.model),
provider: clean(value.provider),
usage: structuredClone(value.usage || {}),
cost: value.cost != null && Number.isFinite(Number(value.cost)) && Number(value.cost) >= 0 ? Number(value.cost) : null,
routing: value.routing && typeof value.routing === "object" && !Array.isArray(value.routing)
? structuredClone(value.routing)
: null,
createdAt,
...(reconstructionPrompt ? { reconstructionPrompt } : {}),
...(clean(value.requestId) ? { requestId: clean(value.requestId) } : {}),
...(clean(value.contractVersion) ? { contractVersion: clean(value.contractVersion) } : {}),
...(value.batchJobId && clean(value.batchJobId) ? { batchJobId: clean(value.batchJobId) } : {}),
...(Array.isArray(value.tags) ? { tags } : {}),
...(Array.isArray(value.uncertainties) ? { uncertainties } : {}),
...(typeof value.includeTags === "boolean" ? { includeTags: value.includeTags } : {}),
...(clean(value.analysisScope) ? { analysisScope: clean(value.analysisScope) } : {}),
...(clean(value.finishReason) ? { finishReason: clean(value.finishReason) } : {}),
...(typeof value.userEdited === "boolean" ? { userEdited: value.userEdited } : {}),
...(validIso(value.editedAt) ? { editedAt: validIso(value.editedAt) } : {}),
...(value.inputEvidence ? { inputEvidence: structuredClone(value.inputEvidence) } : {})
}];
});
}
function completeVideoReconstruction(value) {
if (value?.mode !== "visual-reconstruction" || !clean(value.assetId) || !cleanMultiline(value.reconstructionPrompt)) return false;
if (!clean(value.requestId) || !clean(value.contractVersion) || !["visual", "video"].includes(value.analysisScope)) return false;
if (typeof value.includeTags !== "boolean" || !Array.isArray(value.tags) || !Array.isArray(value.uncertainties)) return false;
const finishReason = clean(value.finishReason).toLocaleLowerCase("en-US");
if (!finishReason || ["length", "content_filter", "error", "cancelled", "canceled"].includes(finishReason)) return false;
return value.includeTags ? value.tags.length > 0 : value.tags.length === 0;
}
function normalizeVideoReconstructionTags(values) {
const seen = new Set();
return (Array.isArray(values) ? values : []).flatMap((value) => {
if (!value || typeof value !== "object" || Array.isArray(value)) return [];
const groupId = clean(value.g);
const detail = clean(value.t);
if (!groupId) return [];
const key = `${groupId}:${detail}`;
if (seen.has(key)) return [];
seen.add(key);
return [{ g: groupId, ...(detail ? { t: detail } : {}) }];
});
}
function normalizeVideoReconstructionUncertainties(values) {
const seen = new Set();
return (Array.isArray(values) ? values : []).flatMap((value) => {
const text = cleanMultiline(value);
if (!text || seen.has(text)) return [];
seen.add(text);
return [text];
});
}
function normalizeTimeNote(value, assetIds) {
const id = clean(value?.id);
const assetId = clean(value?.assetId);
const text = cleanMultiline(value?.text);
const startMs = nonNegativeInteger(value?.startMs);
const endMs = nonNegativeInteger(value?.endMs);
if (!id || !assetIds.has(assetId) || !text) return null;
const createdAt = validIso(value.createdAt) || new Date().toISOString();
const frameAssetId = clean(value.frameAssetId);
return {
id,
assetId,
startMs,
...(endMs > startMs ? { endMs } : {}),
text,
createdAt,
...(frameAssetId && assetIds.has(frameAssetId) ? { frameAssetId } : {})
};
}
function uniqueMediaAssets(values) {
const seen = new Set();
return (Array.isArray(values) ? values : []).flatMap((value) => {
const asset = normalizeMediaAsset(value);
if (!asset || seen.has(asset.id)) return [];
seen.add(asset.id);
return [asset];
});
}
function normalizeExtractedTextFormat(value, format) {
if (value === "markdown" || value === "plain") return value;
return ["markdown", "html", "rtf"].includes(format?.id)
? "markdown"
: "plain";
}
function normalizeReference(value, fallbackUrl) {
const url = safeHttpUrl(value?.url || fallbackUrl);
if (!url) return { url: "", provider: "", playbackMode: "source" };
const provider = MEDIA_REFERENCE_PROVIDERS.includes(value?.provider) ? value.provider : providerForUrl(url);
const requested = PLAYBACK_MODES.has(value?.playbackMode) ? value.playbackMode : "source";
const playbackMode = requested === "embed" && !OFFICIAL_EMBED_PROVIDERS.has(provider) ? "source" : requested;
const metadataStatus = ["resolved", "partial", "permission-denied", "unavailable"].includes(value?.metadataStatus)
? value.metadataStatus
: "partial";
const author = clean(value?.author);
return { url, provider, playbackMode, metadataStatus, ...(author ? { author } : {}),
...(safeHttpUrl(value?.playbackUrl) ? { playbackUrl: safeHttpUrl(value.playbackUrl) } : {}),
...(safeHttpUrl(value?.streamUrl) ? { streamUrl: safeHttpUrl(value.streamUrl) } : {}) };
}
function normalizeLocalAssetReference(value, kind) {
if (kind !== "attachment" || value?.storageMode !== "reference" || value?.recordType !== LOCAL_ASSET_REFERENCE_RECORD_TYPE) return null;
const linkStatus = LOCAL_ASSET_LINK_STATUSES.has(value?.linkStatus) ? value.linkStatus : "";
const message = clean(value?.importFailure?.message);
if (!linkStatus || value?.importFailure?.code !== ASSET_IMPORT_FAILURE_CODES.UNSUPPORTED_FORMAT || !message) return null;
const sourceLastModified = nonNegativeIntegerOrNull(value.sourceLastModified);
return {
recordType: LOCAL_ASSET_REFERENCE_RECORD_TYPE,
linkStatus,
importFailure: {
code: ASSET_IMPORT_FAILURE_CODES.UNSUPPORTED_FORMAT,
message,
forceAllowed: false
},
...(sourceLastModified !== null ? { sourceLastModified } : {})
};
}
function normalizeGenericManagedAttachment(value, context) {
if (context.kind !== "attachment" || value?.storageMode !== "managed" || value?.formatCategory !== "other-source") return null;
if (context.format || !GENERIC_ATTACHMENT_MIME_TYPES.has(context.mimeType)) return null;
if (!/^[a-z0-9]+$/u.test(context.requestedSourceFormat)) return null;
return { sourceFormat: context.requestedSourceFormat };
}
function providerForUrl(url) {
return detectMediaReferenceProvider(url);
}
function inferKind(value, mimeType, format) {
if (MEDIA_KINDS.has(value)) return value;
if (format) return format.kind;
if (mimeType.startsWith("image/")) return "image";
if (mimeType.startsWith("video/")) return "video";
if (mimeType.startsWith("audio/")) return "audio";
return value ? "" : "image";
}
function mimeTypeForKind(kind, mimeType, format) {
if (!mimeType) return false;
if (kind === "image") return mimeType.startsWith("image/");
if (kind === "video") return mimeType.startsWith("video/");
if (kind === "audio") return mimeType.startsWith("audio/") || format?.kind === "audio";
return format?.kind === kind;
}
function safeAssetPath(value) {
const path = clean(value).replace(/\\/g, "/");
return path && !path.startsWith("/") && !path.split("/").includes("..") ? path : "";
}
function safeHttpUrl(value) {
try {
const url = new URL(clean(value));
return ["http:", "https:"].includes(url.protocol) ? url.href : "";
} catch {
return "";
}
}
function positiveInteger(value) {
const number = Number(value);
return Number.isSafeInteger(number) && number > 0 ? number : 0;
}
function nonNegativeInteger(value) {
const number = Number(value);
return Number.isSafeInteger(number) && number >= 0 ? number : 0;
}
function nonNegativeIntegerOrNull(value) {
const number = Number(value);
return Number.isSafeInteger(number) && number >= 0 ? number : null;
}
function validIso(value) {
const text = clean(value);
return text && Number.isFinite(Date.parse(text)) ? new Date(text).toISOString() : "";
}
function cleanMultiline(value) {
return String(value ?? "").replace(/\r\n?/g, "\n").replace(/[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f]/g, "").trim();
}
function cleanStrings(values) {
return (Array.isArray(values) ? values : []).map(cleanMultiline).filter(Boolean);
}
function clean(value) {
return String(value ?? "").replace(/[\u0000-\u001f\u007f]/g, "").trim();
}
import { MEDIA_REFERENCE_PROVIDERS, detectMediaReferenceProvider } from "./media-reference-resolver.js";