argusai-mcp 0.1.0

package/dist/session.d.ts

@@ -0,0 +1,93 @@
+/**
+ * @module session
+ * Per-project session state management for the MCP server.
+ *
+ * Tracks loaded configuration, running containers, mock servers,
+ * and the overall lifecycle state for each project.
+ *
+ * Multi-tenant: session keys are `clientId:projectPath` so different
+ * clients can independently manage the same project. Includes TTL-based
+ * auto-cleanup and per-session mutex.
+ */
+import type { E2EConfig, SSEBus } from 'argusai-core';
+export type SessionState = 'initialized' | 'built' | 'running' | 'stopped';
+export interface ProjectSession {
+    projectPath: string;
+    config: E2EConfig;
+    configPath: string;
+    containerIds: Map<string, string>;
+    mockServers: Map<string, {
+        server: {
+            close(): Promise<void>;
+        };
+        port: number;
+    }>;
+    networkName: string;
+    createdAt: number;
+    lastAccessedAt: number;
+    state: SessionState;
+    /** Client identifier for multi-tenant isolation */
+    clientId: string;
+}
+export interface SessionManagerOptions {
+    eventBus?: SSEBus;
+    /** Session TTL in milliseconds (default: 2 hours) */
+    ttlMs?: number;
+    /** Enable automatic cleanup of expired sessions */
+    autoCleanup?: boolean;
+}
+export declare class SessionManager {
+    private sessions;
+    private mutex;
+    private ttlMs;
+    private cleanupTimer?;
+    eventBus?: SSEBus;
+    constructor(eventBusOrOptions?: SSEBus | SessionManagerOptions);
+    /** Build the composite session key. */
+    private key;
+    /** Default client ID for single-tenant (stdio) mode. */
+    static readonly DEFAULT_CLIENT = "default";
+    /**
+     * Check whether a session exists for the given project.
+     * Falls back to default client if clientId is not provided.
+     */
+    has(projectPath: string, clientId?: string): boolean;
+    /**
+     * Retrieve an existing session or throw SESSION_NOT_FOUND.
+     */
+    getOrThrow(projectPath: string, clientId?: string): ProjectSession;
+    /**
+     * Create a new session for a project.
+     */
+    create(projectPath: string, config: E2EConfig, configPath: string, clientId?: string): ProjectSession;
+    /**
+     * Remove a session and release any held lock.
+     */
+    remove(projectPath: string, clientId?: string): void;
+    /**
+     * Transition a session to a new state, validating the state machine.
+     */
+    transition(projectPath: string, newState: SessionState, clientId?: string): void;
+    acquireLock(projectPath: string, operation: string, clientId?: string): void;
+    releaseLock(projectPath: string, clientId?: string): void;
+    isLocked(projectPath: string, clientId?: string): boolean;
+    /** List all active sessions. */
+    listSessions(): ProjectSession[];
+    /** List sessions for a specific client. */
+    listClientSessions(clientId: string): ProjectSession[];
+    /** Get total number of active sessions. */
+    get size(): number;
+    /** Start the periodic cleanup timer. */
+    startCleanup(): void;
+    /** Stop the periodic cleanup timer. */
+    stopCleanup(): void;
+    /** Remove sessions that haven't been accessed within the TTL period. */
+    cleanupExpired(): string[];
+    /** Destroy the manager: cleanup all sessions and stop the timer. */
+    destroy(): void;
+}
+export declare class SessionError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

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

package/dist/session.js

