@askdkc/dsh-lsp-server 0.1.0

package/lib/types/runtime/process-lifecycle.d.ts

@@ -0,0 +1,21 @@
+import { type ChildProcess } from 'node:child_process';
+export interface SpawnSpec {
+    command: string;
+    args: string[];
+    cwd: string;
+    env?: Record<string, string>;
+}
+export interface ShutdownOptions {
+    shutdownMs: number;
+    killGraceMs: number;
+}
+export declare function spawnServer(spec: SpawnSpec): ChildProcess;
+export declare function terminateProcess(child: ChildProcess, options: ShutdownOptions): Promise<void>;
+export declare function abortableShutdown(child: ChildProcess, options: ShutdownOptions, signal?: AbortSignal): Promise<void>;
+export declare class StderrTail {
+    private readonly maxBytes;
+    private value;
+    constructor(maxBytes: number);
+    append(chunk: Uint8Array): void;
+    text(): string;
+}

package/lib/types/runtime/server-pool.d.ts

@@ -0,0 +1,24 @@
+export interface PoolSession {
+    readonly state: string;
+    start(signal?: AbortSignal): Promise<unknown>;
+    stop(): Promise<void>;
+    isUsable(): boolean;
+}
+export type SessionFactory<S extends PoolSession> = (serverId: string, workspace: string, signal?: AbortSignal) => Promise<S>;
+export declare class ServerPool<S extends PoolSession> {
+    private readonly factory;
+    private readonly sessions;
+    private readonly creation;
+    private readonly queues;
+    private disposing;
+    constructor(factory: SessionFactory<S>);
+    getOrCreate(serverId: string, workspace: string, signal?: AbortSignal): Promise<S>;
+    run<T>(serverId: string, workspace: string, task: (session: S) => Promise<T>, signal?: AbortSignal): Promise<T>;
+    runWithRetry<T>(serverId: string, workspace: string, task: (session: S) => Promise<T>, signal?: AbortSignal): Promise<T>;
+    evict(serverId: string, workspace: string): Promise<void>;
+    disposeAll(): Promise<void>;
+    get size(): number;
+    private serialize;
+    private create;
+}
+export declare function keyOf(serverId: string, workspace: string): string;

package/lib/types/runtime/server-session.d.ts

@@ -0,0 +1,32 @@
+import type { SubprocessHandle } from '@deepseek-ai/dsh-subprocess';
+import type { InitializeParams, InitializeResult } from '../protocol/types.js';
+import { JsonRpcConnection } from './connection.js';
+export type SessionState = 'NEW' | 'STARTING' | 'READY' | 'STOPPING' | 'STOPPED' | 'FAILED';
+export interface ServerSessionOptions {
+    spawn(): SubprocessHandle;
+    initialize: InitializeParams;
+    configuration: unknown;
+    maxMessageBytes: number;
+    shutdown: {
+        shutdownMs: number;
+        killGraceMs: number;
+    };
+}
+export declare class ServerSession {
+    private readonly options;
+    state: SessionState;
+    capabilities: Record<string, unknown>;
+    private child?;
+    private connection?;
+    private stopping?;
+    private readonly lifetime;
+    constructor(options: ServerSessionOptions);
+    start(signal?: AbortSignal): Promise<InitializeResult>;
+    get usable(): boolean;
+    isUsable(): boolean;
+    run<T>(task: (connection: JsonRpcConnection) => Promise<T>, signal?: AbortSignal): Promise<T>;
+    stop(): Promise<void>;
+    private teardown;
+    private signal;
+    private answer;
+}

package/lib/types/runtime/webstack-runtime.d.ts

@@ -0,0 +1,28 @@
+import type { LspProviderQuery, LspQueryResult } from '@deepseek-ai/dsh-lsp';
+import type { SubprocessService } from '@deepseek-ai/dsh-subprocess';
+import type { ResolvedConfig } from '../config.js';
+import { type HostFileSystem } from '../host/dsh.js';
+import type { CompletionRequest, CompletionResult, DiagnosticsRequest, DiagnosticsResult, WebstackLspStatus } from '../service.js';
+export type HostSubprocess = Pick<SubprocessService, 'spawn' | 'resolveExecutable'>;
+export declare class WebstackLspRuntime {
+    private readonly config;
+    private readonly fs;
+    private readonly subprocess;
+    private readonly pool;
+    private readonly workspaces;
+    private readonly lifetime;
+    private readonly live;
+    private readonly starts;
+    private readonly restarts;
+    constructor(config: ResolvedConfig, fs: HostFileSystem, subprocess: HostSubprocess);
+    navigation(request: LspProviderQuery, signal?: AbortSignal): Promise<LspQueryResult>;
+    completion(request: CompletionRequest, signal?: AbortSignal): Promise<CompletionResult>;
+    diagnostics(request: DiagnosticsRequest, signal?: AbortSignal): Promise<DiagnosticsResult>;
+    status(): Promise<WebstackLspStatus>;
+    dispose(): Promise<void>;
+    private signal;
+    private prepare;
+    private validatePosition;
+    private useTailwind;
+    private document;
+}

