@artenx/dshb 0.1.2 → 0.1.3

package/lib/core/workspace-instruction-context.js

@@ -0,0 +1,3 @@
+import "./workspace-instructions.js";
+import { a as registerWorkspaceInstructionInjector, i as name, n as escapeInstructionFrameBody, o as renderInstructionMessageText, r as inject, s as resolveSnapshotForSession, t as createInstructionMessage } from "../workspace-instruction-context-CxUldQkP.js";
+export { createInstructionMessage, escapeInstructionFrameBody, inject, name, registerWorkspaceInstructionInjector, renderInstructionMessageText, resolveSnapshotForSession };

package/lib/core/workspace-instruction-routes.d.ts

@@ -0,0 +1,7 @@
+import { WorkspaceInstructionStore } from "./workspace-instructions.js";
+import { Context } from "@deepseek-ai/cordis";
+//#region src/core/workspace-instruction-routes.d.ts
+declare function registerWorkspaceInstructionRoutes(ctx: Context, store: WorkspaceInstructionStore): void;
+//#endregion
+export { registerWorkspaceInstructionRoutes };
+//# sourceMappingURL=workspace-instruction-routes.d.ts.map

package/lib/core/workspace-instruction-routes.js

@@ -0,0 +1,155 @@
+import { INSTRUCTION_MAX_BYTES, InstructionConflictError, InstructionSizeError } from "./workspace-instructions.js";
+//#region src/core/workspace-instruction-routes.ts
+const MAX_BODY = 65536;
+function sendJson(res, status, body) {
+	res.writeHead(status, { "content-type": "application/json" });
+	res.end(JSON.stringify(body));
+}
+function readBody(req) {
+	return new Promise((resolve) => {
+		if ((req.headers["content-type"] ?? "") !== "application/json") {
+			resolve(null);
+			return;
+		}
+		const chunks = [];
+		let size = 0;
+		req.on("data", (chunk) => {
+			size += chunk.length;
+			if (size > MAX_BODY) {
+				resolve(null);
+				req.destroy();
+				return;
+			}
+			chunks.push(chunk);
+		});
+		req.on("end", () => {
+			try {
+				resolve(JSON.parse(Buffer.concat(chunks).toString("utf8")));
+			} catch {
+				resolve(null);
+			}
+		});
+		req.on("error", () => resolve(null));
+	});
+}
+function pathSegments(req) {
+	return new URL(req.url ?? "/", "http://x").pathname.split("/").filter(Boolean);
+}
+function registerWorkspaceInstructionRoutes(ctx, store) {
+	const webServer = ctx.webServer;
+	ctx.effect(() => webServer.register({
+		kind: "prefix",
+		path: "/api/dshb/instructions",
+		handler: async (req, res) => {
+			const workspaceId = pathSegments(req)[3];
+			if (!workspaceId) {
+				sendJson(res, 404, {
+					ok: false,
+					error: "not found"
+				});
+				return;
+			}
+			const registry = ctx.get("workspaceRegistry");
+			if (registry) {
+				if (!registry.get(workspaceId)) {
+					sendJson(res, 404, {
+						ok: false,
+						error: "workspace not found"
+					});
+					return;
+				}
+			}
+			if (req.method === "GET") {
+				const record = store.get(workspaceId);
+				if (!record) {
+					sendJson(res, 200, {
+						workspaceId,
+						text: "",
+						revision: 0,
+						updatedAt: null
+					});
+					return;
+				}
+				sendJson(res, 200, {
+					workspaceId: record.workspaceId,
+					text: record.text,
+					revision: record.revision,
+					updatedAt: record.updatedAt
+				});
+				return;
+			}
+			if (req.method === "PUT") {
+				const body = await readBody(req);
+				if (!body || typeof body.text !== "string" || typeof body.expectedRevision !== "number") {
+					sendJson(res, 400, {
+						ok: false,
+						error: "需要 text 和 expectedRevision"
+					});
+					return;
+				}
+				const text = body.text;
+				const expectedRevision = body.expectedRevision;
+				try {
+					if (text.length === 0) {
+						store.clear(workspaceId, expectedRevision);
+						sendJson(res, 200, {
+							workspaceId,
+							text: "",
+							revision: expectedRevision,
+							updatedAt: null
+						});
+						return;
+					}
+					const record = store.update({
+						workspaceId,
+						text,
+						expectedRevision
+					});
+					sendJson(res, 200, {
+						workspaceId: record.workspaceId,
+						text: record.text,
+						revision: record.revision,
+						updatedAt: record.updatedAt
+					});
+					return;
+				} catch (err) {
+					if (err instanceof InstructionConflictError) {
+						const current = store.get(workspaceId);
+						sendJson(res, 409, {
+							ok: false,
+							error: "revision conflict",
+							expected: err.expected,
+							actual: err.actual,
+							currentRevision: current?.revision ?? 0,
+							currentText: current?.text ?? "",
+							currentUpdatedAt: current?.updatedAt ?? null
+						});
+						return;
+					}
+					if (err instanceof InstructionSizeError) {
+						sendJson(res, 400, {
+							ok: false,
+							error: `instruction exceeds ${INSTRUCTION_MAX_BYTES} bytes`,
+							bytes: err.bytes,
+							limit: INSTRUCTION_MAX_BYTES
+						});
+						return;
+					}
+					sendJson(res, 500, {
+						ok: false,
+						error: err instanceof Error ? err.message : String(err)
+					});
+					return;
+				}
+			}
+			sendJson(res, 404, {
+				ok: false,
+				error: "not found"
+			});
+		}
+	}));
+}
+//#endregion
+export { registerWorkspaceInstructionRoutes };
+
+//# sourceMappingURL=workspace-instruction-routes.js.map

