devchain-cli 0.2.2 → 0.3.1

package/dist/server/modules/events/catalog/index.d.ts

@@ -64,6 +64,46 @@ export declare const eventCatalog: {
         sessionId: string;
         sessionName: string;
     }>;
+    readonly "terminal.watcher.triggered": z.ZodObject<{
+        watcherId: z.ZodString;
+        watcherName: z.ZodString;
+        customEventName: z.ZodString;
+        sessionId: z.ZodString;
+        agentId: z.ZodNullable<z.ZodString>;
+        agentName: z.ZodNullable<z.ZodString>;
+        projectId: z.ZodString;
+        viewportSnippet: z.ZodString;
+        viewportHash: z.ZodString;
+        matchedPattern: z.ZodOptional<z.ZodString>;
+        triggerCount: z.ZodNumber;
+        triggeredAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        projectId: string;
+        agentId: string | null;
+        sessionId: string;
+        agentName: string | null;
+        watcherId: string;
+        watcherName: string;
+        customEventName: string;
+        viewportSnippet: string;
+        viewportHash: string;
+        triggerCount: number;
+        triggeredAt: string;
+        matchedPattern?: string | undefined;
+    }, {
+        projectId: string;
+        agentId: string | null;
+        sessionId: string;
+        agentName: string | null;
+        watcherId: string;
+        watcherName: string;
+        customEventName: string;
+        viewportSnippet: string;
+        viewportHash: string;
+        triggerCount: number;
+        triggeredAt: string;
+        matchedPattern?: string | undefined;
+    }>;
 };
 export type EventName = keyof typeof eventCatalog;
 export type EventSchema<TName extends EventName> = (typeof eventCatalog)[TName];

package/dist/server/modules/events/catalog/index.js

@@ -5,11 +5,13 @@ const epic_assigned_1 = require("./epic.assigned");
 const session_started_1 = require("./session.started");
 const session_stopped_1 = require("./session.stopped");
 const session_crashed_1 = require("./session.crashed");
+const terminal_watcher_triggered_1 = require("./terminal.watcher.triggered");
 exports.eventCatalog = {
     [epic_assigned_1.epicAssignedEvent.name]: epic_assigned_1.epicAssignedEvent.schema,
     [session_started_1.sessionStartedEvent.name]: session_started_1.sessionStartedEvent.schema,
     [session_stopped_1.sessionStoppedEvent.name]: session_stopped_1.sessionStoppedEvent.schema,
     [session_crashed_1.sessionCrashedEvent.name]: session_crashed_1.sessionCrashedEvent.schema,
+    [terminal_watcher_triggered_1.terminalWatcherTriggeredEvent.name]: terminal_watcher_triggered_1.terminalWatcherTriggeredEvent.schema,
 };
 exports.eventNames = Object.keys(exports.eventCatalog);
 //# sourceMappingURL=index.js.map

package/dist/server/modules/events/catalog/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/events/catalog/index.ts"],"names":[],"mappings":";;;AACA,mDAAoD;AACpD,uDAAwD;AACxD,uDAAwD;AACxD,uDAAwD;AAE3C,QAAA,YAAY,GAAG;IAC1B,CAAC,iCAAiB,CAAC,IAAI,CAAC,EAAE,iCAAiB,CAAC,MAAM;IAClD,CAAC,qCAAmB,CAAC,IAAI,CAAC,EAAE,qCAAmB,CAAC,MAAM;IACtD,CAAC,qCAAmB,CAAC,IAAI,CAAC,EAAE,qCAAmB,CAAC,MAAM;IACtD,CAAC,qCAAmB,CAAC,IAAI,CAAC,EAAE,qCAAmB,CAAC,MAAM;CAC9C,CAAC;AAKE,QAAA,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,oBAAY,CAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/events/catalog/index.ts"],"names":[],"mappings":";;;AACA,mDAAoD;AACpD,uDAAwD;AACxD,uDAAwD;AACxD,uDAAwD;AACxD,6EAA6E;AAEhE,QAAA,YAAY,GAAG;IAC1B,CAAC,iCAAiB,CAAC,IAAI,CAAC,EAAE,iCAAiB,CAAC,MAAM;IAClD,CAAC,qCAAmB,CAAC,IAAI,CAAC,EAAE,qCAAmB,CAAC,MAAM;IACtD,CAAC,qCAAmB,CAAC,IAAI,CAAC,EAAE,qCAAmB,CAAC,MAAM;IACtD,CAAC,qCAAmB,CAAC,IAAI,CAAC,EAAE,qCAAmB,CAAC,MAAM;IACtD,CAAC,0DAA6B,CAAC,IAAI,CAAC,EAAE,0DAA6B,CAAC,MAAM;CAClE,CAAC;AAKE,QAAA,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,oBAAY,CAAgB,CAAC"}

