dshb-router 0.0.1

package/lib/index.d.ts

@@ -0,0 +1,9 @@
+import { t as Context } from "./index-CLOUBKxU.js";
+import { ExecutionWorldProvider, NodeTestReport, WorkspaceBindings, WorldRef, WorldRegistry } from "./types.js";
+import { sharedWorldResolver } from "./resolve.js";
+//#region src/index.d.ts
+declare const name = "dshb-router";
+declare function apply(ctx: Context): void;
+//#endregion
+export { type ExecutionWorldProvider, type NodeTestReport, type WorkspaceBindings, type WorldRef, type WorldRegistry, apply, name, sharedWorldResolver };
+//# sourceMappingURL=index.d.ts.map

package/lib/index.js

@@ -0,0 +1,10 @@
+import { sharedWorldResolver } from "./resolve.js";
+//#region src/index.ts
+const name = "dshb-router";
+function apply(ctx) {
+	ctx.provide("dshbRouter", sharedWorldResolver());
+}
+//#endregion
+export { apply, name, sharedWorldResolver };
+
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import type { Context } from '@deepseek-ai/cordis'\nimport { sharedWorldResolver } from './resolve.js'\n\nexport const name = 'dshb-router'\n\nexport function apply(ctx: Context): void {\n  ctx.provide('dshbRouter', sharedWorldResolver())\n}\n\nexport { sharedWorldResolver } from './resolve.js'\nexport type { ExecutionWorldProvider, WorkspaceBindings, WorldRegistry, WorldRef, NodeTestReport } from './types.js'\n"],"mappings":";;AAGA,MAAa,OAAO;AAEpB,SAAgB,MAAM,KAAoB;CACxC,IAAI,QAAQ,cAAc,oBAAoB,CAAC;AACjD"}

package/lib/resolve.d.ts

@@ -0,0 +1,22 @@
+import { WorkspaceBindings, WorldRef, WorldRegistry } from "./types.js";
+//#region src/resolve.d.ts
+interface BindingHit {
+  nodeId: string;
+  remotePath: string;
+}
+declare function resolveWorld(absPath: string, bindings?: WorkspaceBindings): {
+  kind: 'local';
+} | ({
+  kind: 'remote';
+} & BindingHit);
+declare class WorldResolver {
+  private bindings?;
+  private registries;
+  setBindings(bindings: WorkspaceBindings): void;
+  setRegistry(registry: WorldRegistry): void;
+  resolve(absPath: string): WorldRef;
+}
+declare function sharedWorldResolver(): WorldResolver;
+//#endregion
+export { BindingHit, WorldResolver, resolveWorld, sharedWorldResolver };
+//# sourceMappingURL=resolve.d.ts.map

package/lib/resolve.js

@@ -0,0 +1,45 @@
+//#region src/resolve.ts
+function resolveWorld(absPath, bindings) {
+	if (!bindings) return { kind: "local" };
+	const hit = bindings.resolve(absPath);
+	if (!hit) return { kind: "local" };
+	return {
+		kind: "remote",
+		...hit
+	};
+}
+var WorldResolver = class {
+	bindings;
+	registries = [];
+	setBindings(bindings) {
+		this.bindings = bindings;
+	}
+	setRegistry(registry) {
+		this.registries.push(registry);
+	}
+	resolve(absPath) {
+		const r = resolveWorld(absPath, this.bindings);
+		if (r.kind === "local") return { kind: "local" };
+		for (const reg of this.registries) {
+			const provider = reg.get(r.nodeId);
+			if (provider) return {
+				kind: "remote",
+				provider,
+				remotePath: r.remotePath
+			};
+		}
+		return {
+			kind: "unrouted",
+			nodeId: r.nodeId
+		};
+	}
+};
+let shared = null;
+function sharedWorldResolver() {
+	if (!shared) shared = new WorldResolver();
+	return shared;
+}
+//#endregion
+export { WorldResolver, resolveWorld, sharedWorldResolver };
+
+//# sourceMappingURL=resolve.js.map

