@cleocode/brain 2026.6.14 → 2026.6.17

package/dist/src/adapters/agent-registry.d.ts

@@ -0,0 +1,35 @@
+/**
+ * AGENT-REGISTRY substrate adapter for the Living Brain API.
+ *
+ * Read-only visualization path. Queries the LEGACY standalone `signaldock.db`
+ * (resolved by `getAgentRegistryDbPath`) and returns BrainNodes/BrainEdges for
+ * agents and agent-to-agent social connections. The legacy standalone file still
+ * carries the BARE table names (`agents`, `agent_connections`); the brain-package
+ * read path is migrated to the consolidated `cleo.db` separately in E6 (T11249),
+ * so the SQL below intentionally still targets the bare names.
+ *
+ * The substrate identifier + node-id prefix were renamed `signaldock` →
+ * `agent-registry` under T11622 (display identifiers, decoupled from the physical
+ * table names).
+ *
+ * Node IDs are prefixed with "agent-registry:" to prevent collisions.
+ * Agents are the cross-substrate identity bridge — they appear in TASKS
+ * (assignee), CONDUIT (from/to), and BRAIN (source agent).
+ *
+ * @task T11622 (Signaldock → Agent Registry rename; folds T11578 AC2)
+ */
+import type { BrainEdge, BrainNode, BrainQueryOptions } from '../types.js';
+/**
+ * Returns all BrainNodes and BrainEdges sourced from the Agent Registry.
+ *
+ * Fetches all active agents plus their declared connections.
+ * Agent nodes serve as the cross-substrate identity anchors.
+ *
+ * @param options - Query options (limit).
+ * @returns Nodes and edges from the AGENT-REGISTRY substrate.
+ */
+export declare function getAgentRegistrySubstrate(options?: BrainQueryOptions): {
+    nodes: BrainNode[];
+    edges: BrainEdge[];
+};
+//# sourceMappingURL=agent-registry.d.ts.map

package/dist/src/adapters/agent-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-registry.d.ts","sourceRoot":"","sources":["../../../src/adapters/agent-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AA+B3E;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,GAAE,iBAAsB,GAAG;IAC1E,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB,CAoEA"}

package/dist/src/adapters/agent-registry.js

