@adhdev/session-host-core 0.7.12

package/dist/index.mjs

@@ -0,0 +1,475 @@
+// src/buffer.ts
+var SessionRingBuffer = class {
+  maxBytes;
+  chunks = [];
+  nextSeq = 1;
+  totalBytes = 0;
+  constructor(options = {}) {
+    this.maxBytes = options.maxBytes ?? 512 * 1024;
+  }
+  append(data) {
+    const normalized = typeof data === "string" ? data : String(data ?? "");
+    const bytes = Buffer.byteLength(normalized, "utf8");
+    const seq = this.nextSeq++;
+    this.chunks.push({ seq, data: normalized, bytes });
+    this.totalBytes += bytes;
+    this.trim();
+    return seq;
+  }
+  snapshot(sinceSeq) {
+    const relevant = typeof sinceSeq === "number" ? this.chunks.filter((chunk) => chunk.seq > sinceSeq) : this.chunks;
+    const text = relevant.map((chunk) => chunk.data).join("");
+    const truncated = !!this.chunks[0] && typeof sinceSeq === "number" && sinceSeq < this.chunks[0].seq - 1;
+    return {
+      seq: this.nextSeq - 1,
+      text,
+      truncated
+    };
+  }
+  getState() {
+    return {
+      scrollbackBytes: this.totalBytes,
+      snapshotSeq: this.nextSeq - 1
+    };
+  }
+  clear() {
+    this.chunks = [];
+    this.totalBytes = 0;
+    this.nextSeq = 1;
+  }
+  restore(snapshot) {
+    this.clear();
+    const text = String(snapshot.text || "");
+    if (!text) {
+      this.nextSeq = Math.max(1, Number(snapshot.seq || 0) + 1);
+      return;
+    }
+    const bytes = Buffer.byteLength(text, "utf8");
+    const seq = Math.max(1, Number(snapshot.seq || 1));
+    this.chunks = [{ seq, data: text, bytes }];
+    this.totalBytes = bytes;
+    this.nextSeq = seq + 1;
+    this.trim();
+  }
+  trim() {
+    while (this.totalBytes > this.maxBytes && this.chunks.length > 1) {
+      const removed = this.chunks.shift();
+      if (!removed) break;
+      this.totalBytes -= removed.bytes;
+    }
+  }
+};
+
+// src/registry.ts
+import { randomUUID } from "crypto";
+
+// src/runtime-labels.ts
+import * as path from "path";
+function normalizeSlug(input) {
+  return input.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 48);
+}
+function normalizeValue(input) {
+  return input.trim().toLowerCase();
+}
+function getWorkspaceLabel(workspace) {
+  const trimmed = workspace.trim();
+  if (!trimmed) return "workspace";
+  const normalized = trimmed.replace(/[\\/]+$/, "");
+  const base = path.basename(normalized);
+  return base || normalized;
+}
+function buildRuntimeDisplayName(payload) {
+  const explicit = payload.displayName?.trim();
+  if (explicit) return explicit;
+  const workspaceLabel = getWorkspaceLabel(payload.workspace);
+  const providerLabel = payload.providerType.trim() || "runtime";
+  return `${providerLabel} @ ${workspaceLabel}`;
+}
+function buildRuntimeKey(payload, existingKeys) {
+  const requested = payload.runtimeKey?.trim();
+  const existing = new Set(Array.from(existingKeys, (key) => key.toLowerCase()));
+  const displayName = buildRuntimeDisplayName(payload);
+  const baseKey = normalizeSlug(requested || displayName || getWorkspaceLabel(payload.workspace) || payload.providerType || "runtime") || "runtime";
+  if (!existing.has(baseKey)) return baseKey;
+  let suffix = 2;
+  let candidate = `${baseKey}-${suffix}`;
+  while (existing.has(candidate)) {
+    suffix += 1;
+    candidate = `${baseKey}-${suffix}`;
+  }
+  return candidate;
+}
+function uniqueMatch(records, predicate) {
+  const matches = records.filter(predicate);
+  if (matches.length === 1) return matches[0] || null;
+  if (matches.length === 0) return null;
+  const labels = matches.map((record) => `${record.runtimeKey} (${record.sessionId})`).join(", ");
+  throw new Error(`Ambiguous runtime target. Matches: ${labels}`);
+}
+function resolveRuntimeRecord(records, identifier) {
+  const target = identifier.trim();
+  if (!target) {
+    throw new Error("Runtime target is required");
+  }
+  const exact = uniqueMatch(
+    records,
+    (record) => record.sessionId === target || normalizeValue(record.runtimeKey) === normalizeValue(target) || normalizeValue(record.displayName) === normalizeValue(target)
+  );
+  if (exact) return exact;
+  const prefix = uniqueMatch(
+    records,
+    (record) => record.sessionId.startsWith(target) || normalizeValue(record.runtimeKey).startsWith(normalizeValue(target))
+  );
+  if (prefix) return prefix;
+  throw new Error(`Unknown runtime target: ${target}`);
+}
+function formatRuntimeOwner(record) {
+  if (!record.writeOwner) return "none";
+  return `${record.writeOwner.ownerType}:${record.writeOwner.clientId}`;
+}
+
+// src/registry.ts
+var SessionHostRegistry = class {
+  sessions = /* @__PURE__ */ new Map();
+  createSession(payload) {
+    const sessionId = payload.sessionId || randomUUID();
+    if (this.sessions.has(sessionId)) {
+      throw new Error(`Session already exists: ${sessionId}`);
+    }
+    const now = Date.now();
+    const initialClient = payload.clientId ? [{
+      clientId: payload.clientId,
+      type: payload.clientType || "daemon",
+      readOnly: false,
+      attachedAt: now,
+      lastSeenAt: now
+    }] : [];
+    const record = {
+      sessionId,
+      runtimeKey: buildRuntimeKey(
+        payload,
+        Array.from(this.sessions.values(), (state) => state.record.runtimeKey)
+      ),
+      displayName: buildRuntimeDisplayName(payload),
+      workspaceLabel: getWorkspaceLabel(payload.workspace),
+      transport: "pty",
+      providerType: payload.providerType,
+      category: payload.category,
+      workspace: payload.workspace,
+      launchCommand: payload.launchCommand,
+      createdAt: now,
+      lastActivityAt: now,
+      lifecycle: "starting",
+      writeOwner: null,
+      attachedClients: initialClient,
+      buffer: {
+        scrollbackBytes: 0,
+        snapshotSeq: 0
+      },
+      meta: payload.meta || {}
+    };
+    record.meta = {
+      sessionHostCols: payload.cols || 120,
+      sessionHostRows: payload.rows || 40,
+      ...record.meta
+    };
+    this.sessions.set(sessionId, {
+      record,
+      buffer: new SessionRingBuffer()
+    });
+    return this.cloneRecord(record);
+  }
+  restoreSession(record, snapshot) {
+    const cloned = this.cloneRecord(record);
+    this.sessions.set(cloned.sessionId, {
+      record: cloned,
+      buffer: (() => {
+        const buffer = new SessionRingBuffer();
+        if (snapshot) buffer.restore(snapshot);
+        return buffer;
+      })()
+    });
+    return this.cloneRecord(cloned);
+  }
+  listSessions() {
+    return Array.from(this.sessions.values()).map((state) => this.cloneRecord(state.record)).sort((a, b) => b.lastActivityAt - a.lastActivityAt);
+  }
+  getSession(sessionId) {
+    const state = this.sessions.get(sessionId);
+    return state ? this.cloneRecord(state.record) : null;
+  }
+  attachClient(payload) {
+    const state = this.requireSession(payload.sessionId);
+    const now = Date.now();
+    let removedDaemonOwner = false;
+    if (payload.clientType === "daemon") {
+      const staleDaemonClientIds = state.record.attachedClients.filter((client) => client.type === "daemon" && client.clientId !== payload.clientId).map((client) => client.clientId);
+      if (staleDaemonClientIds.length > 0) {
+        state.record.attachedClients = state.record.attachedClients.filter(
+          (client) => !(client.type === "daemon" && client.clientId !== payload.clientId)
+        );
+        if (state.record.writeOwner && staleDaemonClientIds.includes(state.record.writeOwner.clientId)) {
+          removedDaemonOwner = true;
+        }
+      }
+    }
+    const existing = state.record.attachedClients.find((client) => client.clientId === payload.clientId);
+    if (existing) {
+      existing.type = payload.clientType;
+      existing.readOnly = !!payload.readOnly;
+      existing.lastSeenAt = now;
+    } else {
+      state.record.attachedClients.push({
+        clientId: payload.clientId,
+        type: payload.clientType,
+        readOnly: !!payload.readOnly,
+        attachedAt: now,
+        lastSeenAt: now
+      });
+    }
+    if (removedDaemonOwner) {
+      state.record.writeOwner = null;
+    }
+    state.record.lastActivityAt = now;
+    return this.cloneRecord(state.record);
+  }
+  detachClient(payload) {
+    const state = this.requireSession(payload.sessionId);
+    state.record.attachedClients = state.record.attachedClients.filter((client) => client.clientId !== payload.clientId);
+    if (state.record.writeOwner?.clientId === payload.clientId) {
+      state.record.writeOwner = null;
+    }
+    state.record.lastActivityAt = Date.now();
+    return this.cloneRecord(state.record);
+  }
+  acquireWrite(payload) {
+    const state = this.requireSession(payload.sessionId);
+    if (state.record.writeOwner && state.record.writeOwner.clientId !== payload.clientId && !payload.force) {
+      throw new Error(`Write owned by ${state.record.writeOwner.clientId}`);
+    }
+    const attachedClient = state.record.attachedClients.find((client) => client.clientId === payload.clientId);
+    if (attachedClient) {
+      attachedClient.readOnly = false;
+      attachedClient.lastSeenAt = Date.now();
+    }
+    state.record.writeOwner = {
+      clientId: payload.clientId,
+      ownerType: payload.ownerType,
+      acquiredAt: Date.now()
+    };
+    state.record.lastActivityAt = Date.now();
+    return this.cloneRecord(state.record);
+  }
+  releaseWrite(payload) {
+    const state = this.requireSession(payload.sessionId);
+    const attachedClient = state.record.attachedClients.find((client) => client.clientId === payload.clientId);
+    if (attachedClient) {
+      attachedClient.readOnly = false;
+      attachedClient.lastSeenAt = Date.now();
+    }
+    if (state.record.writeOwner?.clientId === payload.clientId) {
+      state.record.writeOwner = null;
+    }
+    state.record.lastActivityAt = Date.now();
+    return this.cloneRecord(state.record);
+  }
+  appendOutput(sessionId, data) {
+    const state = this.requireSession(sessionId);
+    const seq = state.buffer.append(data);
+    state.record.buffer = state.buffer.getState();
+    state.record.lastActivityAt = Date.now();
+    return { record: this.cloneRecord(state.record), seq };
+  }
+  getSnapshot(sessionId, sinceSeq) {
+    const state = this.requireSession(sessionId);
+    state.record.buffer = state.buffer.getState();
+    return state.buffer.snapshot(sinceSeq);
+  }
+  clearBuffer(sessionId) {
+    const state = this.requireSession(sessionId);
+    state.buffer.clear();
+    state.record.buffer = state.buffer.getState();
+    state.record.lastActivityAt = Date.now();
+    return this.cloneRecord(state.record);
+  }
+  markStarted(sessionId, pid) {
+    const state = this.requireSession(sessionId);
+    state.record.lifecycle = "running";
+    state.record.startedAt = state.record.startedAt || Date.now();
+    if (typeof pid === "number") state.record.osPid = pid;
+    state.record.lastActivityAt = Date.now();
+    return this.cloneRecord(state.record);
+  }
+  markStopped(sessionId, lifecycle = "stopped") {
+    const state = this.requireSession(sessionId);
+    state.record.lifecycle = lifecycle;
+    state.record.lastActivityAt = Date.now();
+    return this.cloneRecord(state.record);
+  }
+  setLifecycle(sessionId, lifecycle) {
+    const state = this.requireSession(sessionId);
+    state.record.lifecycle = lifecycle;
+    state.record.lastActivityAt = Date.now();
+    return this.cloneRecord(state.record);
+  }
+  requireSession(sessionId) {
+    const state = this.sessions.get(sessionId);
+    if (!state) throw new Error(`Unknown session: ${sessionId}`);
+    return state;
+  }
+  cloneRecord(record) {
+    return {
+      ...record,
+      launchCommand: {
+        ...record.launchCommand,
+        args: [...record.launchCommand.args],
+        env: record.launchCommand.env ? { ...record.launchCommand.env } : void 0
+      },
+      writeOwner: record.writeOwner ? { ...record.writeOwner } : null,
+      attachedClients: record.attachedClients.map((client) => ({ ...client })),
+      buffer: { ...record.buffer },
+      meta: { ...record.meta }
+    };
+  }
+};
+
+// src/ipc.ts
+import * as os from "os";
+import * as path2 from "path";
+import * as net from "net";
+import { randomUUID as randomUUID2 } from "crypto";
+function getDefaultSessionHostEndpoint(appName = "adhdev") {
+  if (process.platform === "win32") {
+    return {
+      kind: "pipe",
+      path: `\\\\.\\pipe\\${appName}-session-host`
+    };
+  }
+  return {
+    kind: "unix",
+    path: path2.join(os.tmpdir(), `${appName}-session-host.sock`)
+  };
+}
+function serializeEnvelope(envelope) {
+  return `${JSON.stringify(envelope)}
+`;
+}
+function createLineParser(onEnvelope) {
+  let buffer = "";
+  return (chunk) => {
+    buffer += chunk.toString();
+    let newlineIndex = buffer.indexOf("\n");
+    while (newlineIndex >= 0) {
+      const rawLine = buffer.slice(0, newlineIndex).trim();
+      buffer = buffer.slice(newlineIndex + 1);
+      if (rawLine) {
+        onEnvelope(JSON.parse(rawLine));
+      }
+      newlineIndex = buffer.indexOf("\n");
+    }
+  };
+}
+var SessionHostClient = class {
+  endpoint;
+  socket = null;
+  requestWaiters = /* @__PURE__ */ new Map();
+  eventListeners = /* @__PURE__ */ new Set();
+  constructor(options = {}) {
+    this.endpoint = options.endpoint || getDefaultSessionHostEndpoint(options.appName || "adhdev");
+  }
+  async connect() {
+    if (this.socket && !this.socket.destroyed) return;
+    const socket = net.createConnection(this.endpoint.path);
+    this.socket = socket;
+    socket.on("data", createLineParser((envelope) => {
+      if (envelope.kind === "response") {
+        const waiter = this.requestWaiters.get(envelope.requestId);
+        if (waiter) {
+          this.requestWaiters.delete(envelope.requestId);
+          waiter.resolve(envelope.response);
+        }
+        return;
+      }
+      if (envelope.kind === "event") {
+        for (const listener of this.eventListeners) listener(envelope.event);
+      }
+    }));
+    socket.on("error", (error) => {
+      for (const waiter of this.requestWaiters.values()) {
+        waiter.reject(error);
+      }
+      this.requestWaiters.clear();
+    });
+    await new Promise((resolve, reject) => {
+      socket.once("connect", () => resolve());
+      socket.once("error", reject);
+    });
+  }
+  onEvent(listener) {
+    this.eventListeners.add(listener);
+    return () => {
+      this.eventListeners.delete(listener);
+    };
+  }
+  async request(request) {
+    await this.connect();
+    if (!this.socket) throw new Error("Session host socket unavailable");
+    const requestId = randomUUID2();
+    const envelope = {
+      kind: "request",
+      requestId,
+      request
+    };
+    const response = await new Promise((resolve, reject) => {
+      this.requestWaiters.set(requestId, { resolve, reject });
+      this.socket?.write(serializeEnvelope(envelope));
+    });
+    return response;
+  }
+  async close() {
+    if (!this.socket) return;
+    const socket = this.socket;
+    this.socket = null;
+    for (const waiter of this.requestWaiters.values()) {
+      waiter.reject(new Error("Session host client closed"));
+    }
+    this.requestWaiters.clear();
+    await new Promise((resolve) => {
+      let settled = false;
+      const done = () => {
+        if (settled) return;
+        settled = true;
+        resolve();
+      };
+      socket.once("close", done);
+      socket.end();
+      socket.destroy();
+      setTimeout(done, 50);
+    });
+  }
+};
+function createResponseEnvelope(requestId, response) {
+  return {
+    kind: "response",
+    requestId,
+    response
+  };
+}
+function writeEnvelope(socket, envelope) {
+  socket.write(serializeEnvelope(envelope));
+}
+export {
+  SessionHostClient,
+  SessionHostRegistry,
+  SessionRingBuffer,
+  buildRuntimeDisplayName,
+  buildRuntimeKey,
+  createLineParser,
+  createResponseEnvelope,
+  formatRuntimeOwner,
+  getDefaultSessionHostEndpoint,
+  getWorkspaceLabel,
+  resolveRuntimeRecord,
+  writeEnvelope
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/buffer.ts","../src/registry.ts","../src/runtime-labels.ts","../src/ipc.ts"],"sourcesContent":["import type { SessionBufferSnapshot } from './types.js';\n\nexport interface SessionRingBufferOptions {\n  maxBytes?: number;\n}\n\nexport class SessionRingBuffer {\n  private maxBytes: number;\n  private chunks: { seq: number; data: string; bytes: number }[] = [];\n  private nextSeq = 1;\n  private totalBytes = 0;\n\n  constructor(options: SessionRingBufferOptions = {}) {\n    this.maxBytes = options.maxBytes ?? 512 * 1024;\n  }\n\n  append(data: string): number {\n    const normalized = typeof data === 'string' ? data : String(data ?? '');\n    const bytes = Buffer.byteLength(normalized, 'utf8');\n    const seq = this.nextSeq++;\n\n    this.chunks.push({ seq, data: normalized, bytes });\n    this.totalBytes += bytes;\n    this.trim();\n    return seq;\n  }\n\n  snapshot(sinceSeq?: number): SessionBufferSnapshot {\n    const relevant = typeof sinceSeq === 'number'\n      ? this.chunks.filter(chunk => chunk.seq > sinceSeq)\n      : this.chunks;\n\n    const text = relevant.map(chunk => chunk.data).join('');\n    const truncated = !!this.chunks[0] && typeof sinceSeq === 'number' && sinceSeq < this.chunks[0].seq - 1;\n\n    return {\n      seq: this.nextSeq - 1,\n      text,\n      truncated,\n    };\n  }\n\n  getState(): { scrollbackBytes: number; snapshotSeq: number } {\n    return {\n      scrollbackBytes: this.totalBytes,\n      snapshotSeq: this.nextSeq - 1,\n    };\n  }\n\n  clear(): void {\n    this.chunks = [];\n    this.totalBytes = 0;\n    this.nextSeq = 1;\n  }\n\n  restore(snapshot: { seq: number; text: string }): void {\n    this.clear();\n    const text = String(snapshot.text || '');\n    if (!text) {\n      this.nextSeq = Math.max(1, Number(snapshot.seq || 0) + 1);\n      return;\n    }\n    const bytes = Buffer.byteLength(text, 'utf8');\n    const seq = Math.max(1, Number(snapshot.seq || 1));\n    this.chunks = [{ seq, data: text, bytes }];\n    this.totalBytes = bytes;\n    this.nextSeq = seq + 1;\n    this.trim();\n  }\n\n  private trim(): void {\n    while (this.totalBytes > this.maxBytes && this.chunks.length > 1) {\n      const removed = this.chunks.shift();\n      if (!removed) break;\n      this.totalBytes -= removed.bytes;\n    }\n  }\n}\n","import { randomUUID } from 'crypto';\nimport type {\n  AcquireWritePayload,\n  AttachSessionPayload,\n  CreateSessionPayload,\n  DetachSessionPayload,\n  ReleaseWritePayload,\n  SessionAttachedClient,\n  SessionHostRecord,\n} from './types.js';\nimport { SessionRingBuffer } from './buffer.js';\nimport { buildRuntimeDisplayName, buildRuntimeKey, getWorkspaceLabel } from './runtime-labels.js';\n\ninterface SessionRuntimeState {\n  record: SessionHostRecord;\n  buffer: SessionRingBuffer;\n}\n\nexport class SessionHostRegistry {\n  private sessions = new Map<string, SessionRuntimeState>();\n\n  createSession(payload: CreateSessionPayload): SessionHostRecord {\n    const sessionId = payload.sessionId || randomUUID();\n    if (this.sessions.has(sessionId)) {\n      throw new Error(`Session already exists: ${sessionId}`);\n    }\n    const now = Date.now();\n    const initialClient = payload.clientId\n      ? [{\n          clientId: payload.clientId,\n          type: payload.clientType || 'daemon',\n          readOnly: false,\n          attachedAt: now,\n          lastSeenAt: now,\n        } satisfies SessionAttachedClient]\n      : [];\n\n    const record: SessionHostRecord = {\n      sessionId,\n      runtimeKey: buildRuntimeKey(\n        payload,\n        Array.from(this.sessions.values(), (state) => state.record.runtimeKey),\n      ),\n      displayName: buildRuntimeDisplayName(payload),\n      workspaceLabel: getWorkspaceLabel(payload.workspace),\n      transport: 'pty',\n      providerType: payload.providerType,\n      category: payload.category,\n      workspace: payload.workspace,\n      launchCommand: payload.launchCommand,\n      createdAt: now,\n      lastActivityAt: now,\n      lifecycle: 'starting',\n      writeOwner: null,\n      attachedClients: initialClient,\n      buffer: {\n        scrollbackBytes: 0,\n        snapshotSeq: 0,\n      },\n      meta: payload.meta || {},\n    };\n\n    record.meta = {\n      sessionHostCols: payload.cols || 120,\n      sessionHostRows: payload.rows || 40,\n      ...record.meta,\n    };\n\n    this.sessions.set(sessionId, {\n      record,\n      buffer: new SessionRingBuffer(),\n    });\n\n    return this.cloneRecord(record);\n  }\n\n  restoreSession(record: SessionHostRecord, snapshot?: { seq: number; text: string } | null): SessionHostRecord {\n    const cloned = this.cloneRecord(record);\n    this.sessions.set(cloned.sessionId, {\n      record: cloned,\n      buffer: (() => {\n        const buffer = new SessionRingBuffer();\n        if (snapshot) buffer.restore(snapshot);\n        return buffer;\n      })(),\n    });\n    return this.cloneRecord(cloned);\n  }\n\n  listSessions(): SessionHostRecord[] {\n    return Array.from(this.sessions.values())\n      .map(state => this.cloneRecord(state.record))\n      .sort((a, b) => b.lastActivityAt - a.lastActivityAt);\n  }\n\n  getSession(sessionId: string): SessionHostRecord | null {\n    const state = this.sessions.get(sessionId);\n    return state ? this.cloneRecord(state.record) : null;\n  }\n\n  attachClient(payload: AttachSessionPayload): SessionHostRecord {\n    const state = this.requireSession(payload.sessionId);\n    const now = Date.now();\n    let removedDaemonOwner = false;\n\n    if (payload.clientType === 'daemon') {\n      const staleDaemonClientIds = state.record.attachedClients\n        .filter(client => client.type === 'daemon' && client.clientId !== payload.clientId)\n        .map(client => client.clientId);\n      if (staleDaemonClientIds.length > 0) {\n        state.record.attachedClients = state.record.attachedClients.filter(\n          client => !(client.type === 'daemon' && client.clientId !== payload.clientId),\n        );\n        if (state.record.writeOwner && staleDaemonClientIds.includes(state.record.writeOwner.clientId)) {\n          removedDaemonOwner = true;\n        }\n      }\n    }\n\n    const existing = state.record.attachedClients.find(client => client.clientId === payload.clientId);\n\n    if (existing) {\n      existing.type = payload.clientType;\n      existing.readOnly = !!payload.readOnly;\n      existing.lastSeenAt = now;\n    } else {\n      state.record.attachedClients.push({\n        clientId: payload.clientId,\n        type: payload.clientType,\n        readOnly: !!payload.readOnly,\n        attachedAt: now,\n        lastSeenAt: now,\n      });\n    }\n\n    if (removedDaemonOwner) {\n      state.record.writeOwner = null;\n    }\n\n    state.record.lastActivityAt = now;\n    return this.cloneRecord(state.record);\n  }\n\n  detachClient(payload: DetachSessionPayload): SessionHostRecord {\n    const state = this.requireSession(payload.sessionId);\n    state.record.attachedClients = state.record.attachedClients.filter(client => client.clientId !== payload.clientId);\n    if (state.record.writeOwner?.clientId === payload.clientId) {\n      state.record.writeOwner = null;\n    }\n    state.record.lastActivityAt = Date.now();\n    return this.cloneRecord(state.record);\n  }\n\n  acquireWrite(payload: AcquireWritePayload): SessionHostRecord {\n    const state = this.requireSession(payload.sessionId);\n    if (state.record.writeOwner && state.record.writeOwner.clientId !== payload.clientId && !payload.force) {\n      throw new Error(`Write owned by ${state.record.writeOwner.clientId}`);\n    }\n    const attachedClient = state.record.attachedClients.find(client => client.clientId === payload.clientId);\n    if (attachedClient) {\n      attachedClient.readOnly = false;\n      attachedClient.lastSeenAt = Date.now();\n    }\n    state.record.writeOwner = {\n      clientId: payload.clientId,\n      ownerType: payload.ownerType,\n      acquiredAt: Date.now(),\n    };\n    state.record.lastActivityAt = Date.now();\n    return this.cloneRecord(state.record);\n  }\n\n  releaseWrite(payload: ReleaseWritePayload): SessionHostRecord {\n    const state = this.requireSession(payload.sessionId);\n    const attachedClient = state.record.attachedClients.find(client => client.clientId === payload.clientId);\n    if (attachedClient) {\n      attachedClient.readOnly = false;\n      attachedClient.lastSeenAt = Date.now();\n    }\n    if (state.record.writeOwner?.clientId === payload.clientId) {\n      state.record.writeOwner = null;\n    }\n    state.record.lastActivityAt = Date.now();\n    return this.cloneRecord(state.record);\n  }\n\n  appendOutput(sessionId: string, data: string): { record: SessionHostRecord; seq: number } {\n    const state = this.requireSession(sessionId);\n    const seq = state.buffer.append(data);\n    state.record.buffer = state.buffer.getState();\n    state.record.lastActivityAt = Date.now();\n    return { record: this.cloneRecord(state.record), seq };\n  }\n\n  getSnapshot(sessionId: string, sinceSeq?: number) {\n    const state = this.requireSession(sessionId);\n    state.record.buffer = state.buffer.getState();\n    return state.buffer.snapshot(sinceSeq);\n  }\n\n  clearBuffer(sessionId: string): SessionHostRecord {\n    const state = this.requireSession(sessionId);\n    state.buffer.clear();\n    state.record.buffer = state.buffer.getState();\n    state.record.lastActivityAt = Date.now();\n    return this.cloneRecord(state.record);\n  }\n\n  markStarted(sessionId: string, pid?: number): SessionHostRecord {\n    const state = this.requireSession(sessionId);\n    state.record.lifecycle = 'running';\n    state.record.startedAt = state.record.startedAt || Date.now();\n    if (typeof pid === 'number') state.record.osPid = pid;\n    state.record.lastActivityAt = Date.now();\n    return this.cloneRecord(state.record);\n  }\n\n  markStopped(sessionId: string, lifecycle: 'stopped' | 'failed' = 'stopped'): SessionHostRecord {\n    const state = this.requireSession(sessionId);\n    state.record.lifecycle = lifecycle;\n    state.record.lastActivityAt = Date.now();\n    return this.cloneRecord(state.record);\n  }\n\n  setLifecycle(sessionId: string, lifecycle: 'starting' | 'running' | 'stopping' | 'stopped' | 'failed' | 'interrupted'): SessionHostRecord {\n    const state = this.requireSession(sessionId);\n    state.record.lifecycle = lifecycle;\n    state.record.lastActivityAt = Date.now();\n    return this.cloneRecord(state.record);\n  }\n\n  private requireSession(sessionId: string): SessionRuntimeState {\n    const state = this.sessions.get(sessionId);\n    if (!state) throw new Error(`Unknown session: ${sessionId}`);\n    return state;\n  }\n\n  private cloneRecord(record: SessionHostRecord): SessionHostRecord {\n    return {\n      ...record,\n      launchCommand: {\n        ...record.launchCommand,\n        args: [...record.launchCommand.args],\n        env: record.launchCommand.env ? { ...record.launchCommand.env } : undefined,\n      },\n      writeOwner: record.writeOwner ? { ...record.writeOwner } : null,\n      attachedClients: record.attachedClients.map(client => ({ ...client })),\n      buffer: { ...record.buffer },\n      meta: { ...record.meta },\n    };\n  }\n}\n","import * as path from 'path';\nimport type { CreateSessionPayload, SessionHostRecord } from './types.js';\n\nfunction normalizeSlug(input: string): string {\n  return input\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, '-')\n    .replace(/^-+|-+$/g, '')\n    .slice(0, 48);\n}\n\nfunction normalizeValue(input: string): string {\n  return input.trim().toLowerCase();\n}\n\nexport function getWorkspaceLabel(workspace: string): string {\n  const trimmed = workspace.trim();\n  if (!trimmed) return 'workspace';\n  const normalized = trimmed.replace(/[\\\\/]+$/, '');\n  const base = path.basename(normalized);\n  return base || normalized;\n}\n\nexport function buildRuntimeDisplayName(payload: Pick<CreateSessionPayload, 'displayName' | 'providerType' | 'workspace'>): string {\n  const explicit = payload.displayName?.trim();\n  if (explicit) return explicit;\n  const workspaceLabel = getWorkspaceLabel(payload.workspace);\n  const providerLabel = payload.providerType.trim() || 'runtime';\n  return `${providerLabel} @ ${workspaceLabel}`;\n}\n\nexport function buildRuntimeKey(\n  payload: Pick<CreateSessionPayload, 'runtimeKey' | 'displayName' | 'providerType' | 'workspace'>,\n  existingKeys: Iterable<string>,\n): string {\n  const requested = payload.runtimeKey?.trim();\n  const existing = new Set(Array.from(existingKeys, (key) => key.toLowerCase()));\n  const displayName = buildRuntimeDisplayName(payload);\n  const baseKey = normalizeSlug(requested || displayName || getWorkspaceLabel(payload.workspace) || payload.providerType || 'runtime') || 'runtime';\n  if (!existing.has(baseKey)) return baseKey;\n\n  let suffix = 2;\n  let candidate = `${baseKey}-${suffix}`;\n  while (existing.has(candidate)) {\n    suffix += 1;\n    candidate = `${baseKey}-${suffix}`;\n  }\n  return candidate;\n}\n\nfunction uniqueMatch(records: SessionHostRecord[], predicate: (record: SessionHostRecord) => boolean): SessionHostRecord | null {\n  const matches = records.filter(predicate);\n  if (matches.length === 1) return matches[0] || null;\n  if (matches.length === 0) return null;\n  const labels = matches.map((record) => `${record.runtimeKey} (${record.sessionId})`).join(', ');\n  throw new Error(`Ambiguous runtime target. Matches: ${labels}`);\n}\n\nexport function resolveRuntimeRecord(records: SessionHostRecord[], identifier: string): SessionHostRecord {\n  const target = identifier.trim();\n  if (!target) {\n    throw new Error('Runtime target is required');\n  }\n\n  const exact = uniqueMatch(records, (record) =>\n    record.sessionId === target ||\n    normalizeValue(record.runtimeKey) === normalizeValue(target) ||\n    normalizeValue(record.displayName) === normalizeValue(target),\n  );\n  if (exact) return exact;\n\n  const prefix = uniqueMatch(records, (record) =>\n    record.sessionId.startsWith(target) ||\n    normalizeValue(record.runtimeKey).startsWith(normalizeValue(target)),\n  );\n  if (prefix) return prefix;\n\n  throw new Error(`Unknown runtime target: ${target}`);\n}\n\nexport function formatRuntimeOwner(record: Pick<SessionHostRecord, 'writeOwner'>): string {\n  if (!record.writeOwner) return 'none';\n  return `${record.writeOwner.ownerType}:${record.writeOwner.clientId}`;\n}\n","import * as os from 'os';\nimport * as path from 'path';\nimport * as net from 'net';\nimport { randomUUID } from 'crypto';\nimport type {\n  SessionHostEvent,\n  SessionHostRequest,\n  SessionHostRequestEnvelope,\n  SessionHostResponse,\n  SessionHostResponseEnvelope,\n  SessionHostWireEnvelope,\n} from './types.js';\n\nexport interface SessionHostEndpoint {\n  kind: 'unix' | 'pipe';\n  path: string;\n}\n\nexport function getDefaultSessionHostEndpoint(appName = 'adhdev'): SessionHostEndpoint {\n  if (process.platform === 'win32') {\n    return {\n      kind: 'pipe',\n      path: `\\\\\\\\.\\\\pipe\\\\${appName}-session-host`,\n    };\n  }\n\n  return {\n    kind: 'unix',\n    path: path.join(os.tmpdir(), `${appName}-session-host.sock`),\n  };\n}\n\nfunction serializeEnvelope(envelope: SessionHostWireEnvelope): string {\n  return `${JSON.stringify(envelope)}\\n`;\n}\n\nfunction createLineParser(onEnvelope: (envelope: SessionHostWireEnvelope) => void) {\n  let buffer = '';\n  return (chunk: Buffer | string) => {\n    buffer += chunk.toString();\n    let newlineIndex = buffer.indexOf('\\n');\n    while (newlineIndex >= 0) {\n      const rawLine = buffer.slice(0, newlineIndex).trim();\n      buffer = buffer.slice(newlineIndex + 1);\n      if (rawLine) {\n        onEnvelope(JSON.parse(rawLine) as SessionHostWireEnvelope);\n      }\n      newlineIndex = buffer.indexOf('\\n');\n    }\n  };\n}\n\nexport interface SessionHostClientOptions {\n  endpoint?: SessionHostEndpoint;\n  appName?: string;\n}\n\nexport class SessionHostClient {\n  readonly endpoint: SessionHostEndpoint;\n\n  private socket: net.Socket | null = null;\n  private requestWaiters = new Map<string, { resolve: (value: SessionHostResponse) => void; reject: (error: Error) => void }>();\n  private eventListeners = new Set<(event: SessionHostEvent) => void>();\n\n  constructor(options: SessionHostClientOptions = {}) {\n    this.endpoint = options.endpoint || getDefaultSessionHostEndpoint(options.appName || 'adhdev');\n  }\n\n  async connect(): Promise<void> {\n    if (this.socket && !this.socket.destroyed) return;\n\n    const socket = net.createConnection(this.endpoint.path);\n    this.socket = socket;\n\n    socket.on('data', createLineParser((envelope) => {\n      if (envelope.kind === 'response') {\n        const waiter = this.requestWaiters.get(envelope.requestId);\n        if (waiter) {\n          this.requestWaiters.delete(envelope.requestId);\n          waiter.resolve(envelope.response);\n        }\n        return;\n      }\n\n      if (envelope.kind === 'event') {\n        for (const listener of this.eventListeners) listener(envelope.event);\n      }\n    }));\n\n    socket.on('error', (error) => {\n      for (const waiter of this.requestWaiters.values()) {\n        waiter.reject(error);\n      }\n      this.requestWaiters.clear();\n    });\n\n    await new Promise<void>((resolve, reject) => {\n      socket.once('connect', () => resolve());\n      socket.once('error', reject);\n    });\n  }\n\n  onEvent(listener: (event: SessionHostEvent) => void): () => void {\n    this.eventListeners.add(listener);\n    return () => {\n      this.eventListeners.delete(listener);\n    };\n  }\n\n  async request<T = unknown>(request: SessionHostRequest): Promise<SessionHostResponse<T>> {\n    await this.connect();\n    if (!this.socket) throw new Error('Session host socket unavailable');\n\n    const requestId = randomUUID();\n    const envelope: SessionHostRequestEnvelope = {\n      kind: 'request',\n      requestId,\n      request,\n    };\n\n    const response = await new Promise<SessionHostResponse>((resolve, reject) => {\n      this.requestWaiters.set(requestId, { resolve, reject });\n      this.socket?.write(serializeEnvelope(envelope));\n    });\n\n    return response as SessionHostResponse<T>;\n  }\n\n  async close(): Promise<void> {\n    if (!this.socket) return;\n    const socket = this.socket;\n    this.socket = null;\n    for (const waiter of this.requestWaiters.values()) {\n      waiter.reject(new Error('Session host client closed'));\n    }\n    this.requestWaiters.clear();\n    await new Promise<void>((resolve) => {\n      let settled = false;\n      const done = () => {\n        if (settled) return;\n        settled = true;\n        resolve();\n      };\n      socket.once('close', done);\n      socket.end();\n      socket.destroy();\n      setTimeout(done, 50);\n    });\n  }\n}\n\nexport function createResponseEnvelope(requestId: string, response: SessionHostResponse): SessionHostResponseEnvelope {\n  return {\n    kind: 'response',\n    requestId,\n    response,\n  };\n}\n\nexport function writeEnvelope(socket: Pick<net.Socket, 'write'>, envelope: SessionHostWireEnvelope): void {\n  socket.write(serializeEnvelope(envelope));\n}\n\nexport { createLineParser };\n"],"mappings":"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","names":["path","randomUUID"]}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@adhdev/session-host-core",
+  "version": "0.7.12",
+  "description": "ADHDev local session host core — session registry, protocol, buffers",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "keywords": [
+    "adhdev",
+    "session-host",
+    "pty",
+    "runtime"
+  ],
+  "author": "vilmire",
+  "license": "AGPL-3.0-or-later",
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.2.0",
+    "typescript": "^5.5.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vilmire/adhdev.git",
+    "directory": "packages/session-host-core"
+  },
+  "homepage": "https://github.com/vilmire/adhdev#readme"
+}

