dsh-lsp-actions 0.2.0 → 0.3.1

package/lib/editor/server.js

@@ -0,0 +1,97 @@
+/**
+ * The editor-protocol JSON-RPC server: serves `lsp.actions.list` / `lsp.actions.run` and the
+ * client-controlled `lsp.events` subscription over a newline-delimited JSON-RPC stdio channel.
+ * This is a thin transport consumer of {@link EditorActionService} — all protocol and permission
+ * logic lives there, so any other transport (HTTP, WS, an upstream extension point) can serve the
+ * same surface unchanged.
+ *
+ * Stdout is reserved for protocol frames: enable this only in a dedicated headless composition
+ * whose stdout nothing else claims (the plugin refuses nothing at load — the deployment owns that
+ * contract, exactly like the official SDK JSON-RPC server).
+ * @module dsh-lsp-actions/editor/server
+ */
+import { LruDiagnosticsCache } from "./cache.js";
+import { EditorActionService } from "./service.js";
+import { EditorJsonRpcTransport, EditorProtocolError } from "./transport.js";
+/** The three protocol methods, by wire name. */
+export const EDITOR_METHOD_LIST = 'lsp.actions.list';
+export const EDITOR_METHOD_RUN = 'lsp.actions.run';
+export const EDITOR_METHOD_EVENTS = 'lsp.events';
+/**
+ * Start the editor protocol for one plugin instance: the bounded diagnostics cache, the
+ * transport-agnostic service (listeners attached), and the JSON-RPC stdio server. Every side
+ * effect is owned by the returned {@link EditorProtocolRuntime.dispose}, so the plugin's effect
+ * scope can reverse the whole surface.
+ * @param ctx - the plugin context.
+ * @param runner - the seam-first action runner shared with the model tools.
+ * @param sandbox - the escalation controller shared with the mutation tools.
+ * @param config - the resolved plugin configuration (editor bounds validated by the caller).
+ * @returns the runtime to dispose with the plugin.
+ */
+export function startEditorProtocol(ctx, runner, sandbox, config) {
+    const cache = new LruDiagnosticsCache(config.editor.diagnosticsCacheMaxFiles);
+    const service = new EditorActionService(ctx, runner, sandbox, config, cache);
+    const stopListeners = service.start();
+    // Runtime-only transport hooks (tests): production configs go through the schema, which strips
+    // them, so the server claims process stdio — mirroring the official SDK JSON-RPC plugin.
+    const hooks = config.editor;
+    const server = new EditorJsonRpcServer(service, { input: hooks.input, output: hooks.output });
+    server.start();
+    return {
+        service,
+        server,
+        dispose: async () => {
+            server.close();
+            stopListeners();
+        },
+    };
+}
+/**
+ * Serve the editor protocol over one transport. Construction subscribes to the service's event
+ * stream only while a client has subscribed via the `lsp.events` notification, so idle
+ * connections never accumulate listeners.
+ */
+export class EditorJsonRpcServer {
+    service;
+    transport;
+    eventsDisposer;
+    constructor(service, options = {}) {
+        this.service = service;
+        this.transport = new EditorJsonRpcTransport(options.input ?? process.stdin, options.output ?? process.stdout);
+        this.transport.onRequest(async (method, params) => {
+            switch (method) {
+                case EDITOR_METHOD_LIST:
+                    return this.service.list();
+                case EDITOR_METHOD_RUN:
+                    return await this.service.run(params);
+                default:
+                    throw new EditorProtocolError(-32601, `method not found: ${method}`);
+            }
+        });
+        this.transport.onNotification((method, params) => {
+            if (method !== EDITOR_METHOD_EVENTS)
+                return;
+            const subscribe = typeof params.subscribe === 'boolean' ? params.subscribe : true;
+            if (subscribe) {
+                if (this.eventsDisposer === undefined) {
+                    this.eventsDisposer = this.service.subscribe(event => this.transport.notify('lsp.event', event));
+                }
+            }
+            else {
+                this.eventsDisposer?.();
+                this.eventsDisposer = undefined;
+            }
+        });
+    }
+    /** Attach the transport to its streams. */
+    start() {
+        this.transport.start();
+    }
+    /** Detach the transport and drop the event subscription. */
+    close() {
+        this.eventsDisposer?.();
+        this.eventsDisposer = undefined;
+        this.transport.close();
+    }
+}
+//# sourceMappingURL=server.js.map