@@ -0,0 +1,96 @@
+/**
+ * AGENT-REGISTRY substrate adapter for the Living Brain API.
+ *
+ * Read-only visualization path. Queries the LEGACY standalone `signaldock.db`
+ * (resolved by `getAgentRegistryDbPath`) and returns BrainNodes/BrainEdges for
+ * agents and agent-to-agent social connections. The legacy standalone file still
+ * carries the BARE table names (`agents`, `agent_connections`); the brain-package
+ * read path is migrated to the consolidated `cleo.db` separately in E6 (T11249),
+ * so the SQL below intentionally still targets the bare names.
+ *
+ * The substrate identifier + node-id prefix were renamed `signaldock` →
+ * `agent-registry` under T11622 (display identifiers, decoupled from the physical
+ * table names).
+ *
+ * Node IDs are prefixed with "agent-registry:" to prevent collisions.
+ * Agents are the cross-substrate identity bridge — they appear in TASKS
+ * (assignee), CONDUIT (from/to), and BRAIN (source agent).
+ *
+ * @task T11622 (Signaldock → Agent Registry rename; folds T11578 AC2)
+ */
+import { allTyped, getAgentRegistryDb } from '../db-connections.js';
+/**
+ * Converts a UNIX epoch seconds value to an ISO-8601 string.
+ * Returns null when the value is not a finite positive number.
+ *
+ * @param epoch - UNIX timestamp in seconds, or null.
+ * @returns ISO-8601 string or null.
+ */
+function epochToIso(epoch) {
+    if (epoch === null || !Number.isFinite(epoch) || epoch <= 0)
+        return null;
+    return new Date(epoch * 1000).toISOString();
+}
+/**
+ * Returns all BrainNodes and BrainEdges sourced from the Agent Registry.
+ *
+ * Fetches all active agents plus their declared connections.
+ * Agent nodes serve as the cross-substrate identity anchors.
+ *
+ * @param options - Query options (limit).
+ * @returns Nodes and edges from the AGENT-REGISTRY substrate.
+ */
+export function getAgentRegistrySubstrate(options = {}) {
+    const db = getAgentRegistryDb();
+    if (!db)
+        return { nodes: [], edges: [] };
+    const perSubstrateLimit = Math.ceil((options.limit ?? 500) / 5);
+    const nodes = [];
+    const edges = [];
+    try {
+        // Active agents (legacy standalone signaldock.db bare table)
+        const agentRows = allTyped(db.prepare(`SELECT agent_id, name, status, created_at
+         FROM agents
+         WHERE status != 'deleted'
+         ORDER BY created_at DESC
+         LIMIT ?`), perSubstrateLimit);
+        const agentIds = new Set();
+        for (const row of agentRows) {
+            agentIds.add(row.agent_id);
+            nodes.push({
+                id: `agent-registry:${row.agent_id}`,
+                kind: 'agent',
+                substrate: 'agent-registry',
+                label: row.name,
+                weight: row.status === 'active' ? 1.0 : 0.5,
+                createdAt: epochToIso(row.created_at),
+                meta: {
+                    status: row.status,
+                    created_at: row.created_at,
+                },
+            });
+        }
+        // Agent connections (declared social graph)
+        if (agentIds.size > 0) {
+            const placeholders = [...agentIds].map(() => '?').join(',');
+            const connRows = allTyped(db.prepare(`SELECT from_agent_id, to_agent_id, connection_type, strength
+           FROM agent_connections
+           WHERE from_agent_id IN (${placeholders})
+             AND to_agent_id IN (${placeholders})`), ...agentIds, ...agentIds);
+            for (const row of connRows) {
+                edges.push({
+                    source: `agent-registry:${row.from_agent_id}`,
+                    target: `agent-registry:${row.to_agent_id}`,
+                    type: row.connection_type,
+                    weight: row.strength ?? 0.5,
+                    substrate: 'agent-registry',
+                });
+            }
+        }
+    }
+    catch {
+        // Return partial results on error
+    }
+    return { nodes, edges };
+}
+//# sourceMappingURL=agent-registry.js.map

package/dist/src/adapters/agent-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-registry.js","sourceRoot":"","sources":["../../../src/adapters/agent-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAYpE;;;;;;GAMG;AACH,SAAS,UAAU,CAAC,KAAoB;IACtC,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACzE,OAAO,IAAI,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;AAC9C,CAAC;AAUD;;;;;;;;GAQG;AACH,MAAM,UAAU,yBAAyB,CAAC,UAA6B,EAAE;IAIvE,MAAM,EAAE,GAAG,kBAAkB,EAAE,CAAC;IAChC,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAEzC,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAEhE,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAgB,EAAE,CAAC;IAE9B,IAAI,CAAC;QACH,6DAA6D;QAC7D,MAAM,SAAS,GAAG,QAAQ,CACxB,EAAE,CAAC,OAAO,CACR;;;;iBAIS,CACV,EACD,iBAAiB,CAClB,CAAC;QAEF,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;QACnC,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;YAC5B,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC;gBACT,EAAE,EAAE,kBAAkB,GAAG,CAAC,QAAQ,EAAE;gBACpC,IAAI,EAAE,OAAO;gBACb,SAAS,EAAE,gBAAgB;gBAC3B,KAAK,EAAE,GAAG,CAAC,IAAI;gBACf,MAAM,EAAE,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;gBAC3C,SAAS,EAAE,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC;gBACrC,IAAI,EAAE;oBACJ,MAAM,EAAE,GAAG,CAAC,MAAM;oBAClB,UAAU,EAAE,GAAG,CAAC,UAAU;iBAC3B;aACF,CAAC,CAAC;QACL,CAAC;QAED,4CAA4C;QAC5C,IAAI,QAAQ,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,YAAY,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC5D,MAAM,QAAQ,GAAG,QAAQ,CACvB,EAAE,CAAC,OAAO,CACR;;qCAE2B,YAAY;mCACd,YAAY,GAAG,CACzC,EACD,GAAG,QAAQ,EACX,GAAG,QAAQ,CACZ,CAAC;YAEF,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;gBAC3B,KAAK,CAAC,IAAI,CAAC;oBACT,MAAM,EAAE,kBAAkB,GAAG,CAAC,aAAa,EAAE;oBAC7C,MAAM,EAAE,kBAAkB,GAAG,CAAC,WAAW,EAAE;oBAC3C,IAAI,EAAE,GAAG,CAAC,eAAe;oBACzB,MAAM,EAAE,GAAG,CAAC,QAAQ,IAAI,GAAG;oBAC3B,SAAS,EAAE,gBAAgB;iBAC5B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,kCAAkC;IACpC,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC1B,CAAC"}