package/lib/core/workspace-instruction-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-instruction-routes.js","names":[],"sources":["../../src/core/workspace-instruction-routes.ts"],"sourcesContent":["import type { IncomingMessage, ServerResponse } from 'node:http'\nimport type { Context } from '@deepseek-ai/cordis'\nimport type {} from '@deepseek-ai/dsh-host-webserver'\nimport {\n  InstructionConflictError,\n  InstructionSizeError,\n  INSTRUCTION_MAX_BYTES,\n  type WorkspaceInstructionStore,\n} from './workspace-instructions.js'\n\nconst MAX_BODY = 64 * 1024\n\nfunction sendJson(res: ServerResponse, status: number, body: unknown): void {\n  res.writeHead(status, { 'content-type': 'application/json' })\n  res.end(JSON.stringify(body))\n}\n\nfunction readBody(req: IncomingMessage): Promise<Record<string, unknown> | null> {\n  return new Promise((resolve) => {\n    if ((req.headers['content-type'] ?? '') !== 'application/json') {\n      resolve(null)\n      return\n    }\n    const chunks: Buffer[] = []\n    let size = 0\n    req.on('data', (chunk: Buffer) => {\n      size += chunk.length\n      if (size > MAX_BODY) {\n        resolve(null)\n        req.destroy()\n        return\n      }\n      chunks.push(chunk)\n    })\n    req.on('end', () => {\n      try {\n        resolve(JSON.parse(Buffer.concat(chunks).toString('utf8')) as Record<string, unknown>)\n      } catch {\n        resolve(null)\n      }\n    })\n    req.on('error', () => resolve(null))\n  })\n}\n\nfunction pathSegments(req: IncomingMessage): string[] {\n  return new URL(req.url ?? '/', 'http://x').pathname.split('/').filter(Boolean)\n}\n\ninterface WorkspaceRegistryLike {\n  get(workspaceId: string): { id: string; path: string; title: string } | undefined\n}\n\nexport function registerWorkspaceInstructionRoutes(ctx: Context, store: WorkspaceInstructionStore): void {\n  const webServer = ctx.webServer\n\n  ctx.effect(() =>\n    webServer.register({\n      kind: 'prefix',\n      path: '/api/dshb/instructions',\n      handler: async (req, res) => {\n        const segs = pathSegments(req)\n        const workspaceId = segs[3]\n        if (!workspaceId) {\n          sendJson(res, 404, { ok: false, error: 'not found' })\n          return\n        }\n\n        const registry = ctx.get('workspaceRegistry') as WorkspaceRegistryLike | undefined\n        if (registry) {\n          const ws = registry.get(workspaceId)\n          if (!ws) {\n            sendJson(res, 404, { ok: false, error: 'workspace not found' })\n            return\n          }\n        }\n\n        if (req.method === 'GET') {\n          const record = store.get(workspaceId)\n          if (!record) {\n            sendJson(res, 200, {\n              workspaceId,\n              text: '',\n              revision: 0,\n              updatedAt: null,\n            })\n            return\n          }\n          sendJson(res, 200, {\n            workspaceId: record.workspaceId,\n            text: record.text,\n            revision: record.revision,\n            updatedAt: record.updatedAt,\n          })\n          return\n        }\n\n        if (req.method === 'PUT') {\n          const body = await readBody(req)\n          if (!body || typeof body.text !== 'string' || typeof body.expectedRevision !== 'number') {\n            sendJson(res, 400, { ok: false, error: '需要 text 和 expectedRevision' })\n            return\n          }\n          const text = body.text as string\n          const expectedRevision = body.expectedRevision as number\n          try {\n            if (text.length === 0) {\n              store.clear(workspaceId, expectedRevision)\n              sendJson(res, 200, {\n                workspaceId,\n                text: '',\n                revision: expectedRevision,\n                updatedAt: null,\n              })\n              return\n            }\n            const record = store.update({ workspaceId, text, expectedRevision })\n            sendJson(res, 200, {\n              workspaceId: record.workspaceId,\n              text: record.text,\n              revision: record.revision,\n              updatedAt: record.updatedAt,\n            })\n            return\n          } catch (err) {\n            if (err instanceof InstructionConflictError) {\n              const current = store.get(workspaceId)\n              sendJson(res, 409, {\n                ok: false,\n                error: 'revision conflict',\n                expected: err.expected,\n                actual: err.actual,\n                currentRevision: current?.revision ?? 0,\n                currentText: current?.text ?? '',\n                currentUpdatedAt: current?.updatedAt ?? null,\n              })\n              return\n            }\n            if (err instanceof InstructionSizeError) {\n              sendJson(res, 400, {\n                ok: false,\n                error: `instruction exceeds ${INSTRUCTION_MAX_BYTES} bytes`,\n                bytes: err.bytes,\n                limit: INSTRUCTION_MAX_BYTES,\n              })\n              return\n            }\n            sendJson(res, 500, { ok: false, error: err instanceof Error ? err.message : String(err) })\n            return\n          }\n        }\n\n        sendJson(res, 404, { ok: false, error: 'not found' })\n      },\n    }),\n  )\n}\n"],"mappings":"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"}