@@ -0,0 +1,220 @@
+/**
+ * @module session
+ * Per-project session state management for the MCP server.
+ *
+ * Tracks loaded configuration, running containers, mock servers,
+ * and the overall lifecycle state for each project.
+ *
+ * Multi-tenant: session keys are `clientId:projectPath` so different
+ * clients can independently manage the same project. Includes TTL-based
+ * auto-cleanup and per-session mutex.
+ */
+const VALID_TRANSITIONS = {
+    initialized: ['built', 'stopped'],
+    built: ['running', 'stopped'],
+    running: ['stopped'],
+    stopped: ['initialized'],
+};
+/** Default session TTL: 2 hours of inactivity */
+const DEFAULT_TTL_MS = 2 * 60 * 60 * 1000;
+/** Cleanup check interval: every 5 minutes */
+const CLEANUP_INTERVAL_MS = 5 * 60 * 1000;
+// =====================================================================
+// SessionMutex — prevents concurrent operations on the same session
+// =====================================================================
+class SessionMutex {
+    locks = new Map();
+    acquire(key, operation) {
+        const existing = this.locks.get(key);
+        if (existing) {
+            throw new SessionError('INVALID_STATE', `Concurrent operation rejected: "${operation}" cannot run while "${existing.holder}" is in progress`);
+        }
+        this.locks.set(key, { holder: operation, acquired: Date.now() });
+    }
+    release(key) {
+        this.locks.delete(key);
+    }
+    isLocked(key) {
+        return this.locks.has(key);
+    }
+}
+export class SessionManager {
+    sessions = new Map();
+    mutex = new SessionMutex();
+    ttlMs;
+    cleanupTimer;
+    eventBus;
+    constructor(eventBusOrOptions) {
+        if (eventBusOrOptions && 'emit' in eventBusOrOptions) {
+            // Backward compat: called with just an EventBus
+            this.eventBus = eventBusOrOptions;
+            this.ttlMs = DEFAULT_TTL_MS;
+        }
+        else if (eventBusOrOptions) {
+            this.eventBus = eventBusOrOptions.eventBus;
+            this.ttlMs = eventBusOrOptions.ttlMs ?? DEFAULT_TTL_MS;
+            if (eventBusOrOptions.autoCleanup !== false) {
+                this.startCleanup();
+            }
+        }
+        else {
+            this.ttlMs = DEFAULT_TTL_MS;
+        }
+    }
+    /** Build the composite session key. */
+    key(clientId, projectPath) {
+        return `${clientId}:${projectPath}`;
+    }
+    /** Default client ID for single-tenant (stdio) mode. */
+    static DEFAULT_CLIENT = 'default';
+    /**
+     * Check whether a session exists for the given project.
+     * Falls back to default client if clientId is not provided.
+     */
+    has(projectPath, clientId = SessionManager.DEFAULT_CLIENT) {
+        return this.sessions.has(this.key(clientId, projectPath));
+    }
+    /**
+     * Retrieve an existing session or throw SESSION_NOT_FOUND.
+     */
+    getOrThrow(projectPath, clientId = SessionManager.DEFAULT_CLIENT) {
+        const k = this.key(clientId, projectPath);
+        const session = this.sessions.get(k);
+        if (!session) {
+            throw new SessionError('SESSION_NOT_FOUND', `No active session for project: ${projectPath} (client: ${clientId})`);
+        }
+        session.lastAccessedAt = Date.now();
+        return session;
+    }
+    /**
+     * Create a new session for a project.
+     */
+    create(projectPath, config, configPath, clientId = SessionManager.DEFAULT_CLIENT) {
+        const k = this.key(clientId, projectPath);
+        if (this.sessions.has(k)) {
+            throw new SessionError('SESSION_EXISTS', `Session already exists for project: ${projectPath} (client: ${clientId})`);
+        }
+        const networkName = config.network?.name ?? 'e2e-network';
+        const now = Date.now();
+        const session = {
+            projectPath,
+            config,
+            configPath,
+            containerIds: new Map(),
+            mockServers: new Map(),
+            networkName,
+            createdAt: now,
+            lastAccessedAt: now,
+            state: 'initialized',
+            clientId,
+        };
+        this.sessions.set(k, session);
+        return session;
+    }
+    /**
+     * Remove a session and release any held lock.
+     */
+    remove(projectPath, clientId = SessionManager.DEFAULT_CLIENT) {
+        const k = this.key(clientId, projectPath);
+        this.mutex.release(k);
+        this.sessions.delete(k);
+    }
+    /**
+     * Transition a session to a new state, validating the state machine.
+     */
+    transition(projectPath, newState, clientId = SessionManager.DEFAULT_CLIENT) {
+        const session = this.getOrThrow(projectPath, clientId);
+        const allowed = VALID_TRANSITIONS[session.state];
+        if (!allowed.includes(newState)) {
+            throw new SessionError('INVALID_STATE', `Cannot transition from "${session.state}" to "${newState}"`);
+        }
+        session.state = newState;
+    }
+    acquireLock(projectPath, operation, clientId = SessionManager.DEFAULT_CLIENT) {
+        this.mutex.acquire(this.key(clientId, projectPath), operation);
+    }
+    releaseLock(projectPath, clientId = SessionManager.DEFAULT_CLIENT) {
+        this.mutex.release(this.key(clientId, projectPath));
+    }
+    isLocked(projectPath, clientId = SessionManager.DEFAULT_CLIENT) {
+        return this.mutex.isLocked(this.key(clientId, projectPath));
+    }
+    // =====================================================================
+    // Multi-tenant helpers
+    // =====================================================================
+    /** List all active sessions. */
+    listSessions() {
+        return [...this.sessions.values()];
+    }
+    /** List sessions for a specific client. */
+    listClientSessions(clientId) {
+        return [...this.sessions.values()].filter(s => s.clientId === clientId);
+    }
+    /** Get total number of active sessions. */
+    get size() {
+        return this.sessions.size;
+    }
+    // =====================================================================
+    // TTL / Auto-cleanup
+    // =====================================================================
+    /** Start the periodic cleanup timer. */
+    startCleanup() {
+        if (this.cleanupTimer)
+            return;
+        this.cleanupTimer = setInterval(() => this.cleanupExpired(), CLEANUP_INTERVAL_MS);
+        if (this.cleanupTimer.unref)
+            this.cleanupTimer.unref();
+    }
+    /** Stop the periodic cleanup timer. */
+    stopCleanup() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = undefined;
+        }
+    }
+    /** Remove sessions that haven't been accessed within the TTL period. */
+    cleanupExpired() {
+        const now = Date.now();
+        const expired = [];
+        for (const [key, session] of this.sessions) {
+            if (now - session.lastAccessedAt > this.ttlMs) {
+                // Best-effort cleanup of mock servers
+                for (const [, mock] of session.mockServers) {
+                    mock.server.close().catch(() => { });
+                }
+                this.mutex.release(key);
+                this.sessions.delete(key);
+                expired.push(key);
+            }
+        }
+        if (expired.length > 0) {
+            this.eventBus?.emit('activity', {
+                event: 'sessions_cleaned',
+                data: { expired, remaining: this.sessions.size },
+            });
+        }
+        return expired;
+    }
+    /** Destroy the manager: cleanup all sessions and stop the timer. */
+    destroy() {
+        this.stopCleanup();
+        for (const [, session] of this.sessions) {
+            for (const [, mock] of session.mockServers) {
+                mock.server.close().catch(() => { });
+            }
+        }
+        this.sessions.clear();
+    }
+}
+// =====================================================================
+// Error Type
+// =====================================================================
+export class SessionError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'SessionError';
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/dist/tools/build.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @module tools/build
+ * argus_build — Build Docker images for project services.
+ */
+import { SessionManager } from '../session.js';
+import type { PlatformServices } from '../server.js';
+export interface BuildResult {
+    services: Array<{
+        name: string;
+        image: string;
+        status: 'success' | 'failed';
+        duration: number;
+        error?: string;
+    }>;
+    totalDuration: number;
+}
+/**
+ * Handle the argus_build MCP tool call.
+ * Builds Docker images for one or all services in the project.
+ *
+ * @param params - Tool input with projectPath, optional noCache and service filter
+ * @param sessionManager - Session store for tracking project state
+ * @returns Build results per service with status and timing
+ * @throws {SessionError} SESSION_NOT_FOUND if not initialized, SERVICE_NOT_FOUND if filter matches nothing
+ */
+export declare function handleBuild(params: {
+    projectPath: string;
+    noCache?: boolean;
+    service?: string;
+}, sessionManager: SessionManager, platform?: PlatformServices): Promise<BuildResult>;
+//# sourceMappingURL=build.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/tools/build.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,OAAO,EAAE,cAAc,EAAgB,MAAM,eAAe,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;QAC7B,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IACH,aAAa,EAAE,MAAM,CAAC;CACvB;AA6BD;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EACpE,cAAc,EAAE,cAAc,EAC9B,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,OAAO,CAAC,WAAW,CAAC,CAuFtB"}

