@ahpd/server 0.1.0 → 0.2.0

package/dist/terminals.js

@@ -1,346 +0,0 @@
-import { spawn } from 'node:child_process';
-/**
- * A shell on the host machine, as a terminal channel.
- *
- * Pipes, not a pseudoterminal: a PTY needs a native binding this daemon does
- * not depend on, and the protocol has `isPty: false` for exactly this - "output
- * is plain text and clients do not need to parse VT sequences". So a command
- * runs and its output arrives, and anything that draws itself with cursor
- * movement will not look right. Said in the state rather than discovered.
- *
- * `node:child_process` is used because all three supported runtimes provide it.
- */
-/** What runs, when nothing else was asked for. */
-const shellOf = (asked) => asked ?? process.env.SHELL ?? '/bin/sh';
-/**
- * What a shell says about itself, in the escape sequences it says it with.
- *
- * OSC 133 is the command-boundary convention every shell integration script
- * writes - `A` before the prompt, `B` where the command starts, `C` where its
- * output does, `D;<code>` when it finished - and OSC 7 is the directory. They
- * arrive mixed into the output, so this reads them out and leaves the rest
- * alone: the bytes still go to the client, which is drawing a terminal and
- * needs them.
- *
- * Only under a pseudoterminal, because only then is there a shell running its
- * own prompt to emit them.
- */
-const MARKS = /\u001b\](133|7);([^\u0007\u001b]*)(?:\u0007|\u001b\\)/g;
-export function createTerminal(options, pty) {
-    const { uri, cwd, emit } = options;
-    const shell = shellOf(options.shell);
-    let title = options.name ?? shell.slice(shell.lastIndexOf('/') + 1);
-    let claim = options.claim;
-    let cols = options.cols ?? 80;
-    let rows = options.rows ?? 24;
-    let exitCode;
-    /**
-     * Everything written so far, so a client that subscribes late sees it.
-     *
-     * Capped: a terminal left running `tail -f` for a day is a host holding a
-     * day of output for a client that may never come back.
-     */
-    let buffered = '';
-    const KEEP = 200_000;
-    const said = (data) => {
-        buffered = (buffered + data).slice(-KEEP);
-        emit('terminal', { type: 'terminal/data', data });
-    };
-    /*
-     * `-c` when there is a command, and nothing when there is not.
-     *
-     * A shell given `-c` runs the one thing and exits. Under pipes that is the
-     * only completion signal there is; under a pseudoterminal the shell says so
-     * itself, in OSC 133.
-     */
-    const args = options.command === undefined ? [] : ['-c', options.command];
-    const environment = {
-        ...process.env,
-        // A real terminal under a pty, and an honest `dumb` without one.
-        TERM: pty ? (process.env.TERM ?? 'xterm-256color') : 'dumb',
-        COLUMNS: String(cols),
-        LINES: String(rows),
-    };
-    /** Where the shell says it is, once it has said. */
-    let where = cwd;
-    /** The command being run, from `C` until `D`. */
-    let command;
-    /** What has been typed since the prompt, so the command line can be read back. */
-    let typed = '';
-    /**
-     * Read the shell's own marks out of a chunk, and say what they meant.
-     *
-     * The chunk still reaches the client whole: this is a reader, not a filter,
-     * and a client drawing a terminal needs the bytes it was sent.
-     */
-    const marked = (data) => {
-        for (const found of data.matchAll(MARKS)) {
-            const [, kind, body = ''] = found;
-            if (kind === '7') {
-                // `file://host/path`, per the convention. The host part is dropped:
-                // the path is on this machine, and that is what a client opens.
-                const path = body.replace(/^file:\/\/[^/]*/, '');
-                if (path !== '' && path !== where) {
-                    where = path;
-                    emit('terminal', { type: 'terminal/cwdChanged', cwd: `file://${path}` });
-                }
-                continue;
-            }
-            const mark = body.split(';')[0];
-            if (mark === 'A') {
-                typed = '';
-                continue;
-            }
-            if (mark === 'C') {
-                command = { id: `c${String(Date.now())}`, line: typed.trim(), at: Date.now() };
-                emit('terminal', {
-                    type: 'terminal/commandExecuted',
-                    commandId: command.id,
-                    commandLine: command.line,
-                    timestamp: command.at,
-                });
-                continue;
-            }
-            if (mark !== 'D' || command === undefined)
-                continue;
-            const code = Number(body.split(';')[1]);
-            emit('terminal', {
-                type: 'terminal/commandFinished',
-                commandId: command.id,
-                ...(Number.isFinite(code) ? { exitCode: code } : {}),
-                durationMs: Date.now() - command.at,
-            });
-            command = undefined;
-        }
-    };
-    const terminal = pty?.(shell, args, {
-        ...(cwd !== undefined ? { cwd } : {}),
-        cols,
-        rows,
-        env: environment,
-    });
-    if (terminal !== undefined) {
-        terminal.onData((data) => { marked(data); said(data); });
-        terminal.onExit(({ exitCode: code }) => { exitCode = code; ended(); });
-        // Said once, at the start. A client MUST check this before relying on
-        // command boundaries, and the same fact is on the state.
-        emit('terminal', { type: 'terminal/commandDetectionAvailable' });
-    }
-    const child = terminal !== undefined ? undefined : spawn(shell, args, {
-        cwd,
-        /*
-         * Its own process group, so a signal reaches what it started.
-         *
-         * A shell reading from a pipe runs each command as its own child, and a
-         * signal sent to the shell alone leaves the command running. The group is
-         * what a terminal driver would have signalled, and this has no driver.
-         */
-        detached: true,
-        // A shell reading commands from a pipe. Without a pseudoterminal there is
-        // no point asking it to be interactive: it would print a prompt nobody
-        // can answer the way it expects.
-        stdio: ['pipe', 'pipe', 'pipe'],
-        env: environment,
-    });
-    child?.stdout.on('data', (chunk) => said(chunk.toString('utf8')));
-    child?.stderr.on('data', (chunk) => said(chunk.toString('utf8')));
-    /**
-     * Said once, whichever of the three got here first.
-     *
-     * `error` and `close` can both fire for one failed spawn, and a terminal
-     * that announced its own exit twice would be one every client draws as
-     * having died, come back, and died again.
-     */
-    let announced = false;
-    const ended = () => {
-        if (announced)
-            return;
-        announced = true;
-        emit('terminal', { type: 'terminal/exited', exitCode });
-    };
-    child?.on('error', (error) => {
-        said(`${error.message}\n`);
-        exitCode = 127;
-        ended();
-    });
-    child?.on('exit', (code, signal) => {
-        // A signal is not an exit code, and 128+n is the shell's own convention
-        // for one - better than reporting nothing, which reads as still running.
-        exitCode = code ?? (signal ? 128 : 0);
-    });
-    /*
-     * Announced on `close` rather than on `exit`, which is a race this lost.
-     *
-     * `exit` fires when the process goes; `close` fires once its pipes are
-     * drained. Between the two there is output already written and not yet
-     * read, so a host that reported the exit on `exit` reported a command's
-     * result before the result had arrived - which is exactly what a `!`
-     * command in the composer reads back.
-     */
-    child?.on('close', () => {
-        // A process that closed without an exit event was killed outright.
-        exitCode ??= 0;
-        ended();
-    });
-    return {
-        uri,
-        title: () => title,
-        claim: () => claim,
-        exitCode: () => exitCode,
-        lifecycle: () => (exitCode === undefined
-            ? { status: 'running' }
-            : { status: 'exited', exitCode }),
-        state: () => ({
-            title,
-            cwd: `file://${cwd}`,
-            cols,
-            rows,
-            // One part, because without command detection there are no boundaries
-            // to divide the output at. The protocol's shape, not a flat string.
-            content: buffered === '' ? [] : [{ type: 'unclassified', value: buffered }],
-            claim,
-            // Both true only under a pseudoterminal: without one there is no shell
-            // running its own prompt, so there are no boundaries to report and no
-            // VT sequences for a client to parse.
-            supportsCommandDetection: terminal !== undefined,
-            isPty: terminal !== undefined,
-            /*
-             * Both spellings, because this host speaks five versions.
-             *
-             * `lifecycle` is what 0.9.0 requires and is not optional there - a
-             * client reading `lifecycle.status` on a 0.8.0-shaped terminal gets
-             * `undefined`, which reads as a process that never exits. The flat
-             * `exitCode` is what every version before it reads, and this daemon
-             * negotiates down to 0.5.1.
-             */
-            lifecycle: exitCode === undefined
-                ? { status: 'running' }
-                : { status: 'exited', exitCode },
-            ...(exitCode !== undefined ? { exitCode } : {}),
-        }),
-        write: (data) => {
-            if (exitCode !== undefined)
-                return;
-            /*
-             * `^C` is a signal, and there is nothing here to turn it into one.
-             *
-             * A pseudoterminal has a line discipline that sees the byte and sends
-             * SIGINT to the foreground group. Pipes have none, so the byte arrives
-             * as input and the command runs on - which is a terminal a runaway
-             * command cannot be stopped in. Sending the signal is what the driver
-             * would have done.
-             */
-            /*
-             * Under a pseudoterminal the byte is the signal.
-             *
-             * A pty has a line discipline: `^C` reaches it as input and it sends
-             * SIGINT to the foreground group itself, which is the whole point of
-             * having one. So this writes it through and does nothing clever.
-             */
-            if (terminal !== undefined) {
-                terminal.write(data);
-                // Kept so a command line can be read back at the next `C` mark; the
-                // shell echoes what was typed, but the echo arrives as output and
-                // this is the only place the input itself is seen.
-                typed += data;
-                return;
-            }
-            const at = data.indexOf('\u0003');
-            if (at !== -1) {
-                const rest = data.slice(0, at) + data.slice(at + 1);
-                if (rest !== '' && child?.stdin.writable)
-                    child.stdin.write(rest);
-                /*
-                 * The group, named by the child's own pid, and only when there is one.
-                 *
-                 * A spawn that failed leaves no pid, and `0` is not a safe stand-in:
-                 * to `kill` it means every process in *this* process group, so a
-                 * terminal whose shell never started would signal the host and
-                 * whatever started the host.
-                 */
-                const group = child?.pid;
-                if (group !== undefined) {
-                    try {
-                        process.kill(-group, 'SIGINT');
-                    }
-                    // The group is gone, which is the outcome asked for.
-                    catch { /* nothing left to interrupt */ }
-                }
-                return;
-            }
-            if (child?.stdin.writable)
-                child.stdin.write(data);
-        },
-        // Told, when there is something to tell: a pseudoterminal gets the new
-        // size and sends SIGWINCH itself. Without one these are kept because the
-        // state reports them and a client draws to them.
-        resize: (nextCols, nextRows) => {
-            terminal?.resize(nextCols, nextRows);
-            cols = nextCols;
-            rows = nextRows;
-            emit('terminal', { type: 'terminal/resized', cols, rows });
-        },
-        // The scrollback and nothing else. `cols`, `rows`, `title` and `claim` are
-        // untouched, which is what the reference suite checks for.
-        clear: () => {
-            buffered = '';
-            emit('terminal', { type: 'terminal/cleared' });
-        },
-        setTitle: (next) => {
-            if (next === title)
-                return;
-            title = next;
-            emit('terminal', { type: 'terminal/titleChanged', title });
-        },
-        setClaim: (next) => {
-            claim = next;
-            emit('terminal', { type: 'terminal/claimed', claim });
-        },
-        close: () => {
-            if (terminal !== undefined) {
-                terminal.kill();
-                return;
-            }
-            child?.stdin.end();
-            // The group, not the shell: detached, its children outlive it otherwise.
-            // Only when there is a pid to name it - see the interrupt above.
-            const group = child?.pid;
-            if (group === undefined) {
-                child?.kill();
-                return;
-            }
-            try {
-                process.kill(-group, 'SIGKILL');
-            }
-            catch {
-                child?.kill();
-            }
-        },
-    };
-}
-/**
- * A shell on this machine, as a host's `TerminalStore`.
- *
- * Kept out of `createHost` for the reason above: spawning is the runtime's
- * business, and a host that opens no terminal should not have to have one.
- *
- * ```ts
- * createHost({ path, agents, terminals: shellTerminals() });
- * ```
- *
- * Given a `pty` it runs shells under a pseudoterminal instead, which is what
- * makes shell integration possible: the shell prints its own OSC 133 marks, so
- * command boundaries and the working directory become facts rather than
- * guesses. The binding is handed in because it is native code - `node-pty` is
- * the daemon's dependency and never this library's, and a host on another
- * runtime passes whatever it has.
- *
- * ```ts
- * import { spawn } from 'node-pty';
- * createHost({ path, agents, terminals: shellTerminals({ pty: spawn }) });
- * ```
- */
-export const shellTerminals = (options = {}) => ({
-    create: (asked) => createTerminal(asked, options.pty),
-});
-//# sourceMappingURL=terminals.js.map