package/dist/server/modules/events/catalog/terminal.watcher.triggered.d.ts

@@ -0,0 +1,45 @@
+import { z } from 'zod';
+export declare const terminalWatcherTriggeredEvent: {
+    readonly name: "terminal.watcher.triggered";
+    readonly schema: z.ZodObject<{
+        watcherId: z.ZodString;
+        watcherName: z.ZodString;
+        customEventName: z.ZodString;
+        sessionId: z.ZodString;
+        agentId: z.ZodNullable<z.ZodString>;
+        agentName: z.ZodNullable<z.ZodString>;
+        projectId: z.ZodString;
+        viewportSnippet: z.ZodString;
+        viewportHash: z.ZodString;
+        matchedPattern: z.ZodOptional<z.ZodString>;
+        triggerCount: z.ZodNumber;
+        triggeredAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        projectId: string;
+        agentId: string | null;
+        sessionId: string;
+        agentName: string | null;
+        watcherId: string;
+        watcherName: string;
+        customEventName: string;
+        viewportSnippet: string;
+        viewportHash: string;
+        triggerCount: number;
+        triggeredAt: string;
+        matchedPattern?: string | undefined;
+    }, {
+        projectId: string;
+        agentId: string | null;
+        sessionId: string;
+        agentName: string | null;
+        watcherId: string;
+        watcherName: string;
+        customEventName: string;
+        viewportSnippet: string;
+        viewportHash: string;
+        triggerCount: number;
+        triggeredAt: string;
+        matchedPattern?: string | undefined;
+    }>;
+};
+export type TerminalWatcherTriggeredEventPayload = z.infer<typeof terminalWatcherTriggeredEvent.schema>;

package/dist/server/modules/events/catalog/terminal.watcher.triggered.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.terminalWatcherTriggeredEvent = void 0;
+const zod_1 = require("zod");
+exports.terminalWatcherTriggeredEvent = {
+    name: 'terminal.watcher.triggered',
+    schema: zod_1.z.object({
+        watcherId: zod_1.z.string().min(1),
+        watcherName: zod_1.z.string().min(1),
+        customEventName: zod_1.z.string().min(1),
+        sessionId: zod_1.z.string().min(1),
+        agentId: zod_1.z.string().nullable(),
+        agentName: zod_1.z.string().nullable(),
+        projectId: zod_1.z.string().min(1),
+        viewportSnippet: zod_1.z.string().max(500),
+        viewportHash: zod_1.z.string().min(1),
+        matchedPattern: zod_1.z.string().optional(),
+        triggerCount: zod_1.z.number().int().min(1),
+        triggeredAt: zod_1.z.string().min(1),
+    }),
+};
+//# sourceMappingURL=terminal.watcher.triggered.js.map

package/dist/server/modules/events/catalog/terminal.watcher.triggered.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.watcher.triggered.js","sourceRoot":"","sources":["../../../../src/modules/events/catalog/terminal.watcher.triggered.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAMX,QAAA,6BAA6B,GAAG;IAC3C,IAAI,EAAE,4BAA4B;IAClC,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;QAEf,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5B,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9B,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAGlC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5B,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC9B,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAChC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAG5B,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC;QACpC,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAG/B,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAGrC,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACrC,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;KAC/B,CAAC;CACM,CAAC"}

package/dist/server/modules/events/subscribers/chat-message-delivery.subscriber.d.ts

@@ -18,6 +18,7 @@ export declare class ChatMessageDeliverySubscriber {
     private readonly chatService;
     private readonly storage;
     private readonly logger;
+    private readonly autoLaunchSessions;
     constructor(sessionsService: SessionsService, chatService: ChatService, storage: StorageService);
     handleChatMessageCreated(payload: ChatMessageCreatedPayload): Promise<void>;
 }

package/dist/server/modules/events/subscribers/chat-message-delivery.subscriber.js