package/dist/src/adapters/brain.d.ts

@@ -0,0 +1,35 @@
+/**
+ * BRAIN substrate adapter for the Living Brain API.
+ *
+ * Queries brain.db and returns BrainNodes/BrainEdges for all typed memory tables:
+ * observations, decisions, patterns, learnings, plus the graph layer
+ * (brain_page_nodes / brain_page_edges).
+ *
+ * Cross-substrate bridges are synthesized for:
+ * - brain_page_edges whose to_id references a task (task:T-xxx → tasks:T-xxx)
+ * - brain_page_edges whose to_id is a nexus-style path (foo.ts::Symbol → nexus:...)
+ * - brain_memory_links rows (memory_type + memory_id → task_id link)
+ * - brain_observations.files_modified_json (observation → nexus file path)
+ *
+ * Node IDs are prefixed with "brain:" to prevent collisions.
+ */
+import type { BrainEdge, BrainNode, BrainQueryOptions } from '../types.js';
+/**
+ * Returns all BrainNodes and BrainEdges sourced from brain.db.
+ *
+ * Pulls from all four typed memory tables plus brain_page_edges.
+ * Emits intra-brain edges between loaded nodes, cross-substrate
+ * brain→tasks bridges, cross-substrate brain→nexus bridges, and
+ * brain_memory_links as cross-substrate edges.
+ *
+ * Applies `minWeight` filter where quality_score is available.
+ * Node count is bounded by `limit / 5` to share budget with other substrates.
+ *
+ * @param options - Query options (limit, minWeight).
+ * @returns Nodes and edges from the BRAIN substrate.
+ */
+export declare function getBrainSubstrate(options?: BrainQueryOptions): {
+    nodes: BrainNode[];
+    edges: BrainEdge[];
+};
+//# sourceMappingURL=brain.d.ts.map

package/dist/src/adapters/brain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain.d.ts","sourceRoot":"","sources":["../../../src/adapters/brain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAyH3E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,iBAAsB,GAAG;IAClE,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB,CAwPA"}

package/dist/src/adapters/brain.js