package/lib/types/servers/html.d.ts

@@ -0,0 +1,2 @@
+import type { ServerAdapter } from './types.js';
+export declare const htmlAdapter: ServerAdapter;

package/lib/types/servers/launch.d.ts

@@ -0,0 +1,5 @@
+import type { ResolvedConfig, ServerId } from '../config.js';
+import type { LaunchSpec } from './types.js';
+export declare function resolveLaunch(id: ServerId, config: ResolvedConfig, workspace: string): Promise<LaunchSpec>;
+export declare function initializationOptions(id: ServerId, config: ResolvedConfig): unknown;
+export declare function serverConfiguration(id: ServerId, config: ResolvedConfig): unknown;

package/lib/types/servers/package-bin.d.ts

@@ -0,0 +1,2 @@
+import type { LaunchSpec } from './types.js';
+export declare function resolvePackageBinary(packageName: string, binName: string, cwd: string, args?: string[]): Promise<LaunchSpec>;

package/lib/types/servers/phpantom.d.ts

@@ -0,0 +1,2 @@
+import type { ServerAdapter } from './types.js';
+export declare const phpantomAdapter: ServerAdapter;

package/lib/types/servers/svelte.d.ts

@@ -0,0 +1,2 @@
+import type { ServerAdapter } from './types.js';
+export declare const svelteAdapter: ServerAdapter;

package/lib/types/servers/tailwind.d.ts

@@ -0,0 +1,2 @@
+import type { ServerAdapter } from './types.js';
+export declare const tailwindAdapter: ServerAdapter;

package/lib/types/servers/types.d.ts

@@ -0,0 +1,26 @@
+import type { ClassifiedFile } from '../routing/classifier.js';
+import type { ResolvedConfig } from '../config.js';
+export interface LaunchSpec {
+    command: string;
+    args: string[];
+    cwd: string;
+    env?: Record<string, string>;
+}
+export interface ConfigurationItem {
+    section?: string;
+    scopeUri?: string | null;
+}
+export interface ServerInfo {
+    id: string;
+    version?: string;
+}
+export interface ServerAdapter {
+    readonly id: string;
+    readonly role: 'primary' | 'auxiliary' | 'both';
+    resolveLaunch(config: ResolvedConfig, workspace: string): Promise<LaunchSpec>;
+    languageId(file: ClassifiedFile): string | null;
+    supportsFile(file: ClassifiedFile): boolean;
+    configuration(items: ConfigurationItem[]): unknown[];
+    initializationOptions(workspace: string): unknown;
+    normalizeServerInfo(value: unknown): ServerInfo | undefined;
+}

package/lib/types/servers/typescript.d.ts

@@ -0,0 +1,2 @@
+import type { ServerAdapter } from './types.js';
+export declare const typescriptAdapter: ServerAdapter;

package/lib/types/service.d.ts

@@ -0,0 +1,83 @@
+import type { ResolvedConfig } from './config.js';
+export interface LspPosition {
+    line: number;
+    character: number;
+}
+export interface LspRange {
+    start: LspPosition;
+    end: LspPosition;
+}
+export interface DiagnosticsRequest {
+    workspaceRoot: string;
+    filePath: string;
+    severity?: 'all' | 'error' | 'warning';
+    servers?: string[];
+}
+export interface CompletionRequest {
+    workspaceRoot: string;
+    filePath: string;
+    position: LspPosition;
+    triggerKind?: 1 | 2 | 3;
+    triggerCharacter?: string;
+}
+export interface NormalizedDiagnostic {
+    server: string;
+    uri: string;
+    range: LspRange;
+    severity?: 1 | 2 | 3 | 4;
+    code?: string | number;
+    source?: string;
+    message: string;
+    tags?: number[];
+    servers?: string[];
+}
+export interface NormalizedCompletionItem {
+    server: string;
+    label: string;
+    kind?: number;
+    detail?: string;
+    documentation?: string;
+    sortText?: string;
+    filterText?: string;
+    insertText?: string;
+    insertTextFormat?: number;
+    deprecated?: boolean;
+}
+export interface DiagnosticsResult {
+    diagnostics: NormalizedDiagnostic[];
+    omittedServers?: string[];
+    truncated?: {
+        diagnostics: number;
+        characters: number;
+    };
+}
+export interface CompletionResult {
+    items: NormalizedCompletionItem[];
+    truncated?: {
+        items: number;
+        characters: number;
+    };
+}
+export interface WebstackLspStatus {
+    providerId: string;
+    servers: Array<{
+        id: import('./config.js').ServerId;
+        enabled: boolean;
+        available: boolean;
+        source: 'bundled' | 'path';
+        command?: string;
+        version?: string;
+        lastError?: string;
+        liveWorkspaces: number;
+        restarts: number;
+    }>;
+}
+export interface WebstackLspService {
+    status(): Promise<WebstackLspStatus>;
+    diagnostics(request: DiagnosticsRequest, signal?: AbortSignal): Promise<DiagnosticsResult>;
+    completion(request: CompletionRequest, signal?: AbortSignal): Promise<CompletionResult>;
+}
+export interface ExtendedRuntime extends WebstackLspService {
+}
+export declare function createWebstackLspService(runtime: ExtendedRuntime, config?: Pick<ResolvedConfig, 'limits'>): WebstackLspService;
+export declare function createUnavailableService(providerId?: string): WebstackLspService;

