@lemoncat7/dsh-knowledge 1.1.5 → 2.0.0

package/lib/note-reference-tools.js

@@ -0,0 +1,119 @@
+import { readMountedKnowledge } from './retrieval.js';
+import { assertExplicitKnowledgeNoteReferenceRequest, assertExplicitKnowledgeNoteRequest } from './tool-authorization.js';
+import { optionalToolInteger, requiredToolString, requireToolAgent, toolRecord } from './tool-input.js';
+const textOutput = {
+    schema: { type: 'string' },
+    render: (_args, value) => [{ type: 'text', text: String(value) }],
+};
+export function registerKnowledgeNoteReferenceTools(ctx, provider, knowledgeCodec, noteCodec) {
+    ctx.tools.register(searchNotesTool(provider, noteCodec));
+    ctx.tools.register(manageNoteReferencesTool(provider, knowledgeCodec, noteCodec));
+}
+function searchNotesTool(provider, codec) {
+    return {
+        name: 'knowledge_note_search',
+        description: 'Search note-document and editable-file metadata when the current user explicitly asks to inspect, edit, organize, or reference notes. This never reads note content. Pass exact returned handles to knowledge_note_read/update/move/delete or knowledge_note_references; never invent a handle.',
+        parameters: {
+            type: 'object', additionalProperties: false,
+            properties: {
+                query: { type: 'string', description: 'A focused note filename or title query.' },
+                limit: { type: 'integer', description: 'Maximum results, default 10 and maximum 20.' },
+            },
+            required: ['query'],
+        },
+        output: textOutput,
+        isConcurrencySafe: () => true,
+        async execute(raw, exec) {
+            const agent = requireToolAgent(exec, 'knowledge note tools');
+            assertExplicitKnowledgeNoteRequest(agent, 'inspect');
+            const args = toolRecord(raw);
+            const query = requiredToolString(args.query, 'query', 1000);
+            const limit = optionalToolInteger(args.limit, 'limit', 1, 20) ?? 10;
+            const notes = await provider.searchNotes(query, limit, exec.signal);
+            if (notes.length === 0)
+                return `No note document matches ${JSON.stringify(query)}.`;
+            return [
+                `${notes.length} note document(s) match ${JSON.stringify(query)} (metadata only):`,
+                ...notes.map(note => `- ${note.name} (${note.kind === 'document' ? 'note document' : note.mediaType ?? 'file'}, handle: ${codec.encode(agent.session.id, note.id)})`),
+            ].join('\n');
+        },
+    };
+}
+function manageNoteReferencesTool(provider, knowledgeCodec, noteCodec) {
+    return {
+        name: 'knowledge_note_references',
+        description: 'Inspect, add, or remove the structured note references of one knowledge document only when the current user explicitly asks. The knowledge handle must come from knowledge_search and note handles from knowledge_note_search or this tool. References are metadata relationships and never modify the Markdown body. Add/remove requires a currently writable mounted knowledge base and an open document.',
+        parameters: {
+            type: 'object', additionalProperties: false,
+            properties: {
+                knowledgeHandle: { type: 'string', description: 'Exact signed knowledge handle returned by knowledge_search.' },
+                operation: { type: 'string', enum: ['list', 'add', 'remove'] },
+                noteHandles: { type: 'array', items: { type: 'string' }, maxItems: 16, description: 'Exact note handles. Required for add/remove; omitted for list.' },
+            },
+            required: ['knowledgeHandle', 'operation'],
+        },
+        output: textOutput,
+        isConcurrencySafe: args => toolRecord(args).operation === 'list',
+        async execute(raw, exec) {
+            const agent = requireToolAgent(exec, 'knowledge note tools');
+            const args = toolRecord(raw);
+            const operation = parseOperation(args.operation);
+            assertExplicitKnowledgeNoteReferenceRequest(agent, operation === 'list' ? 'inspect' : operation);
+            const knowledgeHandle = requiredToolString(args.knowledgeHandle, 'knowledgeHandle', 4096);
+            const { entry, mount } = await readMountedKnowledge(provider, agent, knowledgeHandle, knowledgeCodec, exec.signal);
+            if (operation !== 'list' && mount.writeMode === 'none') {
+                throw new Error('the knowledge document is mounted read-only in this session');
+            }
+            const noteHandles = parseNoteHandles(args.noteHandles, operation);
+            const noteIds = [...new Set(noteHandles.map(handle => noteCodec.decode(handle, agent.session.id).noteId))];
+            let changed = 0;
+            if (operation === 'add') {
+                const before = new Set((await provider.listKnowledgeNoteReferences(entry.id, exec.signal)).map(reference => reference.note.id));
+                for (const noteId of noteIds) {
+                    await provider.addKnowledgeNoteReference(entry.id, noteId, 'agent', agent.session.id, exec.signal);
+                    if (!before.has(noteId))
+                        changed += 1;
+                }
+            }
+            if (operation === 'remove') {
+                const current = new Set((await provider.listKnowledgeNoteReferences(entry.id, exec.signal)).map(reference => reference.note.id));
+                for (const noteId of noteIds) {
+                    if (!current.has(noteId))
+                        continue;
+                    await provider.deleteKnowledgeNoteReference(entry.id, noteId, exec.signal);
+                    changed += 1;
+                }
+            }
+            const references = await provider.listKnowledgeNoteReferences(entry.id, exec.signal);
+            return JSON.stringify({
+                storage: provider.mode,
+                operation,
+                changed,
+                knowledgeDocument: { id: entry.id, title: entry.title, knowledgeBaseId: entry.knowledgeBaseId },
+                references: references.map(reference => ({
+                    name: reference.note.name,
+                    kind: reference.note.kind,
+                    mediaType: reference.note.mediaType,
+                    handle: noteCodec.encode(agent.session.id, reference.note.id),
+                })),
+            }, null, 2);
+        },
+    };
+}
+function parseOperation(value) {
+    if (value !== 'list' && value !== 'add' && value !== 'remove')
+        throw new Error('operation must be list, add, or remove');
+    return value;
+}
+function parseNoteHandles(value, operation) {
+    if (operation === 'list') {
+        if (value !== undefined)
+            throw new Error('noteHandles must be omitted when operation is list');
+        return [];
+    }
+    if (!Array.isArray(value) || value.length === 0 || value.length > 16) {
+        throw new Error('noteHandles must contain 1-16 signed handles for add/remove');
+    }
+    return value.map((handle, index) => requiredToolString(handle, `noteHandles[${index}]`, 4096));
+}
+//# sourceMappingURL=note-reference-tools.js.map

