@lemoncat7/dsh-ssh 0.1.0-alpha.15

package/lib/sidebar-anchor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar-anchor.d.ts","sourceRoot":"","sources":["../src/sidebar-anchor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAEjD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,SAAS,CAAC,WAAW,CAAC,GAAG,IAAI,CAuCvE"}

package/lib/sidebar-anchor.js

@@ -0,0 +1,50 @@
+import { useEffect } from 'react';
+/**
+ * Place the plugin's official footer-slot contribution above Workspace without
+ * replacing the single `sidebar.workspaces` slot. If the current sidebar shell
+ * cannot be identified, the entry remains in the supported footer slot.
+ */
+export function useWorkspaceTopAnchor(ref) {
+    useEffect(() => {
+        const element = ref.current;
+        const originalParent = element?.parentElement;
+        if (element === null || element === undefined || originalParent === null || originalParent === undefined)
+            return;
+        const parent = originalParent;
+        let moved = false;
+        let observer;
+        const place = () => {
+            // List-slot entries may be wrapped by the slot renderer. Walk out from
+            // the entry until the preceding sibling is the flexible Workspace
+            // region, instead of assuming the entry is a direct footer child.
+            let ancestor = element.parentElement;
+            while (ancestor !== null && ancestor !== document.body) {
+                const candidate = ancestor.previousElementSibling;
+                if (candidate instanceof HTMLElement) {
+                    const style = getComputedStyle(candidate);
+                    const flexGrow = Number.parseFloat(style.flexGrow);
+                    if (style.display === 'flex' && style.flexDirection === 'column' && flexGrow > 0) {
+                        candidate.insertBefore(element, candidate.firstChild);
+                        element.dataset.dshSshAnchored = 'true';
+                        moved = true;
+                        return true;
+                    }
+                }
+                ancestor = ancestor.parentElement;
+            }
+            return false;
+        };
+        if (!place()) {
+            observer = new MutationObserver(() => { if (place())
+                observer?.disconnect(); });
+            observer.observe(document.body, { childList: true, subtree: true });
+        }
+        return () => {
+            observer?.disconnect();
+            delete element.dataset.dshSshAnchored;
+            if (moved && parent.isConnected)
+                parent.append(element);
+        };
+    }, [ref]);
+}
+//# sourceMappingURL=sidebar-anchor.js.map

package/lib/sidebar-anchor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar-anchor.js","sourceRoot":"","sources":["../src/sidebar-anchor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAkB,MAAM,OAAO,CAAA;AAEjD;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAA2B;IAC/D,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAA;QAC3B,MAAM,cAAc,GAAG,OAAO,EAAE,aAAa,CAAA;QAC7C,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,IAAI,cAAc,KAAK,IAAI,IAAI,cAAc,KAAK,SAAS;YAAE,OAAM;QAChH,MAAM,MAAM,GAAG,cAAc,CAAA;QAC7B,IAAI,KAAK,GAAG,KAAK,CAAA;QACjB,IAAI,QAAsC,CAAA;QAC1C,MAAM,KAAK,GAAG,GAAY,EAAE;YAC1B,uEAAuE;YACvE,kEAAkE;YAClE,kEAAkE;YAClE,IAAI,QAAQ,GAAuB,OAAO,CAAC,aAAa,CAAA;YACxD,OAAO,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACvD,MAAM,SAAS,GAAG,QAAQ,CAAC,sBAAsB,CAAA;gBACjD,IAAI,SAAS,YAAY,WAAW,EAAE,CAAC;oBACrC,MAAM,KAAK,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAA;oBACzC,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;oBAClD,IAAI,KAAK,CAAC,OAAO,KAAK,MAAM,IAAI,KAAK,CAAC,aAAa,KAAK,QAAQ,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;wBACjF,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,SAAS,CAAC,UAAU,CAAC,CAAA;wBACrD,OAAO,CAAC,OAAO,CAAC,cAAc,GAAG,MAAM,CAAA;wBACvC,KAAK,GAAG,IAAI,CAAA;wBACZ,OAAO,IAAI,CAAA;oBACb,CAAC;gBACH,CAAC;gBACD,QAAQ,GAAG,QAAQ,CAAC,aAAa,CAAA;YACnC,CAAC;YACD,OAAO,KAAK,CAAA;QACd,CAAC,CAAA;QACD,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;YACb,QAAQ,GAAG,IAAI,gBAAgB,CAAC,GAAG,EAAE,GAAG,IAAI,KAAK,EAAE;gBAAE,QAAQ,EAAE,UAAU,EAAE,CAAA,CAAC,CAAC,CAAC,CAAA;YAC9E,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;QACrE,CAAC;QACD,OAAO,GAAG,EAAE;YACV,QAAQ,EAAE,UAAU,EAAE,CAAA;YACtB,OAAO,OAAO,CAAC,OAAO,CAAC,cAAc,CAAA;YACrC,IAAI,KAAK,IAAI,MAAM,CAAC,WAAW;gBAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QACzD,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;AACX,CAAC"}

