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

package/lib/bookmarks-write.d.ts

@@ -0,0 +1,24 @@
+/** One outline node as the browser sends it. */
+export interface BookmarkNode {
+    /** Original tree path, or null for a node this session added. */
+    origin: string | null;
+    /** Title read from the PDF, used to detect a stale edit. */
+    originalTitle?: string;
+    title: string;
+    /** Zero-based page for new or retargeted nodes. */
+    pageIndex?: number;
+    children: BookmarkNode[];
+}
+/**
+ * Validate an untrusted outline payload.
+ * @param value - parsed JSON body field.
+ * @returns normalized nodes, or undefined when malformed or too large.
+ */
+export declare function bookmarkNodesFrom(value: unknown): BookmarkNode[] | undefined;
+/**
+ * Bake `nodes` into `bytes` as the document outline.
+ * @param bytes - original PDF.
+ * @param nodes - desired tree.
+ * @returns a new PDF; the input is not mutated.
+ */
+export declare function writePdfBookmarks(bytes: Uint8Array, nodes: BookmarkNode[]): Promise<Uint8Array>;

package/lib/bookmarks-write.js

@@ -0,0 +1,181 @@
+/**
+ * Rewrite a PDF's outline (bookmarks) without touching annotations.
+ *
+ * Same contract as the desktop app: edit the original outline dictionaries so
+ * destinations, actions and styling survive; refuse signed documents because
+ * rewriting them would invalidate the signature.
+ */
+import { PDFDict, PDFDocument, PDFHexString, PDFName, PDFNumber, PDFRef, PDFString, } from 'pdf-lib';
+const MAX_NODES = 2000;
+const MAX_DEPTH = 16;
+const MAX_TITLE = 2000;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Validate an untrusted outline payload.
+ * @param value - parsed JSON body field.
+ * @returns normalized nodes, or undefined when malformed or too large.
+ */
+export function bookmarkNodesFrom(value) {
+    let count = 0;
+    let bad = false;
+    const parse = (input, depth) => {
+        if (!Array.isArray(input) || depth > MAX_DEPTH) {
+            bad = true;
+            return [];
+        }
+        const nodes = [];
+        for (const item of input) {
+            if (!isRecord(item)) {
+                bad = true;
+                continue;
+            }
+            const title = typeof item.title === 'string' ? item.title.trim() : '';
+            const origin = typeof item.origin === 'string' ? item.origin : null;
+            const originalTitle = typeof item.originalTitle === 'string' ? item.originalTitle : undefined;
+            const pageIndex = typeof item.pageIndex === 'number' ? item.pageIndex : undefined;
+            if (title === '' || title.length > MAX_TITLE) {
+                bad = true;
+                continue;
+            }
+            if (pageIndex !== undefined && (!Number.isInteger(pageIndex) || pageIndex < 0)) {
+                bad = true;
+                continue;
+            }
+            if (origin !== null && origin !== '') {
+                const segments = origin.split('.');
+                if (!segments.every(segment => /^\d+$/.test(segment))) {
+                    bad = true;
+                    continue;
+                }
+            }
+            count += 1;
+            if (count > MAX_NODES) {
+                bad = true;
+                return [];
+            }
+            nodes.push({
+                origin: origin === '' ? null : origin,
+                ...(originalTitle === undefined ? {} : { originalTitle }),
+                title,
+                ...(pageIndex === undefined ? {} : { pageIndex }),
+                children: parse(item.children ?? [], depth + 1),
+            });
+        }
+        return nodes;
+    };
+    const nodes = parse(value, 0);
+    return bad ? undefined : nodes;
+}
+/**
+ * Bake `nodes` into `bytes` as the document outline.
+ * @param bytes - original PDF.
+ * @param nodes - desired tree.
+ * @returns a new PDF; the input is not mutated.
+ */
+export async function writePdfBookmarks(bytes, nodes) {
+    const pdf = await PDFDocument.load(bytes, { updateMetadata: false });
+    const name = PDFName.of;
+    for (const [, object] of pdf.context.enumerateIndirectObjects()) {
+        if (object instanceof PDFDict &&
+            (object.has(name('ByteRange')) || object.get(name('FT')) === name('Sig'))) {
+            throw new Error('protected');
+        }
+    }
+    const originals = new Map();
+    const seen = new Set();
+    const root = pdf.catalog.lookupMaybe(name('Outlines'), PDFDict);
+    function read(parent, prefix) {
+        let item = parent.get(name('First'));
+        let index = 0;
+        while (item) {
+            if (!(item instanceof PDFRef) || seen.has(item.toString()))
+                throw new Error('unsupported');
+            seen.add(item.toString());
+            const dict = pdf.context.lookup(item, PDFDict);
+            const action = dict.lookupMaybe(name('A'), PDFDict);
+            if (action && (action.get(name('S')) !== name('GoTo') || action.has(name('Next')))) {
+                throw new Error('unsupported');
+            }
+            const key = `${prefix}${index++}`;
+            originals.set(key, { dict, ref: item });
+            read(dict, `${key}.`);
+            item = dict.get(name('Next'));
+        }
+    }
+    if (root)
+        read(root, '');
+    const outlines = root ?? pdf.context.obj({ Type: 'Outlines' });
+    const rootRef = pdf.context.getObjectRef(outlines) ?? pdf.context.register(outlines);
+    const pages = pdf.getPages();
+    const used = new Set();
+    function write(items, parent, parentRef) {
+        const entries = items.map((node) => {
+            if (!node.title.trim())
+                throw new Error('invalid');
+            if (node.origin !== null &&
+                (used.has(node.origin) || !originals.has(node.origin))) {
+                throw new Error('unsupported');
+            }
+            if (node.origin !== null)
+                used.add(node.origin);
+            const original = node.origin === null ? undefined : originals.get(node.origin);
+            if (original && node.originalTitle !== undefined) {
+                const title = original.dict.lookup(name('Title'));
+                if (!(title instanceof PDFString || title instanceof PDFHexString) ||
+                    title.decodeText() !== node.originalTitle) {
+                    throw new Error('unsupported');
+                }
+            }
+            const dict = original?.dict ?? pdf.context.obj({});
+            const ref = original?.ref ?? pdf.context.register(dict);
+            dict.set(name('Title'), PDFHexString.fromText(node.title.trim()));
+            dict.set(name('Parent'), parentRef);
+            if (node.pageIndex !== undefined) {
+                if (!Number.isInteger(node.pageIndex) || !pages[node.pageIndex])
+                    throw new Error('invalid');
+                dict.delete(name('A'));
+                dict.set(name('Dest'), pdf.context.obj([pages[node.pageIndex].ref, 'Fit']));
+            }
+            else if (!original) {
+                throw new Error('invalid');
+            }
+            return { node, dict, ref };
+        });
+        parent.delete(name('First'));
+        parent.delete(name('Last'));
+        if (entries.length) {
+            parent.set(name('First'), entries[0].ref);
+            parent.set(name('Last'), entries[entries.length - 1].ref);
+        }
+        let visible = 0;
+        entries.forEach(({ node, dict, ref }, i) => {
+            dict.delete(name('Prev'));
+            dict.delete(name('Next'));
+            if (i > 0)
+                dict.set(name('Prev'), entries[i - 1].ref);
+            if (i + 1 < entries.length)
+                dict.set(name('Next'), entries[i + 1].ref);
+            const closed = (dict.lookupMaybe(name('Count'), PDFNumber)?.asNumber() ?? 0) < 0;
+            const children = write(node.children, dict, ref);
+            dict.delete(name('Count'));
+            if (children)
+                dict.set(name('Count'), PDFNumber.of(closed ? -children : children));
+            visible += 1 + (closed ? 0 : children);
+        });
+        return visible;
+    }
+    const count = write(nodes, outlines, rootRef);
+    outlines.set(name('Count'), PDFNumber.of(count));
+    if (nodes.length)
+        pdf.catalog.set(name('Outlines'), rootRef);
+    else
+        pdf.catalog.delete(name('Outlines'));
+    const saved = await pdf.save({ updateFieldAppearances: false });
+    const check = await PDFDocument.load(saved, { updateMetadata: false });
+    if (check.getPageCount() !== pages.length)
+        throw new Error('invalid');
+    return saved;
+}
+//# sourceMappingURL=bookmarks-write.js.map