@@ -0,0 +1,303 @@
+/**
+ * BRAIN substrate adapter for the Living Brain API.
+ *
+ * Queries brain.db and returns BrainNodes/BrainEdges for all typed memory tables:
+ * observations, decisions, patterns, learnings, plus the graph layer
+ * (brain_page_nodes / brain_page_edges).
+ *
+ * Cross-substrate bridges are synthesized for:
+ * - brain_page_edges whose to_id references a task (task:T-xxx → tasks:T-xxx)
+ * - brain_page_edges whose to_id is a nexus-style path (foo.ts::Symbol → nexus:...)
+ * - brain_memory_links rows (memory_type + memory_id → task_id link)
+ * - brain_observations.files_modified_json (observation → nexus file path)
+ *
+ * Node IDs are prefixed with "brain:" to prevent collisions.
+ */
+import { allTyped, getBrainDb } from '../db-connections.js';
+import { resolveDefaultProjectContext } from '../project-context.js';
+/**
+ * Converts a brain_page_edges type-prefixed ID (e.g. "observation:O-abc")
+ * into the BrainNode ID prefix (e.g. "brain:O-abc").
+ *
+ * Returns null when the prefix is not a recognised brain type.
+ *
+ * @param typeId - Type-prefixed ID from brain_page_edges.from_id or to_id.
+ * @returns BrainNode-prefixed ID or null.
+ */
+function brainTypeIdToBrainNodeId(typeId) {
+    const sep = typeId.indexOf(':');
+    if (sep === -1)
+        return null;
+    const prefix = typeId.slice(0, sep);
+    const rawId = typeId.slice(sep + 1);
+    if (prefix === 'observation' ||
+        prefix === 'decision' ||
+        prefix === 'pattern' ||
+        prefix === 'learning') {
+        return `brain:${rawId}`;
+    }
+    return null;
+}
+/**
+ * Returns true when a brain_page_edges to_id looks like a nexus node path
+ * (contains "::" separator used by nexus for file::Symbol paths, or is a
+ * relative file path with a known extension).
+ *
+ * @param toId - to_id value from brain_page_edges.
+ * @returns True when the ID appears to reference a nexus node.
+ */
+function isNexusStyleId(toId) {
+    // Nexus symbol IDs contain :: (file::SymbolName)
+    if (toId.includes('::'))
+        return true;
+    // Nexus file IDs are relative paths (no type: prefix, contain a /)
+    if (!toId.includes(':') && toId.includes('/'))
+        return true;
+    return false;
+}
+/**
+ * Returns true when a brain_page_edges ID looks like a task reference
+ * (e.g. "task:T532").
+ *
+ * @param id - ID from brain_page_edges.
+ * @returns True when the ID references a task node.
+ */
+function isTaskId(id) {
+    return id.startsWith('task:');
+}
+/**
+ * Converts a brain_page_edges task-reference to a tasks-substrate BrainNode ID.
+ * e.g. "task:T532" → "tasks:T532"
+ *
+ * @param taskRef - Task reference from brain_page_edges.
+ * @returns tasks-substrate BrainNode ID.
+ */
+function taskRefToBrainNodeId(taskRef) {
+    return `tasks:${taskRef.slice('task:'.length)}`;
+}
+/**
+ * Returns all BrainNodes and BrainEdges sourced from brain.db.
+ *
+ * Pulls from all four typed memory tables plus brain_page_edges.
+ * Emits intra-brain edges between loaded nodes, cross-substrate
+ * brain→tasks bridges, cross-substrate brain→nexus bridges, and
+ * brain_memory_links as cross-substrate edges.
+ *
+ * Applies `minWeight` filter where quality_score is available.
+ * Node count is bounded by `limit / 5` to share budget with other substrates.
+ *
+ * @param options - Query options (limit, minWeight).
+ * @returns Nodes and edges from the BRAIN substrate.
+ */
+export function getBrainSubstrate(options = {}) {
+    const ctx = options.projectCtx ?? resolveDefaultProjectContext();
+    const db = getBrainDb(ctx);
+    if (!db)
+        return { nodes: [], edges: [] };
+    const minWeight = options.minWeight ?? 0;
+    const perSubstrateLimit = Math.ceil((options.limit ?? 500) / 5);
+    const nodes = [];
+    const edges = [];
+    try {
+        // Observations — normalise created_at to ISO-8601 with 'T' separator via strftime
+        const obsRows = allTyped(db.prepare(`SELECT id, title, quality_score, memory_tier,
+                strftime('%Y-%m-%dT%H:%M:%S', created_at) AS created_at,
+                source_session_id, files_modified_json
+         FROM brain_observations
+         WHERE (quality_score IS NULL OR quality_score >= ?)
+         ORDER BY quality_score DESC, created_at DESC
+         LIMIT ?`), minWeight, Math.ceil(perSubstrateLimit * 0.4));
+        for (const row of obsRows) {
+            nodes.push({
+                id: `brain:${row.id}`,
+                kind: 'observation',
+                substrate: 'brain',
+                label: row.title,
+                weight: row.quality_score ?? undefined,
+                createdAt: row.created_at,
+                meta: {
+                    memory_tier: row.memory_tier,
+                    created_at: row.created_at,
+                    source_session_id: row.source_session_id,
+                },
+            });
+        }
+        // Decisions — normalise created_at to ISO-8601 with 'T' separator via strftime
+        const decRows = allTyped(db.prepare(`SELECT id, decision, quality_score, context_task_id,
+                strftime('%Y-%m-%dT%H:%M:%S', created_at) AS created_at
+         FROM brain_decisions
+         WHERE (quality_score IS NULL OR quality_score >= ?)
+         ORDER BY quality_score DESC, created_at DESC
+         LIMIT ?`), minWeight, Math.ceil(perSubstrateLimit * 0.25));
+        for (const row of decRows) {
+            nodes.push({
+                id: `brain:${row.id}`,
+                kind: 'decision',
+                substrate: 'brain',
+                label: row.decision.slice(0, 100),
+                weight: row.quality_score ?? undefined,
+                createdAt: row.created_at,
+                meta: {
+                    context_task_id: row.context_task_id,
+                    created_at: row.created_at,
+                },
+            });
+        }
+        // Patterns — uses 'pattern' text column (not 'title') and 'extracted_at' (not 'created_at').
+        // SQLite strftime is used to normalise the timestamp to ISO-8601 with 'T' separator.
+        const patRows = allTyped(db.prepare(`SELECT id, pattern, type, quality_score,
+                strftime('%Y-%m-%dT%H:%M:%S', extracted_at) AS extracted_at
+         FROM brain_patterns
+         WHERE (quality_score IS NULL OR quality_score >= ?)
+         ORDER BY quality_score DESC, extracted_at DESC
+         LIMIT ?`), minWeight, Math.ceil(perSubstrateLimit * 0.2));
+        for (const row of patRows) {
+            nodes.push({
+                id: `brain:${row.id}`,
+                kind: 'pattern',
+                substrate: 'brain',
+                label: row.pattern.slice(0, 100),
+                weight: row.quality_score ?? undefined,
+                createdAt: row.extracted_at,
+                meta: { pattern_type: row.type, created_at: row.extracted_at },
+            });
+        }
+        // Learnings — uses 'insight' text column (not 'title').
+        // Normalise created_at to ISO-8601 with 'T' separator via strftime.
+        const learnRows = allTyped(db.prepare(`SELECT id, insight, quality_score,
+                strftime('%Y-%m-%dT%H:%M:%S', created_at) AS created_at
+         FROM brain_learnings
+         WHERE (quality_score IS NULL OR quality_score >= ?)
+         ORDER BY quality_score DESC, created_at DESC
+         LIMIT ?`), minWeight, Math.ceil(perSubstrateLimit * 0.15));
+        for (const row of learnRows) {
+            nodes.push({
+                id: `brain:${row.id}`,
+                kind: 'learning',
+                substrate: 'brain',
+                label: row.insight.slice(0, 100),
+                weight: row.quality_score ?? undefined,
+                createdAt: row.created_at,
+                meta: { created_at: row.created_at },
+            });
+        }
+        // Build lookup: type-prefixed ID (e.g. "observation:O-abc") → BrainNode ID
+        // (e.g. "brain:O-abc"). This is needed because brain_page_edges stores
+        // IDs in type-prefixed format while BrainNode IDs use the "brain:" prefix.
+        const typeIdToBrainNodeId = new Map();
+        for (const n of nodes) {
+            const rawId = n.id.slice('brain:'.length);
+            // Determine which type prefix this node would have in brain_page_edges
+            let typePrefix;
+            if (n.kind === 'observation')
+                typePrefix = 'observation';
+            else if (n.kind === 'decision')
+                typePrefix = 'decision';
+            else if (n.kind === 'pattern')
+                typePrefix = 'pattern';
+            else
+                typePrefix = 'learning';
+            typeIdToBrainNodeId.set(`${typePrefix}:${rawId}`, n.id);
+        }
+        // brain_page_edges: query all and classify each edge
+        const pageEdgeRows = allTyped(db.prepare(`SELECT from_id, to_id, edge_type, weight FROM brain_page_edges`));
+        for (const row of pageEdgeRows) {
+            const sourceBrainNodeId = typeIdToBrainNodeId.get(row.from_id) ?? brainTypeIdToBrainNodeId(row.from_id);
+            if (!sourceBrainNodeId)
+                continue; // source not a recognised brain node
+            if (isTaskId(row.to_id)) {
+                // Cross-substrate: brain → tasks
+                edges.push({
+                    source: sourceBrainNodeId,
+                    target: taskRefToBrainNodeId(row.to_id),
+                    type: row.edge_type,
+                    weight: row.weight ?? 0.5,
+                    substrate: 'cross',
+                });
+            }
+            else if (isNexusStyleId(row.to_id)) {
+                // Cross-substrate: brain → nexus (code_reference, etc.)
+                edges.push({
+                    source: sourceBrainNodeId,
+                    target: `nexus:${row.to_id}`,
+                    type: row.edge_type,
+                    weight: row.weight ?? 0.5,
+                    substrate: 'cross',
+                });
+            }
+            else {
+                // Intra-brain: both IDs should be brain nodes
+                const targetBrainNodeId = typeIdToBrainNodeId.get(row.to_id) ?? brainTypeIdToBrainNodeId(row.to_id);
+                if (targetBrainNodeId) {
+                    edges.push({
+                        source: sourceBrainNodeId,
+                        target: targetBrainNodeId,
+                        type: row.edge_type,
+                        weight: row.weight ?? 0.5,
+                        substrate: 'brain',
+                    });
+                }
+            }
+        }
+        // brain_memory_links: cross-substrate edges from typed memory nodes to tasks
+        const memLinkRows = allTyped(db.prepare(`SELECT memory_type, memory_id, task_id, link_type
+         FROM brain_memory_links`));
+        for (const row of memLinkRows) {
+            const sourceTypeId = `${row.memory_type}:${row.memory_id}`;
+            const sourceBrainNodeId = typeIdToBrainNodeId.get(sourceTypeId) ?? brainTypeIdToBrainNodeId(sourceTypeId);
+            if (!sourceBrainNodeId)
+                continue; // source node not in loaded set
+            edges.push({
+                source: sourceBrainNodeId,
+                target: `tasks:${row.task_id}`,
+                type: row.link_type,
+                weight: 0.7,
+                substrate: 'cross',
+            });
+        }
+        // brain_observations.files_modified_json: cross-substrate observation → nexus file
+        for (const row of obsRows) {
+            if (!row.files_modified_json)
+                continue;
+            let filePaths;
+            try {
+                filePaths = JSON.parse(row.files_modified_json);
+            }
+            catch {
+                continue;
+            }
+            if (!Array.isArray(filePaths))
+                continue;
+            const sourceBrainNodeId = `brain:${row.id}`;
+            for (const rawPath of filePaths) {
+                if (typeof rawPath !== 'string' || rawPath.length === 0)
+                    continue;
+                edges.push({
+                    source: sourceBrainNodeId,
+                    target: `nexus:${rawPath}`,
+                    type: 'modified_by',
+                    weight: 0.6,
+                    substrate: 'cross',
+                });
+            }
+        }
+        // Soft FK: brain_decisions.context_task_id → tasks (direct, not via page_edges)
+        // This handles decisions whose context_task_id may not yet appear in brain_page_edges.
+        for (const dec of decRows) {
+            if (dec.context_task_id) {
+                edges.push({
+                    source: `brain:${dec.id}`,
+                    target: `tasks:${dec.context_task_id}`,
+                    type: 'applies_to',
+                    weight: 0.8,
+                    substrate: 'cross',
+                });
+            }
+        }
+    }
+    catch {
+        // Return partial results on error
+    }
+    return { nodes, edges };
+}
+//# sourceMappingURL=brain.js.map

