@sanctuary-framework/mcp-server 1.1.4 → 1.1.6

package/dist/index.d.cts

@@ -4325,6 +4325,12 @@ interface HubPolicyAndBudgetSources {
  * may persist records to disk or recompute them per call.
  */
 interface HubAgentRegistrySource {
+    /**
+     * Insert or replace a record. Used by wrap-side registration and by
+     * read-side persistence refresh to merge records written after dashboard
+     * boot.
+     */
+    put(record: LocalAgentRecord): void;
     list(filter?: LocalAgentRegistryFilter): LocalAgentRecord[];
     get(agentId: string): LocalAgentRecord | null;
     /**
@@ -4350,6 +4356,12 @@ interface HubServiceDeps {
     fortressId: string;
     /** Local agent registry source. */
     agentRegistry: HubAgentRegistrySource;
+    /**
+     * Optional best-effort persisted agent reader. When supplied, list
+     * operations merge records written after hub construction before
+     * returning the in-memory projection.
+     */
+    readPersistedLocalAgents?: () => LocalAgentRecord[];
     /** Inbox aggregation sources. */
     inboxSources: HubInboxSources;
     /** Activity feed sources. */
@@ -4403,6 +4415,7 @@ declare class HubService {
     constructor(deps: HubServiceDeps);
     private now;
     private nowIso;
+    private refreshPersistedLocalAgents;
     listInbox(): HubInboxItem[];
     resolveInboxItem(itemId: string, action: HubInboxAction): Promise<HubInboxItem>;
     listAgents(filter?: LocalAgentRegistryFilter): LocalAgentRecord[];
@@ -4474,7 +4487,7 @@ declare class HubService {
 }
 
 /**
- * v1.1 Server Wiring (v1.1.1 hotfix)
+ * v1.1 Server Wiring (v1.1.1 hotfix; agent-registry persistence in v1.1.5)
  *
  * v1.1.0 shipped the v1.1 module suite (dashboard / hub API / exit bundle
  * endpoints / coordination) but no entry-point server imported any of it.
@@ -4484,10 +4497,13 @@ declare class HubService {
  *
  * The wiring is deliberately minimal at v1.1.1:
  *
- *   - Local agent registry starts empty. v1.2 will populate it from
- *     `discoverTenants()` and the wrapped harness manifest. v1.1.1 ships
- *     the API surface so existing operator scripts can hit it; the data
- *     plane is the next conversation.
+ *   - Local agent registry starts empty by default. v1.1.5 (Finding Z)
+ *     adds an optional `storagePath` input that rehydrates the registry
+ *     from `<storagePath>/state/_hub/local-agents.json`, written by
+ *     `sanctuary wrap` for each successfully wrapped harness. Callers
+ *     that pass `storagePath` get the wrap-populated set; callers that
+ *     omit it (legacy) keep the empty-by-default behavior. Real
+ *     harness-discovery via `discoverTenants()` remains v1.2 work.
  *   - Inbox sources return empty arrays. The privacy chokepoint already
  *     emits audit events through PR #69 / PR #71; the inbox aggregator is
  *     the v1.2 work to project those into operator cards.

package/dist/index.d.ts

@@ -4325,6 +4325,12 @@ interface HubPolicyAndBudgetSources {
  * may persist records to disk or recompute them per call.
  */
 interface HubAgentRegistrySource {
+    /**
+     * Insert or replace a record. Used by wrap-side registration and by
+     * read-side persistence refresh to merge records written after dashboard
+     * boot.
+     */
+    put(record: LocalAgentRecord): void;
     list(filter?: LocalAgentRegistryFilter): LocalAgentRecord[];
     get(agentId: string): LocalAgentRecord | null;
     /**
@@ -4350,6 +4356,12 @@ interface HubServiceDeps {
     fortressId: string;
     /** Local agent registry source. */
     agentRegistry: HubAgentRegistrySource;
+    /**
+     * Optional best-effort persisted agent reader. When supplied, list
+     * operations merge records written after hub construction before
+     * returning the in-memory projection.
+     */
+    readPersistedLocalAgents?: () => LocalAgentRecord[];
     /** Inbox aggregation sources. */
     inboxSources: HubInboxSources;
     /** Activity feed sources. */
@@ -4403,6 +4415,7 @@ declare class HubService {
     constructor(deps: HubServiceDeps);
     private now;
     private nowIso;
+    private refreshPersistedLocalAgents;
     listInbox(): HubInboxItem[];
     resolveInboxItem(itemId: string, action: HubInboxAction): Promise<HubInboxItem>;
     listAgents(filter?: LocalAgentRegistryFilter): LocalAgentRecord[];
@@ -4474,7 +4487,7 @@ declare class HubService {
 }
 
 /**
- * v1.1 Server Wiring (v1.1.1 hotfix)
+ * v1.1 Server Wiring (v1.1.1 hotfix; agent-registry persistence in v1.1.5)
  *
  * v1.1.0 shipped the v1.1 module suite (dashboard / hub API / exit bundle
  * endpoints / coordination) but no entry-point server imported any of it.
@@ -4484,10 +4497,13 @@ declare class HubService {
  *
  * The wiring is deliberately minimal at v1.1.1:
  *
- *   - Local agent registry starts empty. v1.2 will populate it from
- *     `discoverTenants()` and the wrapped harness manifest. v1.1.1 ships
- *     the API surface so existing operator scripts can hit it; the data
- *     plane is the next conversation.
+ *   - Local agent registry starts empty by default. v1.1.5 (Finding Z)
+ *     adds an optional `storagePath` input that rehydrates the registry
+ *     from `<storagePath>/state/_hub/local-agents.json`, written by
+ *     `sanctuary wrap` for each successfully wrapped harness. Callers
+ *     that pass `storagePath` get the wrap-populated set; callers that
+ *     omit it (legacy) keep the empty-by-default behavior. Real
+ *     harness-discovery via `discoverTenants()` remains v1.2 work.
  *   - Inbox sources return empty arrays. The privacy chokepoint already
  *     emits audit events through PR #69 / PR #71; the inbox aggregator is
  *     the v1.2 work to project those into operator cards.

package/dist/index.js

@@ -14,7 +14,7 @@ import { ListToolsRequestSchema, CallToolRequestSchema } from '@modelcontextprot
 import { createServer as createServer$2 } from 'http';
 import { createServer as createServer$1 } from 'https';
 import { exec, execSync, spawn } from 'child_process';
-import { statSync, existsSync, readFileSync } from 'fs';
+import { existsSync, readFileSync, statSync } from 'fs';
 import { fileURLToPath } from 'url';
 import { Client } from '@modelcontextprotocol/sdk/client/index.js';
 import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
@@ -26871,6 +26871,13 @@ var HubService = class {
   nowIso() {
     return this.now().toISOString();
   }
+  refreshPersistedLocalAgents() {
+    const readPersistedLocalAgents2 = this.deps.readPersistedLocalAgents;
+    if (!readPersistedLocalAgents2) return;
+    for (const record of readPersistedLocalAgents2()) {
+      this.deps.agentRegistry.put(record);
+    }
+  }
   // ── Inbox ───────────────────────────────────────────────────────────
   listInbox() {
     const items = aggregateInbox(this.deps.inboxSources, this.inboxStore);
@@ -26882,6 +26889,7 @@ var HubService = class {
   }
   // ── Agents ──────────────────────────────────────────────────────────
   listAgents(filter) {
+    this.refreshPersistedLocalAgents();
     const safeFilter = {
       ...filter ?? {},
       identity_id: this.deps.identityId
@@ -27298,6 +27306,21 @@ var HubService = class {
     return this.inboxStore.size();
   }
 };
+function localAgentsFilePath(storagePath) {
+  return join(storagePath, "state", "_hub", "local-agents.json");
+}
+function readPersistedLocalAgents(storagePath) {
+  const filePath = localAgentsFilePath(storagePath);
+  if (!existsSync(filePath)) return [];
+  try {
+    const raw = readFileSync(filePath, "utf8");
+    const parsed = JSON.parse(raw);
+    if (!parsed || !Array.isArray(parsed.agents)) return [];
+    return parsed.agents;
+  } catch {
+    return [];
+  }
+}
 
 // src/dashboard/v1_1/wiring.ts
 var CapabilityErrorAgentController = class {
@@ -27329,11 +27352,15 @@ var CapabilityErrorAgentController = class {
   }
 };
 function buildV11Bindings(inputs) {
-  const registry = new InMemoryLocalAgentRegistry([]);
+  const seed = inputs.storagePath !== void 0 ? readPersistedLocalAgents(inputs.storagePath) : [];
+  const registry = new InMemoryLocalAgentRegistry(seed);
+  const storagePath = inputs.storagePath;
+  const readPersisted = storagePath !== void 0 ? () => readPersistedLocalAgents(storagePath) : void 0;
   const hubService = new HubService({
     identityId: inputs.identityId,
     fortressId: inputs.fortressId,
     agentRegistry: registry,
+    ...readPersisted ? { readPersistedLocalAgents: readPersisted } : {},
     inboxSources: {
       listPendingApprovals: () => [],
       listRecentBlockedEgress: () => [],
@@ -29429,7 +29456,12 @@ Refusing to start the cocoon while the reset-history marker is unreadable.`
       buildV11Bindings({
         identityId: embeddedHubIdentityId,
         fortressId: fortressIdFromStoragePath(config.storage_path),
-        auditLog
+        auditLog,
+        // v1.1.5 (Finding Z): rehydrate the hub agent registry from
+        // `<storagePath>/state/_hub/local-agents.json` so the embedded
+        // dashboard surfaces wraps performed by prior `sanctuary wrap`
+        // invocations against this same fortress.
+        storagePath: config.storage_path
       })
     );
     await dashboard.start();