@aexol/spectral 0.9.15 → 0.9.17

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/prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/memory/prompts.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,+QAA+Q,CAAC;AAE1S,eAAO,MAAM,yBAAyB,6oHAmD+F,CAAC;AAEtI,eAAO,MAAM,0BAA0B,67CAkB+F,CAAC;AAEvI,eAAO,MAAM,gBAAgB,8+CAasI,CAAC;AAEpK,eAAO,MAAM,eAAe,knTAoC2G,CAAC;AAExI,eAAO,MAAM,gBAAgB,69UA0DwH,CAAC;AAEtJ,eAAO,MAAM,aAAa,u2cAgFuP,CAAC;AASlR,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGlF;AASD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAG/E;AAED,eAAO,MAAM,0BAA0B,07BAOoS,CAAC"}
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/memory/prompts.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,+QAA+Q,CAAC;AAE1S,eAAO,MAAM,yBAAyB,6oHAmD+F,CAAC;AAEtI,eAAO,MAAM,0BAA0B,67CAkB+F,CAAC;AAEvI,eAAO,MAAM,gBAAgB,8+CAasI,CAAC;AAEpK,eAAO,MAAM,eAAe,knTAoC2G,CAAC;AAExI,eAAO,MAAM,gBAAgB,69UA0DwH,CAAC;AAEtJ,eAAO,MAAM,aAAa,u2cAgFuP,CAAC;AAiBlR,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAIlF;AASD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAG/E;AAED,eAAO,MAAM,0BAA0B,07BAOoS,CAAC"}

package/dist/memory/prompts.js