package/dist/src/adapters/brain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain.js","sourceRoot":"","sources":["../../../src/adapters/brain.ts"],"names":[],"mappings":"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"}

package/dist/src/adapters/conduit.d.ts

@@ -0,0 +1,25 @@
+/**
+ * CONDUIT substrate adapter for the Living Brain API.
+ *
+ * Queries conduit.db and returns BrainNodes/BrainEdges for agent-to-agent messages.
+ * Each message becomes a node; `from_agent_id → to_agent_id` becomes an edge.
+ * Co-authoring agent pairs produce cross-substrate edges to SIGNALDOCK.
+ *
+ * Node IDs are prefixed with "conduit:" to prevent collisions.
+ */
+import type { BrainEdge, BrainNode, BrainQueryOptions } from '../types.js';
+/**
+ * Returns all BrainNodes and BrainEdges sourced from conduit.db.
+ *
+ * Fetches the most recent messages (capped at perSubstrateLimit).
+ * Synthesizes agent→agent edges and cross-substrate agent references
+ * pointing to signaldock.
+ *
+ * @param options - Query options (limit).
+ * @returns Nodes and edges from the CONDUIT substrate.
+ */
+export declare function getConduitSubstrate(options?: BrainQueryOptions): {
+    nodes: BrainNode[];
+    edges: BrainEdge[];
+};
+//# sourceMappingURL=conduit.d.ts.map