package/lib/note-reference-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"note-reference-tools.js","sourceRoot":"","sources":["../src/note-reference-tools.ts"],"names":[],"mappings":"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"}

package/lib/note-tools.d.ts

@@ -0,0 +1,6 @@
+import type { KnowledgeProvider } from './provider.js';
+import { KnowledgeNoteHandleCodec } from './note-reference-handle.js';
+import type { RuntimeContextLike } from './runtime.js';
+/** AI-facing note workspace operations. Every mutation requires a direct user request and signed session handles. */
+export declare function registerKnowledgeNoteTools(ctx: RuntimeContextLike, provider: KnowledgeProvider, codec: KnowledgeNoteHandleCodec): void;
+//# sourceMappingURL=note-tools.d.ts.map

package/lib/note-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"note-tools.d.ts","sourceRoot":"","sources":["../src/note-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAEtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAA;AACrE,OAAO,KAAK,EAAE,kBAAkB,EAA0C,MAAM,cAAc,CAAA;AAW9F,qHAAqH;AACrH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,kBAAkB,EACvB,QAAQ,EAAE,iBAAiB,EAC3B,KAAK,EAAE,wBAAwB,GAC9B,IAAI,CAON"}

package/lib/note-tools.js

@@ -0,0 +1,283 @@
+import { assertExplicitKnowledgeNoteRequest } from './tool-authorization.js';
+import { optionalToolInteger, requiredToolString, requireToolAgent, toolRecord } from './tool-input.js';
+const MAX_TOOL_NOTE_CONTENT = 200_000;
+const textOutput = {
+    schema: { type: 'string' },
+    render: (_args, value) => [{ type: 'text', text: String(value) }],
+};
+/** AI-facing note workspace operations. Every mutation requires a direct user request and signed session handles. */
+export function registerKnowledgeNoteTools(ctx, provider, codec) {
+    ctx.tools.register(listNotesTool(provider, codec));
+    ctx.tools.register(readNoteTool(provider, codec));
+    ctx.tools.register(createNoteTool(provider, codec));
+    ctx.tools.register(updateNoteTool(provider, codec));
+    ctx.tools.register(moveNoteTool(provider, codec));
+    ctx.tools.register(deleteNoteTool(provider, codec));
+}
+function listNotesTool(provider, codec) {
+    return {
+        name: 'knowledge_note_list',
+        description: 'Browse one folder in the independent note workspace, or search note and folder names. Use this when the user explicitly asks to inspect, create, organize, or edit notes. Omit folderHandle to browse the root. Handles are session-bound; pass exact returned handles to other knowledge_note tools.',
+        parameters: {
+            type: 'object', additionalProperties: false,
+            properties: {
+                folderHandle: { type: 'string', description: 'Exact signed folder handle returned by this tool. Omit for the note-workspace root.' },
+                query: { type: 'string', description: 'Optional name search across the whole note workspace. Cannot be combined with folderHandle.' },
+                limit: { type: 'integer', description: 'Maximum results, default 50 and maximum 100.' },
+            },
+        },
+        output: textOutput,
+        isConcurrencySafe: () => true,
+        async execute(raw, exec) {
+            const agent = requireToolAgent(exec, 'knowledge note tools');
+            assertExplicitKnowledgeNoteRequest(agent, 'inspect');
+            const args = toolRecord(raw);
+            const query = optionalText(args.query, 'query', 1000);
+            const folderHandle = optionalText(args.folderHandle, 'folderHandle', 4096);
+            if (query !== undefined && folderHandle !== undefined)
+                throw new Error('query and folderHandle cannot be combined');
+            const limit = optionalToolInteger(args.limit, 'limit', 1, 100) ?? 50;
+            let parentId = null;
+            let folder;
+            if (folderHandle !== undefined) {
+                folder = await resolveNoteHandle(provider, codec, agent.session.id, folderHandle, exec.signal);
+                if (folder.kind !== 'folder')
+                    throw new Error('folderHandle must identify a note folder');
+                parentId = folder.id;
+            }
+            const nodes = await provider.listNotes(query === undefined ? { parentId, limit } : { query, limit }, exec.signal);
+            return JSON.stringify({
+                storage: provider.mode,
+                scope: query === undefined ? { folder: folder?.name ?? 'root' } : { query },
+                items: nodes.map(node => noteView(node, codec.encode(agent.session.id, node.id))),
+            }, null, 2);
+        },
+    };
+}
+function readNoteTool(provider, codec) {
+    return {
+        name: 'knowledge_note_read',
+        description: 'Read a bounded chunk from an editable text or Markdown note after knowledge_note_list/search returned its exact handle. This never reads folders or binary attachments. Use offset and maxChars to continue long notes.',
+        parameters: {
+            type: 'object', additionalProperties: false,
+            properties: {
+                noteHandle: { type: 'string', description: 'Exact signed note handle returned by knowledge_note_list or knowledge_note_search.' },
+                offset: { type: 'integer', description: 'Character offset, default 0.' },
+                maxChars: { type: 'integer', description: 'Maximum returned characters, default 20000 and maximum 80000.' },
+            },
+            required: ['noteHandle'],
+        },
+        output: textOutput,
+        isConcurrencySafe: () => true,
+        async execute(raw, exec) {
+            const agent = requireToolAgent(exec, 'knowledge note tools');
+            assertExplicitKnowledgeNoteRequest(agent, 'inspect');
+            const args = toolRecord(raw);
+            const handle = requiredToolString(args.noteHandle, 'noteHandle', 4096);
+            const offset = optionalToolInteger(args.offset, 'offset', 0, 50_000_000) ?? 0;
+            const maxChars = optionalToolInteger(args.maxChars, 'maxChars', 1, 80_000) ?? 20_000;
+            const node = await resolveNoteHandle(provider, codec, agent.session.id, handle, exec.signal);
+            if (!node.editable || node.kind === 'folder')
+                throw new Error('knowledge_note_read only supports editable text and Markdown notes');
+            const { content } = await provider.readNote(node.id, exec.signal);
+            const text = decodeTextNote(content);
+            const chunk = text.slice(offset, offset + maxChars);
+            return JSON.stringify({
+                storage: provider.mode,
+                note: noteView(node, handle),
+                offset,
+                content: chunk,
+                nextOffset: offset + chunk.length < text.length ? offset + chunk.length : null,
+                totalChars: text.length,
+            }, null, 2);
+        },
+    };
+}
+function createNoteTool(provider, codec) {
+    return {
+        name: 'knowledge_note_create',
+        description: 'Create a Markdown note or folder in the active local or remote note workspace only when the current user explicitly asks. Omit parentFolderHandle to create at the root. The tool follows the active provider and never copies or synchronizes between local and remote storage.',
+        parameters: {
+            type: 'object', additionalProperties: false,
+            properties: {
+                kind: { type: 'string', enum: ['document', 'folder'] },
+                name: { type: 'string', description: 'Document title/filename or folder name.' },
+                parentFolderHandle: { type: 'string', description: 'Exact signed folder handle returned by knowledge_note_list. Omit for root.' },
+                content: { type: 'string', description: 'Initial Markdown content for a document. Omit for a folder.' },
+            },
+            required: ['kind', 'name'],
+        },
+        output: textOutput,
+        async execute(raw, exec) {
+            const agent = requireToolAgent(exec, 'knowledge note tools');
+            assertExplicitKnowledgeNoteRequest(agent, 'create');
+            const args = toolRecord(raw);
+            const kind = noteKind(args.kind);
+            const name = requiredToolString(args.name, 'name', 255);
+            const content = optionalContent(args.content, 'content') ?? '';
+            if (kind === 'folder' && args.content !== undefined)
+                throw new Error('content must be omitted when creating a folder');
+            const parentId = await resolveOptionalFolderId(provider, codec, agent.session.id, args.parentFolderHandle, 'parentFolderHandle', exec.signal);
+            const node = kind === 'folder'
+                ? await provider.createNoteFolder(name, parentId, exec.signal)
+                : await provider.createNoteDocument(name, parentId, content, exec.signal);
+            return mutationResult(provider, 'created', node, codec.encode(agent.session.id, node.id));
+        },
+    };
+}
+function updateNoteTool(provider, codec) {
+    return {
+        name: 'knowledge_note_update',
+        description: 'Rename or change one existing note only when the user explicitly asks. Use an exact signed handle. replace_content replaces the complete body; append_content preserves the existing body and appends value exactly; rename changes only the visible name.',
+        parameters: {
+            type: 'object', additionalProperties: false,
+            properties: {
+                noteHandle: { type: 'string', description: 'Exact signed handle returned by knowledge_note_list or knowledge_note_search.' },
+                operation: { type: 'string', enum: ['rename', 'replace_content', 'append_content'] },
+                value: { type: 'string', description: 'New name or content, according to operation.' },
+            },
+            required: ['noteHandle', 'operation', 'value'],
+        },
+        output: textOutput,
+        async execute(raw, exec) {
+            const agent = requireToolAgent(exec, 'knowledge note tools');
+            assertExplicitKnowledgeNoteRequest(agent, 'update');
+            const args = toolRecord(raw);
+            const handle = requiredToolString(args.noteHandle, 'noteHandle', 4096);
+            const operation = updateOperation(args.operation);
+            const node = await resolveNoteHandle(provider, codec, agent.session.id, handle, exec.signal);
+            let updated;
+            if (operation === 'rename') {
+                updated = await provider.renameNote(node.id, requiredToolString(args.value, 'value', 255), exec.signal);
+            }
+            else {
+                if (!node.editable || node.kind === 'folder')
+                    throw new Error('only editable text and Markdown notes support content updates');
+                const value = requiredContent(args.value, 'value');
+                const content = operation === 'append_content'
+                    ? `${decodeTextNote((await provider.readNote(node.id, exec.signal)).content)}${value}`
+                    : value;
+                updated = await provider.updateNoteContent(node.id, new TextEncoder().encode(content), exec.signal);
+            }
+            return mutationResult(provider, 'updated', updated, codec.encode(agent.session.id, updated.id));
+        },
+    };
+}
+function moveNoteTool(provider, codec) {
+    return {
+        name: 'knowledge_note_move',
+        description: 'Move a note or folder only when the user explicitly asks. Use exact signed handles. Omit targetFolderHandle to move the item to the note-workspace root.',
+        parameters: {
+            type: 'object', additionalProperties: false,
+            properties: {
+                noteHandle: { type: 'string' },
+                targetFolderHandle: { type: 'string', description: 'Exact destination-folder handle; omit for root.' },
+            },
+            required: ['noteHandle'],
+        },
+        output: textOutput,
+        async execute(raw, exec) {
+            const agent = requireToolAgent(exec, 'knowledge note tools');
+            assertExplicitKnowledgeNoteRequest(agent, 'move');
+            const args = toolRecord(raw);
+            const handle = requiredToolString(args.noteHandle, 'noteHandle', 4096);
+            const node = await resolveNoteHandle(provider, codec, agent.session.id, handle, exec.signal);
+            const parentId = await resolveOptionalFolderId(provider, codec, agent.session.id, args.targetFolderHandle, 'targetFolderHandle', exec.signal);
+            const moved = await provider.moveNote(node.id, parentId, exec.signal);
+            return mutationResult(provider, 'moved', moved, codec.encode(agent.session.id, moved.id));
+        },
+    };
+}
+function deleteNoteTool(provider, codec) {
+    return {
+        name: 'knowledge_note_delete',
+        description: 'Permanently delete one note or folder only when the current user explicitly asks. Requires an exact signed handle. Referenced notes are protected; remote deletion also requires an admin-capable token.',
+        parameters: {
+            type: 'object', additionalProperties: false,
+            properties: { noteHandle: { type: 'string', description: 'Exact signed handle returned by knowledge_note_list or knowledge_note_search.' } },
+            required: ['noteHandle'],
+        },
+        output: textOutput,
+        async execute(raw, exec) {
+            const agent = requireToolAgent(exec, 'knowledge note tools');
+            assertExplicitKnowledgeNoteRequest(agent, 'delete');
+            const args = toolRecord(raw);
+            const handle = requiredToolString(args.noteHandle, 'noteHandle', 4096);
+            const node = await resolveNoteHandle(provider, codec, agent.session.id, handle, exec.signal);
+            await provider.deleteNote(node.id, exec.signal);
+            return JSON.stringify({ storage: provider.mode, operation: 'deleted', note: { name: node.name, kind: node.kind } }, null, 2);
+        },
+    };
+}
+async function resolveNoteHandle(provider, codec, sessionId, handle, signal) {
+    const { noteId } = codec.decode(handle, sessionId);
+    const node = await provider.getNote(noteId, signal);
+    if (node === undefined)
+        throw new Error('the note handle points to a note that no longer exists');
+    return node;
+}
+async function resolveOptionalFolderId(provider, codec, sessionId, value, label, signal) {
+    if (value === undefined)
+        return null;
+    const handle = requiredToolString(value, label, 4096);
+    const node = await resolveNoteHandle(provider, codec, sessionId, handle, signal);
+    if (node.kind !== 'folder')
+        throw new Error('the parent handle must identify a note folder');
+    return node.id;
+}
+function noteView(node, handle) {
+    return {
+        handle,
+        name: node.name,
+        kind: node.kind,
+        mediaType: node.mediaType,
+        editable: node.editable,
+        size: node.size,
+        updatedAt: node.updatedAt,
+    };
+}
+function mutationResult(provider, operation, node, handle) {
+    return JSON.stringify({ storage: provider.mode, operation, note: noteView(node, handle) }, null, 2);
+}
+function optionalText(value, name, maxLength) {
+    if (value === undefined)
+        return undefined;
+    return requiredToolString(value, name, maxLength);
+}
+function optionalContent(value, name) {
+    if (value === undefined)
+        return undefined;
+    return noteContent(value, name);
+}
+function requiredContent(value, name) {
+    if (typeof value !== 'string')
+        throw new Error(`${name} must be a string`);
+    return noteContent(value, name);
+}
+function noteContent(value, name) {
+    if (typeof value !== 'string')
+        throw new Error(`${name} must be a string`);
+    if (value.length > MAX_TOOL_NOTE_CONTENT)
+        throw new Error(`${name} must contain at most ${MAX_TOOL_NOTE_CONTENT} characters`);
+    return value;
+}
+function noteKind(value) {
+    if (value !== 'document' && value !== 'folder')
+        throw new Error('kind must be document or folder');
+    return value;
+}
+function updateOperation(value) {
+    if (value !== 'rename' && value !== 'replace_content' && value !== 'append_content') {
+        throw new Error('operation must be rename, replace_content, or append_content');
+    }
+    return value;
+}
+function decodeTextNote(content) {
+    try {
+        return new TextDecoder('utf-8', { fatal: true }).decode(content);
+    }
+    catch {
+        throw new Error('the note content is not valid UTF-8 text');
+    }
+}
+//# sourceMappingURL=note-tools.js.map

