@anastops/mcp-server 0.1.0 → 1.0.0

package/dist/handlers/handlers.agent.js

@@ -0,0 +1,99 @@
+/**
+ * MCP Tool Handlers - Agent Management
+ * Handles: agent_create, agent_deploy, agent_status, agent_list, agent_retire
+ */
+import { nanoid } from 'nanoid';
+import { getPersistence } from '../persistence.js';
+import { safePersist, agents, getAgent } from './handlers.base.js';
+export function handleAgentCreate(args) {
+    const agentId = nanoid(21);
+    const now = new Date();
+    const agent = {
+        id: agentId,
+        session_id: args['session_id'],
+        role: args['role'] ?? 'implementer',
+        name: args['name'] ?? `agent-${agentId.slice(0, 4)}`,
+        status: 'idle',
+        provider: args['provider'] ?? 'claude',
+        model: args['model'] ?? 'claude-sonnet',
+        current_task_id: null,
+        tasks_completed: 0,
+        tasks_failed: 0,
+        tokens_used: 0,
+        created_at: now,
+        last_activity_at: now,
+        config: {},
+    };
+    agents.set(agentId, agent);
+    // Persist to MongoDB
+    safePersist(getPersistence().saveAgent(agent));
+    return Promise.resolve({
+        agent_id: agent.id,
+        name: agent.name,
+        role: agent.role,
+        status: agent.status,
+    });
+}
+export async function handleAgentDeploy(args) {
+    const agent = await getAgent(args['agent_id']);
+    if (agent === null)
+        throw new Error('Agent not found');
+    agent.current_task_id = args['task_id'];
+    agent.status = 'working';
+    agent.last_activity_at = new Date();
+    agents.set(agent.id, agent);
+    safePersist(getPersistence().saveAgent(agent));
+    return { agent_id: agent.id, task_id: agent.current_task_id, status: agent.status };
+}
+export async function handleAgentStatus(args) {
+    const agent = await getAgent(args['agent_id']);
+    if (agent === null)
+        throw new Error('Agent not found');
+    return agent;
+}
+export async function handleAgentList(args) {
+    // Get from in-memory cache first
+    const inMemoryAgents = [];
+    for (const [, agent] of agents.entries()) {
+        if (args['session_id'] === undefined || agent.session_id === args['session_id']) {
+            inMemoryAgents.push(agent);
+        }
+    }
+    // Also get from MongoDB for persistence
+    const persistedAgents = await getPersistence().listAgents({
+        ...(args['session_id'] !== undefined && { session_id: args['session_id'] }),
+    });
+    // Merge: in-memory takes precedence
+    const inMemoryIds = new Set(inMemoryAgents.map((a) => a.id));
+    const sessionAgents = [
+        ...inMemoryAgents,
+        ...persistedAgents.filter((a) => !inMemoryIds.has(a.id)),
+    ];
+    return {
+        count: sessionAgents.length,
+        agents: sessionAgents.map((a) => ({ id: a.id, name: a.name, role: a.role, status: a.status })),
+    };
+}
+export async function handleAgentRetire(args) {
+    const agentId = args['agent_id'];
+    const agent = await getAgent(agentId);
+    if (agent === null) {
+        throw new Error(`Agent not found: ${agentId}`);
+    }
+    // Retire the agent
+    agent.status = 'completed';
+    agent.last_activity_at = new Date();
+    agent.current_task_id = null;
+    agents.set(agentId, agent);
+    // Persist to MongoDB
+    safePersist(getPersistence().saveAgent(agent));
+    return {
+        agent_id: agent.id,
+        name: agent.name,
+        role: agent.role,
+        status: agent.status,
+        tasks_completed: agent.tasks_completed,
+        retired: true,
+    };
+}
+//# sourceMappingURL=handlers.agent.js.map

package/dist/handlers/handlers.agent.js.map

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