package/lib/editor/server.js.map

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

package/lib/editor/service.d.ts

@@ -0,0 +1,67 @@
+/**
+ * The editor-protocol service: the transport-agnostic `lsp.actions.list` / `lsp.actions.run` /
+ * `lsp.events` surface editors consume. It owns the action dispatch, the per-run timeout, the
+ * version check, the bounded diagnostics cache (invalidated by filesystem observations and by the
+ * plugin's own writes), and the event stream; the JSON-RPC transport in `server.ts` is one thin
+ * consumer of it. Everything the service registers (listeners, cache, event subscriptions) is
+ * effect-scoped through the plugin's `ctx.effect`, so stopping the plugin reverses it all.
+ * @module dsh-lsp-actions/editor/service
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { ActionRunner } from '../runner.js';
+import type { FormatSandboxController } from '../sandbox.js';
+import type { ResolvedConfig } from '../servers.js';
+import { LruDiagnosticsCache } from './cache.js';
+import type { EditorEvent, EditorListResult, EditorRunRequest, EditorRunResult } from './types.js';
+/** The listener contract of the event stream. */
+export type EditorEventListener = (event: EditorEvent) => void;
+/**
+ * The editor action surface for one plugin instance. Construction registers nothing; call
+ * {@link EditorActionService.start} (inside the plugin's effect) to attach listeners.
+ */
+export declare class EditorActionService {
+    private readonly ctx;
+    private readonly runner;
+    private readonly sandbox;
+    private readonly config;
+    private readonly cache;
+    private readonly listeners;
+    private started;
+    /** Serial source for request ids of runs that did not supply one (instance-owned, so a plugin reload never shares it). */
+    private serial;
+    constructor(ctx: Context, runner: ActionRunner, sandbox: FormatSandboxController, config: ResolvedConfig, cache: LruDiagnosticsCache);
+    /**
+     * Attach the reversible listeners: filesystem observations invalidate cached diagnostics (and
+     * announce `file.changed`), and session creation/disposal re-announce the session list. Safe to
+     * call once; the returned disposer detaches everything.
+     * @returns the disposal function for this service's listeners.
+     */
+    start(): () => void;
+    /**
+     * The `lsp.actions.list` result: the protocol identity, the v1 action catalog, and the
+     * addressable DSH sessions (live sessions from the optional `sessions` service).
+     * @returns the list payload.
+     */
+    list(): EditorListResult;
+    /**
+     * Run one editor action: version-check, validate, bind the addressed session's live agent (for
+     * the official permission-preset and approval choreography), enforce the configured per-run
+     * timeout, emit `action.status` lifecycle events, and always answer with the structured success
+     * or failure envelope.
+     * @param request - the raw `lsp.actions.run` parameters.
+     * @param signal - optional caller cancellation, raced with the configured timeout.
+     * @returns the unified run envelope.
+     */
+    run(request: EditorRunRequest, signal?: AbortSignal): Promise<EditorRunResult>;
+    /** Subscribe to the event stream. Returns a disposer for the subscription. */
+    subscribe(listener: EditorEventListener): () => void;
+    /** The current live-session snapshot. */
+    private sessionSnapshot;
+    /** The live agent of the addressed session, when one exists. */
+    private liveAgentOf;
+    private sessionsService;
+    private announce;
+    /** A per-service-instance unique request id for runs that did not supply one. */
+    private counter;
+}
+//# sourceMappingURL=service.d.ts.map

package/lib/editor/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/editor/service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAInD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAEhD,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAqB,MAAM,YAAY,CAAA;AAYrH,iDAAiD;AACjD,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAA;AAE9D;;;GAGG;AACH,qBAAa,mBAAmB;IAO5B,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAVxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiC;IAC3D,OAAO,CAAC,OAAO,CAAQ;IACvB,0HAA0H;IAC1H,OAAO,CAAC,MAAM,CAAI;gBAGC,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,uBAAuB,EAChC,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,mBAAmB;IAG7C;;;;;OAKG;IACH,KAAK,IAAI,MAAM,IAAI;IA2BnB;;;;OAIG;IACH,IAAI,IAAI,gBAAgB;IASxB;;;;;;;;OAQG;IACG,GAAG,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;IA6CpF,8EAA8E;IAC9E,SAAS,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,IAAI;IAKpD,yCAAyC;IACzC,OAAO,CAAC,eAAe;IAWvB,gEAAgE;IAChE,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,QAAQ;IAIhB,iFAAiF;IACjF,OAAO,CAAC,OAAO;CAIhB"}

