@awcp/mcp 0.0.0-dev-202601300724

package/dist/bin/awcp-mcp.d.ts

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+/**
+ * AWCP MCP Server CLI
+ *
+ * Starts an MCP server that provides AWCP delegation tools.
+ * Connects to a running Delegator Daemon.
+ *
+ * Usage:
+ *   awcp-mcp [--daemon-url URL]
+ *
+ * Options:
+ *   --daemon-url  URL of Delegator Daemon (default: http://localhost:3100)
+ *   --help        Show this help message
+ *
+ * Example:
+ *   awcp-mcp --daemon-url http://localhost:3100
+ *
+ * Claude Desktop config (claude_desktop_config.json):
+ *   {
+ *     "mcpServers": {
+ *       "awcp": {
+ *         "command": "npx",
+ *         "args": ["awcp-mcp", "--daemon-url", "http://localhost:3100"]
+ *       }
+ *     }
+ *   }
+ */
+export {};
+//# sourceMappingURL=awcp-mcp.d.ts.map

package/dist/bin/awcp-mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"awcp-mcp.d.ts","sourceRoot":"","sources":["../../src/bin/awcp-mcp.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG"}

package/dist/bin/awcp-mcp.js

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+/**
+ * AWCP MCP Server CLI
+ *
+ * Starts an MCP server that provides AWCP delegation tools.
+ * Connects to a running Delegator Daemon.
+ *
+ * Usage:
+ *   awcp-mcp [--daemon-url URL]
+ *
+ * Options:
+ *   --daemon-url  URL of Delegator Daemon (default: http://localhost:3100)
+ *   --help        Show this help message
+ *
+ * Example:
+ *   awcp-mcp --daemon-url http://localhost:3100
+ *
+ * Claude Desktop config (claude_desktop_config.json):
+ *   {
+ *     "mcpServers": {
+ *       "awcp": {
+ *         "command": "npx",
+ *         "args": ["awcp-mcp", "--daemon-url", "http://localhost:3100"]
+ *       }
+ *     }
+ *   }
+ */
+import { createAwcpMcpServer } from '../server.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+async function main() {
+    const args = process.argv.slice(2);
+    // Parse arguments
+    let daemonUrl = 'http://localhost:3100';
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === '--daemon-url' && args[i + 1]) {
+            daemonUrl = args[i + 1];
+            i++;
+        }
+        else if (args[i] === '--help' || args[i] === '-h') {
+            console.error(`AWCP MCP Server
+
+Provides MCP tools for workspace delegation:
+  - delegate: Delegate a local directory to a remote Executor
+  - delegate_output: Get delegation status/results
+  - delegate_cancel: Cancel active delegations
+
+Usage:
+  awcp-mcp [options]
+
+Options:
+  --daemon-url URL  Delegator Daemon URL (default: http://localhost:3100)
+  --help, -h        Show this help message
+
+Example:
+  awcp-mcp --daemon-url http://localhost:3100
+
+Claude Desktop config:
+  {
+    "mcpServers": {
+      "awcp": {
+        "command": "npx",
+        "args": ["awcp-mcp", "--daemon-url", "http://localhost:3100"]
+      }
+    }
+  }
+`);
+            process.exit(0);
+        }
+    }
+    // Create server
+    const server = createAwcpMcpServer({ daemonUrl });
+    // Connect via stdio
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Log to stderr (stdout is for MCP protocol)
+    console.error(`[AWCP MCP] Server started, connected to daemon at ${daemonUrl}`);
+}
+main().catch((error) => {
+    console.error('[AWCP MCP] Fatal error:', error);
+    process.exit(1);
+});

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @awcp/mcp - MCP tools for AWCP workspace delegation
+ *
+ * @example
+ * ```typescript
+ * import { createAwcpMcpServer } from '@awcp/mcp';
+ * import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+ *
+ * const server = createAwcpMcpServer({
+ *   daemonUrl: 'http://localhost:3100',
+ * });
+ *
+ * const transport = new StdioServerTransport();
+ * await server.connect(transport);
+ * ```
+ */
+export { createAwcpMcpServer, type AwcpMcpServerOptions } from './server.js';
+export { DelegatorDaemonClient } from '@awcp/sdk/delegator/client';
+export { delegateSchema, type DelegateParams } from './tools/delegate.js';
+export { delegateOutputSchema, type DelegateOutputParams, } from './tools/delegate-output.js';
+export { delegateCancelSchema, type DelegateCancelParams, } from './tools/delegate-cancel.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,mBAAmB,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGnE,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EACL,oBAAoB,EACpB,KAAK,oBAAoB,GAC1B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,oBAAoB,EACpB,KAAK,oBAAoB,GAC1B,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -0,0 +1,22 @@
+/**
+ * @awcp/mcp - MCP tools for AWCP workspace delegation
+ *
+ * @example
+ * ```typescript
+ * import { createAwcpMcpServer } from '@awcp/mcp';
+ * import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+ *
+ * const server = createAwcpMcpServer({
+ *   daemonUrl: 'http://localhost:3100',
+ * });
+ *
+ * const transport = new StdioServerTransport();
+ * await server.connect(transport);
+ * ```
+ */
+export { createAwcpMcpServer } from './server.js';
+export { DelegatorDaemonClient } from '@awcp/sdk/delegator/client';
+// Tool schemas (for external use)
+export { delegateSchema } from './tools/delegate.js';
+export { delegateOutputSchema, } from './tools/delegate-output.js';
+export { delegateCancelSchema, } from './tools/delegate-cancel.js';