package/dist/tools/build.js

@@ -0,0 +1,110 @@
+/**
+ * @module tools/build
+ * argus_build — Build Docker images for project services.
+ */
+import { buildImage, } from 'argusai-core';
+import { SessionError } from '../session.js';
+function getServicesToBuild(config, serviceFilter) {
+    const targets = [];
+    if (config.services && config.services.length > 0) {
+        for (const svc of config.services) {
+            if (serviceFilter && svc.name !== serviceFilter)
+                continue;
+            targets.push({ name: svc.name, build: svc.build });
+        }
+    }
+    else if (config.service) {
+        const svc = config.service;
+        if (!serviceFilter || svc.container.name === serviceFilter) {
+            targets.push({ name: svc.container.name, build: svc.build });
+        }
+    }
+    if (serviceFilter && targets.length === 0) {
+        throw new SessionError('SERVICE_NOT_FOUND', `Service "${serviceFilter}" not found in configuration`);
+    }
+    return targets;
+}
+/**
+ * Handle the argus_build MCP tool call.
+ * Builds Docker images for one or all services in the project.
+ *
+ * @param params - Tool input with projectPath, optional noCache and service filter
+ * @param sessionManager - Session store for tracking project state
+ * @returns Build results per service with status and timing
+ * @throws {SessionError} SESSION_NOT_FOUND if not initialized, SERVICE_NOT_FOUND if filter matches nothing
+ */
+export async function handleBuild(params, sessionManager, platform) {
+    const session = sessionManager.getOrThrow(params.projectPath);
+    const targets = getServicesToBuild(session.config, params.service);
+    const totalStart = Date.now();
+    const results = [];
+    const bus = sessionManager.eventBus;
+    bus?.emit('activity', {
+        event: 'activity_start',
+        data: { id: `build-${totalStart}`, source: 'ai', operation: 'build', project: session.config.project.name, status: 'running', startTime: totalStart },
+    });
+    for (const target of targets) {
+        const buildStart = Date.now();
+        let lineNumber = 0;
+        let buildError;
+        try {
+            const buildOpts = {
+                dockerfile: target.build.dockerfile,
+                context: target.build.context,
+                imageName: target.build.image,
+                buildArgs: target.build.args,
+                noCache: params.noCache,
+            };
+            for await (const event of buildImage(buildOpts)) {
+                bus?.emit('build', { event: event.type, data: event });
+                if (event.type === 'build_log') {
+                    lineNumber++;
+                }
+                if (event.type === 'build_end' && !event.success) {
+                    buildError = event.error;
+                }
+            }
+        }
+        catch (err) {
+            buildError = err.message;
+        }
+        results.push({
+            name: target.name,
+            image: target.build.image,
+            status: buildError ? 'failed' : 'success',
+            duration: Date.now() - buildStart,
+            error: buildError,
+        });
+    }
+    const anyFailed = results.some(r => r.status === 'failed');
+    if (!anyFailed) {
+        sessionManager.transition(params.projectPath, 'built');
+    }
+    const totalDuration = Date.now() - totalStart;
+    bus?.emit('activity', {
+        event: 'activity_update',
+        data: { id: `build-${totalStart}`, source: 'ai', operation: 'build', project: session.config.project.name, status: anyFailed ? 'failed' : 'success', startTime: totalStart, endTime: Date.now() },
+    });
+    // Persist build records
+    if (platform?.store) {
+        for (const r of results) {
+            platform.store.saveBuildRecord({
+                id: `build-${totalStart}-${r.name}`,
+                project: session.projectPath,
+                image: r.image,
+                status: r.status,
+                duration: r.duration,
+                timestamp: totalStart,
+                source: 'ai',
+                error: r.error,
+            }).catch(() => { });
+        }
+    }
+    // Notify on failure
+    if (anyFailed && platform?.notifier) {
+        const failedNames = results.filter(r => r.status === 'failed').map(r => r.name);
+        platform.notifier.notifyBuildFailure(session.projectPath, failedNames.join(', '), results.find(r => r.error)?.error ?? 'Build failed').catch(() => { });
+    }
+    return { services: results, totalDuration };
+}
+//# sourceMappingURL=build.js.map