package/dist/src/adapters/conduit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conduit.d.ts","sourceRoot":"","sources":["../../../src/adapters/conduit.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAyB3E;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,iBAAsB,GAAG;IACpE,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB,CAqEA"}

package/dist/src/adapters/conduit.js

@@ -0,0 +1,94 @@
+/**
+ * CONDUIT substrate adapter for the Living Brain API.
+ *
+ * Queries conduit.db and returns BrainNodes/BrainEdges for agent-to-agent messages.
+ * Each message becomes a node; `from_agent_id → to_agent_id` becomes an edge.
+ * Co-authoring agent pairs produce cross-substrate edges to SIGNALDOCK.
+ *
+ * Node IDs are prefixed with "conduit:" to prevent collisions.
+ */
+import { allTyped, getConduitDb } from '../db-connections.js';
+import { resolveDefaultProjectContext } from '../project-context.js';
+/**
+ * Converts a UNIX epoch seconds value to an ISO-8601 string.
+ * Returns null when the value is not a finite positive number.
+ *
+ * @param epoch - UNIX timestamp in seconds.
+ * @returns ISO-8601 string or null.
+ */
+function epochToIso(epoch) {
+    if (!Number.isFinite(epoch) || epoch <= 0)
+        return null;
+    return new Date(epoch * 1000).toISOString();
+}
+/**
+ * Returns all BrainNodes and BrainEdges sourced from conduit.db.
+ *
+ * Fetches the most recent messages (capped at perSubstrateLimit).
+ * Synthesizes agent→agent edges and cross-substrate agent references
+ * pointing to signaldock.
+ *
+ * @param options - Query options (limit).
+ * @returns Nodes and edges from the CONDUIT substrate.
+ */
+export function getConduitSubstrate(options = {}) {
+    const ctx = options.projectCtx ?? resolveDefaultProjectContext();
+    const db = getConduitDb(ctx);
+    if (!db)
+        return { nodes: [], edges: [] };
+    const perSubstrateLimit = Math.ceil((options.limit ?? 500) / 5);
+    const nodes = [];
+    const edges = [];
+    try {
+        // Most recent messages
+        const msgRows = allTyped(db.prepare(`SELECT id, content, from_agent_id, to_agent_id, created_at, conversation_id
+         FROM messages
+         ORDER BY created_at DESC
+         LIMIT ?`), perSubstrateLimit);
+        const agentPairs = new Map();
+        for (const row of msgRows) {
+            // Message node — truncate content for label
+            const label = row.content.length > 80 ? `${row.content.slice(0, 80)}…` : row.content;
+            nodes.push({
+                id: `conduit:${row.id}`,
+                kind: 'message',
+                substrate: 'conduit',
+                label,
+                createdAt: epochToIso(row.created_at),
+                meta: {
+                    from_agent_id: row.from_agent_id,
+                    to_agent_id: row.to_agent_id,
+                    conversation_id: row.conversation_id,
+                    created_at: row.created_at,
+                },
+            });
+            // Aggregate agent pairs for social-graph edges
+            if (row.from_agent_id && row.to_agent_id) {
+                const key = `${row.from_agent_id}→${row.to_agent_id}`;
+                const existing = agentPairs.get(key);
+                if (existing) {
+                    existing.count++;
+                }
+                else {
+                    agentPairs.set(key, { count: 1, from: row.from_agent_id, to: row.to_agent_id });
+                }
+            }
+        }
+        // Cross-substrate: agent social graph edges pointing to signaldock agent nodes
+        for (const [, pair] of agentPairs) {
+            const weight = Math.min(1.0, pair.count / 10);
+            edges.push({
+                source: `agent-registry:${pair.from}`,
+                target: `agent-registry:${pair.to}`,
+                type: 'messages',
+                weight,
+                substrate: 'cross',
+            });
+        }
+    }
+    catch {
+        // Return partial results on error
+    }
+    return { nodes, edges };
+}
+//# sourceMappingURL=conduit.js.map

