@awcp/mcp 0.0.1 → 0.0.3

package/dist/tools/delegate-output.js

@@ -4,10 +4,14 @@
  * Use this to check status or get results from a background delegation.
  */
 import { z } from 'zod';
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
 export const delegateOutputSchema = z.object({
     delegation_id: z
         .string()
-        .describe('The delegation ID returned from delegate()'),
+        .describe('Delegation ID from the background delegation launch'),
     block: z
         .boolean()
         .optional()
@@ -17,28 +21,7 @@ export const delegateOutputSchema = z.object({
         .int()
         .positive()
         .optional()
-        .describe('Maximum seconds to wait when blocking (default: 60)'),
+        .describe('Max seconds to wait (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)
-\`\`\`
-`;
+export const delegateOutputDescription = readFileSync(join(__dirname, 'delegate-output.txt'), 'utf-8');
+//# sourceMappingURL=delegate-output.js.map

package/dist/tools/delegate-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegate-output.js","sourceRoot":"","sources":["../../src/tools/delegate-output.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,QAAQ,CAAC,qDAAqD,CAAC;IAClE,KAAK,EAAE,CAAC;SACL,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,sCAAsC,CAAC;IACnD,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,mCAAmC,CAAC;CACjD,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,yBAAyB,GAAG,YAAY,CACnD,IAAI,CAAC,SAAS,EAAE,qBAAqB,CAAC,EACtC,OAAO,CACR,CAAC"}

package/dist/tools/delegate-output.txt

@@ -0,0 +1,22 @@
+Retrieve output from a background delegation.
+
+## Parameters
+- **delegation_id** (required): Delegation ID from the background delegation launch
+- **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

@@ -5,6 +5,7 @@
  * Executor agent for collaborative task execution.
  */
 import { z } from 'zod';
+import type { PeersContext } from '../peer-discovery.js';
 export declare const delegateSchema: z.ZodObject<{
     description: z.ZodString;
     prompt: z.ZodString;
@@ -31,5 +32,9 @@ export declare const delegateSchema: z.ZodObject<{
     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";
+/**
+ * Generate delegate tool description with available executors info
+ */
+export declare function generateDelegateDescription(peers?: PeersContext): string;
+export declare const delegateDescription: string;
 //# sourceMappingURL=delegate.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"delegate.d.ts","sourceRoot":"","sources":["../../src/tools/delegate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAKzD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;EA+BzB,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,CAAC,EAAE,YAAY,GAAG,MAAM,CA6BxE;AAGD,eAAO,MAAM,mBAAmB,QAAgC,CAAC"}

package/dist/tools/delegate.js

@@ -5,6 +5,11 @@
  * Executor agent for collaborative task execution.
  */
 import { z } from 'zod';
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const DESCRIPTION_TEMPLATE = readFileSync(join(__dirname, 'delegate.txt'), 'utf-8');
 export const delegateSchema = z.object({
     description: z
         .string()
@@ -35,29 +40,33 @@ export const delegateSchema = z.object({
         .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
-})
-\`\`\`
-`;
+/**
+ * Generate delegate tool description with available executors info
+ */
+export function generateDelegateDescription(peers) {
+    let executorsSection = '';
+    // Add available executors section if peers are configured
+    if (peers && peers.peers.length > 0) {
+        const availablePeers = peers.peers.filter(p => p.card);
+        if (availablePeers.length > 0) {
+            executorsSection = '## Available Executors';
+            for (const peer of availablePeers) {
+                const card = peer.card;
+                executorsSection += `\n\n### ${card.name}`;
+                executorsSection += `\n- **URL**: \`${peer.awcpUrl}\``;
+                if (card.description) {
+                    executorsSection += `\n- **Description**: ${card.description}`;
+                }
+                if (card.skills && card.skills.length > 0) {
+                    const skillNames = card.skills.map(s => s.name).join(', ');
+                    executorsSection += `\n- **Skills**: ${skillNames}`;
+                }
+            }
+        }
+    }
+    // Replace {executors} placeholder with actual content
+    return DESCRIPTION_TEMPLATE.replace('{executors}', executorsSection);
+}
+// For backward compatibility - static description without peers
+export const delegateDescription = generateDelegateDescription();
+//# sourceMappingURL=delegate.js.map

package/dist/tools/delegate.js.map

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

package/dist/tools/delegate.txt

@@ -0,0 +1,46 @@
+Delegate a workspace to a remote Executor for collaborative task execution.
+
+## When to use
+
+Use delegation when:
+- Task requires a different environment or specialized toolset
+- You want to parallelize work across multiple agents
+- The remote agent has capabilities you lack (e.g., browser, GPU, specific SDKs)
+
+Do NOT use when:
+- Task is trivial and can be done locally
+- You need real-time back-and-forth interaction during execution
+
+## Background mode
+
+**Prefer background=true by default.** This lets you launch multiple delegations in parallel and continue working.
+
+Use background=false only when you cannot proceed without the result.
+
+## Writing effective prompts
+
+Structure your prompt with:
+- **What to do**: Clear, specific goal
+- **Expected outcome**: What success looks like
+- **Context**: Relevant file paths, patterns, constraints
+- **What NOT to do**: Scope boundaries to prevent over-engineering
+
+{executors}
+
+## Examples
+
+### Parallel tasks
+```
+delegate(background: true, description: "Fix linting errors", prompt: "...", workspace_dir: "/project", peer_url: "...")
+delegate(background: true, description: "Add unit tests", prompt: "...", workspace_dir: "/project", peer_url: "...")
+```
+
+### Synchronous (when result needed immediately)
+```
+delegate(background: false, description: "Generate config", prompt: "Create tsconfig.json for...", workspace_dir: "/project", peer_url: "...")
+```
+
+### Read-only analysis
+```
+delegate(description: "Code review", prompt: "Review the code for security issues...", workspace_dir: "/project", peer_url: "...", access_mode: "ro")
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awcp/mcp",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "MCP tools for AWCP delegation",
   "type": "module",
   "main": "dist/index.js",
@@ -15,14 +15,17 @@
     }
   },
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && cp src/tools/*.txt dist/tools/",
     "dev": "tsc --watch",
     "test": "vitest run",
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@awcp/sdk": "^0.0.1",
-    "@awcp/core": "^0.0.1",
+    "@awcp/sdk": "^0.0.3",
+    "@awcp/core": "^0.0.3",
+    "@awcp/transport-archive": "^0.0.3",
+    "@awcp/transport-sshfs": "^0.0.3",
+    "@a2a-js/sdk": "^0.3.5",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "zod": "^3.23.0"
   },