package/lib/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","names":[],"sources":["../src/resolve.ts"],"sourcesContent":["import type { WorldRegistry, WorkspaceBindings, WorldRef } from './types.js'\n\nexport interface BindingHit {\n  nodeId: string\n  remotePath: string\n}\n\nexport function resolveWorld(absPath: string, bindings?: WorkspaceBindings): { kind: 'local' } | ({ kind: 'remote' } & BindingHit) {\n  if (!bindings) return { kind: 'local' }\n  const hit = bindings.resolve(absPath)\n  if (!hit) return { kind: 'local' }\n  return { kind: 'remote', ...hit }\n}\n\nexport class WorldResolver {\n  private bindings?: WorkspaceBindings\n  private registries: WorldRegistry[] = []\n\n  setBindings(bindings: WorkspaceBindings): void {\n    this.bindings = bindings\n  }\n\n  setRegistry(registry: WorldRegistry): void {\n    this.registries.push(registry)\n  }\n\n  resolve(absPath: string): WorldRef {\n    const r = resolveWorld(absPath, this.bindings)\n    if (r.kind === 'local') return { kind: 'local' }\n    for (const reg of this.registries) {\n      const provider = reg.get(r.nodeId)\n      if (provider) return { kind: 'remote', provider, remotePath: r.remotePath }\n    }\n    return { kind: 'unrouted', nodeId: r.nodeId }\n  }\n}\n\nlet shared: WorldResolver | null = null\n\nexport function sharedWorldResolver(): WorldResolver {\n  if (!shared) shared = new WorldResolver()\n  return shared\n}\n"],"mappings":";AAOA,SAAgB,aAAa,SAAiB,UAAqF;CACjI,IAAI,CAAC,UAAU,OAAO,EAAE,MAAM,QAAQ;CACtC,MAAM,MAAM,SAAS,QAAQ,OAAO;CACpC,IAAI,CAAC,KAAK,OAAO,EAAE,MAAM,QAAQ;CACjC,OAAO;EAAE,MAAM;EAAU,GAAG;CAAI;AAClC;AAEA,IAAa,gBAAb,MAA2B;CACzB;CACA,aAAsC,CAAC;CAEvC,YAAY,UAAmC;EAC7C,KAAK,WAAW;CAClB;CAEA,YAAY,UAA+B;EACzC,KAAK,WAAW,KAAK,QAAQ;CAC/B;CAEA,QAAQ,SAA2B;EACjC,MAAM,IAAI,aAAa,SAAS,KAAK,QAAQ;EAC7C,IAAI,EAAE,SAAS,SAAS,OAAO,EAAE,MAAM,QAAQ;EAC/C,KAAK,MAAM,OAAO,KAAK,YAAY;GACjC,MAAM,WAAW,IAAI,IAAI,EAAE,MAAM;GACjC,IAAI,UAAU,OAAO;IAAE,MAAM;IAAU;IAAU,YAAY,EAAE;GAAW;EAC5E;EACA,OAAO;GAAE,MAAM;GAAY,QAAQ,EAAE;EAAO;CAC9C;AACF;AAEA,IAAI,SAA+B;AAEnC,SAAgB,sBAAqC;CACnD,IAAI,CAAC,QAAQ,SAAS,IAAI,cAAc;CACxC,OAAO;AACT"}

package/lib/router-fs.d.ts

@@ -0,0 +1,25 @@
+import { t as Context } from "./index-CLOUBKxU.js";
+import SandboxedFileSystem from "@deepseek-ai/dsh-fs-sandbox";
+import { FsDirEntry, FsEditOutcome, FsEditRequest, FsInfo, FsPathInfo, FsTarget, FsVersion, FsWriteIntent, FsWriteOutcome } from "@deepseek-ai/dsh-fs";
+import { SandboxExecutionPolicy } from "@deepseek-ai/dsh-sandbox";
+//#region src/router-fs.d.ts
+declare class RouterFileSystem extends SandboxedFileSystem {
+  private readonly resolver;
+  constructor(ctx: Context, config: unknown);
+  private targetPath;
+  stat(target: FsTarget, signal?: AbortSignal): Promise<FsInfo | undefined>;
+  lstat(path: string, opts?: {
+    cwd?: string;
+  }, signal?: AbortSignal): Promise<FsPathInfo | undefined>;
+  readText(target: FsTarget, signal?: AbortSignal): Promise<string>;
+  streamText(target: FsTarget, signal?: AbortSignal): Promise<AsyncIterable<string>>;
+  readBytes(target: FsTarget, signal: AbortSignal | undefined, maxBytes: number): Promise<Uint8Array>;
+  listDir(target: FsTarget, signal?: AbortSignal): Promise<FsDirEntry[]>;
+  writeText(target: FsTarget, content: string, expected?: FsWriteIntent, signal?: AbortSignal, sandboxPolicy?: SandboxExecutionPolicy): Promise<FsWriteOutcome>;
+  editText(target: FsTarget, edit: FsEditRequest, expected?: {
+    version: FsVersion;
+  }, signal?: AbortSignal, sandboxPolicy?: SandboxExecutionPolicy): Promise<FsEditOutcome>;
+}
+//#endregion
+export { RouterFileSystem as default };
+//# sourceMappingURL=router-fs.d.ts.map

