@sudosandwich/limps 0.2.0

package/dist/rlm/security.js

@@ -0,0 +1,154 @@
+/**
+ * Security validation for RLM sandbox execution.
+ * Feature #6: Security Sandbox
+ *
+ * Blocks dangerous APIs and validates code before execution.
+ * This is defense-in-depth; isolated-vm provides true isolation.
+ */
+/**
+ * APIs that are blocked from sandbox execution.
+ * These are validated via static analysis before code runs.
+ */
+export const BLOCKED_APIS = [
+    'require',
+    'import',
+    'eval',
+    'Function',
+    'process',
+    'global',
+    'globalThis',
+    'fetch',
+    'XMLHttpRequest',
+    'WebSocket',
+    'setTimeout',
+    'setInterval',
+    'setImmediate',
+    'Buffer',
+    'ArrayBuffer.transfer',
+    '__proto__',
+    'constructor.constructor',
+];
+/**
+ * Security error thrown when code contains prohibited operations.
+ */
+export class SecurityError extends Error {
+    violation;
+    constructor(violation, message) {
+        super(message);
+        this.name = 'SecurityError';
+        this.violation = violation;
+        // Ensure proper prototype chain for instanceof checks
+        Object.setPrototypeOf(this, SecurityError.prototype);
+        // Capture stack trace (V8 engines)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, SecurityError);
+        }
+    }
+}
+const VIOLATION_RULES = [
+    {
+        violation: 'require',
+        pattern: /\brequire\b/,
+        message: 'Prohibited module access',
+    },
+    {
+        violation: 'import',
+        pattern: /\bimport\b/,
+        message: 'Dynamic import not allowed',
+    },
+    {
+        violation: 'eval',
+        pattern: /\beval\b/,
+        message: 'Dynamic code execution',
+    },
+    {
+        violation: 'Function',
+        pattern: /\bFunction\b/,
+        message: 'Dynamic code execution',
+    },
+    {
+        violation: 'process',
+        pattern: /\bprocess\b/,
+        message: 'Process access not allowed',
+    },
+    {
+        violation: 'global',
+        pattern: /\bglobal\b(?!This)/,
+        message: 'Global access not allowed',
+    },
+    {
+        violation: 'globalThis',
+        pattern: /\bglobalThis\b/,
+        message: 'Global access not allowed',
+    },
+    {
+        violation: 'fetch',
+        pattern: /\bfetch\b/,
+        message: 'Network access not allowed',
+    },
+    {
+        violation: 'XMLHttpRequest',
+        pattern: /\bXMLHttpRequest\b/,
+        message: 'Network access not allowed',
+    },
+    {
+        violation: 'WebSocket',
+        pattern: /\bWebSocket\b/,
+        message: 'Network access not allowed',
+    },
+    {
+        violation: 'setTimeout',
+        pattern: /\bsetTimeout\b/,
+        message: 'Timer functions not allowed',
+    },
+    {
+        violation: 'setInterval',
+        pattern: /\bsetInterval\b/,
+        message: 'Timer functions not allowed',
+    },
+    {
+        violation: 'setImmediate',
+        pattern: /\bsetImmediate\b/,
+        message: 'Timer functions not allowed',
+    },
+    {
+        violation: 'Buffer',
+        pattern: /\bBuffer\b/,
+        message: 'Buffer access not allowed',
+    },
+    {
+        violation: 'ArrayBuffer.transfer',
+        pattern: /ArrayBuffer\s*\.\s*transfer/,
+        message: 'ArrayBuffer.transfer not allowed',
+    },
+    {
+        violation: '__proto__',
+        pattern: /__proto__/,
+        message: 'Prototype pollution',
+    },
+    {
+        violation: 'constructor.constructor',
+        pattern: /constructor\s*\.\s*constructor/,
+        message: 'Prototype pollution',
+    },
+];
+/**
+ * Pre-execution validation of code string.
+ * Scans for BLOCKED_APIS patterns and throws SecurityError if found.
+ *
+ * @param code - JavaScript code to validate
+ * @throws SecurityError if code contains blocked patterns
+ */
+export function validateCode(code) {
+    // Empty or whitespace-only code is allowed
+    if (!code.trim()) {
+        return;
+    }
+    // Check each violation rule
+    for (const rule of VIOLATION_RULES) {
+        if (rule.pattern.test(code)) {
+            throw new SecurityError(rule.violation, rule.message);
+        }
+    }
+}
+//# sourceMappingURL=security.js.map