package/lib/bookmarks-write.js.map

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

package/lib/catalog.d.ts

@@ -0,0 +1,28 @@
+import type { ChildProcess } from 'node:child_process';
+export interface CatalogSettings {
+    vault: string;
+    agenteroBin: string;
+}
+export type CatalogResult = {
+    status: 200;
+    raw: string;
+} | {
+    status: 502;
+    error: string;
+};
+/** `agentero import id`. `text` is an arXiv id, DOI, or URL. */
+export declare function importId(settings: CatalogSettings, text: string, children: Set<ChildProcess>): Promise<CatalogResult>;
+/** `agentero import bib -`, with the BibTeX document on stdin. */
+export declare function importBib(settings: CatalogSettings, text: string, children: Set<ChildProcess>): Promise<CatalogResult>;
+/** `agentero export bib`. JSON `data.content` is the BibTeX. */
+export declare function exportBib(settings: CatalogSettings, children: Set<ChildProcess>): Promise<CatalogResult>;
+/** Append or remove one tag. The ref is a vault-relative paper path or id. */
+export declare function changeTag(settings: CatalogSettings, ref: string, op: 'add' | 'rm', tag: string, children: Set<ChildProcess>): Promise<CatalogResult>;
+/** Move a paper directory to the vault recycle bin. Does not pass `--files`. */
+export declare function deletePaper(settings: CatalogSettings, ref: string, children: Set<ChildProcess>): Promise<CatalogResult>;
+/** Set catalog `is_read`. */
+export declare function setRead(settings: CatalogSettings, ref: string, read: boolean, children: Set<ChildProcess>): Promise<CatalogResult>;
+/** Download the PDF for a paper already in the catalog. */
+export declare function downloadPaper(settings: CatalogSettings, ref: string, children: Set<ChildProcess>): Promise<CatalogResult>;
+/** Rank a short arXiv list for one keyword. Already-imported ids are dropped by the CLI. */
+export declare function discoverArxiv(settings: CatalogSettings, keyword: string, children: Set<ChildProcess>): Promise<CatalogResult>;