package/dist/handlers/handlers.base.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Base utilities for MCP Tool Handlers
+ * Includes TOON encoding, response formatting, error handling, and cache management
+ */
+import type { Task, Agent, Artifact } from '@anastops/core';
+import { LRUCache } from 'lru-cache';
+/**
+ * Safe fire-and-forget wrapper for persistence operations
+ * Catches errors to prevent uncaught promise rejections from crashing the server
+ */
+export declare function safePersist<T>(operation: Promise<T>): void;
+/**
+ * TOON-encoded response wrapper type
+ */
+export interface TOONEncodedResponse {
+    data: unknown;
+    encoding?: 'toon' | 'json';
+    token_reduction?: {
+        original: number;
+        encoded: number;
+        savings_percent: number;
+    };
+}
+/**
+ * Apply TOON encoding to response if beneficial
+ * Returns original data if TOON doesn't provide savings
+ *
+ * TOON (Token-Optimized Object Notation) is most effective for:
+ * - Arrays of uniform objects (converted to tabular format)
+ * - Large structured responses (> 500 bytes)
+ */
+export declare function applyTOONEncodingToResponse(data: unknown): TOONEncodedResponse;
+/**
+ * Sanitize error message for external exposure
+ * SECURITY: Never expose internal details like stack traces, paths, or credentials
+ */
+export declare function sanitizeErrorMessage(error: unknown): string;
+export interface MemoryStoreValue {
+    value: Record<string, unknown>;
+    stored_at: Date;
+}
+export declare const agents: LRUCache<string, Agent, unknown>;
+export declare const tasks: LRUCache<string, Task, unknown>;
+export declare const artifacts: LRUCache<string, Artifact, unknown>;
+export declare const memoryStore: LRUCache<string, MemoryStoreValue, unknown>;
+/**
+ * Get task from memory or MongoDB
+ * Loads from MongoDB and caches in memory if not found
+ */
+export declare function getTask(taskId: string): Promise<Task | null>;
+/**
+ * Get agent from memory or MongoDB
+ */
+export declare function getAgent(agentId: string): Promise<Agent | null>;
+/**
+ * Get artifact from memory or MongoDB
+ */
+export declare function getArtifact(artifactId: string): Promise<Artifact | null>;
+/**
+ * Format a session report with all related data
+ */
+export declare function formatSessionReport(report: {
+    session: {
+        id: string;
+        objective: string;
+        status: string;
+        created_at: Date;
+        updated_at: Date;
+        metadata: {
+            total_tokens: number;
+            total_cost: number;
+            agents_used: string[];
+            files_affected: string[];
+            tasks_completed: number;
+            tasks_failed: number;
+        };
+    };
+    tasks: Task[];
+    agents: Agent[];
+    artifacts: Artifact[];
+}, includeOutput: boolean, includeArtifactContent: boolean): Record<string, unknown>;
+//# sourceMappingURL=handlers.base.d.ts.map

package/dist/handlers/handlers.base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.base.d.ts","sourceRoot":"","sources":["../../src/handlers/handlers.base.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAKrC;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAO1D;AAKD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAwDD;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,OAAO,GAAG,mBAAmB,CA8D9E;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAwB3D;AAGD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,SAAS,EAAE,IAAI,CAAC;CACjB;AAGD,eAAO,MAAM,MAAM,kCAAkE,CAAC;AACtF,eAAO,MAAM,KAAK,iCAAsE,CAAC;AACzF,eAAO,MAAM,SAAS,qCAA0E,CAAC;AACjG,eAAO,MAAM,WAAW,6CAGtB,CAAC;AAEH;;;GAGG;AACH,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAgBlE;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAarE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAa9E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE;IACN,OAAO,EAAE;QACP,EAAE,EAAE,MAAM,CAAC;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,IAAI,CAAC;QACjB,UAAU,EAAE,IAAI,CAAC;QACjB,QAAQ,EAAE;YACR,YAAY,EAAE,MAAM,CAAC;YACrB,UAAU,EAAE,MAAM,CAAC;YACnB,WAAW,EAAE,MAAM,EAAE,CAAC;YACtB,cAAc,EAAE,MAAM,EAAE,CAAC;YACzB,eAAe,EAAE,MAAM,CAAC;YACxB,YAAY,EAAE,MAAM,CAAC;SACtB,CAAC;KACH,CAAC;IACF,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB,EACD,aAAa,EAAE,OAAO,EACtB,sBAAsB,EAAE,OAAO,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA2HzB"}

