@poco-ai/agentero-dsh-host 0.0.0-stage → 0.1.1

package/lib/notes-files.js

@@ -0,0 +1,427 @@
+import { lstat, mkdir, readFile, readdir, readlink, realpath, writeFile } from 'node:fs/promises';
+import * as path from 'node:path';
+/** Markdown files returned from one vault `notes` directory. */
+const NOTE_LIMIT = 500;
+const INVALID_PATH = 'invalid path';
+const NOT_FOUND = 'not found';
+function ioCode(error) {
+    if (typeof error !== 'object' || error === null || !('code' in error))
+        return undefined;
+    return typeof error.code === 'string' ? error.code : undefined;
+}
+/**
+ * Vault-relative path with `/` separators.
+ * Absolute paths and `.` / `..` segments are rejected.
+ */
+function vaultRelative(input) {
+    if (/[\u0000-\u001f]/.test(input))
+        return undefined;
+    const unified = input.replaceAll('\\', '/');
+    if (unified === '' || unified.startsWith('/') || /^[a-zA-Z]:/.test(unified))
+        return undefined;
+    if (path.win32.isAbsolute(input) || path.posix.isAbsolute(unified))
+        return undefined;
+    const segments = unified.split('/');
+    if (segments.some(segment => segment === '' || segment === '.' || segment === '..'))
+        return undefined;
+    return segments.join('/');
+}
+export function within(parent, child, allowEqual) {
+    const relative = path.relative(parent, child);
+    if (relative === '')
+        return allowEqual;
+    if (path.isAbsolute(relative))
+        return false;
+    return relative !== '..' && !relative.startsWith(`..${path.sep}`);
+}
+function samePath(left, right) {
+    return path.relative(left, right) === '';
+}
+async function vaultDirectory(vault) {
+    try {
+        const real = await realpath(vault);
+        const stat = await lstat(real);
+        if (!stat.isDirectory())
+            return undefined;
+        return real;
+    }
+    catch (error) {
+        const code = ioCode(error);
+        if (code === 'ENOENT' || code === 'ENOTDIR')
+            return undefined;
+        throw error;
+    }
+}
+function opensFence(line) {
+    const match = /^ {0,3}(`{3,}|~{3,})(.*)$/.exec(line);
+    if (match === null)
+        return undefined;
+    const marker = match[1] ?? '';
+    const info = match[2] ?? '';
+    if (marker.startsWith('`') && info.includes('`'))
+        return undefined;
+    const char = marker[0];
+    if (char !== '`' && char !== '~')
+        return undefined;
+    return { char, len: marker.length };
+}
+function closesFence(line, open) {
+    const match = /^ {0,3}(`{3,}|~{3,})[ \t]*$/.exec(line);
+    if (match === null)
+        return false;
+    const marker = match[1] ?? '';
+    return marker[0] === open.char && marker.length >= open.len;
+}
+/** First ATX heading outside a fence. Empty headings are skipped. */
+function atxHeading(line) {
+    const match = /^ {0,3}(#{1,6})[ \t]+(.*)$/.exec(line);
+    if (match === null)
+        return undefined;
+    const text = (match[2] ?? '').replace(/[ \t]+#+\s*$/, '').trim();
+    if (text === '')
+        return undefined;
+    return text;
+}
+function noteTitle(text, filename) {
+    const source = text.charCodeAt(0) === 0xfeff ? text.slice(1) : text;
+    let fence;
+    for (const line of source.split(/\r?\n/)) {
+        if (fence !== undefined) {
+            if (closesFence(line, fence))
+                fence = undefined;
+            continue;
+        }
+        const opened = opensFence(line);
+        if (opened !== undefined) {
+            fence = opened;
+            continue;
+        }
+        const heading = atxHeading(line);
+        if (heading !== undefined)
+            return heading;
+    }
+    return filename;
+}
+async function walkNotes(dir, relPosix, out) {
+    if (out.length >= NOTE_LIMIT)
+        return;
+    const entries = await readdir(dir, { withFileTypes: true });
+    entries.sort((left, right) => left.name.localeCompare(right.name));
+    const files = [];
+    const dirs = [];
+    for (const entry of entries) {
+        if (entry.isSymbolicLink())
+            continue;
+        if (entry.isDirectory()) {
+            if (entry.name.startsWith('.'))
+                continue;
+            dirs.push(entry.name);
+            continue;
+        }
+        if (!entry.isFile() || !entry.name.endsWith('.md'))
+            continue;
+        files.push(entry.name);
+    }
+    for (const name of files) {
+        if (out.length >= NOTE_LIMIT)
+            return;
+        const rel = `${relPosix}/${name}`;
+        let title = name;
+        try {
+            title = noteTitle(await readFile(path.join(dir, name), 'utf8'), name);
+        }
+        catch {
+            title = name;
+        }
+        out.push({ path: rel, title });
+    }
+    for (const name of dirs) {
+        if (out.length >= NOTE_LIMIT)
+            return;
+        await walkNotes(path.join(dir, name), `${relPosix}/${name}`, out);
+    }
+}
+/** Markdown files under `<vault>/notes`. A missing notes directory is an empty list. */
+export async function listVaultNotes(vault) {
+    const root = await vaultDirectory(vault);
+    if (root === undefined)
+        return [];
+    const notesLexical = path.join(root, 'notes');
+    let notesReal;
+    try {
+        notesReal = await realpath(notesLexical);
+    }
+    catch (error) {
+        if (ioCode(error) === 'ENOENT')
+            return [];
+        throw error;
+    }
+    const stat = await lstat(notesReal);
+    if (!stat.isDirectory() || !within(root, notesReal, false))
+        return [];
+    const notes = [];
+    await walkNotes(notesReal, 'notes', notes);
+    notes.sort((left, right) => left.path.localeCompare(right.path));
+    return notes;
+}
+/** Read a UTF-8 file whose real path stays inside the vault. */
+export async function readVaultFile(vault, rawPath) {
+    const relative = vaultRelative(rawPath);
+    if (relative === undefined)
+        return { status: 400, error: INVALID_PATH };
+    const root = await vaultDirectory(vault);
+    if (root === undefined)
+        return { status: 404, error: NOT_FOUND };
+    const lexical = path.join(root, ...relative.split('/'));
+    if (!within(root, lexical, false))
+        return { status: 400, error: INVALID_PATH };
+    try {
+        const stat = await lstat(lexical);
+        if (stat.isSymbolicLink()) {
+            const target = await readlink(lexical);
+            const resolved = path.resolve(path.dirname(lexical), target);
+            if (!within(root, resolved, false))
+                return { status: 400, error: INVALID_PATH };
+        }
+    }
+    catch (error) {
+        const code = ioCode(error);
+        if (code === 'ENOENT')
+            return { status: 404, error: NOT_FOUND };
+        if (code === 'ELOOP' || code === 'ENOTDIR')
+            return { status: 400, error: INVALID_PATH };
+        throw error;
+    }
+    let real;
+    try {
+        real = await realpath(lexical);
+    }
+    catch (error) {
+        const code = ioCode(error);
+        if (code === 'ENOENT')
+            return { status: 404, error: NOT_FOUND };
+        if (code === 'ELOOP' || code === 'ENOTDIR')
+            return { status: 400, error: INVALID_PATH };
+        throw error;
+    }
+    if (!within(root, real, false))
+        return { status: 400, error: INVALID_PATH };
+    const stat = await lstat(real);
+    if (!stat.isFile())
+        return { status: 400, error: INVALID_PATH };
+    const text = await readFile(real, 'utf8');
+    return { status: 200, path: relative, text };
+}
+/** Nearest existing directory at or above `start`. */
+async function firstExisting(start) {
+    const missing = [];
+    let current = start;
+    for (;;) {
+        let stat;
+        try {
+            stat = await lstat(current);
+        }
+        catch (error) {
+            if (ioCode(error) !== 'ENOENT')
+                throw error;
+            missing.push(current);
+            const parent = path.dirname(current);
+            if (parent === current)
+                return 'bad';
+            current = parent;
+            continue;
+        }
+        if (!stat.isDirectory() && !stat.isSymbolicLink())
+            return 'bad';
+        let real;
+        try {
+            real = await realpath(current);
+        }
+        catch (error) {
+            const code = ioCode(error);
+            if (code === 'ENOENT' || code === 'ELOOP' || code === 'ENOTDIR')
+                return 'bad';
+            throw error;
+        }
+        const realStat = await lstat(real);
+        if (!realStat.isDirectory())
+            return 'bad';
+        return { lexical: current, real, missing };
+    }
+}
+function notesFile(relative) {
+    return relative.startsWith('notes/') && relative.length > 'notes/'.length;
+}
+/** `papers/<id>/NOTES.md` only. The paper directory must already exist. */
+function paperNotesFile(relative) {
+    return /^papers\/[^/]+\/NOTES\.md$/.test(relative);
+}
+/**
+ * Resolve a vault-relative path to a lexical path inside the vault.
+ * Does not require the target to exist.
+ */
+export async function locateVaultPath(vault, rawPath) {
+    const relative = vaultRelative(rawPath);
+    if (relative === undefined)
+        return { ok: false, status: 400, error: INVALID_PATH };
+    const root = await vaultDirectory(vault);
+    if (root === undefined)
+        return { ok: false, status: 404, error: NOT_FOUND };
+    const lexical = path.join(root, ...relative.split('/'));
+    if (!within(root, lexical, false))
+        return { ok: false, status: 400, error: INVALID_PATH };
+    return { ok: true, location: { root, relative, lexical } };
+}
+/**
+ * Create or replace `papers/<id>/NOTES.md`.
+ * The paper directory must already exist. This does not create `papers/`.
+ */
+async function writePaperNotes(vault, relative, text) {
+    const located = await locateVaultPath(vault, relative);
+    if (!located.ok)
+        return { status: located.status, error: located.error };
+    const { root, lexical } = located.location;
+    const parentLexical = path.dirname(lexical);
+    let parentReal;
+    try {
+        parentReal = await realpath(parentLexical);
+    }
+    catch (error) {
+        const code = ioCode(error);
+        if (code === 'ENOENT')
+            return { status: 404, error: NOT_FOUND };
+        if (code === 'ELOOP' || code === 'ENOTDIR')
+            return { status: 400, error: INVALID_PATH };
+        throw error;
+    }
+    if (!within(root, parentReal, false))
+        return { status: 400, error: INVALID_PATH };
+    const parentStat = await lstat(parentReal);
+    if (!parentStat.isDirectory())
+        return { status: 400, error: INVALID_PATH };
+    let exists = false;
+    try {
+        await lstat(lexical);
+        exists = true;
+    }
+    catch (error) {
+        if (ioCode(error) !== 'ENOENT')
+            throw error;
+    }
+    if (exists) {
+        let fileReal;
+        try {
+            fileReal = await realpath(lexical);
+        }
+        catch (error) {
+            const code = ioCode(error);
+            if (code === 'ENOENT' || code === 'ELOOP' || code === 'ENOTDIR')
+                return { status: 400, error: INVALID_PATH };
+            throw error;
+        }
+        if (!within(parentReal, fileReal, false))
+            return { status: 400, error: INVALID_PATH };
+        const fileStat = await lstat(fileReal);
+        if (!fileStat.isFile())
+            return { status: 400, error: INVALID_PATH };
+    }
+    await writeFile(lexical, text, { encoding: 'utf8', flag: exists ? 'w' : 'wx' });
+    return { status: 200, path: relative };
+}
+/**
+ * Write UTF-8 under `<vault>/notes`, or replace one paper's `NOTES.md`.
+ * Parent directories are created only inside `notes/`.
+ * Other paths are refused.
+ */
+export async function writeVaultNote(vault, rawPath, text) {
+    const relative = vaultRelative(rawPath);
+    if (relative === undefined)
+        return { status: 400, error: INVALID_PATH };
+    if (paperNotesFile(relative))
+        return writePaperNotes(vault, relative, text);
+    if (!notesFile(relative))
+        return { status: 400, error: INVALID_PATH };
+    const root = await vaultDirectory(vault);
+    if (root === undefined)
+        return { status: 404, error: NOT_FOUND };
+    const notesLexical = path.join(root, 'notes');
+    const fileLexical = path.join(root, ...relative.split('/'));
+    if (!within(notesLexical, fileLexical, false))
+        return { status: 400, error: INVALID_PATH };
+    const ancestor = await firstExisting(path.dirname(fileLexical));
+    if (ancestor === 'bad' || !within(root, ancestor.real, true))
+        return { status: 400, error: INVALID_PATH };
+    if (samePath(ancestor.real, root)) {
+        // `notes` is not an existing directory. A symlink here would write outside it.
+        try {
+            await lstat(notesLexical);
+            return { status: 400, error: INVALID_PATH };
+        }
+        catch (error) {
+            if (ioCode(error) !== 'ENOENT')
+                throw error;
+        }
+        const underNotes = ancestor.missing.every(dir => samePath(dir, notesLexical) || within(notesLexical, dir, false));
+        if (!underNotes)
+            return { status: 400, error: INVALID_PATH };
+    }
+    else {
+        let notesReal;
+        try {
+            notesReal = await realpath(notesLexical);
+        }
+        catch (error) {
+            const code = ioCode(error);
+            if (code === 'ENOENT' || code === 'ELOOP' || code === 'ENOTDIR')
+                return { status: 400, error: INVALID_PATH };
+            throw error;
+        }
+        const notesStat = await lstat(notesReal);
+        if (!notesStat.isDirectory() || !within(root, notesReal, false))
+            return { status: 400, error: INVALID_PATH };
+        if (!within(notesReal, ancestor.real, true))
+            return { status: 400, error: INVALID_PATH };
+        const projected = ancestor.missing.every(dir => {
+            const suffix = path.relative(ancestor.lexical, dir);
+            if (suffix === '' || path.isAbsolute(suffix) || suffix === '..' || suffix.startsWith(`..${path.sep}`))
+                return false;
+            return within(notesReal, path.resolve(ancestor.real, suffix), true);
+        });
+        if (!projected)
+            return { status: 400, error: INVALID_PATH };
+    }
+    let exists = false;
+    try {
+        await lstat(fileLexical);
+        exists = true;
+    }
+    catch (error) {
+        if (ioCode(error) !== 'ENOENT')
+            throw error;
+    }
+    if (exists) {
+        let fileReal;
+        let notesReal;
+        try {
+            fileReal = await realpath(fileLexical);
+            notesReal = await realpath(notesLexical);
+        }
+        catch (error) {
+            const code = ioCode(error);
+            if (code === 'ENOENT' || code === 'ELOOP' || code === 'ENOTDIR')
+                return { status: 400, error: INVALID_PATH };
+            throw error;
+        }
+        if (!within(root, fileReal, false) || !within(root, notesReal, false) || !within(notesReal, fileReal, false)) {
+            return { status: 400, error: INVALID_PATH };
+        }
+        const fileStat = await lstat(fileReal);
+        if (!fileStat.isFile())
+            return { status: 400, error: INVALID_PATH };
+    }
+    if (!exists)
+        await mkdir(path.dirname(fileLexical), { recursive: true });
+    await writeFile(fileLexical, text, { encoding: 'utf8', flag: exists ? 'w' : 'wx' });
+    return { status: 200, path: relative };
+}
+//# sourceMappingURL=notes-files.js.map

package/lib/notes-files.js.map

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

package/lib/pdf-file.d.ts

@@ -0,0 +1,23 @@
+export type PdfReadResult = {
+    status: 200;
+    bytes: Buffer;
+} | {
+    status: 400 | 404;
+    error: string;
+};
+export type PdfPathResult = {
+    status: 200;
+    realPath: string;
+} | {
+    status: 400 | 404;
+    error: string;
+};
+/**
+ * Resolve one PDF on disk.
+ * A `ref` ending in `.pdf` is that file.
+ * Any other ref is a paper directory: prefer `<dirname>.pdf`, else the first
+ * direct-child `.pdf` in locale order. Nested directories are not searched.
+ */
+export declare function locateVaultPdf(vault: string, rawRef: string): Promise<PdfPathResult>;
+/** Read one PDF. A `ref` ending in `.pdf` is that file; any other ref is a paper directory. */
+export declare function readVaultPdf(vault: string, rawRef: string): Promise<PdfReadResult>;

package/lib/pdf-file.js

@@ -0,0 +1,84 @@
+import { lstat, readdir, readFile, realpath } from 'node:fs/promises';
+import * as path from 'node:path';
+import { locateVaultPath } from './notes-files.js';
+function ioCode(error) {
+    if (typeof error !== 'object' || error === null || !('code' in error))
+        return undefined;
+    return typeof error.code === 'string' ? error.code : undefined;
+}
+async function readRegularFile(realPath) {
+    const stat = await lstat(realPath);
+    if (!stat.isFile())
+        return { status: 400, error: 'invalid path' };
+    return { status: 200, bytes: await readFile(realPath) };
+}
+/**
+ * Resolve one PDF on disk.
+ * A `ref` ending in `.pdf` is that file.
+ * Any other ref is a paper directory: prefer `<dirname>.pdf`, else the first
+ * direct-child `.pdf` in locale order. Nested directories are not searched.
+ */
+export async function locateVaultPdf(vault, rawRef) {
+    const located = await locateVaultPath(vault, rawRef);
+    if (!located.ok)
+        return { status: located.status, error: located.error };
+    const { root, relative, lexical } = located.location;
+    if (relative.toLowerCase().endsWith('.pdf')) {
+        let real;
+        try {
+            real = await realpath(lexical);
+        }
+        catch (error) {
+            const code = ioCode(error);
+            if (code === 'ENOENT')
+                return { status: 404, error: 'not found' };
+            if (code === 'ELOOP' || code === 'ENOTDIR')
+                return { status: 400, error: 'invalid path' };
+            throw error;
+        }
+        const relativeToRoot = path.relative(root, real);
+        if (relativeToRoot.startsWith('..') || path.isAbsolute(relativeToRoot)) {
+            return { status: 400, error: 'invalid path' };
+        }
+        return { status: 200, realPath: real };
+    }
+    let dirReal;
+    try {
+        dirReal = await realpath(lexical);
+    }
+    catch (error) {
+        const code = ioCode(error);
+        if (code === 'ENOENT')
+            return { status: 404, error: 'not found' };
+        if (code === 'ELOOP' || code === 'ENOTDIR')
+            return { status: 400, error: 'invalid path' };
+        throw error;
+    }
+    const relativeToRoot = path.relative(root, dirReal);
+    if (relativeToRoot.startsWith('..') || path.isAbsolute(relativeToRoot)) {
+        return { status: 400, error: 'invalid path' };
+    }
+    const dirStat = await lstat(dirReal);
+    if (!dirStat.isDirectory())
+        return { status: 400, error: 'invalid path' };
+    const entries = await readdir(dirReal, { withFileTypes: true });
+    const pdfs = entries
+        .filter(entry => entry.isFile() && entry.name.toLowerCase().endsWith('.pdf'))
+        .map(entry => entry.name)
+        .sort((left, right) => left.localeCompare(right));
+    if (pdfs.length === 0)
+        return { status: 404, error: 'not found' };
+    const preferred = `${path.posix.basename(relative)}.pdf`;
+    const name = pdfs.find(item => item === preferred) ?? pdfs[0];
+    if (name === undefined)
+        return { status: 404, error: 'not found' };
+    return { status: 200, realPath: path.join(dirReal, name) };
+}
+/** Read one PDF. A `ref` ending in `.pdf` is that file; any other ref is a paper directory. */
+export async function readVaultPdf(vault, rawRef) {
+    const located = await locateVaultPdf(vault, rawRef);
+    if (located.status !== 200)
+        return located;
+    return readRegularFile(located.realPath);
+}
+//# sourceMappingURL=pdf-file.js.map

package/lib/pdf-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-file.js","sourceRoot":"","sources":["../src/pdf-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AACrE,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAUlD,SAAS,MAAM,CAAC,KAAc;IAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IACvF,OAAO,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAA;AAChE,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,QAAgB;IAC7C,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAA;IAClC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,cAAc,EAAE,CAAA;IACjE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAA;AACzD,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAa,EAAE,MAAc;IAChE,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IACpD,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAA;IACxE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAA;IAEpD,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5C,IAAI,IAAY,CAAA;QAChB,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAA;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;YAC1B,IAAI,IAAI,KAAK,QAAQ;gBAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,CAAA;YACjE,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,SAAS;gBAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,cAAc,EAAE,CAAA;YACzF,MAAM,KAAK,CAAA;QACb,CAAC;QACD,MAAM,cAAc,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QAChD,IAAI,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;YACvE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,cAAc,EAAE,CAAA;QAC/C,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;IACxC,CAAC;IAED,IAAI,OAAe,CAAA;IACnB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAA;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;QAC1B,IAAI,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,CAAA;QACjE,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,cAAc,EAAE,CAAA;QACzF,MAAM,KAAK,CAAA;IACb,CAAC;IACD,MAAM,cAAc,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IACnD,IAAI,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QACvE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,cAAc,EAAE,CAAA;IAC/C,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,CAAA;IACpC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,cAAc,EAAE,CAAA;IAEzE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAA;IAC/D,MAAM,IAAI,GAAG,OAAO;SACjB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;SAC5E,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;SACxB,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAA;IACnD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,CAAA;IACjE,MAAM,SAAS,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAA;IACxD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAA;IAC7D,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,CAAA;IAClE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAA;AAC5D,CAAC;AAED,+FAA+F;AAC/F,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAa,EAAE,MAAc;IAC9D,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IACnD,IAAI,OAAO,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,OAAO,CAAA;IAC1C,OAAO,eAAe,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;AAC1C,CAAC"}

package/lib/tools.d.ts

@@ -0,0 +1,8 @@
+import type { ChildProcess } from 'node:child_process';
+import type { Context } from '@deepseek-ai/cordis';
+import { type CatalogSettings } from './catalog.js';
+/**
+ * Register model tools that read and import the same vault as the panels.
+ * @returns Disposer that unregisters every tool.
+ */
+export declare function registerTools(ctx: Context, settings: CatalogSettings, children: Set<ChildProcess>): () => void;