package/lib/catalog.js

@@ -0,0 +1,58 @@
+import { cliFailure, runAgentero } from './cli-run.js';
+/** Network-backed CLI calls: import, download, BibTeX, arXiv discovery. */
+const NETWORK_MS = 120_000;
+/** Local catalog edits. */
+const LOCAL_MS = 20_000;
+async function cliJson(settings, args, timeoutMs, label, children, stdin) {
+    const result = await runAgentero(settings.agenteroBin, [
+        '--vault', settings.vault,
+        '--json',
+        ...args,
+    ], timeoutMs, children, stdin);
+    if (result.timedOut || result.spawnError !== undefined || result.code !== 0) {
+        return { status: 502, error: cliFailure(result, label) };
+    }
+    try {
+        JSON.parse(result.stdout);
+    }
+    catch {
+        return { status: 502, error: `${label} returned invalid JSON` };
+    }
+    return { status: 200, raw: result.stdout };
+}
+/** `agentero import id`. `text` is an arXiv id, DOI, or URL. */
+export function importId(settings, text, children) {
+    return cliJson(settings, ['import', 'id', '--', text], NETWORK_MS, 'agentero import id', children);
+}
+/** `agentero import bib -`, with the BibTeX document on stdin. */
+export function importBib(settings, text, children) {
+    return cliJson(settings, ['import', 'bib', '-'], NETWORK_MS, 'agentero import bib', children, text);
+}
+/** `agentero export bib`. JSON `data.content` is the BibTeX. */
+export function exportBib(settings, children) {
+    return cliJson(settings, ['export', 'bib'], NETWORK_MS, 'agentero export bib', children);
+}
+/** Append or remove one tag. The ref is a vault-relative paper path or id. */
+export function changeTag(settings, ref, op, tag, children) {
+    return cliJson(settings, ['paper', 'tag', op, ref, '--', tag], LOCAL_MS, 'agentero paper tag', children);
+}
+/** Move a paper directory to the vault recycle bin. Does not pass `--files`. */
+export function deletePaper(settings, ref, children) {
+    return cliJson(settings, ['paper', 'delete', ref], LOCAL_MS, 'agentero paper delete', children);
+}
+/** Set catalog `is_read`. */
+export function setRead(settings, ref, read, children) {
+    const args = ['paper', 'set-read', ref];
+    if (!read)
+        args.push('--false');
+    return cliJson(settings, args, LOCAL_MS, 'agentero paper set-read', children);
+}
+/** Download the PDF for a paper already in the catalog. */
+export function downloadPaper(settings, ref, children) {
+    return cliJson(settings, ['paper', 'download', ref], NETWORK_MS, 'agentero paper download', children);
+}
+/** Rank a short arXiv list for one keyword. Already-imported ids are dropped by the CLI. */
+export function discoverArxiv(settings, keyword, children) {
+    return cliJson(settings, ['discover', 'arxiv', '--keyword', keyword, '--top', '8'], NETWORK_MS, 'agentero discover arxiv', children);
+}
+//# sourceMappingURL=catalog.js.map