@@ -261,11 +261,20 @@ What you CANNOT do:
 It is valid to end a pass with zero drops if the pool genuinely has nothing more to cut — a follow-up pass will be skipped when a run returns zero drops. On late pressure passes, first re-check old [coverage: reinforced] and [coverage: cited] observations as active-memory redundancies before deciding there are no sound drops. Do not force drops you don't believe in.
 
 Remember: pruning is active-memory management, not source deletion. A drop that looks reasonable at "low" still becomes a mistake if the content was a user correction with a mis-labeled relevance and no reflection captures it with equivalent fidelity. Read before you cut.`;
+const REFLECTOR_UNIFIED_PASS = `Pass strategy — combined broad synthesis + atomic facts in a single pass.
+
+Phase 1 — Multi-observation synthesis: First crystallize broad durable patterns, repeated preferences, recurring constraints, stable work style, and project-level themes supported by multiple observations. Every reflection in this phase must cite at least 2 distinct supportingObservationIds whose durable meaning is captured by the reflection. If an existing reflection already captures the pattern, repeat the exact same content when adding support ids materially improves active-memory coverage.
+
+Phase 2 — Atomic durable facts + safety review: Then capture important durable facts that may be supported by a single authoritative observation: explicit user preferences, hard constraints, corrections, decisions, completed milestones, project facts, release or rollback caveats, important technical context, and other load-bearing facts future agents must not forget. Review high and critical observations against reflections created in phase 1, and catch durable information still missing. Strengthen existing or newly-created reflections by repeating exact reflection content with additional supportingObservationIds for high, critical, and old medium observations whose durable meaning is already captured by that reflection.
+
+Do not duplicate earlier reflections; repeat exact existing content only to add missing support or promote no-provenance legacy memory. Create new reflections only when durable meaning is still missing. Do not create low-quality reflections just for coverage, and do not attach observations whose unique exact detail or current task state is not captured with equivalent fidelity.`;
 const REFLECTOR_PASS_STRATEGIES = {
     1: `Pass strategy — multi-observation synthesis. Find broad durable patterns, repeated preferences, recurring constraints, stable work style, and project-level themes supported by multiple observations. Every reflection recorded in this pass must cite at least 2 distinct supportingObservationIds whose durable meaning is captured by the reflection. Do not create one-off event summaries; leave important single-observation facts, safety review, and coverage strengthening for the final reflector pass. If an existing reflection already captures the pattern, repeat the exact same content when adding support ids materially improves active-memory coverage.`,
     2: `Pass strategy — final atomic durable facts, safety review, and coverage strengthening. Capture important durable facts that may be supported by a single authoritative observation: explicit user preferences, hard constraints, corrections, decisions, completed milestones, project facts, release or rollback caveats, important technical context, and other load-bearing facts future agents must not forget. Review high and critical observations against current reflections, including reflections created in pass 1, and catch durable information still missing. Strengthen existing or newly-created reflections by repeating exact reflection content with additional supportingObservationIds for high, critical, and old medium observations whose durable meaning is already captured by that reflection. Do not duplicate earlier reflections; repeat exact existing content only to add missing support or promote no-provenance legacy memory. Create new reflections only when durable meaning is still missing. Do not create low-quality reflections just for coverage, and do not attach observations whose unique exact detail or current task state is not captured with equivalent fidelity.`,
 };
 export function buildReflectorPassGuidance(pass, maxPasses) {
+    if (maxPasses === 1)
+        return REFLECTOR_UNIFIED_PASS;
     const tier = Math.min(2, Math.max(1, pass));
     return `Pass ${pass} of up to ${maxPasses}. ${REFLECTOR_PASS_STRATEGIES[tier]}`;
 }

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"}

package/dist/memory/tools/share-project-observation.js

@@ -0,0 +1,106 @@
+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";
+import { getMemoryState } from "../branch.js";
+import { RELEVANCE_VALUES } from "../types.js";
+export const SHARE_PROJECT_OBSERVATION_TOOL_NAME = "share_project_observation";
+function findObservationInBranch(branch, memoryId) {
+    if (!Array.isArray(branch))
+        return null;
+    const state = getMemoryState(branch);
+    for (const obs of state.committedObs) {
+        if (obs.id === memoryId) {
+            return { id: obs.id, content: obs.content, relevance: obs.relevance, originType: "observation" };
+        }
+    }
+    for (const obs of state.pendingObs) {
+        if (obs.id === memoryId) {
+            return { id: obs.id, content: obs.content, relevance: obs.relevance, originType: "observation" };
+        }
+    }
+    for (const reflection of state.reflections) {
+        const id = typeof reflection === "string" ? undefined : reflection.id;
+        const content = typeof reflection === "string" ? reflection : reflection.content;
+        if (id === memoryId) {
+            return { id, content, relevance: "high", originType: "reflection" };
+        }
+    }
+    return null;
+}
+function findObservationInStore(store, projectId, memoryId) {
+    const obs = store.getProjectObservationById(projectId, memoryId);
+    if (!obs)
+        return null;
+    const relevance = RELEVANCE_VALUES.includes(obs.relevance)
+        ? obs.relevance
+        : "medium";
+    return { id: obs.id, content: obs.content, relevance, originType: "observation" };
+}
+export const shareProjectObservationTool = defineTool({
+    name: SHARE_PROJECT_OBSERVATION_TOOL_NAME,
+    label: "Share observation with other agents",
+    description: "Broadcast a project observation or reflection to other active sessions working on this project. " +
+        "Use this when you discover a fact another agent should know immediately, " +
+        "rather than waiting for them to search project memory.",
+    promptSnippet: "Use share_project_observation(memory_id) to push a known observation to other active sessions.",
+    promptGuidelines: [
+        "Only share observations that are relevant to collaborators on the same project.",
+        "Prefer sharing high/critical relevance facts — avoid noise.",
+        "The memory_id must be a 12-character lowercase hex id from the current branch or project memory.",
+    ],
+    parameters: Type.Object({
+        memory_id: Type.String({
+            pattern: "^[a-f0-9]{12}$",
+            description: "12-character observation/reflection id.",
+        }),
+    }),
+    async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
+        const store = getProjectObsStore();
+        const broker = getInterAgentBroker();
+        if (!store || !broker) {
+            return {
+                content: [{ type: "text", text: "Sharing is unavailable outside spectral serve." }],
+                details: { status: "unavailable" },
+            };
+        }
+        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" },
+            };
+        }
+        const branch = ctx.sessionManager.getBranch?.();
+        const obs = findObservationInBranch(branch, params.memory_id)
+            ?? findObservationInStore(store, projectId, params.memory_id);
+        if (!obs) {
+            return {
+                content: [{ type: "text", text: `Observation \`${params.memory_id}\` not found.` }],
+                details: { status: "not_found" },
+            };
+        }
+        broker.send({
+            projectId,
+            channel: "memory",
+            senderSessionId: sessionId,
+            kind: "observation",
+            payload: JSON.stringify({
+                memoryId: obs.id,
+                content: obs.content,
+                relevance: obs.relevance,
+                sourceSessionId: sessionId,
+                originType: obs.originType,
+                timestamp: new Date().toISOString(),
+            }),
+        });
+        return {
+            content: [{ type: "text", text: `Shared observation \`${obs.id}\` with other project sessions.` }],
+            details: { status: "ok", memoryId: obs.id },
+        };
+    },
+});
+export function registerShareProjectObservationTool(ext) {
+    ext.registerTool(shareProjectObservationTool);
+}