package/dist/tools/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/tools/build.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,UAAU,GAKX,MAAM,cAAc,CAAC;AACtB,OAAO,EAAkB,YAAY,EAAE,MAAM,eAAe,CAAC;AAmB7D,SAAS,kBAAkB,CAAC,MAAiB,EAAE,aAAsB;IACnE,MAAM,OAAO,GAAyB,EAAE,CAAC;IAEzC,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YAClC,IAAI,aAAa,IAAI,GAAG,CAAC,IAAI,KAAK,aAAa;gBAAE,SAAS;YAC1D,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;SAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAkB,MAAM,CAAC,OAAO,CAAC;QAC1C,IAAI,CAAC,aAAa,IAAI,GAAG,CAAC,SAAS,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YAC3D,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,IAAI,aAAa,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,YAAY,CAAC,mBAAmB,EAAE,YAAY,aAAa,8BAA8B,CAAC,CAAC;IACvG,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAoE,EACpE,cAA8B,EAC9B,QAA2B;IAE3B,MAAM,OAAO,GAAG,cAAc,CAAC,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,kBAAkB,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAEnE,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC9B,MAAM,OAAO,GAA4B,EAAE,CAAC;IAC5C,MAAM,GAAG,GAAG,cAAc,CAAC,QAAQ,CAAC;IAEpC,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE;QACpB,KAAK,EAAE,gBAAgB;QACvB,IAAI,EAAE,EAAE,EAAE,EAAE,SAAS,UAAU,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE;KACtJ,CAAC,CAAC;IAEH,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC9B,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,UAA8B,CAAC;QAEnC,IAAI,CAAC;YACH,MAAM,SAAS,GAAG;gBAChB,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU;gBACnC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO;gBAC7B,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK;gBAC7B,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI;gBAC5B,OAAO,EAAE,MAAM,CAAC,OAAO;aACxB,CAAC;YAEF,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBAChD,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;gBACvD,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;oBAC/B,UAAU,EAAE,CAAC;gBACf,CAAC;gBACD,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;oBACjD,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC;gBAC3B,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,UAAU,GAAI,GAAa,CAAC,OAAO,CAAC;QACtC,CAAC;QAED,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK;YACzB,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;YACzC,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU;YACjC,KAAK,EAAE,UAAU;SAClB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;IAC3D,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,cAAc,CAAC,UAAU,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC;IAC9C,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE;QACpB,KAAK,EAAE,iBAAiB;QACxB,IAAI,EAAE,EAAE,EAAE,EAAE,SAAS,UAAU,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE;KAClM,CAAC,CAAC;IAEH,wBAAwB;IACxB,IAAI,QAAQ,EAAE,KAAK,EAAE,CAAC;QACpB,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC;gBAC7B,EAAE,EAAE,SAAS,UAAU,IAAI,CAAC,CAAC,IAAI,EAAE;gBACnC,OAAO,EAAE,OAAO,CAAC,WAAW;gBAC5B,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,SAAS,EAAE,UAAU;gBACrB,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,CAAC,CAAC,KAAK;aACf,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,oBAAoB;IACpB,IAAI,SAAS,IAAI,QAAQ,EAAE,QAAQ,EAAE,CAAC;QACpC,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAChF,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,CAClC,OAAO,CAAC,WAAW,EACnB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EACtB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,KAAK,IAAI,cAAc,CACpD,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;AAC9C,CAAC"}