package/lib/router-fs.js

@@ -0,0 +1,64 @@
+import { sharedWorldResolver } from "./resolve.js";
+import SandboxedFileSystem from "@deepseek-ai/dsh-fs-sandbox";
+//#region src/router-fs.ts
+var RouterFileSystem = class extends SandboxedFileSystem {
+	resolver = sharedWorldResolver();
+	constructor(ctx, config) {
+		super(ctx, config);
+	}
+	targetPath(target) {
+		return this.processPath(target);
+	}
+	async stat(target, signal) {
+		const ref = this.resolver.resolve(this.targetPath(target));
+		if (ref.kind === "local") return super.stat(target, signal);
+		if (ref.kind === "unrouted") throw new Error(`node ${ref.nodeId} world not available`);
+		return ref.provider.fs.stat(ref.remotePath, signal);
+	}
+	async lstat(path, opts, signal) {
+		const ref = this.resolver.resolve(path);
+		if (ref.kind === "local") return super.lstat(path, opts, signal);
+		if (ref.kind === "unrouted") throw new Error(`node ${ref.nodeId} world not available`);
+		return ref.provider.fs.lstat(ref.remotePath, opts, signal);
+	}
+	async readText(target, signal) {
+		const ref = this.resolver.resolve(this.targetPath(target));
+		if (ref.kind === "local") return super.readText(target, signal);
+		if (ref.kind === "unrouted") throw new Error(`node ${ref.nodeId} world not available`);
+		return ref.provider.fs.readText(ref.remotePath, signal);
+	}
+	async streamText(target, signal) {
+		const ref = this.resolver.resolve(this.targetPath(target));
+		if (ref.kind === "local") return super.streamText(target, signal);
+		if (ref.kind === "unrouted") throw new Error(`node ${ref.nodeId} world not available`);
+		return ref.provider.fs.streamText(ref.remotePath, signal);
+	}
+	async readBytes(target, signal, maxBytes) {
+		const ref = this.resolver.resolve(this.targetPath(target));
+		if (ref.kind === "local") return super.readBytes(target, signal, maxBytes);
+		if (ref.kind === "unrouted") throw new Error(`node ${ref.nodeId} world not available`);
+		return ref.provider.fs.readBytes(ref.remotePath, signal, maxBytes);
+	}
+	async listDir(target, signal) {
+		const ref = this.resolver.resolve(this.targetPath(target));
+		if (ref.kind === "local") return super.listDir(target, signal);
+		if (ref.kind === "unrouted") throw new Error(`node ${ref.nodeId} world not available`);
+		return ref.provider.fs.listDir(ref.remotePath, signal);
+	}
+	async writeText(target, content, expected, signal, sandboxPolicy) {
+		const ref = this.resolver.resolve(this.targetPath(target));
+		if (ref.kind === "local") return super.writeText(target, content, expected, signal, sandboxPolicy);
+		if (ref.kind === "unrouted") throw new Error(`node ${ref.nodeId} world not available`);
+		return ref.provider.fs.writeText(ref.remotePath, content, expected, signal, sandboxPolicy);
+	}
+	async editText(target, edit, expected, signal, sandboxPolicy) {
+		const ref = this.resolver.resolve(this.targetPath(target));
+		if (ref.kind === "local") return super.editText(target, edit, expected, signal, sandboxPolicy);
+		if (ref.kind === "unrouted") throw new Error(`node ${ref.nodeId} world not available`);
+		return ref.provider.fs.editText(ref.remotePath, edit, expected, signal, sandboxPolicy);
+	}
+};
+//#endregion
+export { RouterFileSystem as default };
+
+//# sourceMappingURL=router-fs.js.map