package/lib/core/workspace-instructions.d.ts

@@ -0,0 +1,68 @@
+//#region src/core/workspace-instructions.d.ts
+declare const INSTRUCTION_MAX_BYTES = 32768;
+interface WorkspaceInstructionRecord {
+  workspaceId: string;
+  text: string;
+  revision: number;
+  digest: string;
+  createdAt: string;
+  updatedAt: string;
+}
+interface SessionInstructionSnapshot {
+  sessionId: string;
+  workspaceId?: string;
+  workspaceRevision?: number;
+  digest?: string;
+  text: string;
+  capturedAt: string;
+  inheritedFromSessionId?: string;
+}
+declare class InstructionConflictError extends Error {
+  readonly expected: number;
+  readonly actual: number;
+  constructor(expected: number, actual: number);
+}
+declare class InstructionSizeError extends Error {
+  readonly bytes: number;
+  constructor(bytes: number);
+}
+declare class WorkspaceInstructionStore {
+  private data;
+  private loaded;
+  private file;
+  private load;
+  private save;
+  get(workspaceId: string): WorkspaceInstructionRecord | undefined;
+  update(input: {
+    workspaceId: string;
+    text: string;
+    expectedRevision: number;
+  }): WorkspaceInstructionRecord;
+  clear(workspaceId: string, expectedRevision: number): void;
+  removeByWorkspace(workspaceId: string): void;
+}
+declare class SessionInstructionSnapshotStore {
+  private data;
+  private loaded;
+  private file;
+  private load;
+  private save;
+  get(sessionId: string): SessionInstructionSnapshot | undefined;
+  createIfAbsent(sessionId: string, source: {
+    kind: 'workspace';
+    record: WorkspaceInstructionRecord;
+    workspaceId: string;
+  } | {
+    kind: 'empty';
+    workspaceId?: string;
+  } | {
+    kind: 'inherit';
+    parentSnapshot: SessionInstructionSnapshot;
+  }): SessionInstructionSnapshot;
+  remove(sessionId: string): void;
+}
+declare function sharedWorkspaceInstructionStore(): WorkspaceInstructionStore;
+declare function sharedSessionInstructionSnapshotStore(): SessionInstructionSnapshotStore;
+//#endregion
+export { INSTRUCTION_MAX_BYTES, InstructionConflictError, InstructionSizeError, SessionInstructionSnapshot, SessionInstructionSnapshotStore, WorkspaceInstructionRecord, WorkspaceInstructionStore, sharedSessionInstructionSnapshotStore, sharedWorkspaceInstructionStore };
+//# sourceMappingURL=workspace-instructions.d.ts.map

