@aexol/spectral 0.9.14 → 0.9.16

package/dist/memory/config.d.ts

@@ -1,3 +1,14 @@
+export type Relevance = "low" | "medium" | "high" | "critical";
+export interface InterAgentConfig {
+    /** Auto-broadcast captured observations/reflections to other sessions. Default: true. */
+    broadcastOnCompact?: boolean;
+    /** Minimum relevance to auto-broadcast. Default: "high". */
+    minBroadcastRelevance?: Relevance;
+    /** Auto-receive shared observations on session start. Default: true. */
+    autoReceive?: boolean;
+    /** TTL in seconds for observation messages. Default: 86400. */
+    ttlSeconds?: number;
+}
 export interface Config {
     observationThresholdTokens: number;
     compactionThresholdTokens: number;
@@ -14,6 +25,7 @@ export interface Config {
     prunerMaxTurnsPerPass?: number;
     /** @deprecated Use reflectorMaxTurnsPerPass and prunerMaxTurnsPerPass. */
     compactionMaxToolCalls?: number;
+    interAgent?: InterAgentConfig;
 }
 export interface EffectiveTurnLimits {
     observerMaxTurnsPerRun: number;

package/dist/memory/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/memory/config.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,MAAM;IACtB,0BAA0B,EAAE,MAAM,CAAC;IACnC,yBAAyB,EAAE,MAAM,CAAC;IAClC,yBAAyB,EAAE,MAAM,CAAC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,0EAA0E;IAC1E,sBAAsB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,mBAAmB;IACnC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,wBAAwB,EAAE,MAAM,CAAC;IACjC,qBAAqB,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,QAAQ,EAAE,MAOtB,CAAC;AAiCF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,CAMrE;AAED,wBAAgB,aAAa,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAOnF;AAaD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAUpF"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/memory/config.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAE/D,MAAM,WAAW,gBAAgB;IAChC,yFAAyF;IACzF,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,4DAA4D;IAC5D,qBAAqB,CAAC,EAAE,SAAS,CAAC;IAClC,wEAAwE;IACxE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,MAAM;IACtB,0BAA0B,EAAE,MAAM,CAAC;IACnC,yBAAyB,EAAE,MAAM,CAAC;IAClC,yBAAyB,EAAE,MAAM,CAAC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,0EAA0E;IAC1E,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IACnC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,wBAAwB,EAAE,MAAM,CAAC;IACjC,qBAAqB,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,QAAQ,EAAE,MAOtB,CAAC;AA0DF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,CAMrE;AAED,wBAAgB,aAAa,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAOnF;AAaD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAUpF"}

package/dist/memory/config.js

@@ -27,6 +27,24 @@ function normalizeTurnLimit(normalized, key) {
         normalized[key] = value;
     }
 }