package/lib/store.d.ts

@@ -0,0 +1,20 @@
+import type { CredentialEntry, ForwardRule, SessionInjection, SshProfile, SshSettings, SshState } from './domain.js';
+export declare class SshStore {
+    private readonly path;
+    private state;
+    private queue;
+    private constructor();
+    static open(path: string, defaults: SshSettings): Promise<SshStore>;
+    snapshot(): SshState;
+    profiles(): SshProfile[];
+    profile(id: string): SshProfile | undefined;
+    credentialEntries(): CredentialEntry[];
+    credentialEntry(id: string): CredentialEntry | undefined;
+    forwards(): ForwardRule[];
+    forward(id: string): ForwardRule | undefined;
+    injection(sessionId: string): SessionInjection | undefined;
+    settings(): SshSettings;
+    update(mutator: (draft: SshState) => void): Promise<SshState>;
+    private persist;
+}
+//# sourceMappingURL=store.d.ts.map

package/lib/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAEpH,qBAAa,QAAQ;IAIC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHzC,OAAO,CAAC,KAAK,CAAU;IACvB,OAAO,CAAC,KAAK,CAAsC;IAEnD,OAAO;WAIM,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAczE,QAAQ,IAAI,QAAQ;IACpB,QAAQ,IAAI,UAAU,EAAE;IACxB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAC3C,iBAAiB,IAAI,eAAe,EAAE;IACtC,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IACxD,QAAQ,IAAI,WAAW,EAAE;IACzB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAC5C,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAC1D,QAAQ,IAAI,WAAW;IAEvB,MAAM,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC;YAa/C,OAAO;CAwBtB"}

package/lib/store.js