package/package.json

@@ -0,0 +1,138 @@
+{
+  "name": "@askdkc/dsh-lsp-server",
+  "version": "0.1.0",
+  "description": "Composite read-only LSP provider for DeepSeek Harness web stacks",
+  "type": "module",
+  "main": "./lib/provider.js",
+  "types": "./lib/types/provider.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/provider.d.ts",
+      "default": "./lib/provider.js"
+    },
+    "./provider": {
+      "types": "./lib/types/provider.d.ts",
+      "default": "./lib/provider.js"
+    },
+    "./extra-tool": {
+      "types": "./lib/types/extra-tool.d.ts",
+      "default": "./lib/extra-tool.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "dsh-lsp-webstack": "./lib/cli/doctor.js"
+  },
+  "files": [
+    "lib/**",
+    "cordis.patch.yml",
+    "README.md",
+    "docs/**",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "scripts": {
+    "build": "tsdown && tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:e2e": "vitest run --config vitest.e2e.config.ts",
+    "check": "npm run typecheck && npm test && npm run build && npm run test:package",
+    "test:package": "vitest run --config vitest.package.config.ts",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run check"
+  },
+  "dependencies": {
+    "@tailwindcss/language-server": "0.16.0",
+    "svelte-language-server": "0.17.15",
+    "typescript": "5.7.3",
+    "typescript-language-server": "4.3.3",
+    "vscode-langservers-extracted": "4.10.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-lsp": "0.0.1-rc.1 || ^0.1.3-alpha.1",
+    "@deepseek-ai/schemastery": "^3.18.2",
+    "@deepseek-ai/dsh-fs": "0.0.1-rc.1 || ^0.1.3-alpha.1",
+    "@deepseek-ai/dsh-subprocess": "0.0.1-rc.1 || ^0.1.3-alpha.1",
+    "@deepseek-ai/dsh-tools": "0.0.1-rc.1 || ^0.1.3-alpha.1",
+    "@deepseek-ai/dsh-system-prompt": "0.0.1-rc.1 || ^0.1.3-alpha.1",
+    "@deepseek-ai/dsh-tool-lsp": "0.0.1-rc.1 || ^0.1.3-alpha.1"
+  },
+  "devDependencies": {
+    "@types/node": "22.10.5",
+    "tsdown": "0.15.0",
+    "typescript": "5.7.3",
+    "vitest": "3.2.6",
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-lsp": "0.0.1-rc.1",
+    "@deepseek-ai/schemastery": "^3.18.2",
+    "@deepseek-ai/dsh-fs": "0.0.1-rc.1",
+    "@deepseek-ai/dsh-subprocess": "0.0.1-rc.1",
+    "@deepseek-ai/dsh-tools": "0.0.1-rc.1",
+    "@deepseek-ai/dsh-system-prompt": "0.0.1-rc.1",
+    "@deepseek-ai/dsh-tool-lsp": "0.0.1-rc.1",
+    "@deepseek-ai/dsh-brand": "0.0.1-rc.1",
+    "@deepseek-ai/dsh-invariants": "0.0.1-rc.1",
+    "@deepseek-ai/dsh-llm": "0.0.1-rc.1",
+    "@deepseek-ai/dsh-timeout": "0.0.1-rc.1",
+    "@deepseek-ai/dsh-scope": "0.0.1-rc.1",
+    "@deepseek-ai/dsh-session": "0.0.1-rc.1",
+    "@deepseek-ai/dsh-fs-local": "0.0.1-rc.1",
+    "@deepseek-ai/dsh-subprocess-local": "0.0.1-rc.1",
+    "tailwindcss-v3": "npm:tailwindcss@3.4.17",
+    "tailwindcss-v4": "npm:tailwindcss@4.1.13"
+  },
+  "engines": {
+    "node": ">=22.18.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "packageManager": "pnpm@9.15.9",
+  "pnpm": {
+    "overrides": {
+      "tsdown>rolldown": "1.0.0-beta.38"
+    }
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/askdkc/dsh-lsp-server.git"
+  },
+  "overrides": {
+    "tsdown": {
+      "rolldown": "1.0.0-beta.38"
+    }
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/cordis": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-lsp": {
+      "optional": true
+    },
+    "@deepseek-ai/schemastery": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-fs": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-subprocess": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tools": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-system-prompt": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tool-lsp": {
+      "optional": true
+    }
+  }
+}