@artenx/dshb 0.1.31 → 0.1.33

package/lib/ssh-transport-C7povM0s.d.ts

@@ -0,0 +1,115 @@
+import { a as SyncPeer } from "./model-BP7Gw1yk.js";
+import { i as SyncNodeManifest, t as SyncNodeApplyResult } from "./node-sync-3Z9QLz2n.js";
+import { SyncPeerManager, SyncPeerSecrets } from "./core/sync/peer-manager.js";
+import { r as SyncHostKeyChallenges, t as SyncHostKeyChallengeError } from "./host-key-C5afhAUd.js";
+import { d as SyncFrame } from "./protocol-DJ0zyVlB.js";
+import { a as SyncSessionBundle, d as SyncSessionManifest, i as SyncSessionApplyResult, l as SyncSessionEventPrefix, p as SyncSessionObject } from "./session-sync-BuOJvFxK.js";
+import { Client, ClientChannel, ConnectConfig } from "ssh2";
+//#region src/core/sync/ssh-transport.d.ts
+type SyncSshErrorCategory = 'auth' | 'network' | 'hostkey' | 'timeout' | 'helper' | 'protocol';
+declare class SyncSshProbeError extends Error {
+  readonly category: SyncSshErrorCategory;
+  constructor(category: SyncSshErrorCategory);
+}
+declare class SyncSessionDeltaPrefixError extends Error {
+  constructor();
+}
+interface SyncRemoteHandshake {
+  protocolVersion: number;
+  instanceId: string;
+  capabilities: string[];
+}
+interface SyncRemoteNodeManifest extends SyncNodeManifest {
+  capabilities?: string[];
+}
+declare class SyncSshSession {
+  private readonly client;
+  private readonly channel;
+  private readonly decoder;
+  private readonly closeSignal;
+  private reading;
+  private closed;
+  private inputEnded;
+  private nextDataSequence;
+  private pendingError;
+  constructor(client: Client, channel: ClientChannel);
+  sendControl(value: Record<string, unknown>): Promise<void>;
+  sendData(sequence: number, data: Buffer): Promise<void>;
+  endInput(): void;
+  readFrames(idleTimeoutMs?: number): AsyncGenerator<SyncFrame>;
+  close(): void;
+  private write;
+}
+declare function buildSyncSshConnectConfig(peer: SyncPeer, secrets: SyncPeerSecrets, challenges: SyncHostKeyChallenges, onChallenge: (error: SyncHostKeyChallengeError) => void): ConnectConfig;
+declare class SyncSshTransport {
+  private readonly peerManager;
+  private readonly hostKeyChallenges;
+  constructor(peerManager: SyncPeerManager);
+  probe(peerId: string): Promise<SyncRemoteHandshake>;
+  openSession(peerId: string): Promise<{
+    peer: SyncPeer;
+    session: SyncSshSession;
+  }>;
+  fetchNodeManifest(peerId: string): Promise<SyncRemoteNodeManifest>;
+  applyNodeManifest(peerId: string, records: SyncNodeManifest['records'], sourceName: string): Promise<SyncNodeApplyResult>;
+  fetchSessionBundle(peerId: string): Promise<SyncSessionBundle>;
+  fetchSessionManifest(peerId: string): Promise<SyncSessionManifest>;
+  fetchSessionEntries(peerId: string, keys: readonly string[], manifestDigest: string, prefixes?: readonly SyncSessionEventPrefix[], deferredObjects?: boolean): Promise<SyncSessionBundle>;
+  applySessionBundle(peerId: string, bundle: SyncSessionBundle, sourceName: string): Promise<SyncSessionApplyResult>;
+  trustObservedHostKey(peerId: string): Promise<void>;
+  /**
+   * 拉取带外对象流：响应以帧流形式逐块 yield，调用方（收件箱）边收边落盘，
+   * 内存 O(单帧)。会话在流结束/出错时关闭（生成器 finally）。
+   */
+  fetchSessionObjects(peerId: string, objects: readonly SyncSessionObject[]): AsyncGenerator<Uint8Array>;
+  /**
+   * 推送带外对象流：把帧流按 1MB 分块写入请求体，逐块经 SSH 发送；
+   * 对端流式落盘收件箱后返回 JSON 摘要。
+   */
+  pushSessionObjects(peerId: string, frames: AsyncIterable<Uint8Array>): Promise<void>;
+  private fetchDataOperation;
+  private requestHandshake;
+}
+interface SyncRemoteProbeDraft {
+  host: string;
+  port: number;
+  username: string;
+  authKind: 'password' | 'key';
+}
+interface SyncRemoteProbeProfile {
+  name: string;
+  dshbInstalled: boolean;
+  home: string;
+}
+interface SyncRemoteProbeHandshake {
+  port: number;
+  instanceId: string;
+}
+interface SyncRemoteProbeResult {
+  homes: string[];
+  profiles: SyncRemoteProbeProfile[];
+  /** 握手命中的全部端口（同机多实例时可能有多个；配置端口的命中排最前）。 */
+  handshakes: SyncRemoteProbeHandshake[];
+  webPort?: number;
+  instanceId?: string;
+  processHints: string[];
+  hostKeyFingerprint: string;
+}
+declare const REMOTE_PROBE_BEGIN_MARKER = "DSHB_PROBE_BEGIN";
+declare const REMOTE_PROBE_END_MARKER = "DSHB_PROBE_END";
+/**
+ * 生成远端发现脚本：纯 POSIX sh + 远端 node（DSH 所在机器必然有 node）。
+ * 三个动作：① 多候选定位 DSH_HOME（含桌面版常见路径）；② 列出 profiles 及
+ * dshb 安装标记；③ 握手探测真实 Web 端口（仅远端回环，桌面版 127.0.0.1:3080
+ * 即可命中）。输出以 BEGIN/END 标记包裹，逐行 "key value"。
+ */
+declare function buildRemoteProbeScript(dshHome?: string, preferredWebPort?: number): string;
+/** 解析探测输出：仅在 BEGIN/END 标记之间取行，容忍未知行。 */
+declare function parseRemoteProbeOutput(output: string, hostKeyFingerprint: string, preferredWebPort?: number): SyncRemoteProbeResult;
+declare class SyncRemoteProbe {
+  /** 探测远端：SSH 登录 + 单次 exec 发现脚本；主机密钥自动接受（只读发现，指纹随结果返回）。 */
+  probeRemote(draft: SyncRemoteProbeDraft, secrets: SyncPeerSecrets, preferredWebPort?: number): Promise<SyncRemoteProbeResult>;
+}
+//#endregion
+export { parseRemoteProbeOutput as _, SyncRemoteProbe as a, SyncRemoteProbeProfile as c, SyncSshErrorCategory as d, SyncSshProbeError as f, buildSyncSshConnectConfig as g, buildRemoteProbeScript as h, SyncRemoteNodeManifest as i, SyncRemoteProbeResult as l, SyncSshTransport as m, REMOTE_PROBE_END_MARKER as n, SyncRemoteProbeDraft as o, SyncSshSession as p, SyncRemoteHandshake as r, SyncRemoteProbeHandshake as s, REMOTE_PROBE_BEGIN_MARKER as t, SyncSessionDeltaPrefixError as u };
+//# sourceMappingURL=ssh-transport-C7povM0s.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artenx/dshb",
-  "version": "0.1.31",
+  "version": "0.1.33",
   "description": "Routes DSH filesystem, shell, subprocess, and PTY operations to local, SSH, and Docker execution nodes, with a node registry, an authentication gate, a mobile-aware management UI, and per-workspace custom project instructions.",
   "type": "module",
   "main": "lib/index.js",