@@ -0,0 +1,154 @@
+import { randomBytes } from 'node:crypto';
+import { mkdir, open, readFile, rename, rm } from 'node:fs/promises';
+import { dirname } from 'node:path';
+export class SshStore {
+    path;
+    state;
+    queue = Promise.resolve();
+    constructor(path, initial) {
+        this.path = path;
+        this.state = initial;
+    }
+    static async open(path, defaults) {
+        await mkdir(dirname(path), { recursive: true });
+        let initial = { schemaVersion: 1, profiles: [], credentialEntries: [], forwardRules: [], injections: [], settings: defaults };
+        try {
+            const parsed = JSON.parse(await readFile(path, 'utf8'));
+            initial = parseState(parsed, defaults);
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT')
+                throw error;
+        }
+        const store = new SshStore(path, initial);
+        if (!(await fileExists(path)))
+            await store.persist(initial);
+        return store;
+    }
+    snapshot() { return structuredClone(this.state); }
+    profiles() { return structuredClone(this.state.profiles); }
+    profile(id) { return structuredClone(this.state.profiles.find(profile => profile.id === id)); }
+    credentialEntries() { return structuredClone(this.state.credentialEntries); }
+    credentialEntry(id) { return structuredClone(this.state.credentialEntries.find(entry => entry.id === id)); }
+    forwards() { return structuredClone(this.state.forwardRules); }
+    forward(id) { return structuredClone(this.state.forwardRules.find(rule => rule.id === id)); }
+    injection(sessionId) { return structuredClone(this.state.injections.find(item => item.sessionId === sessionId)); }
+    settings() { return structuredClone(this.state.settings); }
+    update(mutator) {
+        const operation = this.queue.then(async () => {
+            const draft = structuredClone(this.state);
+            mutator(draft);
+            validateReferences(draft);
+            await this.persist(draft);
+            this.state = draft;
+            return this.snapshot();
+        });
+        this.queue = operation.catch(() => { });
+        return operation;
+    }
+    async persist(state) {
+        const directory = dirname(this.path);
+        const temporary = `${this.path}.${process.pid}.${randomBytes(5).toString('hex')}.tmp`;
+        const handle = await open(temporary, 'w', 0o600);
+        try {
+            await handle.writeFile(`${JSON.stringify(state, null, 2)}\n`, 'utf8');
+            await handle.sync();
+        }
+        finally {
+            await handle.close();
+        }
+        try {
+            await rename(temporary, this.path);
+        }
+        catch (error) {
+            if (process.platform !== 'win32')
+                throw error;
+            await rm(this.path, { force: true });
+            await rename(temporary, this.path);
+        }
+        finally {
+            await rm(temporary, { force: true }).catch(() => { });
+        }
+        if (process.platform !== 'win32') {
+            const directoryHandle = await open(directory, 'r');
+            try {
+                await directoryHandle.sync();
+            }
+            finally {
+                await directoryHandle.close();
+            }
+        }
+    }
+}
+function parseState(value, defaults) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        throw new Error('dsh-ssh state must be an object');
+    const state = value;
+    if (state.schemaVersion !== 1)
+        throw new Error(`unsupported dsh-ssh state version ${String(state.schemaVersion)}`);
+    return {
+        schemaVersion: 1,
+        profiles: Array.isArray(state.profiles) ? state.profiles.map(normalizeStoredProfile) : [],
+        credentialEntries: Array.isArray(state.credentialEntries) ? state.credentialEntries : [],
+        forwardRules: Array.isArray(state.forwardRules) ? state.forwardRules : [],
+        injections: Array.isArray(state.injections) ? state.injections.map(injection => ({
+            ...injection,
+            workingDirectories: normalizeWorkingDirectories(injection),
+        })) : [],
+        settings: typeof state.settings === 'object' && state.settings !== null ? { ...defaults, ...state.settings } : defaults,
+    };
+}
+function validateReferences(state) {
+    const ids = new Set(state.profiles.map(profile => profile.id));
+    const credentialIds = new Set(state.credentialEntries.map(entry => entry.id));
+    if (ids.size !== state.profiles.length)
+        throw new Error('duplicate SSH profile id');
+    if (credentialIds.size !== state.credentialEntries.length)
+        throw new Error('duplicate SSH credential entry id');
+    for (const profile of state.profiles) {
+        if (profile.credentialId !== undefined && !credentialIds.has(profile.credentialId))
+            throw Object.assign(new Error('SSH profile references a missing credential entry'), { status: 400 });
+        if (profile.proxy.type === 'jump' && (profile.proxy.profileIds.length === 0 || profile.proxy.profileIds.some(id => !ids.has(id) || id === profile.id) || new Set(profile.proxy.profileIds).size !== profile.proxy.profileIds.length)) {
+            throw Object.assign(new Error('jump proxy chain must reference unique existing profiles other than itself'), { status: 400 });
+        }
+    }
+    for (const rule of state.forwardRules)
+        if (!ids.has(rule.profileId))
+            throw new Error(`forward rule references missing profile ${rule.profileId}`);
+    for (const injection of state.injections) {
+        injection.profileIds = [...new Set(injection.profileIds.filter(id => ids.has(id)))];
+        injection.workingDirectories = Object.fromEntries(Object.entries(injection.workingDirectories).filter(([profileId]) => injection.profileIds.includes(profileId)));
+    }
+}
+function normalizeStoredProfile(profile) {
+    const proxy = profile.proxy;
+    if (proxy.type !== 'jump')
+        return profile;
+    const profileIds = Array.isArray(proxy.profileIds)
+        ? proxy.profileIds.filter((id) => typeof id === 'string' && id.length > 0)
+        : typeof proxy.profileId === 'string' && proxy.profileId.length > 0 ? [proxy.profileId] : [];
+    return { ...profile, proxy: { type: 'jump', profileIds: [...new Set(profileIds)] } };
+}
+function normalizeWorkingDirectories(injection) {
+    if (typeof injection !== 'object' || injection === null)
+        return {};
+    const value = injection.workingDirectories;
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return {};
+    return Object.fromEntries(Object.entries(value).filter((entry) => {
+        const [profileId, cwd] = entry;
+        return profileId.length > 0 && profileId.length <= 100 && typeof cwd === 'string' && cwd.trim().length > 0 && cwd.length <= 4096 && !/[\0\r\n]/.test(cwd);
+    }).map(([profileId, cwd]) => [profileId, cwd.trim()]));
+}
+async function fileExists(path) {
+    try {
+        await readFile(path);
+        return true;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return false;
+        throw error;
+    }
+}
+//# sourceMappingURL=store.js.map

package/lib/store.js.map

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

