argusai-mcp 0.1.0

package/dist/tools/init.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @module tools/init
+ * argus_init — Initialize a project session by loading e2e.yaml.
+ */
+import { SessionManager } from '../session.js';
+export interface InitResult {
+    projectName: string;
+    configPath: string;
+    services: Array<{
+        name: string;
+        image: string;
+        ports: string[];
+        hasHealthcheck: boolean;
+    }>;
+    mocks: Array<{
+        name: string;
+        port: number;
+        routeCount: number;
+    }>;
+    suites: Array<{
+        id: string;
+        name: string;
+        runner: string;
+        file?: string;
+    }>;
+    schemaVersion: string;
+}
+/**
+ * Handle the argus_init MCP tool call.
+ * Loads the project e2e.yaml config and creates a new session.
+ *
+ * @param params - Tool input with projectPath and optional configFile override
+ * @param sessionManager - Session store for tracking project state
+ * @returns Structured init result with project info, services, mocks, and suites
+ * @throws {SessionError} SESSION_EXISTS if already initialized, CONFIG_NOT_FOUND/CONFIG_INVALID on bad config
+ */
+export declare function handleInit(params: {
+    projectPath: string;
+    configFile?: string;
+}, sessionManager: SessionManager): Promise<InitResult>;
+//# sourceMappingURL=init.d.ts.map

package/dist/tools/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/tools/init.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,cAAc,EAAgB,MAAM,eAAe,CAAC;AAE7D,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,cAAc,EAAE,OAAO,CAAC;KACzB,CAAC,CAAC;IACH,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IACH,MAAM,EAAE,KAAK,CAAC;QACZ,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;IACH,aAAa,EAAE,MAAM,CAAC;CACvB;AAyBD;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,EACpD,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,UAAU,CAAC,CAkErB"}

package/dist/tools/init.js

@@ -0,0 +1,96 @@
+/**
+ * @module tools/init
+ * argus_init — Initialize a project session by loading e2e.yaml.
+ */
+import path from 'node:path';
+import { loadConfig } from 'argusai-core';
+import { SessionError } from '../session.js';
+function extractServices(config) {
+    if (config.services && config.services.length > 0) {
+        return config.services.map((svc) => ({
+            name: svc.name,
+            image: svc.build.image,
+            ports: svc.container.ports,
+            hasHealthcheck: !!svc.container.healthcheck,
+        }));
+    }
+    if (config.service) {
+        const svc = config.service;
+        return [{
+                name: svc.container.name,
+                image: svc.build.image,
+                ports: svc.container.ports,
+                hasHealthcheck: !!svc.container.healthcheck,
+            }];
+    }
+    return [];
+}
+/**
+ * Handle the argus_init MCP tool call.
+ * Loads the project e2e.yaml config and creates a new session.
+ *
+ * @param params - Tool input with projectPath and optional configFile override
+ * @param sessionManager - Session store for tracking project state
+ * @returns Structured init result with project info, services, mocks, and suites
+ * @throws {SessionError} SESSION_EXISTS if already initialized, CONFIG_NOT_FOUND/CONFIG_INVALID on bad config
+ */
+export async function handleInit(params, sessionManager) {
+    const { projectPath, configFile } = params;
+    if (sessionManager.has(projectPath)) {
+        throw new SessionError('SESSION_EXISTS', `Session already initialized for project: ${projectPath}`);
+    }
+    const configFileName = configFile ?? 'e2e.yaml';
+    const configPath = path.resolve(projectPath, configFileName);
+    let config;
+    try {
+        config = await loadConfig(configPath);
+    }
+    catch (err) {
+        const message = err.message;
+        if (message.includes('not found')) {
+            throw new SessionError('CONFIG_NOT_FOUND', `Configuration file not found: ${configPath}`);
+        }
+        if (message.includes('validation failed')) {
+            throw new SessionError('CONFIG_INVALID', message);
+        }
+        throw err;
+    }
+    sessionManager.create(projectPath, config, configPath);
+    sessionManager.eventBus?.emit('activity', {
+        event: 'activity_start',
+        data: { id: `init-${Date.now()}`, source: 'ai', operation: 'init', project: config.project.name, status: 'success', startTime: Date.now(), endTime: Date.now() },
+    });
+    const services = extractServices(config);
+    const mocks = [];
+    if (config.mocks) {
+        for (const [name, mockConfig] of Object.entries(config.mocks)) {
+            const mc = mockConfig;
+            mocks.push({
+                name,
+                port: mc.port,
+                routeCount: mc.routes?.length ?? 0,
+            });
+        }
+    }
+    const suites = [];
+    if (config.tests?.suites) {
+        for (const suite of config.tests.suites) {
+            const s = suite;
+            suites.push({
+                id: s.id,
+                name: s.name,
+                runner: s.runner ?? 'yaml',
+                file: s.file,
+            });
+        }
+    }
+    return {
+        projectName: config.project.name,
+        configPath,
+        services,
+        mocks,
+        suites,
+        schemaVersion: config.version,
+    };
+}
+//# sourceMappingURL=init.js.map

