@agent-workshop/adoc-core 0.1.0

package/dist/plugins.js

@@ -0,0 +1,157 @@
+import { access, readFile } from 'node:fs/promises';
+import { createRequire, registerHooks } from 'node:module';
+import { dirname, join, relative, resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import semver from 'semver';
+import { parse } from 'yaml';
+import { errorMessage } from './errors.js';
+const KIT = '@agent-workshop/adoc-plugin-kit';
+// A plugin imports `@agent-workshop/adoc-plugin-kit` of the running adoc wherever its folder is, also outside any node_modules tree
+// that has the kit (for example in the user _Plugin_Directory_).
+registerHooks({
+    resolve(specifier, context, next) {
+        if (specifier === KIT || specifier.startsWith(`${KIT}/`))
+            return next(specifier, { ...context, parentURL: import.meta.url });
+        return next(specifier, context);
+    },
+});
+async function exists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** The _Plugin_Directory_ next to the config file whose folder is `base`. */
+export function pluginDirectory(base) {
+    return join(base, 'plugins');
+}
+/** `github:<owner>/<repo>[/<folder>][#<ref>]`, or undefined for any other source. */
+export function parseGithubSource(source) {
+    const m = /^github:([^/#\s]+)\/([^/#\s]+)((?:\/[^#\s]+)?)(?:#(\S+))?$/.exec(source);
+    if (!m)
+        return undefined;
+    return { owner: m[1], repo: m[2], folder: m[3].replace(/^\/|\/$/g, ''), ...(m[4] ? { ref: m[4] } : {}) };
+}
+/** The folder a GitHub _Plugin_Source_ is fetched to: the plugin key in lowercase, in the _Plugin_Directory_. */
+export function fetchedFolder(plugin) {
+    return join(pluginDirectory(plugin.base), plugin.key.toLowerCase());
+}
+async function entryIn(folder) {
+    for (const candidate of [join(folder, 'index.ts'), join(folder, 'index.js'), join(folder, 'index.mjs')]) {
+        if (await exists(candidate))
+            return candidate;
+    }
+    return undefined;
+}
+/** The plugin folder and its entry file for a _Plugin_Source_. */
+async function locate(plugin) {
+    const { source, base } = plugin;
+    if (source.startsWith('npm:')) {
+        const spec = source.slice(4);
+        const name = spec.startsWith('@') ? `@${spec.slice(1).split('@')[0]}` : spec.split('@')[0];
+        const range = spec.slice(name.length + 1) || undefined;
+        // As Node resolves it from the declaring file's folder upwards, then from the running adoc's installation.
+        for (const from of [join(base, 'adoc.yaml'), import.meta.url]) {
+            let manifest;
+            try {
+                manifest = createRequire(from).resolve(`${name}/package.json`);
+            }
+            catch {
+                continue;
+            }
+            const directory = dirname(manifest);
+            const { version } = JSON.parse(await readFile(manifest, 'utf8'));
+            if (range && version && !semver.satisfies(version, range, { includePrerelease: true })) {
+                throw new Error(`${name} ${version} in ${directory} does not satisfy ${range}`);
+            }
+            return { directory, entry: createRequire(manifest).resolve(name) };
+        }
+        throw new Error(`no npm package ${name} near ${base} or in adoc's installation; install it with npm`);
+    }
+    if (source.startsWith('github:')) {
+        if (!parseGithubSource(source))
+            throw new Error(`${source} is not github:<owner>/<repo>[/<folder>][#<ref>]`);
+        const directory = fetchedFolder(plugin);
+        const entry = await entryIn(directory);
+        if (!entry)
+            throw new Error(`${source} is not fetched into ${directory} yet; run adoc plugin install`);
+        return { directory, entry };
+    }
+    if (source.startsWith('./') || source.startsWith('../') || source.startsWith('/')) {
+        const directory = resolve(base, source);
+        const entry = await entryIn(directory);
+        if (!entry)
+            throw new Error(`no index.ts or index.js in ${directory}`);
+        return { directory, entry };
+    }
+    throw new Error(`${source} is not a plugin source; write npm:<package>, github:<owner>/<repo>/<folder>, or a path starting with ./, ../ or /`);
+}
+/** Fails when the plugin's `peerDependencies` range of the _Plugin_Kit_ excludes the running one. */
+async function checkKit(directory) {
+    let manifest;
+    try {
+        manifest = JSON.parse(await readFile(join(directory, 'package.json'), 'utf8'));
+    }
+    catch {
+        return;
+    }
+    const range = manifest.peerDependencies?.[KIT];
+    if (!range)
+        return;
+    const { version } = JSON.parse(await readFile(createRequire(import.meta.url).resolve(`${KIT}/package.json`), 'utf8'));
+    if (!semver.satisfies(version, range, { includePrerelease: true }))
+        throw new Error(`the plugin needs ${KIT} ${range}, but this adoc has ${version}; update adoc or the plugin`);
+}
+export function scopeOf(home, path) {
+    const rel = relative(home.workspace, path);
+    return rel && !rel.startsWith('..') && !rel.startsWith('/') ? 'project' : 'user';
+}
+/** Reads the `skill/SKILL.md` of an owner folder; throws when it is missing or has no name and description. */
+export async function readSkillSource(owner, scope) {
+    const directory = join(owner, 'skill');
+    let text;
+    try {
+        text = await readFile(join(directory, 'SKILL.md'), 'utf8');
+    }
+    catch {
+        throw new Error(`no skill/SKILL.md in ${owner}; every plugin needs its agent skill there`);
+    }
+    const front = /^---\r?\n([\s\S]*?)\r?\n---/.exec(text);
+    const data = (front ? parse(front[1]) : undefined);
+    if (typeof data?.name !== 'string' || typeof data.description !== 'string')
+        throw new Error(`${join(directory, 'SKILL.md')} needs front matter with name and description`);
+    return { name: data.name, description: data.description, directory, scope };
+}
+let loadCounter = 0;
+async function loadOne(home, plugin, fresh) {
+    const { key, source } = plugin;
+    let directory;
+    try {
+        const located = await locate(plugin);
+        directory = located.directory;
+        const entry = located.entry;
+        await checkKit(directory);
+        const skill = await readSkillSource(directory, scopeOf(home, directory));
+        const url = pathToFileURL(entry);
+        if (fresh)
+            url.searchParams.set('adoc-load', String(++loadCounter));
+        const module = (await import(url.href));
+        if (!module.default)
+            throw new Error(`${entry} has no default export; write export default definePlugin({ … })`);
+        return { key, source, directory, definition: module.default, skill };
+    }
+    catch (error) {
+        return { key, source, ...(directory ? { directory } : {}), error: errorMessage(error) };
+    }
+}
+/** Loads every plugin declared in the _Adoc_Config_. A failure is kept as the plugin's error, never thrown. */
+export async function loadPlugins(home, config, fresh = false) {
+    const loaded = new Map();
+    for (const declared of config.plugins)
+        loaded.set(declared.key, await loadOne(home, declared, fresh));
+    return loaded;
+}
+//# sourceMappingURL=plugins.js.map

package/dist/plugins.js.map

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

package/dist/registry.d.ts

@@ -0,0 +1,11 @@
+/** _Server_Record_: what a running _Adoc_Server_ writes outside the repository. */
+export interface ServerRecord {
+    pid: number;
+    url: string;
+    workspace: string;
+}
+/** The record of the running server of a workspace, or undefined when none runs. */
+export declare function readServerRecord(workspace: string, env?: NodeJS.ProcessEnv): Promise<ServerRecord | undefined>;
+export declare function writeServerRecord(record: ServerRecord, env?: NodeJS.ProcessEnv): Promise<void>;
+/** Removes the record when it still belongs to this process. */
+export declare function removeServerRecord(workspace: string, env?: NodeJS.ProcessEnv): Promise<void>;

package/dist/registry.js

@@ -0,0 +1,39 @@
+import { createHash } from 'node:crypto';
+import { mkdir, readFile, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+function recordPath(workspace, env) {
+    const base = env.XDG_RUNTIME_DIR || tmpdir();
+    return join(base, 'adoc', `${createHash('sha256').update(workspace).digest('hex').slice(0, 16)}.json`);
+}
+function alive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return error.code === 'EPERM';
+    }
+}
+/** The record of the running server of a workspace, or undefined when none runs. */
+export async function readServerRecord(workspace, env = process.env) {
+    try {
+        const record = JSON.parse(await readFile(recordPath(workspace, env), 'utf8'));
+        return record.workspace === workspace && alive(record.pid) ? record : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function writeServerRecord(record, env = process.env) {
+    const path = recordPath(record.workspace, env);
+    await mkdir(join(path, '..'), { recursive: true });
+    await writeFile(path, JSON.stringify(record) + '\n');
+}
+/** Removes the record when it still belongs to this process. */
+export async function removeServerRecord(workspace, env = process.env) {
+    const current = await readServerRecord(workspace, env);
+    if (!current || current.pid === process.pid)
+        await rm(recordPath(workspace, env), { force: true });
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AASjC,SAAS,UAAU,CAAC,SAAiB,EAAE,GAAsB;IAC3D,MAAM,IAAI,GAAG,GAAG,CAAC,eAAe,IAAI,MAAM,EAAE,CAAC;IAC7C,OAAO,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC;AACzG,CAAC;AAED,SAAS,KAAK,CAAC,GAAW;IACxB,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAQ,KAA+B,CAAC,IAAI,KAAK,OAAO,CAAC;IAC3D,CAAC;AACH,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,SAAiB,EAAE,GAAG,GAAsB,OAAO,CAAC,GAAG;IAC5F,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,UAAU,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,CAAiB,CAAC;QAC9F,OAAO,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAClF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAAoB,EAAE,GAAG,GAAsB,OAAO,CAAC,GAAG;IAChG,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAC/C,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;AACvD,CAAC;AAED,gEAAgE;AAChE,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,SAAiB,EAAE,GAAG,GAAsB,OAAO,CAAC,GAAG;IAC9F,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IACvD,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,KAAK,OAAO,CAAC,GAAG;QAAE,MAAM,EAAE,CAAC,UAAU,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACrG,CAAC"}

package/dist/report.d.ts

@@ -0,0 +1,3 @@
+import type { CheckEntry } from './workspace.js';
+/** Renders the report of _Adoc_Check_Command_ as text, one line per entry. */
+export declare function formatCheck(entries: readonly CheckEntry[]): string;

package/dist/report.js

@@ -0,0 +1,9 @@
+/** Renders the report of _Adoc_Check_Command_ as text, one line per entry. */
+export function formatCheck(entries) {
+    if (!entries.length)
+        return 'adoc check: no problems';
+    const errors = entries.filter((e) => e.level === 'error').length;
+    const lines = entries.map((e) => `${e.level.padEnd(7)} ${e.kind.padEnd(18)} ${e.message}`);
+    return `adoc check: ${errors} error(s), ${entries.length - errors} warning(s)\n${lines.join('\n')}`;
+}
+//# sourceMappingURL=report.js.map

package/dist/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,MAAM,UAAU,WAAW,CAAC,OAA8B;IACxD,IAAI,CAAC,OAAO,CAAC,MAAM;QAAE,OAAO,yBAAyB,CAAC;IACtD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,MAAM,CAAC;IACjE,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3F,OAAO,eAAe,MAAM,cAAc,OAAO,CAAC,MAAM,GAAG,MAAM,gBAAgB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACtG,CAAC"}

package/dist/scan.d.ts

@@ -0,0 +1,35 @@
+import type { PluginDocument } from '@agent-workshop/adoc-plugin-kit';
+import type { LoadedPlugin } from './plugins.js';
+/** Where one _Document_ lives. Paths are workspace-relative with forward slashes. */
+export interface DocumentRecord {
+    readonly key: string;
+    readonly pluginKey: string;
+    readonly localId: string;
+    readonly kind: 'file' | 'folder';
+    readonly path: string;
+    readonly file: string;
+    /** Inside a _Document_Archive_: a folder named `_archive` at any depth of a watch path. */
+    readonly archived: boolean;
+    /** The companion files of a file document that exist, such as `docs/SKETCH-login.png`. */
+    readonly companions: readonly string[];
+}
+/** The folder name of a _Document_Archive_. */
+export declare const ARCHIVE_FOLDER = "_archive";
+export interface ScanProblem {
+    readonly kind: 'duplicate-key' | 'unknown-plugin-key' | 'invalid-local-id' | 'layout-mismatch';
+    readonly message: string;
+    readonly path: string;
+    readonly key?: string;
+}
+export interface ScanResult {
+    readonly documents: Map<string, DocumentRecord>;
+    readonly problems: ScanProblem[];
+}
+/** Finds every _Document_ under the _Watch_Path_ entries. A file under overlapping watch paths counts once. */
+export declare function scanDocuments(workspace: string, watch: readonly string[], plugins: Map<string, LoadedPlugin>): Promise<ScanResult>;
+/** Reads a document into the shape plugins receive, together with its _Document_Version_ and its last update (the newest file modification time). */
+export declare function readDocument(workspace: string, record: DocumentRecord): Promise<{
+    doc: PluginDocument;
+    version: string;
+    updatedAt: string;
+}>;

package/dist/scan.js

@@ -0,0 +1,163 @@
+import { readdir, readFile, stat } from 'node:fs/promises';
+import { createHash } from 'node:crypto';
+import { join, relative, resolve, sep } from 'node:path';
+import { KEY_PREFIX_PATTERN, LOCAL_ID_PATTERN } from './names.js';
+/** The folder name of a _Document_Archive_. */
+export const ARCHIVE_FOLDER = '_archive';
+const toPosix = (path) => path.split(sep).join('/');
+async function isDirectory(path) {
+    try {
+        return (await stat(path)).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/** Finds every _Document_ under the _Watch_Path_ entries. A file under overlapping watch paths counts once. */
+export async function scanDocuments(workspace, watch, plugins) {
+    const documents = new Map();
+    const problems = [];
+    const seen = new Set();
+    /** Companion files found, by the path their document would have. */
+    const companions = new Map();
+    const visit = async (directory, archived) => {
+        let entries;
+        try {
+            entries = await readdir(directory, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        entries.sort((a, b) => a.name.localeCompare(b.name));
+        for (const entry of entries) {
+            if (entry.name.startsWith('.') || entry.name === 'node_modules')
+                continue;
+            const absolute = join(directory, entry.name);
+            if (seen.has(absolute))
+                continue;
+            seen.add(absolute);
+            const relPath = toPosix(relative(workspace, absolute));
+            const isDir = entry.isDirectory();
+            const match = KEY_PREFIX_PATTERN.exec(entry.name);
+            if (!match) {
+                if (isDir)
+                    await visit(absolute, archived || entry.name === ARCHIVE_FOLDER);
+                continue;
+            }
+            const pluginKey = match[1];
+            const plugin = plugins.get(pluginKey);
+            if (!plugin) {
+                problems.push({ kind: 'unknown-plugin-key', path: relPath, message: `${relPath} looks like a document key, but no plugin is declared with the key ${pluginKey}.` });
+                continue;
+            }
+            if (!plugin.definition)
+                continue;
+            const layout = plugin.definition.layout;
+            let localId;
+            let file;
+            if (layout.kind === 'file') {
+                const companion = isDir ? undefined : layout.companions?.find((ext) => entry.name.endsWith(ext));
+                if (companion) {
+                    const main = `${relPath.slice(0, -companion.length)}${layout.extension}`;
+                    companions.set(main, [...(companions.get(main) ?? []), relPath]);
+                    continue;
+                }
+                if (isDir || !entry.name.endsWith(layout.extension)) {
+                    problems.push({ kind: 'layout-mismatch', path: relPath, message: `${relPath}: ${pluginKey} documents are files ending with ${layout.extension}.` });
+                    continue;
+                }
+                localId = match[2].slice(0, -layout.extension.length);
+                file = relPath;
+            }
+            else {
+                if (!isDir) {
+                    problems.push({ kind: 'layout-mismatch', path: relPath, message: `${relPath}: ${pluginKey} documents are folders with ${layout.entry} inside.` });
+                    continue;
+                }
+                localId = match[2];
+                file = `${relPath}/${layout.entry}`;
+            }
+            const key = `${pluginKey}-${localId}`;
+            if (!LOCAL_ID_PATTERN.test(localId)) {
+                problems.push({ kind: 'invalid-local-id', path: relPath, key, message: `${relPath}: the local id "${localId}" may use only lowercase letters, digits, hyphens, underscores and dots.` });
+                continue;
+            }
+            const record = { key, pluginKey, localId, kind: layout.kind, path: relPath, file, archived, companions: [] };
+            const existing = documents.get(key);
+            if (existing) {
+                // The not archived document wins, whichever the scan met first.
+                const used = existing.archived && !archived ? record : existing;
+                const other = used === record ? existing : record;
+                documents.set(key, used);
+                problems.push({ kind: 'duplicate-key', path: other.path, key, message: `${key} is carried by both ${used.path} and ${other.path}; ${used.path} is used.` });
+                continue;
+            }
+            documents.set(key, record);
+        }
+    };
+    for (const path of watch)
+        await visit(resolve(workspace, path), false);
+    for (const [main, paths] of companions) {
+        const record = [...documents.values()].find((d) => d.path === main);
+        if (record)
+            documents.set(record.key, { ...record, companions: paths.sort() });
+        else
+            for (const path of paths)
+                problems.push({ kind: 'layout-mismatch', path, message: `${path} is a companion file, but its document ${main} does not exist.` });
+    }
+    return { documents, problems };
+}
+async function listFiles(root, prefix = '') {
+    const out = [];
+    for (const entry of await readdir(join(root, prefix), { withFileTypes: true })) {
+        const rel = prefix ? `${prefix}/${entry.name}` : entry.name;
+        if (entry.isDirectory())
+            out.push(...(await listFiles(root, rel)));
+        else
+            out.push(rel);
+    }
+    return out.sort();
+}
+/** Reads a document into the shape plugins receive, together with its _Document_Version_ and its last update (the newest file modification time). */
+export async function readDocument(workspace, record) {
+    const files = {};
+    const absolute = join(workspace, record.path);
+    let updated = 0;
+    const read = async (path) => {
+        updated = Math.max(updated, (await stat(path)).mtimeMs);
+        return readFile(path, 'utf8');
+    };
+    if (record.kind === 'file') {
+        files[record.path.split('/').pop()] = await read(absolute);
+    }
+    else if (await isDirectory(absolute)) {
+        for (const rel of await listFiles(absolute))
+            files[rel] = await read(join(absolute, rel));
+    }
+    const mainName = record.kind === 'file' ? record.path.split('/').pop() : record.file.slice(record.path.length + 1);
+    const hash = createHash('sha256');
+    for (const name of Object.keys(files).sort())
+        hash.update(name).update('\0').update(files[name]).update('\0');
+    // Companion files count for the version and the last update, but plugins do not receive them: they may be binary.
+    for (const path of record.companions) {
+        try {
+            const absoluteCompanion = join(workspace, path);
+            updated = Math.max(updated, (await stat(absoluteCompanion)).mtimeMs);
+            hash.update(path).update('\0').update(await readFile(absoluteCompanion)).update('\0');
+        }
+        catch {
+            // A companion removed since the scan; the next scan drops it.
+        }
+    }
+    const doc = {
+        key: record.key,
+        pluginKey: record.pluginKey,
+        localId: record.localId,
+        path: record.path,
+        file: record.file,
+        text: files[mainName] ?? '',
+        files,
+    };
+    return { doc, version: hash.digest('hex').slice(0, 16), updatedAt: new Date(updated).toISOString() };
+}
+//# sourceMappingURL=scan.js.map

package/dist/scan.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,80 @@
+import { type IncomingMessage, type ServerResponse } from 'node:http';
+import { MessageQueue, type UserMessage } from './messages.js';
+import { type MessageTransport } from './transports.js';
+import type { Workspace } from './workspace.js';
+export declare const PROTOCOL = "adoc/1";
+/** A _Browser_Session_ as the server tracks it. */
+export interface BrowserSession {
+    id: string;
+    connected: boolean;
+    lastAccess: string;
+    location: string;
+}
+/** Handles a request outside adoc's own routes, such as `/mcp`. Returns true when it handled the request. */
+export type ServerExtension = (request: IncomingMessage, response: ServerResponse) => Promise<boolean>;
+export interface ServerOptions {
+    host?: string;
+    port?: number;
+    extensions?: ServerExtension[];
+    log?: (line: string) => void;
+    debounceMs?: number;
+}
+export declare function publicMessage(message: UserMessage): {
+    formatted: string;
+};
+/**
+ * _Adoc_Server_: serves the _Adoc_Web_UI_, the REST API and live events for one workspace,
+ * watches its files and holds every _User_Message_ until delivery.
+ */
+export declare class AdocServer {
+    readonly workspace: Workspace;
+    private readonly options;
+    readonly queue: MessageQueue;
+    readonly transport: MessageTransport;
+    private readonly listener;
+    private readonly sockets;
+    private watchers;
+    private readonly sessions;
+    private claim;
+    private agentStatus;
+    private unsubscribe;
+    private retryHeld;
+    private readonly terminal;
+    private debounce;
+    private chain;
+    private readonly host;
+    private readonly port;
+    private readonly log;
+    private readonly webappDirectory;
+    constructor(workspace: Workspace, options?: ServerOptions);
+    get url(): string;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /** Serializes workspace work so that rescans and actions never overlap. */
+    private run;
+    private pluginDebounce;
+    private schedulePluginReload;
+    private schedule;
+    /** _Document_Change_Notification_: rescans and tells browsers which documents changed. */
+    rescan(): Promise<void>;
+    private welcome;
+    /** Reads `.adoc/claim.yaml`, follows the claimed pane's agent status, and retries held messages. */
+    private loadClaim;
+    /** The assigned agent as the web UI shows it. */
+    agentInfo(): Record<string, unknown>;
+    private broadcastAgent;
+    /** Every _Browser_Session_, most recent access first. */
+    browserSessions(): BrowserSession[];
+    /** Sends a browser session to a document, an anchor or a plugin; by default the connected session accessed last. */
+    openInBrowser(target: string, sessionId?: string): {
+        session: string;
+        location: string;
+    };
+    private broadcast;
+    private handle;
+    /**
+     * Serves a built file under `/assets/` (the `client/` folder of a plugin under `/assets/plugins/<KEY>/`); every other
+     * path is a client route and gets index.html.
+     */
+    private serveWebapp;
+}