package/lib/router-fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router-fs.js","names":[],"sources":["../src/router-fs.ts"],"sourcesContent":["import SandboxedFileSystem from '@deepseek-ai/dsh-fs-sandbox'\nimport type { Context } from '@deepseek-ai/cordis'\nimport type { FsEditOutcome, FsEditRequest, FsTarget, FsVersion, FsWriteIntent, FsWriteOutcome, FsDirEntry, FsInfo, FsPathInfo } from '@deepseek-ai/dsh-fs'\nimport type { SandboxExecutionPolicy } from '@deepseek-ai/dsh-sandbox'\nimport type { FsDelegate } from './types.js'\nimport { sharedWorldResolver } from './resolve.js'\n\nexport default class RouterFileSystem extends SandboxedFileSystem {\n  private readonly resolver = sharedWorldResolver()\n\n  constructor(ctx: Context, config: unknown) {\n    super(ctx, config as never)\n  }\n\n  private targetPath(target: FsTarget): string {\n    return this.processPath(target)\n  }\n\n  override async stat(target: FsTarget, signal?: AbortSignal): Promise<FsInfo | undefined> {\n    const ref = this.resolver.resolve(this.targetPath(target))\n    if (ref.kind === 'local') return super.stat(target, signal)\n    if (ref.kind === 'unrouted') throw new Error(`node ${ref.nodeId} world not available`)\n    return ref.provider.fs.stat(ref.remotePath, signal) as Promise<FsInfo | undefined>\n  }\n\n  override async lstat(path: string, opts?: { cwd?: string }, signal?: AbortSignal): Promise<FsPathInfo | undefined> {\n    const ref = this.resolver.resolve(path)\n    if (ref.kind === 'local') return super.lstat(path, opts, signal)\n    if (ref.kind === 'unrouted') throw new Error(`node ${ref.nodeId} world not available`)\n    return ref.provider.fs.lstat(ref.remotePath, opts, signal) as Promise<FsPathInfo | undefined>\n  }\n\n  override async readText(target: FsTarget, signal?: AbortSignal): Promise<string> {\n    const ref = this.resolver.resolve(this.targetPath(target))\n    if (ref.kind === 'local') return super.readText(target, signal)\n    if (ref.kind === 'unrouted') throw new Error(`node ${ref.nodeId} world not available`)\n    return ref.provider.fs.readText(ref.remotePath, signal)\n  }\n\n  override async streamText(target: FsTarget, signal?: AbortSignal): Promise<AsyncIterable<string>> {\n    const ref = this.resolver.resolve(this.targetPath(target))\n    if (ref.kind === 'local') return super.streamText(target, signal)\n    if (ref.kind === 'unrouted') throw new Error(`node ${ref.nodeId} world not available`)\n    return ref.provider.fs.streamText(ref.remotePath, signal)\n  }\n\n  override async readBytes(target: FsTarget, signal: AbortSignal | undefined, maxBytes: number): Promise<Uint8Array> {\n    const ref = this.resolver.resolve(this.targetPath(target))\n    if (ref.kind === 'local') return super.readBytes(target, signal, maxBytes)\n    if (ref.kind === 'unrouted') throw new Error(`node ${ref.nodeId} world not available`)\n    return ref.provider.fs.readBytes(ref.remotePath, signal, maxBytes)\n  }\n\n  override async listDir(target: FsTarget, signal?: AbortSignal): Promise<FsDirEntry[]> {\n    const ref = this.resolver.resolve(this.targetPath(target))\n    if (ref.kind === 'local') return super.listDir(target, signal)\n    if (ref.kind === 'unrouted') throw new Error(`node ${ref.nodeId} world not available`)\n    return ref.provider.fs.listDir(ref.remotePath, signal) as Promise<FsDirEntry[]>\n  }\n\n  override async writeText(target: FsTarget, content: string, expected?: FsWriteIntent, signal?: AbortSignal, sandboxPolicy?: SandboxExecutionPolicy): Promise<FsWriteOutcome> {\n    const ref = this.resolver.resolve(this.targetPath(target))\n    if (ref.kind === 'local') return super.writeText(target, content, expected, signal, sandboxPolicy)\n    if (ref.kind === 'unrouted') throw new Error(`node ${ref.nodeId} world not available`)\n    return ref.provider.fs.writeText(ref.remotePath, content, expected, signal, sandboxPolicy) as Promise<FsWriteOutcome>\n  }\n\n  override async editText(target: FsTarget, edit: FsEditRequest, expected?: { version: FsVersion }, signal?: AbortSignal, sandboxPolicy?: SandboxExecutionPolicy): Promise<FsEditOutcome> {\n    const ref = this.resolver.resolve(this.targetPath(target))\n    if (ref.kind === 'local') return super.editText(target, edit, expected, signal, sandboxPolicy)\n    if (ref.kind === 'unrouted') throw new Error(`node ${ref.nodeId} world not available`)\n    return ref.provider.fs.editText(ref.remotePath, edit, expected, signal, sandboxPolicy) as Promise<FsEditOutcome>\n  }\n}\n"],"mappings":"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"}

