@agi-fans/dsh-tui 0.15.0 → 0.17.0

package/lib/runtime/composer-images.js

@@ -0,0 +1,149 @@
+/**
+ * ComposerImages — owns the image-draft list and its `[Image #n]` markers
+ * inside the composer text.
+ *
+ * Draft ownership only: inserting, removing at the cursor, renumbering after
+ * edits, and dropping drafts whose marker disappeared. Paste routing, key
+ * decoding, and the prompt/settings/search branches that decide whether a
+ * paste is an image at all stay in the provider.
+ */
+import { imageMarker, probeImageDimensions } from "../input/image-paste.js";
+export class ComposerImages {
+    #deps;
+    #images = [];
+    #validate;
+    constructor(deps) {
+        this.#deps = deps;
+    }
+    get count() {
+        return this.#images.length;
+    }
+    /** Fresh copies for a submission snapshot. */
+    copies() {
+        return this.#images.map(image => ({ ...image }));
+    }
+    setValidator(validate) {
+        this.#validate = validate;
+    }
+    /**
+     * Run the Harness image-admission check for one paste candidate. A refusal
+     * becomes an error notice and skips the draft, instead of failing the whole
+     * submission after the user has typed a prompt around it.
+     */
+    async admit(image) {
+        if (this.#validate === undefined)
+            return true;
+        try {
+            await this.#validate(image);
+            return true;
+        }
+        catch (error) {
+            this.#deps.notice(error instanceof Error ? error.message : String(error));
+            return false;
+        }
+    }
+    /** Insert an `[Image #n]` marker at the cursor, padded with spaces. */
+    insert(input) {
+        const size = input.width === undefined || input.height === undefined
+            ? probeImageDimensions(input.data, input.mediaType)
+            : undefined;
+        const image = {
+            ...input,
+            ...(input.width === undefined && size !== undefined ? { width: size.width } : {}),
+            ...(input.height === undefined && size !== undefined ? { height: size.height } : {}),
+        };
+        const marker = imageMarker(this.#images.length, image);
+        const editor = this.#deps.editor;
+        const before = editor.cursor > 0 && !/\s/u.test(editor.text[editor.cursor - 1] ?? '') ? ' ' : '';
+        const after = editor.cursor >= editor.text.length || !/\s/u.test(editor.text[editor.cursor] ?? '')
+            ? ' '
+            : '';
+        this.#images.push(image);
+        editor.handle({ type: 'text', value: before + marker + after });
+    }
+    /**
+     * Delete the image whose marker touches the cursor, renumbering the rest.
+     * Returns true when a draft was removed; the caller repaints.
+     */
+    removeAtCursor(key) {
+        const editor = this.#deps.editor;
+        const cursor = editor.cursor;
+        for (let index = 0; index < this.#images.length; index += 1) {
+            const image = this.#images[index];
+            const marker = imageMarker(index, image);
+            const start = editor.text.indexOf(marker);
+            if (start < 0)
+                continue;
+            let from = start;
+            let to = start + marker.length;
+            const touches = key === 'backspace'
+                ? cursor > start && cursor <= to
+                : cursor >= start && cursor < to;
+            if (!touches)
+                continue;
+            if (editor.text[to] === ' ')
+                to += 1;
+            else if (from > 0 && editor.text[from - 1] === ' ')
+                from -= 1;
+            const oldImages = this.#images;
+            let text = editor.text.slice(0, from) + editor.text.slice(to);
+            const nextImages = oldImages.filter((_, oldIndex) => oldIndex !== index);
+            let nextIndex = 0;
+            for (let oldIndex = 0; oldIndex < oldImages.length; oldIndex += 1) {
+                if (oldIndex === index)
+                    continue;
+                const remaining = oldImages[oldIndex];
+                text = text.replaceAll(imageMarker(oldIndex, remaining), imageMarker(nextIndex, remaining));
+                nextIndex += 1;
+            }
+            this.#images = nextImages;
+            editor.setText(text, Math.min(from, text.length));
+            return true;
+        }
+        return false;
+    }
+    /** Drop drafts whose marker left the text, renumbering the survivors. */
+    reconcile() {
+        if (this.#images.length === 0)
+            return;
+        const editor = this.#deps.editor;
+        const oldImages = this.#images;
+        const retained = oldImages.filter((image, index) => editor.text.includes(imageMarker(index, image)));
+        if (retained.length === oldImages.length)
+            return;
+        let text = editor.text;
+        let nextIndex = 0;
+        for (let oldIndex = 0; oldIndex < oldImages.length; oldIndex += 1) {
+            const image = oldImages[oldIndex];
+            const oldMarker = imageMarker(oldIndex, image);
+            if (!text.includes(oldMarker))
+                continue;
+            text = text.replaceAll(oldMarker, imageMarker(nextIndex, image));
+            nextIndex += 1;
+        }
+        this.#images = retained;
+        editor.setText(text, Math.min(editor.cursor, text.length));
+    }
+    /** Prepend a queued submission's drafts, rebasing the current markers. */
+    restore(submission) {
+        const editor = this.#deps.editor;
+        const currentImages = this.#images;
+        let rebasedCurrent = editor.text;
+        for (let index = currentImages.length - 1; index >= 0; index -= 1) {
+            const image = currentImages[index];
+            rebasedCurrent = rebasedCurrent.replaceAll(imageMarker(index, image), imageMarker(index + submission.images.length, image));
+        }
+        const separator = submission.text !== '' && rebasedCurrent !== '' ? '\n' : '';
+        this.#images = [...submission.images.map(image => ({ ...image })), ...currentImages];
+        editor.setText(submission.text + separator + rebasedCurrent);
+    }
+    /** Replace drafts and text with a queued/edited submission. */
+    replace(submission) {
+        this.#images = submission.images.map(image => ({ ...image }));
+        this.#deps.editor.setText(submission.text);
+    }
+    clear() {
+        this.#images = [];
+    }
+}
+//# sourceMappingURL=composer-images.js.map

package/lib/runtime/composer-images.js.map

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

package/lib/runtime/herdr-agent.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Custom Herdr lifecycle integration.
+ *
+ * Herdr (https://herdr.dev) detects a fixed set of agents and lets every other
+ * agent claim a pane's lifecycle authority itself over the local socket
+ * (`pane.report_agent` / `pane.release_agent`). This module implements that
+ * contract: it reports `idle`, `working`, and `blocked` for omdsh and is a
+ * complete no-op outside a Herdr pane.
+ *
+ * The status projection is a pure controller; the reporter adds the stable
+ * source identity, the strictly increasing sequence Herdr requires, the native
+ * session reference, and best-effort socket delivery.
+ * @module runtime/herdr-agent
+ */
+/** Stable, integration-unique source namespace Herdr requires for custom reports. */
+export declare const HERDR_REPORT_SOURCE = "custom:omdsh";
+/** Agent label Herdr shows in its sidebar and agent list. */
+export declare const HERDR_AGENT_LABEL = "omdsh";
+/** The semantic states Herdr accepts from a custom integration; `done` is derived. */
+export type HerdrAgentState = 'idle' | 'working' | 'blocked';
+export interface HerdrAgentStatus {
+    readonly state: HerdrAgentState;
+    readonly message?: string;
+}
+export interface HerdrRequest {
+    readonly id: string;
+    readonly method: 'pane.report_agent' | 'pane.release_agent';
+    readonly params: Readonly<Record<string, unknown>>;
+}
+/** Delivery seam: production writes one JSON line per request to the local socket. */
+export interface HerdrTransport {
+    send(request: HerdrRequest): void;
+}
+export interface HerdrEnvironment {
+    readonly paneId: string;
+    readonly socketPath: string;
+}
+/**
+ * Pane-authoritative Herdr detection.
+ *
+ * `HERDR_ENV=1` is the canonical marker; the pane id and socket path are what
+ * the protocol needs. Client-side overrides (`HERDR_SOCKET_PATH`,
+ * `HERDR_BIN_PATH`, `HERDR_SESSION`) can be set outside a pane, so they are
+ * never detection evidence on their own.
+ */
+export declare function herdrEnvironment(env?: NodeJS.ProcessEnv): HerdrEnvironment | undefined;
+/**
+ * Pure state projection: an active driver plus the human prompts it is blocked
+ * on decide the single semantic state Herdr understands. `blocked` wins over
+ * `working` because a blocked pane must reject `herdr agent prompt` input.
+ */
+export declare class HerdrAgentStatusController {
+    #private;
+    /** The initial report makes Herdr attach the agent to the pane before any turn. */
+    start(): HerdrAgentStatus;
+    setRunning(running: boolean): HerdrAgentStatus | undefined;
+    prompt(message?: string): HerdrAgentStatus | undefined;
+    promptResolved(): HerdrAgentStatus | undefined;
+    /**
+     * Forget the last projection without reporting. A replaced session makes
+     * the previous state meaningless, but only a fresh signal may publish,
+     * because a compaction or resume can swap sessions mid-driver.
+     */
+    reset(): void;
+}
+export interface HerdrAgentReporterOptions {
+    /** Environment to detect Herdr from. Defaults to `process.env`. */
+    readonly env?: NodeJS.ProcessEnv;
+    /** Delivery seam for tests. Defaults to the local socket transport. */
+    readonly transport?: (socketPath: string) => HerdrTransport;
+    /** Clock seam for the monotonic sequence. Defaults to `Date.now`. */
+    readonly now?: () => number;
+}
+/**
+ * Report omdsh lifecycle state to the Herdr pane that owns this process.
+ *
+ * Reports are best-effort and silent, matching Herdr's own integrations: a
+ * missing or restarted server must never disturb the TUI.
+ */
+export declare class HerdrAgentReporter {
+    #private;
+    constructor(options?: HerdrAgentReporterOptions);
+    /** Whether this process runs inside a Herdr pane with a usable socket. */
+    get active(): boolean;
+    start(): void;
+    setRunning(running: boolean): void;
+    prompt(message?: string): void;
+    promptResolved(): void;
+    /** Attach the native session reference Herdr exposes on its agent records. */
+    setSession(sessionId: string | undefined): void;
+    /** Release the pane's lifecycle authority; later reports are dropped. */
+    release(): void;
+}
+/** Herdr exports Unix-style paths; Windows dials them as named pipes. */
+export declare function herdrSocketTarget(socketPath: string, platform?: NodeJS.Platform): string;

package/lib/runtime/herdr-agent.js

@@ -0,0 +1,258 @@
+/**
+ * Custom Herdr lifecycle integration.
+ *
+ * Herdr (https://herdr.dev) detects a fixed set of agents and lets every other
+ * agent claim a pane's lifecycle authority itself over the local socket
+ * (`pane.report_agent` / `pane.release_agent`). This module implements that
+ * contract: it reports `idle`, `working`, and `blocked` for omdsh and is a
+ * complete no-op outside a Herdr pane.
+ *
+ * The status projection is a pure controller; the reporter adds the stable
+ * source identity, the strictly increasing sequence Herdr requires, the native
+ * session reference, and best-effort socket delivery.
+ * @module runtime/herdr-agent
+ */
+import { connect } from 'node:net';
+/** Stable, integration-unique source namespace Herdr requires for custom reports. */
+export const HERDR_REPORT_SOURCE = 'custom:omdsh';
+/** Agent label Herdr shows in its sidebar and agent list. */
+export const HERDR_AGENT_LABEL = 'omdsh';
+/**
+ * Pane-authoritative Herdr detection.
+ *
+ * `HERDR_ENV=1` is the canonical marker; the pane id and socket path are what
+ * the protocol needs. Client-side overrides (`HERDR_SOCKET_PATH`,
+ * `HERDR_BIN_PATH`, `HERDR_SESSION`) can be set outside a pane, so they are
+ * never detection evidence on their own.
+ */
+export function herdrEnvironment(env = process.env) {
+    if (env.HERDR_ENV !== '1')
+        return undefined;
+    const paneId = env.HERDR_PANE_ID?.trim();
+    const socketPath = env.HERDR_SOCKET_PATH?.trim();
+    if (paneId === undefined || paneId === '' || socketPath === undefined || socketPath === '')
+        return undefined;
+    return { paneId, socketPath };
+}
+const HERDR_MESSAGE_LIMIT = 240;
+function cleanHerdrMessage(value) {
+    if (value === undefined)
+        return undefined;
+    const cleaned = value
+        .replace(/[\x00-\x1f\x7f-\x9f]/gu, ' ')
+        .replace(/\s+/gu, ' ')
+        .trim()
+        .slice(0, HERDR_MESSAGE_LIMIT);
+    return cleaned === '' ? undefined : cleaned;
+}
+/**
+ * Pure state projection: an active driver plus the human prompts it is blocked
+ * on decide the single semantic state Herdr understands. `blocked` wins over
+ * `working` because a blocked pane must reject `herdr agent prompt` input.
+ */
+export class HerdrAgentStatusController {
+    #running = false;
+    #prompts = 0;
+    #promptMessage;
+    #last;
+    /** The initial report makes Herdr attach the agent to the pane before any turn. */
+    start() {
+        return this.#publish(true);
+    }
+    setRunning(running) {
+        this.#running = running;
+        return this.#publish();
+    }
+    prompt(message) {
+        this.#prompts += 1;
+        const cleaned = cleanHerdrMessage(message);
+        if (cleaned !== undefined)
+            this.#promptMessage = cleaned;
+        return this.#publish();
+    }
+    promptResolved() {
+        if (this.#prompts === 0)
+            return undefined;
+        this.#prompts -= 1;
+        if (this.#prompts === 0)
+            this.#promptMessage = undefined;
+        return this.#publish();
+    }
+    /**
+     * Forget the last projection without reporting. A replaced session makes
+     * the previous state meaningless, but only a fresh signal may publish,
+     * because a compaction or resume can swap sessions mid-driver.
+     */
+    reset() {
+        this.#running = false;
+        this.#prompts = 0;
+        this.#promptMessage = undefined;
+        this.#last = undefined;
+    }
+    #desired() {
+        if (this.#prompts > 0) {
+            return this.#promptMessage === undefined
+                ? { state: 'blocked' }
+                : { state: 'blocked', message: this.#promptMessage };
+        }
+        return this.#running ? { state: 'working' } : { state: 'idle' };
+    }
+    #publish(force = false) {
+        const next = this.#desired();
+        const signature = `${next.state}\u0000${next.message ?? ''}`;
+        if (!force && signature === this.#last)
+            return undefined;
+        this.#last = signature;
+        return next;
+    }
+}
+/**
+ * Report omdsh lifecycle state to the Herdr pane that owns this process.
+ *
+ * Reports are best-effort and silent, matching Herdr's own integrations: a
+ * missing or restarted server must never disturb the TUI.
+ */
+export class HerdrAgentReporter {
+    #environment;
+    #transport;
+    #controller = new HerdrAgentStatusController();
+    #now;
+    #seq;
+    #sessionId;
+    #released = false;
+    constructor(options = {}) {
+        this.#now = options.now ?? (() => Date.now());
+        this.#seq = this.#now() * 1000;
+        this.#environment = herdrEnvironment(options.env ?? process.env);
+        this.#transport = this.#environment === undefined
+            ? undefined
+            : (options.transport ?? defaultHerdrTransport)(this.#environment.socketPath);
+    }
+    /** Whether this process runs inside a Herdr pane with a usable socket. */
+    get active() {
+        return this.#transport !== undefined;
+    }
+    start() {
+        this.#report(this.#controller.start());
+    }
+    setRunning(running) {
+        this.#report(this.#controller.setRunning(running));
+    }
+    prompt(message) {
+        this.#report(this.#controller.prompt(message));
+    }
+    promptResolved() {
+        this.#report(this.#controller.promptResolved());
+    }
+    /** Attach the native session reference Herdr exposes on its agent records. */
+    setSession(sessionId) {
+        const trimmed = sessionId?.trim();
+        const next = trimmed === undefined || trimmed === '' ? undefined : trimmed;
+        if (next === this.#sessionId)
+            return;
+        this.#sessionId = next;
+        this.#controller.reset();
+    }
+    /** Release the pane's lifecycle authority; later reports are dropped. */
+    release() {
+        const environment = this.#environment;
+        const transport = this.#transport;
+        if (this.#released || environment === undefined || transport === undefined)
+            return;
+        this.#released = true;
+        this.#deliver(transport, {
+            id: `${HERDR_REPORT_SOURCE}:release:${this.#now()}`,
+            method: 'pane.release_agent',
+            params: {
+                pane_id: environment.paneId,
+                source: HERDR_REPORT_SOURCE,
+                agent: HERDR_AGENT_LABEL,
+                seq: this.#nextSeq(),
+            },
+        });
+    }
+    #report(status) {
+        const environment = this.#environment;
+        const transport = this.#transport;
+        if (status === undefined || this.#released || environment === undefined || transport === undefined)
+            return;
+        const params = {
+            pane_id: environment.paneId,
+            source: HERDR_REPORT_SOURCE,
+            agent: HERDR_AGENT_LABEL,
+            state: status.state,
+            seq: this.#nextSeq(),
+        };
+        if (status.message !== undefined)
+            params.message = status.message;
+        if (this.#sessionId !== undefined)
+            params.agent_session_id = this.#sessionId;
+        this.#deliver(transport, {
+            id: `${HERDR_REPORT_SOURCE}:${status.state}:${this.#now()}`,
+            method: 'pane.report_agent',
+            params,
+        });
+    }
+    /** A broken transport must never throw into the TUI's status or dispose path. */
+    #deliver(transport, request) {
+        try {
+            transport.send(request);
+        }
+        catch {
+            // Best-effort delivery, matching Herdr's own integrations.
+        }
+    }
+    /**
+     * Strictly increasing across reporter instances in one process: Herdr
+     * ignores a report whose sequence is not above the last accepted one for the
+     * same source, so a plugin reload must not restart below a used sequence.
+     */
+    #nextSeq() {
+        this.#seq = Math.max(this.#seq + 1, this.#now() * 1000);
+        return this.#seq;
+    }
+}
+const HERDR_REQUEST_TIMEOUT_MS = 500;
+/**
+ * One JSON line per request over a short-lived local connection. The server
+ * acknowledges every request, but delivery stays fire-and-forget: the pane
+ * must never wait on Herdr, and `unref()` keeps a pending write from holding
+ * the process open.
+ */
+function defaultHerdrTransport(socketPath) {
+    const target = herdrSocketTarget(socketPath);
+    return {
+        send(request) {
+            let socket;
+            try {
+                socket = connect(target);
+            }
+            catch {
+                return;
+            }
+            socket.unref();
+            let timer;
+            const finish = () => {
+                if (timer !== undefined)
+                    clearTimeout(timer);
+                socket.destroy();
+            };
+            timer = setTimeout(finish, HERDR_REQUEST_TIMEOUT_MS);
+            timer.unref();
+            socket.on('error', finish);
+            socket.on('connect', () => { socket.write(`${JSON.stringify(request)}\n`); });
+            socket.on('data', finish);
+            socket.on('end', finish);
+            socket.on('close', finish);
+        },
+    };
+}
+/** Herdr exports Unix-style paths; Windows dials them as named pipes. */
+export function herdrSocketTarget(socketPath, platform = process.platform) {
+    const lowered = socketPath.toLowerCase();
+    if (platform !== 'win32' || lowered.startsWith('\\\\.\\pipe\\') || lowered.startsWith('\\\\?\\pipe\\')) {
+        return socketPath;
+    }
+    return `\\\\.\\pipe\\${socketPath}`;
+}
+//# sourceMappingURL=herdr-agent.js.map

package/lib/runtime/herdr-agent.js.map

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

package/lib/runtime/plain-tui.d.ts

@@ -0,0 +1,34 @@
+/** Non-TTY line input and incremental transcript printing. */
+import type { TuiPrompt, TuiSubmission } from '../definition.ts';
+import type { Block } from '../views/event-views.ts';
+import type { TerminalLike } from './provider-local.ts';
+export type PendingRead = {
+    resolve: (submission: TuiSubmission | null) => void;
+    signal?: AbortSignal | null;
+    /** Detaches this read's abort listener once the read settles. */
+    offAbort?: () => void;
+};
+export interface PlainTuiDeps {
+    readonly term: TerminalLike;
+    /** Transcript blocks, read live so `print()` always flushes the newest tail. */
+    blocks(): readonly Block[];
+    /** The in-flight human prompt's request, if one is waiting on an answer. */
+    promptRequest(): TuiPrompt | undefined;
+    /** Resolve the in-flight prompt; the provider owns prompt bookkeeping. */
+    finishPrompt(answer: string | null): void;
+}
+/**
+ * Pipe-mode counterpart of the TTY reader: a readline queue that buffers lines
+ * until the runner asks for the next submission, plus incremental transcript
+ * printing that emits each settled block exactly once.
+ */
+export declare class PlainTui {
+    #private;
+    constructor(deps: PlainTuiDeps);
+    readline(signal?: AbortSignal): Promise<TuiSubmission | null>;
+    /** Print blocks that settled since the last flush. */
+    print(): void;
+    /** Forget the print cursor so a replaced transcript reprints in full. */
+    resetPrinted(): void;
+    dispose(): void;
+}