@@ -25,6 +25,7 @@ let ChatMessageDeliverySubscriber = ChatMessageDeliverySubscriber_1 = class Chat
         this.chatService = chatService;
         this.storage = storage;
         this.logger = new common_1.Logger(ChatMessageDeliverySubscriber_1.name);
+        this.autoLaunchSessions = process.env.NODE_ENV !== 'test';
     }
     async handleChatMessageCreated(payload) {
         const { threadId, message } = payload;
@@ -32,11 +33,7 @@ let ChatMessageDeliverySubscriber = ChatMessageDeliverySubscriber_1 = class Chat
             return;
         }
         if (message.authorType === 'system') {
-            const containsToolCalls = message.content.includes('tools/call');
-            if (!containsToolCalls) {
-                this.logger.debug({ threadId, messageId: message.id }, 'System message without tool calls; skipping injection');
-                return;
-            }
+            return;
         }
         try {
             const thread = await this.chatService.getThread(threadId);
@@ -48,15 +45,36 @@ let ChatMessageDeliverySubscriber = ChatMessageDeliverySubscriber_1 = class Chat
                 return;
             }
             const activeSessions = await this.sessionsService.listActiveSessions();
+            const sessionByAgentId = new Map(activeSessions.map((s) => [s.agentId, s]));
             for (const agentId of recipients) {
-                const session = activeSessions.find((s) => s.agentId === agentId);
-                if (!session) {
-                    this.logger.debug({ threadId, agentId, messageId: message.id }, 'Agent has no active session; skipping injection');
-                    continue;
+                try {
+                    let session = sessionByAgentId.get(agentId);
+                    if (!session && this.autoLaunchSessions) {
+                        try {
+                            const launched = await this.sessionsService.launchSession({
+                                projectId: thread.projectId,
+                                agentId,
+                            });
+                            session = launched;
+                            sessionByAgentId.set(agentId, launched);
+                            this.logger.debug({ threadId, agentId, sessionId: launched.id, messageId: message.id }, 'Launched session to deliver chat message');
+                        }
+                        catch (launchError) {
+                            this.logger.debug({ threadId, agentId, messageId: message.id, error: launchError }, 'Failed to auto-launch session for chat message delivery');
+                        }
+                    }
+                    if (!session) {
+                        this.logger.debug({ threadId, agentId, messageId: message.id }, 'Agent has no active session; skipping injection');
+                        continue;
+                    }
+                    const agent = await this.storage.getAgent(agentId);
+                    const injectionText = `\n[CHAT] From: User • Thread: ${threadId}\n${message.content}\n[ACK] tools/call { name: "devchain_chat_ack", arguments: { thread_id: "${threadId}", message_id: "${message.id}", agent_name: "${agent.name}" } }\n`;
+                    await this.sessionsService.injectTextIntoSession(session.id, injectionText);
+                    this.logger.debug({ threadId, agentId, sessionId: session.id, messageId: message.id }, 'Injected chat message into session');
+                }
+                catch (deliverError) {
+                    this.logger.debug({ threadId, agentId, messageId: message.id, error: deliverError }, 'Failed to deliver chat message to agent session');
                 }
-                const injectionText = `\n[CHAT] From: User • Thread: ${threadId}\n${message.content}\n[ACK] tools/call { name: "devchain_chat_ack", arguments: { thread_id: "${threadId}", message_id: "${message.id}", agent_id: "${agentId}" } }\n`;
-                await this.sessionsService.injectTextIntoSession(session.id, injectionText);
-                this.logger.debug({ threadId, agentId, sessionId: session.id, messageId: message.id }, 'Injected chat message into session');
             }
         }
         catch (error) {

package/dist/server/modules/events/subscribers/chat-message-delivery.subscriber.js.map

@@ -1 +1 @@
-{"version":3,"file":"chat-message-delivery.subscriber.js","sourceRoot":"","sources":["../../../../src/modules/events/subscribers/chat-message-delivery.subscriber.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"chat-message-delivery.subscriber.js","sourceRoot":"","sources":["../../../../src/modules/events/subscribers/chat-message-delivery.subscriber.ts"],"names":[],"mappings":"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"}

package/dist/server/modules/mcp/constants.js

@@ -11,7 +11,11 @@ exports.DOCUMENT_TOOL_NAMES = [
     'devchain_create_document',
     'devchain_update_document',
 ];
-exports.CHAT_TOOL_NAMES = ['devchain_send_message'];
+exports.CHAT_TOOL_NAMES = [
+    'devchain_chat_ack',
+    'devchain_chat_read_history',
+    'devchain_chat_list_members',
+];
 exports.RECORDS_TOOL_NAMES = [
     'devchain_create_record',
     'devchain_update_record',

package/dist/server/modules/mcp/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/modules/mcp/constants.ts"],"names":[],"mappings":";;;AAqBA,8CAaC;AAlCY,QAAA,sBAAsB,GAAG,KAAK,CAAC;AAC/B,QAAA,kBAAkB,GAAG,KAAK,CAAC;AAC3B,QAAA,qBAAqB,GAAG,KAAK,CAAC;AAE9B,QAAA,mBAAmB,GAAG;IACjC,yBAAyB;IACzB,uBAAuB;IACvB,0BAA0B;IAC1B,0BAA0B;CAC3B,CAAC;AAEW,QAAA,eAAe,GAAG,CAAC,uBAAuB,CAAC,CAAC;AAC5C,QAAA,kBAAkB,GAAG;IAChC,wBAAwB;IACxB,wBAAwB;IACxB,qBAAqB;IACrB,uBAAuB;IACvB,mBAAmB;IACnB,sBAAsB;CACvB,CAAC;AAEF,SAAgB,iBAAiB,CAA6B,KAAU;IACtE,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,IAAI,CAAC,8BAAsB,EAAE,CAAC;QAC5B,2BAAmB,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,CAAC,0BAAkB,EAAE,CAAC;QACxB,uBAAe,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,CAAC,6BAAqB,EAAE,CAAC;QAC3B,0BAAkB,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IAC/B,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACxD,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/modules/mcp/constants.ts"],"names":[],"mappings":";;;AA0BA,8CAaC;AAvCY,QAAA,sBAAsB,GAAG,KAAK,CAAC;AAC/B,QAAA,kBAAkB,GAAG,KAAK,CAAC;AAC3B,QAAA,qBAAqB,GAAG,KAAK,CAAC;AAE9B,QAAA,mBAAmB,GAAG;IACjC,yBAAyB;IACzB,uBAAuB;IACvB,0BAA0B;IAC1B,0BAA0B;CAC3B,CAAC;AAGW,QAAA,eAAe,GAAG;IAC7B,mBAAmB;IACnB,4BAA4B;IAC5B,4BAA4B;CAC7B,CAAC;AACW,QAAA,kBAAkB,GAAG;IAChC,wBAAwB;IACxB,wBAAwB;IACxB,qBAAqB;IACrB,uBAAuB;IACvB,mBAAmB;IACnB,sBAAsB;CACvB,CAAC;AAEF,SAAgB,iBAAiB,CAA6B,KAAU;IACtE,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,IAAI,CAAC,8BAAsB,EAAE,CAAC;QAC5B,2BAAmB,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,CAAC,0BAAkB,EAAE,CAAC;QACxB,uBAAe,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,CAAC,6BAAqB,EAAE,CAAC;QAC3B,0BAAkB,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IAC/B,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACxD,CAAC"}

package/dist/server/modules/mcp/controllers/mcp-http.controller.js

@@ -147,16 +147,24 @@ let McpHttpController = class McpHttpController {
     }
     listTools() {
         const tools = [
+            {
+                name: 'devchain_list_sessions',
+                description: 'List active sessions for discovery. This is the bootstrap tool that requires no sessionId - use it to discover valid session IDs for other MCP calls.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {},
+                },
+            },
             {
                 name: 'devchain_list_documents',
-                description: 'List all documents for the current project. Automatically scopes to the project at the provided path.',
+                description: 'List all documents for the project resolved from the session.',
                 inputSchema: {
                     type: 'object',
-                    required: ['path'],
+                    required: ['sessionId'],
                     properties: {
-                        path: {
+                        sessionId: {
                             type: 'string',
-                            description: 'Absolute path to current working directory (e.g. /home/user/project)',
+                            description: 'Session ID (full UUID or 8+ char prefix)',
                         },
                         tags: {
                             type: 'array',
@@ -174,10 +182,12 @@ let McpHttpController = class McpHttpController {
                 description: 'Start an activity for an agent; posts a system start message and begins a running timer (DM by default).',
                 inputSchema: {
                     type: 'object',
-                    required: ['path', 'agentName', 'title'],
+                    required: ['sessionId', 'title'],
                     properties: {
-                        path: { type: 'string', description: 'Absolute project path' },
-                        agentName: { type: 'string', description: 'Agent name (case-insensitive)' },
+                        sessionId: {
+                            type: 'string',
+                            description: 'Session ID (full UUID or 8+ char prefix)',
+                        },
                         title: { type: 'string', description: 'Activity title (<=256 chars)' },
                         threadId: { type: 'string', description: 'Target thread UUID (optional)' },
                         announce: { type: 'boolean', description: 'Whether to post the start system message' },
@@ -189,10 +199,12 @@ let McpHttpController = class McpHttpController {
                 description: 'Finish the latest running activity for an agent; optionally posts a finish system message.',
                 inputSchema: {
                     type: 'object',
-                    required: ['path', 'agentName'],
+                    required: ['sessionId'],
                     properties: {
-                        path: { type: 'string', description: 'Absolute project path' },
-                        agentName: { type: 'string', description: 'Agent name (case-insensitive)' },
+                        sessionId: {
+                            type: 'string',
+                            description: 'Session ID (full UUID or 8+ char prefix)',
+                        },
                         threadId: { type: 'string', description: 'Target thread UUID (optional)' },
                         message: { type: 'string', description: 'Optional finish message (<=1000 chars)' },
                         status: {
@@ -230,14 +242,14 @@ let McpHttpController = class McpHttpController {
             },
             {
                 name: 'devchain_create_document',
-                description: 'Create a new markdown document in the project at the provided path',
+                description: 'Create a new markdown document in the project resolved from the session',
                 inputSchema: {
                     type: 'object',
-                    required: ['path', 'title', 'contentMd'],
+                    required: ['sessionId', 'title', 'contentMd'],
                     properties: {
-                        path: {
+                        sessionId: {
                             type: 'string',
-                            description: 'Absolute path to current working directory (e.g. /home/user/project)',
+                            description: 'Session ID (full UUID or 8+ char prefix)',
                         },
                         title: { type: 'string', description: 'Document title' },
                         contentMd: { type: 'string', description: 'Markdown content' },
@@ -264,16 +276,15 @@ let McpHttpController = class McpHttpController {
             },
             {
                 name: 'devchain_list_prompts',
-                description: 'List prompts for the project resolved from the provided path (projectId deprecated)',
+                description: 'List prompts for the project resolved from the session',
                 inputSchema: {
                     type: 'object',
-                    required: ['path'],
+                    required: ['sessionId'],
                     properties: {
-                        path: {
+                        sessionId: {
                             type: 'string',
-                            description: 'Absolute path to the project root (e.g. /home/user/project)',
+                            description: 'Session ID (full UUID or 8+ char prefix)',
                         },
-                        projectId: { type: 'string', description: '[deprecated] Filter by project ID' },
                         tags: { type: 'array', items: { type: 'string' }, description: 'Filter by tags' },
                         q: { type: 'string', description: 'Search query' },
                     },
@@ -281,34 +292,30 @@ let McpHttpController = class McpHttpController {
             },
             {
                 name: 'devchain_get_prompt',
-                description: 'Get a specific prompt by ID or by (name + path)',
+                description: 'Get a specific prompt by ID or by (name + sessionId)',
                 inputSchema: {
                     type: 'object',
                     properties: {
                         id: { type: 'string', description: 'Prompt UUID' },
                         name: { type: 'string', description: 'Prompt name/title' },
                         version: { type: 'number', description: 'Specific version number' },
-                        path: {
+                        sessionId: {
                             type: 'string',
-                            description: 'Absolute project path required when querying by name (e.g. /home/user/project)',
-                        },
-                        projectId: {
-                            type: 'string',
-                            description: '[deprecated] Project ID for scoped prompts',
+                            description: 'Session ID (full UUID or 8+ char prefix) required when querying by name',
                         },
                     },
                 },
             },
             {
                 name: 'devchain_list_agents',
-                description: 'List agents for the project resolved from the provided path',
+                description: 'List agents for the project resolved from the session',
                 inputSchema: {
                     type: 'object',
-                    required: ['path'],
+                    required: ['sessionId'],
                     properties: {
-                        path: {
+                        sessionId: {
                             type: 'string',
-                            description: 'Absolute path to the project root (e.g. /home/user/project)',
+                            description: 'Session ID (full UUID or 8+ char prefix)',
                         },
                         limit: { type: 'number', description: 'Max results (default: 100)' },
                         offset: { type: 'number', description: 'Pagination offset (default: 0)' },
@@ -321,14 +328,14 @@ let McpHttpController = class McpHttpController {
             },
             {
                 name: 'devchain_get_agent_by_name',
-                description: 'Fetch a single agent by name for the project resolved from the provided path',
+                description: 'Fetch a single agent by name for the project resolved from the session',
                 inputSchema: {
                     type: 'object',
-                    required: ['path', 'name'],
+                    required: ['sessionId', 'name'],
                     properties: {
-                        path: {
+                        sessionId: {
                             type: 'string',
-                            description: 'Absolute path to the project root (e.g. /home/user/project)',
+                            description: 'Session ID (full UUID or 8+ char prefix)',
                         },
                         name: {
                             type: 'string',
@@ -339,28 +346,28 @@ let McpHttpController = class McpHttpController {
             },
             {
                 name: 'devchain_list_statuses',
-                description: 'List project statuses resolved from the provided path',
+                description: 'List project statuses resolved from the session',
                 inputSchema: {
                     type: 'object',
-                    required: ['path'],
+                    required: ['sessionId'],
                     properties: {
-                        path: {
+                        sessionId: {
                             type: 'string',
-                            description: 'Absolute path to the project root (e.g. /home/user/project)',
+                            description: 'Session ID (full UUID or 8+ char prefix)',
                         },
                     },
                 },
             },
             {
                 name: 'devchain_list_epics',
-                description: 'List epics for the project resolved from the provided path with optional filters',
+                description: 'List epics for the project resolved from the session with optional filters',
                 inputSchema: {
                     type: 'object',
-                    required: ['path'],
+                    required: ['sessionId'],
                     properties: {
-                        path: {
+                        sessionId: {
                             type: 'string',
-                            description: 'Absolute path to the project root (e.g. /home/user/project)',
+                            description: 'Session ID (full UUID or 8+ char prefix)',
                         },
                         statusName: {
                             type: 'string',
@@ -377,14 +384,14 @@ let McpHttpController = class McpHttpController {
             },
             {
                 name: 'devchain_list_assigned_epics_tasks',
-                description: 'List epics assigned to the specified agent within the project resolved from the provided path',
+                description: 'List epics assigned to the specified agent within the project resolved from the session',
                 inputSchema: {
                     type: 'object',
-                    required: ['path', 'agentName'],
+                    required: ['sessionId', 'agentName'],
                     properties: {
-                        path: {
+                        sessionId: {
                             type: 'string',
-                            description: 'Absolute path to the project root (e.g. /home/user/project)',
+                            description: 'Session ID (full UUID or 8+ char prefix)',
                         },
                         agentName: { type: 'string', description: 'Agent name to match (case-insensitive)' },
                         limit: { type: 'number', description: 'Max results (default: 100)' },
@@ -394,14 +401,14 @@ let McpHttpController = class McpHttpController {
             },
             {
                 name: 'devchain_create_epic',
-                description: 'Create a new epic within the project resolved from the provided path',
+                description: 'Create a new epic within the project resolved from the session',
                 inputSchema: {
                     type: 'object',
-                    required: ['path', 'title'],
+                    required: ['sessionId', 'title'],
                     properties: {
-                        path: {
+                        sessionId: {
                             type: 'string',
-                            description: 'Absolute path to the project root (e.g. /home/user/project)',
+                            description: 'Session ID (full UUID or 8+ char prefix)',
                         },
                         title: { type: 'string', description: 'Epic title' },
                         description: { type: 'string', description: 'Optional epic description' },
@@ -430,11 +437,11 @@ let McpHttpController = class McpHttpController {
                 description: 'Fetch a single epic, including comments and related hierarchy details',
                 inputSchema: {
                     type: 'object',
-                    required: ['path', 'id'],
+                    required: ['sessionId', 'id'],
                     properties: {
-                        path: {
+                        sessionId: {
                             type: 'string',
-                            description: 'Absolute path to the project root (e.g. /home/user/project)',
+                            description: 'Session ID (full UUID or 8+ char prefix)',
                         },
                         id: { type: 'string', description: 'Epic UUID' },
                     },
@@ -442,17 +449,16 @@ let McpHttpController = class McpHttpController {
             },
             {
                 name: 'devchain_add_epic_comment',
-                description: 'Add a comment to the specified epic within the project resolved from the provided path',
+                description: 'Add a comment to the specified epic within the project resolved from the session. Author is derived from session agent.',
                 inputSchema: {
                     type: 'object',
-                    required: ['path', 'epicId', 'authorName', 'content'],
+                    required: ['sessionId', 'epicId', 'content'],
                     properties: {
-                        path: {
+                        sessionId: {
                             type: 'string',
-                            description: 'Absolute path to the project root (e.g. /home/user/project)',
+                            description: 'Session ID (full UUID or 8+ char prefix)',
                         },
                         epicId: { type: 'string', description: 'Epic UUID' },
-                        authorName: { type: 'string', description: 'Name of the comment author' },
                         content: { type: 'string', description: 'Comment body content' },
                     },
                 },
@@ -462,11 +468,11 @@ let McpHttpController = class McpHttpController {
                 description: 'Update an epic with flexible field updates including status (by name), assignment (by agent name or clear), parent hierarchy, and tags. Uses optimistic locking via version.',
                 inputSchema: {
                     type: 'object',
-                    required: ['path', 'id', 'version'],
+                    required: ['sessionId', 'id', 'version'],
                     properties: {
-                        path: {
+                        sessionId: {
                             type: 'string',
-                            description: 'Absolute path to the project root (e.g. /home/user/project)',
+                            description: 'Session ID (full UUID or 8+ char prefix)',
                         },
                         id: { type: 'string', description: 'Epic UUID' },
                         version: { type: 'number', description: 'Current version for optimistic locking' },
@@ -610,18 +616,18 @@ let McpHttpController = class McpHttpController {
             },
             {
                 name: 'devchain_send_message',
-                description: 'Send a chat message. Provide threadId to reply in a thread, or recipientAgentNames to create a new agent-initiated group when a senderName is provided.',
+                description: 'Send a chat message. Sender is derived from session agent. Provide threadId to reply in a thread, or recipientAgentNames to create a new agent-initiated group.',
                 inputSchema: {
                     type: 'object',
-                    required: ['path', 'message'],
+                    required: ['sessionId', 'message'],
                     properties: {
-                        path: {
+                        sessionId: {
                             type: 'string',
-                            description: 'Absolute path to the project root (e.g. /home/user/project)',
+                            description: 'Session ID (full UUID or 8+ char prefix)',
                         },
                         threadId: {
                             type: 'string',
-                            description: 'Existing thread UUID. When provided with senderName, recipients may be omitted to fan-out to thread members.',
+                            description: 'Existing thread UUID. When provided, recipients may be omitted to fan-out to thread members.',
                         },
                         recipientAgentNames: {
                             type: 'array',
@@ -631,17 +637,9 @@ let McpHttpController = class McpHttpController {
                         recipient: {
                             type: 'string',
                             enum: ['user', 'agents'],
-                            description: 'Set to "user" to DM the user without a threadId when providing agentName.',
+                            description: 'Set to "user" to DM the user without a threadId.',
                         },
                         message: { type: 'string', description: 'Message content to deliver.' },
-                        senderName: {
-                            type: 'string',
-                            description: "Agent's name authoring the message (case-insensitive). When provided, message is authored as that agent.",
-                        },
-                        agentName: {
-                            type: 'string',
-                            description: 'Alias for senderName used with { recipient: "user" } to identify the sending agent.',
-                        },
                     },
                 },
             },
@@ -650,11 +648,14 @@ let McpHttpController = class McpHttpController {
                 description: 'Mark a chat message as read for an agent and emit a message.read event.',
                 inputSchema: {
                     type: 'object',
-                    required: ['thread_id', 'message_id', 'agent_name'],
+                    required: ['sessionId', 'thread_id', 'message_id'],
                     properties: {
+                        sessionId: {
+                            type: 'string',
+                            description: 'Session ID (full UUID or 8+ char prefix)',
+                        },
                         thread_id: { type: 'string', description: 'Chat thread UUID.' },
                         message_id: { type: 'string', description: 'Chat message UUID to acknowledge.' },
-                        agent_name: { type: 'string', description: 'Agent name acknowledging the message.' },
                     },
                 },
             },