package/dist/server.d.ts

@@ -0,0 +1,38 @@
+/**
+ * AWCP MCP Server
+ *
+ * Provides MCP tools for AI agents to delegate workspaces to remote Executors.
+ *
+ * Tools:
+ * - delegate: Initiate a workspace delegation
+ * - delegate_output: Get delegation status/results
+ * - delegate_cancel: Cancel active delegations
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export interface AwcpMcpServerOptions {
+    /** URL of the Delegator Daemon (default: http://localhost:3100) */
+    daemonUrl?: string;
+    /** Timeout for daemon requests in ms (default: 30000) */
+    timeout?: number;
+    /** Default TTL for delegations in seconds (default: 3600) */
+    defaultTtl?: number;
+}
+/**
+ * Create an AWCP MCP Server instance
+ *
+ * @example
+ * ```typescript
+ * import { createAwcpMcpServer } from '@awcp/mcp';
+ * import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+ *
+ * const server = createAwcpMcpServer({
+ *   daemonUrl: 'http://localhost:3100',
+ * });
+ *
+ * const transport = new StdioServerTransport();
+ * await server.connect(transport);
+ * ```
+ */
+export declare function createAwcpMcpServer(options?: AwcpMcpServerOptions): McpServer;
+export { DelegatorDaemonClient } from '@awcp/sdk/delegator/client';
+//# 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;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAoBpE,MAAM,WAAW,oBAAoB;IACnC,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,oBAAyB,aA8LrE;AA2DD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/server.js