package/lib/catalog.js.map

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

package/lib/cli-run.d.ts

@@ -0,0 +1,15 @@
+import { type ChildProcess } from 'node:child_process';
+export interface CliRunResult {
+    code: number | null;
+    stdout: string;
+    stderr: string;
+    timedOut: boolean;
+    spawnError?: string;
+}
+/**
+ * Run `agentero` with an argument array. `shell` stays off.
+ * The child is tracked so unload can kill it.
+ */
+export declare function runAgentero(bin: string, args: readonly string[], timeoutMs: number, children: Set<ChildProcess>, stdin?: string): Promise<CliRunResult>;
+/** Human-readable failure. JSON mode prints `{ ok:false, error:{ message } }` on stdout. */
+export declare function cliFailure(result: CliRunResult, label: string): string;

package/lib/cli-run.js

@@ -0,0 +1,102 @@
+import { spawn } from 'node:child_process';
+/**
+ * Run `agentero` with an argument array. `shell` stays off.
+ * The child is tracked so unload can kill it.
+ */
+export function runAgentero(bin, args, timeoutMs, children, stdin) {
+    return new Promise((resolve) => {
+        let child;
+        try {
+            child = spawn(bin, args, {
+                shell: false,
+                windowsHide: true,
+                stdio: [stdin === undefined ? 'ignore' : 'pipe', 'pipe', 'pipe'],
+            });
+        }
+        catch (error) {
+            resolve({
+                code: null,
+                stdout: '',
+                stderr: '',
+                timedOut: false,
+                spawnError: error instanceof Error ? error.message : String(error),
+            });
+            return;
+        }
+        children.add(child);
+        if (stdin !== undefined)
+            child.stdin?.end(stdin);
+        const stdout = [];
+        const stderr = [];
+        let settled = false;
+        let timedOut = false;
+        let spawnError;
+        let timer;
+        const finish = () => {
+            if (settled)
+                return;
+            settled = true;
+            if (timer !== undefined)
+                clearTimeout(timer);
+            resolve({
+                code: child.exitCode,
+                stdout: Buffer.concat(stdout).toString('utf8'),
+                stderr: Buffer.concat(stderr).toString('utf8'),
+                timedOut,
+                ...(spawnError !== undefined ? { spawnError } : {}),
+            });
+        };
+        timer = setTimeout(() => {
+            timedOut = true;
+            try {
+                child.kill();
+            }
+            catch {
+                // The child already exited.
+            }
+            finish();
+        }, timeoutMs);
+        child.stdout?.on('data', (chunk) => { stdout.push(chunk); });
+        child.stderr?.on('data', (chunk) => { stderr.push(chunk); });
+        child.on('error', (error) => {
+            spawnError = error.message;
+            finish();
+        });
+        child.on('close', () => {
+            children.delete(child);
+            finish();
+        });
+    });
+}
+/** Human-readable failure. JSON mode prints `{ ok:false, error:{ message } }` on stdout. */
+export function cliFailure(result, label) {
+    if (result.timedOut)
+        return `${label} timed out`;
+    if (result.spawnError !== undefined && result.spawnError !== '')
+        return result.spawnError;
+    const stderr = result.stderr.trim();
+    if (stderr !== '')
+        return stderr;
+    const stdout = result.stdout.trim();
+    if (stdout !== '') {
+        try {
+            const parsed = JSON.parse(stdout);
+            if (parsed !== null && typeof parsed === 'object' && 'error' in parsed) {
+                const error = parsed.error;
+                if (typeof error === 'string' && error !== '')
+                    return error;
+                if (error !== null && typeof error === 'object' && 'message' in error && typeof error.message === 'string') {
+                    return error.message;
+                }
+            }
+        }
+        catch {
+            // Fall through to the raw stdout.
+        }
+        return stdout.slice(0, 500);
+    }
+    if (result.code === null)
+        return `${label} failed`;
+    return `agentero exited with code ${result.code}`;
+}
+//# sourceMappingURL=cli-run.js.map

