byterover-cli 1.8.0 → 2.1.0

package/dist/server/core/domain/transport/schemas.d.ts

@@ -15,13 +15,13 @@ export declare const TokenUsageSchema: z.ZodObject<{
     outputTokens: z.ZodNumber;
     totalTokens: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
+    totalTokens: number;
     inputTokens: number;
     outputTokens: number;
-    totalTokens: number;
 }, {
+    totalTokens: number;
     inputTokens: number;
     outputTokens: number;
-    totalTokens: number;
 }>;
 export declare const LogLevelSchema: z.ZodEnum<["debug", "error", "info", "warn"]>;
 export declare const UIEventTypeSchema: z.ZodEnum<["banner", "help", "prompt", "response", "separator", "shutdown"]>;
@@ -67,7 +67,7 @@ export declare const ExecutionStartedPayloadSchema: z.ZodObject<{
 export declare const ExecutionTerminatedPayloadSchema: z.ZodObject<{
     durationMs: z.ZodOptional<z.ZodNumber>;
     endTime: z.ZodDate;
-    error: z.ZodOptional<z.ZodAny>;
+    error: z.ZodOptional<z.ZodUnknown>;
     reason: z.ZodEnum<["ABORTED", "ERROR", "GOAL", "MAX_TURNS", "PROTOCOL_VIOLATION", "TIMEOUT"]>;
     sessionId: z.ZodString;
     toolCallsExecuted: z.ZodNumber;
@@ -78,7 +78,7 @@ export declare const ExecutionTerminatedPayloadSchema: z.ZodObject<{
     reason: "ABORTED" | "ERROR" | "GOAL" | "MAX_TURNS" | "PROTOCOL_VIOLATION" | "TIMEOUT";
     sessionId: string;
     endTime: Date;
-    error?: any;
+    error?: unknown;
     durationMs?: number | undefined;
 }, {
     toolCallsExecuted: number;
@@ -86,7 +86,7 @@ export declare const ExecutionTerminatedPayloadSchema: z.ZodObject<{
     reason: "ABORTED" | "ERROR" | "GOAL" | "MAX_TURNS" | "PROTOCOL_VIOLATION" | "TIMEOUT";
     sessionId: string;
     endTime: Date;
-    error?: any;
+    error?: unknown;
     durationMs?: number | undefined;
 }>;
 export declare const LogPayloadSchema: z.ZodObject<{
@@ -204,13 +204,13 @@ export declare const ResponsePayloadSchema: z.ZodObject<{
         outputTokens: z.ZodNumber;
         totalTokens: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
+        totalTokens: number;
         inputTokens: number;
         outputTokens: number;
-        totalTokens: number;
     }, {
+        totalTokens: number;
         inputTokens: number;
         outputTokens: number;
-        totalTokens: number;
     }>>;
 }, "strip", z.ZodTypeAny, {
     sessionId: string;
@@ -220,9 +220,9 @@ export declare const ResponsePayloadSchema: z.ZodObject<{
     provider?: string | undefined;
     partial?: boolean | undefined;
     tokenUsage?: {
+        totalTokens: number;
         inputTokens: number;
         outputTokens: number;
-        totalTokens: number;
     } | undefined;
 }, {
     sessionId: string;
@@ -232,9 +232,9 @@ export declare const ResponsePayloadSchema: z.ZodObject<{
     provider?: string | undefined;
     partial?: boolean | undefined;
     tokenUsage?: {
+        totalTokens: number;
         inputTokens: number;
         outputTokens: number;
-        totalTokens: number;
     } | undefined;
 }>;
 export declare const ThinkingPayloadSchema: z.ZodObject<{
@@ -436,6 +436,50 @@ export declare const TransportAgentEventNames: {
     readonly RESTARTED: "agent:restarted";
     readonly RESTARTING: "agent:restarting";
 };
+/**
+ * Internal state-request events (agent ↔ daemon).
+ * Used by agent child processes to fetch config/auth from the daemon's state server.
+ */
+export declare const TransportStateEventNames: {
+    readonly GET_AUTH: "state:getAuth";
+    readonly GET_PROJECT_CONFIG: "state:getProjectConfig";
+    readonly GET_PROVIDER_CONFIG: "state:getProviderConfig";
+};
+/**
+ * Daemon → agent broadcast events (fire-and-forget, no ack).
+ * Used to notify agent child processes of global state changes.
+ */
+export declare const TransportDaemonEventNames: {
+    readonly PROVIDER_UPDATED: "provider:updated";
+};
+/**
+ * Response payload for GET_PROVIDER_CONFIG — shared between daemon and agent process.
+ *
+ * `activeProvider` vs `provider`:
+ * - `activeProvider` (always set) — identity used for cache keys, session tracking, and change detection.
+ * - `provider` (optional) — LLM routing hint passed through to the SessionManager's LLM config.
+ *   Undefined for 'byterover' (uses internal routing), set for all external providers.
+ */
+export interface ProviderConfigResponse {
+    activeModel?: string;
+    activeProvider: string;
+    maxInputTokens?: number;
+    openRouterApiKey?: string;
+    provider?: string;
+    providerApiKey?: string;
+    providerBaseUrl?: string;
+    providerHeaders?: Record<string, string>;
+    providerKeyMissing?: boolean;
+}
+/**
+ * Transport-generated client lifecycle events.
+ * Used by external clients (tui/cli/mcp) to register and associate with projects.
+ */
+export declare const TransportClientEventNames: {
+    readonly ASSOCIATE_PROJECT: "client:associateProject";
+    readonly REGISTER: "client:register";
+    readonly UPDATE_AGENT_NAME: "client:updateAgentName";
+};
 /**
  * Transport-generated session events (internal).
  */
@@ -461,6 +505,8 @@ export declare const TaskExecuteSchema: z.ZodObject<{
     files: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     /** Folder path for curate-folder task type */
     folderPath: z.ZodOptional<z.ZodString>;
+    /** Project path this task belongs to (for multi-project routing) */
+    projectPath: z.ZodOptional<z.ZodString>;
     /** Unique task identifier */
     taskId: z.ZodString;
     /** Task type */
@@ -471,16 +517,18 @@ export declare const TaskExecuteSchema: z.ZodObject<{
     taskId: string;
     clientId: string;
     files?: string[] | undefined;
-    clientCwd?: string | undefined;
     folderPath?: string | undefined;
+    clientCwd?: string | undefined;
+    projectPath?: string | undefined;
 }, {
     type: "curate" | "query" | "curate-folder";
     content: string;
     taskId: string;
     clientId: string;
     files?: string[] | undefined;
-    clientCwd?: string | undefined;
     folderPath?: string | undefined;
+    clientCwd?: string | undefined;
+    projectPath?: string | undefined;
 }>;
 /**
  * task:cancel - Transport tells Agent to cancel a task
@@ -605,11 +653,15 @@ export declare const LlmUnsupportedInputEventSchema: z.ZodObject<{
  * task:ack - Transport acknowledges task creation
  */
 export declare const TaskAckSchema: z.ZodObject<{
+    /** Log entry ID from CurateLogHandler, if applicable */
+    logId: z.ZodOptional<z.ZodString>;
     taskId: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     taskId: string;
+    logId?: string | undefined;
 }, {
     taskId: string;
+    logId?: string | undefined;
 }>;
 /**
  * task:created - Broadcasted when a new task is created
@@ -633,15 +685,15 @@ export declare const TaskCreatedSchema: z.ZodObject<{
     content: string;
     taskId: string;
     files?: string[] | undefined;
-    clientCwd?: string | undefined;
     folderPath?: string | undefined;
+    clientCwd?: string | undefined;
 }, {
     type: "curate" | "query" | "curate-folder";
     content: string;
     taskId: string;
     files?: string[] | undefined;
-    clientCwd?: string | undefined;
     folderPath?: string | undefined;
+    clientCwd?: string | undefined;
 }>;
 /**
  * task:started - Agent begins processing the task
@@ -687,14 +739,21 @@ export declare const TaskCancelledEventSchema: z.ZodObject<{
  * task:completed - Task finished successfully
  */
 export declare const TaskCompletedEventSchema: z.ZodObject<{
+    clientId: z.ZodOptional<z.ZodString>;
+    /** Log entry ID from CurateLogHandler, if applicable */
+    logId: z.ZodOptional<z.ZodString>;
     result: z.ZodString;
     taskId: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     result: string;
     taskId: string;
+    clientId?: string | undefined;
+    logId?: string | undefined;
 }, {
     result: string;
     taskId: string;
+    clientId?: string | undefined;
+    logId?: string | undefined;
 }>;
 /**
  * Structured error object
@@ -720,6 +779,7 @@ export declare const TaskErrorDataSchema: z.ZodObject<{
  * task:error - Task failed with error
  */
 export declare const TaskErrorEventSchema: z.ZodObject<{
+    clientId: z.ZodOptional<z.ZodString>;
     error: z.ZodObject<{
         code: z.ZodOptional<z.ZodString>;
         details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -736,6 +796,8 @@ export declare const TaskErrorEventSchema: z.ZodObject<{
         code?: string | undefined;
         details?: Record<string, unknown> | undefined;
     }>;
+    /** Log entry ID from CurateLogHandler, if applicable */
+    logId: z.ZodOptional<z.ZodString>;
     taskId: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     error: {
@@ -745,6 +807,8 @@ export declare const TaskErrorEventSchema: z.ZodObject<{
         details?: Record<string, unknown> | undefined;
     };
     taskId: string;
+    clientId?: string | undefined;
+    logId?: string | undefined;
 }, {
     error: {
         message: string;
@@ -753,6 +817,8 @@ export declare const TaskErrorEventSchema: z.ZodObject<{
         details?: Record<string, unknown> | undefined;
     };
     taskId: string;
+    clientId?: string | undefined;
+    logId?: string | undefined;
 }>;
 /**
  * llmservice:response - LLM text output
@@ -771,13 +837,13 @@ export declare const LlmResponseEventSchema: z.ZodObject<{
         outputTokens: z.ZodNumber;
         totalTokens: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
+        totalTokens: number;
         inputTokens: number;
         outputTokens: number;
-        totalTokens: number;
     }, {
+        totalTokens: number;
         inputTokens: number;
         outputTokens: number;
-        totalTokens: number;
     }>>;
 }, "strip", z.ZodTypeAny, {
     sessionId: string;
@@ -788,9 +854,9 @@ export declare const LlmResponseEventSchema: z.ZodObject<{
     provider?: string | undefined;
     partial?: boolean | undefined;
     tokenUsage?: {
+        totalTokens: number;
         inputTokens: number;
         outputTokens: number;
-        totalTokens: number;
     } | undefined;
 }, {
     sessionId: string;
@@ -801,9 +867,9 @@ export declare const LlmResponseEventSchema: z.ZodObject<{
     provider?: string | undefined;
     partial?: boolean | undefined;
     tokenUsage?: {
+        totalTokens: number;
         inputTokens: number;
         outputTokens: number;
-        totalTokens: number;
     } | undefined;
 }>;
 /**
@@ -884,6 +950,8 @@ export declare const TaskCreateRequestSchema: z.ZodObject<{
     files: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     /** Folder path for curate-folder task type */
     folderPath: z.ZodOptional<z.ZodString>;
+    /** Project path this task belongs to (for multi-project routing) */
+    projectPath: z.ZodOptional<z.ZodString>;
     /** Task ID - generated by Client UseCase (UUID v4) */
     taskId: z.ZodString;
     /** Task type */
@@ -893,26 +961,32 @@ export declare const TaskCreateRequestSchema: z.ZodObject<{
     content: string;
     taskId: string;
     files?: string[] | undefined;
-    clientCwd?: string | undefined;
     folderPath?: string | undefined;
+    clientCwd?: string | undefined;
+    projectPath?: string | undefined;
 }, {
     type: "curate" | "query" | "curate-folder";
     content: string;
     taskId: string;
     files?: string[] | undefined;
-    clientCwd?: string | undefined;
     folderPath?: string | undefined;
+    clientCwd?: string | undefined;
+    projectPath?: string | undefined;
 }>;
 /**
  * Response after task creation
  */
 export declare const TaskCreateResponseSchema: z.ZodObject<{
+    /** Log entry ID from CurateLogHandler, if applicable */
+    logId: z.ZodOptional<z.ZodString>;
     /** Created task ID */
     taskId: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     taskId: string;
+    logId?: string | undefined;
 }, {
     taskId: string;
+    logId?: string | undefined;
 }>;
 /**
  * Request to cancel a task

package/dist/server/core/domain/transport/schemas.js

@@ -62,7 +62,7 @@ export const ExecutionStartedPayloadSchema = z.object({
 export const ExecutionTerminatedPayloadSchema = z.object({
     durationMs: z.number().optional(),
     endTime: z.coerce.date(),
-    error: z.any().optional(), // Error objects don't serialize well
+    error: z.unknown().optional(), // Error objects don't serialize well
     reason: AgentTerminationReasonSchema,
     sessionId: z.string(),
     toolCallsExecuted: z.number(),
@@ -256,6 +256,31 @@ export const TransportAgentEventNames = {
     RESTARTED: 'agent:restarted',
     RESTARTING: 'agent:restarting',
 };
+/**
+ * Internal state-request events (agent ↔ daemon).
+ * Used by agent child processes to fetch config/auth from the daemon's state server.
+ */
+export const TransportStateEventNames = {
+    GET_AUTH: 'state:getAuth',
+    GET_PROJECT_CONFIG: 'state:getProjectConfig',
+    GET_PROVIDER_CONFIG: 'state:getProviderConfig',
+};
+/**
+ * Daemon → agent broadcast events (fire-and-forget, no ack).
+ * Used to notify agent child processes of global state changes.
+ */
+export const TransportDaemonEventNames = {
+    PROVIDER_UPDATED: 'provider:updated',
+};
+/**
+ * Transport-generated client lifecycle events.
+ * Used by external clients (tui/cli/mcp) to register and associate with projects.
+ */
+export const TransportClientEventNames = {
+    ASSOCIATE_PROJECT: 'client:associateProject',
+    REGISTER: 'client:register',
+    UPDATE_AGENT_NAME: 'client:updateAgentName',
+};
 /**
  * Transport-generated session events (internal).
  */
@@ -284,6 +309,8 @@ export const TaskExecuteSchema = z.object({
     files: z.array(z.string()).optional(),
     /** Folder path for curate-folder task type */
     folderPath: z.string().optional(),
+    /** Project path this task belongs to (for multi-project routing) */
+    projectPath: z.string().optional(),
     /** Unique task identifier */
     taskId: z.string(),
     /** Task type */
@@ -325,6 +352,8 @@ export const LlmUnsupportedInputEventSchema = z.object({
  * task:ack - Transport acknowledges task creation
  */
 export const TaskAckSchema = z.object({
+    /** Log entry ID from CurateLogHandler, if applicable */
+    logId: z.string().optional(),
     taskId: z.string(),
 });
 /**
@@ -373,6 +402,9 @@ export const TaskCancelledEventSchema = z.object({
  * task:completed - Task finished successfully
  */
 export const TaskCompletedEventSchema = z.object({
+    clientId: z.string().optional(),
+    /** Log entry ID from CurateLogHandler, if applicable */
+    logId: z.string().optional(),
     result: z.string(),
     taskId: z.string(),
 });
@@ -390,7 +422,10 @@ export const TaskErrorDataSchema = z.object({
  * task:error - Task failed with error
  */
 export const TaskErrorEventSchema = z.object({
+    clientId: z.string().optional(),
     error: TaskErrorDataSchema,
+    /** Log entry ID from CurateLogHandler, if applicable */
+    logId: z.string().optional(),
     taskId: z.string(),
 });
 /**
@@ -451,6 +486,8 @@ export const TaskCreateRequestSchema = z.object({
     files: z.array(z.string()).optional(),
     /** Folder path for curate-folder task type */
     folderPath: z.string().optional(),
+    /** Project path this task belongs to (for multi-project routing) */
+    projectPath: z.string().optional(),
     /** Task ID - generated by Client UseCase (UUID v4) */
     taskId: z.string().uuid('Invalid taskId format - must be UUID'),
     /** Task type */
@@ -460,6 +497,8 @@ export const TaskCreateRequestSchema = z.object({
  * Response after task creation
  */
 export const TaskCreateResponseSchema = z.object({
+    /** Log entry ID from CurateLogHandler, if applicable */
+    logId: z.string().optional(),
     /** Created task ID */
     taskId: z.string(),
 });

package/dist/server/core/domain/transport/task-info.d.ts

@@ -0,0 +1,21 @@
+import type { TaskType } from './schemas.js';
+/**
+ * Tracked task metadata used by TaskRouter for routing events
+ * and by ConnectionCoordinator for agent disconnect cleanup.
+ */
+export type TaskInfo = {
+    /** Client's working directory for file validation */
+    clientCwd?: string;
+    clientId: string;
+    content: string;
+    createdAt: number;
+    files?: string[];
+    /** Folder path for curate-folder tasks */
+    folderPath?: string;
+    /** Log entry ID set by lifecycle hook after onTaskCreate */
+    logId?: string;
+    /** Project path this task belongs to (for multi-project routing) */
+    projectPath?: string;
+    taskId: string;
+    type: TaskType;
+};

package/dist/server/core/interfaces/agent/i-agent-pool.d.ts

@@ -0,0 +1,88 @@
+import type { TaskExecute } from '../../domain/transport/schemas.js';
+/**
+ * Result of submitting a task to the pool.
+ * Uses discriminated union (success field) instead of thrown errors.
+ */
+export type SubmitTaskResult = {
+    message: string;
+    reason: 'create_failed' | 'invalid_task' | 'pool_full';
+    success: false;
+} | {
+    success: true;
+};
+/**
+ * Read-only snapshot of a managed agent entry for monitoring.
+ */
+export type AgentEntryInfo = {
+    /** Number of currently executing tasks */
+    readonly activeTasks: number;
+    /** Child process PID (-1 if process hasn't started yet or has exited) */
+    readonly childPid: number;
+    readonly createdAt: number;
+    readonly hasActiveTask: boolean;
+    readonly isIdle: boolean;
+    readonly lastUsedAt: number;
+    readonly projectPath: string;
+};
+/**
+ * Manages up to N forked child process agents, one per active project.
+ *
+ * Each agent is a separate Node.js process (child_process.fork())
+ * associated with a projectPath. When the pool is full, new projects
+ * are rejected with `pool_full`. Existing agents can still queue tasks.
+ * Idle agents are cleaned up by AgentIdleTimeoutPolicy after inactivity.
+ *
+ * Pool is pure lifecycle management — zero knowledge of auth, project config,
+ * or agent internals. Each child process handles all agent setup independently.
+ *
+ * Consumed by:
+ * - brv-server.ts: instantiation and wiring
+ * - TransportHandlers: delegates task submission via submitTask()
+ * - ClientManager.onProjectEmpty → markIdle() for idle cleanup
+ */
+export interface IAgentPool {
+    /**
+     * Get pool entries for monitoring/debugging.
+     */
+    getEntries(): readonly AgentEntryInfo[];
+    /**
+     * Get current pool size (number of managed agents).
+     */
+    getSize(): number;
+    /**
+     * Handle agent socket disconnection.
+     * Removes the agent from the pool and stops the child process.
+     * Called by TransportHandlers when an agent's Socket.IO client disconnects.
+     * Without this, the pool retains a stale clientId and tasks sent to it are lost.
+     */
+    handleAgentDisconnected(projectPath: string): void;
+    /**
+     * Check if the pool has an agent for a given project.
+     */
+    hasAgent(projectPath: string): boolean;
+    /**
+     * Mark a project's agent as idle (no external clients).
+     * Called by wiring code in response to ClientManager.onProjectEmpty.
+     * Idle agents are candidates for cleanup by AgentIdleTimeoutPolicy.
+     */
+    markIdle(projectPath: string): void;
+    /**
+     * Notify pool that a task has completed (or errored) for a project.
+     * Clears busy flag and drains queued tasks for the project.
+     * Called by TransportHandlers on task:completed / task:error events.
+     */
+    notifyTaskCompleted(projectPath: string): void;
+    /**
+     * Graceful shutdown: stop all agent processes and clear the pool.
+     * Called during daemon shutdown sequence.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Submit a task for execution.
+     *
+     * The pool acquires or forks an agent process for the task's project,
+     * then sends the task via the transport server. If the agent is busy,
+     * the task is queued in a per-project FIFO queue.
+     */
+    submitTask(task: TaskExecute): Promise<SubmitTaskResult>;
+}

package/dist/server/core/interfaces/client/i-client-manager.d.ts

@@ -0,0 +1,117 @@
+import type { ClientInfo, ClientType } from '../../domain/client/client-info.js';
+/**
+ * Callback fired when a project has no remaining external clients.
+ * External = tui | cli | extension | mcp (not agent — agents are workers, not users).
+ *
+ * @param projectPath - The project that lost all external clients
+ */
+export type ProjectEmptyCallback = (projectPath: string) => void;
+/**
+ * Manages connected client lifecycle and project membership.
+ *
+ * Tracks which clients are connected to which projects and fires a
+ * callback when a project loses all external clients.
+ *
+ * Client type semantics:
+ * - 'tui'/'cli'/'extension'/'mcp' are external clients (count toward project membership)
+ * - 'agent' is a worker process (does NOT count — handled by AgentPool)
+ *
+ * Consumed by TransportHandlers (T4) for client registration,
+ * disconnect handling, and onProjectEmpty wiring.
+ */
+export interface IClientManager {
+    /**
+     * Associate a global-scope client with a project.
+     * Used when an MCP client's first tool call provides a cwd.
+     * After association, the client counts toward project membership
+     * and onProjectEmpty tracking.
+     *
+     * No-op if client is unknown or already associated with a project.
+     *
+     * @param clientId - The client's Socket.IO ID
+     * @param projectPath - The project path to associate
+     */
+    associateProject(clientId: string, projectPath: string): void;
+    /**
+     * Get all projects that have at least one registered client.
+     *
+     * @returns Array of project paths
+     */
+    getActiveProjects(): string[];
+    /**
+     * Get all registered clients (for debugging).
+     * Used by daemon:getState handler.
+     *
+     * @returns Array of all ClientInfo
+     */
+    getAllClients(): ClientInfo[];
+    /**
+     * Get a client by ID.
+     *
+     * @param clientId - The client's Socket.IO ID
+     * @returns ClientInfo or undefined if not found
+     */
+    getClient(clientId: string): ClientInfo | undefined;
+    /**
+     * Get all clients associated with a project.
+     * Returns both external clients and agent clients.
+     *
+     * @param projectPath - The project path
+     * @returns Array of ClientInfo for that project
+     */
+    getClientsByProject(projectPath: string): ClientInfo[];
+    /**
+     * Register callback for when a client connects (registers).
+     * Used by IdleTimeoutPolicy to track registered clients for daemon shutdown.
+     *
+     * Only one callback supported — subsequent calls overwrite previous.
+     *
+     * @param callback - Function called when a client registers
+     */
+    onClientConnected(callback: () => void): void;
+    /**
+     * Register callback for when a client disconnects (unregisters).
+     * Used by IdleTimeoutPolicy to track registered clients for daemon shutdown.
+     *
+     * Only one callback supported — subsequent calls overwrite previous.
+     *
+     * @param callback - Function called when a client unregisters
+     */
+    onClientDisconnected(callback: () => void): void;
+    /**
+     * Register callback for when a project has no external clients.
+     * Called immediately when the last external client (tui/mcp) disconnects.
+     * Agent clients don't count — they're workers, not users.
+     *
+     * Only one callback supported — subsequent calls overwrite previous.
+     *
+     * @param callback - Function called with projectPath
+     */
+    onProjectEmpty(callback: ProjectEmptyCallback): void;
+    /**
+     * Register a new client connection.
+     *
+     * @param clientId - The client's Socket.IO ID
+     * @param type - The client type ('tui' | 'cli' | 'extension' | 'mcp' | 'agent')
+     * @param projectPath - Optional project path (undefined for global-scope MCP)
+     */
+    register(clientId: string, type: ClientType, projectPath?: string): void;
+    /**
+     * Set the agent name for an MCP client.
+     * Called when the MCP initialize handshake provides clientInfo with the agent name.
+     *
+     * No-op if client is unknown.
+     *
+     * @param clientId - The client's Socket.IO ID
+     * @param agentName - The agent name from MCP clientInfo (e.g., "Windsurf", "Claude Code")
+     */
+    setAgentName(clientId: string, agentName: string): void;
+    /**
+     * Unregister a client on disconnect.
+     * Automatically checks if the client's project now has 0 external clients
+     * and fires onProjectEmpty callback if so.
+     *
+     * @param clientId - The client's Socket.IO ID
+     */
+    unregister(clientId: string): void;
+}

package/dist/server/core/interfaces/context-tree/i-context-file-reader.d.ts

@@ -5,11 +5,15 @@ import type { Narrative, RawConcept } from '../../domain/knowledge/markdown-writ
 export type ContextFileContent = {
     /** The raw content of the file */
     content: string;
+    /** Keywords for search and discovery */
+    keywords: string[];
     narrative?: Narrative;
     /** Relative path within the context tree (e.g., "structure/context.md") */
     path: string;
     rawConcept?: RawConcept;
-    /** Title extracted from the first heading, or the relative path if no heading found */
+    /** Tags for categorization and filtering */
+    tags: string[];
+    /** Title extracted from frontmatter, first heading, or the relative path if no heading found */
     title: string;
 };
 /**