package/lib/editor/service.js

@@ -0,0 +1,182 @@
+/**
+ * The editor-protocol service: the transport-agnostic `lsp.actions.list` / `lsp.actions.run` /
+ * `lsp.events` surface editors consume. It owns the action dispatch, the per-run timeout, the
+ * version check, the bounded diagnostics cache (invalidated by filesystem observations and by the
+ * plugin's own writes), and the event stream; the JSON-RPC transport in `server.ts` is one thin
+ * consumer of it. Everything the service registers (listeners, cache, event subscriptions) is
+ * effect-scoped through the plugin's `ctx.effect`, so stopping the plugin reverses it all.
+ * @module dsh-lsp-actions/editor/service
+ */
+import { LspActionError } from "../vocabulary.js";
+import { EDITOR_ACTIONS, runEditorAction } from "./actions.js";
+import { EDITOR_PROTOCOL } from "./types.js";
+/**
+ * The editor action surface for one plugin instance. Construction registers nothing; call
+ * {@link EditorActionService.start} (inside the plugin's effect) to attach listeners.
+ */
+export class EditorActionService {
+    ctx;
+    runner;
+    sandbox;
+    config;
+    cache;
+    listeners = new Set();
+    started = false;
+    /** Serial source for request ids of runs that did not supply one (instance-owned, so a plugin reload never shares it). */
+    serial = 0;
+    constructor(ctx, runner, sandbox, config, cache) {
+        this.ctx = ctx;
+        this.runner = runner;
+        this.sandbox = sandbox;
+        this.config = config;
+        this.cache = cache;
+    }
+    /**
+     * Attach the reversible listeners: filesystem observations invalidate cached diagnostics (and
+     * announce `file.changed`), and session creation/disposal re-announce the session list. Safe to
+     * call once; the returned disposer detaches everything.
+     * @returns the disposal function for this service's listeners.
+     */
+    start() {
+        if (this.started)
+            throw new Error('lsp-actions editor service already started');
+        this.started = true;
+        const offObserved = this.ctx.on('fs/observed', (...args) => {
+            const target = args[0];
+            const observation = args[1];
+            if (target === undefined || observation?.kind !== 'present')
+                return;
+            const key = target.displayPath ?? target.targetKey;
+            if (key === undefined)
+                return;
+            if (this.cache.delete(key))
+                this.announce({ kind: 'file.changed', filePath: key });
+        });
+        const announceSessions = () => {
+            this.announce({ kind: 'sessions.changed', sessions: this.sessionSnapshot() });
+        };
+        const sessions = this.sessionsService();
+        const offCreated = sessions === undefined ? undefined : this.ctx.on('session/created', () => { announceSessions(); });
+        const offDisposed = sessions === undefined ? undefined : this.ctx.on('session/disposed', () => { announceSessions(); });
+        return () => {
+            offObserved();
+            offCreated?.();
+            offDisposed?.();
+            this.listeners.clear();
+            this.cache.clear();
+            this.started = false;
+        };
+    }
+    /**
+     * The `lsp.actions.list` result: the protocol identity, the v1 action catalog, and the
+     * addressable DSH sessions (live sessions from the optional `sessions` service).
+     * @returns the list payload.
+     */
+    list() {
+        return {
+            protocol: EDITOR_PROTOCOL,
+            version: 1,
+            actions: EDITOR_ACTIONS,
+            sessions: this.sessionSnapshot(),
+        };
+    }
+    /**
+     * Run one editor action: version-check, validate, bind the addressed session's live agent (for
+     * the official permission-preset and approval choreography), enforce the configured per-run
+     * timeout, emit `action.status` lifecycle events, and always answer with the structured success
+     * or failure envelope.
+     * @param request - the raw `lsp.actions.run` parameters.
+     * @param signal - optional caller cancellation, raced with the configured timeout.
+     * @returns the unified run envelope.
+     */
+    async run(request, signal) {
+        const requestId = typeof request?.requestId === 'string' && request.requestId !== '' ? request.requestId : `editor-${this.counter()}`;
+        // Every failure — including protocol-level validation — answers through the same structured
+        // envelope, so clients route on `status`/`error.code` and never parse JSON-RPC error text.
+        const refused = (code, message) => {
+            const error = { code, message };
+            if (typeof request?.action === 'string' && request.action !== '') {
+                this.announce({ kind: 'action.status', requestId, action: request.action, status: 'failed', error });
+            }
+            return { requestId, action: typeof request?.action === 'string' ? request.action : '', status: 'failed', error };
+        };
+        if (request?.protocol !== undefined && request.protocol !== EDITOR_PROTOCOL) {
+            return refused('LSP_PROTOCOL_VERSION_UNSUPPORTED', `unsupported editor protocol "${String(request.protocol)}" — this server speaks ${EDITOR_PROTOCOL}`);
+        }
+        if (typeof request?.action !== 'string' || request.action.trim() === '') {
+            return refused('LSP_ACTION_INVALID_ARGS', 'lsp.actions.run requires a non-empty string action');
+        }
+        const action = request.action;
+        const agent = this.liveAgentOf(request.sessionId);
+        const controller = new AbortController();
+        const timeout = setTimeout(() => { controller.abort(new LspActionError(`the editor action timed out after ${this.config.editor.requestTimeoutMs} ms`, 'LSP_ACTION_UNAVAILABLE')); }, this.config.editor.requestTimeoutMs);
+        const run = {
+            requestId,
+            signal: signal === undefined ? controller.signal : AbortSignal.any([signal, controller.signal]),
+            agent,
+        };
+        this.announce({ kind: 'action.status', requestId, action, status: 'started' });
+        try {
+            const result = await runEditorAction({ ctx: this.ctx, runner: this.runner, sandbox: this.sandbox, config: this.config, cache: this.cache, onEvent: event => this.announce(event) }, action, request.params === null || typeof request.params !== 'object' ? undefined : request.params, run);
+            this.announce({ kind: 'action.status', requestId, action, status: 'succeeded' });
+            return { requestId, action, status: 'succeeded', result };
+        }
+        catch (error) {
+            const info = structuredError(error);
+            this.announce({ kind: 'action.status', requestId, action, status: 'failed', error: info });
+            return { requestId, action, status: 'failed', error: info };
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    /** Subscribe to the event stream. Returns a disposer for the subscription. */
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => { this.listeners.delete(listener); };
+    }
+    /** The current live-session snapshot. */
+    sessionSnapshot() {
+        const sessions = this.sessionsService();
+        if (sessions === undefined)
+            return [];
+        const agents = this.ctx.get('agents');
+        return sessions.list().map(session => ({
+            sessionId: String(session.id),
+            cwd: session.header.cwd ?? '',
+            live: agents?.get(session.id) !== undefined,
+        }));
+    }
+    /** The live agent of the addressed session, when one exists. */
+    liveAgentOf(sessionId) {
+        if (sessionId === undefined)
+            return undefined;
+        const sessions = this.sessionsService();
+        if (sessions === undefined)
+            return undefined;
+        const session = sessions.list().find(candidate => String(candidate.id) === sessionId);
+        if (session === undefined)
+            return undefined;
+        const agents = this.ctx.get('agents');
+        return agents?.get(session.id);
+    }
+    sessionsService() {
+        return this.ctx.get('sessions');
+    }
+    announce(event) {
+        for (const listener of this.listeners)
+            listener(event);
+    }
+    /** A per-service-instance unique request id for runs that did not supply one. */
+    counter() {
+        this.serial += 1;
+        return `editor-${this.serial}`;
+    }
+}
+/** Map one thrown failure to the stable, plain-JSON error shape of a failed envelope. */
+function structuredError(error) {
+    if (error instanceof LspActionError)
+        return { code: error.code, message: error.message };
+    return { code: 'LSP_ACTION_UNAVAILABLE', message: error instanceof Error ? error.message : String(error) };
+}
+//# sourceMappingURL=service.js.map

package/lib/editor/service.js.map

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

package/lib/editor/transport.d.ts

@@ -0,0 +1,53 @@
+/**
+ * The editor protocol's JSON-RPC transport: newline-delimited JSON-RPC 2.0 over byte streams,
+ * wire-compatible with the official DeepSeek Harness SDK/ACP transports (one JSON object per line,
+ * the same request/response/notification frame rules and error codes). A client that can speak the
+ * official SDK wire can speak this wire unchanged — only the method vocabulary differs.
+ * @module dsh-lsp-actions/editor/transport
+ */
+import type { Readable, Writable } from 'node:stream';
+/** A request handler: resolves to the response `result`, rejects into a `-32603` error frame. */
+export type EditorRequestHandler = (method: string, params: Record<string, unknown>) => Promise<unknown>;
+/**
+ * A minimal JSON-RPC 2.0 line endpoint over caller-owned streams. Malformed lines are ignored;
+ * unknown methods answer `-32601`; handler failures answer `-32603`; notifications without a
+ * handler are dropped. {@link start} attaches listeners and {@link close} detaches them.
+ */
+export declare class EditorJsonRpcTransport {
+    private readonly input;
+    private readonly output;
+    private buffer;
+    private readonly decoder;
+    private started;
+    private requestHandler;
+    private notificationHandler;
+    constructor(input: Readable, output: Writable);
+    /** Attach the input listeners and begin reading frames. Idempotent. */
+    start(): void;
+    /** Detach listeners. Safe before {@link start}. */
+    close(): void;
+    /** Install the request handler, replacing any prior handler. */
+    onRequest(handler: EditorRequestHandler): void;
+    /** Install the notification handler, replacing any prior handler. */
+    onNotification(handler: (method: string, params: Record<string, unknown>) => void): void;
+    /** Send one server→client notification. */
+    notify(method: string, params: object): void;
+    /** Wait for the output stream to flush prior writes. */
+    flush(): Promise<void>;
+    private readonly onData;
+    private drainLines;
+    private readonly onInputError;
+    private readonly onInputEnd;
+    private handleLine;
+    private handleRequest;
+    private writeError;
+    private write;
+}
+/** A protocol-level failure that maps to a specific JSON-RPC error code. */
+export declare class EditorProtocolError extends Error {
+    readonly jsonRpcCode: number;
+    constructor(jsonRpcCode: number, message: string);
+}
+/** A fresh, transport-unique request id (used when a peer frame carries none). */
+export declare function freshRequestId(): string;
+//# sourceMappingURL=transport.d.ts.map

package/lib/editor/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/editor/transport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAKrD,iGAAiG;AACjG,MAAM,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AAExG;;;;GAIG;AACH,qBAAa,sBAAsB;IAQ/B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IARzB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IACpD,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,cAAc,CAAkC;IACxD,OAAO,CAAC,mBAAmB,CAAyE;gBAGjF,KAAK,EAAE,QAAQ,EACf,MAAM,EAAE,QAAQ;IAGnC,uEAAuE;IACvE,KAAK,IAAI,IAAI;IAQb,mDAAmD;IACnD,KAAK,IAAI,IAAI;IAMb,gEAAgE;IAChE,SAAS,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI;IAI9C,qEAAqE;IACrE,cAAc,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,IAAI;IAIxF,2CAA2C;IAC3C,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAI5C,wDAAwD;IACxD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAGtB;IAED,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiB;IAE9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAG1B;YAEa,UAAU;YAoBV,aAAa;IAe3B,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,KAAK;CAGd;AAED,4EAA4E;AAC5E,qBAAa,mBAAoB,SAAQ,KAAK;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM;gBAAnB,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI1D;AASD,kFAAkF;AAClF,wBAAgB,cAAc,IAAI,MAAM,CAEvC"}

package/lib/editor/transport.js

@@ -0,0 +1,143 @@
+/**
+ * The editor protocol's JSON-RPC transport: newline-delimited JSON-RPC 2.0 over byte streams,
+ * wire-compatible with the official DeepSeek Harness SDK/ACP transports (one JSON object per line,
+ * the same request/response/notification frame rules and error codes). A client that can speak the
+ * official SDK wire can speak this wire unchanged — only the method vocabulary differs.
+ * @module dsh-lsp-actions/editor/transport
+ */
+import { randomUUID } from 'node:crypto';
+import { StringDecoder } from 'node:string_decoder';
+/**
+ * A minimal JSON-RPC 2.0 line endpoint over caller-owned streams. Malformed lines are ignored;
+ * unknown methods answer `-32601`; handler failures answer `-32603`; notifications without a
+ * handler are dropped. {@link start} attaches listeners and {@link close} detaches them.
+ */
+export class EditorJsonRpcTransport {
+    input;
+    output;
+    buffer = '';
+    decoder = new StringDecoder('utf8');
+    started = false;
+    requestHandler;
+    notificationHandler;
+    constructor(input, output) {
+        this.input = input;
+        this.output = output;
+    }
+    /** Attach the input listeners and begin reading frames. Idempotent. */
+    start() {
+        if (this.started)
+            return;
+        this.started = true;
+        this.input.on('data', this.onData);
+        this.input.on('error', this.onInputError);
+        this.input.on('end', this.onInputEnd);
+    }
+    /** Detach listeners. Safe before {@link start}. */
+    close() {
+        this.input.off('data', this.onData);
+        this.input.off('error', this.onInputError);
+        this.input.off('end', this.onInputEnd);
+    }
+    /** Install the request handler, replacing any prior handler. */
+    onRequest(handler) {
+        this.requestHandler = handler;
+    }
+    /** Install the notification handler, replacing any prior handler. */
+    onNotification(handler) {
+        this.notificationHandler = handler;
+    }
+    /** Send one server→client notification. */
+    notify(method, params) {
+        this.write({ jsonrpc: '2.0', method, params });
+    }
+    /** Wait for the output stream to flush prior writes. */
+    flush() {
+        return new Promise((resolve, reject) => {
+            this.output.write('', error => error === null || error === undefined ? resolve() : reject(error));
+        });
+    }
+    onData = (chunk) => {
+        this.buffer += typeof chunk === 'string' ? chunk : this.decoder.write(chunk);
+        this.drainLines();
+    };
+    drainLines() {
+        for (;;) {
+            const newline = this.buffer.indexOf('\n');
+            if (newline < 0)
+                break;
+            const line = this.buffer.slice(0, newline).trim();
+            this.buffer = this.buffer.slice(newline + 1);
+            if (!line)
+                continue;
+            void this.handleLine(line);
+        }
+    }
+    onInputError = () => { };
+    onInputEnd = () => {
+        this.buffer += this.decoder.end();
+        this.drainLines();
+    };
+    async handleLine(line) {
+        let message;
+        try {
+            message = JSON.parse(line);
+        }
+        catch {
+            return;
+        }
+        if (message === null || typeof message !== 'object' || Array.isArray(message))
+            return;
+        const frame = message;
+        const id = frame.id;
+        const method = frame.method;
+        if ((typeof id === 'string' || typeof id === 'number') && typeof method === 'string') {
+            await this.handleRequest(id, method, normalizeParams(frame.params));
+            return;
+        }
+        if (typeof method === 'string') {
+            this.notificationHandler?.(method, normalizeParams(frame.params));
+        }
+    }
+    async handleRequest(id, method, params) {
+        const handler = this.requestHandler;
+        if (handler === undefined) {
+            this.writeError(id, -32601, `method not found: ${method}`);
+            return;
+        }
+        try {
+            const result = await handler(method, params);
+            this.write({ jsonrpc: '2.0', id, result });
+        }
+        catch (error) {
+            const code = error instanceof EditorProtocolError ? error.jsonRpcCode : -32603;
+            this.writeError(id, code, error instanceof Error ? error.message : String(error));
+        }
+    }
+    writeError(id, code, message) {
+        this.write({ jsonrpc: '2.0', id, error: { code, message } });
+    }
+    write(message) {
+        this.output.write(`${JSON.stringify(message)}\n`);
+    }
+}
+/** A protocol-level failure that maps to a specific JSON-RPC error code. */
+export class EditorProtocolError extends Error {
+    jsonRpcCode;
+    constructor(jsonRpcCode, message) {
+        super(message);
+        this.jsonRpcCode = jsonRpcCode;
+        this.name = 'EditorProtocolError';
+    }
+}
+/** Normalize JSON-RPC params to a plain object (arrays and scalars collapse to `{}`). */
+function normalizeParams(params) {
+    return params !== null && typeof params === 'object' && !Array.isArray(params)
+        ? params
+        : {};
+}
+/** A fresh, transport-unique request id (used when a peer frame carries none). */
+export function freshRequestId() {
+    return randomUUID();
+}
+//# sourceMappingURL=transport.js.map

package/lib/editor/transport.js.map

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