package/lib/cli-run.js.map

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

package/lib/client/index.d.ts

@@ -0,0 +1,71 @@
+import type { Context } from '@deepseek-ai/cordis';
+export interface VaultInfo {
+    path: string;
+    name: string;
+    scope: string;
+    recentVaults: {
+        path: string;
+        name: string;
+    }[];
+    canPick: boolean;
+}
+/** Document a later panel can open. */
+export type AgenteroOpenerKind = 'paper' | 'note';
+/** Open one document id. The host does not register openers in this step. */
+export type AgenteroOpener = (id: string) => void;
+/** Browser service other Agentero panels reach through `ctx.get('agentero')`. */
+export interface AgenteroClient {
+    getVault(): Promise<VaultInfo>;
+    /** Requests remain tied to the source opened by this page, even if another page switches vaults. */
+    request(url: string, init?: RequestInit): Promise<Response>;
+    /**
+     * Replace the opener for one kind.
+     * @param kind - Document kind.
+     * @param opener - Called by {@link AgenteroClient.open}.
+     * @returns Disposer that removes this opener when it is still current.
+     */
+    registerOpener(kind: AgenteroOpenerKind, opener: AgenteroOpener): () => void;
+    /**
+     * Open a document when an opener is registered.
+     * @param kind - Document kind.
+     * @param id - Document id.
+     * @returns False when no opener is registered for `kind`.
+     */
+    open(kind: AgenteroOpenerKind, id: string): boolean;
+}
+/** Owner props for the notes column beside a PDF page. */
+export interface PdfNotesOwner {
+    /** Vault-relative paper directory, for example `papers/1706.03762`. */
+    paperPath: string;
+}
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        'agentero.host': 'vaultChanged' | 'unavailable';
+    }
+    interface SlotMap {
+        /**
+         * Single notes column declared by the PDF panel.
+         * The notes plugin fills it. An empty slot leaves the page full width.
+         */
+        'agentero.pdf.notes': {
+            kind: 'single';
+            scope: 'session';
+            owner: PdfNotesOwner;
+        };
+    }
+}
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        /** Agentero document openers. Panels register later. */
+        agentero: AgenteroClient;
+    }
+}
+/** Browser plugin name. The service key is the same name. */
+export declare const name = "agentero";
+/** Locale, slots, and the shared configuration form serve the panels and Settings. */
+export declare const inject: string[];
+/**
+ * Provide the `agentero` service. Openers stay empty until a later step.
+ * @param ctx - Browser plugin context.
+ */
+export declare function apply(ctx: Context): void;

package/lib/client/settings-model.d.ts