+const RELEVANCE_VALUES = ["low", "medium", "high", "critical"];
+function normalizeInterAgentConfig(value) {
+    if (!value || typeof value !== "object")
+        return undefined;
+    const raw = value;
+    const normalized = {};
+    if (typeof raw.broadcastOnCompact === "boolean")
+        normalized.broadcastOnCompact = raw.broadcastOnCompact;
+    if (typeof raw.autoReceive === "boolean")
+        normalized.autoReceive = raw.autoReceive;
+    if (typeof raw.minBroadcastRelevance === "string" && RELEVANCE_VALUES.includes(raw.minBroadcastRelevance)) {
+        normalized.minBroadcastRelevance = raw.minBroadcastRelevance;
+    }
+    if (Number.isInteger(raw.ttlSeconds) && typeof raw.ttlSeconds === "number" && raw.ttlSeconds >= 0) {
+        normalized.ttlSeconds = raw.ttlSeconds;
+    }
+    return Object.keys(normalized).length > 0 ? normalized : undefined;
+}
 function normalizeSettingsConfig(value) {
     const normalized = { ...value };
     if ("passive" in normalized && typeof normalized.passive !== "boolean")
@@ -38,6 +56,15 @@ function normalizeSettingsConfig(value) {
     normalizeTurnLimit(normalized, "reflectorMaxTurnsPerPass");
     normalizeTurnLimit(normalized, "prunerMaxTurnsPerPass");
     normalizeTurnLimit(normalized, "compactionMaxToolCalls");
+    if ("interAgent" in normalized) {
+        const normalizedInterAgent = normalizeInterAgentConfig(normalized.interAgent);
+        if (normalizedInterAgent) {
+            normalized.interAgent = normalizedInterAgent;
+        }
+        else {
+            delete normalized.interAgent;
+        }
+    }
     return normalized;
 }
 export function resolveTurnLimits(config) {

package/dist/memory/hooks/compaction-hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compaction-hook.d.ts","sourceRoot":"","sources":["../../../src/memory/hooks/compaction-hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAA+C,MAAM,iCAAiC,CAAC;AAsBjH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAmE7C,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CA8XhF"}
+{"version":3,"file":"compaction-hook.d.ts","sourceRoot":"","sources":["../../../src/memory/hooks/compaction-hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAA+C,MAAM,iCAAiC,CAAC;AAuBjH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAmE7C,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CA+XhF"}

package/dist/memory/hooks/compaction-hook.js

@@ -1,6 +1,7 @@
 import { debugLog, withDebugLogContext } from "../debug-log.js";
 import { resolveTurnLimits } from "../config.js";
 import { getProjectObsStore } from "../project-observations-store.js";
+import { relayProjectObservations } from "../inter-agent-relay.js";
 import { collectObservationsByCoverage, findLastCompactionIndex, gapRawEntries, getMemoryState, } from "../branch.js";
 import { coverageTagCounts, migrateLegacyReflections, observationPoolTokens, renderSummary, runPruner, runReflector, } from "../compaction.js";
 import { observationsToPromptLines, runObserver } from "../observer.js";
@@ -60,8 +61,9 @@ function emitAgentLoopProgress(emitProgress, phase, event) {
 export function registerCompactionHook(ext, runtime) {
     ext.on("session_before_compact", async (event, ctx) => {
         if (runtime.compactHookInFlight) {
-            if (ctx.hasUI)
-                ctx.ui.notify("Observational memory: another compaction is already in progress; cancelling duplicate", "warning");
+            // Expected race: another compaction process reached the hook first.
+            // Let the in-flight compaction continue; this is not a user-facing error.
+            debugLog("compaction.skip_duplicate", { reason: "hook already in flight" });
             return { cancel: true };
         }
         runtime.compactHookInFlight = true;
@@ -382,5 +384,6 @@ export function registerCompactionHook(ext, runtime) {
             projectId,
             sessionId,
         });
+        relayProjectObservations(ctx.cwd, projectId, sessionId, projectObs, "reflection");
     }
 }

package/dist/memory/hooks/compaction-trigger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compaction-trigger.d.ts","sourceRoot":"","sources":["../../../src/memory/hooks/compaction-trigger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAU7C,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAsFnF"}
+{"version":3,"file":"compaction-trigger.d.ts","sourceRoot":"","sources":["../../../src/memory/hooks/compaction-trigger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAU7C,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAyFnF"}

package/dist/memory/hooks/compaction-trigger.js

@@ -67,8 +67,9 @@ export function registerCompactionTrigger(ext, runtime) {
                     },
                     onError: (error) => {
                         runtime.compactInFlight = false;
-                        if (error.message === "Compaction cancelled") {
-                            // We already notified the user with the real reason before returning { cancel: true }.
+                        if (error.message === "Compaction cancelled" ||
+                            error.message === "Compaction already in progress") {
+                            // Expected races: another compaction is already running. No need to surface.
                             return;
                         }
                         if (hasUI)

package/dist/memory/hooks/inter-agent-receiver.d.ts

@@ -0,0 +1,3 @@
+import type { ExtensionAPI } from "../../sdk/coding-agent/index.js";
+export declare function registerInterAgentReceiver(ext: ExtensionAPI): void;
+//# sourceMappingURL=inter-agent-receiver.d.ts.map

package/dist/memory/hooks/inter-agent-receiver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inter-agent-receiver.d.ts","sourceRoot":"","sources":["../../../src/memory/hooks/inter-agent-receiver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAoFpE,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAgIlE"}

package/dist/memory/hooks/inter-agent-receiver.js

@@ -0,0 +1,183 @@
+import { getProjectObsStore } from "../project-observations-store.js";
+import { getInterAgentBroker } from "../inter-agent-broker-singleton.js";
+import { loadConfig } from "../config.js";
+import { debugLog } from "../debug-log.js";
+const DELIVERED_OBSERVATIONS_CUSTOM_TYPE = "om.inter-agent.delivered";
+function getSessionId(ctx) {
+    return ctx.sessionManager.getSessionId?.();
+}
+function isAlreadyDelivered(branch, memoryId) {
+    if (!Array.isArray(branch))
+        return false;
+    for (const entry of branch) {
+        if (typeof entry === "object" &&
+            entry !== null &&
+            entry.type === "custom_entry" &&
+            entry.customType === DELIVERED_OBSERVATIONS_CUSTOM_TYPE) {
+            const ids = entry.data?.ids;
+            if (Array.isArray(ids) && ids.includes(memoryId))
+                return true;
+        }
+    }
+    return false;
+}
+function formatObservationPrompt(observations) {
+    const lines = observations.map((o) => `- [${o.relevance}] ${o.content} (shared by ${o.sourceSessionId}, id: \`${o.memoryId}\`)`);
+    return [
+        "",
+        "---",
+        "SHARED PROJECT OBSERVATIONS from other active sessions:",
+        "The following observations were shared by other agents working on this project. " +
+            "Consider them when making decisions, but verify against current code.",
+        "",
+        ...lines,
+        "---",
+    ].join("\n");
+}
+function parseObservationPayload(msg) {
+    if (msg.kind !== "observation")
+        return null;
+    try {
+        const raw = JSON.parse(msg.payload);
+        if (typeof raw.memoryId !== "string" ||
+            typeof raw.content !== "string" ||
+            typeof raw.sourceSessionId !== "string" ||
+            typeof raw.timestamp !== "string") {
+            return null;
+        }
+        const relevance = ["low", "medium", "high", "critical"].includes(String(raw.relevance))
+            ? raw.relevance
+            : "medium";
+        const originType = raw.originType === "reflection" ? "reflection" : "observation";
+        return {
+            memoryId: raw.memoryId,
+            content: raw.content,
+            relevance,
+            sourceSessionId: raw.sourceSessionId,
+            originType,
+            timestamp: raw.timestamp,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+export function registerInterAgentReceiver(ext) {
+    const broker = getInterAgentBroker();
+    if (!broker) {
+        debugLog("inter_agent.receiver.disabled", { reason: "no_broker" });
+        return;
+    }
+    const receivers = new Map();
+    ext.on("session_start", (_event, ctx) => {
+        const store = getProjectObsStore();
+        if (!store)
+            return;
+        const projectId = store.getProjectByCwd(ctx.cwd);
+        const sessionId = getSessionId(ctx);
+        if (!projectId || !sessionId)
+            return;
+        const config = loadConfig(ctx.cwd);
+        if (config.interAgent?.autoReceive === false) {
+            debugLog("inter_agent.receiver.auto_disabled", { sessionId });
+            return;
+        }
+        // Rebuild delivered set from persisted custom entries so reloads don't
+        // re-inject the same observations.
+        const deliveredIds = new Set();
+        const branch = ctx.sessionManager.getBranch?.();
+        if (Array.isArray(branch)) {
+            for (const entry of branch) {
+                if (typeof entry === "object" &&
+                    entry !== null &&
+                    entry.type === "custom_entry" &&
+                    entry.customType === DELIVERED_OBSERVATIONS_CUSTOM_TYPE) {
+                    const ids = entry.data?.ids;
+                    if (Array.isArray(ids)) {
+                        for (const id of ids)
+                            deliveredIds.add(id);
+                    }
+                }
+            }
+        }
+        const state = {
+            sessionId,
+            projectId,
+            deliveredIds,
+            pending: [],
+        };
+        receivers.set(sessionId, state);
+        // Poll historical/undelivered messages.
+        const msgs = broker.poll({
+            projectId,
+            channel: "memory",
+            recipientSessionId: sessionId,
+            markDelivered: true,
+            limit: 50,
+        });
+        for (const msg of msgs) {
+            if (msg.senderSessionId === sessionId)
+                continue;
+            const obs = parseObservationPayload(msg);
+            if (!obs || deliveredIds.has(obs.memoryId))
+                continue;
+            state.pending.push(obs);
+            deliveredIds.add(obs.memoryId);
+        }
+        // Subscribe to live messages.
+        state.unsubscribe = broker.subscribe({
+            sessionId,
+            projectId,
+            channel: "memory",
+            handler: (msg) => {
+                if (msg.senderSessionId === sessionId)
+                    return;
+                const obs = parseObservationPayload(msg);
+                if (!obs || state.deliveredIds.has(obs.memoryId))
+                    return;
+                state.pending.push(obs);
+                state.deliveredIds.add(obs.memoryId);
+                if (ctx.hasUI && ctx.ui) {
+                    ctx.ui.notify(`Shared observation from ${msg.senderName ?? msg.senderSessionId}: ${obs.content.slice(0, 120)}`, "info");
+                }
+            },
+        });
+        if (state.pending.length > 0) {
+            debugLog("inter_agent.receiver.pending", {
+                sessionId,
+                count: state.pending.length,
+            });
+        }
+    });
+    ext.on("before_agent_start", (event, ctx) => {
+        const sessionId = getSessionId(ctx);
+        if (!sessionId)
+            return undefined;
+        const state = receivers.get(sessionId);
+        if (!state || state.pending.length === 0)
+            return undefined;
+        const observations = state.pending.splice(0, state.pending.length);
+        if (observations.length > 0) {
+            ext.appendEntry(DELIVERED_OBSERVATIONS_CUSTOM_TYPE, { ids: observations.map((o) => o.memoryId) });
+        }
+        const appendix = formatObservationPrompt(observations);
+        debugLog("inter_agent.receiver.inject", {
+            sessionId,
+            count: observations.length,
+            chars: appendix.length,
+        });
+        return {
+            systemPrompt: `${event.systemPrompt}\n${appendix}`,
+        };
+    });
+    ext.on("session_shutdown", (_event, ctx) => {
+        const sessionId = getSessionId(ctx);
+        if (!sessionId)
+            return;
+        const state = receivers.get(sessionId);
+        if (!state)
+            return;
+        state.unsubscribe?.();
+        receivers.delete(sessionId);
+    });
+}

package/dist/memory/hooks/observer-trigger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observer-trigger.d.ts","sourceRoot":"","sources":["../../../src/memory/hooks/observer-trigger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAWpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAK7C,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAyKjF"}
+{"version":3,"file":"observer-trigger.d.ts","sourceRoot":"","sources":["../../../src/memory/hooks/observer-trigger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAWpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAO7C,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CA0KjF"}

package/dist/memory/hooks/observer-trigger.js

@@ -5,6 +5,8 @@ import { observationsToPromptLines, runObserver } from "../observer.js";
 import { serializeSourceAddressedBranchEntries } from "../serialize.js";
 import { estimateEntryTokens, estimateStringTokens } from "../tokens.js";
 import { OBSERVATION_CUSTOM_TYPE, reflectionToPromptLine } from "../types.js";
+import { getProjectObsStore } from "../project-observations-store.js";
+import { relayProjectObservations } from "../inter-agent-relay.js";
 export function registerObserverTrigger(ext, runtime) {
     ext.on("turn_end", (_event, ctx) => {
         process.stderr.write("[obs-mem] turn_end fired\n");
@@ -146,6 +148,7 @@ export function registerObserverTrigger(ext, runtime) {
                     records,
                 });
                 ext.appendEntry(OBSERVATION_CUSTOM_TYPE, data);
+                relayObservationRecords(cwd, ctx.sessionManager.getSessionId?.(), records);
                 debugLog("observer.appended", { count: records.length, tokenCount: observationTokens, coversFromId, coversUpToId: effectiveCoversUpToId });
                 if (hasUI && ui)
                     ui.notify(`Observational memory: ${records.length} observation${records.length === 1 ? "" : "s"} recorded (~${observationTokens.toLocaleString()} tokens)`, "info");
@@ -157,3 +160,14 @@ export function registerObserverTrigger(ext, runtime) {
         }));
     });
 }
+function relayObservationRecords(cwd, sessionId, records) {
+    if (!sessionId || records.length === 0)
+        return;
+    const store = getProjectObsStore();
+    if (!store)
+        return;
+    const projectId = store.getProjectByCwd(cwd);
+    if (!projectId)
+        return;
+    relayProjectObservations(cwd, projectId, sessionId, records, "observation");
+}

package/dist/memory/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAWjE,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,GAAG,EAAE,YAAY,QAe5D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAcjE,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,GAAG,EAAE,YAAY,QAmB5D"}

package/dist/memory/index.js

@@ -2,10 +2,13 @@ import { registerStatusCommand } from "./commands/status.js";
 import { registerViewCommand } from "./commands/view.js";
 import { registerCompactionHook } from "./hooks/compaction-hook.js";
 import { registerCompactionTrigger } from "./hooks/compaction-trigger.js";
+import { registerInterAgentReceiver } from "./hooks/inter-agent-receiver.js";
 import { registerObserverTrigger } from "./hooks/observer-trigger.js";
 import { Runtime } from "./runtime.js";
 import { registerRecallTool } from "./tools/recall-observation.js";
 import { registerReadProjectObservationsTool } from "./tools/read-project-observations.js";
+import { registerReceiveAgentObservationsTool } from "./tools/receive-agent-observations.js";
+import { registerShareProjectObservationTool } from "./tools/share-project-observation.js";
 import { registerWriteProjectObservationTool } from "./tools/write-project-observation.js";
 export default function observationalMemory(ext) {
     const runtime = new Runtime();
@@ -19,4 +22,7 @@ export default function observationalMemory(ext) {
     registerRecallTool(ext);
     registerReadProjectObservationsTool(ext);
     registerWriteProjectObservationTool(ext);
+    registerShareProjectObservationTool(ext);
+    registerReceiveAgentObservationsTool(ext);
+    registerInterAgentReceiver(ext);
 }

package/dist/memory/inter-agent-broker-singleton.d.ts

@@ -0,0 +1,5 @@
+import type { InterAgentBroker, InterAgentMessage } from "../server/inter-agent-broker.js";
+export declare function setInterAgentBroker(broker: InterAgentBroker): void;
+export declare function getInterAgentBroker(): InterAgentBroker | null;
+export type { InterAgentBroker, InterAgentMessage };
+//# sourceMappingURL=inter-agent-broker-singleton.d.ts.map

package/dist/memory/inter-agent-broker-singleton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inter-agent-broker-singleton.d.ts","sourceRoot":"","sources":["../../src/memory/inter-agent-broker-singleton.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAI3F,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAElE;AAED,wBAAgB,mBAAmB,IAAI,gBAAgB,GAAG,IAAI,CAE7D;AAED,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/memory/inter-agent-broker-singleton.js

@@ -0,0 +1,7 @@
+let _broker = null;
+export function setInterAgentBroker(broker) {
+    _broker = broker;
+}
+export function getInterAgentBroker() {
+    return _broker;
+}

package/dist/memory/inter-agent-relay.d.ts

@@ -0,0 +1,7 @@
+export interface RelayObservation {
+    id: string;
+    content: string;
+    relevance: string;
+}
+export declare function relayProjectObservations(cwd: string, projectId: string, sessionId: string, observations: RelayObservation[], originType?: "observation" | "reflection"): void;
+//# sourceMappingURL=inter-agent-relay.d.ts.map

package/dist/memory/inter-agent-relay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inter-agent-relay.d.ts","sourceRoot":"","sources":["../../src/memory/inter-agent-relay.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,gBAAgB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,wBAAwB,CACvC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,gBAAgB,EAAE,EAChC,UAAU,GAAE,aAAa,GAAG,YAA2B,GACrD,IAAI,CAiCN"}

package/dist/memory/inter-agent-relay.js

@@ -0,0 +1,41 @@
+import { getInterAgentBroker } from "./inter-agent-broker-singleton.js";
+import { loadConfig } from "./config.js";
+import { debugLog } from "./debug-log.js";
+const RELEVANCE_RANK = {
+    low: 0,
+    medium: 1,
+    high: 2,
+    critical: 3,
+};
+export function relayProjectObservations(cwd, projectId, sessionId, observations, originType = "reflection") {
+    const broker = getInterAgentBroker();
+    if (!broker)
+        return;
+    const config = loadConfig(cwd).interAgent;
+    if (config?.broadcastOnCompact === false) {
+        debugLog("inter_agent.broadcast.disabled", { sessionId });
+        return;
+    }
+    const minRank = RELEVANCE_RANK[config?.minBroadcastRelevance ?? "high"] ?? 2;
+    const ttlSeconds = config?.ttlSeconds;
+    for (const obs of observations) {
+        if ((RELEVANCE_RANK[obs.relevance] ?? 0) < minRank)
+            continue;
+        broker.send({
+            projectId,
+            channel: "memory",
+            senderSessionId: sessionId,
+            kind: "observation",
+            payload: JSON.stringify({
+                memoryId: obs.id,
+                content: obs.content,
+                relevance: obs.relevance,
+                sourceSessionId: sessionId,
+                originType,
+                timestamp: new Date().toISOString(),
+            }),
+            ttlSeconds,
+        });
+        debugLog("inter_agent.broadcast.sent", { memoryId: obs.id, sessionId });
+    }
+}

package/dist/memory/project-observations-store.d.ts

@@ -17,6 +17,13 @@ export interface ProjectObservationsStore {
         createdAt: number;
         sessionId: string;
     }>;
+    getProjectObservationById(projectId: string, observationId: string): {
+        id: string;
+        content: string;
+        relevance: string;
+        createdAt: number;
+        sessionId: string;
+    } | null;
     getProjectByCwd(cwd: string): string | null;
 }
 export declare function setProjectObsStore(store: ProjectObservationsStore): void;

package/dist/memory/project-observations-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-observations-store.d.ts","sourceRoot":"","sources":["../../src/memory/project-observations-store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,wBAAwB;IACxC,yBAAyB,CACxB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,EACvE,SAAS,EAAE,MAAM,GACf,IAAI,CAAC;IACR,yBAAyB,CACxB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,GACZ,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvF,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAC5C;AAID,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,wBAAwB,GAAG,IAAI,CAExE;AAED,wBAAgB,kBAAkB,IAAI,wBAAwB,GAAG,IAAI,CAEpE"}
+{"version":3,"file":"project-observations-store.d.ts","sourceRoot":"","sources":["../../src/memory/project-observations-store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,wBAAwB;IACxC,yBAAyB,CACxB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,EACvE,SAAS,EAAE,MAAM,GACf,IAAI,CAAC;IACR,yBAAyB,CACxB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,GACZ,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvF,yBAAyB,CACxB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,GACnB;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACnG,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAC5C;AAID,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,wBAAwB,GAAG,IAAI,CAExE;AAED,wBAAgB,kBAAkB,IAAI,wBAAwB,GAAG,IAAI,CAEpE"}

package/dist/memory/tools/receive-agent-observations.d.ts

@@ -0,0 +1,17 @@
+import { Type } from "../../sdk/ai/index.js";
+import { type ExtensionAPI } from "../../sdk/coding-agent/index.js";
+export declare const RECEIVE_AGENT_OBSERVATIONS_TOOL_NAME = "receive_agent_observations";
+export interface AgentObservationPayload {
+    memoryId: string;
+    content: string;
+    relevance: "low" | "medium" | "high" | "critical";
+    sourceSessionId: string;
+    originType: "observation" | "reflection";
+    timestamp: string;
+}
+export declare const receiveAgentObservationsTool: import("../../sdk/coding-agent/index.js").ToolDefinition<Type.TObject<{
+    since: Type.TOptional<Type.TNumber>;
+    limit: Type.TOptional<Type.TNumber>;
+}>, unknown> & import("../../sdk/coding-agent/index.js").ToolDefinition<any, any>;
+export declare function registerReceiveAgentObservationsTool(ext: ExtensionAPI): void;
+//# sourceMappingURL=receive-agent-observations.d.ts.map

package/dist/memory/tools/receive-agent-observations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receive-agent-observations.d.ts","sourceRoot":"","sources":["../../../src/memory/tools/receive-agent-observations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAIhF,eAAO,MAAM,oCAAoC,+BAA+B,CAAC;AAEjF,MAAM,WAAW,uBAAuB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IAClD,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,aAAa,GAAG,YAAY,CAAC;IACzC,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,4BAA4B;;;iFAmEvC,CAAC;AAEH,wBAAgB,oCAAoC,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAE5E"}

package/dist/memory/tools/receive-agent-observations.js

@@ -0,0 +1,68 @@
+import { Type } from "../../sdk/ai/index.js";
+import { defineTool } from "../../sdk/coding-agent/index.js";
+import { getProjectObsStore } from "../project-observations-store.js";
+import { getInterAgentBroker } from "../inter-agent-broker-singleton.js";
+export const RECEIVE_AGENT_OBSERVATIONS_TOOL_NAME = "receive_agent_observations";
+export const receiveAgentObservationsTool = defineTool({
+    name: RECEIVE_AGENT_OBSERVATIONS_TOOL_NAME,
+    label: "Receive observations from other agents",
+    description: "Poll for observations shared by other active sessions on this project. " +
+        "Call this before starting work or when you suspect another agent has shared context.",
+    promptSnippet: "Use receive_agent_observations() to pull shared observations from other active sessions.",
+    promptGuidelines: [
+        "Call at the start of a session or task to pick up context shared by collaborators.",
+        "Deduplicate results by memory_id against observations already in your context.",
+    ],
+    parameters: Type.Object({
+        since: Type.Optional(Type.Number({ description: "Optional timestamp (ms) to only fetch newer messages." })),
+        limit: Type.Optional(Type.Number({ default: 20 })),
+    }),
+    async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
+        const store = getProjectObsStore();
+        const broker = getInterAgentBroker();
+        if (!store || !broker) {
+            return {
+                content: [{ type: "text", text: "Receiving is unavailable outside spectral serve." }],
+                details: { status: "unavailable", observations: [] },
+            };
+        }
+        const projectId = store.getProjectByCwd(ctx.cwd);
+        const sessionId = ctx.sessionManager.getSessionId?.();
+        if (!projectId || !sessionId) {
+            return {
+                content: [{ type: "text", text: "No project/session context." }],
+                details: { status: "no_context", observations: [] },
+            };
+        }
+        const msgs = broker.poll({
+            projectId,
+            channel: "memory",
+            recipientSessionId: sessionId,
+            since: params.since,
+            limit: params.limit ?? 20,
+            markDelivered: true,
+        });
+        const observations = msgs
+            .filter((m) => m.kind === "observation")
+            .map((m) => JSON.parse(m.payload));
+        if (observations.length === 0) {
+            return {
+                content: [{ type: "text", text: "No new observations from other agents." }],
+                details: { status: "no_new", observations: [] },
+            };
+        }
+        const lines = observations.map((o) => `[${o.relevance}] ${o.content} (from ${o.sourceSessionId}, id: \`${o.memoryId}\`)`);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `New shared observations:\n\n${lines.join("\n")}`,
+                },
+            ],
+            details: { status: "ok", observations },
+        };
+    },
+});
+export function registerReceiveAgentObservationsTool(ext) {
+    ext.registerTool(receiveAgentObservationsTool);
+}

package/dist/memory/tools/share-project-observation.d.ts

@@ -0,0 +1,8 @@
+import { Type } from "../../sdk/ai/index.js";
+import { type ExtensionAPI } from "../../sdk/coding-agent/index.js";
+export declare const SHARE_PROJECT_OBSERVATION_TOOL_NAME = "share_project_observation";
+export declare const shareProjectObservationTool: import("../../sdk/coding-agent/index.js").ToolDefinition<Type.TObject<{
+    memory_id: Type.TString;
+}>, unknown> & import("../../sdk/coding-agent/index.js").ToolDefinition<any, any>;
+export declare function registerShareProjectObservationTool(ext: ExtensionAPI): void;
+//# sourceMappingURL=share-project-observation.d.ts.map

package/dist/memory/tools/share-project-observation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"share-project-observation.d.ts","sourceRoot":"","sources":["../../../src/memory/tools/share-project-observation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAOhF,eAAO,MAAM,mCAAmC,8BAA8B,CAAC;AA6C/E,eAAO,MAAM,2BAA2B;;iFAqEtC,CAAC;AAEH,wBAAgB,mCAAmC,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAE3E"}