package/dist/memory/unified-compaction.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Unified Compaction — single LLM call replacing both:
+ *   1. Core spectral generateSummary() (narrative conversation summary)
+ *   2. Sync catch-up observer (observation extraction from gap entries)
+ *
+ * Uses a text-based delimited output format (compatible with any model
+ * without requiring native structured-output support):
+ *
+ *   ===NARRATIVE===
+ *   ## Goal
+ *   ...
+ *
+ *   ===OBSERVATIONS===
+ *   [YYYY-MM-DD HH:MM] [relevance] Content line
+ *   ...
+ */
+import type { AgentMessage, ThinkingLevel } from "../sdk/agent-core/index.js";
+import type { Model } from "../sdk/ai/index.js";
+import type { ObservationRecord } from "./types.js";
+export interface UnifiedCompactionInput {
+    /** Messages to summarize (from core compaction preparation) */
+    messagesToSummarize: AgentMessage[];
+    /** Serialized gap entries as text with source entry labels */
+    gapChunk?: string;
+    /** Source entry IDs from gap entries */
+    gapSourceEntryIds?: string[];
+    /** Model to use */
+    model: Model<any>;
+    /** API key */
+    apiKey: string;
+    /** Request headers */
+    headers?: Record<string, string>;
+    /** Abort signal */
+    signal?: AbortSignal;
+    /** Previous compaction summary for iterative update */
+    previousSummary?: string;
+    /** Custom instructions for summarization focus */
+    customInstructions?: string;
+    /** Thinking level for reasoning models */
+    thinkingLevel?: ThinkingLevel;
+    /** Reserve tokens for prompt + output */
+    reserveTokens: number;
+}
+export interface UnifiedCompactionOutput {
+    /** Markdown narrative summary (for CompactionEntry.summary) */
+    narrativeSummary: string;
+    /** Observations extracted from the conversation */
+    observations: ObservationRecord[];
+    /** Files read */
+    readFiles: string[];
+    /** Files modified */
+    modifiedFiles: string[];
+}
+/**
+ * Generate a unified compaction result: narrative summary + observations
+ * in a single LLM call. Uses delimited text output for broad model compatibility.
+ */
+export declare function generateUnifiedCompaction(input: UnifiedCompactionInput): Promise<UnifiedCompactionOutput>;
+//# sourceMappingURL=unified-compaction.d.ts.map

package/dist/memory/unified-compaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unified-compaction.d.ts","sourceRoot":"","sources":["../../src/memory/unified-compaction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAUhD,OAAO,KAAK,EAAE,iBAAiB,EAAa,MAAM,YAAY,CAAC;AAkO/D,MAAM,WAAW,sBAAsB;IACtC,+DAA+D;IAC/D,mBAAmB,EAAE,YAAY,EAAE,CAAC;IACpC,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,mBAAmB;IACnB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAClB,cAAc;IACd,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,mBAAmB;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kDAAkD;IAClD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,0CAA0C;IAC1C,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACvC,+DAA+D;IAC/D,gBAAgB,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAClC,iBAAiB;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,qBAAqB;IACrB,aAAa,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAC9C,KAAK,EAAE,sBAAsB,GAC3B,OAAO,CAAC,uBAAuB,CAAC,CA0IlC"}