@aexol/spectral 0.9.15 → 0.9.16

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/relay/dispatcher.d.ts

@@ -48,7 +48,7 @@ import type { RelayClient } from "./client.js";
  * `id` is populated when the route had an `:id` placeholder.
  */
 interface RouteMatch {
-    route: "list_projects" | "create_project" | "update_project" | "delete_project" | "bind_studio" | "list_project_sessions" | "create_session" | "get_session" | "update_session" | "delete_session" | "get_session_memory" | "get_session_memory_details" | "compact_session" | "remember_and_delete_session" | "fork_session" | "list_path_autocomplete" | "pick_directory" | "enqueue_prompt" | "get_prompt_queue" | "remove_prompt" | "clear_prompt_queue" | "list_mcp_status" | "get_settings" | "put_settings";
+    route: "list_projects" | "create_project" | "update_project" | "delete_project" | "bind_studio" | "list_project_sessions" | "create_session" | "get_session" | "update_session" | "delete_session" | "get_session_memory" | "get_session_memory_details" | "compact_session" | "remember_and_delete_session" | "fork_session" | "list_path_autocomplete" | "pick_directory" | "search_project_files" | "enqueue_prompt" | "get_prompt_queue" | "remove_prompt" | "clear_prompt_queue" | "list_mcp_status" | "get_settings" | "put_settings";
     id?: string;
     /** Parsed query params, if the path carried a `?...` suffix. */
     query?: URLSearchParams;

package/dist/relay/dispatcher.d.ts.map

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

package/dist/relay/dispatcher.js

@@ -43,6 +43,7 @@ import { BadRequestError, NotFoundError } from "../server/handlers/errors.js";
 import { handleListMcpStatus } from "../server/handlers/mcp-status.js";
 import { handlePathAutocomplete } from "../server/handlers/paths-autocomplete.js";
 import { handlePickDirectory } from "../server/handlers/paths-pick-directory.js";
+import { handleSearchProjectFiles } from "../server/handlers/files-search.js";
 import { handleBindStudioProject, handleCreateProject, handleDeleteProject, handleListProjects, handleListSessionsByProject, handleUpdateProject, } from "../server/handlers/projects.js";
 import { handleCompactSession, handleCreateSession, handleDeleteSession, handleForkSession, handleRememberAndDeleteSession, handleGetSessionDetail, handleGetSessionMemoryDetails, handleGetSessionMemoryStatus, handleUpdateSession, } from "../server/handlers/sessions.js";
 import { handleClearPromptQueue, handleEnqueuePrompt, handleGetPromptQueue, handleRemovePrompt, } from "../server/handlers/queue.js";
@@ -101,6 +102,14 @@ export function matchRoute(method, path) {
             return { route: "create_session" };
         return null;
     }
+    // /api/projects/:id/files/search
+    const projectFilesMatch = /^\/api\/projects\/([^/]+)\/files\/search$/.exec(cleanPath);
+    if (projectFilesMatch) {
+        const id = decodeURIComponent(projectFilesMatch[1]);
+        if (method === "GET")
+            return { route: "search_project_files", id, query };
+        return null;
+    }
     // /api/projects/:id/bind-studio
     const bindStudioMatch = /^\/api\/projects\/([^/]+)\/bind-studio$/.exec(cleanPath);
     if (bindStudioMatch) {
@@ -406,6 +415,10 @@ async function dispatchRoute(match, body, deps) {
         }
         case "pick_directory":
             return handlePickDirectory();
+        case "search_project_files": {
+            const searchQuery = match.query?.get("query") ?? "";
+            return handleSearchProjectFiles(store, id, searchQuery);
+        }
         case "enqueue_prompt":
             return handleEnqueuePrompt(store, manager, id, asObject(body));
         case "get_prompt_queue":

package/dist/server/handlers/files-search.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Project file search for the agent composer `@` mention dropdown.
+ *
+ * `GET /api/projects/:id/files/search?query=<query>` returns files whose
+ * relative path contains the query (case-insensitive). Results are limited
+ * to `MAX_RESULTS` and common generated directories are always excluded.
+ *
+ * The handler is synchronous-style but returns a Promise because `glob`
+ * exposes an async API.
+ */
+import type { SessionStore } from "../storage.js";
+export interface ProjectFileSearchResult {
+    /** Absolute filesystem path. */
+    path: string;
+    /** Path relative to the project root (POSIX separators). */
+    relativePath: string;
+    /** Filename (basename). */
+    name: string;
+}
+/**
+ * Search files in a project whose relative path contains `query`
+ * (case-insensitive). Returns an empty array when the project has no
+ * files, when the query is empty, or when the project path is unreadable.
+ */
+export declare function handleSearchProjectFiles(store: SessionStore, projectId: string, query: string): Promise<ProjectFileSearchResult[]>;
+//# sourceMappingURL=files-search.d.ts.map

package/dist/server/handlers/files-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files-search.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/files-search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,MAAM,WAAW,uBAAuB;IACtC,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAC;IACrB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AAyBD;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAqDpC"}

package/dist/server/handlers/files-search.js

@@ -0,0 +1,89 @@
+/**
+ * Project file search for the agent composer `@` mention dropdown.
+ *
+ * `GET /api/projects/:id/files/search?query=<query>` returns files whose
+ * relative path contains the query (case-insensitive). Results are limited
+ * to `MAX_RESULTS` and common generated directories are always excluded.
+ *
+ * The handler is synchronous-style but returns a Promise because `glob`
+ * exposes an async API.
+ */
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { glob } from "glob";
+import { NotFoundError } from "./errors.js";
+/** Maximum number of suggestions shown in the composer dropdown. */
+const MAX_RESULTS = 20;
+/**
+ * Directories/patterns that are never useful as `@` mention targets.
+ * These are applied in addition to the project's own `.gitignore`.
+ */
+const ALWAYS_IGNORE = [
+    "**/node_modules/**",
+    "**/.git/**",
+    "**/.next/**",
+    "**/.nuxt/**",
+    "**/.svelte-kit/**",
+    "**/.astro/**",
+    "**/dist/**",
+    "**/build/**",
+    "**/.spectral/**",
+    "**/.vscode/**",
+    "**/.idea/**",
+    "**/coverage/**",
+    "**/*.log",
+];
+/**
+ * Search files in a project whose relative path contains `query`
+ * (case-insensitive). Returns an empty array when the project has no
+ * files, when the query is empty, or when the project path is unreadable.
+ */
+export async function handleSearchProjectFiles(store, projectId, query) {
+    const project = store.getProject(projectId);
+    if (!project) {
+        throw new NotFoundError("Project not found");
+    }
+    const projectPath = project.path;
+    const trimmedQuery = query.trim();
+    if (!trimmedQuery) {
+        return [];
+    }
+    const ignorePatterns = [...ALWAYS_IGNORE];
+    // Read root .gitignore when present. Nested .gitignores are ignored for
+    // now — this keeps the search fast and the implementation small; the
+    // hard-coded ALWAYS_IGNORE already catches the largest generated dirs.
+    try {
+        const gitignore = readFileSync(join(projectPath, ".gitignore"), "utf8");
+        const patterns = gitignore
+            .split("\n")
+            .map((line) => line.trim())
+            .filter((line) => line && !line.startsWith("#"));
+        ignorePatterns.push(...patterns);
+    }
+    catch {
+        // .gitignore missing or unreadable — proceed without it.
+    }
+    const lowerQuery = trimmedQuery.toLowerCase();
+    let matches;
+    try {
+        matches = await glob("**/*", {
+            cwd: projectPath,
+            nodir: true,
+            dot: false,
+            ignore: ignorePatterns,
+        });
+    }
+    catch {
+        // Project path unreadable or not a directory — return empty rather
+        // than crashing the composer dropdown.
+        return [];
+    }
+    const filtered = matches
+        .filter((relativePath) => relativePath.toLowerCase().includes(lowerQuery))
+        .slice(0, MAX_RESULTS);
+    return filtered.map((relativePath) => ({
+        path: join(projectPath, relativePath),
+        relativePath,
+        name: relativePath.split("/").pop() ?? relativePath,
+    }));
+}

package/dist/server/inter-agent-broker.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Inter-agent communication broker for `spectral serve`.
+ *
+ * Provides project-scoped, channel-based messaging between active agent
+ * sessions running in the same spectral process on the same machine. Messages
+ * are durably backed by SQLite so they survive reconnects and can be polled by
+ * sessions that were not attached when the message was sent.
+ *
+ * The broker is intentionally process-local: subscriptions are in-memory
+ * inside the `spectral serve` daemon. Cross-process delivery on the same
+ * machine happens through the shared SQLite backing when each process creates
+ * its own broker instance pointing at the same `sessions.db`.
+ */
+import type { SessionStore } from "./storage.js";
+export interface InterAgentMessage {
+    /** Unique message id (UUID). */
+    id: string;
+    /** Owning project. */
+    projectId: string;
+    /** Logical channel within the project (e.g. "memory", "task-handoff"). */
+    channel: string;
+    /** Session that sent the message. */
+    senderSessionId: string;
+    /** Optional human-readable sender name. */
+    senderName?: string;
+    /** When set, the message is a private direct message; otherwise broadcast. */
+    recipientSessionId?: string;
+    /** Message kind used to route interpretation (e.g. "observation"). */
+    kind: string;
+    /** Opaque JSON payload. */
+    payload: string;
+    /** Timestamp (ms since epoch) when the message was created. */
+    createdAt: number;
+    /** Timestamp (ms) when the recipient first polled it, if ever. */
+    deliveredAt?: number;
+    /** Timestamp (ms) after which the message may be garbage collected. */
+    expiresAt?: number;
+}
+export interface InterAgentSendInput {
+    projectId: string;
+    channel: string;
+    senderSessionId: string;
+    senderName?: string;
+    /** Omit for broadcast. */
+    recipientSessionId?: string;
+    kind: string;
+    payload: string;
+    /** Default: 24 hours. Set to 0 to disable expiry. */
+    ttlSeconds?: number;
+}
+export interface InterAgentPollInput {
+    projectId: string;
+    /** Filter by channel. Omit to poll all channels in the project. */
+    channel?: string;
+    /** Poll only messages addressed to this session (or broadcast). Omit to poll all. */
+    recipientSessionId?: string;
+    /** Only return messages created after this timestamp (exclusive). */
+    since?: number;
+    /** Maximum messages to return. Default 100. */
+    limit?: number;
+    /** Mark returned messages as delivered. Default true. */
+    markDelivered?: boolean;
+}
+export interface InterAgentSubscribeInput {
+    sessionId: string;
+    projectId: string;
+    channel?: string;
+    handler: (msg: InterAgentMessage) => void;
+}
+export interface InterAgentBrokerOptions {
+    store: SessionStore;
+    /** Default TTL in seconds for messages that don't specify one. Default 86400. */
+    defaultTtlSeconds?: number;
+}
+/**
+ * In-process broker for inter-session messages.
+ *
+ * All public methods are synchronous because the underlying `SessionStore`
+ * uses better-sqlite3. Live subscribers are called synchronously from `send`.
+ */
+export declare class InterAgentBroker {
+    private readonly store;
+    private readonly defaultTtlSeconds;
+    /**
+     * In-process subscriptions keyed by `projectId:channel`. Each active session
+     * in the current process registers a handler here to receive live pushes.
+     */
+    private readonly subscriptions;
+    constructor(opts: InterAgentBrokerOptions);
+    /**
+     * Send a message. Persists it to SQLite and synchronously pushes it to any
+     * in-process subscribers whose session/channel filters match.
+     */
+    send(input: InterAgentSendInput): InterAgentMessage;
+    /**
+     * Poll for messages matching the filter. By default marks returned messages
+     * as delivered so they won't be returned again on subsequent polls.
+     */
+    poll(input: InterAgentPollInput): InterAgentMessage[];
+    /**
+     * Subscribe a session to live pushes for a project/channel. Returns an
+     * unsubscribe function. Subscriptions are in-process only.
+     */
+    subscribe(input: InterAgentSubscribeInput): () => void;
+    /**
+     * Delete expired messages from the backing store. Call periodically.
+     */
+    cleanup(maxAgeSeconds?: number): void;
+    private pushToSubscribers;
+}
+//# sourceMappingURL=inter-agent-broker.d.ts.map

package/dist/server/inter-agent-broker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inter-agent-broker.d.ts","sourceRoot":"","sources":["../../src/server/inter-agent-broker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjD,MAAM,WAAW,iBAAiB;IAChC,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,eAAe,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qFAAqF;IACrF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,YAAY,CAAC;IACpB,iFAAiF;IACjF,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAE3C;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA4D;gBAE9E,IAAI,EAAE,uBAAuB;IAKzC;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,mBAAmB,GAAG,iBAAiB;IAyBnD;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,mBAAmB,GAAG,iBAAiB,EAAE;IAWrD;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,wBAAwB,GAAG,MAAM,IAAI;IA4BtD;;OAEG;IACH,OAAO,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI;IAQrC,OAAO,CAAC,iBAAiB;CAqB1B"}

package/dist/server/inter-agent-broker.js

@@ -0,0 +1,136 @@
+/**
+ * Inter-agent communication broker for `spectral serve`.
+ *
+ * Provides project-scoped, channel-based messaging between active agent
+ * sessions running in the same spectral process on the same machine. Messages
+ * are durably backed by SQLite so they survive reconnects and can be polled by
+ * sessions that were not attached when the message was sent.
+ *
+ * The broker is intentionally process-local: subscriptions are in-memory
+ * inside the `spectral serve` daemon. Cross-process delivery on the same
+ * machine happens through the shared SQLite backing when each process creates
+ * its own broker instance pointing at the same `sessions.db`.
+ */
+import { randomUUID } from "node:crypto";
+/**
+ * In-process broker for inter-session messages.
+ *
+ * All public methods are synchronous because the underlying `SessionStore`
+ * uses better-sqlite3. Live subscribers are called synchronously from `send`.
+ */
+export class InterAgentBroker {
+    store;
+    defaultTtlSeconds;
+    /**
+     * In-process subscriptions keyed by `projectId:channel`. Each active session
+     * in the current process registers a handler here to receive live pushes.
+     */
+    subscriptions = new Map();
+    constructor(opts) {
+        this.store = opts.store;
+        this.defaultTtlSeconds = opts.defaultTtlSeconds ?? 24 * 60 * 60;
+    }
+    /**
+     * Send a message. Persists it to SQLite and synchronously pushes it to any
+     * in-process subscribers whose session/channel filters match.
+     */
+    send(input) {
+        const now = Date.now();
+        const ttl = input.ttlSeconds === undefined
+            ? this.defaultTtlSeconds
+            : input.ttlSeconds;
+        const msg = {
+            id: randomUUID(),
+            projectId: input.projectId,
+            channel: input.channel,
+            senderSessionId: input.senderSessionId,
+            senderName: input.senderName,
+            recipientSessionId: input.recipientSessionId,
+            kind: input.kind,
+            payload: input.payload,
+            createdAt: now,
+            expiresAt: ttl > 0 ? now + ttl * 1000 : undefined,
+        };
+        this.store.insertInterAgentMessage(msg);
+        this.pushToSubscribers(msg);
+        return msg;
+    }
+    /**
+     * Poll for messages matching the filter. By default marks returned messages
+     * as delivered so they won't be returned again on subsequent polls.
+     */
+    poll(input) {
+        return this.store.pollInterAgentMessages({
+            projectId: input.projectId,
+            channel: input.channel,
+            recipientSessionId: input.recipientSessionId,
+            since: input.since,
+            limit: input.limit ?? 100,
+            markDelivered: input.markDelivered ?? true,
+        });
+    }
+    /**
+     * Subscribe a session to live pushes for a project/channel. Returns an
+     * unsubscribe function. Subscriptions are in-process only.
+     */
+    subscribe(input) {
+        const key = subscriptionKey(input.projectId, input.channel);
+        let set = this.subscriptions.get(key);
+        if (!set) {
+            set = new Set();
+            this.subscriptions.set(key, set);
+        }
+        const wrapped = (msg) => {
+            // Don't deliver the sender's own messages back to itself.
+            if (msg.senderSessionId === input.sessionId)
+                return;
+            // Respect direct-message targeting.
+            if (msg.recipientSessionId && msg.recipientSessionId !== input.sessionId)
+                return;
+            input.handler(msg);
+        };
+        set.add(wrapped);
+        return () => {
+            const current = this.subscriptions.get(key);
+            if (!current)
+                return;
+            current.delete(wrapped);
+            if (current.size === 0) {
+                this.subscriptions.delete(key);
+            }
+        };
+    }
+    /**
+     * Delete expired messages from the backing store. Call periodically.
+     */
+    cleanup(maxAgeSeconds) {
+        const now = Date.now();
+        if (maxAgeSeconds !== undefined) {
+            this.store.deleteInterAgentMessagesOlderThan(now - maxAgeSeconds * 1000);
+        }
+        this.store.deleteExpiredInterAgentMessages(now);
+    }
+    pushToSubscribers(msg) {
+        // Try both channel-specific and project-wide subscriptions.
+        const keys = [
+            subscriptionKey(msg.projectId, msg.channel),
+            subscriptionKey(msg.projectId, undefined),
+        ];
+        for (const key of keys) {
+            const set = this.subscriptions.get(key);
+            if (!set)
+                continue;
+            for (const handler of set) {
+                try {
+                    handler(msg);
+                }
+                catch (err) {
+                    console.error(`[inter-agent] subscriber error: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
+        }
+    }
+}
+function subscriptionKey(projectId, channel) {
+    return channel ? `${projectId}:${channel}` : projectId;
+}

package/dist/server/session-stream.d.ts

@@ -196,6 +196,7 @@ export declare class SessionStreamManager {
     private readonly machineJwt;
     private readonly bridgeFactory;
     private readonly agentDir;
+    private readonly broker;
     private readonly streams;
     private disposed;
     constructor(opts: SessionStreamManagerOptions);

package/dist/server/session-stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-stream.d.ts","sourceRoot":"","sources":["../../src/server/session-stream.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-stream.d.ts","sourceRoot":"","sources":["../../src/server/session-stream.ts"],"names":[],"mappings":"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"}

package/dist/server/session-stream.js

@@ -38,6 +38,8 @@
  */
 import { randomUUID } from "node:crypto";
 import { AgentBridge } from "./agent-bridge.js";
+import { InterAgentBroker } from "./inter-agent-broker.js";
+import { setInterAgentBroker } from "../memory/inter-agent-broker-singleton.js";
 import { getMemoryState, isSourceEntry, rawTokensSinceLastBound, rawTokensSinceLastCompaction, } from "../memory/branch.js";
 import { observationPoolTokens, renderSummary } from "../memory/compaction.js";
 import { loadConfig } from "../memory/config.js";
@@ -233,6 +235,7 @@ export class SessionStreamManager {
     machineJwt;
     bridgeFactory;
     agentDir;
+    broker;
     streams = new Map();
     disposed = false;
     constructor(opts) {
@@ -242,13 +245,19 @@ export class SessionStreamManager {
         this.machineJwt = opts.machineJwt;
         this.bridgeFactory = opts.bridgeFactory ?? DEFAULT_BRIDGE_FACTORY;
         this.agentDir = opts.agentDir;
+        // Broker for project-scoped inter-session communication.
+        this.broker = new InterAgentBroker({ store: this.store });
         // Wire the project observations store singleton so the memory extension's
         // read_project_observations tool can query cross-session observations.
         setProjectObsStore({
             insertProjectObservations: (pid, sid, obs, ts) => this.store.insertProjectObservations(pid, sid, obs, ts),
             searchProjectObservations: (pid, q, limit) => this.store.searchProjectObservations(pid, q, limit),
+            getProjectObservationById: (pid, oid) => this.store.getProjectObservationById(pid, oid),
             getProjectByCwd: (cwd) => this.store.getProjectByCwd(cwd),
         });
+        // Wire the inter-agent broker singleton so the memory extension can send
+        // and receive live observation messages between active sessions.
+        setInterAgentBroker(this.broker);
     }
     /**
      * Attach a subscriber to a session. Lazily creates the underlying spectral
@@ -1048,6 +1057,40 @@ export class SessionStreamManager {
             },
         };
         stream.bridge = this.bridgeFactory(bridgeOpts);
+        // Subscribe this session to live inter-agent observation messages so the
+        // browser UI can surface them even before the memory extension injects
+        // them into the agent context.
+        if (projectId) {
+            stream.interAgentUnsubscribe = this.broker.subscribe({
+                sessionId,
+                projectId,
+                channel: "memory",
+                handler: (msg) => {
+                    if (msg.senderSessionId === sessionId)
+                        return;
+                    if (msg.kind !== "observation")
+                        return;
+                    try {
+                        const payload = JSON.parse(msg.payload);
+                        const relevance = payload.relevance;
+                        this.broadcast(stream, {
+                            type: "inter_agent_observation",
+                            projectId: msg.projectId,
+                            sourceSessionId: msg.senderSessionId,
+                            sourceSessionName: msg.senderName,
+                            memoryId: String(payload.memoryId ?? ""),
+                            content: String(payload.content ?? ""),
+                            relevance,
+                            originType: payload.originType === "reflection" ? "reflection" : "observation",
+                            timestamp: String(payload.timestamp ?? new Date().toISOString()),
+                        });
+                    }
+                    catch (err) {
+                        console.error(`[spectral] error: failed to broadcast inter-agent observation: ${err instanceof Error ? err.message : String(err)}`);
+                    }
+                },
+            });
+        }
         stream.ready = stream.bridge
             .start()
             .then(() => {