package/lib/terminal.d.ts

@@ -0,0 +1,108 @@
+import type { ClientChannel } from 'ssh2';
+import type { TerminalBackend, TerminalBackendSession, TerminalBackendSpawnSpec, TerminalReadRequest, TerminalReadResult, TerminalSendOperation, TerminalSendRequest, TerminalSendResult, TerminalSessionStatus, TerminalSignal, TerminalSignalResult } from '@deepseek-ai/dsh-terminal';
+import { SshConnector, type ManagedSshConnection } from './connector.js';
+import { SshStore } from './store.js';
+export declare class SshTerminalBackend implements TerminalBackend {
+    private readonly connector;
+    private readonly store;
+    readonly type = "ssh";
+    constructor(connector: SshConnector, store: SshStore);
+    spawn(spec: TerminalBackendSpawnSpec): Promise<TerminalBackendSession>;
+}
+export declare class SshTerminalSession implements TerminalBackendSession {
+    private readonly connection;
+    readonly channel: ClientChannel;
+    readonly motd: string;
+    private scrollback;
+    private terminalStatus;
+    private active;
+    private closing?;
+    constructor(connection: ManagedSshConnection, channel: ClientChannel, motd: string);
+    startSend(request: TerminalSendRequest): TerminalSendOperation;
+    read(request: TerminalReadRequest): TerminalReadResult;
+    write(text: string): void;
+    resize(cols: number, rows: number): void;
+    signal(signal: TerminalSignal): Promise<TerminalSignalResult>;
+    status(): TerminalSessionStatus;
+    close(_reason: string): Promise<void>;
+    receive(text: string): void;
+    snapshotStatus(): TerminalSessionStatus;
+}
+export declare class BrowserTerminalManager {
+    private readonly connector;
+    private readonly sessions;
+    constructor(connector: SshConnector);
+    create(profileId: string, cols: number, rows: number, signal?: AbortSignal): Promise<{
+        id: string;
+        profileId: string;
+    }>;
+    get(id: string): BrowserTerminal;
+    closeAll(): Promise<void>;
+}
+/** Owner-scoped AI terminals for Web profiles, whose official Terminal service lives inside each Agent preset realm. */
+export declare class AiTerminalManager {
+    private readonly connector;
+    private readonly sessions;
+    constructor(connector: SshConnector);
+    create(ownerId: string, profileId: string, cwd: string, name?: string, signal?: AbortSignal): Promise<{
+        terminalId: string;
+        profileId: string;
+        cwd: string;
+        motd: string;
+    }>;
+    get(ownerId: string, terminalId: string): SshTerminalSession;
+    list(ownerId: string): Array<{
+        terminalId: string;
+        status: TerminalSessionStatus;
+    }>;
+    send(ownerId: string, terminalId: string, request: TerminalSendRequest): Promise<TerminalSendResult>;
+    write(ownerId: string, terminalId: string, text: string): void;
+    resize(ownerId: string, terminalId: string, cols: number, rows: number): void;
+    activity(ownerId: string): AiTerminalActivity[];
+    close(ownerId: string, terminalId: string): Promise<boolean>;
+    closeAll(): Promise<void>;
+}
+export interface AiTerminalCommand {
+    id: string;
+    command: string;
+    submitted: boolean;
+    startedAt: number;
+    completedAt: number;
+    output: string;
+    waitReason: TerminalSendResult['waitReason'];
+    truncated: boolean;
+}
+export interface AiTerminalActivity {
+    terminalId: string;
+    profileId: string;
+    name: string;
+    cwd: string;
+    createdAt: number;
+    status: TerminalSessionStatus;
+    scrollback: string;
+    commands: AiTerminalCommand[];
+}
+export declare class BrowserTerminal {
+    readonly id: string;
+    readonly profileId: string;
+    private readonly connection;
+    private readonly channel;
+    private readonly onClose;
+    private output;
+    private baseCursor;
+    private closed;
+    private idleTimer;
+    constructor(id: string, profileId: string, connection: ManagedSshConnection, channel: ClientChannel, onClose: () => void);
+    write(text: string): void;
+    resize(cols: number, rows: number): void;
+    read(cursor: number): {
+        data: string;
+        cursor: number;
+        truncated: boolean;
+        closed: boolean;
+    };
+    close(): Promise<void>;
+    private append;
+    private touch;
+}
+//# sourceMappingURL=terminal.d.ts.map

package/lib/terminal.d.ts.map

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