package/dist/tools/init.js.map

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

package/dist/tools/logs.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @module tools/logs
+ * argus_logs — Get recent logs from a container.
+ */
+import { type ContainerStatus } from 'argusai-core';
+import { SessionManager } from '../session.js';
+export interface LogsResult {
+    container: string;
+    lines: string[];
+    lineCount: number;
+    containerStatus: ContainerStatus;
+}
+/**
+ * Handle the argus_logs MCP tool call.
+ * Retrieves recent log output from a specific container.
+ *
+ * @param params - Tool input with projectPath, container name, and optional line count / since filter
+ * @param sessionManager - Session store for tracking project state
+ * @returns Container logs split into lines with container status
+ * @throws {SessionError} CONTAINER_NOT_FOUND if container not in session, CONTAINER_NOT_RUNNING if stopped
+ */
+export declare function handleLogs(params: {
+    projectPath: string;
+    container: string;
+    lines?: number;
+    since?: string;
+}, sessionManager: SessionManager): Promise<LogsResult>;
+//# sourceMappingURL=logs.d.ts.map

package/dist/tools/logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../src/tools/logs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,cAAc,EAAgB,MAAM,eAAe,CAAC;AAE7D,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,eAAe,CAAC;CAClC;AAED;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAClF,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,UAAU,CAAC,CAuBrB"}

package/dist/tools/logs.js

@@ -0,0 +1,35 @@
+/**
+ * @module tools/logs
+ * argus_logs — Get recent logs from a container.
+ */
+import { getContainerLogs, getContainerStatus, } from 'argusai-core';
+import { SessionError } from '../session.js';
+/**
+ * Handle the argus_logs MCP tool call.
+ * Retrieves recent log output from a specific container.
+ *
+ * @param params - Tool input with projectPath, container name, and optional line count / since filter
+ * @param sessionManager - Session store for tracking project state
+ * @returns Container logs split into lines with container status
+ * @throws {SessionError} CONTAINER_NOT_FOUND if container not in session, CONTAINER_NOT_RUNNING if stopped
+ */
+export async function handleLogs(params, sessionManager) {
+    const session = sessionManager.getOrThrow(params.projectPath);
+    if (!session.containerIds.has(params.container)) {
+        throw new SessionError('CONTAINER_NOT_FOUND', `Container "${params.container}" not found in session`);
+    }
+    const containerStatus = await getContainerStatus(params.container);
+    if (containerStatus !== 'running' && containerStatus !== 'exited') {
+        throw new SessionError('CONTAINER_NOT_RUNNING', `Container "${params.container}" is not running (status: ${containerStatus})`);
+    }
+    const lineCount = params.lines ?? 100;
+    const rawLogs = await getContainerLogs(params.container, lineCount);
+    const lines = rawLogs.split('\n').filter(Boolean);
+    return {
+        container: params.container,
+        lines,
+        lineCount: lines.length,
+        containerStatus,
+    };
+}
+//# sourceMappingURL=logs.js.map