package/lib/router-shell.d.ts

@@ -0,0 +1,14 @@
+import { t as Context } from "./index-CLOUBKxU.js";
+import SandboxBashExecutor from "@deepseek-ai/dsh-bash-sandbox";
+import { ShellExecRequest, ShellExecSpec, ShellProcess, ShellRunResult } from "@deepseek-ai/dsh-shell";
+//#region src/router-shell.d.ts
+declare class RouterShell extends SandboxBashExecutor {
+  private readonly resolver;
+  constructor(ctx: Context, config: unknown);
+  resolve(request: ShellExecRequest): ShellExecSpec;
+  run(spec: ShellExecSpec): Promise<ShellRunResult>;
+  start(spec: ShellExecSpec): ShellProcess;
+}
+//#endregion
+export { RouterShell as default };
+//# sourceMappingURL=router-shell.d.ts.map

package/lib/router-shell.js

@@ -0,0 +1,36 @@
+import { sharedWorldResolver } from "./resolve.js";
+import SandboxBashExecutor from "@deepseek-ai/dsh-bash-sandbox";
+//#region src/router-shell.ts
+var RouterShell = class extends SandboxBashExecutor {
+	resolver = sharedWorldResolver();
+	constructor(ctx, config) {
+		super(ctx, config);
+	}
+	resolve(request) {
+		return super.resolve(request);
+	}
+	async run(spec) {
+		const ref = this.resolver.resolve(spec.workdir ?? "");
+		if (ref.kind === "local") return super.run(spec);
+		if (ref.kind === "unrouted") throw new Error(`node ${ref.nodeId} world not available`);
+		await ref.provider.ensureDir(ref.remotePath).catch(() => {});
+		return ref.provider.shell.run({
+			...spec,
+			workdir: ref.remotePath
+		});
+	}
+	start(spec) {
+		const ref = this.resolver.resolve(spec.workdir ?? "");
+		if (ref.kind === "local") return super.start(spec);
+		if (ref.kind === "unrouted") throw new Error(`node ${ref.nodeId} world not available`);
+		ref.provider.ensureDir(ref.remotePath).catch(() => {});
+		return ref.provider.shell.start({
+			...spec,
+			workdir: ref.remotePath
+		});
+	}
+};
+//#endregion
+export { RouterShell as default };
+
+//# sourceMappingURL=router-shell.js.map