package/lib/core/workspace-instructions.js

@@ -0,0 +1,191 @@
+import { homedir } from "node:os";
+import { chmodSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { createHash } from "node:crypto";
+//#region src/core/workspace-instructions.ts
+const INSTRUCTION_MAX_BYTES = 32768;
+var InstructionConflictError = class extends Error {
+	expected;
+	actual;
+	constructor(expected, actual) {
+		super(`revision conflict: expected ${expected}, current ${actual}`);
+		this.name = "InstructionConflictError";
+		this.expected = expected;
+		this.actual = actual;
+	}
+};
+var InstructionSizeError = class extends Error {
+	bytes;
+	constructor(bytes) {
+		super(`instruction exceeds ${INSTRUCTION_MAX_BYTES} bytes (got ${bytes})`);
+		this.name = "InstructionSizeError";
+		this.bytes = bytes;
+	}
+};
+function dshHome() {
+	return process.env.DSH_HOME ?? join(homedir(), ".dsh");
+}
+function utf8Bytes(text) {
+	return Buffer.byteLength(text, "utf8");
+}
+function computeDigest(text) {
+	return createHash("sha256").update(text, "utf8").digest("hex");
+}
+var WorkspaceInstructionStore = class {
+	data = { records: {} };
+	loaded = false;
+	file() {
+		return join(dshHome(), "dshb", "workspace-instructions.json");
+	}
+	load() {
+		if (this.loaded) return;
+		this.loaded = true;
+		try {
+			const raw = readFileSync(this.file(), "utf8");
+			this.data = JSON.parse(raw);
+			if (!this.data.records || typeof this.data.records !== "object") this.data = { records: {} };
+		} catch {
+			this.data = { records: {} };
+		}
+	}
+	save() {
+		this.load();
+		const file = this.file();
+		mkdirSync(join(file, ".."), {
+			recursive: true,
+			mode: 448
+		});
+		const tmp = `${file}.${process.pid}.tmp`;
+		writeFileSync(tmp, JSON.stringify(this.data, null, 2), { mode: 384 });
+		renameSync(tmp, file);
+		chmodSync(file, 384);
+	}
+	get(workspaceId) {
+		this.load();
+		const r = this.data.records[workspaceId];
+		return r ? { ...r } : void 0;
+	}
+	update(input) {
+		this.load();
+		const bytes = utf8Bytes(input.text);
+		if (bytes > 32768) throw new InstructionSizeError(bytes);
+		const existing = this.data.records[input.workspaceId];
+		if (existing && existing.revision !== input.expectedRevision) throw new InstructionConflictError(input.expectedRevision, existing.revision);
+		const now = (/* @__PURE__ */ new Date()).toISOString();
+		const record = {
+			workspaceId: input.workspaceId,
+			text: input.text,
+			revision: (existing?.revision ?? 0) + 1,
+			digest: computeDigest(input.text),
+			createdAt: existing?.createdAt ?? now,
+			updatedAt: now
+		};
+		this.data.records[input.workspaceId] = record;
+		this.save();
+		return { ...record };
+	}
+	clear(workspaceId, expectedRevision) {
+		this.load();
+		const existing = this.data.records[workspaceId];
+		if (existing && existing.revision !== expectedRevision) throw new InstructionConflictError(expectedRevision, existing.revision);
+		if (!existing) return;
+		delete this.data.records[workspaceId];
+		this.save();
+	}
+	removeByWorkspace(workspaceId) {
+		this.load();
+		if (!this.data.records[workspaceId]) return;
+		delete this.data.records[workspaceId];
+		this.save();
+	}
+};
+var SessionInstructionSnapshotStore = class {
+	data = { records: {} };
+	loaded = false;
+	file() {
+		return join(dshHome(), "dshb", "session-instruction-snapshots.json");
+	}
+	load() {
+		if (this.loaded) return;
+		this.loaded = true;
+		try {
+			const raw = readFileSync(this.file(), "utf8");
+			this.data = JSON.parse(raw);
+			if (!this.data.records || typeof this.data.records !== "object") this.data = { records: {} };
+		} catch {
+			this.data = { records: {} };
+		}
+	}
+	save() {
+		this.load();
+		const file = this.file();
+		mkdirSync(join(file, ".."), {
+			recursive: true,
+			mode: 448
+		});
+		const tmp = `${file}.${process.pid}.tmp`;
+		writeFileSync(tmp, JSON.stringify(this.data, null, 2), { mode: 384 });
+		renameSync(tmp, file);
+		chmodSync(file, 384);
+	}
+	get(sessionId) {
+		this.load();
+		const r = this.data.records[sessionId];
+		return r ? { ...r } : void 0;
+	}
+	createIfAbsent(sessionId, source) {
+		this.load();
+		const existing = this.data.records[sessionId];
+		if (existing) return { ...existing };
+		let snapshot;
+		const now = (/* @__PURE__ */ new Date()).toISOString();
+		if (source.kind === "workspace") snapshot = {
+			sessionId,
+			workspaceId: source.workspaceId,
+			workspaceRevision: source.record.revision,
+			digest: source.record.digest,
+			text: source.record.text,
+			capturedAt: now
+		};
+		else if (source.kind === "inherit") {
+			const parent = source.parentSnapshot;
+			snapshot = {
+				sessionId,
+				workspaceId: parent.workspaceId,
+				workspaceRevision: parent.workspaceRevision,
+				digest: parent.digest,
+				text: parent.text,
+				capturedAt: now,
+				inheritedFromSessionId: parent.sessionId
+			};
+		} else snapshot = {
+			sessionId,
+			workspaceId: source.workspaceId,
+			text: "",
+			capturedAt: now
+		};
+		this.data.records[sessionId] = snapshot;
+		this.save();
+		return { ...snapshot };
+	}
+	remove(sessionId) {
+		this.load();
+		if (!this.data.records[sessionId]) return;
+		delete this.data.records[sessionId];
+		this.save();
+	}
+};
+let sharedWorkspaceStore = null;
+let sharedSnapshotStore = null;
+function sharedWorkspaceInstructionStore() {
+	if (!sharedWorkspaceStore) sharedWorkspaceStore = new WorkspaceInstructionStore();
+	return sharedWorkspaceStore;
+}
+function sharedSessionInstructionSnapshotStore() {
+	if (!sharedSnapshotStore) sharedSnapshotStore = new SessionInstructionSnapshotStore();
+	return sharedSnapshotStore;
+}
+//#endregion
+export { INSTRUCTION_MAX_BYTES, InstructionConflictError, InstructionSizeError, SessionInstructionSnapshotStore, WorkspaceInstructionStore, sharedSessionInstructionSnapshotStore, sharedWorkspaceInstructionStore };
+
+//# sourceMappingURL=workspace-instructions.js.map

package/lib/core/workspace-instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-instructions.js","names":[],"sources":["../../src/core/workspace-instructions.ts"],"sourcesContent":["import { createHash } from 'node:crypto'\nimport { chmodSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs'\nimport { homedir } from 'node:os'\nimport { join } from 'node:path'\n\nexport const INSTRUCTION_MAX_BYTES = 32768\n\nexport interface WorkspaceInstructionRecord {\n  workspaceId: string\n  text: string\n  revision: number\n  digest: string\n  createdAt: string\n  updatedAt: string\n}\n\nexport interface SessionInstructionSnapshot {\n  sessionId: string\n  workspaceId?: string\n  workspaceRevision?: number\n  digest?: string\n  text: string\n  capturedAt: string\n  inheritedFromSessionId?: string\n}\n\nexport class InstructionConflictError extends Error {\n  readonly expected: number\n  readonly actual: number\n  constructor(expected: number, actual: number) {\n    super(`revision conflict: expected ${expected}, current ${actual}`)\n    this.name = 'InstructionConflictError'\n    this.expected = expected\n    this.actual = actual\n  }\n}\n\nexport class InstructionSizeError extends Error {\n  readonly bytes: number\n  constructor(bytes: number) {\n    super(`instruction exceeds ${INSTRUCTION_MAX_BYTES} bytes (got ${bytes})`)\n    this.name = 'InstructionSizeError'\n    this.bytes = bytes\n  }\n}\n\nfunction dshHome(): string {\n  return process.env.DSH_HOME ?? join(homedir(), '.dsh')\n}\n\nfunction utf8Bytes(text: string): number {\n  return Buffer.byteLength(text, 'utf8')\n}\n\nfunction computeDigest(text: string): string {\n  return createHash('sha256').update(text, 'utf8').digest('hex')\n}\n\ninterface WorkspaceStoreData {\n  records: Record<string, WorkspaceInstructionRecord>\n}\n\ninterface SnapshotStoreData {\n  records: Record<string, SessionInstructionSnapshot>\n}\n\nexport class WorkspaceInstructionStore {\n  private data: WorkspaceStoreData = { records: {} }\n  private loaded = false\n\n  private file(): string {\n    return join(dshHome(), 'dshb', 'workspace-instructions.json')\n  }\n\n  private load(): void {\n    if (this.loaded) return\n    this.loaded = true\n    try {\n      const raw = readFileSync(this.file(), 'utf8')\n      this.data = JSON.parse(raw) as WorkspaceStoreData\n      if (!this.data.records || typeof this.data.records !== 'object') {\n        this.data = { records: {} }\n      }\n    } catch {\n      this.data = { records: {} }\n    }\n  }\n\n  private save(): void {\n    this.load()\n    const file = this.file()\n    mkdirSync(join(file, '..'), { recursive: true, mode: 0o700 })\n    const tmp = `${file}.${process.pid}.tmp`\n    writeFileSync(tmp, JSON.stringify(this.data, null, 2), { mode: 0o600 })\n    renameSync(tmp, file)\n    chmodSync(file, 0o600)\n  }\n\n  get(workspaceId: string): WorkspaceInstructionRecord | undefined {\n    this.load()\n    const r = this.data.records[workspaceId]\n    return r ? { ...r } : undefined\n  }\n\n  update(input: {\n    workspaceId: string\n    text: string\n    expectedRevision: number\n  }): WorkspaceInstructionRecord {\n    this.load()\n    const bytes = utf8Bytes(input.text)\n    if (bytes > INSTRUCTION_MAX_BYTES) throw new InstructionSizeError(bytes)\n    const existing = this.data.records[input.workspaceId]\n    if (existing && existing.revision !== input.expectedRevision) {\n      throw new InstructionConflictError(input.expectedRevision, existing.revision)\n    }\n    const now = new Date().toISOString()\n    const record: WorkspaceInstructionRecord = {\n      workspaceId: input.workspaceId,\n      text: input.text,\n      revision: (existing?.revision ?? 0) + 1,\n      digest: computeDigest(input.text),\n      createdAt: existing?.createdAt ?? now,\n      updatedAt: now,\n    }\n    this.data.records[input.workspaceId] = record\n    this.save()\n    return { ...record }\n  }\n\n  clear(workspaceId: string, expectedRevision: number): void {\n    this.load()\n    const existing = this.data.records[workspaceId]\n    if (existing && existing.revision !== expectedRevision) {\n      throw new InstructionConflictError(expectedRevision, existing.revision)\n    }\n    if (!existing) return\n    delete this.data.records[workspaceId]\n    this.save()\n  }\n\n  removeByWorkspace(workspaceId: string): void {\n    this.load()\n    if (!this.data.records[workspaceId]) return\n    delete this.data.records[workspaceId]\n    this.save()\n  }\n}\n\nexport class SessionInstructionSnapshotStore {\n  private data: SnapshotStoreData = { records: {} }\n  private loaded = false\n\n  private file(): string {\n    return join(dshHome(), 'dshb', 'session-instruction-snapshots.json')\n  }\n\n  private load(): void {\n    if (this.loaded) return\n    this.loaded = true\n    try {\n      const raw = readFileSync(this.file(), 'utf8')\n      this.data = JSON.parse(raw) as SnapshotStoreData\n      if (!this.data.records || typeof this.data.records !== 'object') {\n        this.data = { records: {} }\n      }\n    } catch {\n      this.data = { records: {} }\n    }\n  }\n\n  private save(): void {\n    this.load()\n    const file = this.file()\n    mkdirSync(join(file, '..'), { recursive: true, mode: 0o700 })\n    const tmp = `${file}.${process.pid}.tmp`\n    writeFileSync(tmp, JSON.stringify(this.data, null, 2), { mode: 0o600 })\n    renameSync(tmp, file)\n    chmodSync(file, 0o600)\n  }\n\n  get(sessionId: string): SessionInstructionSnapshot | undefined {\n    this.load()\n    const r = this.data.records[sessionId]\n    return r ? { ...r } : undefined\n  }\n\n  createIfAbsent(\n    sessionId: string,\n    source:\n      | { kind: 'workspace'; record: WorkspaceInstructionRecord; workspaceId: string }\n      | { kind: 'empty'; workspaceId?: string }\n      | { kind: 'inherit'; parentSnapshot: SessionInstructionSnapshot },\n  ): SessionInstructionSnapshot {\n    this.load()\n    const existing = this.data.records[sessionId]\n    if (existing) return { ...existing }\n    let snapshot: SessionInstructionSnapshot\n    const now = new Date().toISOString()\n    if (source.kind === 'workspace') {\n      snapshot = {\n        sessionId,\n        workspaceId: source.workspaceId,\n        workspaceRevision: source.record.revision,\n        digest: source.record.digest,\n        text: source.record.text,\n        capturedAt: now,\n      }\n    } else if (source.kind === 'inherit') {\n      const parent = source.parentSnapshot\n      snapshot = {\n        sessionId,\n        workspaceId: parent.workspaceId,\n        workspaceRevision: parent.workspaceRevision,\n        digest: parent.digest,\n        text: parent.text,\n        capturedAt: now,\n        inheritedFromSessionId: parent.sessionId,\n      }\n    } else {\n      snapshot = {\n        sessionId,\n        workspaceId: source.workspaceId,\n        text: '',\n        capturedAt: now,\n      }\n    }\n    this.data.records[sessionId] = snapshot\n    this.save()\n    return { ...snapshot }\n  }\n\n  remove(sessionId: string): void {\n    this.load()\n    if (!this.data.records[sessionId]) return\n    delete this.data.records[sessionId]\n    this.save()\n  }\n}\n\nlet sharedWorkspaceStore: WorkspaceInstructionStore | null = null\nlet sharedSnapshotStore: SessionInstructionSnapshotStore | null = null\n\nexport function sharedWorkspaceInstructionStore(): WorkspaceInstructionStore {\n  if (!sharedWorkspaceStore) sharedWorkspaceStore = new WorkspaceInstructionStore()\n  return sharedWorkspaceStore\n}\n\nexport function sharedSessionInstructionSnapshotStore(): SessionInstructionSnapshotStore {\n  if (!sharedSnapshotStore) sharedSnapshotStore = new SessionInstructionSnapshotStore()\n  return sharedSnapshotStore\n}\n"],"mappings":"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"}

package/lib/router/router-fs.d.ts

@@ -1,5 +1,5 @@
-import SandboxedFileSystem from "@deepseek-ai/dsh-fs-sandbox";
 import { Context } from "@deepseek-ai/cordis";
+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/router-fs.d.ts

package/lib/router/router-shell.d.ts

@@ -1,5 +1,5 @@
-import SandboxBashExecutor from "@deepseek-ai/dsh-bash-sandbox";
 import { Context } from "@deepseek-ai/cordis";
+import SandboxBashExecutor from "@deepseek-ai/dsh-bash-sandbox";
 import { ShellExecRequest, ShellExecSpec, ShellProcess, ShellRunResult } from "@deepseek-ai/dsh-shell";
 //#region src/router/router-shell.d.ts
 declare class RouterShell extends SandboxBashExecutor {

package/lib/router/router-subprocess.d.ts

@@ -1,5 +1,5 @@
-import LocalSubprocessRuntime from "@deepseek-ai/dsh-subprocess-local";
 import { Context } from "@deepseek-ai/cordis";
+import LocalSubprocessRuntime from "@deepseek-ai/dsh-subprocess-local";
 import { SubprocessHandle, SubprocessSpawnSpec, SubprocessTerminalHandle, SubprocessTerminalSpawnSpec } from "@deepseek-ai/dsh-subprocess";
 //#region src/router/router-subprocess.d.ts
 declare class RouterSubprocess extends LocalSubprocessRuntime {

package/lib/ui/picker.d.ts

@@ -1,5 +1,5 @@
-import DirectoryPicker, { DirectoryPickerBrowseCapability } from "@deepseek-ai/dsh-host-directory-picker";
 import { Context } from "@deepseek-ai/cordis";
+import DirectoryPicker, { DirectoryPickerBrowseCapability } from "@deepseek-ai/dsh-host-directory-picker";
 //#region src/ui/picker.d.ts
 declare class DshbDirectoryPicker extends DirectoryPicker {
   constructor(ctx: Context);