package/dist/handlers/handlers.base.js

@@ -0,0 +1,337 @@
+/**
+ * Base utilities for MCP Tool Handlers
+ * Includes TOON encoding, response formatting, error handling, and cache management
+ */
+import { captureError } from '@anastops/core';
+import { LRUCache } from 'lru-cache';
+import { ZodError } from 'zod';
+import { getPersistence } from '../persistence.js';
+/**
+ * Safe fire-and-forget wrapper for persistence operations
+ * Catches errors to prevent uncaught promise rejections from crashing the server
+ */
+export function safePersist(operation) {
+    operation.catch((error) => {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error('[Persistence Error]', message);
+        // Capture persistence errors in Sentry
+        captureError(error, { type: 'persistence' });
+    });
+}
+// TOON encoding constants
+const TOON_MIN_SIZE_BYTES = 500;
+/**
+ * Estimate token count for text
+ * Rough approximation: ~4 characters per token for English
+ */
+function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+/**
+ * Convert array of uniform objects to TOON tabular format
+ * TOON format uses pipe-separated headers and values for compact representation
+ */
+function toTOONTabular(arr, keys) {
+    if (arr.length === 0 || keys.length === 0)
+        return '';
+    const lines = [];
+    // Header row
+    lines.push(keys.join(' | '));
+    // Data rows
+    for (const item of arr) {
+        const values = keys.map((k) => {
+            const val = item[k];
+            if (val === null || val === undefined)
+                return '';
+            if (typeof val === 'string')
+                return val.slice(0, 50);
+            if (val instanceof Date)
+                return val.toISOString();
+            return String(val);
+        });
+        lines.push(values.join(' | '));
+    }
+    return lines.join('\n');
+}
+/**
+ * Check if array contains uniform objects (all objects have same keys)
+ */
+function isUniformObjectArray(data) {
+    if (!Array.isArray(data) || data.length === 0)
+        return false;
+    if (typeof data[0] !== 'object' || data[0] === null)
+        return false;
+    const firstKeys = Object.keys(data[0])
+        .sort()
+        .join(',');
+    return data.every((item) => {
+        if (typeof item !== 'object' || item === null)
+            return false;
+        return (Object.keys(item)
+            .sort()
+            .join(',') === firstKeys);
+    });
+}
+/**
+ * Apply TOON encoding to response if beneficial
+ * Returns original data if TOON doesn't provide savings
+ *
+ * TOON (Token-Optimized Object Notation) is most effective for:
+ * - Arrays of uniform objects (converted to tabular format)
+ * - Large structured responses (> 500 bytes)
+ */
+export function applyTOONEncodingToResponse(data) {
+    // Only apply TOON to arrays or large objects
+    const jsonStr = JSON.stringify(data);
+    if (jsonStr.length < TOON_MIN_SIZE_BYTES) {
+        return { data }; // Too small, not worth encoding
+    }
+    const originalTokens = estimateTokens(jsonStr);
+    // Check if data structure is TOON-eligible
+    // TOON works best with arrays of uniform objects
+    if (typeof data !== 'object' || data === null) {
+        return { data };
+    }
+    const dataObj = data;
+    // Look for arrays within the response that could be TOON-encoded
+    let hasEncodableArrays = false;
+    const toonParts = [];
+    const scalarParts = [];
+    for (const [key, value] of Object.entries(dataObj)) {
+        if (isUniformObjectArray(value)) {
+            hasEncodableArrays = true;
+            const keys = Object.keys(value[0]);
+            toonParts.push(`${key}:\n${toTOONTabular(value, keys)}`);
+        }
+        else if (Array.isArray(value)) {
+            // Non-uniform array, keep as JSON
+            scalarParts.push(`${key}: ${JSON.stringify(value)}`);
+        }
+        else if (typeof value === 'object' && value !== null) {
+            // Nested object, keep as compact JSON
+            scalarParts.push(`${key}: ${JSON.stringify(value)}`);
+        }
+        else {
+            // Scalar value
+            scalarParts.push(`${key}: ${String(value)}`);
+        }
+    }
+    if (!hasEncodableArrays) {
+        return { data }; // No benefit from TOON encoding
+    }
+    // Build TOON-encoded representation
+    const toonEncoded = [...scalarParts, ...toonParts].join('\n');
+    const encodedTokens = estimateTokens(toonEncoded);
+    // Only use TOON if we get meaningful savings (> 20%)
+    const savingsPercent = ((originalTokens - encodedTokens) / originalTokens) * 100;
+    if (savingsPercent < 20) {
+        return { data }; // Not enough savings to justify encoding change
+    }
+    return {
+        data: toonEncoded,
+        encoding: 'toon',
+        token_reduction: {
+            original: originalTokens,
+            encoded: encodedTokens,
+            savings_percent: Math.round(savingsPercent * 100) / 100,
+        },
+    };
+}
+/**
+ * Sanitize error message for external exposure
+ * SECURITY: Never expose internal details like stack traces, paths, or credentials
+ */
+export function sanitizeErrorMessage(error) {
+    if (error instanceof ZodError) {
+        // Return validation errors with field details but no internal info
+        const issues = error.issues.map((issue) => ({
+            path: issue.path.join('.'),
+            message: issue.message,
+        }));
+        return `Validation error: ${JSON.stringify(issues)}`;
+    }
+    if (error instanceof Error) {
+        const message = error.message;
+        // Redact sensitive patterns
+        const sensitized = message
+            .replace(/mongodb:\/\/[^@]+@/gi, 'mongodb://***@') // MongoDB credentials
+            .replace(/redis:\/\/[^@]+@/gi, 'redis://***@') // Redis credentials
+            .replace(/password[=:]["']?[^"'\s]+["']?/gi, 'password=***') // Generic passwords
+            .replace(/\/Users\/[^/]+\//g, '/****/') // User paths
+            .replace(/\/home\/[^/]+\//g, '/****/') // User paths
+            .replace(/api[_-]?key[=:]["']?[^"'\s]+["']?/gi, 'api_key=***'); // API keys
+        return sensitized;
+    }
+    return 'An unexpected error occurred';
+}
+// LRU caches with size limits and TTL to prevent memory leaks
+export const agents = new LRUCache({ max: 1000, ttl: 1000 * 60 * 60 }); // 1 hour TTL
+export const tasks = new LRUCache({ max: 5000, ttl: 1000 * 60 * 60 * 24 }); // 24 hour TTL
+export const artifacts = new LRUCache({ max: 1000, ttl: 1000 * 60 * 60 * 24 }); // 24 hour TTL
+export const memoryStore = new LRUCache({
+    max: 10000,
+    ttl: 1000 * 60 * 60,
+}); // 1 hour TTL
+/**
+ * Get task from memory or MongoDB
+ * Loads from MongoDB and caches in memory if not found
+ */
+export async function getTask(taskId) {
+    // Check in-memory first
+    const memTask = tasks.get(taskId);
+    if (memTask !== undefined) {
+        return memTask;
+    }
+    // Try to load from MongoDB
+    const dbTask = await getPersistence().getTask(taskId);
+    if (dbTask !== null) {
+        // Cache in memory for subsequent access
+        tasks.set(taskId, dbTask);
+        return dbTask;
+    }
+    return null;
+}
+/**
+ * Get agent from memory or MongoDB
+ */
+export async function getAgent(agentId) {
+    const memAgent = agents.get(agentId);
+    if (memAgent !== undefined) {
+        return memAgent;
+    }
+    const dbAgent = await getPersistence().getAgent(agentId);
+    if (dbAgent !== null) {
+        agents.set(agentId, dbAgent);
+        return dbAgent;
+    }
+    return null;
+}
+/**
+ * Get artifact from memory or MongoDB
+ */
+export async function getArtifact(artifactId) {
+    const memArtifact = artifacts.get(artifactId);
+    if (memArtifact !== undefined) {
+        return memArtifact;
+    }
+    const dbArtifact = await getPersistence().getArtifact(artifactId);
+    if (dbArtifact !== null) {
+        artifacts.set(artifactId, dbArtifact);
+        return dbArtifact;
+    }
+    return null;
+}
+/**
+ * Format a session report with all related data
+ */
+export function formatSessionReport(report, includeOutput, includeArtifactContent) {
+    const { session, tasks: sessionTasks, agents: sessionAgents, artifacts: sessionArtifacts, } = report;
+    // Calculate statistics
+    const taskStats = {
+        total: sessionTasks.length,
+        pending: sessionTasks.filter((t) => t.status === 'pending').length,
+        queued: sessionTasks.filter((t) => t.status === 'queued').length,
+        running: sessionTasks.filter((t) => t.status === 'running').length,
+        completed: sessionTasks.filter((t) => t.status === 'completed').length,
+        failed: sessionTasks.filter((t) => t.status === 'failed').length,
+        cancelled: sessionTasks.filter((t) => t.status === 'cancelled').length,
+    };
+    const totalTokens = sessionTasks.reduce((sum, t) => sum + (t.token_usage?.total_tokens ?? 0), 0);
+    const totalCost = sessionTasks.reduce((sum, t) => sum + (t.token_usage?.cost ?? 0), 0);
+    // Format tasks with full details
+    const formattedTasks = sessionTasks.map((t) => {
+        const taskData = {
+            id: t.id,
+            type: t.type,
+            status: t.status,
+            description: t.description,
+            provider: t.provider,
+            model: t.model,
+            routing_tier: t.routing_tier,
+            complexity_score: t.complexity_score,
+            token_usage: t.token_usage,
+            created_at: t.created_at,
+            started_at: t.started_at,
+            completed_at: t.completed_at,
+            retry_count: t.retry_count,
+            input: {
+                prompt: t.input?.prompt?.slice(0, 500) ?? '',
+                context_files: t.input?.context_files ?? [],
+                agent: t.input?.agent,
+                skills: t.input?.skills,
+            },
+        };
+        if (t.error !== null && t.error !== undefined && t.error !== '') {
+            taskData.error = t.error;
+        }
+        if (includeOutput && t.output) {
+            taskData.output = {
+                content: t.output.content,
+                artifacts: t.output.artifacts,
+                files_modified: t.output.files_modified,
+            };
+        }
+        else if (t.output) {
+            taskData.output = {
+                content_length: t.output.content?.length ?? 0,
+                artifacts_count: t.output.artifacts?.length ?? 0,
+                files_modified: t.output.files_modified,
+            };
+        }
+        return taskData;
+    });
+    // Format agents
+    const formattedAgents = sessionAgents.map((a) => ({
+        id: a.id,
+        name: a.name,
+        role: a.role,
+        status: a.status,
+        provider: a.provider,
+        model: a.model,
+        tasks_completed: a.tasks_completed,
+        tasks_failed: a.tasks_failed,
+        tokens_used: a.tokens_used,
+        current_task_id: a.current_task_id,
+        created_at: a.created_at,
+        last_activity_at: a.last_activity_at,
+    }));
+    // Format artifacts
+    const formattedArtifacts = sessionArtifacts.map((a) => {
+        const artifactData = {
+            id: a.id,
+            name: a.name,
+            type: a.type,
+            size_bytes: a.size_bytes,
+            token_count: a.token_count,
+            created_at: a.created_at,
+        };
+        if (includeArtifactContent) {
+            artifactData.content = a.content;
+        }
+        else {
+            artifactData.summary = a.summary;
+        }
+        return artifactData;
+    });
+    return {
+        session: {
+            id: session.id,
+            objective: session.objective,
+            status: session.status,
+            created_at: session.created_at,
+            updated_at: session.updated_at,
+            metadata: session.metadata,
+        },
+        statistics: {
+            tasks: taskStats,
+            total_tokens: totalTokens,
+            total_cost_usd: totalCost,
+            agents_count: sessionAgents.length,
+            artifacts_count: sessionArtifacts.length,
+        },
+        tasks: formattedTasks,
+        agents: formattedAgents,
+        artifacts: formattedArtifacts,
+    };
+}
+//# sourceMappingURL=handlers.base.js.map

package/dist/handlers/handlers.base.js.map

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

package/dist/handlers/handlers.lock.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MCP Tool Handlers - Lock Management
+ * Handles: lock_acquire, lock_release, lock_status
+ */
+export declare function handleLockAcquire(args: Record<string, unknown>): Promise<unknown>;
+export declare function handleLockRelease(args: Record<string, unknown>): Promise<unknown>;
+export declare function handleLockStatus(args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=handlers.lock.d.ts.map

package/dist/handlers/handlers.lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.lock.d.ts","sourceRoot":"","sources":["../../src/handlers/handlers.lock.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAmCjF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CA+BjF;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAkDhF"}

package/dist/handlers/handlers.lock.js

@@ -0,0 +1,111 @@
+/**
+ * MCP Tool Handlers - Lock Management
+ * Handles: lock_acquire, lock_release, lock_status
+ */
+import { memoryStore } from './handlers.base.js';
+export function handleLockAcquire(args) {
+    const sessionId = args['session_id'];
+    const filePath = args['file_path'];
+    const ttl = args['ttl'] ?? 300000;
+    // In-memory lock implementation (Redis-based implementation would be used in production)
+    const lockKey = `lock:${filePath}`;
+    const existingLock = memoryStore.get(lockKey);
+    if (existingLock !== undefined) {
+        const lockData = existingLock.value;
+        // Check if lock is expired
+        if (lockData.expires_at > Date.now() && lockData.session_id !== sessionId) {
+            return Promise.resolve({
+                session_id: sessionId,
+                file_path: filePath,
+                acquired: false,
+                owner: lockData.session_id,
+                ttl,
+            });
+        }
+    }
+    // Acquire lock
+    memoryStore.set(lockKey, {
+        value: { session_id: sessionId, expires_at: Date.now() + ttl },
+        stored_at: new Date(),
+    });
+    return Promise.resolve({
+        session_id: sessionId,
+        file_path: filePath,
+        acquired: true,
+        ttl,
+    });
+}
+export function handleLockRelease(args) {
+    const sessionId = args['session_id'];
+    const filePath = args['file_path'];
+    const lockKey = `lock:${filePath}`;
+    const existingLock = memoryStore.get(lockKey);
+    if (existingLock !== undefined) {
+        const lockData = existingLock.value;
+        if (lockData.session_id === sessionId) {
+            memoryStore.delete(lockKey);
+            return Promise.resolve({
+                session_id: sessionId,
+                file_path: filePath,
+                released: true,
+            });
+        }
+        return Promise.resolve({
+            session_id: sessionId,
+            file_path: filePath,
+            released: false,
+            error: 'Lock is held by another session',
+        });
+    }
+    return Promise.resolve({
+        session_id: sessionId,
+        file_path: filePath,
+        released: true,
+        message: 'Lock did not exist',
+    });
+}
+export function handleLockStatus(args) {
+    const sessionId = args['session_id'];
+    const filePath = args['file_path'];
+    if (filePath !== undefined) {
+        const lockKey = `lock:${filePath}`;
+        const existingLock = memoryStore.get(lockKey);
+        if (existingLock !== undefined) {
+            const lockData = existingLock.value;
+            const isExpired = lockData.expires_at <= Date.now();
+            return Promise.resolve({
+                file_path: filePath,
+                is_locked: !isExpired,
+                owner: isExpired ? null : lockData.session_id,
+                expires_at: lockData.expires_at,
+            });
+        }
+        return Promise.resolve({
+            file_path: filePath,
+            is_locked: false,
+            owner: null,
+        });
+    }
+    if (sessionId !== undefined) {
+        // List all locks held by this session
+        const sessionLocks = [];
+        for (const [key, data] of memoryStore.entries()) {
+            if (key.startsWith('lock:')) {
+                const lockData = data.value;
+                if (lockData.session_id === sessionId && lockData.expires_at > Date.now()) {
+                    sessionLocks.push({
+                        file_path: key.replace('lock:', ''),
+                        expires_at: lockData.expires_at,
+                    });
+                }
+            }
+        }
+        return Promise.resolve({
+            session_id: sessionId,
+            lock_count: sessionLocks.length,
+            locks: sessionLocks,
+        });
+    }
+    return Promise.resolve({ error: 'Must provide either session_id or file_path' });
+}
+//# sourceMappingURL=handlers.lock.js.map