@cnstra/devtools-server 1.2.0 → 3.0.0

package/dist/index.cjs

@@ -1,10 +1,11 @@
 'use strict';
 
 var devtoolsDto = require('@cnstra/devtools-dto');
+var persist = require('@cnstra/persist');
 
 // src/index.ts
 var CNSDevToolsServer = class {
-  constructor(repository) {
+  constructor(repository, stimulationRepository = new persist.CNSInMemoryStimulationRepository()) {
     this.repository = repository;
     /** WebSocket → appId (for app clients) */
     this.appSockets = /* @__PURE__ */ new Map();
@@ -14,6 +15,7 @@ var CNSDevToolsServer = class {
     this.uiClients = /* @__PURE__ */ new Set();
     this.lastCpuUsage = process.cpuUsage();
     this.lastCpuTime = Date.now();
+    this.stimulationRepository = stimulationRepository;
   }
   // ─── Message entry point ─────────────────────────────────────────────────
   async handleMessage(ws, raw) {
@@ -27,14 +29,14 @@ var CNSDevToolsServer = class {
     if (!data || typeof data !== "object" || !("type" in data)) return;
     const type = data.type;
     if (type === "batch") {
-      const result = devtoolsDto.CNSDTOAppBatchMessageSchema.safeParse(data);
+      const result = devtoolsDto.CNSAppBatchMessageDTOSchema.safeParse(data);
       if (!result.success) return;
       for (const item of result.data.items) {
         await this.handleAppBatchItem(ws, item);
       }
       return;
     }
-    const clientResult = devtoolsDto.CNSDTOClientMessageSchema.safeParse(data);
+    const clientResult = devtoolsDto.CNSClientMessageDTOSchema.safeParse(data);
     if (!clientResult.success) return;
     const msg = clientResult.data;
     switch (msg.type) {
@@ -47,17 +49,119 @@ var CNSDevToolsServer = class {
       case "topology.query":
         await this.handleTopologyQuery(ws, msg.requestId, msg.cnsId, msg.appId);
         break;
-      case "stimulations.query":
-        await this.handleStimulationsQuery(ws, msg);
-        break;
-      case "hops.query":
-        await this.handleHopsQuery(ws, msg);
-        break;
       case "replay.start":
         await this.handleReplayStart(ws, msg);
         break;
+      case "stimulation.retry":
+        await this.handleStimulationRetry(ws, msg);
+        break;
+      case "stimulation.clone":
+        await this.handleStimulationClone(ws, msg);
+        break;
+      case "cns.stimulations.list":
+        await this.handleStimulationsList(ws, msg);
+        break;
+      case "cns.stimulations.facets":
+        await this.handleStimulationsFacets(ws, msg);
+        break;
+      case "cns.stimulations.snapshot":
+        await this.handleStimulationsSnapshot(ws, msg);
+        break;
+      case "cns.stimulation.detail":
+        await this.handleStimulationDetail(ws, msg);
+        break;
     }
   }
+  /**
+   * Explorer protocol (bucket-shaped). The roster row = resumable state minus
+   * `progress`, plus envelope summaries derived from the run's attempts.
+   *
+   * Pushdown: if the store implements `ICNSStimulationRosterQuery` (e.g. the
+   * Postgres store), the filter + keyset + GROUP BY run INSIDE it (SQL). Else we
+   * fall back to the shared reference derivation over the reader — identical
+   * results, only the work moves. Roster shapes are structurally the wire DTOs,
+   * so no mapping is needed at the boundary.
+   */
+  toRosterFilter(scopeName, filter) {
+    return { ...filter ?? {}, ...scopeName ? { scopeName } : {} };
+  }
+  async handleStimulationsList(ws, msg) {
+    const filter = this.toRosterFilter(msg.scopeName, msg.filter);
+    const limit = typeof msg.limit === "number" ? msg.limit : 50;
+    const opts = { cursor: msg.cursor, limit };
+    const store = this.stimulationRepository;
+    const page = persist.supportsRosterQuery(store) ? await store.queryRoster(filter, opts) : persist.keysetPage(
+      (await persist.loadRosterEntries(store, filter)).map((e) => e.row),
+      opts
+    );
+    this.send(ws, {
+      type: "cns.stimulations.list.result",
+      requestId: msg.requestId,
+      stimulations: page.rows,
+      nextCursor: page.nextCursor,
+      total: page.total
+    });
+  }
+  async handleStimulationsFacets(ws, msg) {
+    const filter = this.toRosterFilter(msg.scopeName, msg.filter);
+    const store = this.stimulationRepository;
+    const facets = persist.supportsRosterQuery(store) ? await store.queryFacets(filter, { metricPath: msg.metricPath }) : persist.computeRosterFacets(await persist.loadRosterEntries(store, filter), {
+      metricPath: msg.metricPath
+    });
+    this.send(ws, {
+      type: "cns.stimulations.facets.result",
+      requestId: msg.requestId,
+      facets
+    });
+  }
+  async handleStimulationDetail(ws, msg) {
+    const attempts = await this.stimulationRepository.getAttempts(
+      msg.stimulationId
+    );
+    const tasks = [];
+    for (const a of attempts) {
+      const ts = await this.stimulationRepository.getTasks(
+        a.stimulationAttemptId
+      );
+      tasks.push(...ts);
+    }
+    this.send(ws, {
+      type: "cns.stimulation.detail.result",
+      requestId: msg.requestId,
+      attempts,
+      tasks
+    });
+  }
+  /**
+   * The topology/signal views' bulk feed: a bounded, newest-first set of runs as
+   * FLAT buckets (stimulations + attempts + tasks) the panel joins client-side by
+   * id. Replaces the retired nested `cns.stimulations.query` tree — same data, no
+   * server-side join, no client-side flatten.
+   */
+  async handleStimulationsSnapshot(ws, msg) {
+    const filter = this.toRosterFilter(msg.scopeName, msg.filter);
+    const store = this.stimulationRepository;
+    const limit = typeof msg.limit === "number" ? msg.limit : 200;
+    const page = persist.supportsRosterQuery(store) ? await store.queryRoster(filter, { limit }) : persist.keysetPage(
+      (await persist.loadRosterEntries(store, filter)).map((e) => e.row),
+      { limit }
+    );
+    const attempts = [];
+    const tasks = [];
+    for (const row of page.rows) {
+      const as = await store.getAttempts(row.stimulationId);
+      attempts.push(...as);
+      for (const a of as)
+        tasks.push(...await store.getTasks(a.stimulationAttemptId));
+    }
+    this.send(ws, {
+      type: "cns.stimulations.snapshot.result",
+      requestId: msg.requestId,
+      stimulations: page.rows,
+      attempts,
+      tasks
+    });
+  }
   addClient(ws) {
     this.uiClients.add(ws);
     if (this.uiClients.size === 1) this.startMetrics();
@@ -79,17 +183,22 @@ var CNSDevToolsServer = class {
       case "topology":
         await this.handleTopology(ws, item);
         break;
-      case "stimulation.started":
-        await this.handleStimulationStarted(ws, item.stimulation);
+      // ── Name-based resumable model ──
+      case "cns.stimulation":
+        await this.stimulationRepository.saveStimulation(item.data);
         break;
-      case "stimulation.hop":
-        await this.handleStimulationHop(item.hop);
+      case "cns.stimulation.attempt":
+        await this.stimulationRepository.saveAttempt(item.data);
         break;
-      case "stimulation.completed":
-        await this.handleStimulationCompleted(item);
+      case "cns.stimulation.task":
+        await this.stimulationRepository.appendTask(item.data);
         break;
     }
   }
+  /** The name-based resumable store, for tests/integrations that want to read it back. */
+  getStimulationRepository() {
+    return this.stimulationRepository;
+  }
   async handleTopology(ws, msg) {
     const { appId, cnsId, appName, version, timestamp, neurons, collaterals, dendrites } = msg;
     const now = Date.now();
@@ -114,35 +223,6 @@ var CNSDevToolsServer = class {
     this.broadcast({ type: "app.connected", app, topology: { cnsId, neurons, collaterals, dendrites } });
     this.broadcastRaw(JSON.stringify(topologyBroadcast));
   }
-  async handleStimulationStarted(ws, stimulation) {
-    const appId = this.appSockets.get(ws);
-    if (appId) {
-      const apps = await this.repository.listApps();
-      const app = apps.find((a) => a.id === appId);
-      if (app) await this.repository.upsertApp({ ...app, lastSeenAt: Date.now() });
-    }
-    await this.repository.saveStimulation(stimulation);
-    this.broadcast({ type: "stimulation.started", stimulation });
-  }
-  async handleStimulationHop(hop) {
-    await this.repository.saveHop(hop);
-    this.broadcast({ type: "stimulation.hop", hop });
-  }
-  async handleStimulationCompleted(item) {
-    await this.repository.completeStimulation(
-      item.stimulationId,
-      item.completedAt,
-      item.hopCount,
-      item.hasError
-    );
-    this.broadcast({
-      type: "stimulation.completed",
-      stimulationId: item.stimulationId,
-      completedAt: item.completedAt,
-      hopCount: item.hopCount,
-      hasError: item.hasError
-    });
-  }
   // ─── UI client query handlers ─────────────────────────────────────────────
   async handleClientConnect(ws) {
     this.addClient(ws);
@@ -162,25 +242,6 @@ var CNSDevToolsServer = class {
     if (appId) snapshots = snapshots.filter((s) => s.appId === appId);
     this.send(ws, { type: "topology.result", requestId, snapshots });
   }
-  async handleStimulationsQuery(ws, msg) {
-    const appId = msg.appId ?? (msg.cnsId ? await this.repository.findAppByCns(msg.cnsId) : void 0);
-    if (!appId) {
-      this.send(ws, { type: "stimulations.result", requestId: msg.requestId, items: [], total: 0, offset: 0 });
-      return;
-    }
-    const { items, total } = await this.repository.getStimulations(appId, msg.filter ?? {});
-    this.send(ws, {
-      type: "stimulations.result",
-      requestId: msg.requestId,
-      items,
-      total,
-      offset: msg.filter?.offset ?? 0
-    });
-  }
-  async handleHopsQuery(ws, msg) {
-    const items = await this.repository.getHops(msg.stimulationId);
-    this.send(ws, { type: "hops.result", requestId: msg.requestId, items });
-  }
   async handleReplayStart(ws, msg) {
     const appId = msg.appId ?? (msg.cnsId ? await this.repository.findAppByCns(msg.cnsId) : void 0);
     const appSockets = appId ? this.appWsByAppId.get(appId) : void 0;
@@ -198,6 +259,94 @@ var CNSDevToolsServer = class {
       }
     }
   }
+  // ─── Resumable actions (retry / clone), Phase 2b-2 ──────────────────────────────
+  //
+  // The UI's request is thin (a stimulationId). The CNS + name→ref registry live in
+  // the APP, so the server can't execute it: it ENRICHES from the resumable store (the
+  // stored entry + progress + a server-assigned attempt identity) and forwards a
+  // resume/launch command to the owning app, routed by scopeName (= the cns id).
+  /** Resolve the app that owns a stimulation's scope, or reject if unreachable. */
+  async resolveScopeApp(scopeName) {
+    const appId = scopeName ? await this.repository.findAppByCns(scopeName) : void 0;
+    const sockets = appId ? this.appWsByAppId.get(appId) : void 0;
+    return sockets && sockets.size > 0 ? sockets : void 0;
+  }
+  async handleStimulationRetry(ws, msg) {
+    const reject = (reason) => this.send(ws, {
+      type: "stimulation.retry.rejected",
+      requestId: msg.requestId,
+      stimulationId: msg.stimulationId,
+      reason
+    });
+    const stim = await this.stimulationRepository.getStimulation(msg.stimulationId);
+    if (!stim) return reject("unknown stimulation");
+    if (stim.progress.tasks.length === 0)
+      return reject("nothing to resume (empty frontier)");
+    const appSockets = await this.resolveScopeApp(stim.scopeName);
+    if (!appSockets) return reject("app not connected");
+    const attempts = await this.stimulationRepository.getAttempts(msg.stimulationId);
+    const nextAttempt = attempts.length + 1;
+    const stimulationAttemptId = devtoolsDto.buildAttemptId(msg.stimulationId, nextAttempt);
+    this.send(ws, {
+      type: "stimulation.retry.accepted",
+      requestId: msg.requestId,
+      stimulationId: msg.stimulationId,
+      newStimulationAttemptId: stimulationAttemptId
+    });
+    const payload = JSON.stringify({
+      type: "cns.stimulation.resume",
+      requestId: msg.requestId,
+      scopeName: stim.scopeName,
+      stimulationId: msg.stimulationId,
+      stimulationAttemptId,
+      attemptNumber: nextAttempt,
+      entry: stim.entry,
+      progress: stim.progress,
+      options: msg.options
+    });
+    for (const appWs of appSockets) {
+      try {
+        appWs.send(payload);
+      } catch {
+      }
+    }
+  }
+  async handleStimulationClone(ws, msg) {
+    const reject = (reason) => this.send(ws, {
+      type: "stimulation.clone.rejected",
+      requestId: msg.requestId,
+      stimulationId: msg.stimulationId,
+      reason
+    });
+    const stim = await this.stimulationRepository.getStimulation(msg.stimulationId);
+    if (!stim) return reject("unknown stimulation");
+    const appSockets = await this.resolveScopeApp(stim.scopeName);
+    if (!appSockets) return reject("app not connected");
+    const newStimulationId = devtoolsDto.buildCloneId(msg.stimulationId);
+    const stimulationAttemptId = devtoolsDto.buildAttemptId(newStimulationId, 1);
+    this.send(ws, {
+      type: "stimulation.clone.accepted",
+      requestId: msg.requestId,
+      stimulationId: msg.stimulationId,
+      newStimulationId,
+      newStimulationAttemptId: stimulationAttemptId
+    });
+    const payload = JSON.stringify({
+      type: "cns.stimulation.launch",
+      requestId: msg.requestId,
+      scopeName: stim.scopeName,
+      stimulationId: newStimulationId,
+      stimulationAttemptId,
+      entry: stim.entry,
+      options: msg.options
+    });
+    for (const appWs of appSockets) {
+      try {
+        appWs.send(payload);
+      } catch {
+      }
+    }
+  }
   // ─── Broadcast helpers ────────────────────────────────────────────────────
   broadcast(message) {
     this.broadcastRaw(JSON.stringify(message));

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":["CNSDTOAppBatchMessageSchema","CNSDTOClientMessageSchema"],"mappings":"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","file":"index.cjs","sourcesContent":["import {\n    CNSDTOApp,\n    CNSDTOAppBatchMessageSchema,\n    CNSDTOClientMessageSchema,\n    CNSDTOStimulation,\n    CNSDTOStimulationFilter,\n    CNSDTOHop,\n    CNSDTOTopologyMessage,\n} from '@cnstra/devtools-dto';\nimport { WebSocket } from 'ws';\n\n// ─── Repository interface ─────────────────────────────────────────────────────\n\nexport type CNSDTOTopologySnapshot = Omit<CNSDTOTopologyMessage, 'type'>;\n\nexport interface ICNSDevToolsServerRepository {\n    // Apps\n    upsertApp(app: CNSDTOApp): void | Promise<void>;\n    listApps(): CNSDTOApp[] | Promise<CNSDTOApp[]>;\n\n    // Topology\n    saveTopology(snapshot: CNSDTOTopologySnapshot): void | Promise<void>;\n    getTopology(cnsId?: string): CNSDTOTopologySnapshot[] | Promise<CNSDTOTopologySnapshot[]>;\n\n    // Stimulations\n    saveStimulation(stimulation: CNSDTOStimulation): void | Promise<void>;\n    completeStimulation(\n        stimulationId: string,\n        completedAt: number,\n        hopCount: number,\n        hasError: boolean\n    ): void | Promise<void>;\n    getStimulations(\n        appId: string,\n        filter: CNSDTOStimulationFilter\n    ): { items: CNSDTOStimulation[]; total: number } | Promise<{ items: CNSDTOStimulation[]; total: number }>;\n\n    // Hops\n    saveHop(hop: CNSDTOHop): void | Promise<void>;\n    getHops(stimulationId: string): CNSDTOHop[] | Promise<CNSDTOHop[]>;\n\n    // CNS ↔ App mapping\n    addCnsToApp(appId: string, cnsId: string): void | Promise<void>;\n    getCnsByApp(appId: string): string[] | Promise<string[]>;\n    findAppByCns(cnsId: string): string | undefined | Promise<string | undefined>;\n}\n\n// ─── Server ───────────────────────────────────────────────────────────────────\n\nexport class CNSDevToolsServer {\n    /** WebSocket → appId (for app clients) */\n    private appSockets = new Map<WebSocket, string>();\n    /** appId → WebSocket[] (one app may have multiple CNS instances) */\n    private appWsByAppId = new Map<string, Set<WebSocket>>();\n    /** WebSocket clients that registered as UI clients */\n    private uiClients = new Set<WebSocket>();\n\n    private metricsTimer?: NodeJS.Timeout;\n    private lastCpuUsage = process.cpuUsage();\n    private lastCpuTime = Date.now();\n\n    constructor(private readonly repository: ICNSDevToolsServerRepository) {}\n\n    // ─── Message entry point ─────────────────────────────────────────────────\n\n    async handleMessage(\n        ws: WebSocket,\n        raw: unknown\n    ): Promise<void> {\n        if (typeof raw !== 'string' && typeof raw !== 'object') return;\n\n        let data: unknown;\n        try {\n            data = typeof raw === 'string' ? JSON.parse(raw) : raw;\n        } catch {\n            return;\n        }\n\n        if (!data || typeof data !== 'object' || !('type' in data)) return;\n        const type = (data as any).type as string;\n\n        // App batch (topology + stimulation events)\n        if (type === 'batch') {\n            const result = CNSDTOAppBatchMessageSchema.safeParse(data);\n            if (!result.success) return;\n            for (const item of result.data.items) {\n                await this.handleAppBatchItem(ws, item);\n            }\n            return;\n        }\n\n        // UI client message\n        const clientResult = CNSDTOClientMessageSchema.safeParse(data);\n        if (!clientResult.success) return;\n        const msg = clientResult.data;\n\n        switch (msg.type) {\n            case 'client.connect':\n                await this.handleClientConnect(ws);\n                break;\n            case 'apps.query':\n                await this.handleAppsQuery(ws, msg.requestId);\n                break;\n            case 'topology.query':\n                await this.handleTopologyQuery(ws, msg.requestId, msg.cnsId, msg.appId);\n                break;\n            case 'stimulations.query':\n                await this.handleStimulationsQuery(ws, msg);\n                break;\n            case 'hops.query':\n                await this.handleHopsQuery(ws, msg);\n                break;\n            case 'replay.start':\n                await this.handleReplayStart(ws, msg);\n                break;\n        }\n    }\n\n    addClient(ws: WebSocket): void {\n        this.uiClients.add(ws);\n        if (this.uiClients.size === 1) this.startMetrics();\n    }\n\n    removeClient(ws: WebSocket): void {\n        this.uiClients.delete(ws);\n        this.appSockets.delete(ws);\n        if (this.uiClients.size === 0) this.stopMetrics();\n    }\n\n    async getActiveApps(): Promise<CNSDTOApp[]> {\n        return this.repository.listApps();\n    }\n\n    stop(): void {\n        this.stopMetrics();\n    }\n\n    // ─── App batch item handlers ──────────────────────────────────────────────\n\n    private async handleAppBatchItem(ws: WebSocket, item: any): Promise<void> {\n        switch (item.type) {\n            case 'topology':\n                await this.handleTopology(ws, item);\n                break;\n            case 'stimulation.started':\n                await this.handleStimulationStarted(ws, item.stimulation);\n                break;\n            case 'stimulation.hop':\n                await this.handleStimulationHop(item.hop);\n                break;\n            case 'stimulation.completed':\n                await this.handleStimulationCompleted(item);\n                break;\n        }\n    }\n\n    private async handleTopology(ws: WebSocket, msg: any): Promise<void> {\n        const { appId, cnsId, appName, version, timestamp, neurons, collaterals, dendrites } = msg;\n\n        const now = Date.now();\n        const app: CNSDTOApp = {\n            id: appId,\n            name: appName,\n            version,\n            connectedAt: now,\n            lastSeenAt: now,\n        };\n\n        await this.repository.upsertApp(app);\n        await this.repository.addCnsToApp(appId, cnsId);\n        await this.repository.saveTopology({ appId, cnsId, appName, version, timestamp, neurons, collaterals, dendrites });\n\n        // Track app socket\n        this.appSockets.set(ws, appId);\n        if (!this.appWsByAppId.has(appId)) this.appWsByAppId.set(appId, new Set());\n        this.appWsByAppId.get(appId)!.add(ws);\n\n        // Broadcast topology + app connected to UI clients\n        const topologyBroadcast = {\n            type: 'topology.result' as const,\n            requestId: '__broadcast__',\n            snapshots: await this.repository.getTopology(cnsId),\n        };\n\n        this.broadcast({ type: 'app.connected', app, topology: { cnsId, neurons, collaterals, dendrites } });\n        // Also send topology snapshot so UI can refresh graph\n        this.broadcastRaw(JSON.stringify(topologyBroadcast));\n    }\n\n    private async handleStimulationStarted(ws: WebSocket, stimulation: CNSDTOStimulation): Promise<void> {\n        // Update lastSeenAt for the app\n        const appId = this.appSockets.get(ws);\n        if (appId) {\n            const apps = await this.repository.listApps();\n            const app = apps.find(a => a.id === appId);\n            if (app) await this.repository.upsertApp({ ...app, lastSeenAt: Date.now() });\n        }\n\n        await this.repository.saveStimulation(stimulation);\n        this.broadcast({ type: 'stimulation.started', stimulation });\n    }\n\n    private async handleStimulationHop(hop: CNSDTOHop): Promise<void> {\n        await this.repository.saveHop(hop);\n        this.broadcast({ type: 'stimulation.hop', hop });\n    }\n\n    private async handleStimulationCompleted(item: any): Promise<void> {\n        await this.repository.completeStimulation(\n            item.stimulationId,\n            item.completedAt,\n            item.hopCount,\n            item.hasError\n        );\n        this.broadcast({\n            type: 'stimulation.completed',\n            stimulationId: item.stimulationId,\n            completedAt: item.completedAt,\n            hopCount: item.hopCount,\n            hasError: item.hasError,\n        });\n    }\n\n    // ─── UI client query handlers ─────────────────────────────────────────────\n\n    private async handleClientConnect(ws: WebSocket): Promise<void> {\n        this.addClient(ws);\n        this.send(ws, { type: 'apps.result', requestId: '__init__', items: await this.repository.listApps() });\n        this.send(ws, {\n            type: 'topology.result',\n            requestId: '__init__',\n            snapshots: await this.repository.getTopology(),\n        });\n    }\n\n    private async handleAppsQuery(ws: WebSocket, requestId: string): Promise<void> {\n        const items = await this.repository.listApps();\n        this.send(ws, { type: 'apps.result', requestId, items });\n    }\n\n    private async handleTopologyQuery(\n        ws: WebSocket,\n        requestId: string,\n        cnsId?: string,\n        appId?: string\n    ): Promise<void> {\n        let snapshots = await this.repository.getTopology(cnsId);\n        if (appId) snapshots = snapshots.filter(s => s.appId === appId);\n        this.send(ws, { type: 'topology.result', requestId, snapshots });\n    }\n\n    private async handleStimulationsQuery(ws: WebSocket, msg: any): Promise<void> {\n        const appId = msg.appId ?? (msg.cnsId ? await this.repository.findAppByCns(msg.cnsId) : undefined);\n\n        if (!appId) {\n            this.send(ws, { type: 'stimulations.result', requestId: msg.requestId, items: [], total: 0, offset: 0 });\n            return;\n        }\n\n        const { items, total } = await this.repository.getStimulations(appId, msg.filter ?? {});\n        this.send(ws, {\n            type: 'stimulations.result',\n            requestId: msg.requestId,\n            items,\n            total,\n            offset: msg.filter?.offset ?? 0,\n        });\n    }\n\n    private async handleHopsQuery(ws: WebSocket, msg: any): Promise<void> {\n        const items = await this.repository.getHops(msg.stimulationId);\n        this.send(ws, { type: 'hops.result', requestId: msg.requestId, items });\n    }\n\n    private async handleReplayStart(ws: WebSocket, msg: any): Promise<void> {\n        const appId = msg.appId ?? (msg.cnsId ? await this.repository.findAppByCns(msg.cnsId) : undefined);\n        const appSockets = appId ? this.appWsByAppId.get(appId) : undefined;\n\n        if (!appSockets || appSockets.size === 0) {\n            this.send(ws, { type: 'replay.rejected', replayId: msg.replayId, reason: 'App not connected' });\n            return;\n        }\n\n        const newStimulationId = `${msg.stimulationId}-replay-${Date.now()}`;\n        this.send(ws, { type: 'replay.accepted', replayId: msg.replayId, newStimulationId });\n\n        const payload = JSON.stringify(msg);\n        for (const appWs of appSockets) {\n            try { appWs.send(payload); } catch {}\n        }\n    }\n\n    // ─── Broadcast helpers ────────────────────────────────────────────────────\n\n    private broadcast(message: object): void {\n        this.broadcastRaw(JSON.stringify(message));\n    }\n\n    private broadcastRaw(payload: string): void {\n        for (const client of this.uiClients) {\n            try {\n                if ((client as any).readyState === 1) client.send(payload);\n            } catch {}\n        }\n    }\n\n    private send(ws: WebSocket, message: object): void {\n        try {\n            if ((ws as any).readyState === 1) ws.send(JSON.stringify(message));\n        } catch {}\n    }\n\n    // ─── Metrics ──────────────────────────────────────────────────────────────\n\n    private startMetrics(): void {\n        if (this.metricsTimer) return;\n        this.metricsTimer = setInterval(() => {\n            const mem = process.memoryUsage();\n            const now = Date.now();\n            const cpu = process.cpuUsage(this.lastCpuUsage);\n            const elapsed = (now - this.lastCpuTime) * 1000;\n            const cpuPercent = elapsed > 0 ? ((cpu.user + cpu.system) / elapsed) * 100 : 0;\n            this.lastCpuUsage = process.cpuUsage();\n            this.lastCpuTime = now;\n\n            this.broadcast({\n                type: 'server.metrics',\n                timestamp: now,\n                rssMB: mem.rss / 1024 / 1024,\n                heapUsedMB: mem.heapUsed / 1024 / 1024,\n                heapTotalMB: mem.heapTotal / 1024 / 1024,\n                cpuPercent,\n            });\n        }, 1000);\n    }\n\n    private stopMetrics(): void {\n        if (this.metricsTimer) {\n            clearInterval(this.metricsTimer);\n            this.metricsTimer = undefined;\n        }\n    }\n}\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":["CNSInMemoryStimulationRepository","CNSAppBatchMessageDTOSchema","CNSClientMessageDTOSchema","supportsRosterQuery","keysetPage","loadRosterEntries","computeRosterFacets","buildAttemptId","buildCloneId"],"mappings":"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","file":"index.cjs","sourcesContent":["import {\n    TCNSAppDTO,\n    CNSAppBatchMessageDTOSchema,\n    CNSClientMessageDTOSchema,\n    TCNSTopologyMessageDTO,\n} from '@cnstra/devtools-dto';\nimport type {\n    TCNSStimulationFilter,\n    TCNSStimulationTask,\n    TCNSStimulationAttempt,\n} from '@cnstra/devtools-dto';\nimport { buildAttemptId, buildCloneId } from '@cnstra/devtools-dto';\nimport type {\n    ICNSStimulationRepository,\n    TCNSStimulationRosterFilter,\n} from '@cnstra/persist';\nimport {\n    CNSInMemoryStimulationRepository,\n    supportsRosterQuery,\n    loadRosterEntries,\n    keysetPage,\n    computeRosterFacets,\n} from '@cnstra/persist';\nimport { WebSocket } from 'ws';\n\n// ─── Repository interface ─────────────────────────────────────────────────────\n\nexport type TCNSTopologySnapshotDTO = Omit<TCNSTopologyMessageDTO, 'type'>;\n\nexport interface ICNSDevToolsServerRepository {\n    // Apps\n    upsertApp(app: TCNSAppDTO): void | Promise<void>;\n    listApps(): TCNSAppDTO[] | Promise<TCNSAppDTO[]>;\n\n    // Topology\n    saveTopology(snapshot: TCNSTopologySnapshotDTO): void | Promise<void>;\n    getTopology(cnsId?: string): TCNSTopologySnapshotDTO[] | Promise<TCNSTopologySnapshotDTO[]>;\n\n    // CNS ↔ App mapping\n    addCnsToApp(appId: string, cnsId: string): void | Promise<void>;\n    getCnsByApp(appId: string): string[] | Promise<string[]>;\n    findAppByCns(cnsId: string): string | undefined | Promise<string | undefined>;\n}\n\n// ─── Server ───────────────────────────────────────────────────────────────────\n\nexport class CNSDevToolsServer {\n    /** WebSocket → appId (for app clients) */\n    private appSockets = new Map<WebSocket, string>();\n    /** appId → WebSocket[] (one app may have multiple CNS instances) */\n    private appWsByAppId = new Map<string, Set<WebSocket>>();\n    /** WebSocket clients that registered as UI clients */\n    private uiClients = new Set<WebSocket>();\n\n    private metricsTimer?: NodeJS.Timeout;\n    private lastCpuUsage = process.cpuUsage();\n    private lastCpuTime = Date.now();\n\n    /**\n     * Name-based resumable store (Stimulation/Attempt/Task). Written from the three\n     * `cns.stimulation*` batch items the producer emits when `trackStimulations` is on.\n     * Defaults to in-memory; the example-app can inject a Postgres store.\n     */\n    private readonly stimulationRepository: ICNSStimulationRepository;\n\n    constructor(\n        private readonly repository: ICNSDevToolsServerRepository,\n        stimulationRepository: ICNSStimulationRepository = new CNSInMemoryStimulationRepository()\n    ) {\n        this.stimulationRepository = stimulationRepository;\n    }\n\n    // ─── Message entry point ─────────────────────────────────────────────────\n\n    async handleMessage(\n        ws: WebSocket,\n        raw: unknown\n    ): Promise<void> {\n        if (typeof raw !== 'string' && typeof raw !== 'object') return;\n\n        let data: unknown;\n        try {\n            data = typeof raw === 'string' ? JSON.parse(raw) : raw;\n        } catch {\n            return;\n        }\n\n        if (!data || typeof data !== 'object' || !('type' in data)) return;\n        const type = (data as any).type as string;\n\n        // App batch (topology + stimulation events)\n        if (type === 'batch') {\n            const result = CNSAppBatchMessageDTOSchema.safeParse(data);\n            if (!result.success) return;\n            for (const item of result.data.items) {\n                await this.handleAppBatchItem(ws, item);\n            }\n            return;\n        }\n\n        // UI client message\n        const clientResult = CNSClientMessageDTOSchema.safeParse(data);\n        if (!clientResult.success) return;\n        const msg = clientResult.data;\n\n        switch (msg.type) {\n            case 'client.connect':\n                await this.handleClientConnect(ws);\n                break;\n            case 'apps.query':\n                await this.handleAppsQuery(ws, msg.requestId);\n                break;\n            case 'topology.query':\n                await this.handleTopologyQuery(ws, msg.requestId, msg.cnsId, msg.appId);\n                break;\n            case 'replay.start':\n                await this.handleReplayStart(ws, msg);\n                break;\n            case 'stimulation.retry':\n                await this.handleStimulationRetry(ws, msg);\n                break;\n            case 'stimulation.clone':\n                await this.handleStimulationClone(ws, msg);\n                break;\n            case 'cns.stimulations.list':\n                await this.handleStimulationsList(ws, msg);\n                break;\n            case 'cns.stimulations.facets':\n                await this.handleStimulationsFacets(ws, msg);\n                break;\n            case 'cns.stimulations.snapshot':\n                await this.handleStimulationsSnapshot(ws, msg);\n                break;\n            case 'cns.stimulation.detail':\n                await this.handleStimulationDetail(ws, msg);\n                break;\n        }\n    }\n\n    /**\n     * Explorer protocol (bucket-shaped). The roster row = resumable state minus\n     * `progress`, plus envelope summaries derived from the run's attempts.\n     *\n     * Pushdown: if the store implements `ICNSStimulationRosterQuery` (e.g. the\n     * Postgres store), the filter + keyset + GROUP BY run INSIDE it (SQL). Else we\n     * fall back to the shared reference derivation over the reader — identical\n     * results, only the work moves. Roster shapes are structurally the wire DTOs,\n     * so no mapping is needed at the boundary.\n     */\n    private toRosterFilter(\n        scopeName: string | undefined,\n        filter: TCNSStimulationFilter | undefined\n    ): TCNSStimulationRosterFilter {\n        return { ...(filter ?? {}), ...(scopeName ? { scopeName } : {}) };\n    }\n\n    private async handleStimulationsList(\n        ws: WebSocket,\n        msg: any\n    ): Promise<void> {\n        const filter = this.toRosterFilter(msg.scopeName, msg.filter);\n        const limit = typeof msg.limit === 'number' ? msg.limit : 50;\n        const opts = { cursor: msg.cursor, limit };\n        const store = this.stimulationRepository;\n        const page = supportsRosterQuery(store)\n            ? await store.queryRoster(filter, opts)\n            : keysetPage(\n                  (await loadRosterEntries(store, filter)).map(e => e.row),\n                  opts\n              );\n        this.send(ws, {\n            type: 'cns.stimulations.list.result',\n            requestId: msg.requestId,\n            stimulations: page.rows,\n            nextCursor: page.nextCursor,\n            total: page.total,\n        });\n    }\n\n    private async handleStimulationsFacets(\n        ws: WebSocket,\n        msg: any\n    ): Promise<void> {\n        const filter = this.toRosterFilter(msg.scopeName, msg.filter);\n        const store = this.stimulationRepository;\n        const facets = supportsRosterQuery(store)\n            ? await store.queryFacets(filter, { metricPath: msg.metricPath })\n            : computeRosterFacets(await loadRosterEntries(store, filter), {\n                  metricPath: msg.metricPath,\n              });\n        this.send(ws, {\n            type: 'cns.stimulations.facets.result',\n            requestId: msg.requestId,\n            facets,\n        });\n    }\n\n    private async handleStimulationDetail(\n        ws: WebSocket,\n        msg: any\n    ): Promise<void> {\n        const attempts = await this.stimulationRepository.getAttempts(\n            msg.stimulationId\n        );\n        const tasks: TCNSStimulationTask[] = [];\n        for (const a of attempts) {\n            const ts = await this.stimulationRepository.getTasks(\n                a.stimulationAttemptId\n            );\n            tasks.push(...ts);\n        }\n        this.send(ws, {\n            type: 'cns.stimulation.detail.result',\n            requestId: msg.requestId,\n            attempts,\n            tasks,\n        });\n    }\n\n    /**\n     * The topology/signal views' bulk feed: a bounded, newest-first set of runs as\n     * FLAT buckets (stimulations + attempts + tasks) the panel joins client-side by\n     * id. Replaces the retired nested `cns.stimulations.query` tree — same data, no\n     * server-side join, no client-side flatten.\n     */\n    private async handleStimulationsSnapshot(\n        ws: WebSocket,\n        msg: any\n    ): Promise<void> {\n        const filter = this.toRosterFilter(msg.scopeName, msg.filter);\n        const store = this.stimulationRepository;\n        const limit = typeof msg.limit === 'number' ? msg.limit : 200;\n        const page = supportsRosterQuery(store)\n            ? await store.queryRoster(filter, { limit })\n            : keysetPage(\n                  (await loadRosterEntries(store, filter)).map(e => e.row),\n                  { limit }\n              );\n        const attempts: TCNSStimulationAttempt[] = [];\n        const tasks: TCNSStimulationTask[] = [];\n        for (const row of page.rows) {\n            const as = await store.getAttempts(row.stimulationId);\n            attempts.push(...as);\n            for (const a of as)\n                tasks.push(...(await store.getTasks(a.stimulationAttemptId)));\n        }\n        this.send(ws, {\n            type: 'cns.stimulations.snapshot.result',\n            requestId: msg.requestId,\n            stimulations: page.rows,\n            attempts,\n            tasks,\n        });\n    }\n\n    addClient(ws: WebSocket): void {\n        this.uiClients.add(ws);\n        if (this.uiClients.size === 1) this.startMetrics();\n    }\n\n    removeClient(ws: WebSocket): void {\n        this.uiClients.delete(ws);\n        this.appSockets.delete(ws);\n        if (this.uiClients.size === 0) this.stopMetrics();\n    }\n\n    async getActiveApps(): Promise<TCNSAppDTO[]> {\n        return this.repository.listApps();\n    }\n\n    stop(): void {\n        this.stopMetrics();\n    }\n\n    // ─── App batch item handlers ──────────────────────────────────────────────\n\n    private async handleAppBatchItem(ws: WebSocket, item: any): Promise<void> {\n        switch (item.type) {\n            case 'topology':\n                await this.handleTopology(ws, item);\n                break;\n            // ── Name-based resumable model ──\n            case 'cns.stimulation':\n                await this.stimulationRepository.saveStimulation(item.data);\n                break;\n            case 'cns.stimulation.attempt':\n                await this.stimulationRepository.saveAttempt(item.data);\n                break;\n            case 'cns.stimulation.task':\n                await this.stimulationRepository.appendTask(item.data);\n                break;\n        }\n    }\n\n    /** The name-based resumable store, for tests/integrations that want to read it back. */\n    getStimulationRepository(): ICNSStimulationRepository {\n        return this.stimulationRepository;\n    }\n\n    private async handleTopology(ws: WebSocket, msg: any): Promise<void> {\n        const { appId, cnsId, appName, version, timestamp, neurons, collaterals, dendrites } = msg;\n\n        const now = Date.now();\n        const app: TCNSAppDTO = {\n            id: appId,\n            name: appName,\n            version,\n            connectedAt: now,\n            lastSeenAt: now,\n        };\n\n        await this.repository.upsertApp(app);\n        await this.repository.addCnsToApp(appId, cnsId);\n        await this.repository.saveTopology({ appId, cnsId, appName, version, timestamp, neurons, collaterals, dendrites });\n\n        // Track app socket\n        this.appSockets.set(ws, appId);\n        if (!this.appWsByAppId.has(appId)) this.appWsByAppId.set(appId, new Set());\n        this.appWsByAppId.get(appId)!.add(ws);\n\n        // Broadcast topology + app connected to UI clients\n        const topologyBroadcast = {\n            type: 'topology.result' as const,\n            requestId: '__broadcast__',\n            snapshots: await this.repository.getTopology(cnsId),\n        };\n\n        this.broadcast({ type: 'app.connected', app, topology: { cnsId, neurons, collaterals, dendrites } });\n        // Also send topology snapshot so UI can refresh graph\n        this.broadcastRaw(JSON.stringify(topologyBroadcast));\n    }\n\n    // ─── UI client query handlers ─────────────────────────────────────────────\n\n    private async handleClientConnect(ws: WebSocket): Promise<void> {\n        this.addClient(ws);\n        this.send(ws, { type: 'apps.result', requestId: '__init__', items: await this.repository.listApps() });\n        this.send(ws, {\n            type: 'topology.result',\n            requestId: '__init__',\n            snapshots: await this.repository.getTopology(),\n        });\n    }\n\n    private async handleAppsQuery(ws: WebSocket, requestId: string): Promise<void> {\n        const items = await this.repository.listApps();\n        this.send(ws, { type: 'apps.result', requestId, items });\n    }\n\n    private async handleTopologyQuery(\n        ws: WebSocket,\n        requestId: string,\n        cnsId?: string,\n        appId?: string\n    ): Promise<void> {\n        let snapshots = await this.repository.getTopology(cnsId);\n        if (appId) snapshots = snapshots.filter(s => s.appId === appId);\n        this.send(ws, { type: 'topology.result', requestId, snapshots });\n    }\n\n    private async handleReplayStart(ws: WebSocket, msg: any): Promise<void> {\n        const appId = msg.appId ?? (msg.cnsId ? await this.repository.findAppByCns(msg.cnsId) : undefined);\n        const appSockets = appId ? this.appWsByAppId.get(appId) : undefined;\n\n        if (!appSockets || appSockets.size === 0) {\n            this.send(ws, { type: 'replay.rejected', replayId: msg.replayId, reason: 'App not connected' });\n            return;\n        }\n\n        const newStimulationId = `${msg.stimulationId}-replay-${Date.now()}`;\n        this.send(ws, { type: 'replay.accepted', replayId: msg.replayId, newStimulationId });\n\n        const payload = JSON.stringify(msg);\n        for (const appWs of appSockets) {\n            try { appWs.send(payload); } catch {}\n        }\n    }\n\n    // ─── Resumable actions (retry / clone), Phase 2b-2 ──────────────────────────────\n    //\n    // The UI's request is thin (a stimulationId). The CNS + name→ref registry live in\n    // the APP, so the server can't execute it: it ENRICHES from the resumable store (the\n    // stored entry + progress + a server-assigned attempt identity) and forwards a\n    // resume/launch command to the owning app, routed by scopeName (= the cns id).\n\n    /** Resolve the app that owns a stimulation's scope, or reject if unreachable. */\n    private async resolveScopeApp(\n        scopeName: string | undefined\n    ): Promise<Set<WebSocket> | undefined> {\n        const appId = scopeName\n            ? await this.repository.findAppByCns(scopeName)\n            : undefined;\n        const sockets = appId ? this.appWsByAppId.get(appId) : undefined;\n        return sockets && sockets.size > 0 ? sockets : undefined;\n    }\n\n    private async handleStimulationRetry(ws: WebSocket, msg: any): Promise<void> {\n        const reject = (reason: string) =>\n            this.send(ws, {\n                type: 'stimulation.retry.rejected',\n                requestId: msg.requestId,\n                stimulationId: msg.stimulationId,\n                reason,\n            });\n\n        const stim = await this.stimulationRepository.getStimulation(msg.stimulationId);\n        if (!stim) return reject('unknown stimulation');\n        if (stim.progress.tasks.length === 0)\n            return reject('nothing to resume (empty frontier)');\n\n        const appSockets = await this.resolveScopeApp(stim.scopeName);\n        if (!appSockets) return reject('app not connected');\n\n        const attempts = await this.stimulationRepository.getAttempts(msg.stimulationId);\n        const nextAttempt = attempts.length + 1;\n        const stimulationAttemptId = buildAttemptId(msg.stimulationId, nextAttempt);\n\n        this.send(ws, {\n            type: 'stimulation.retry.accepted',\n            requestId: msg.requestId,\n            stimulationId: msg.stimulationId,\n            newStimulationAttemptId: stimulationAttemptId,\n        });\n\n        const payload = JSON.stringify({\n            type: 'cns.stimulation.resume',\n            requestId: msg.requestId,\n            scopeName: stim.scopeName,\n            stimulationId: msg.stimulationId,\n            stimulationAttemptId,\n            attemptNumber: nextAttempt,\n            entry: stim.entry,\n            progress: stim.progress,\n            options: msg.options,\n        });\n        for (const appWs of appSockets) {\n            try { appWs.send(payload); } catch {}\n        }\n    }\n\n    private async handleStimulationClone(ws: WebSocket, msg: any): Promise<void> {\n        const reject = (reason: string) =>\n            this.send(ws, {\n                type: 'stimulation.clone.rejected',\n                requestId: msg.requestId,\n                stimulationId: msg.stimulationId,\n                reason,\n            });\n\n        const stim = await this.stimulationRepository.getStimulation(msg.stimulationId);\n        if (!stim) return reject('unknown stimulation');\n\n        const appSockets = await this.resolveScopeApp(stim.scopeName);\n        if (!appSockets) return reject('app not connected');\n\n        const newStimulationId = buildCloneId(msg.stimulationId);\n        const stimulationAttemptId = buildAttemptId(newStimulationId, 1);\n\n        this.send(ws, {\n            type: 'stimulation.clone.accepted',\n            requestId: msg.requestId,\n            stimulationId: msg.stimulationId,\n            newStimulationId,\n            newStimulationAttemptId: stimulationAttemptId,\n        });\n\n        const payload = JSON.stringify({\n            type: 'cns.stimulation.launch',\n            requestId: msg.requestId,\n            scopeName: stim.scopeName,\n            stimulationId: newStimulationId,\n            stimulationAttemptId,\n            entry: stim.entry,\n            options: msg.options,\n        });\n        for (const appWs of appSockets) {\n            try { appWs.send(payload); } catch {}\n        }\n    }\n\n    // ─── Broadcast helpers ────────────────────────────────────────────────────\n\n    private broadcast(message: object): void {\n        this.broadcastRaw(JSON.stringify(message));\n    }\n\n    private broadcastRaw(payload: string): void {\n        for (const client of this.uiClients) {\n            try {\n                if ((client as any).readyState === 1) client.send(payload);\n            } catch {}\n        }\n    }\n\n    private send(ws: WebSocket, message: object): void {\n        try {\n            if ((ws as any).readyState === 1) ws.send(JSON.stringify(message));\n        } catch {}\n    }\n\n    // ─── Metrics ──────────────────────────────────────────────────────────────\n\n    private startMetrics(): void {\n        if (this.metricsTimer) return;\n        this.metricsTimer = setInterval(() => {\n            const mem = process.memoryUsage();\n            const now = Date.now();\n            const cpu = process.cpuUsage(this.lastCpuUsage);\n            const elapsed = (now - this.lastCpuTime) * 1000;\n            const cpuPercent = elapsed > 0 ? ((cpu.user + cpu.system) / elapsed) * 100 : 0;\n            this.lastCpuUsage = process.cpuUsage();\n            this.lastCpuTime = now;\n\n            this.broadcast({\n                type: 'server.metrics',\n                timestamp: now,\n                rssMB: mem.rss / 1024 / 1024,\n                heapUsedMB: mem.heapUsed / 1024 / 1024,\n                heapTotalMB: mem.heapTotal / 1024 / 1024,\n                cpuPercent,\n            });\n        }, 1000);\n    }\n\n    private stopMetrics(): void {\n        if (this.metricsTimer) {\n            clearInterval(this.metricsTimer);\n            this.metricsTimer = undefined;\n        }\n    }\n}\n"]}

package/dist/index.d.ts

@@ -1,22 +1,12 @@
-import { CNSDTOApp, CNSDTOStimulation, CNSDTOStimulationFilter, CNSDTOHop, CNSDTOTopologyMessage } from '@cnstra/devtools-dto';
+import { TCNSAppDTO, TCNSTopologyMessageDTO } from '@cnstra/devtools-dto';
+import type { ICNSStimulationRepository } from '@cnstra/persist';
 import { WebSocket } from 'ws';
-export type CNSDTOTopologySnapshot = Omit<CNSDTOTopologyMessage, 'type'>;
+export type TCNSTopologySnapshotDTO = Omit<TCNSTopologyMessageDTO, 'type'>;
 export interface ICNSDevToolsServerRepository {
-    upsertApp(app: CNSDTOApp): void | Promise<void>;
-    listApps(): CNSDTOApp[] | Promise<CNSDTOApp[]>;
-    saveTopology(snapshot: CNSDTOTopologySnapshot): void | Promise<void>;
-    getTopology(cnsId?: string): CNSDTOTopologySnapshot[] | Promise<CNSDTOTopologySnapshot[]>;
-    saveStimulation(stimulation: CNSDTOStimulation): void | Promise<void>;
-    completeStimulation(stimulationId: string, completedAt: number, hopCount: number, hasError: boolean): void | Promise<void>;
-    getStimulations(appId: string, filter: CNSDTOStimulationFilter): {
-        items: CNSDTOStimulation[];
-        total: number;
-    } | Promise<{
-        items: CNSDTOStimulation[];
-        total: number;
-    }>;
-    saveHop(hop: CNSDTOHop): void | Promise<void>;
-    getHops(stimulationId: string): CNSDTOHop[] | Promise<CNSDTOHop[]>;
+    upsertApp(app: TCNSAppDTO): void | Promise<void>;
+    listApps(): TCNSAppDTO[] | Promise<TCNSAppDTO[]>;
+    saveTopology(snapshot: TCNSTopologySnapshotDTO): void | Promise<void>;
+    getTopology(cnsId?: string): TCNSTopologySnapshotDTO[] | Promise<TCNSTopologySnapshotDTO[]>;
     addCnsToApp(appId: string, cnsId: string): void | Promise<void>;
     getCnsByApp(appId: string): string[] | Promise<string[]>;
     findAppByCns(cnsId: string): string | undefined | Promise<string | undefined>;
@@ -32,23 +22,51 @@ export declare class CNSDevToolsServer {
     private metricsTimer?;
     private lastCpuUsage;
     private lastCpuTime;
-    constructor(repository: ICNSDevToolsServerRepository);
+    /**
+     * Name-based resumable store (Stimulation/Attempt/Task). Written from the three
+     * `cns.stimulation*` batch items the producer emits when `trackStimulations` is on.
+     * Defaults to in-memory; the example-app can inject a Postgres store.
+     */
+    private readonly stimulationRepository;
+    constructor(repository: ICNSDevToolsServerRepository, stimulationRepository?: ICNSStimulationRepository);
     handleMessage(ws: WebSocket, raw: unknown): Promise<void>;
+    /**
+     * Explorer protocol (bucket-shaped). The roster row = resumable state minus
+     * `progress`, plus envelope summaries derived from the run's attempts.
+     *
+     * Pushdown: if the store implements `ICNSStimulationRosterQuery` (e.g. the
+     * Postgres store), the filter + keyset + GROUP BY run INSIDE it (SQL). Else we
+     * fall back to the shared reference derivation over the reader — identical
+     * results, only the work moves. Roster shapes are structurally the wire DTOs,
+     * so no mapping is needed at the boundary.
+     */
+    private toRosterFilter;
+    private handleStimulationsList;
+    private handleStimulationsFacets;
+    private handleStimulationDetail;
+    /**
+     * The topology/signal views' bulk feed: a bounded, newest-first set of runs as
+     * FLAT buckets (stimulations + attempts + tasks) the panel joins client-side by
+     * id. Replaces the retired nested `cns.stimulations.query` tree — same data, no
+     * server-side join, no client-side flatten.
+     */
+    private handleStimulationsSnapshot;
     addClient(ws: WebSocket): void;
     removeClient(ws: WebSocket): void;
-    getActiveApps(): Promise<CNSDTOApp[]>;
+    getActiveApps(): Promise<TCNSAppDTO[]>;
     stop(): void;
     private handleAppBatchItem;
+    /** The name-based resumable store, for tests/integrations that want to read it back. */
+    getStimulationRepository(): ICNSStimulationRepository;
     private handleTopology;
-    private handleStimulationStarted;
-    private handleStimulationHop;
-    private handleStimulationCompleted;
     private handleClientConnect;
     private handleAppsQuery;
     private handleTopologyQuery;
-    private handleStimulationsQuery;
-    private handleHopsQuery;
     private handleReplayStart;
+    /** Resolve the app that owns a stimulation's scope, or reject if unreachable. */
+    private resolveScopeApp;
+    private handleStimulationRetry;
+    private handleStimulationClone;
     private broadcast;
     private broadcastRaw;
     private send;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,UAAU,EAGV,sBAAsB,EACzB,MAAM,sBAAsB,CAAC;AAO9B,OAAO,KAAK,EACR,yBAAyB,EAE5B,MAAM,iBAAiB,CAAC;AAQzB,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAI/B,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,sBAAsB,EAAE,MAAM,CAAC,CAAC;AAE3E,MAAM,WAAW,4BAA4B;IAEzC,SAAS,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,QAAQ,IAAI,UAAU,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAGjD,YAAY,CAAC,QAAQ,EAAE,uBAAuB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,uBAAuB,EAAE,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAG5F,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACzD,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACjF;AAID,qBAAa,iBAAiB;IAoBtB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAnB/B,0CAA0C;IAC1C,OAAO,CAAC,UAAU,CAAgC;IAClD,oEAAoE;IACpE,OAAO,CAAC,YAAY,CAAqC;IACzD,sDAAsD;IACtD,OAAO,CAAC,SAAS,CAAwB;IAEzC,OAAO,CAAC,YAAY,CAAC,CAAiB;IACtC,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,WAAW,CAAc;IAEjC;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAA4B;gBAG7C,UAAU,EAAE,4BAA4B,EACzD,qBAAqB,GAAE,yBAAkE;IAOvF,aAAa,CACf,EAAE,EAAE,SAAS,EACb,GAAG,EAAE,OAAO,GACb,OAAO,CAAC,IAAI,CAAC;IA8DhB;;;;;;;;;OASG;IACH,OAAO,CAAC,cAAc;YAOR,sBAAsB;YAuBtB,wBAAwB;YAkBxB,uBAAuB;IAsBrC;;;;;OAKG;YACW,0BAA0B;IA8BxC,SAAS,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI;IAK9B,YAAY,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI;IAM3B,aAAa,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAI5C,IAAI,IAAI,IAAI;YAME,kBAAkB;IAkBhC,wFAAwF;IACxF,wBAAwB,IAAI,yBAAyB;YAIvC,cAAc;YAmCd,mBAAmB;YAUnB,eAAe;YAKf,mBAAmB;YAWnB,iBAAiB;IAyB/B,iFAAiF;YACnE,eAAe;YAUf,sBAAsB;YA4CtB,sBAAsB;IA0CpC,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,IAAI;IAQZ,OAAO,CAAC,YAAY;IAsBpB,OAAO,CAAC,WAAW;CAMtB"}

package/dist/index.js

@@ -1,8 +1,9 @@
-import { CNSDTOAppBatchMessageSchema, CNSDTOClientMessageSchema } from '@cnstra/devtools-dto';
+import { CNSAppBatchMessageDTOSchema, CNSClientMessageDTOSchema, buildAttemptId, buildCloneId } from '@cnstra/devtools-dto';
+import { CNSInMemoryStimulationRepository, supportsRosterQuery, keysetPage, loadRosterEntries, computeRosterFacets } from '@cnstra/persist';
 
 // src/index.ts
 var CNSDevToolsServer = class {
-  constructor(repository) {
+  constructor(repository, stimulationRepository = new CNSInMemoryStimulationRepository()) {
     this.repository = repository;
     /** WebSocket → appId (for app clients) */
     this.appSockets = /* @__PURE__ */ new Map();
@@ -12,6 +13,7 @@ var CNSDevToolsServer = class {
     this.uiClients = /* @__PURE__ */ new Set();
     this.lastCpuUsage = process.cpuUsage();
     this.lastCpuTime = Date.now();
+    this.stimulationRepository = stimulationRepository;
   }
   // ─── Message entry point ─────────────────────────────────────────────────
   async handleMessage(ws, raw) {
@@ -25,14 +27,14 @@ var CNSDevToolsServer = class {
     if (!data || typeof data !== "object" || !("type" in data)) return;
     const type = data.type;
     if (type === "batch") {
-      const result = CNSDTOAppBatchMessageSchema.safeParse(data);
+      const result = CNSAppBatchMessageDTOSchema.safeParse(data);
       if (!result.success) return;
       for (const item of result.data.items) {
         await this.handleAppBatchItem(ws, item);
       }
       return;
     }
-    const clientResult = CNSDTOClientMessageSchema.safeParse(data);
+    const clientResult = CNSClientMessageDTOSchema.safeParse(data);
     if (!clientResult.success) return;
     const msg = clientResult.data;
     switch (msg.type) {
@@ -45,17 +47,119 @@ var CNSDevToolsServer = class {
       case "topology.query":
         await this.handleTopologyQuery(ws, msg.requestId, msg.cnsId, msg.appId);
         break;
-      case "stimulations.query":
-        await this.handleStimulationsQuery(ws, msg);
-        break;
-      case "hops.query":
-        await this.handleHopsQuery(ws, msg);
-        break;
       case "replay.start":
         await this.handleReplayStart(ws, msg);
         break;
+      case "stimulation.retry":
+        await this.handleStimulationRetry(ws, msg);
+        break;
+      case "stimulation.clone":
+        await this.handleStimulationClone(ws, msg);
+        break;
+      case "cns.stimulations.list":
+        await this.handleStimulationsList(ws, msg);
+        break;
+      case "cns.stimulations.facets":
+        await this.handleStimulationsFacets(ws, msg);
+        break;
+      case "cns.stimulations.snapshot":
+        await this.handleStimulationsSnapshot(ws, msg);
+        break;
+      case "cns.stimulation.detail":
+        await this.handleStimulationDetail(ws, msg);
+        break;
     }
   }
+  /**
+   * Explorer protocol (bucket-shaped). The roster row = resumable state minus
+   * `progress`, plus envelope summaries derived from the run's attempts.
+   *
+   * Pushdown: if the store implements `ICNSStimulationRosterQuery` (e.g. the
+   * Postgres store), the filter + keyset + GROUP BY run INSIDE it (SQL). Else we
+   * fall back to the shared reference derivation over the reader — identical
+   * results, only the work moves. Roster shapes are structurally the wire DTOs,
+   * so no mapping is needed at the boundary.
+   */
+  toRosterFilter(scopeName, filter) {
+    return { ...filter ?? {}, ...scopeName ? { scopeName } : {} };
+  }
+  async handleStimulationsList(ws, msg) {
+    const filter = this.toRosterFilter(msg.scopeName, msg.filter);
+    const limit = typeof msg.limit === "number" ? msg.limit : 50;
+    const opts = { cursor: msg.cursor, limit };
+    const store = this.stimulationRepository;
+    const page = supportsRosterQuery(store) ? await store.queryRoster(filter, opts) : keysetPage(
+      (await loadRosterEntries(store, filter)).map((e) => e.row),
+      opts
+    );
+    this.send(ws, {
+      type: "cns.stimulations.list.result",
+      requestId: msg.requestId,
+      stimulations: page.rows,
+      nextCursor: page.nextCursor,
+      total: page.total
+    });
+  }
+  async handleStimulationsFacets(ws, msg) {
+    const filter = this.toRosterFilter(msg.scopeName, msg.filter);
+    const store = this.stimulationRepository;
+    const facets = supportsRosterQuery(store) ? await store.queryFacets(filter, { metricPath: msg.metricPath }) : computeRosterFacets(await loadRosterEntries(store, filter), {
+      metricPath: msg.metricPath
+    });
+    this.send(ws, {
+      type: "cns.stimulations.facets.result",
+      requestId: msg.requestId,
+      facets
+    });
+  }
+  async handleStimulationDetail(ws, msg) {
+    const attempts = await this.stimulationRepository.getAttempts(
+      msg.stimulationId
+    );
+    const tasks = [];
+    for (const a of attempts) {
+      const ts = await this.stimulationRepository.getTasks(
+        a.stimulationAttemptId
+      );
+      tasks.push(...ts);
+    }
+    this.send(ws, {
+      type: "cns.stimulation.detail.result",
+      requestId: msg.requestId,
+      attempts,
+      tasks
+    });
+  }
+  /**
+   * The topology/signal views' bulk feed: a bounded, newest-first set of runs as
+   * FLAT buckets (stimulations + attempts + tasks) the panel joins client-side by
+   * id. Replaces the retired nested `cns.stimulations.query` tree — same data, no
+   * server-side join, no client-side flatten.
+   */
+  async handleStimulationsSnapshot(ws, msg) {
+    const filter = this.toRosterFilter(msg.scopeName, msg.filter);
+    const store = this.stimulationRepository;
+    const limit = typeof msg.limit === "number" ? msg.limit : 200;
+    const page = supportsRosterQuery(store) ? await store.queryRoster(filter, { limit }) : keysetPage(
+      (await loadRosterEntries(store, filter)).map((e) => e.row),
+      { limit }
+    );
+    const attempts = [];
+    const tasks = [];
+    for (const row of page.rows) {
+      const as = await store.getAttempts(row.stimulationId);
+      attempts.push(...as);
+      for (const a of as)
+        tasks.push(...await store.getTasks(a.stimulationAttemptId));
+    }
+    this.send(ws, {
+      type: "cns.stimulations.snapshot.result",
+      requestId: msg.requestId,
+      stimulations: page.rows,
+      attempts,
+      tasks
+    });
+  }
   addClient(ws) {
     this.uiClients.add(ws);
     if (this.uiClients.size === 1) this.startMetrics();
@@ -77,17 +181,22 @@ var CNSDevToolsServer = class {
       case "topology":
         await this.handleTopology(ws, item);
         break;
-      case "stimulation.started":
-        await this.handleStimulationStarted(ws, item.stimulation);
+      // ── Name-based resumable model ──
+      case "cns.stimulation":
+        await this.stimulationRepository.saveStimulation(item.data);
         break;
-      case "stimulation.hop":
-        await this.handleStimulationHop(item.hop);
+      case "cns.stimulation.attempt":
+        await this.stimulationRepository.saveAttempt(item.data);
         break;
-      case "stimulation.completed":
-        await this.handleStimulationCompleted(item);
+      case "cns.stimulation.task":
+        await this.stimulationRepository.appendTask(item.data);
         break;
     }
   }
+  /** The name-based resumable store, for tests/integrations that want to read it back. */
+  getStimulationRepository() {
+    return this.stimulationRepository;
+  }
   async handleTopology(ws, msg) {
     const { appId, cnsId, appName, version, timestamp, neurons, collaterals, dendrites } = msg;
     const now = Date.now();
@@ -112,35 +221,6 @@ var CNSDevToolsServer = class {
     this.broadcast({ type: "app.connected", app, topology: { cnsId, neurons, collaterals, dendrites } });
     this.broadcastRaw(JSON.stringify(topologyBroadcast));
   }
-  async handleStimulationStarted(ws, stimulation) {
-    const appId = this.appSockets.get(ws);
-    if (appId) {
-      const apps = await this.repository.listApps();
-      const app = apps.find((a) => a.id === appId);
-      if (app) await this.repository.upsertApp({ ...app, lastSeenAt: Date.now() });
-    }
-    await this.repository.saveStimulation(stimulation);
-    this.broadcast({ type: "stimulation.started", stimulation });
-  }
-  async handleStimulationHop(hop) {
-    await this.repository.saveHop(hop);
-    this.broadcast({ type: "stimulation.hop", hop });
-  }
-  async handleStimulationCompleted(item) {
-    await this.repository.completeStimulation(
-      item.stimulationId,
-      item.completedAt,
-      item.hopCount,
-      item.hasError
-    );
-    this.broadcast({
-      type: "stimulation.completed",
-      stimulationId: item.stimulationId,
-      completedAt: item.completedAt,
-      hopCount: item.hopCount,
-      hasError: item.hasError
-    });
-  }
   // ─── UI client query handlers ─────────────────────────────────────────────
   async handleClientConnect(ws) {
     this.addClient(ws);
@@ -160,25 +240,6 @@ var CNSDevToolsServer = class {
     if (appId) snapshots = snapshots.filter((s) => s.appId === appId);
     this.send(ws, { type: "topology.result", requestId, snapshots });
   }
-  async handleStimulationsQuery(ws, msg) {
-    const appId = msg.appId ?? (msg.cnsId ? await this.repository.findAppByCns(msg.cnsId) : void 0);
-    if (!appId) {
-      this.send(ws, { type: "stimulations.result", requestId: msg.requestId, items: [], total: 0, offset: 0 });
-      return;
-    }
-    const { items, total } = await this.repository.getStimulations(appId, msg.filter ?? {});
-    this.send(ws, {
-      type: "stimulations.result",
-      requestId: msg.requestId,
-      items,
-      total,
-      offset: msg.filter?.offset ?? 0
-    });
-  }
-  async handleHopsQuery(ws, msg) {
-    const items = await this.repository.getHops(msg.stimulationId);
-    this.send(ws, { type: "hops.result", requestId: msg.requestId, items });
-  }
   async handleReplayStart(ws, msg) {
     const appId = msg.appId ?? (msg.cnsId ? await this.repository.findAppByCns(msg.cnsId) : void 0);
     const appSockets = appId ? this.appWsByAppId.get(appId) : void 0;
@@ -196,6 +257,94 @@ var CNSDevToolsServer = class {
       }
     }
   }
+  // ─── Resumable actions (retry / clone), Phase 2b-2 ──────────────────────────────
+  //
+  // The UI's request is thin (a stimulationId). The CNS + name→ref registry live in
+  // the APP, so the server can't execute it: it ENRICHES from the resumable store (the
+  // stored entry + progress + a server-assigned attempt identity) and forwards a
+  // resume/launch command to the owning app, routed by scopeName (= the cns id).
+  /** Resolve the app that owns a stimulation's scope, or reject if unreachable. */
+  async resolveScopeApp(scopeName) {
+    const appId = scopeName ? await this.repository.findAppByCns(scopeName) : void 0;
+    const sockets = appId ? this.appWsByAppId.get(appId) : void 0;
+    return sockets && sockets.size > 0 ? sockets : void 0;
+  }
+  async handleStimulationRetry(ws, msg) {
+    const reject = (reason) => this.send(ws, {
+      type: "stimulation.retry.rejected",
+      requestId: msg.requestId,
+      stimulationId: msg.stimulationId,
+      reason
+    });
+    const stim = await this.stimulationRepository.getStimulation(msg.stimulationId);
+    if (!stim) return reject("unknown stimulation");
+    if (stim.progress.tasks.length === 0)
+      return reject("nothing to resume (empty frontier)");
+    const appSockets = await this.resolveScopeApp(stim.scopeName);
+    if (!appSockets) return reject("app not connected");
+    const attempts = await this.stimulationRepository.getAttempts(msg.stimulationId);
+    const nextAttempt = attempts.length + 1;
+    const stimulationAttemptId = buildAttemptId(msg.stimulationId, nextAttempt);
+    this.send(ws, {
+      type: "stimulation.retry.accepted",
+      requestId: msg.requestId,
+      stimulationId: msg.stimulationId,
+      newStimulationAttemptId: stimulationAttemptId
+    });
+    const payload = JSON.stringify({
+      type: "cns.stimulation.resume",
+      requestId: msg.requestId,
+      scopeName: stim.scopeName,
+      stimulationId: msg.stimulationId,
+      stimulationAttemptId,
+      attemptNumber: nextAttempt,
+      entry: stim.entry,
+      progress: stim.progress,
+      options: msg.options
+    });
+    for (const appWs of appSockets) {
+      try {
+        appWs.send(payload);
+      } catch {
+      }
+    }
+  }
+  async handleStimulationClone(ws, msg) {
+    const reject = (reason) => this.send(ws, {
+      type: "stimulation.clone.rejected",
+      requestId: msg.requestId,
+      stimulationId: msg.stimulationId,
+      reason
+    });
+    const stim = await this.stimulationRepository.getStimulation(msg.stimulationId);
+    if (!stim) return reject("unknown stimulation");
+    const appSockets = await this.resolveScopeApp(stim.scopeName);
+    if (!appSockets) return reject("app not connected");
+    const newStimulationId = buildCloneId(msg.stimulationId);
+    const stimulationAttemptId = buildAttemptId(newStimulationId, 1);
+    this.send(ws, {
+      type: "stimulation.clone.accepted",
+      requestId: msg.requestId,
+      stimulationId: msg.stimulationId,
+      newStimulationId,
+      newStimulationAttemptId: stimulationAttemptId
+    });
+    const payload = JSON.stringify({
+      type: "cns.stimulation.launch",
+      requestId: msg.requestId,
+      scopeName: stim.scopeName,
+      stimulationId: newStimulationId,
+      stimulationAttemptId,
+      entry: stim.entry,
+      options: msg.options
+    });
+    for (const appWs of appSockets) {
+      try {
+        appWs.send(payload);
+      } catch {
+      }
+    }
+  }
   // ─── Broadcast helpers ────────────────────────────────────────────────────
   broadcast(message) {
     this.broadcastRaw(JSON.stringify(message));

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import {\n    CNSDTOApp,\n    CNSDTOAppBatchMessageSchema,\n    CNSDTOClientMessageSchema,\n    CNSDTOStimulation,\n    CNSDTOStimulationFilter,\n    CNSDTOHop,\n    CNSDTOTopologyMessage,\n} from '@cnstra/devtools-dto';\nimport { WebSocket } from 'ws';\n\n// ─── Repository interface ─────────────────────────────────────────────────────\n\nexport type CNSDTOTopologySnapshot = Omit<CNSDTOTopologyMessage, 'type'>;\n\nexport interface ICNSDevToolsServerRepository {\n    // Apps\n    upsertApp(app: CNSDTOApp): void | Promise<void>;\n    listApps(): CNSDTOApp[] | Promise<CNSDTOApp[]>;\n\n    // Topology\n    saveTopology(snapshot: CNSDTOTopologySnapshot): void | Promise<void>;\n    getTopology(cnsId?: string): CNSDTOTopologySnapshot[] | Promise<CNSDTOTopologySnapshot[]>;\n\n    // Stimulations\n    saveStimulation(stimulation: CNSDTOStimulation): void | Promise<void>;\n    completeStimulation(\n        stimulationId: string,\n        completedAt: number,\n        hopCount: number,\n        hasError: boolean\n    ): void | Promise<void>;\n    getStimulations(\n        appId: string,\n        filter: CNSDTOStimulationFilter\n    ): { items: CNSDTOStimulation[]; total: number } | Promise<{ items: CNSDTOStimulation[]; total: number }>;\n\n    // Hops\n    saveHop(hop: CNSDTOHop): void | Promise<void>;\n    getHops(stimulationId: string): CNSDTOHop[] | Promise<CNSDTOHop[]>;\n\n    // CNS ↔ App mapping\n    addCnsToApp(appId: string, cnsId: string): void | Promise<void>;\n    getCnsByApp(appId: string): string[] | Promise<string[]>;\n    findAppByCns(cnsId: string): string | undefined | Promise<string | undefined>;\n}\n\n// ─── Server ───────────────────────────────────────────────────────────────────\n\nexport class CNSDevToolsServer {\n    /** WebSocket → appId (for app clients) */\n    private appSockets = new Map<WebSocket, string>();\n    /** appId → WebSocket[] (one app may have multiple CNS instances) */\n    private appWsByAppId = new Map<string, Set<WebSocket>>();\n    /** WebSocket clients that registered as UI clients */\n    private uiClients = new Set<WebSocket>();\n\n    private metricsTimer?: NodeJS.Timeout;\n    private lastCpuUsage = process.cpuUsage();\n    private lastCpuTime = Date.now();\n\n    constructor(private readonly repository: ICNSDevToolsServerRepository) {}\n\n    // ─── Message entry point ─────────────────────────────────────────────────\n\n    async handleMessage(\n        ws: WebSocket,\n        raw: unknown\n    ): Promise<void> {\n        if (typeof raw !== 'string' && typeof raw !== 'object') return;\n\n        let data: unknown;\n        try {\n            data = typeof raw === 'string' ? JSON.parse(raw) : raw;\n        } catch {\n            return;\n        }\n\n        if (!data || typeof data !== 'object' || !('type' in data)) return;\n        const type = (data as any).type as string;\n\n        // App batch (topology + stimulation events)\n        if (type === 'batch') {\n            const result = CNSDTOAppBatchMessageSchema.safeParse(data);\n            if (!result.success) return;\n            for (const item of result.data.items) {\n                await this.handleAppBatchItem(ws, item);\n            }\n            return;\n        }\n\n        // UI client message\n        const clientResult = CNSDTOClientMessageSchema.safeParse(data);\n        if (!clientResult.success) return;\n        const msg = clientResult.data;\n\n        switch (msg.type) {\n            case 'client.connect':\n                await this.handleClientConnect(ws);\n                break;\n            case 'apps.query':\n                await this.handleAppsQuery(ws, msg.requestId);\n                break;\n            case 'topology.query':\n                await this.handleTopologyQuery(ws, msg.requestId, msg.cnsId, msg.appId);\n                break;\n            case 'stimulations.query':\n                await this.handleStimulationsQuery(ws, msg);\n                break;\n            case 'hops.query':\n                await this.handleHopsQuery(ws, msg);\n                break;\n            case 'replay.start':\n                await this.handleReplayStart(ws, msg);\n                break;\n        }\n    }\n\n    addClient(ws: WebSocket): void {\n        this.uiClients.add(ws);\n        if (this.uiClients.size === 1) this.startMetrics();\n    }\n\n    removeClient(ws: WebSocket): void {\n        this.uiClients.delete(ws);\n        this.appSockets.delete(ws);\n        if (this.uiClients.size === 0) this.stopMetrics();\n    }\n\n    async getActiveApps(): Promise<CNSDTOApp[]> {\n        return this.repository.listApps();\n    }\n\n    stop(): void {\n        this.stopMetrics();\n    }\n\n    // ─── App batch item handlers ──────────────────────────────────────────────\n\n    private async handleAppBatchItem(ws: WebSocket, item: any): Promise<void> {\n        switch (item.type) {\n            case 'topology':\n                await this.handleTopology(ws, item);\n                break;\n            case 'stimulation.started':\n                await this.handleStimulationStarted(ws, item.stimulation);\n                break;\n            case 'stimulation.hop':\n                await this.handleStimulationHop(item.hop);\n                break;\n            case 'stimulation.completed':\n                await this.handleStimulationCompleted(item);\n                break;\n        }\n    }\n\n    private async handleTopology(ws: WebSocket, msg: any): Promise<void> {\n        const { appId, cnsId, appName, version, timestamp, neurons, collaterals, dendrites } = msg;\n\n        const now = Date.now();\n        const app: CNSDTOApp = {\n            id: appId,\n            name: appName,\n            version,\n            connectedAt: now,\n            lastSeenAt: now,\n        };\n\n        await this.repository.upsertApp(app);\n        await this.repository.addCnsToApp(appId, cnsId);\n        await this.repository.saveTopology({ appId, cnsId, appName, version, timestamp, neurons, collaterals, dendrites });\n\n        // Track app socket\n        this.appSockets.set(ws, appId);\n        if (!this.appWsByAppId.has(appId)) this.appWsByAppId.set(appId, new Set());\n        this.appWsByAppId.get(appId)!.add(ws);\n\n        // Broadcast topology + app connected to UI clients\n        const topologyBroadcast = {\n            type: 'topology.result' as const,\n            requestId: '__broadcast__',\n            snapshots: await this.repository.getTopology(cnsId),\n        };\n\n        this.broadcast({ type: 'app.connected', app, topology: { cnsId, neurons, collaterals, dendrites } });\n        // Also send topology snapshot so UI can refresh graph\n        this.broadcastRaw(JSON.stringify(topologyBroadcast));\n    }\n\n    private async handleStimulationStarted(ws: WebSocket, stimulation: CNSDTOStimulation): Promise<void> {\n        // Update lastSeenAt for the app\n        const appId = this.appSockets.get(ws);\n        if (appId) {\n            const apps = await this.repository.listApps();\n            const app = apps.find(a => a.id === appId);\n            if (app) await this.repository.upsertApp({ ...app, lastSeenAt: Date.now() });\n        }\n\n        await this.repository.saveStimulation(stimulation);\n        this.broadcast({ type: 'stimulation.started', stimulation });\n    }\n\n    private async handleStimulationHop(hop: CNSDTOHop): Promise<void> {\n        await this.repository.saveHop(hop);\n        this.broadcast({ type: 'stimulation.hop', hop });\n    }\n\n    private async handleStimulationCompleted(item: any): Promise<void> {\n        await this.repository.completeStimulation(\n            item.stimulationId,\n            item.completedAt,\n            item.hopCount,\n            item.hasError\n        );\n        this.broadcast({\n            type: 'stimulation.completed',\n            stimulationId: item.stimulationId,\n            completedAt: item.completedAt,\n            hopCount: item.hopCount,\n            hasError: item.hasError,\n        });\n    }\n\n    // ─── UI client query handlers ─────────────────────────────────────────────\n\n    private async handleClientConnect(ws: WebSocket): Promise<void> {\n        this.addClient(ws);\n        this.send(ws, { type: 'apps.result', requestId: '__init__', items: await this.repository.listApps() });\n        this.send(ws, {\n            type: 'topology.result',\n            requestId: '__init__',\n            snapshots: await this.repository.getTopology(),\n        });\n    }\n\n    private async handleAppsQuery(ws: WebSocket, requestId: string): Promise<void> {\n        const items = await this.repository.listApps();\n        this.send(ws, { type: 'apps.result', requestId, items });\n    }\n\n    private async handleTopologyQuery(\n        ws: WebSocket,\n        requestId: string,\n        cnsId?: string,\n        appId?: string\n    ): Promise<void> {\n        let snapshots = await this.repository.getTopology(cnsId);\n        if (appId) snapshots = snapshots.filter(s => s.appId === appId);\n        this.send(ws, { type: 'topology.result', requestId, snapshots });\n    }\n\n    private async handleStimulationsQuery(ws: WebSocket, msg: any): Promise<void> {\n        const appId = msg.appId ?? (msg.cnsId ? await this.repository.findAppByCns(msg.cnsId) : undefined);\n\n        if (!appId) {\n            this.send(ws, { type: 'stimulations.result', requestId: msg.requestId, items: [], total: 0, offset: 0 });\n            return;\n        }\n\n        const { items, total } = await this.repository.getStimulations(appId, msg.filter ?? {});\n        this.send(ws, {\n            type: 'stimulations.result',\n            requestId: msg.requestId,\n            items,\n            total,\n            offset: msg.filter?.offset ?? 0,\n        });\n    }\n\n    private async handleHopsQuery(ws: WebSocket, msg: any): Promise<void> {\n        const items = await this.repository.getHops(msg.stimulationId);\n        this.send(ws, { type: 'hops.result', requestId: msg.requestId, items });\n    }\n\n    private async handleReplayStart(ws: WebSocket, msg: any): Promise<void> {\n        const appId = msg.appId ?? (msg.cnsId ? await this.repository.findAppByCns(msg.cnsId) : undefined);\n        const appSockets = appId ? this.appWsByAppId.get(appId) : undefined;\n\n        if (!appSockets || appSockets.size === 0) {\n            this.send(ws, { type: 'replay.rejected', replayId: msg.replayId, reason: 'App not connected' });\n            return;\n        }\n\n        const newStimulationId = `${msg.stimulationId}-replay-${Date.now()}`;\n        this.send(ws, { type: 'replay.accepted', replayId: msg.replayId, newStimulationId });\n\n        const payload = JSON.stringify(msg);\n        for (const appWs of appSockets) {\n            try { appWs.send(payload); } catch {}\n        }\n    }\n\n    // ─── Broadcast helpers ────────────────────────────────────────────────────\n\n    private broadcast(message: object): void {\n        this.broadcastRaw(JSON.stringify(message));\n    }\n\n    private broadcastRaw(payload: string): void {\n        for (const client of this.uiClients) {\n            try {\n                if ((client as any).readyState === 1) client.send(payload);\n            } catch {}\n        }\n    }\n\n    private send(ws: WebSocket, message: object): void {\n        try {\n            if ((ws as any).readyState === 1) ws.send(JSON.stringify(message));\n        } catch {}\n    }\n\n    // ─── Metrics ──────────────────────────────────────────────────────────────\n\n    private startMetrics(): void {\n        if (this.metricsTimer) return;\n        this.metricsTimer = setInterval(() => {\n            const mem = process.memoryUsage();\n            const now = Date.now();\n            const cpu = process.cpuUsage(this.lastCpuUsage);\n            const elapsed = (now - this.lastCpuTime) * 1000;\n            const cpuPercent = elapsed > 0 ? ((cpu.user + cpu.system) / elapsed) * 100 : 0;\n            this.lastCpuUsage = process.cpuUsage();\n            this.lastCpuTime = now;\n\n            this.broadcast({\n                type: 'server.metrics',\n                timestamp: now,\n                rssMB: mem.rss / 1024 / 1024,\n                heapUsedMB: mem.heapUsed / 1024 / 1024,\n                heapTotalMB: mem.heapTotal / 1024 / 1024,\n                cpuPercent,\n            });\n        }, 1000);\n    }\n\n    private stopMetrics(): void {\n        if (this.metricsTimer) {\n            clearInterval(this.metricsTimer);\n            this.metricsTimer = undefined;\n        }\n    }\n}\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import {\n    TCNSAppDTO,\n    CNSAppBatchMessageDTOSchema,\n    CNSClientMessageDTOSchema,\n    TCNSTopologyMessageDTO,\n} from '@cnstra/devtools-dto';\nimport type {\n    TCNSStimulationFilter,\n    TCNSStimulationTask,\n    TCNSStimulationAttempt,\n} from '@cnstra/devtools-dto';\nimport { buildAttemptId, buildCloneId } from '@cnstra/devtools-dto';\nimport type {\n    ICNSStimulationRepository,\n    TCNSStimulationRosterFilter,\n} from '@cnstra/persist';\nimport {\n    CNSInMemoryStimulationRepository,\n    supportsRosterQuery,\n    loadRosterEntries,\n    keysetPage,\n    computeRosterFacets,\n} from '@cnstra/persist';\nimport { WebSocket } from 'ws';\n\n// ─── Repository interface ─────────────────────────────────────────────────────\n\nexport type TCNSTopologySnapshotDTO = Omit<TCNSTopologyMessageDTO, 'type'>;\n\nexport interface ICNSDevToolsServerRepository {\n    // Apps\n    upsertApp(app: TCNSAppDTO): void | Promise<void>;\n    listApps(): TCNSAppDTO[] | Promise<TCNSAppDTO[]>;\n\n    // Topology\n    saveTopology(snapshot: TCNSTopologySnapshotDTO): void | Promise<void>;\n    getTopology(cnsId?: string): TCNSTopologySnapshotDTO[] | Promise<TCNSTopologySnapshotDTO[]>;\n\n    // CNS ↔ App mapping\n    addCnsToApp(appId: string, cnsId: string): void | Promise<void>;\n    getCnsByApp(appId: string): string[] | Promise<string[]>;\n    findAppByCns(cnsId: string): string | undefined | Promise<string | undefined>;\n}\n\n// ─── Server ───────────────────────────────────────────────────────────────────\n\nexport class CNSDevToolsServer {\n    /** WebSocket → appId (for app clients) */\n    private appSockets = new Map<WebSocket, string>();\n    /** appId → WebSocket[] (one app may have multiple CNS instances) */\n    private appWsByAppId = new Map<string, Set<WebSocket>>();\n    /** WebSocket clients that registered as UI clients */\n    private uiClients = new Set<WebSocket>();\n\n    private metricsTimer?: NodeJS.Timeout;\n    private lastCpuUsage = process.cpuUsage();\n    private lastCpuTime = Date.now();\n\n    /**\n     * Name-based resumable store (Stimulation/Attempt/Task). Written from the three\n     * `cns.stimulation*` batch items the producer emits when `trackStimulations` is on.\n     * Defaults to in-memory; the example-app can inject a Postgres store.\n     */\n    private readonly stimulationRepository: ICNSStimulationRepository;\n\n    constructor(\n        private readonly repository: ICNSDevToolsServerRepository,\n        stimulationRepository: ICNSStimulationRepository = new CNSInMemoryStimulationRepository()\n    ) {\n        this.stimulationRepository = stimulationRepository;\n    }\n\n    // ─── Message entry point ─────────────────────────────────────────────────\n\n    async handleMessage(\n        ws: WebSocket,\n        raw: unknown\n    ): Promise<void> {\n        if (typeof raw !== 'string' && typeof raw !== 'object') return;\n\n        let data: unknown;\n        try {\n            data = typeof raw === 'string' ? JSON.parse(raw) : raw;\n        } catch {\n            return;\n        }\n\n        if (!data || typeof data !== 'object' || !('type' in data)) return;\n        const type = (data as any).type as string;\n\n        // App batch (topology + stimulation events)\n        if (type === 'batch') {\n            const result = CNSAppBatchMessageDTOSchema.safeParse(data);\n            if (!result.success) return;\n            for (const item of result.data.items) {\n                await this.handleAppBatchItem(ws, item);\n            }\n            return;\n        }\n\n        // UI client message\n        const clientResult = CNSClientMessageDTOSchema.safeParse(data);\n        if (!clientResult.success) return;\n        const msg = clientResult.data;\n\n        switch (msg.type) {\n            case 'client.connect':\n                await this.handleClientConnect(ws);\n                break;\n            case 'apps.query':\n                await this.handleAppsQuery(ws, msg.requestId);\n                break;\n            case 'topology.query':\n                await this.handleTopologyQuery(ws, msg.requestId, msg.cnsId, msg.appId);\n                break;\n            case 'replay.start':\n                await this.handleReplayStart(ws, msg);\n                break;\n            case 'stimulation.retry':\n                await this.handleStimulationRetry(ws, msg);\n                break;\n            case 'stimulation.clone':\n                await this.handleStimulationClone(ws, msg);\n                break;\n            case 'cns.stimulations.list':\n                await this.handleStimulationsList(ws, msg);\n                break;\n            case 'cns.stimulations.facets':\n                await this.handleStimulationsFacets(ws, msg);\n                break;\n            case 'cns.stimulations.snapshot':\n                await this.handleStimulationsSnapshot(ws, msg);\n                break;\n            case 'cns.stimulation.detail':\n                await this.handleStimulationDetail(ws, msg);\n                break;\n        }\n    }\n\n    /**\n     * Explorer protocol (bucket-shaped). The roster row = resumable state minus\n     * `progress`, plus envelope summaries derived from the run's attempts.\n     *\n     * Pushdown: if the store implements `ICNSStimulationRosterQuery` (e.g. the\n     * Postgres store), the filter + keyset + GROUP BY run INSIDE it (SQL). Else we\n     * fall back to the shared reference derivation over the reader — identical\n     * results, only the work moves. Roster shapes are structurally the wire DTOs,\n     * so no mapping is needed at the boundary.\n     */\n    private toRosterFilter(\n        scopeName: string | undefined,\n        filter: TCNSStimulationFilter | undefined\n    ): TCNSStimulationRosterFilter {\n        return { ...(filter ?? {}), ...(scopeName ? { scopeName } : {}) };\n    }\n\n    private async handleStimulationsList(\n        ws: WebSocket,\n        msg: any\n    ): Promise<void> {\n        const filter = this.toRosterFilter(msg.scopeName, msg.filter);\n        const limit = typeof msg.limit === 'number' ? msg.limit : 50;\n        const opts = { cursor: msg.cursor, limit };\n        const store = this.stimulationRepository;\n        const page = supportsRosterQuery(store)\n            ? await store.queryRoster(filter, opts)\n            : keysetPage(\n                  (await loadRosterEntries(store, filter)).map(e => e.row),\n                  opts\n              );\n        this.send(ws, {\n            type: 'cns.stimulations.list.result',\n            requestId: msg.requestId,\n            stimulations: page.rows,\n            nextCursor: page.nextCursor,\n            total: page.total,\n        });\n    }\n\n    private async handleStimulationsFacets(\n        ws: WebSocket,\n        msg: any\n    ): Promise<void> {\n        const filter = this.toRosterFilter(msg.scopeName, msg.filter);\n        const store = this.stimulationRepository;\n        const facets = supportsRosterQuery(store)\n            ? await store.queryFacets(filter, { metricPath: msg.metricPath })\n            : computeRosterFacets(await loadRosterEntries(store, filter), {\n                  metricPath: msg.metricPath,\n              });\n        this.send(ws, {\n            type: 'cns.stimulations.facets.result',\n            requestId: msg.requestId,\n            facets,\n        });\n    }\n\n    private async handleStimulationDetail(\n        ws: WebSocket,\n        msg: any\n    ): Promise<void> {\n        const attempts = await this.stimulationRepository.getAttempts(\n            msg.stimulationId\n        );\n        const tasks: TCNSStimulationTask[] = [];\n        for (const a of attempts) {\n            const ts = await this.stimulationRepository.getTasks(\n                a.stimulationAttemptId\n            );\n            tasks.push(...ts);\n        }\n        this.send(ws, {\n            type: 'cns.stimulation.detail.result',\n            requestId: msg.requestId,\n            attempts,\n            tasks,\n        });\n    }\n\n    /**\n     * The topology/signal views' bulk feed: a bounded, newest-first set of runs as\n     * FLAT buckets (stimulations + attempts + tasks) the panel joins client-side by\n     * id. Replaces the retired nested `cns.stimulations.query` tree — same data, no\n     * server-side join, no client-side flatten.\n     */\n    private async handleStimulationsSnapshot(\n        ws: WebSocket,\n        msg: any\n    ): Promise<void> {\n        const filter = this.toRosterFilter(msg.scopeName, msg.filter);\n        const store = this.stimulationRepository;\n        const limit = typeof msg.limit === 'number' ? msg.limit : 200;\n        const page = supportsRosterQuery(store)\n            ? await store.queryRoster(filter, { limit })\n            : keysetPage(\n                  (await loadRosterEntries(store, filter)).map(e => e.row),\n                  { limit }\n              );\n        const attempts: TCNSStimulationAttempt[] = [];\n        const tasks: TCNSStimulationTask[] = [];\n        for (const row of page.rows) {\n            const as = await store.getAttempts(row.stimulationId);\n            attempts.push(...as);\n            for (const a of as)\n                tasks.push(...(await store.getTasks(a.stimulationAttemptId)));\n        }\n        this.send(ws, {\n            type: 'cns.stimulations.snapshot.result',\n            requestId: msg.requestId,\n            stimulations: page.rows,\n            attempts,\n            tasks,\n        });\n    }\n\n    addClient(ws: WebSocket): void {\n        this.uiClients.add(ws);\n        if (this.uiClients.size === 1) this.startMetrics();\n    }\n\n    removeClient(ws: WebSocket): void {\n        this.uiClients.delete(ws);\n        this.appSockets.delete(ws);\n        if (this.uiClients.size === 0) this.stopMetrics();\n    }\n\n    async getActiveApps(): Promise<TCNSAppDTO[]> {\n        return this.repository.listApps();\n    }\n\n    stop(): void {\n        this.stopMetrics();\n    }\n\n    // ─── App batch item handlers ──────────────────────────────────────────────\n\n    private async handleAppBatchItem(ws: WebSocket, item: any): Promise<void> {\n        switch (item.type) {\n            case 'topology':\n                await this.handleTopology(ws, item);\n                break;\n            // ── Name-based resumable model ──\n            case 'cns.stimulation':\n                await this.stimulationRepository.saveStimulation(item.data);\n                break;\n            case 'cns.stimulation.attempt':\n                await this.stimulationRepository.saveAttempt(item.data);\n                break;\n            case 'cns.stimulation.task':\n                await this.stimulationRepository.appendTask(item.data);\n                break;\n        }\n    }\n\n    /** The name-based resumable store, for tests/integrations that want to read it back. */\n    getStimulationRepository(): ICNSStimulationRepository {\n        return this.stimulationRepository;\n    }\n\n    private async handleTopology(ws: WebSocket, msg: any): Promise<void> {\n        const { appId, cnsId, appName, version, timestamp, neurons, collaterals, dendrites } = msg;\n\n        const now = Date.now();\n        const app: TCNSAppDTO = {\n            id: appId,\n            name: appName,\n            version,\n            connectedAt: now,\n            lastSeenAt: now,\n        };\n\n        await this.repository.upsertApp(app);\n        await this.repository.addCnsToApp(appId, cnsId);\n        await this.repository.saveTopology({ appId, cnsId, appName, version, timestamp, neurons, collaterals, dendrites });\n\n        // Track app socket\n        this.appSockets.set(ws, appId);\n        if (!this.appWsByAppId.has(appId)) this.appWsByAppId.set(appId, new Set());\n        this.appWsByAppId.get(appId)!.add(ws);\n\n        // Broadcast topology + app connected to UI clients\n        const topologyBroadcast = {\n            type: 'topology.result' as const,\n            requestId: '__broadcast__',\n            snapshots: await this.repository.getTopology(cnsId),\n        };\n\n        this.broadcast({ type: 'app.connected', app, topology: { cnsId, neurons, collaterals, dendrites } });\n        // Also send topology snapshot so UI can refresh graph\n        this.broadcastRaw(JSON.stringify(topologyBroadcast));\n    }\n\n    // ─── UI client query handlers ─────────────────────────────────────────────\n\n    private async handleClientConnect(ws: WebSocket): Promise<void> {\n        this.addClient(ws);\n        this.send(ws, { type: 'apps.result', requestId: '__init__', items: await this.repository.listApps() });\n        this.send(ws, {\n            type: 'topology.result',\n            requestId: '__init__',\n            snapshots: await this.repository.getTopology(),\n        });\n    }\n\n    private async handleAppsQuery(ws: WebSocket, requestId: string): Promise<void> {\n        const items = await this.repository.listApps();\n        this.send(ws, { type: 'apps.result', requestId, items });\n    }\n\n    private async handleTopologyQuery(\n        ws: WebSocket,\n        requestId: string,\n        cnsId?: string,\n        appId?: string\n    ): Promise<void> {\n        let snapshots = await this.repository.getTopology(cnsId);\n        if (appId) snapshots = snapshots.filter(s => s.appId === appId);\n        this.send(ws, { type: 'topology.result', requestId, snapshots });\n    }\n\n    private async handleReplayStart(ws: WebSocket, msg: any): Promise<void> {\n        const appId = msg.appId ?? (msg.cnsId ? await this.repository.findAppByCns(msg.cnsId) : undefined);\n        const appSockets = appId ? this.appWsByAppId.get(appId) : undefined;\n\n        if (!appSockets || appSockets.size === 0) {\n            this.send(ws, { type: 'replay.rejected', replayId: msg.replayId, reason: 'App not connected' });\n            return;\n        }\n\n        const newStimulationId = `${msg.stimulationId}-replay-${Date.now()}`;\n        this.send(ws, { type: 'replay.accepted', replayId: msg.replayId, newStimulationId });\n\n        const payload = JSON.stringify(msg);\n        for (const appWs of appSockets) {\n            try { appWs.send(payload); } catch {}\n        }\n    }\n\n    // ─── Resumable actions (retry / clone), Phase 2b-2 ──────────────────────────────\n    //\n    // The UI's request is thin (a stimulationId). The CNS + name→ref registry live in\n    // the APP, so the server can't execute it: it ENRICHES from the resumable store (the\n    // stored entry + progress + a server-assigned attempt identity) and forwards a\n    // resume/launch command to the owning app, routed by scopeName (= the cns id).\n\n    /** Resolve the app that owns a stimulation's scope, or reject if unreachable. */\n    private async resolveScopeApp(\n        scopeName: string | undefined\n    ): Promise<Set<WebSocket> | undefined> {\n        const appId = scopeName\n            ? await this.repository.findAppByCns(scopeName)\n            : undefined;\n        const sockets = appId ? this.appWsByAppId.get(appId) : undefined;\n        return sockets && sockets.size > 0 ? sockets : undefined;\n    }\n\n    private async handleStimulationRetry(ws: WebSocket, msg: any): Promise<void> {\n        const reject = (reason: string) =>\n            this.send(ws, {\n                type: 'stimulation.retry.rejected',\n                requestId: msg.requestId,\n                stimulationId: msg.stimulationId,\n                reason,\n            });\n\n        const stim = await this.stimulationRepository.getStimulation(msg.stimulationId);\n        if (!stim) return reject('unknown stimulation');\n        if (stim.progress.tasks.length === 0)\n            return reject('nothing to resume (empty frontier)');\n\n        const appSockets = await this.resolveScopeApp(stim.scopeName);\n        if (!appSockets) return reject('app not connected');\n\n        const attempts = await this.stimulationRepository.getAttempts(msg.stimulationId);\n        const nextAttempt = attempts.length + 1;\n        const stimulationAttemptId = buildAttemptId(msg.stimulationId, nextAttempt);\n\n        this.send(ws, {\n            type: 'stimulation.retry.accepted',\n            requestId: msg.requestId,\n            stimulationId: msg.stimulationId,\n            newStimulationAttemptId: stimulationAttemptId,\n        });\n\n        const payload = JSON.stringify({\n            type: 'cns.stimulation.resume',\n            requestId: msg.requestId,\n            scopeName: stim.scopeName,\n            stimulationId: msg.stimulationId,\n            stimulationAttemptId,\n            attemptNumber: nextAttempt,\n            entry: stim.entry,\n            progress: stim.progress,\n            options: msg.options,\n        });\n        for (const appWs of appSockets) {\n            try { appWs.send(payload); } catch {}\n        }\n    }\n\n    private async handleStimulationClone(ws: WebSocket, msg: any): Promise<void> {\n        const reject = (reason: string) =>\n            this.send(ws, {\n                type: 'stimulation.clone.rejected',\n                requestId: msg.requestId,\n                stimulationId: msg.stimulationId,\n                reason,\n            });\n\n        const stim = await this.stimulationRepository.getStimulation(msg.stimulationId);\n        if (!stim) return reject('unknown stimulation');\n\n        const appSockets = await this.resolveScopeApp(stim.scopeName);\n        if (!appSockets) return reject('app not connected');\n\n        const newStimulationId = buildCloneId(msg.stimulationId);\n        const stimulationAttemptId = buildAttemptId(newStimulationId, 1);\n\n        this.send(ws, {\n            type: 'stimulation.clone.accepted',\n            requestId: msg.requestId,\n            stimulationId: msg.stimulationId,\n            newStimulationId,\n            newStimulationAttemptId: stimulationAttemptId,\n        });\n\n        const payload = JSON.stringify({\n            type: 'cns.stimulation.launch',\n            requestId: msg.requestId,\n            scopeName: stim.scopeName,\n            stimulationId: newStimulationId,\n            stimulationAttemptId,\n            entry: stim.entry,\n            options: msg.options,\n        });\n        for (const appWs of appSockets) {\n            try { appWs.send(payload); } catch {}\n        }\n    }\n\n    // ─── Broadcast helpers ────────────────────────────────────────────────────\n\n    private broadcast(message: object): void {\n        this.broadcastRaw(JSON.stringify(message));\n    }\n\n    private broadcastRaw(payload: string): void {\n        for (const client of this.uiClients) {\n            try {\n                if ((client as any).readyState === 1) client.send(payload);\n            } catch {}\n        }\n    }\n\n    private send(ws: WebSocket, message: object): void {\n        try {\n            if ((ws as any).readyState === 1) ws.send(JSON.stringify(message));\n        } catch {}\n    }\n\n    // ─── Metrics ──────────────────────────────────────────────────────────────\n\n    private startMetrics(): void {\n        if (this.metricsTimer) return;\n        this.metricsTimer = setInterval(() => {\n            const mem = process.memoryUsage();\n            const now = Date.now();\n            const cpu = process.cpuUsage(this.lastCpuUsage);\n            const elapsed = (now - this.lastCpuTime) * 1000;\n            const cpuPercent = elapsed > 0 ? ((cpu.user + cpu.system) / elapsed) * 100 : 0;\n            this.lastCpuUsage = process.cpuUsage();\n            this.lastCpuTime = now;\n\n            this.broadcast({\n                type: 'server.metrics',\n                timestamp: now,\n                rssMB: mem.rss / 1024 / 1024,\n                heapUsedMB: mem.heapUsed / 1024 / 1024,\n                heapTotalMB: mem.heapTotal / 1024 / 1024,\n                cpuPercent,\n            });\n        }, 1000);\n    }\n\n    private stopMetrics(): void {\n        if (this.metricsTimer) {\n            clearInterval(this.metricsTimer);\n            this.metricsTimer = undefined;\n        }\n    }\n}\n"]}

package/dist/start.d.ts

@@ -1,4 +1,5 @@
-import type { ICNS, TCNSNeuron, CNSPersistOptionsRegistry } from '@cnstra/core';
+import type { CNSPersistOptionsRegistry, ICNSStimulationRepository } from '@cnstra/persist';
+import type { ICNS, TCNSNeuron } from '@cnstra/types';
 export type StartDevToolsOptions = {
     /** Port for HTTP (UI) and WebSocket. Default: 3141 */
     port?: number;
@@ -7,6 +8,15 @@ export type StartDevToolsOptions = {
     /** App ID shown in DevTools. Default: 'app' */
     appId?: string;
     consoleLogEnabled?: boolean;
+    /**
+     * The canonical name-based Stimulation → Attempt → Task store the Explorer
+     * reads its runs / facets / waterfall from. Pass the SAME instance you give a
+     * pg-boss / BullMQ worker as its `observe` store, and every job run shows up
+     * in the Explorer live (one process, shared memory). Use a
+     * `CNSPostgresStimulationRepository` to keep history across restarts, or omit
+     * for a fresh ephemeral in-memory store.
+     */
+    stimulationRepository?: ICNSStimulationRepository;
 };
 export type DevToolsHandle = {
     url: string;
@@ -23,5 +33,5 @@ export type DevToolsHandle = {
  * await startDevTools(cns, registry);
  * // → 🧠 CNStra DevTools: http://localhost:3141
  */
-export declare function startDevTools(cns: ICNS<TCNSNeuron<any, any>>, registry: CNSPersistOptionsRegistry, options?: StartDevToolsOptions): Promise<DevToolsHandle>;
+export declare function startDevTools(cns: ICNS<TCNSNeuron<any>>, registry: CNSPersistOptionsRegistry, options?: StartDevToolsOptions): Promise<DevToolsHandle>;
 //# sourceMappingURL=start.d.ts.map

package/dist/start.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AA6ChF,MAAM,MAAM,oBAAoB,GAAG;IAC/B,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,IAAI,CAAC;CACpB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CAC/B,GAAG,EAAE,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,EAC/B,QAAQ,EAAE,yBAAyB,EACnC,OAAO,GAAE,oBAAyB,GACnC,OAAO,CAAC,cAAc,CAAC,CAiEzB"}
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACR,yBAAyB,EACzB,yBAAyB,EAC5B,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AA6CtD,MAAM,MAAM,oBAAoB,GAAG;IAC/B,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;;;;OAOG;IACH,qBAAqB,CAAC,EAAE,yBAAyB,CAAC;CACrD,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,IAAI,CAAC;CACpB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CAC/B,GAAG,EAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAC1B,QAAQ,EAAE,yBAAyB,EACnC,OAAO,GAAE,oBAAyB,GACnC,OAAO,CAAC,cAAc,CAAC,CAoEzB"}

package/package.json

@@ -1,71 +1,79 @@
 {
-  "name": "@cnstra/devtools-server",
-  "version": "1.2.0",
-  "description": "CNStra DevTools server (WebSocket only for now)",
-  "keywords": [
-    "cnstra",
-    "devtools",
-    "server",
-    "websocket"
-  ],
-  "type": "module",
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "sideEffects": false,
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
-    }
-  },
-  "bin": {
-    "cnstra-devtools": "./dist/cli.js"
-  },
-  "scripts": {
-    "build": "tsup && tsc --emitDeclarationOnly",
-    "build:types": "tsc --emitDeclarationOnly",
-    "start": "node dist/index.js",
-    "prepublishOnly": "npm run test && npm run build",
-    "test": "jest"
-  },
-  "files": [
-    "dist"
-  ],
-  "dependencies": {
-    "@cnstra/devtools-dto": "^1.0.0",
-    "@cnstra/devtools-server-repository-in-memory": "^1.1.0",
-    "ws": "^8.18.0"
-  },
-  "peerDependencies": {
-    "@cnstra/core": "^2.1.0",
-    "@cnstra/devtools": "^1.0.1",
-    "@cnstra/devtools-panel-ui": "^1.0.0",
-    "@cnstra/devtools-transport-ws": "^1.0.0"
-  },
-  "peerDependenciesMeta": {
-    "@cnstra/devtools-panel-ui": {
-      "optional": true
+    "name": "@cnstra/devtools-server",
+    "version": "3.0.0",
+    "description": "CNStra DevTools server (WebSocket only for now)",
+    "keywords": [
+        "cnstra",
+        "devtools",
+        "server",
+        "websocket"
+    ],
+    "type": "module",
+    "main": "./dist/index.cjs",
+    "module": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "sideEffects": false,
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js",
+            "require": "./dist/index.cjs"
+        }
+    },
+    "bin": {
+        "cnstra-devtools": "./dist/cli.js"
+    },
+    "scripts": {
+        "build": "tsup && tsc --emitDeclarationOnly",
+        "build:types": "tsc --emitDeclarationOnly",
+        "start": "node dist/index.js",
+        "prepublishOnly": "node ../../scripts/check-drift.mjs --gate && npm run test && npm run build",
+        "test": "jest"
+    },
+    "files": [
+        "dist"
+    ],
+    "dependencies": {
+        "@cnstra/devtools-dto": "^3.0.0",
+        "@cnstra/devtools-server-repository-in-memory": "^3.0.0",
+        "@cnstra/types": "^0.2.0",
+        "ws": "^8.18.0"
+    },
+    "peerDependencies": {
+        "@cnstra/core": "^3.0.0",
+        "@cnstra/devtools": "^3.0.0",
+        "@cnstra/devtools-panel-ui": "^3.0.0",
+        "@cnstra/devtools-transport-ws": "^2.0.0",
+        "@cnstra/persist": "^0.2.0"
+    },
+    "devDependencies": {
+        "@cnstra/broker": "^0.2.0",
+        "@cnstra/core": "^3.0.0",
+        "@cnstra/devtools": "^3.0.0",
+        "@cnstra/devtools-panel-ui": "^3.0.0",
+        "@cnstra/devtools-transport-ws": "^2.0.0",
+        "@cnstra/persist": "^0.2.0",
+        "@types/node": "^22.7.4",
+        "@types/ws": "^8.5.10",
+        "jest": "^29.7.0",
+        "ts-jest": "^29.1.2",
+        "tsup": "8.5.1",
+        "typescript": "^5.8.3"
     },
-    "@cnstra/devtools": {
-      "optional": true
+    "peerDependenciesMeta": {
+        "@cnstra/devtools-panel-ui": {
+            "optional": true
+        },
+        "@cnstra/devtools": {
+            "optional": true
+        },
+        "@cnstra/devtools-transport-ws": {
+            "optional": true
+        }
     },
-    "@cnstra/devtools-transport-ws": {
-      "optional": true
+    "author": "Andrei Baikov <abaikov23@gmail.com>",
+    "license": "MIT",
+    "publishConfig": {
+        "access": "public"
     }
-  },
-  "devDependencies": {
-    "@types/node": "^22.7.4",
-    "@types/ws": "^8.5.10",
-    "jest": "^29.7.0",
-    "ts-jest": "^29.1.2",
-    "tsup": "8.5.1",
-    "typescript": "^5.8.3"
-  },
-  "author": "Andrei Baikov <abaikov23@gmail.com>",
-  "license": "MIT",
-  "publishConfig": {
-    "access": "public"
-  }
 }