@@ -0,0 +1,28 @@
+/** Staged CLI field over the Host's `agentero-host` entry. */
+import type { SnapshotStore } from '@deepseek-ai/dsh-client-store';
+import { type SettingsFieldState, type SettingsFormActions, type SettingsFormScope, type SettingsFormShell } from '@deepseek-ai/dsh-client-ui-primitives';
+/** Fields this page edits; the knowledge base persists through its own validated route. */
+export interface AgenteroCliSettings {
+    agenteroBin?: string;
+}
+/** Draft and shared form status. */
+export interface AgenteroSettingsState extends SettingsFormShell {
+    agenteroBin: SettingsFieldState;
+}
+/** Registration-side observable and edit/save actions. */
+export interface AgenteroSettingsFace extends SettingsFormActions {
+    hooks: {
+        agenteroSettings: SnapshotStore<AgenteroSettingsState>;
+    };
+}
+/** Stages CLI edits over the `agentero-host` namespace. */
+export declare class AgenteroSettingsModel {
+    private readonly form;
+    private readonly state;
+    /** @param scope - the shared configuration form of the `agentero-host` entry. */
+    constructor(scope: SettingsFormScope<AgenteroCliSettings>);
+    /** Build the face the settings section injects. */
+    inject(): AgenteroSettingsFace;
+    /** Release the entry subscription. */
+    dispose(): void;
+}

package/lib/client/settings.d.ts

@@ -0,0 +1,27 @@
+/** Agentero's section in the dsh Settings dialog. */
+import type { InjectFace, PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import type { AgenteroSettingsFace } from './settings-model';
+/** Vault facts the page reads before offering the native picker. */
+export interface SettingsVault {
+    path: string;
+    canPick: boolean;
+}
+/** Host calls the page uses for the vault; the CLI field persists through the form face. */
+export interface SettingsFace {
+    loadVault(): Promise<SettingsVault>;
+    pickVault(): Promise<string | null>;
+    saveVault(path: string): Promise<void>;
+    reload(): void;
+}
+export type AgenteroFace = SettingsFace & AgenteroSettingsFace;
+export type AgenteroSettingsProps = PropsLocale<'agentero.settings'> & InjectFace<AgenteroFace>;
+export type SettingsLocaleKey = 'nav' | 'vaultTitle' | 'vaultPlaceholder' | 'choose' | 'apply' | 'applying' | 'invalidVault' | 'cliTitle' | 'cliPlaceholder' | 'save' | 'saving' | 'saved' | 'saveFailed' | 'reset' | 'loadFailed' | 'unavailable';
+export declare const en: Record<SettingsLocaleKey, string>;
+export declare const zh: Record<SettingsLocaleKey, string>;
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        'agentero.settings': SettingsLocaleKey;
+    }
+}
+/** Render the knowledge base and CLI fields inside the Settings dialog. */
+export declare function AgenteroSettings(props: AgenteroSettingsProps): import("react").JSX.Element;

package/lib/client/ui/button.d.ts

@@ -0,0 +1,10 @@
+import { type VariantProps } from 'class-variance-authority';
+import type * as React from 'react';
+declare const buttonVariants: (props?: ({
+    variant?: "default" | "outline" | "secondary" | "ghost" | "destructive" | "link" | null | undefined;
+    size?: "default" | "sm" | "icon" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+declare function Button({ className, variant, size, asChild, ...props }: React.ComponentProps<'button'> & VariantProps<typeof buttonVariants> & {
+    asChild?: boolean;
+}): React.JSX.Element;
+export { Button, buttonVariants };

package/lib/client/ui/input.d.ts

@@ -0,0 +1,2 @@
+declare const Input: import("react").ForwardRefExoticComponent<Omit<import("react").DetailedHTMLProps<import("react").InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref"> & import("react").RefAttributes<HTMLInputElement>>;
+export { Input };

package/lib/client/utils.d.ts

@@ -0,0 +1,2 @@
+import { type ClassValue } from 'clsx';
+export declare function cn(...inputs: ClassValue[]): string;