package/lib/router-shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router-shell.js","names":[],"sources":["../src/router-shell.ts"],"sourcesContent":["import SandboxBashExecutor from '@deepseek-ai/dsh-bash-sandbox'\nimport type { Context } from '@deepseek-ai/cordis'\nimport type { ShellExecRequest, ShellExecSpec, ShellProcess, ShellRunResult } from '@deepseek-ai/dsh-shell'\nimport { sharedWorldResolver } from './resolve.js'\n\nexport default class RouterShell extends SandboxBashExecutor {\n  private readonly resolver = sharedWorldResolver()\n\n  constructor(ctx: Context, config: unknown) {\n    super(ctx, config as never)\n  }\n\n  override resolve(request: ShellExecRequest): ShellExecSpec {\n    return super.resolve(request)\n  }\n\n  override async run(spec: ShellExecSpec): Promise<ShellRunResult> {\n    const ref = this.resolver.resolve(spec.workdir ?? '')\n    if (ref.kind === 'local') return super.run(spec)\n    if (ref.kind === 'unrouted') throw new Error(`node ${ref.nodeId} world not available`)\n    await ref.provider.ensureDir(ref.remotePath).catch(() => {})\n    return ref.provider.shell.run({ ...spec, workdir: ref.remotePath })\n  }\n\n  override start(spec: ShellExecSpec): ShellProcess {\n    const ref = this.resolver.resolve(spec.workdir ?? '')\n    if (ref.kind === 'local') return super.start(spec)\n    if (ref.kind === 'unrouted') throw new Error(`node ${ref.nodeId} world not available`)\n    void ref.provider.ensureDir(ref.remotePath).catch(() => {})\n    return ref.provider.shell.start({ ...spec, workdir: ref.remotePath })\n  }\n}\n"],"mappings":";;;AAKA,IAAqB,cAArB,cAAyC,oBAAoB;CAC3D,WAA4B,oBAAoB;CAEhD,YAAY,KAAc,QAAiB;EACzC,MAAM,KAAK,MAAe;CAC5B;CAEA,QAAiB,SAA0C;EACzD,OAAO,MAAM,QAAQ,OAAO;CAC9B;CAEA,MAAe,IAAI,MAA8C;EAC/D,MAAM,MAAM,KAAK,SAAS,QAAQ,KAAK,WAAW,EAAE;EACpD,IAAI,IAAI,SAAS,SAAS,OAAO,MAAM,IAAI,IAAI;EAC/C,IAAI,IAAI,SAAS,YAAY,MAAM,IAAI,MAAM,QAAQ,IAAI,OAAO,qBAAqB;EACrF,MAAM,IAAI,SAAS,UAAU,IAAI,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC;EAC3D,OAAO,IAAI,SAAS,MAAM,IAAI;GAAE,GAAG;GAAM,SAAS,IAAI;EAAW,CAAC;CACpE;CAEA,MAAe,MAAmC;EAChD,MAAM,MAAM,KAAK,SAAS,QAAQ,KAAK,WAAW,EAAE;EACpD,IAAI,IAAI,SAAS,SAAS,OAAO,MAAM,MAAM,IAAI;EACjD,IAAI,IAAI,SAAS,YAAY,MAAM,IAAI,MAAM,QAAQ,IAAI,OAAO,qBAAqB;EACrF,IAAS,SAAS,UAAU,IAAI,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC;EAC1D,OAAO,IAAI,SAAS,MAAM,MAAM;GAAE,GAAG;GAAM,SAAS,IAAI;EAAW,CAAC;CACtE;AACF"}

package/lib/router-subprocess.d.ts

@@ -0,0 +1,13 @@
+import { t as Context } from "./index-CLOUBKxU.js";
+import LocalSubprocessRuntime from "@deepseek-ai/dsh-subprocess-local";
+import { SubprocessHandle, SubprocessSpawnSpec, SubprocessTerminalHandle, SubprocessTerminalSpawnSpec } from "@deepseek-ai/dsh-subprocess";
+//#region src/router-subprocess.d.ts
+declare class RouterSubprocess extends LocalSubprocessRuntime {
+  private readonly resolver;
+  constructor(ctx: Context);
+  spawn(spec: SubprocessSpawnSpec): SubprocessHandle;
+  spawnTerminal(spec: SubprocessTerminalSpawnSpec): Promise<SubprocessTerminalHandle>;
+}
+//#endregion
+export { RouterSubprocess as default };
+//# sourceMappingURL=router-subprocess.d.ts.map

package/lib/router-subprocess.js

@@ -0,0 +1,33 @@
+import { sharedWorldResolver } from "./resolve.js";
+import LocalSubprocessRuntime from "@deepseek-ai/dsh-subprocess-local";
+//#region src/router-subprocess.ts
+var RouterSubprocess = class extends LocalSubprocessRuntime {
+	resolver = sharedWorldResolver();
+	constructor(ctx) {
+		super(ctx);
+	}
+	spawn(spec) {
+		const ref = this.resolver.resolve(spec.cwd ?? "");
+		if (ref.kind === "local") return super.spawn(spec);
+		if (ref.kind === "unrouted") throw new Error(`node ${ref.nodeId} world not available`);
+		ref.provider.ensureDir(ref.remotePath).catch(() => {});
+		return ref.provider.subprocess.spawn({
+			...spec,
+			cwd: ref.remotePath
+		});
+	}
+	async spawnTerminal(spec) {
+		const ref = this.resolver.resolve(spec.cwd ?? "");
+		if (ref.kind === "local") return super.spawnTerminal(spec);
+		if (ref.kind === "unrouted") throw new Error(`node ${ref.nodeId} world not available`);
+		await ref.provider.ensureDir(ref.remotePath).catch(() => {});
+		return ref.provider.subprocess.spawnTerminal({
+			...spec,
+			cwd: ref.remotePath
+		});
+	}
+};
+//#endregion
+export { RouterSubprocess as default };
+
+//# sourceMappingURL=router-subprocess.js.map