package/dist/tools/logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../../src/tools/logs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,gBAAgB,EAChB,kBAAkB,GAEnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAkB,YAAY,EAAE,MAAM,eAAe,CAAC;AAS7D;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAkF,EAClF,cAA8B;IAE9B,MAAM,OAAO,GAAG,cAAc,CAAC,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAE9D,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,YAAY,CAAC,qBAAqB,EAAE,cAAc,MAAM,CAAC,SAAS,wBAAwB,CAAC,CAAC;IACxG,CAAC;IAED,MAAM,eAAe,GAAG,MAAM,kBAAkB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAEnE,IAAI,eAAe,KAAK,SAAS,IAAI,eAAe,KAAK,QAAQ,EAAE,CAAC;QAClE,MAAM,IAAI,YAAY,CAAC,uBAAuB,EAAE,cAAc,MAAM,CAAC,SAAS,6BAA6B,eAAe,GAAG,CAAC,CAAC;IACjI,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,IAAI,GAAG,CAAC;IACtC,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACpE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAElD,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,KAAK;QACL,SAAS,EAAE,KAAK,CAAC,MAAM;QACvB,eAAe;KAChB,CAAC;AACJ,CAAC"}

package/dist/tools/mock-requests.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @module tools/mock-requests
+ * argus_mock_requests — Get recorded requests from mock services.
+ */
+import { SessionManager } from '../session.js';
+export interface MockRequestsResult {
+    mocks: Array<{
+        name: string;
+        port: number;
+        totalRequests: number;
+        requests: Array<{
+            method: string;
+            url: string;
+            body: unknown;
+            headers: Record<string, string | string[] | undefined>;
+            timestamp: string;
+        }>;
+    }>;
+}
+/**
+ * Handle the argus_mock_requests MCP tool call.
+ * Fetches recorded HTTP requests from mock service endpoints.
+ * Optionally filters by mock name, time range, and clears request logs.
+ *
+ * @param params - Tool input with projectPath, optional mockName filter, since timestamp, and clear flag
+ * @param sessionManager - Session store for tracking project state
+ * @returns Recorded requests per mock service
+ * @throws {SessionError} MOCKS_NOT_RUNNING if no mocks active, MOCK_NOT_FOUND if filter matches nothing
+ */
+export declare function handleMockRequests(params: {
+    projectPath: string;
+    mockName?: string;
+    since?: string;
+    clear?: boolean;
+}, sessionManager: SessionManager): Promise<MockRequestsResult>;
+//# sourceMappingURL=mock-requests.d.ts.map

package/dist/tools/mock-requests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-requests.d.ts","sourceRoot":"","sources":["../../src/tools/mock-requests.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAgB,MAAM,eAAe,CAAC;AAE7D,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,EAAE,MAAM,CAAC;QACtB,QAAQ,EAAE,KAAK,CAAC;YACd,MAAM,EAAE,MAAM,CAAC;YACf,GAAG,EAAE,MAAM,CAAC;YACZ,IAAI,EAAE,OAAO,CAAC;YACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;YACvD,SAAS,EAAE,MAAM,CAAC;SACnB,CAAC,CAAC;KACJ,CAAC,CAAC;CACJ;AAaD;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,EACnF,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,kBAAkB,CAAC,CAsD7B"}

package/dist/tools/mock-requests.js