@@ -0,0 +1,232 @@
+/**
+ * AWCP MCP Server
+ *
+ * Provides MCP tools for AI agents to delegate workspaces to remote Executors.
+ *
+ * Tools:
+ * - delegate: Initiate a workspace delegation
+ * - delegate_output: Get delegation status/results
+ * - delegate_cancel: Cancel active delegations
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { DelegatorDaemonClient } from '@awcp/sdk/delegator/client';
+import { delegateSchema, delegateDescription, } from './tools/delegate.js';
+import { delegateOutputSchema, delegateOutputDescription, } from './tools/delegate-output.js';
+import { delegateCancelSchema, delegateCancelDescription, } from './tools/delegate-cancel.js';
+/**
+ * Create an AWCP MCP Server instance
+ *
+ * @example
+ * ```typescript
+ * import { createAwcpMcpServer } from '@awcp/mcp';
+ * import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+ *
+ * const server = createAwcpMcpServer({
+ *   daemonUrl: 'http://localhost:3100',
+ * });
+ *
+ * const transport = new StdioServerTransport();
+ * await server.connect(transport);
+ * ```
+ */
+export function createAwcpMcpServer(options = {}) {
+    const daemonUrl = options.daemonUrl ?? 'http://localhost:3100';
+    const timeout = options.timeout ?? 30000;
+    const defaultTtl = options.defaultTtl ?? 3600;
+    const client = new DelegatorDaemonClient(daemonUrl, { timeout });
+    const server = new McpServer({
+        name: 'awcp',
+        version: '1.0.0',
+    });
+    // ============================================
+    // Tool: delegate
+    // ============================================
+    server.tool('delegate', delegateDescription, delegateSchema.shape, async (params) => {
+        const { description, prompt, workspace_dir, peer_url, ttl_seconds, access_mode, background, } = params;
+        try {
+            const result = await client.delegate({
+                executorUrl: peer_url,
+                localDir: workspace_dir,
+                task: { description, prompt },
+                ttlSeconds: ttl_seconds ?? defaultTtl,
+                accessMode: access_mode ?? 'rw',
+            });
+            const delegationId = result.delegationId;
+            if (background) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Delegation launched in background.
+
+Delegation ID: ${delegationId}
+Executor: ${peer_url}
+Workspace: ${workspace_dir}
+Status: running
+
+Use \`delegate_output(delegation_id="${delegationId}")\` to check progress or retrieve results.`,
+                        },
+                    ],
+                };
+            }
+            // Sync mode: wait for completion
+            const delegation = await client.waitForCompletion(delegationId, 2000, 3600000);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: formatDelegationResult(delegation),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Delegation failed: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // ============================================
+    // Tool: delegate_output
+    // ============================================
+    server.tool('delegate_output', delegateOutputDescription, delegateOutputSchema.shape, async (params) => {
+        const { delegation_id, block, timeout: timeoutSec } = params;
+        try {
+            let delegation = await client.getDelegation(delegation_id);
+            if (block && isRunning(delegation)) {
+                const timeoutMs = (timeoutSec ?? 60) * 1000;
+                delegation = await client.waitForCompletion(delegation_id, 2000, timeoutMs);
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: formatDelegationStatus(delegation),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to get delegation: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // ============================================
+    // Tool: delegate_cancel
+    // ============================================
+    server.tool('delegate_cancel', delegateCancelDescription, delegateCancelSchema.shape, async (params) => {
+        const { delegation_id, all } = params;
+        try {
+            if (all) {
+                const list = await client.listDelegations();
+                const active = list.delegations.filter((d) => !['completed', 'error', 'cancelled'].includes(d.state));
+                for (const d of active) {
+                    await client.cancelDelegation(d.id);
+                }
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Cancelled ${active.length} delegation${active.length !== 1 ? 's' : ''}.`,
+                        },
+                    ],
+                };
+            }
+            if (!delegation_id) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'Provide either delegation_id or all=true',
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            await client.cancelDelegation(delegation_id);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Delegation ${delegation_id} cancelled.`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to cancel: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    return server;
+}
+// ============================================
+// Helpers
+// ============================================
+function isRunning(delegation) {
+    return ['created', 'invited', 'accepted', 'started', 'running'].includes(delegation.state);
+}
+function formatDelegationResult(delegation) {
+    const lines = [
+        `Delegation: ${delegation.id}`,
+        `Status: ${delegation.state}`,
+    ];
+    if (delegation.state === 'completed' && delegation.result) {
+        lines.push('', '--- Result ---', delegation.result.summary);
+        if (delegation.result.highlights?.length) {
+            lines.push('', 'Highlights:', ...delegation.result.highlights.map((h) => `  - ${h}`));
+        }
+    }
+    if (delegation.state === 'error' && delegation.error) {
+        lines.push('', '--- Error ---', delegation.error.message);
+        if (delegation.error.hint) {
+            lines.push(`Hint: ${delegation.error.hint}`);
+        }
+    }
+    return lines.join('\n');
+}
+function formatDelegationStatus(delegation) {
+    const lines = [
+        `Delegation: ${delegation.id}`,
+        `Status: ${delegation.state}`,
+        `Executor: ${delegation.peerUrl}`,
+        `Created: ${delegation.createdAt}`,
+    ];
+    if (isRunning(delegation)) {
+        lines.push('', 'Task is still running...');
+    }
+    else if (delegation.state === 'completed' && delegation.result) {
+        lines.push('', '--- Result ---', delegation.result.summary);
+    }
+    else if (delegation.state === 'error' && delegation.error) {
+        lines.push('', '--- Error ---', delegation.error.message);
+        if (delegation.error.hint) {
+            lines.push(`Hint: ${delegation.error.hint}`);
+        }
+    }
+    else if (delegation.state === 'cancelled') {
+        lines.push('', 'Delegation was cancelled.');
+    }
+    return lines.join('\n');
+}
+export { DelegatorDaemonClient } from '@awcp/sdk/delegator/client';

package/dist/tools/delegate-cancel.d.ts

@@ -0,0 +1,20 @@
+/**
+ * delegate_cancel tool - Cancel an active delegation
+ *
+ * This will terminate the delegation, unmount the remote filesystem,
+ * revoke credentials, and clean up resources.
+ */
+import { z } from 'zod';
+export declare const delegateCancelSchema: z.ZodObject<{
+    delegation_id: z.ZodOptional<z.ZodString>;
+    all: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    delegation_id?: string | undefined;
+    all?: boolean | undefined;
+}, {
+    delegation_id?: string | undefined;
+    all?: boolean | undefined;
+}>;
+export type DelegateCancelParams = z.infer<typeof delegateCancelSchema>;
+export declare const delegateCancelDescription = "Cancel active delegations.\n\n## Parameters\n- **delegation_id** (optional): Specific delegation ID to cancel\n- **all** (optional): Cancel all active delegations\n\n## Usage\nCancel a specific delegation:\n```\ndelegate_cancel(delegation_id: \"dlg_abc123\")\n```\n\nCancel all active delegations:\n```\ndelegate_cancel(all: true)\n```\n\n## Notes\n- Cancellation triggers cleanup: unmount, credential revocation, export removal\n- The Executor will receive a cancellation signal\n";
+//# sourceMappingURL=delegate-cancel.d.ts.map

package/dist/tools/delegate-cancel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegate-cancel.d.ts","sourceRoot":"","sources":["../../src/tools/delegate-cancel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,oBAAoB;;;;;;;;;EAS/B,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE,eAAO,MAAM,yBAAyB,seAoBrC,CAAC"}

package/dist/tools/delegate-cancel.js

@@ -0,0 +1,38 @@
+/**
+ * delegate_cancel tool - Cancel an active delegation
+ *
+ * This will terminate the delegation, unmount the remote filesystem,
+ * revoke credentials, and clean up resources.
+ */
+import { z } from 'zod';
+export const delegateCancelSchema = z.object({
+    delegation_id: z
+        .string()
+        .optional()
+        .describe('Specific delegation ID to cancel'),
+    all: z
+        .boolean()
+        .optional()
+        .describe('Cancel all active delegations'),
+});
+export const delegateCancelDescription = `Cancel active delegations.
+
+## Parameters
+- **delegation_id** (optional): Specific delegation ID to cancel
+- **all** (optional): Cancel all active delegations
+
+## Usage
+Cancel a specific delegation:
+\`\`\`
+delegate_cancel(delegation_id: "dlg_abc123")
+\`\`\`
+
+Cancel all active delegations:
+\`\`\`
+delegate_cancel(all: true)
+\`\`\`
+
+## Notes
+- Cancellation triggers cleanup: unmount, credential revocation, export removal
+- The Executor will receive a cancellation signal
+`;

package/dist/tools/delegate-output.d.ts

@@ -0,0 +1,22 @@
+/**
+ * delegate_output tool - Retrieve output from a delegation
+ *
+ * Use this to check status or get results from a background delegation.
+ */
+import { z } from 'zod';
+export declare const delegateOutputSchema: z.ZodObject<{
+    delegation_id: z.ZodString;
+    block: z.ZodOptional<z.ZodBoolean>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    delegation_id: string;
+    block?: boolean | undefined;
+    timeout?: number | undefined;
+}, {
+    delegation_id: string;
+    block?: boolean | undefined;
+    timeout?: number | undefined;
+}>;
+export type DelegateOutputParams = z.infer<typeof delegateOutputSchema>;
+export declare const delegateOutputDescription = "Retrieve output from a delegation.\n\n## Parameters\n- **delegation_id** (required): Delegation ID from delegate()\n- **block** (optional): Wait for completion if still running\n- **timeout** (optional): Maximum seconds to wait (default: 60)\n\n## Usage\nAfter launching a background delegation:\n```\ndelegate(background: true, ...) \u2192 \"Delegation ID: dlg_abc123...\"\n```\n\nCheck or retrieve results:\n```\ndelegate_output(delegation_id: \"dlg_abc123\")\n```\n\nWait for completion:\n```\ndelegate_output(delegation_id: \"dlg_abc123\", block: true, timeout: 120)\n```\n";
+//# sourceMappingURL=delegate-output.d.ts.map

package/dist/tools/delegate-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegate-output.d.ts","sourceRoot":"","sources":["../../src/tools/delegate-output.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAc/B,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE,eAAO,MAAM,yBAAyB,skBAsBrC,CAAC"}

package/dist/tools/delegate-output.js

@@ -0,0 +1,44 @@
+/**
+ * delegate_output tool - Retrieve output from a delegation
+ *
+ * Use this to check status or get results from a background delegation.
+ */
+import { z } from 'zod';
+export const delegateOutputSchema = z.object({
+    delegation_id: z
+        .string()
+        .describe('The delegation ID returned from delegate()'),
+    block: z
+        .boolean()
+        .optional()
+        .describe('Wait for completion if still running'),
+    timeout: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe('Maximum seconds to wait when blocking (default: 60)'),
+});
+export const delegateOutputDescription = `Retrieve output from a delegation.
+
+## Parameters
+- **delegation_id** (required): Delegation ID from delegate()
+- **block** (optional): Wait for completion if still running
+- **timeout** (optional): Maximum seconds to wait (default: 60)
+
+## Usage
+After launching a background delegation:
+\`\`\`
+delegate(background: true, ...) → "Delegation ID: dlg_abc123..."
+\`\`\`
+
+Check or retrieve results:
+\`\`\`
+delegate_output(delegation_id: "dlg_abc123")
+\`\`\`
+
+Wait for completion:
+\`\`\`
+delegate_output(delegation_id: "dlg_abc123", block: true, timeout: 120)
+\`\`\`
+`;

package/dist/tools/delegate.d.ts

@@ -0,0 +1,35 @@
+/**
+ * delegate tool - Initiate a workspace delegation to a remote Executor
+ *
+ * This tool allows an AI agent to delegate a local directory to a remote
+ * Executor agent for collaborative task execution.
+ */
+import { z } from 'zod';
+export declare const delegateSchema: z.ZodObject<{
+    description: z.ZodString;
+    prompt: z.ZodString;
+    workspace_dir: z.ZodString;
+    peer_url: z.ZodString;
+    ttl_seconds: z.ZodOptional<z.ZodNumber>;
+    access_mode: z.ZodOptional<z.ZodEnum<["ro", "rw"]>>;
+    background: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    prompt: string;
+    workspace_dir: string;
+    peer_url: string;
+    ttl_seconds?: number | undefined;
+    access_mode?: "ro" | "rw" | undefined;
+    background?: boolean | undefined;
+}, {
+    description: string;
+    prompt: string;
+    workspace_dir: string;
+    peer_url: string;
+    ttl_seconds?: number | undefined;
+    access_mode?: "ro" | "rw" | undefined;
+    background?: boolean | undefined;
+}>;
+export type DelegateParams = z.infer<typeof delegateSchema>;
+export declare const delegateDescription = "Delegate a local workspace directory to a remote Executor agent.\n\n## Parameters\n- **description** (required): Short task description for logs\n- **prompt** (required): Full task instructions with goals and constraints\n- **workspace_dir** (required): Local directory path to delegate\n- **peer_url** (required): Executor's AWCP endpoint URL\n- **ttl_seconds** (optional): Lease duration (default: 3600)\n- **access_mode** (optional): \"ro\" or \"rw\" (default: \"rw\")\n- **background** (optional): Return immediately if true (default: false)\n\n## Behavior\n- **Sync mode (background=false)**: Waits for task completion, returns final_summary\n- **Async mode (background=true)**: Returns delegation_id immediately\n\n## Example\n```\ndelegate({\n  description: \"Fix TypeScript errors\",\n  prompt: \"Find and fix all type errors in the src/ directory...\",\n  workspace_dir: \"/path/to/project\",\n  peer_url: \"http://executor:4001/awcp\",\n  background: true\n})\n```\n";
+//# sourceMappingURL=delegate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delegate.d.ts","sourceRoot":"","sources":["../../src/tools/delegate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;EA+BzB,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,eAAO,MAAM,mBAAmB,q9BAyB/B,CAAC"}

package/dist/tools/delegate.js

@@ -0,0 +1,63 @@
+/**
+ * delegate tool - Initiate a workspace delegation to a remote Executor
+ *
+ * This tool allows an AI agent to delegate a local directory to a remote
+ * Executor agent for collaborative task execution.
+ */
+import { z } from 'zod';
+export const delegateSchema = z.object({
+    description: z
+        .string()
+        .describe('Short task description (for logs and listing)'),
+    prompt: z
+        .string()
+        .describe('Full task instructions including goals and constraints'),
+    workspace_dir: z
+        .string()
+        .describe('Local directory path to delegate to the Executor'),
+    peer_url: z
+        .string()
+        .url()
+        .describe('URL of the target Executor AWCP endpoint'),
+    ttl_seconds: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe('Lease duration in seconds (default: 3600)'),
+    access_mode: z
+        .enum(['ro', 'rw'])
+        .optional()
+        .describe('Access mode: ro (read-only) or rw (read-write, default)'),
+    background: z
+        .boolean()
+        .optional()
+        .describe('If true, returns immediately with delegation_id. ' +
+        'If false (default), waits for task completion.'),
+});
+export const delegateDescription = `Delegate a local workspace directory to a remote Executor agent.
+
+## Parameters
+- **description** (required): Short task description for logs
+- **prompt** (required): Full task instructions with goals and constraints
+- **workspace_dir** (required): Local directory path to delegate
+- **peer_url** (required): Executor's AWCP endpoint URL
+- **ttl_seconds** (optional): Lease duration (default: 3600)
+- **access_mode** (optional): "ro" or "rw" (default: "rw")
+- **background** (optional): Return immediately if true (default: false)
+
+## Behavior
+- **Sync mode (background=false)**: Waits for task completion, returns final_summary
+- **Async mode (background=true)**: Returns delegation_id immediately
+
+## Example
+\`\`\`
+delegate({
+  description: "Fix TypeScript errors",
+  prompt: "Find and fix all type errors in the src/ directory...",
+  workspace_dir: "/path/to/project",
+  peer_url: "http://executor:4001/awcp",
+  background: true
+})
+\`\`\`
+`;

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@awcp/mcp",
+  "version": "0.0.0-dev-202601300724",
+  "description": "MCP tools for AWCP delegation",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "awcp-mcp": "dist/bin/awcp-mcp.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@awcp/sdk": "0.0.0-dev-202601300724",
+    "@awcp/core": "0.0.0-dev-202601300724",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.12.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.4.0"
+  },
+  "files": [
+    "dist"
+  ]
+}