package/lib/router-subprocess.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router-subprocess.js","names":[],"sources":["../src/router-subprocess.ts"],"sourcesContent":["import LocalSubprocessRuntime from '@deepseek-ai/dsh-subprocess-local'\nimport type { Context } from '@deepseek-ai/cordis'\nimport type { SubprocessHandle, SubprocessSpawnSpec, SubprocessTerminalHandle, SubprocessTerminalSpawnSpec } from '@deepseek-ai/dsh-subprocess'\nimport { sharedWorldResolver } from './resolve.js'\n\nexport default class RouterSubprocess extends LocalSubprocessRuntime {\n  private readonly resolver = sharedWorldResolver()\n\n  constructor(ctx: Context) {\n    super(ctx)\n  }\n\n  override spawn(spec: SubprocessSpawnSpec): SubprocessHandle {\n    const ref = this.resolver.resolve(spec.cwd ?? '')\n    if (ref.kind === 'local') return super.spawn(spec)\n    if (ref.kind === 'unrouted') throw new Error(`node ${ref.nodeId} world not available`)\n    void ref.provider.ensureDir(ref.remotePath).catch(() => {})\n    return ref.provider.subprocess.spawn({ ...spec, cwd: ref.remotePath })\n  }\n\n  override async spawnTerminal(spec: SubprocessTerminalSpawnSpec): Promise<SubprocessTerminalHandle> {\n    const ref = this.resolver.resolve(spec.cwd ?? '')\n    if (ref.kind === 'local') return super.spawnTerminal(spec)\n    if (ref.kind === 'unrouted') throw new Error(`node ${ref.nodeId} world not available`)\n    await ref.provider.ensureDir(ref.remotePath).catch(() => {})\n    return ref.provider.subprocess.spawnTerminal({ ...spec, cwd: ref.remotePath })\n  }\n}\n"],"mappings":";;;AAKA,IAAqB,mBAArB,cAA8C,uBAAuB;CACnE,WAA4B,oBAAoB;CAEhD,YAAY,KAAc;EACxB,MAAM,GAAG;CACX;CAEA,MAAe,MAA6C;EAC1D,MAAM,MAAM,KAAK,SAAS,QAAQ,KAAK,OAAO,EAAE;EAChD,IAAI,IAAI,SAAS,SAAS,OAAO,MAAM,MAAM,IAAI;EACjD,IAAI,IAAI,SAAS,YAAY,MAAM,IAAI,MAAM,QAAQ,IAAI,OAAO,qBAAqB;EACrF,IAAS,SAAS,UAAU,IAAI,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC;EAC1D,OAAO,IAAI,SAAS,WAAW,MAAM;GAAE,GAAG;GAAM,KAAK,IAAI;EAAW,CAAC;CACvE;CAEA,MAAe,cAAc,MAAsE;EACjG,MAAM,MAAM,KAAK,SAAS,QAAQ,KAAK,OAAO,EAAE;EAChD,IAAI,IAAI,SAAS,SAAS,OAAO,MAAM,cAAc,IAAI;EACzD,IAAI,IAAI,SAAS,YAAY,MAAM,IAAI,MAAM,QAAQ,IAAI,OAAO,qBAAqB;EACrF,MAAM,IAAI,SAAS,UAAU,IAAI,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC;EAC3D,OAAO,IAAI,SAAS,WAAW,cAAc;GAAE,GAAG;GAAM,KAAK,IAAI;EAAW,CAAC;CAC/E;AACF"}

package/lib/types.d.ts