package/lib/note-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"note-tools.js","sourceRoot":"","sources":["../src/note-tools.ts"],"names":[],"mappings":"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"}

package/lib/notes/domain.d.ts

@@ -0,0 +1,44 @@
+export type NoteNodeKind = 'folder' | 'document' | 'file';
+export interface NoteNode {
+    id: string;
+    parentId: string | null;
+    kind: NoteNodeKind;
+    name: string;
+    mediaType: string | null;
+    editable: boolean;
+    size: number;
+    sha256: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface NoteReference {
+    noteId: string;
+    knowledgeBaseId: string;
+    documentId: string;
+    documentTitle: string;
+}
+export type KnowledgeNoteReferenceSource = 'user' | 'agent' | 'legacy';
+export interface KnowledgeNoteReference {
+    knowledgeId: string;
+    knowledgeBaseId: string;
+    documentTitle: string;
+    note: NoteNode;
+    source: KnowledgeNoteReferenceSource;
+    sourceSessionId?: string;
+    createdAt: string;
+}
+export interface NoteListRequest {
+    parentId?: string | null;
+    query?: string;
+    limit?: number;
+}
+export interface NoteFileUpload {
+    parentId?: string | null;
+    name: string;
+    mediaType: string;
+    content: Uint8Array;
+}
+export declare function isNoteId(value: string): boolean;
+export declare function isEditableNoteNode(node: Pick<NoteNode, 'kind' | 'name' | 'mediaType'>): boolean;
+export declare function noteReferenceMarkdown(node: Pick<NoteNode, 'id' | 'name'>): string;
+//# sourceMappingURL=domain.d.ts.map

package/lib/notes/domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../src/notes/domain.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAA;AAEzD,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,IAAI,EAAE,YAAY,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,QAAQ,EAAE,OAAO,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,eAAe,EAAE,MAAM,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,MAAM,4BAA4B,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAA;AAEtE,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAA;IACnB,eAAe,EAAE,MAAM,CAAA;IACvB,aAAa,EAAE,MAAM,CAAA;IACrB,IAAI,EAAE,QAAQ,CAAA;IACd,MAAM,EAAE,4BAA4B,CAAA;IACpC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,UAAU,CAAA;CACpB;AAqBD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC,GAAG,OAAO,CAQ/F;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,GAAG,MAAM,CAAC,GAAG,MAAM,CAEjF"}

package/lib/notes/domain.js

@@ -0,0 +1,38 @@
+const EDITABLE_NOTE_MEDIA_TYPES = new Set([
+    'application/json',
+    'application/ld+json',
+    'application/toml',
+    'application/xml',
+    'application/x-javascript',
+    'application/x-yaml',
+    'application/yaml',
+]);
+const EDITABLE_NOTE_EXTENSIONS = new Set([
+    'bash', 'c', 'cjs', 'conf', 'cpp', 'css', 'csv', 'env', 'fish', 'go', 'h', 'hpp',
+    'htm', 'html', 'ini', 'java', 'js', 'json', 'jsonc', 'jsx', 'less', 'log', 'markdown',
+    'md', 'mjs', 'properties', 'py', 'rb', 'rs', 'scss', 'sh', 'sql', 'svelte', 'toml',
+    'ts', 'tsv', 'tsx', 'txt', 'vue', 'xml', 'yaml', 'yml', 'zsh',
+]);
+const NOTE_ID_PATTERN = /^note_[a-f0-9]{32}$/;
+export function isNoteId(value) {
+    return NOTE_ID_PATTERN.test(value);
+}
+export function isEditableNoteNode(node) {
+    if (node.kind === 'document')
+        return true;
+    if (node.kind !== 'file')
+        return false;
+    const mediaType = node.mediaType?.toLocaleLowerCase() ?? '';
+    if (mediaType.startsWith('text/') || EDITABLE_NOTE_MEDIA_TYPES.has(mediaType))
+        return true;
+    const name = node.name.toLocaleLowerCase();
+    const dot = name.lastIndexOf('.');
+    return EDITABLE_NOTE_EXTENSIONS.has(dot >= 0 ? name.slice(dot + 1) : name);
+}
+export function noteReferenceMarkdown(node) {
+    return `@[${escapeMarkdownLabel(node.name)}](note://${node.id})`;
+}
+function escapeMarkdownLabel(value) {
+    return value.replaceAll('\\', '\\\\').replaceAll('[', '\\[').replaceAll(']', '\\]');
+}
+//# sourceMappingURL=domain.js.map

package/lib/notes/domain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.js","sourceRoot":"","sources":["../../src/notes/domain.ts"],"names":[],"mappings":"AA+CA,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAC;IACxC,kBAAkB;IAClB,qBAAqB;IACrB,kBAAkB;IAClB,iBAAiB;IACjB,0BAA0B;IAC1B,oBAAoB;IACpB,kBAAkB;CACnB,CAAC,CAAA;AAEF,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC;IACvC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK;IAChF,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU;IACrF,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM;IAClF,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;CAC9D,CAAC,CAAA;AAEF,MAAM,eAAe,GAAG,qBAAqB,CAAA;AAE7C,MAAM,UAAU,QAAQ,CAAC,KAAa;IACpC,OAAO,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;AACpC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAmD;IACpF,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,IAAI,CAAA;IACzC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,KAAK,CAAA;IACtC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAA;IAC3D,IAAI,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,yBAAyB,CAAC,GAAG,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAA;IAC1F,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAA;IAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;IACjC,OAAO,wBAAwB,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;AAC5E,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAmC;IACvE,OAAO,KAAK,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,EAAE,GAAG,CAAA;AAClE,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAa;IACxC,OAAO,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;AACrF,CAAC"}

package/lib/notes/store.d.ts

@@ -0,0 +1,39 @@
+import { type NoteFileUpload, type NoteListRequest, type NoteNode } from './domain.js';
+export declare class NoteStore {
+    private readonly rootPath;
+    private readonly removeOnClose;
+    private readonly db;
+    private readonly objectsPath;
+    private closed;
+    constructor(rootPath: string, removeOnClose?: boolean);
+    list(request?: NoteListRequest): NoteNode[];
+    get(id: string): NoteNode | undefined;
+    subtree(id: string): NoteNode[];
+    createFolder(name: string, parentId?: string | null): Promise<NoteNode>;
+    createDocument(name: string, parentId?: string | null, content?: string): Promise<NoteNode>;
+    upload(upload: NoteFileUpload): Promise<NoteNode>;
+    read(id: string): Promise<{
+        node: NoteNode;
+        content: Buffer;
+    }>;
+    updateContent(id: string, content: Uint8Array): Promise<NoteNode>;
+    rename(id: string, name: string): NoteNode;
+    move(id: string, parentId: string | null): NoteNode;
+    copy(id: string, parentId?: string | null, requestedName?: string): Promise<NoteNode>;
+    delete(id: string): Promise<void>;
+    close(): Promise<void>;
+    private createNode;
+    private copyNode;
+    private availableCopyName;
+    private requireNode;
+    private children;
+    private assertFolder;
+    private assertNameAvailable;
+    private nameExists;
+    private isDescendant;
+    private migrate;
+    private objectPath;
+    private assertOpen;
+}
+export declare function normalizeNoteName(value: string): string;
+//# sourceMappingURL=store.d.ts.map

package/lib/notes/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/notes/store.ts"],"names":[],"mappings":"AAMA,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,QAAQ,EAEd,MAAM,aAAa,CAAA;AAOpB,qBAAa,SAAS;IAKR,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAAU,OAAO,CAAC,QAAQ,CAAC,aAAa;IAJ7E,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAc;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IACpC,OAAO,CAAC,MAAM,CAAQ;gBAEO,QAAQ,EAAE,MAAM,EAAmB,aAAa,UAAQ;IAQrF,IAAI,CAAC,OAAO,GAAE,eAAoB,GAAG,QAAQ,EAAE;IAwB/C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAOrC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,EAAE;IAezB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI7E,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,GAAG,IAAW,EAAE,OAAO,SAAK,GAAG,OAAO,CAAC,QAAQ,CAAC;IAK7F,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIjD,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAc9D,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC;IAcvE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ;IAU1C,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ;IAgB7C,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAiBrF,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqCjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAOd,UAAU;YAyBV,QAAQ;IAiBtB,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,OAAO;IAyBf,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,UAAU;CAGnB;AAID,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASvD"}