package/dist/terminals.js.map

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

package/dist/tools.d.ts

@@ -1,18 +0,0 @@
-import type { HostTool } from './types/host.js';
-/**
- * The tools this package contributes to every session, as a host's `tools`.
- *
- * The protocol's `serverTools` are the *host's* own - not a backend's and not
- * a client's - and what makes one worth contributing is that the host knows
- * something the agent inside a session cannot: the other sessions running
- * beside it, and the terminals the person is watching. Both are read-only.
- *
- * ```ts
- * createHost({ path, agents, tools: hostTools() });
- * ```
- *
- * A host that wants its own passes its own; a host that passes none
- * contributes none, and its sessions report no `serverTools` at all.
- */
-export declare const hostTools: () => HostTool[];
-//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,SAAS,QAAO,QAAQ,EA8CpC,CAAC"}

package/dist/tools.js

@@ -1,65 +0,0 @@
-/**
- * The tools this package contributes to every session, as a host's `tools`.
- *
- * The protocol's `serverTools` are the *host's* own - not a backend's and not
- * a client's - and what makes one worth contributing is that the host knows
- * something the agent inside a session cannot: the other sessions running
- * beside it, and the terminals the person is watching. Both are read-only.
- *
- * ```ts
- * createHost({ path, agents, tools: hostTools() });
- * ```
- *
- * A host that wants its own passes its own; a host that passes none
- * contributes none, and its sessions report no `serverTools` at all.
- */
-export const hostTools = () => [
-    {
-        definition: {
-            name: 'ahp_sessions',
-            title: 'Sessions on this host',
-            description: 'The other agent sessions running on this host, with the directories each works in. '
-                + 'Use it before touching a file to find out whether another agent is already working there.',
-            inputSchema: { type: 'object', properties: {} },
-            annotations: { title: 'Sessions on this host', readOnlyHint: true, openWorldHint: false },
-        },
-        run: (_input, at) => {
-            const others = at.sessions().filter((one) => one.uri !== at.session);
-            if (others.length === 0)
-                return 'No other session is running on this host.';
-            return others
-                .map((one) => `${one.uri}\t${one.provider}\t${one.title}\t${one.workingDirectories.join(' ')}`)
-                .join('\n');
-        },
-    },
-    {
-        definition: {
-            name: 'ahp_resource',
-            title: 'Read a resource this host serves',
-            description: 'Read a resource by URI, including one a connected client publishes and this machine has no copy of '
-                + '- a plugin\u2019s virtual files, an editor\u2019s unsaved buffers. Addressed as <scheme>://<client>/<path>.',
-            inputSchema: { type: 'object', properties: { uri: { type: 'string' } }, required: ['uri'] },
-            annotations: { title: 'Read a resource this host serves', readOnlyHint: true },
-        },
-        run: async (input, at) => await at.read(String(input.uri ?? '')),
-    },
-    {
-        definition: {
-            name: 'ahp_terminals',
-            title: 'Terminals on this host',
-            description: 'The terminals this host has open, with what each is running and where. '
-                + 'These are the terminals the person can see, which is not the same as a shell run from a tool.',
-            inputSchema: { type: 'object', properties: {} },
-            annotations: { title: 'Terminals on this host', readOnlyHint: true, openWorldHint: false },
-        },
-        run: (_input, at) => {
-            const open = at.terminals();
-            if (open.length === 0)
-                return 'This host has no terminal open.';
-            return open
-                .map((one) => `${one.uri}\t${one.title}\t${one.cwd}\t${one.running ? 'running' : 'exited'}`)
-                .join('\n');
-        },
-    },
-];
-//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,GAAe,EAAE,CAAC;IACzC;QACE,UAAU,EAAE;YACV,IAAI,EAAE,cAAc;YACpB,KAAK,EAAE,uBAAuB;YAC9B,WAAW,EAAE,qFAAqF;kBAC9F,2FAA2F;YAC/F,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;YAC/C,WAAW,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;SAC1F;QACD,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE;YAClB,MAAM,MAAM,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,EAAE,CAAC,OAAO,CAAC,CAAC;YACrE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,2CAA2C,CAAC;YAC5E,OAAO,MAAM;iBACV,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,QAAQ,KAAK,GAAG,CAAC,KAAK,KAAK,GAAG,CAAC,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;iBAC9F,IAAI,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC;KACF;IACD;QACE,UAAU,EAAE;YACV,IAAI,EAAE,cAAc;YACpB,KAAK,EAAE,kCAAkC;YACzC,WAAW,EAAE,qGAAqG;kBAC9G,6GAA6G;YACjH,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE;YAC3F,WAAW,EAAE,EAAE,KAAK,EAAE,kCAAkC,EAAE,YAAY,EAAE,IAAI,EAAE;SAC/E;QACD,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;KACjE;IACD;QACE,UAAU,EAAE;YACV,IAAI,EAAE,eAAe;YACrB,KAAK,EAAE,wBAAwB;YAC/B,WAAW,EAAE,yEAAyE;kBAClF,+FAA+F;YACnG,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;YAC/C,WAAW,EAAE,EAAE,KAAK,EAAE,wBAAwB,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;SAC3F;QACD,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE;YAClB,MAAM,IAAI,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;YAC5B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,iCAAiC,CAAC;YAChE,OAAO,IAAI;iBACR,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,KAAK,KAAK,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;iBAC3F,IAAI,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC;KACF;CACF,CAAC"}