@@ -0,0 +1,67 @@
+import { FileSystem } from "@deepseek-ai/dsh-fs";
+import { SubprocessHandle, SubprocessRuntime, SubprocessSpawnSpec, SubprocessTerminalHandle, SubprocessTerminalSpawnSpec } from "@deepseek-ai/dsh-subprocess";
+import { ShellExecRequest, ShellExecSpec, ShellProcess, ShellRunResult } from "@deepseek-ai/dsh-shell";
+//#region src/types.d.ts
+interface NodeTestReport {
+  ok: boolean;
+  reachable?: boolean;
+  error?: string;
+}
+interface FsDelegate {
+  resolve(path: string, opts?: {
+    cwd?: string;
+  }): Promise<FsTargetLike>;
+  processPath(target: FsTargetLike): string;
+  fileUrl(target: FsTargetLike): string;
+  contains(parent: FsTargetLike, child: FsTargetLike): boolean;
+  stat(target: FsTargetLike, signal?: AbortSignal): Promise<unknown>;
+  lstat(path: string, opts?: {
+    cwd?: string;
+  }, signal?: AbortSignal): Promise<unknown>;
+  readText(target: FsTargetLike, signal?: AbortSignal): Promise<string>;
+  streamText(target: FsTargetLike, signal?: AbortSignal): Promise<AsyncIterable<string>>;
+  readBytes(target: FsTargetLike, signal: AbortSignal | undefined, maxBytes: number): Promise<Uint8Array>;
+  listDir(target: FsTargetLike, signal?: AbortSignal): Promise<unknown[]>;
+  writeText(target: FsTargetLike, content: string, expected?: unknown, signal?: AbortSignal, policy?: unknown): Promise<unknown>;
+  editText(target: FsTargetLike, edit: unknown, expected?: unknown, signal?: AbortSignal, policy?: unknown): Promise<unknown>;
+}
+type FsTargetLike = string;
+interface SubprocessDelegate {
+  spawn(spec: SubprocessSpawnSpec): SubprocessHandle;
+  spawnTerminal(spec: SubprocessTerminalSpawnSpec): Promise<SubprocessTerminalHandle>;
+}
+interface ShellDelegate {
+  resolve(request: ShellExecRequest): ShellExecSpec;
+  run(spec: ShellExecSpec): Promise<ShellRunResult>;
+  start(spec: ShellExecSpec): ShellProcess;
+}
+interface ExecutionWorldProvider {
+  readonly nodeId: string;
+  readonly fs: FsDelegate;
+  readonly subprocess: SubprocessDelegate;
+  readonly shell: ShellDelegate;
+  ensureDir(remotePath: string): Promise<void>;
+  testConnection(): Promise<NodeTestReport>;
+}
+interface WorkspaceBindings {
+  resolve(mirrorPath: string): {
+    nodeId: string;
+    remotePath: string;
+  } | undefined;
+}
+interface WorldRegistry {
+  get(nodeId: string): ExecutionWorldProvider | undefined;
+}
+type WorldRef = {
+  kind: 'local';
+} | {
+  kind: 'remote';
+  provider: ExecutionWorldProvider;
+  remotePath: string;
+} | {
+  kind: 'unrouted';
+  nodeId: string;
+};
+//#endregion
+export { ExecutionWorldProvider, type FileSystem, FsDelegate, FsTargetLike, NodeTestReport, ShellDelegate, type ShellExecRequest, type ShellExecSpec, type ShellProcess, type ShellRunResult, SubprocessDelegate, type SubprocessHandle, type SubprocessRuntime, type SubprocessSpawnSpec, type SubprocessTerminalHandle, type SubprocessTerminalSpawnSpec, WorkspaceBindings, WorldRef, WorldRegistry };
+//# sourceMappingURL=types.d.ts.map

package/lib/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "dshb-router",
+  "version": "0.0.1",
+  "description": "DSHB 执行世界路由器（ctx.fs / ctx.subprocess / ctx.shell 按镜像路径分流）",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./fs": "./lib/router-fs.js",
+    "./subprocess": "./lib/router-subprocess.js",
+    "./shell": "./lib/router-shell.js",
+    "./resolve": "./lib/resolve.js",
+    "./types": "./lib/types.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "dependencies": {
+    "@deepseek-ai/dsh-fs": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-fs-sandbox": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-subprocess": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-subprocess-local": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-shell": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-bash-sandbox": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-sandbox": "^0.1.1-rc.2"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2"
+  },
+  "types": "lib/index.d.ts",
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit"
+  }
+}