@xopcai/xopc 0.0.90 → 0.0.91

package/dist/src/infra/restart.js

@@ -1,8 +1,8 @@
+import { init_paths_state, resolveStateDir } from "../config/paths-state.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { init_paths_state, resolveStateDir } from "../config/paths-state.js";
-import { mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import path from "node:path";
+import { mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 //#region src/infra/restart.ts
 /**
 * Gateway restart coordination — OpenClaw-aligned SIGUSR1 authorization and restart intent.

package/dist/src/infra/stable-node-path.js

@@ -1,5 +1,5 @@
-import fs from "node:fs/promises";
 import path from "node:path";
+import fs from "node:fs/promises";
 //#region src/infra/stable-node-path.ts
 /** Resolve Homebrew Cellar node paths to stable opt/bin symlinks. */
 async function resolveStableNodePath(nodePath) {

package/dist/src/infra/update-check.js

@@ -1,7 +1,7 @@
 import { PACKAGE_VERSION, init_package_version } from "../package-version.js";
 import { channelToNpmTag } from "./update-channels.js";
-import { access, readFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
+import { access, readFile } from "node:fs/promises";
 import { fileURLToPath } from "node:url";
 //#region src/infra/update-check.ts
 init_package_version();

package/dist/src/infra/update-global.js

@@ -2,9 +2,9 @@ import { resolveExecPathBinPrepend } from "./path-env.js";
 import { readPackageVersion } from "./package-json.js";
 import { applyPathPrepend } from "./path-prepend.js";
 import { createDefaultCommandRunner } from "./run-command.js";
+import path from "node:path";
 import fs from "node:fs";
 import fs$1 from "node:fs/promises";
-import path from "node:path";
 //#region src/infra/update-global.ts
 const XOPC_PACKAGE_NAME = "@xopcai/xopc";
 const GLOBAL_RENAME_PREFIX = ".";

package/dist/src/infra/update-lock.js

@@ -1,9 +1,9 @@
-import { init_write_file_atomic, writeTextAtomic } from "./write-file-atomic.js";
+import { init_paths_state, resolveUpdateLockPath } from "../config/paths-state.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { init_paths_state, resolveUpdateLockPath } from "../config/paths-state.js";
-import { mkdir, readFile, unlink } from "node:fs/promises";
+import { init_write_file_atomic, writeTextAtomic } from "./write-file-atomic.js";
 import { dirname } from "node:path";
+import { mkdir, readFile, unlink } from "node:fs/promises";
 //#region src/infra/update-lock.ts
 init_write_file_atomic();
 init_paths_state();

package/dist/src/infra/update-runner.js

@@ -8,8 +8,8 @@ import { runGlobalPackageUpdateSteps } from "./package-update-steps.js";
 import { resolveStableNodePath } from "./stable-node-path.js";
 import { trimLogTail } from "./update-log.js";
 import { maybeRestartGatewayAfterUpdate } from "./update-restart.js";
-import fs from "node:fs/promises";
 import path from "node:path";
+import fs from "node:fs/promises";
 //#region src/infra/update-runner.ts
 const DEFAULT_TIMEOUT_MS = 2700 * 1e3;
 const MAX_LOG_CHARS = 8e3;

package/dist/src/infra/update-startup.js

@@ -1,8 +1,8 @@
 import { PACKAGE_VERSION, init_package_version } from "../package-version.js";
-import { init_write_file_atomic, writeTextAtomic } from "./write-file-atomic.js";
+import { init_paths_state, resolveUpdateCheckStatePath } from "../config/paths-state.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { init_paths_state, resolveUpdateCheckStatePath } from "../config/paths-state.js";
+import { init_write_file_atomic, writeTextAtomic } from "./write-file-atomic.js";
 import { acquireUpdateLock } from "./update-lock.js";
 import { normalizeUpdateChannel } from "./update-channels.js";
 import { compareSemver, detectInstallKind, resolveNpmChannelTag, resolvePackageRoot } from "./update-check.js";

package/dist/src/infra/write-file-atomic.js

@@ -1,8 +1,8 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
-import { randomUUID } from "node:crypto";
+import path from "node:path";
 import { chmodSync, closeSync, copyFileSync, fsyncSync, mkdirSync, openSync, renameSync, rmSync, writeFileSync } from "node:fs";
+import { randomUUID } from "node:crypto";
 import { chmod, copyFile, mkdir, open, rename, rm } from "node:fs/promises";
-import path from "node:path";
 //#region src/infra/write-file-atomic.ts
 /**
 * Durable single-file writes: temp file → fsync → rename to target.

package/dist/src/notes/attachment-ref.d.ts

@@ -0,0 +1,9 @@
+/** Canonical persisted reference: xopc-attachment://notes/{noteId}/{attachmentId} */
+export declare const NOTE_ATTACHMENT_SCHEME = "xopc-attachment";
+export type ParsedNoteAttachmentRef = {
+    noteId: string;
+    attachmentId: string;
+};
+export declare function buildNoteAttachmentRef(noteId: string, attachmentId: string): string;
+export declare function parseNoteAttachmentTarget(target: string, expectedNoteId?: string): ParsedNoteAttachmentRef | null;
+export declare function attachmentIdFromTarget(target: string, noteId: string): string | undefined;

package/dist/src/notes/attachment-ref.js

@@ -0,0 +1,27 @@
+//#region src/notes/attachment-ref.ts
+/** Canonical persisted reference: xopc-attachment://notes/{noteId}/{attachmentId} */
+const NOTE_ATTACHMENT_SCHEME = "xopc-attachment";
+const CANONICAL_REF = /^xopc-attachment:\/\/notes\/([^/]+)\/([^/?#]+)$/i;
+function buildNoteAttachmentRef(noteId, attachmentId) {
+	return `${NOTE_ATTACHMENT_SCHEME}://notes/${encodeURIComponent(noteId)}/${encodeURIComponent(attachmentId)}`;
+}
+function parseNoteAttachmentTarget(target, expectedNoteId) {
+	const trimmed = target.trim();
+	if (!trimmed) return null;
+	const canonical = trimmed.split("?")[0].match(CANONICAL_REF);
+	if (!canonical) return null;
+	const noteId = decodeURIComponent(canonical[1]);
+	const attachmentId = decodeURIComponent(canonical[2]);
+	if (expectedNoteId && noteId !== expectedNoteId) return null;
+	return {
+		noteId,
+		attachmentId
+	};
+}
+function attachmentIdFromTarget(target, noteId) {
+	return parseNoteAttachmentTarget(target, noteId)?.attachmentId;
+}
+//#endregion
+export { NOTE_ATTACHMENT_SCHEME, attachmentIdFromTarget, buildNoteAttachmentRef, parseNoteAttachmentTarget };
+
+//# sourceMappingURL=attachment-ref.js.map

package/dist/src/notes/attachment-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-ref.js","names":[],"sources":["../../../src/notes/attachment-ref.ts"],"sourcesContent":["/** Canonical persisted reference: xopc-attachment://notes/{noteId}/{attachmentId} */\nexport const NOTE_ATTACHMENT_SCHEME = 'xopc-attachment';\n\nconst CANONICAL_REF =\n  /^xopc-attachment:\\/\\/notes\\/([^/]+)\\/([^/?#]+)$/i;\n\nexport type ParsedNoteAttachmentRef = {\n  noteId: string;\n  attachmentId: string;\n};\n\nexport function buildNoteAttachmentRef(noteId: string, attachmentId: string): string {\n  return `${NOTE_ATTACHMENT_SCHEME}://notes/${encodeURIComponent(noteId)}/${encodeURIComponent(attachmentId)}`;\n}\n\nexport function parseNoteAttachmentTarget(\n  target: string,\n  expectedNoteId?: string,\n): ParsedNoteAttachmentRef | null {\n  const trimmed = target.trim();\n  if (!trimmed) return null;\n\n  const canonical = trimmed.split('?')[0].match(CANONICAL_REF);\n  if (!canonical) return null;\n\n  const noteId = decodeURIComponent(canonical[1]);\n  const attachmentId = decodeURIComponent(canonical[2]);\n  if (expectedNoteId && noteId !== expectedNoteId) return null;\n  return { noteId, attachmentId };\n}\n\nexport function attachmentIdFromTarget(target: string, noteId: string): string | undefined {\n  return parseNoteAttachmentTarget(target, noteId)?.attachmentId;\n}\n"],"mappings":";;AACA,MAAa,yBAAyB;AAEtC,MAAM,gBACJ;AAOF,SAAgB,uBAAuB,QAAgB,cAA8B;AACnF,QAAO,GAAG,uBAAuB,WAAW,mBAAmB,OAAO,CAAC,GAAG,mBAAmB,aAAa;;AAG5G,SAAgB,0BACd,QACA,gBACgC;CAChC,MAAM,UAAU,OAAO,MAAM;AAC7B,KAAI,CAAC,QAAS,QAAO;CAErB,MAAM,YAAY,QAAQ,MAAM,IAAI,CAAC,GAAG,MAAM,cAAc;AAC5D,KAAI,CAAC,UAAW,QAAO;CAEvB,MAAM,SAAS,mBAAmB,UAAU,GAAG;CAC/C,MAAM,eAAe,mBAAmB,UAAU,GAAG;AACrD,KAAI,kBAAkB,WAAW,eAAgB,QAAO;AACxD,QAAO;EAAE;EAAQ;EAAc;;AAGjC,SAAgB,uBAAuB,QAAgB,QAAoC;AACzF,QAAO,0BAA0B,QAAQ,OAAO,EAAE"}

package/dist/src/notes/index.d.ts

@@ -0,0 +1,4 @@
+export { NotesStore } from './store.js';
+export { NotesService } from './service.js';
+export { resolveNotesDir, resolveNotesIndexPath, resolveNoteItemPath, resolveNoteMediaDir, resolveNoteHistoryDir } from './paths.js';
+export type { Note, NoteKind, NoteStatus, NoteAttachment, NoteAiMeta, NoteAiDeepMeta, NoteIndexEntry, NoteSnapshot, NoteSnapshotEntry, NotesIndexFile, NotesListQuery, CaptureSource, CaptureChannel, CreateNoteParams, SnapshotTrigger, } from './types.js';

package/dist/src/notes/index.js

@@ -0,0 +1,4 @@
+import { resolveNoteHistoryDir, resolveNoteItemPath, resolveNoteMediaDir, resolveNotesDir, resolveNotesIndexPath } from "./paths.js";
+import { NotesStore } from "./store.js";
+import { NotesService } from "./service.js";
+export { NotesService, NotesStore, resolveNoteHistoryDir, resolveNoteItemPath, resolveNoteMediaDir, resolveNotesDir, resolveNotesIndexPath };

package/dist/src/notes/note-attachment-sync.d.ts

@@ -0,0 +1,7 @@
+import type { Note, NoteAttachment } from './types.js';
+/** Attachment ids referenced in note markdown, blocks, or plain text. */
+export declare function collectReferencedAttachmentIds(note: Pick<Note, 'id' | 'text' | 'blocks'>): Set<string>;
+export declare function partitionAttachmentsByReference(note: Pick<Note, 'id' | 'text' | 'blocks' | 'attachments'>): {
+    kept: NoteAttachment[];
+    removed: NoteAttachment[];
+};

package/dist/src/notes/note-attachment-sync.js

@@ -0,0 +1,46 @@
+import { attachmentIdFromTarget } from "./attachment-ref.js";
+import { notePlainText } from "./note-index-meta.js";
+//#region src/notes/note-attachment-sync.ts
+const MARKDOWN_IMAGE = /!\[([^\]]*)\]\(([^)]+)\)/g;
+const MARKDOWN_LINK = /(?<!!)\[([^\]]*)\]\(([^)]+)\)/g;
+const BARE_ATTACHMENT_REF = /xopc-attachment:\/\/notes\/([^/]+)\/([^/?#"'\s)]+)/gi;
+/** Attachment ids referenced in note markdown, blocks, or plain text. */
+function collectReferencedAttachmentIds(note) {
+	const ids = /* @__PURE__ */ new Set();
+	for (const block of note.blocks ?? []) if (block.type === "image") ids.add(block.attachmentId);
+	const source = notePlainText(note);
+	if (!source.trim()) return ids;
+	for (const match of source.matchAll(MARKDOWN_IMAGE)) {
+		const target = match[2];
+		if (typeof target !== "string") continue;
+		const attachmentId = attachmentIdFromTarget(target, note.id);
+		if (attachmentId) ids.add(attachmentId);
+	}
+	for (const match of source.matchAll(MARKDOWN_LINK)) {
+		const target = match[2];
+		if (typeof target !== "string") continue;
+		const attachmentId = attachmentIdFromTarget(target, note.id);
+		if (attachmentId) ids.add(attachmentId);
+	}
+	for (const match of source.matchAll(BARE_ATTACHMENT_REF)) {
+		if (decodeURIComponent(match[1]) !== note.id) continue;
+		ids.add(decodeURIComponent(match[2]));
+	}
+	return ids;
+}
+function partitionAttachmentsByReference(note) {
+	const referenced = collectReferencedAttachmentIds(note);
+	const attachments = note.attachments ?? [];
+	const kept = [];
+	const removed = [];
+	for (const attachment of attachments) if (referenced.has(attachment.id)) kept.push(attachment);
+	else removed.push(attachment);
+	return {
+		kept,
+		removed
+	};
+}
+//#endregion
+export { collectReferencedAttachmentIds, partitionAttachmentsByReference };
+
+//# sourceMappingURL=note-attachment-sync.js.map

package/dist/src/notes/note-attachment-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"note-attachment-sync.js","names":[],"sources":["../../../src/notes/note-attachment-sync.ts"],"sourcesContent":["import type { Note, NoteAttachment } from './types.js';\nimport { attachmentIdFromTarget } from './attachment-ref.js';\nimport { notePlainText } from './note-index-meta.js';\n\nconst MARKDOWN_IMAGE = /!\\[([^\\]]*)\\]\\(([^)]+)\\)/g;\nconst MARKDOWN_LINK = /(?<!!)\\[([^\\]]*)\\]\\(([^)]+)\\)/g;\nconst BARE_ATTACHMENT_REF = /xopc-attachment:\\/\\/notes\\/([^/]+)\\/([^/?#\"'\\s)]+)/gi;\n\n/** Attachment ids referenced in note markdown, blocks, or plain text. */\nexport function collectReferencedAttachmentIds(\n  note: Pick<Note, 'id' | 'text' | 'blocks'>,\n): Set<string> {\n  const ids = new Set<string>();\n\n  for (const block of note.blocks ?? []) {\n    if (block.type === 'image') ids.add(block.attachmentId);\n  }\n\n  const source = notePlainText(note);\n  if (!source.trim()) return ids;\n\n  for (const match of source.matchAll(MARKDOWN_IMAGE)) {\n    const target = match[2];\n    if (typeof target !== 'string') continue;\n    const attachmentId = attachmentIdFromTarget(target, note.id);\n    if (attachmentId) ids.add(attachmentId);\n  }\n\n  for (const match of source.matchAll(MARKDOWN_LINK)) {\n    const target = match[2];\n    if (typeof target !== 'string') continue;\n    const attachmentId = attachmentIdFromTarget(target, note.id);\n    if (attachmentId) ids.add(attachmentId);\n  }\n\n  for (const match of source.matchAll(BARE_ATTACHMENT_REF)) {\n    const noteId = decodeURIComponent(match[1]);\n    if (noteId !== note.id) continue;\n    ids.add(decodeURIComponent(match[2]));\n  }\n\n  return ids;\n}\n\nexport function partitionAttachmentsByReference(\n  note: Pick<Note, 'id' | 'text' | 'blocks' | 'attachments'>,\n): { kept: NoteAttachment[]; removed: NoteAttachment[] } {\n  const referenced = collectReferencedAttachmentIds(note);\n  const attachments = note.attachments ?? [];\n  const kept: NoteAttachment[] = [];\n  const removed: NoteAttachment[] = [];\n\n  for (const attachment of attachments) {\n    if (referenced.has(attachment.id)) {\n      kept.push(attachment);\n    } else {\n      removed.push(attachment);\n    }\n  }\n\n  return { kept, removed };\n}\n"],"mappings":";;;AAIA,MAAM,iBAAiB;AACvB,MAAM,gBAAgB;AACtB,MAAM,sBAAsB;;AAG5B,SAAgB,+BACd,MACa;CACb,MAAM,sBAAM,IAAI,KAAa;AAE7B,MAAK,MAAM,SAAS,KAAK,UAAU,EAAE,CACnC,KAAI,MAAM,SAAS,QAAS,KAAI,IAAI,MAAM,aAAa;CAGzD,MAAM,SAAS,cAAc,KAAK;AAClC,KAAI,CAAC,OAAO,MAAM,CAAE,QAAO;AAE3B,MAAK,MAAM,SAAS,OAAO,SAAS,eAAe,EAAE;EACnD,MAAM,SAAS,MAAM;AACrB,MAAI,OAAO,WAAW,SAAU;EAChC,MAAM,eAAe,uBAAuB,QAAQ,KAAK,GAAG;AAC5D,MAAI,aAAc,KAAI,IAAI,aAAa;;AAGzC,MAAK,MAAM,SAAS,OAAO,SAAS,cAAc,EAAE;EAClD,MAAM,SAAS,MAAM;AACrB,MAAI,OAAO,WAAW,SAAU;EAChC,MAAM,eAAe,uBAAuB,QAAQ,KAAK,GAAG;AAC5D,MAAI,aAAc,KAAI,IAAI,aAAa;;AAGzC,MAAK,MAAM,SAAS,OAAO,SAAS,oBAAoB,EAAE;AAExD,MADe,mBAAmB,MAAM,GAC9B,KAAK,KAAK,GAAI;AACxB,MAAI,IAAI,mBAAmB,MAAM,GAAG,CAAC;;AAGvC,QAAO;;AAGT,SAAgB,gCACd,MACuD;CACvD,MAAM,aAAa,+BAA+B,KAAK;CACvD,MAAM,cAAc,KAAK,eAAe,EAAE;CAC1C,MAAM,OAAyB,EAAE;CACjC,MAAM,UAA4B,EAAE;AAEpC,MAAK,MAAM,cAAc,YACvB,KAAI,WAAW,IAAI,WAAW,GAAG,CAC/B,MAAK,KAAK,WAAW;KAErB,SAAQ,KAAK,WAAW;AAI5B,QAAO;EAAE;EAAM;EAAS"}

package/dist/src/notes/note-index-meta.d.ts

@@ -0,0 +1,14 @@
+import type { Note } from './types.js';
+export { parseNoteAttachmentTarget, buildNoteAttachmentRef } from './attachment-ref.js';
+export declare function notePlainText(note: Pick<Note, 'id' | 'text' | 'blocks'>): string;
+export declare function stripMediaFromPlainText(text: string): string;
+export declare function extractAttachmentFileNames(note: Pick<Note, 'attachments'>): string[] | undefined;
+export declare function extractCoverAttachmentId(note: Note): string | undefined;
+export declare function buildNoteSnippet(note: Pick<Note, 'id' | 'text' | 'blocks'>): string | undefined;
+export declare function buildNoteIndexMeta(note: Note): {
+    snippet?: string;
+    coverAttachmentId?: string;
+    voiceAttachmentId?: string;
+    voiceDurationSec?: number;
+    attachmentNames?: string[];
+};

package/dist/src/notes/note-index-meta.js

@@ -0,0 +1,87 @@
+import { attachmentIdFromTarget, buildNoteAttachmentRef, parseNoteAttachmentTarget } from "./attachment-ref.js";
+//#region src/notes/note-index-meta.ts
+const SNIPPET_LENGTH = 100;
+const MARKDOWN_IMAGE = /!\[([^\]]*)\]\(([^)]+)\)/g;
+const MARKDOWN_LINK = /(?<!!)\[([^\]]*)\]\(([^)]+)\)/g;
+const BARE_ATTACHMENT_REF = /xopc-attachment:\/\/notes\/[^/]+\/[^/?#"'\s)]+/gi;
+function notePlainText(note) {
+	if (note.text?.trim()) return note.text;
+	return note.blocks?.map((block) => {
+		if (block.type === "divider") return "";
+		if (block.type === "todo") return block.text;
+		if (block.type === "image") return `![${block.alt ?? ""}](${buildNoteAttachmentRef(note.id, block.attachmentId)})`;
+		return block.text;
+	}).join(" ") ?? "";
+}
+function isNoteMediaTarget(target) {
+	return parseNoteAttachmentTarget(target) !== null;
+}
+function stripMediaFromPlainText(text) {
+	let result = text.replace(MARKDOWN_IMAGE, " ");
+	result = result.replace(MARKDOWN_LINK, (full, _alt, target) => {
+		if (typeof target !== "string") return full;
+		return isNoteMediaTarget(target) ? " " : full;
+	});
+	result = result.replace(BARE_ATTACHMENT_REF, " ");
+	return result.replace(/\s+/g, " ").trim();
+}
+function extractAttachmentFileNames(note) {
+	const names = note.attachments?.map((item) => item.fileName.trim().toLowerCase()).filter(Boolean);
+	if (!names?.length) return void 0;
+	return [...new Set(names)];
+}
+function extractCoverAttachmentId(note) {
+	for (const block of note.blocks ?? []) {
+		if (block.type !== "image") continue;
+		const attachment = note.attachments?.find((item) => item.id === block.attachmentId);
+		if (!attachment || attachment.type === "image") return block.attachmentId;
+	}
+	const text = notePlainText(note);
+	if (!text.trim()) return void 0;
+	for (const match of text.matchAll(MARKDOWN_IMAGE)) {
+		const target = match[2];
+		if (typeof target !== "string") continue;
+		const attachmentId = attachmentIdFromTarget(target, note.id);
+		if (!attachmentId) continue;
+		const attachment = note.attachments?.find((item) => item.id === attachmentId);
+		if (!attachment || attachment.type === "image") return attachmentId;
+	}
+	for (const match of text.matchAll(BARE_ATTACHMENT_REF)) {
+		const parsed = parseNoteAttachmentTarget(match[0], note.id);
+		if (!parsed) continue;
+		const attachment = note.attachments?.find((item) => item.id === parsed.attachmentId);
+		if (!attachment || attachment.type === "image") return parsed.attachmentId;
+	}
+}
+function buildNoteSnippet(note) {
+	const text = notePlainText(note);
+	if (!text.trim()) return void 0;
+	const clean = stripMediaFromPlainText(text);
+	if (!clean) return void 0;
+	return clean.length > SNIPPET_LENGTH ? `${clean.slice(0, SNIPPET_LENGTH)}…` : clean;
+}
+function extractVoiceAttachment(note) {
+	const audio = note.attachments?.find((a) => a.type === "audio");
+	if (!audio) return {};
+	return {
+		voiceAttachmentId: audio.id,
+		voiceDurationSec: audio.duration
+	};
+}
+function buildNoteIndexMeta(note) {
+	const coverAttachmentId = extractCoverAttachmentId(note);
+	const snippet = buildNoteSnippet(note);
+	const attachmentNames = extractAttachmentFileNames(note);
+	const { voiceAttachmentId, voiceDurationSec } = extractVoiceAttachment(note);
+	return {
+		snippet,
+		coverAttachmentId,
+		voiceAttachmentId,
+		voiceDurationSec,
+		attachmentNames
+	};
+}
+//#endregion
+export { buildNoteAttachmentRef, buildNoteIndexMeta, buildNoteSnippet, extractAttachmentFileNames, extractCoverAttachmentId, notePlainText, parseNoteAttachmentTarget, stripMediaFromPlainText };
+
+//# sourceMappingURL=note-index-meta.js.map

package/dist/src/notes/note-index-meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"note-index-meta.js","names":[],"sources":["../../../src/notes/note-index-meta.ts"],"sourcesContent":["import type { Note } from './types.js';\nimport {\n  attachmentIdFromTarget,\n  buildNoteAttachmentRef,\n  parseNoteAttachmentTarget,\n} from './attachment-ref.js';\n\nconst SNIPPET_LENGTH = 100;\nconst MARKDOWN_IMAGE = /!\\[([^\\]]*)\\]\\(([^)]+)\\)/g;\nconst MARKDOWN_LINK = /(?<!!)\\[([^\\]]*)\\]\\(([^)]+)\\)/g;\nconst BARE_ATTACHMENT_REF = /xopc-attachment:\\/\\/notes\\/[^/]+\\/[^/?#\"'\\s)]+/gi;\n\nexport { parseNoteAttachmentTarget, buildNoteAttachmentRef } from './attachment-ref.js';\n\nexport function notePlainText(note: Pick<Note, 'id' | 'text' | 'blocks'>): string {\n  if (note.text?.trim()) return note.text;\n  return (\n    note.blocks\n      ?.map((block) => {\n        if (block.type === 'divider') return '';\n        if (block.type === 'todo') return block.text;\n        if (block.type === 'image') {\n          const alt = block.alt ?? '';\n          return `![${alt}](${buildNoteAttachmentRef(note.id, block.attachmentId)})`;\n        }\n        return block.text;\n      })\n      .join(' ') ?? ''\n  );\n}\n\nfunction isNoteMediaTarget(target: string): boolean {\n  return parseNoteAttachmentTarget(target) !== null;\n}\n\nexport function stripMediaFromPlainText(text: string): string {\n  let result = text.replace(MARKDOWN_IMAGE, ' ');\n  result = result.replace(MARKDOWN_LINK, (full, _alt, target) => {\n    if (typeof target !== 'string') return full;\n    return isNoteMediaTarget(target) ? ' ' : full;\n  });\n  result = result.replace(BARE_ATTACHMENT_REF, ' ');\n  return result.replace(/\\s+/g, ' ').trim();\n}\n\nexport function extractAttachmentFileNames(note: Pick<Note, 'attachments'>): string[] | undefined {\n  const names = note.attachments?.map((item) => item.fileName.trim().toLowerCase()).filter(Boolean);\n  if (!names?.length) return undefined;\n  return [...new Set(names)];\n}\n\nexport function extractCoverAttachmentId(note: Note): string | undefined {\n  for (const block of note.blocks ?? []) {\n    if (block.type !== 'image') continue;\n    const attachment = note.attachments?.find((item) => item.id === block.attachmentId);\n    if (!attachment || attachment.type === 'image') return block.attachmentId;\n  }\n\n  const text = notePlainText(note);\n  if (!text.trim()) return undefined;\n\n  for (const match of text.matchAll(MARKDOWN_IMAGE)) {\n    const target = match[2];\n    if (typeof target !== 'string') continue;\n    const attachmentId = attachmentIdFromTarget(target, note.id);\n    if (!attachmentId) continue;\n    const attachment = note.attachments?.find((item) => item.id === attachmentId);\n    if (!attachment || attachment.type === 'image') return attachmentId;\n  }\n\n  for (const match of text.matchAll(BARE_ATTACHMENT_REF)) {\n    const parsed = parseNoteAttachmentTarget(match[0], note.id);\n    if (!parsed) continue;\n    const attachment = note.attachments?.find((item) => item.id === parsed.attachmentId);\n    if (!attachment || attachment.type === 'image') return parsed.attachmentId;\n  }\n\n  return undefined;\n}\n\nexport function buildNoteSnippet(note: Pick<Note, 'id' | 'text' | 'blocks'>): string | undefined {\n  const text = notePlainText(note);\n  if (!text.trim()) return undefined;\n  const clean = stripMediaFromPlainText(text);\n  if (!clean) return undefined;\n  return clean.length > SNIPPET_LENGTH ? `${clean.slice(0, SNIPPET_LENGTH)}…` : clean;\n}\n\nfunction extractVoiceAttachment(note: Note): { voiceAttachmentId?: string; voiceDurationSec?: number } {\n  const audio = note.attachments?.find((a) => a.type === 'audio');\n  if (!audio) return {};\n  return { voiceAttachmentId: audio.id, voiceDurationSec: audio.duration };\n}\n\nexport function buildNoteIndexMeta(note: Note): {\n  snippet?: string;\n  coverAttachmentId?: string;\n  voiceAttachmentId?: string;\n  voiceDurationSec?: number;\n  attachmentNames?: string[];\n} {\n  const coverAttachmentId = extractCoverAttachmentId(note);\n  const snippet = buildNoteSnippet(note);\n  const attachmentNames = extractAttachmentFileNames(note);\n  const { voiceAttachmentId, voiceDurationSec } = extractVoiceAttachment(note);\n  return {\n    snippet,\n    coverAttachmentId,\n    voiceAttachmentId,\n    voiceDurationSec,\n    attachmentNames,\n  };\n}\n"],"mappings":"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"}

package/dist/src/notes/paths.d.ts

@@ -0,0 +1,5 @@
+export declare function resolveNotesDir(): string;
+export declare function resolveNotesIndexPath(): string;
+export declare function resolveNoteItemPath(noteId: string): string;
+export declare function resolveNoteMediaDir(noteId: string): string;
+export declare function resolveNoteHistoryDir(noteId: string): string;

package/dist/src/notes/paths.js

@@ -0,0 +1,23 @@
+import { init_paths_state, resolveStateDir } from "../config/paths-state.js";
+import { join } from "node:path";
+//#region src/notes/paths.ts
+init_paths_state();
+function resolveNotesDir() {
+	return join(resolveStateDir(), "notes");
+}
+function resolveNotesIndexPath() {
+	return join(resolveNotesDir(), "index.json");
+}
+function resolveNoteItemPath(noteId) {
+	return join(resolveNotesDir(), "items", `${noteId}.json`);
+}
+function resolveNoteMediaDir(noteId) {
+	return join(resolveNotesDir(), "media", noteId);
+}
+function resolveNoteHistoryDir(noteId) {
+	return join(resolveNotesDir(), "history", noteId);
+}
+//#endregion
+export { resolveNoteHistoryDir, resolveNoteItemPath, resolveNoteMediaDir, resolveNotesDir, resolveNotesIndexPath };
+
+//# sourceMappingURL=paths.js.map

package/dist/src/notes/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","names":[],"sources":["../../../src/notes/paths.ts"],"sourcesContent":["import { join } from 'node:path';\n\nimport { resolveStateDir } from '../config/paths-state.js';\n\nexport function resolveNotesDir(): string {\n  return join(resolveStateDir(), 'notes');\n}\n\nexport function resolveNotesIndexPath(): string {\n  return join(resolveNotesDir(), 'index.json');\n}\n\nexport function resolveNoteItemPath(noteId: string): string {\n  return join(resolveNotesDir(), 'items', `${noteId}.json`);\n}\n\nexport function resolveNoteMediaDir(noteId: string): string {\n  return join(resolveNotesDir(), 'media', noteId);\n}\n\nexport function resolveNoteHistoryDir(noteId: string): string {\n  return join(resolveNotesDir(), 'history', noteId);\n}\n"],"mappings":";;;kBAE2D;AAE3D,SAAgB,kBAA0B;AACxC,QAAO,KAAK,iBAAiB,EAAE,QAAQ;;AAGzC,SAAgB,wBAAgC;AAC9C,QAAO,KAAK,iBAAiB,EAAE,aAAa;;AAG9C,SAAgB,oBAAoB,QAAwB;AAC1D,QAAO,KAAK,iBAAiB,EAAE,SAAS,GAAG,OAAO,OAAO;;AAG3D,SAAgB,oBAAoB,QAAwB;AAC1D,QAAO,KAAK,iBAAiB,EAAE,SAAS,OAAO;;AAGjD,SAAgB,sBAAsB,QAAwB;AAC5D,QAAO,KAAK,iBAAiB,EAAE,WAAW,OAAO"}

package/dist/src/notes/service.d.ts

@@ -0,0 +1,42 @@
+import { NotesStore } from './store.js';
+import type { CaptureSource, CreateNoteParams, Note, NoteAiPatch, NoteAttachment, NoteBlock, NoteIndexEntry, NoteSnapshot, NoteSnapshotEntry, NotesListQuery, SnapshotTrigger } from './types.js';
+export declare class NotesService {
+    private store;
+    private lastSnapshotAt;
+    constructor(store: NotesStore);
+    initialize(): Promise<void>;
+    quickCapture(text: string, source: CaptureSource): Promise<Note>;
+    createNote(params: CreateNoteParams): Promise<Note>;
+    getNote(id: string): Promise<Note | null>;
+    updateNote(id: string, patch: Partial<Note>, trigger?: SnapshotTrigger): Promise<Note | null>;
+    private reconcileAttachments;
+    syncNote(id: string, patch: Partial<Note>, baseRemoteVersion?: number): Promise<{
+        note: Note | null;
+        conflict: boolean;
+    }>;
+    createAiEditPatch(id: string, instruction: string, blocks?: NoteBlock[]): Promise<{
+        message: string;
+        patch: NoteAiPatch;
+    } | null>;
+    deleteNote(id: string): Promise<boolean>;
+    listNotes(query?: NotesListQuery): Promise<{
+        items: NoteIndexEntry[];
+        total: number;
+    }>;
+    addAttachment(noteId: string, file: {
+        name: string;
+        buffer: Buffer;
+        mimeType: string;
+        duration?: number;
+    }): Promise<NoteAttachment | null>;
+    getAttachmentPath(noteId: string, attachmentId: string): Promise<{
+        filePath: string;
+        mimeType: string;
+        fileName: string;
+    } | null>;
+    listNoteHistory(noteId: string): Promise<NoteSnapshotEntry[]>;
+    getNoteSnapshot(noteId: string, timestamp: number): Promise<NoteSnapshot | null>;
+    restoreNoteSnapshot(noteId: string, timestamp: number): Promise<Note | null>;
+    flush(): Promise<void>;
+    private maybeSaveSnapshot;
+}