package/dist/rlm/security.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,21 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ServerConfig } from './config.js';
+import type { Database as DatabaseType } from 'better-sqlite3';
+import type { CoordinationState } from './coordination.js';
+/**
+ * Create an MCP server instance with the given configuration.
+ *
+ * @param config - Server configuration
+ * @param db - Database instance for tools and resources
+ * @param coordination - Coordination state for multi-agent orchestration
+ * @returns MCP server instance
+ */
+export declare function createServer(config: ServerConfig, db: DatabaseType, coordination: CoordinationState): McpServer;
+/**
+ * Start the MCP server with stdio transport and handle graceful shutdown.
+ *
+ * @param server - MCP server instance to start
+ * @param onShutdown - Optional callback to run during graceful shutdown (e.g., stop watcher, close db)
+ */
+export declare function startServer(server: McpServer, onShutdown?: () => Promise<void>): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAK3D;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,YAAY,EACpB,EAAE,EAAE,YAAY,EAChB,YAAY,EAAE,iBAAiB,GAC9B,SAAS,CA8BX;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,SAAS,EACjB,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC,CAkEf"}

package/dist/server.js

@@ -0,0 +1,107 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { registerResources } from './resources/index.js';
+import { registerTools } from './tools/index.js';
+/**
+ * Create an MCP server instance with the given configuration.
+ *
+ * @param config - Server configuration
+ * @param db - Database instance for tools and resources
+ * @param coordination - Coordination state for multi-agent orchestration
+ * @returns MCP server instance
+ */
+export function createServer(config, db, coordination) {
+    const server = new McpServer({
+        name: 'mcp-planning-server',
+        version: '0.2.0',
+    });
+    // Tool context for handlers
+    const toolContext = {
+        db,
+        coordination,
+        config,
+    };
+    // Store on server instance for tool handlers to access
+    server.toolContext = toolContext;
+    // Resource context for handlers
+    const resourceContext = {
+        db,
+        coordination,
+        config,
+    };
+    // Register resources
+    registerResources(server, resourceContext);
+    // Register tools
+    registerTools(server, toolContext);
+    return server;
+}
+/**
+ * Start the MCP server with stdio transport and handle graceful shutdown.
+ *
+ * @param server - MCP server instance to start
+ * @param onShutdown - Optional callback to run during graceful shutdown (e.g., stop watcher, close db)
+ */
+export async function startServer(server, onShutdown) {
+    const transport = new StdioServerTransport();
+    // Set up signal handlers for graceful shutdown
+    // Only register exit handlers if not in test environment
+    const isTestEnvironment = process.env.NODE_ENV === 'test' || process.env.VITEST === 'true';
+    const shutdown = async (signal) => {
+        console.error(`Received ${signal}, shutting down gracefully...`);
+        try {
+            // Run custom shutdown callback first (stop watcher, close db)
+            if (onShutdown) {
+                await onShutdown();
+            }
+            await server.close();
+            if (!isTestEnvironment) {
+                process.exit(0);
+            }
+        }
+        catch (error) {
+            console.error(`Error during shutdown:`, error);
+            if (!isTestEnvironment) {
+                process.exit(1);
+            }
+            else {
+                throw error;
+            }
+        }
+    };
+    if (!isTestEnvironment) {
+        process.on('SIGINT', () => {
+            shutdown('SIGINT').catch((error) => {
+                console.error('Error in SIGINT handler:', error);
+                process.exit(1);
+            });
+        });
+        process.on('SIGTERM', () => {
+            shutdown('SIGTERM').catch((error) => {
+                console.error('Error in SIGTERM handler:', error);
+                process.exit(1);
+            });
+        });
+        // Handle uncaught errors
+        process.on('uncaughtException', (error) => {
+            console.error('Uncaught exception:', error);
+            shutdown('uncaughtException').catch(() => {
+                process.exit(1);
+            });
+        });
+        process.on('unhandledRejection', (reason, promise) => {
+            console.error('Unhandled rejection at:', promise, 'reason:', reason);
+            shutdown('unhandledRejection').catch(() => {
+                process.exit(1);
+            });
+        });
+    }
+    try {
+        await server.connect(transport);
+        console.error('MCP Planning Server running on stdio');
+    }
+    catch (error) {
+        console.error('Failed to start server:', error);
+        throw error;
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/task-parser.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Shared task parsing utilities for MCP planning tools.
+ *
+ * This module provides common functions for parsing tasks from planning documents,
+ * used by get-next-task, claim-task, and update-task-status tools.
+ */
+/**
+ * Parsed task interface representing a task extracted from a planning document.
+ */
+export interface ParsedTask {
+    id: string;
+    planId: string;
+    featureNumber: number;
+    title: string;
+    status: 'GAP' | 'WIP' | 'PASS' | 'BLOCKED';
+    dependencies: string[];
+    files: string[];
+    documentPath: string;
+    agentPersona?: 'coder' | 'reviewer' | 'pm' | 'customer';
+}
+/**
+ * Extract plan ID from document path.
+ * Example: "/path/to/plans/0008-plan-name/plan.md" -> "0008-plan-name"
+ *
+ * @param path - Document path
+ * @returns Plan ID or null if not found
+ */
+export declare function extractPlanId(path: string): string | null;
+/**
+ * Parse tasks from a planning document.
+ * Extracts features marked with ### #<number>: pattern.
+ *
+ * @param path - Document path
+ * @param content - Document content
+ * @param planId - Plan ID for task ID generation
+ * @returns Array of parsed tasks
+ */
+export declare function parseTasksFromDocument(path: string, content: string, planId: string): ParsedTask[];
+/**
+ * Find a specific task in parsed tasks by ID.
+ *
+ * @param tasks - Array of parsed tasks
+ * @param taskId - Task ID to find
+ * @returns Parsed task or undefined if not found
+ */
+export declare function findTaskById(tasks: ParsedTask[], taskId: string): ParsedTask | undefined;
+//# sourceMappingURL=task-parser.d.ts.map

package/dist/task-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-parser.d.ts","sourceRoot":"","sources":["../src/task-parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;IAC3C,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI,GAAG,UAAU,CAAC;CACzD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,UAAU,EAAE,CAgFd;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAExF"}

package/dist/task-parser.js

@@ -0,0 +1,112 @@
+/**
+ * Shared task parsing utilities for MCP planning tools.
+ *
+ * This module provides common functions for parsing tasks from planning documents,
+ * used by get-next-task, claim-task, and update-task-status tools.
+ */
+/**
+ * Extract plan ID from document path.
+ * Example: "/path/to/plans/0008-plan-name/plan.md" -> "0008-plan-name"
+ *
+ * @param path - Document path
+ * @returns Plan ID or null if not found
+ */
+export function extractPlanId(path) {
+    const plansMatch = path.match(/plans[/\\]([^/\\]+)/);
+    if (!plansMatch) {
+        return null;
+    }
+    return plansMatch[1];
+}
+/**
+ * Parse tasks from a planning document.
+ * Extracts features marked with ### #<number>: pattern.
+ *
+ * @param path - Document path
+ * @param content - Document content
+ * @param planId - Plan ID for task ID generation
+ * @returns Array of parsed tasks
+ */
+export function parseTasksFromDocument(path, content, planId) {
+    const tasks = [];
+    // Match feature markers: ### #<number>: <title>
+    const featureRegex = /^###\s+#(\d+):\s+(.+)$/gm;
+    const matches = Array.from(content.matchAll(featureRegex));
+    for (const match of matches) {
+        const featureNumber = parseInt(match[1], 10);
+        const title = match[2].trim();
+        const taskId = `${planId}#${featureNumber}`;
+        // Extract status from content after the feature marker
+        const featureStart = match.index || 0;
+        const nextFeatureMatch = content.indexOf('### #', featureStart + 1);
+        const featureSection = nextFeatureMatch > 0
+            ? content.substring(featureStart, nextFeatureMatch)
+            : content.substring(featureStart);
+        // Extract status: Status: `GAP` or Status: `WIP`, etc.
+        const statusMatch = featureSection.match(/Status:\s*`?(\w+)`?/i);
+        const status = (statusMatch?.[1]?.toUpperCase() || 'GAP');
+        // Extract dependencies
+        const dependencies = [];
+        const depsMatch = featureSection.match(/Dependencies:\s*(.+?)(?:\n|$)/i);
+        if (depsMatch) {
+            const depsText = depsMatch[1].trim();
+            if (depsText && depsText.toLowerCase() !== 'none') {
+                // Extract feature references like #1, #2, or full task IDs
+                const depMatches = depsText.matchAll(/#(\d+)|(\d{4}[^#]*#\d+)/g);
+                for (const depMatch of depMatches) {
+                    if (depMatch[1]) {
+                        dependencies.push(`#${depMatch[1]}`);
+                    }
+                    else if (depMatch[2]) {
+                        dependencies.push(depMatch[2]);
+                    }
+                }
+            }
+        }
+        // Extract files from Files: line
+        const files = [];
+        const filesMatch = featureSection.match(/Files:\s*(.+?)(?:\n|$)/i);
+        if (filesMatch) {
+            const filesText = filesMatch[1].trim();
+            // Extract file paths (may be comma-separated or on multiple lines)
+            const fileMatches = filesText.matchAll(/`?([^\s`,]+\.(?:ts|js|tsx|jsx|md|json))`?/g);
+            for (const fileMatch of fileMatches) {
+                if (fileMatch[1]) {
+                    files.push(fileMatch[1]);
+                }
+            }
+        }
+        // Extract agent persona if this is an agent file
+        let agentPersona;
+        if (path.includes('/agents/') || path.includes('\\agents\\')) {
+            // Try to extract from agent file content
+            const personaMatch = content.match(/persona[:\s]+(coder|reviewer|pm|customer)/i);
+            if (personaMatch) {
+                agentPersona = personaMatch[1].toLowerCase();
+            }
+        }
+        tasks.push({
+            id: taskId,
+            planId,
+            featureNumber,
+            title,
+            status,
+            dependencies,
+            files,
+            documentPath: path,
+            agentPersona,
+        });
+    }
+    return tasks;
+}
+/**
+ * Find a specific task in parsed tasks by ID.
+ *
+ * @param tasks - Array of parsed tasks
+ * @param taskId - Task ID to find
+ * @returns Parsed task or undefined if not found
+ */
+export function findTaskById(tasks, taskId) {
+    return tasks.find((t) => t.id === taskId);
+}
+//# sourceMappingURL=task-parser.js.map

package/dist/task-parser.js.map

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

package/dist/test-setup.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Test setup file for Vitest.
+ * Provides shared test fixtures and configuration.
+ */
+export {};
+//# sourceMappingURL=test-setup.d.ts.map

package/dist/test-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-setup.d.ts","sourceRoot":"","sources":["../src/test-setup.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/test-setup.js

@@ -0,0 +1,37 @@
+/**
+ * Test setup file for Vitest.
+ * Provides shared test fixtures and configuration.
+ */
+import { beforeEach, afterEach } from 'vitest';
+import { mkdirSync, rmSync, existsSync } from 'fs';
+import { join } from 'path';
+import { tmpdir } from 'os';
+// Test directory for fixtures
+const TEST_DIR = join(tmpdir(), 'mcp-test-repo');
+beforeEach(async () => {
+    // Create fresh test directory structure
+    if (existsSync(TEST_DIR)) {
+        rmSync(TEST_DIR, { recursive: true, force: true });
+    }
+    mkdirSync(TEST_DIR, { recursive: true });
+    mkdirSync(join(TEST_DIR, 'addendums'), { recursive: true });
+    mkdirSync(join(TEST_DIR, 'examples'), { recursive: true });
+    mkdirSync(join(TEST_DIR, 'research'), { recursive: true });
+    mkdirSync(join(TEST_DIR, 'plans'), { recursive: true });
+    // Override config to use test directory if needed
+    // Note: Individual tests may override this with their own test directories
+    if (!process.env.REPO_ROOT) {
+        process.env.REPO_ROOT = TEST_DIR;
+    }
+});
+afterEach(async () => {
+    // Cleanup test directory
+    if (existsSync(TEST_DIR)) {
+        rmSync(TEST_DIR, { recursive: true, force: true });
+    }
+    // Reset env var if we set it
+    if (process.env.REPO_ROOT === TEST_DIR) {
+        delete process.env.REPO_ROOT;
+    }
+});
+//# sourceMappingURL=test-setup.js.map

package/dist/test-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-setup.js","sourceRoot":"","sources":["../src/test-setup.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAE5B,8BAA8B;AAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC;AAEjD,UAAU,CAAC,KAAK,IAAI,EAAE;IACpB,wCAAwC;IACxC,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,MAAM,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAExD,kDAAkD;IAClD,2EAA2E;IAC3E,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,SAAS,GAAG,QAAQ,CAAC;IACnC,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,SAAS,CAAC,KAAK,IAAI,EAAE;IACnB,yBAAyB;IACzB,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,MAAM,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,6BAA6B;IAC7B,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QACvC,OAAO,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;IAC/B,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/tools/claim-task.d.ts

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import type { ToolContext, ToolResult } from '../types.js';
+/**
+ * Input schema for claim_task tool.
+ */
+export declare const ClaimTaskInputSchema: z.ZodObject<{
+    taskId: z.ZodString;
+    agentId: z.ZodString;
+    persona: z.ZodOptional<z.ZodEnum<["coder", "reviewer", "pm", "customer"]>>;
+}, "strip", z.ZodTypeAny, {
+    taskId: string;
+    agentId: string;
+    persona?: "coder" | "reviewer" | "pm" | "customer" | undefined;
+}, {
+    taskId: string;
+    agentId: string;
+    persona?: "coder" | "reviewer" | "pm" | "customer" | undefined;
+}>;
+/**
+ * Handle claim_task tool request.
+ * Marks a task as in-progress by a specific agent with file locks.
+ *
+ * @param input - Tool input
+ * @param context - Tool context
+ * @returns Tool result
+ */
+export declare function handleClaimTask(input: z.infer<typeof ClaimTaskInputSchema>, context: ToolContext): Promise<ToolResult>;
+//# sourceMappingURL=claim-task.d.ts.map

package/dist/tools/claim-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim-task.d.ts","sourceRoot":"","sources":["../../src/tools/claim-task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAI/B,CAAC;AAiHH;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,EAC3C,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAgMrB"}