package/dist/src/adapters/conduit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conduit.js","sourceRoot":"","sources":["../../../src/adapters/conduit.ts"],"names":[],"mappings":"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"}

package/dist/src/adapters/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Barrel for all substrate adapters.
+ *
+ * Re-exports individual adapter functions and provides the unified
+ * `getAllSubstrates()` function that merges results from all five databases
+ * into a single BrainGraph.
+ */
+export { getAgentRegistrySubstrate } from './agent-registry.js';
+export { getBrainSubstrate } from './brain.js';
+export { getConduitSubstrate } from './conduit.js';
+export { getNexusSubstrate } from './nexus.js';
+export { getTasksSubstrate } from './tasks.js';
+import type { BrainGraph, BrainQueryOptions } from '../types.js';
+/**
+ * Queries all five substrates and merges the results into a unified BrainGraph.
+ *
+ * When `options.substrates` is provided, only those substrates are queried.
+ * Node IDs are substrate-prefixed, so deduplication is safe to perform
+ * by ID equality alone.
+ *
+ * After all substrates are loaded, performs a second-pass stub-node load:
+ * any edge target ID not yet in the loaded node set is fetched as a minimal
+ * stub (id, substrate, kind, label). This recovers cross-substrate edges
+ * that would otherwise be silently dropped.
+ *
+ * Stub nodes carry `meta.isStub: true` for optional UI differentiation.
+ *
+ * @param options - Query options forwarded to each substrate adapter.
+ * @returns Merged BrainGraph across all requested substrates, with stub nodes for unresolved edge targets.
+ */
+export declare function getAllSubstrates(options?: BrainQueryOptions): BrainGraph;
+//# sourceMappingURL=index.d.ts.map