package/dist/tools/clean.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @module tools/clean
+ * argus_clean — Stop and remove all containers, networks, and mocks.
+ *
+ * Uses MultiServiceOrchestrator for config normalization, while keeping
+ * Docker calls at this level for testability.
+ */
+import { SessionManager } from '../session.js';
+export interface CleanResult {
+    containers: Array<{
+        name: string;
+        action: 'removed' | 'not_found' | 'force_removed' | 'failed';
+        error?: string;
+    }>;
+    mocks: Array<{
+        name: string;
+        action: 'stopped' | 'not_running' | 'failed';
+        error?: string;
+    }>;
+    network: {
+        name: string;
+        action: 'removed' | 'not_found' | 'failed';
+        error?: string;
+    };
+    sessionRemoved: boolean;
+}
+/**
+ * Handle the argus_clean MCP tool call.
+ * Stops containers, shuts down mock servers, removes the Docker network,
+ * and destroys the session. Uses best-effort cleanup for all resources.
+ *
+ * @param params - Tool input with projectPath and optional force flag
+ * @param sessionManager - Session store for tracking project state
+ * @returns Cleanup results for containers, mocks, network, and session
+ */
+export declare function handleClean(params: {
+    projectPath: string;
+    force?: boolean;
+}, sessionManager: SessionManager): Promise<CleanResult>;
+//# sourceMappingURL=clean.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clean.d.ts","sourceRoot":"","sources":["../../src/tools/clean.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,EAAE,cAAc,EAAgB,MAAM,eAAe,CAAC;AAE7D,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,eAAe,GAAG,QAAQ,CAAC;QAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IACH,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,QAAQ,CAAC;QAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IACH,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;QAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,EAChD,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,WAAW,CAAC,CAiGtB"}

package/dist/tools/clean.js