@@ -0,0 +1,62 @@
+/**
+ * @module tools/mock-requests
+ * argus_mock_requests — Get recorded requests from mock services.
+ */
+import { SessionError } from '../session.js';
+/**
+ * Handle the argus_mock_requests MCP tool call.
+ * Fetches recorded HTTP requests from mock service endpoints.
+ * Optionally filters by mock name, time range, and clears request logs.
+ *
+ * @param params - Tool input with projectPath, optional mockName filter, since timestamp, and clear flag
+ * @param sessionManager - Session store for tracking project state
+ * @returns Recorded requests per mock service
+ * @throws {SessionError} MOCKS_NOT_RUNNING if no mocks active, MOCK_NOT_FOUND if filter matches nothing
+ */
+export async function handleMockRequests(params, sessionManager) {
+    const session = sessionManager.getOrThrow(params.projectPath);
+    if (session.mockServers.size === 0) {
+        throw new SessionError('MOCKS_NOT_RUNNING', 'No mock services are running');
+    }
+    if (params.mockName && !session.mockServers.has(params.mockName)) {
+        throw new SessionError('MOCK_NOT_FOUND', `Mock service "${params.mockName}" not found`);
+    }
+    const result = { mocks: [] };
+    const targets = params.mockName
+        ? [[params.mockName, session.mockServers.get(params.mockName)]]
+        : Array.from(session.mockServers.entries());
+    for (const [name, mockInfo] of targets) {
+        try {
+            const resp = await fetch(`http://localhost:${mockInfo.port}/_mock/requests`, {
+                signal: AbortSignal.timeout(5000),
+            });
+            if (!resp.ok) {
+                result.mocks.push({ name, port: mockInfo.port, totalRequests: 0, requests: [] });
+                continue;
+            }
+            const data = await resp.json();
+            let requests = data.requests;
+            if (params.since) {
+                const sinceTime = new Date(params.since).getTime();
+                requests = requests.filter(r => new Date(r.timestamp).getTime() >= sinceTime);
+            }
+            result.mocks.push({
+                name,
+                port: mockInfo.port,
+                totalRequests: requests.length,
+                requests,
+            });
+            if (params.clear) {
+                await fetch(`http://localhost:${mockInfo.port}/_mock/requests`, {
+                    method: 'DELETE',
+                    signal: AbortSignal.timeout(2000),
+                });
+            }
+        }
+        catch {
+            result.mocks.push({ name, port: mockInfo.port, totalRequests: 0, requests: [] });
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=mock-requests.js.map

package/dist/tools/mock-requests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-requests.js","sourceRoot":"","sources":["../../src/tools/mock-requests.ts"],"names":[],"mappings":"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"}

package/dist/tools/run.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @module tools/run
+ * argus_run + argus_run_suite — Execute test suites.
+ */
+import { type AIFriendlyTestResult } from 'argusai-core';
+import { SessionManager } from '../session.js';
+import type { ResultFormatter } from '../formatters/result-formatter.js';
+import type { PlatformServices } from '../server.js';
+export interface RunResult {
+    status: 'passed' | 'failed';
+    totals: {
+        passed: number;
+        failed: number;
+        skipped: number;
+        total: number;
+    };
+    duration: number;
+    suites: Array<{
+        id: string;
+        name: string;
+        status: 'passed' | 'failed';
+        duration: number;
+        passed: number;
+        failed: number;
+        skipped: number;
+        cases: AIFriendlyTestResult[];
+    }>;
+}
+/**
+ * Handle the argus_run MCP tool call.
+ * Executes all (or filtered) test suites and returns AI-friendly results.
+ *
+ * @param params - Tool input with projectPath, optional suite filter and parallel override
+ * @param sessionManager - Session store for tracking project state
+ * @param formatter - Converts raw TestEvents into AIFriendlyTestResult format
+ * @returns Structured run result with per-suite/per-case outcomes and diagnostics
+ * @throws {SessionError} NOT_RUNNING if setup not done, SUITE_NOT_FOUND if filter matches nothing
+ */
+export declare function handleRun(params: {
+    projectPath: string;
+    filter?: string;
+    parallel?: boolean;
+}, sessionManager: SessionManager, formatter: ResultFormatter, platform?: PlatformServices): Promise<RunResult>;
+/**
+ * Handle the argus_run_suite MCP tool call.
+ * Executes a single test suite by ID and returns AI-friendly results.
+ *
+ * @param params - Tool input with projectPath and suiteId
+ * @param sessionManager - Session store for tracking project state
+ * @param formatter - Converts raw TestEvents into AIFriendlyTestResult format
+ * @returns Structured run result for the single suite
+ * @throws {SessionError} NOT_RUNNING if setup not done, SUITE_NOT_FOUND if suiteId not found
+ */
+export declare function handleRunSuite(params: {
+    projectPath: string;
+    suiteId: string;
+}, sessionManager: SessionManager, formatter: ResultFormatter, platform?: PlatformServices): Promise<RunResult>;
+//# sourceMappingURL=run.d.ts.map

package/dist/tools/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/tools/run.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAML,KAAK,oBAAoB,EAC1B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,cAAc,EAAgB,MAAM,eAAe,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3E,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,KAAK,CAAC;QACZ,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;QAC5B,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,oBAAoB,EAAE,CAAC;KAC/B,CAAC,CAAC;CACJ;AAED;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,EACpE,cAAc,EAAE,cAAc,EAC9B,SAAS,EAAE,eAAe,EAC1B,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,OAAO,CAAC,SAAS,CAAC,CA4BpB;AAED;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAChD,cAAc,EAAE,cAAc,EAC9B,SAAS,EAAE,eAAe,EAC1B,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,OAAO,CAAC,SAAS,CAAC,CAiBpB"}

package/dist/tools/run.js

@@ -0,0 +1,190 @@
+/**
+ * @module tools/run
+ * argus_run + argus_run_suite — Execute test suites.
+ */
+import path from 'node:path';
+import { loadYAMLTests, executeYAMLSuite, createDefaultRegistry, } from 'argusai-core';
+import { SessionError } from '../session.js';
+/**
+ * Handle the argus_run MCP tool call.
+ * Executes all (or filtered) test suites and returns AI-friendly results.
+ *
+ * @param params - Tool input with projectPath, optional suite filter and parallel override
+ * @param sessionManager - Session store for tracking project state
+ * @param formatter - Converts raw TestEvents into AIFriendlyTestResult format
+ * @returns Structured run result with per-suite/per-case outcomes and diagnostics
+ * @throws {SessionError} NOT_RUNNING if setup not done, SUITE_NOT_FOUND if filter matches nothing
+ */
+export async function handleRun(params, sessionManager, formatter, platform) {
+    const session = sessionManager.getOrThrow(params.projectPath);
+    if (session.state !== 'running') {
+        throw new SessionError('NOT_RUNNING', 'Environment not set up. Call argus_setup first.');
+    }
+    const config = session.config;
+    if (!config.tests?.suites || config.tests.suites.length === 0) {
+        return {
+            status: 'passed',
+            totals: { passed: 0, failed: 0, skipped: 0, total: 0 },
+            duration: 0,
+            suites: [],
+        };
+    }
+    let suites = config.tests.suites;
+    if (params.filter) {
+        const filterIds = params.filter.split(',').map(s => s.trim());
+        suites = suites.filter((s) => filterIds.includes(s.id));
+        if (suites.length === 0) {
+            throw new SessionError('SUITE_NOT_FOUND', `No suites found matching filter: ${params.filter}`);
+        }
+    }
+    return executeSuites(suites, session, formatter, sessionManager.eventBus, platform);
+}
+/**
+ * Handle the argus_run_suite MCP tool call.
+ * Executes a single test suite by ID and returns AI-friendly results.
+ *
+ * @param params - Tool input with projectPath and suiteId
+ * @param sessionManager - Session store for tracking project state
+ * @param formatter - Converts raw TestEvents into AIFriendlyTestResult format
+ * @returns Structured run result for the single suite
+ * @throws {SessionError} NOT_RUNNING if setup not done, SUITE_NOT_FOUND if suiteId not found
+ */
+export async function handleRunSuite(params, sessionManager, formatter, platform) {
+    const session = sessionManager.getOrThrow(params.projectPath);
+    if (session.state !== 'running') {
+        throw new SessionError('NOT_RUNNING', 'Environment not set up. Call argus_setup first.');
+    }
+    const config = session.config;
+    const suites = (config.tests?.suites ?? []).filter((s) => s.id === params.suiteId);
+    if (suites.length === 0) {
+        throw new SessionError('SUITE_NOT_FOUND', `Suite "${params.suiteId}" not found in configuration`);
+    }
+    return executeSuites(suites, session, formatter, sessionManager.eventBus, platform);
+}
+async function executeSuites(suites, session, formatter, bus, platform) {
+    const totalStart = Date.now();
+    const suiteResults = [];
+    let totalPassed = 0;
+    let totalFailed = 0;
+    let totalSkipped = 0;
+    bus?.emit('activity', {
+        event: 'activity_start',
+        data: { id: `run-${totalStart}`, source: 'ai', operation: 'run', project: session.config.project.name, status: 'running', startTime: totalStart },
+    });
+    const containerName = getContainerName(session.config);
+    const baseUrl = getBaseUrl(session.config);
+    for (const suiteConfig of suites) {
+        const events = [];
+        const suiteStart = Date.now();
+        if (suiteConfig.runner === 'yaml' || !suiteConfig.runner) {
+            if (suiteConfig.file) {
+                const filePath = path.resolve(session.projectPath, suiteConfig.file);
+                const yamlSuite = await loadYAMLTests(filePath);
+                for await (const event of executeYAMLSuite(yamlSuite, {
+                    baseUrl,
+                    variables: { config: {}, runtime: {}, env: { ...process.env } },
+                    containerName,
+                })) {
+                    events.push(event);
+                    bus?.emit('test', { event: event.type, data: event });
+                }
+            }
+        }
+        else {
+            const registry = await createDefaultRegistry();
+            const runner = registry.get(suiteConfig.runner);
+            if (runner) {
+                const cwd = session.projectPath;
+                const target = suiteConfig.file ?? suiteConfig.command ?? '';
+                for await (const event of runner.run({
+                    cwd,
+                    target,
+                    env: process.env,
+                    timeout: 300_000,
+                })) {
+                    events.push(event);
+                    bus?.emit('test', { event: event.type, data: event });
+                }
+            }
+        }
+        const cases = formatter.formatEvents(events, suiteConfig.name);
+        let suitePassed = 0;
+        let suiteFailed = 0;
+        let suiteSkipped = 0;
+        for (const c of cases) {
+            if (c.status === 'passed')
+                suitePassed++;
+            else if (c.status === 'failed')
+                suiteFailed++;
+            else
+                suiteSkipped++;
+        }
+        totalPassed += suitePassed;
+        totalFailed += suiteFailed;
+        totalSkipped += suiteSkipped;
+        suiteResults.push({
+            id: suiteConfig.id,
+            name: suiteConfig.name,
+            status: suiteFailed > 0 ? 'failed' : 'passed',
+            duration: Date.now() - suiteStart,
+            passed: suitePassed,
+            failed: suiteFailed,
+            skipped: suiteSkipped,
+            cases,
+        });
+    }
+    const total = totalPassed + totalFailed + totalSkipped;
+    const totalDuration = Date.now() - totalStart;
+    bus?.emit('activity', {
+        event: 'activity_update',
+        data: { id: `run-${totalStart}`, source: 'ai', operation: 'run', project: session.config.project.name, status: totalFailed > 0 ? 'failed' : 'success', startTime: totalStart, endTime: Date.now() },
+    });
+    const runResult = {
+        status: totalFailed > 0 ? 'failed' : 'passed',
+        totals: { passed: totalPassed, failed: totalFailed, skipped: totalSkipped, total },
+        duration: totalDuration,
+        suites: suiteResults,
+    };
+    // Persist test records
+    if (platform?.store) {
+        for (const sr of suiteResults) {
+            platform.store.saveTestRecord({
+                id: `test-${totalStart}-${sr.id}`,
+                project: session.projectPath,
+                suite: sr.name,
+                status: sr.failed > 0 ? 'failed' : sr.skipped === (sr.passed + sr.failed + sr.skipped) ? 'skipped' : 'passed',
+                passed: sr.passed,
+                failed: sr.failed,
+                skipped: sr.skipped,
+                duration: sr.duration,
+                timestamp: totalStart,
+                source: 'ai',
+                error: sr.cases.find(c => c.status === 'failed')?.failure?.error,
+            }).catch(() => { });
+        }
+    }
+    // Notify on failure
+    if (totalFailed > 0 && platform?.notifier) {
+        const failedSuites = suiteResults.filter(s => s.status === 'failed').map(s => s.name);
+        platform.notifier.notifyTestFailure(session.projectPath, failedSuites.join(', '), `${totalFailed} test(s) failed in: ${failedSuites.join(', ')}`).catch(() => { });
+    }
+    return runResult;
+}
+function getContainerName(config) {
+    if (config.services && config.services.length > 0) {
+        return config.services[0].container.name;
+    }
+    return config.service?.container.name;
+}
+function getBaseUrl(config) {
+    const svc = config.services?.[0] ?? config.service;
+    if (!svc)
+        return 'http://localhost:3000';
+    const ports = svc.container.ports;
+    if (ports.length > 0) {
+        const hostPort = ports[0].split(':')[0];
+        return `http://localhost:${hostPort}`;
+    }
+    return 'http://localhost:3000';
+}
+//# sourceMappingURL=run.js.map

package/dist/tools/run.js.map

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

package/dist/tools/setup.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @module tools/setup
+ * argus_setup — Start the test environment.
+ *
+ * Uses MultiServiceOrchestrator for config normalization and dependency
+ * ordering, while keeping Docker calls at this level for testability.
+ */
+import { SessionManager } from '../session.js';
+export interface SetupResult {
+    network: {
+        name: string;
+        created: boolean;
+    };
+    services: Array<{
+        name: string;
+        containerId: string;
+        status: 'running' | 'healthy' | 'unhealthy' | 'failed';
+        ports: Array<{
+            host: number;
+            container: number;
+        }>;
+        healthCheckDuration?: number;
+        error?: string;
+    }>;
+    mocks: Array<{
+        name: string;
+        port: number;
+        status: 'running' | 'failed';
+        routeCount: number;
+    }>;
+    totalDuration: number;
+}
+/**
+ * Handle the argus_setup MCP tool call.
+ * Creates Docker network, starts mock services and service containers,
+ * and waits for health checks in dependency order.
+ *
+ * @param params - Tool input with projectPath and optional health-check timeout override
+ * @param sessionManager - Session store for tracking project state
+ * @returns Setup results including network, service, and mock status
+ * @throws {SessionError} SESSION_NOT_FOUND if not initialized, PORT_CONFLICT on occupied ports
+ */
+export declare function handleSetup(params: {
+    projectPath: string;
+    timeout?: string;
+}, sessionManager: SessionManager): Promise<SetupResult>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/tools/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/tools/setup.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAcH,OAAO,EAAE,cAAc,EAAgB,MAAM,eAAe,CAAC;AAE7D,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAC5C,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;QACvD,KAAK,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAClD,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IACH,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;QAC7B,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IACH,aAAa,EAAE,MAAM,CAAC;CACvB;AAuBD;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EACjD,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,WAAW,CAAC,CAuItB"}