package/src/buffer.ts

@@ -0,0 +1,78 @@
+import type { SessionBufferSnapshot } from './types.js';
+
+export interface SessionRingBufferOptions {
+  maxBytes?: number;
+}
+
+export class SessionRingBuffer {
+  private maxBytes: number;
+  private chunks: { seq: number; data: string; bytes: number }[] = [];
+  private nextSeq = 1;
+  private totalBytes = 0;
+
+  constructor(options: SessionRingBufferOptions = {}) {
+    this.maxBytes = options.maxBytes ?? 512 * 1024;
+  }
+
+  append(data: string): number {
+    const normalized = typeof data === 'string' ? data : String(data ?? '');
+    const bytes = Buffer.byteLength(normalized, 'utf8');
+    const seq = this.nextSeq++;
+
+    this.chunks.push({ seq, data: normalized, bytes });
+    this.totalBytes += bytes;
+    this.trim();
+    return seq;
+  }
+
+  snapshot(sinceSeq?: number): SessionBufferSnapshot {
+    const relevant = typeof sinceSeq === 'number'
+      ? this.chunks.filter(chunk => chunk.seq > sinceSeq)
+      : this.chunks;
+
+    const text = relevant.map(chunk => chunk.data).join('');
+    const truncated = !!this.chunks[0] && typeof sinceSeq === 'number' && sinceSeq < this.chunks[0].seq - 1;
+
+    return {
+      seq: this.nextSeq - 1,
+      text,
+      truncated,
+    };
+  }
+
+  getState(): { scrollbackBytes: number; snapshotSeq: number } {
+    return {
+      scrollbackBytes: this.totalBytes,
+      snapshotSeq: this.nextSeq - 1,
+    };
+  }
+
+  clear(): void {
+    this.chunks = [];
+    this.totalBytes = 0;
+    this.nextSeq = 1;
+  }
+
+  restore(snapshot: { seq: number; text: string }): void {
+    this.clear();
+    const text = String(snapshot.text || '');
+    if (!text) {
+      this.nextSeq = Math.max(1, Number(snapshot.seq || 0) + 1);
+      return;
+    }
+    const bytes = Buffer.byteLength(text, 'utf8');
+    const seq = Math.max(1, Number(snapshot.seq || 1));
+    this.chunks = [{ seq, data: text, bytes }];
+    this.totalBytes = bytes;
+    this.nextSeq = seq + 1;
+    this.trim();
+  }
+
+  private trim(): void {
+    while (this.totalBytes > this.maxBytes && this.chunks.length > 1) {
+      const removed = this.chunks.shift();
+      if (!removed) break;
+      this.totalBytes -= removed.bytes;
+    }
+  }
+}