@@ -0,0 +1,111 @@
+/**
+ * @module tools/clean
+ * argus_clean — Stop and remove all containers, networks, and mocks.
+ *
+ * Uses MultiServiceOrchestrator for config normalization, while keeping
+ * Docker calls at this level for testability.
+ */
+import { stopContainer, removeNetwork, MultiServiceOrchestrator, } from 'argusai-core';
+import { SessionError } from '../session.js';
+/**
+ * Handle the argus_clean MCP tool call.
+ * Stops containers, shuts down mock servers, removes the Docker network,
+ * and destroys the session. Uses best-effort cleanup for all resources.
+ *
+ * @param params - Tool input with projectPath and optional force flag
+ * @param sessionManager - Session store for tracking project state
+ * @returns Cleanup results for containers, mocks, network, and session
+ */
+export async function handleClean(params, sessionManager) {
+    let session;
+    let networkName = 'e2e-network';
+    try {
+        session = sessionManager.getOrThrow(params.projectPath);
+        networkName = session.networkName;
+    }
+    catch (err) {
+        if (err instanceof SessionError && err.code === 'SESSION_NOT_FOUND') {
+            return {
+                containers: [],
+                mocks: [],
+                network: { name: networkName, action: 'not_found' },
+                sessionRemoved: false,
+            };
+        }
+        throw err;
+    }
+    const bus = sessionManager.eventBus;
+    const cleanStart = Date.now();
+    bus?.emit('clean', { event: 'clean_start', data: { type: 'clean_start', project: session.config.project.name, timestamp: cleanStart } });
+    bus?.emit('activity', {
+        event: 'activity_start',
+        data: { id: `clean-${cleanStart}`, source: 'ai', operation: 'clean', project: session.config.project.name, status: 'running', startTime: cleanStart },
+    });
+    const orchestrator = new MultiServiceOrchestrator();
+    const services = orchestrator.normalizeServices(session.config);
+    // Collect all container names to clean — both from config and session tracking
+    const containerNames = new Set();
+    for (const svc of services) {
+        containerNames.add(svc.container.name);
+    }
+    for (const [name] of session.containerIds) {
+        containerNames.add(name);
+    }
+    // Stop containers (best-effort)
+    const containerResults = [];
+    for (const name of containerNames) {
+        try {
+            bus?.emit('clean', { event: 'container_removing', data: { type: 'container_removing', name, timestamp: Date.now() } });
+            await stopContainer(name);
+            bus?.emit('clean', { event: 'container_removed', data: { type: 'container_removed', name, timestamp: Date.now() } });
+            containerResults.push({ name, action: 'removed' });
+        }
+        catch (err) {
+            containerResults.push({
+                name,
+                action: 'failed',
+                error: err.message,
+            });
+        }
+    }
+    // Stop mock servers
+    const mockResults = [];
+    for (const [name, mockInfo] of session.mockServers) {
+        try {
+            await mockInfo.server.close();
+            bus?.emit('clean', { event: 'mock_stopped', data: { type: 'mock_stopped', name, timestamp: Date.now() } });
+            mockResults.push({ name, action: 'stopped' });
+        }
+        catch (err) {
+            mockResults.push({
+                name,
+                action: 'failed',
+                error: err.message,
+            });
+        }
+    }
+    // Remove network
+    let networkResult;
+    try {
+        await removeNetwork(networkName);
+        bus?.emit('clean', { event: 'network_removed', data: { type: 'network_removed', name: networkName, timestamp: Date.now() } });
+        networkResult = { name: networkName, action: 'removed' };
+    }
+    catch {
+        networkResult = { name: networkName, action: 'failed' };
+    }
+    const cleanDuration = Date.now() - cleanStart;
+    bus?.emit('clean', { event: 'clean_end', data: { type: 'clean_end', duration: cleanDuration, timestamp: Date.now() } });
+    bus?.emit('activity', {
+        event: 'activity_update',
+        data: { id: `clean-${cleanStart}`, source: 'ai', operation: 'clean', project: session.config.project.name, status: 'success', startTime: cleanStart, endTime: Date.now() },
+    });
+    sessionManager.remove(params.projectPath);
+    return {
+        containers: containerResults,
+        mocks: mockResults,
+        network: networkResult,
+        sessionRemoved: true,
+    };
+}
+//# sourceMappingURL=clean.js.map

package/dist/tools/clean.js.map

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