@awcp/mcp 0.0.12 → 0.0.13

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

@@ -0,0 +1 @@
+{"version":3,"file":"delegate-snapshots.d.ts","sourceRoot":"","sources":["../../src/tools/delegate-snapshots.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,uBAAuB;;;;;;EAIlC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE9E,eAAO,MAAM,4BAA4B,yzBAyBxC,CAAC"}

package/dist/tools/delegate-snapshots.js

@@ -0,0 +1,36 @@
+/**
+ * delegate_snapshots tool - List snapshots for a delegation
+ */
+import { z } from 'zod';
+export const delegateSnapshotsSchema = z.object({
+    delegation_id: z
+        .string()
+        .describe('Delegation ID to list snapshots for'),
+});
+export const delegateSnapshotsDescription = `List all snapshots received from a delegation.
+
+Returns snapshot metadata including:
+- Snapshot ID, summary, and highlights
+- Status: pending (awaiting decision), applied, or discarded
+- Whether the executor recommends this snapshot
+- File count and size statistics
+
+Use this to review available snapshots before applying or discarding them.
+
+## When to use
+
+- After a delegation completes with snapshot_mode='staged'
+- To check which snapshot was auto-applied (snapshot_mode='auto')
+- To review multiple snapshots and decide which to apply
+
+## Example
+
+\`\`\`
+delegate_snapshots(delegation_id: "dlg_abc123")
+→ [
+    { id: "snap_1", summary: "Fixed auth bug", status: "pending", recommended: true },
+    { id: "snap_2", summary: "Also updated tests", status: "pending" }
+  ]
+\`\`\`
+`;
+//# sourceMappingURL=delegate-snapshots.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delegate-snapshots.js","sourceRoot":"","sources":["../../src/tools/delegate-snapshots.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,QAAQ,CAAC,qCAAqC,CAAC;CACnD,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,4BAA4B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;CAyB3C,CAAC"}

package/dist/tools/delegate.d.ts

@@ -1,43 +1,68 @@
 /**
  * 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';
 import type { PeersContext } from '../peer-discovery.js';
 export declare const delegateSchema: z.ZodObject<{
     description: z.ZodString;
     prompt: z.ZodString;
-    workspace_dir: z.ZodString;
+    workspace_dir: z.ZodOptional<z.ZodString>;
+    resources: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        path: z.ZodString;
+        mode: z.ZodOptional<z.ZodEnum<["ro", "rw"]>>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        path: string;
+        mode?: "ro" | "rw" | undefined;
+    }, {
+        name: string;
+        path: string;
+        mode?: "ro" | "rw" | undefined;
+    }>, "many">>;
     cwd: z.ZodOptional<z.ZodString>;
     peer_url: z.ZodString;
     ttl_seconds: z.ZodOptional<z.ZodNumber>;
     access_mode: z.ZodOptional<z.ZodEnum<["ro", "rw"]>>;
+    snapshot_mode: z.ZodOptional<z.ZodEnum<["auto", "staged", "discard"]>>;
+    auth_type: z.ZodOptional<z.ZodEnum<["api_key", "bearer", "oauth2"]>>;
+    auth_credential: z.ZodOptional<z.ZodString>;
     background: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     description: string;
     prompt: string;
-    workspace_dir: string;
     peer_url: string;
+    workspace_dir?: string | undefined;
+    resources?: {
+        name: string;
+        path: string;
+        mode?: "ro" | "rw" | undefined;
+    }[] | undefined;
     cwd?: string | undefined;
     ttl_seconds?: number | undefined;
     access_mode?: "ro" | "rw" | undefined;
+    snapshot_mode?: "auto" | "staged" | "discard" | undefined;
+    auth_type?: "api_key" | "bearer" | "oauth2" | undefined;
+    auth_credential?: string | undefined;
     background?: boolean | undefined;
 }, {
     description: string;
     prompt: string;
-    workspace_dir: string;
     peer_url: string;
+    workspace_dir?: string | undefined;
+    resources?: {
+        name: string;
+        path: string;
+        mode?: "ro" | "rw" | undefined;
+    }[] | undefined;
     cwd?: string | undefined;
     ttl_seconds?: number | undefined;
     access_mode?: "ro" | "rw" | undefined;
+    snapshot_mode?: "auto" | "staged" | "discard" | undefined;
+    auth_type?: "api_key" | "bearer" | "oauth2" | undefined;
+    auth_credential?: string | undefined;
     background?: boolean | undefined;
 }>;
 export type DelegateParams = z.infer<typeof delegateSchema>;
-/**
- * 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;AAIxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAKzD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmCzB,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"}
+{"version":3,"file":"delegate.d.ts","sourceRoot":"","sources":["../../src/tools/delegate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAWzD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsDzB,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,wBAAgB,2BAA2B,CAAC,KAAK,CAAC,EAAE,YAAY,GAAG,MAAM,CA2BxE"}

package/dist/tools/delegate.js

@@ -1,8 +1,5 @@
 /**
  * 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';
 import { readFileSync } from 'node:fs';
@@ -10,6 +7,11 @@ 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');
+const resourceSchema = z.object({
+    name: z.string().describe('Resource name (e.g., "src", "data")'),
+    path: z.string().describe('Local directory path'),
+    mode: z.enum(['ro', 'rw']).optional().describe('Access mode (default: rw)'),
+});
 export const delegateSchema = z.object({
     description: z
         .string()
@@ -19,11 +21,16 @@ export const delegateSchema = z.object({
         .describe('Full task instructions including goals and constraints'),
     workspace_dir: z
         .string()
-        .describe('Local directory path to delegate to the Executor (absolute or relative)'),
+        .optional()
+        .describe('Local directory path to delegate (for single-resource delegation)'),
+    resources: z
+        .array(resourceSchema)
+        .optional()
+        .describe('Multiple resources to delegate (alternative to workspace_dir)'),
     cwd: z
         .string()
         .optional()
-        .describe('Current working directory for resolving relative workspace_dir paths. If not provided, relative paths are resolved against the daemon process cwd.'),
+        .describe('Working directory for resolving relative paths'),
     peer_url: z
         .string()
         .url()
@@ -37,19 +44,27 @@ export const delegateSchema = z.object({
     access_mode: z
         .enum(['ro', 'rw'])
         .optional()
-        .describe('Access mode: ro (read-only) or rw (read-write, default)'),
+        .describe('Default access mode: ro (read-only) or rw (read-write, default)'),
+    snapshot_mode: z
+        .enum(['auto', 'staged', 'discard'])
+        .optional()
+        .describe('Snapshot handling: auto (apply immediately), staged (require manual apply), discard (ignore)'),
+    auth_type: z
+        .enum(['api_key', 'bearer', 'oauth2'])
+        .optional()
+        .describe('Authentication type for the Executor'),
+    auth_credential: z
+        .string()
+        .optional()
+        .describe('Authentication credential (API key, bearer token, etc.)'),
     background: z
         .boolean()
         .optional()
         .describe('If true, returns immediately with delegation_id. ' +
         'If false (default), waits for task completion.'),
 });
-/**
- * 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) {
@@ -68,9 +83,6 @@ export function generateDelegateDescription(peers) {
             }
         }
     }
-    // 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

@@ -1 +1 @@
-{"version":3,"file":"delegate.js","sourceRoot":"","sources":["../../src/tools/delegate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;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;AAGzC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,oBAAoB,GAAG,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC;AAEpF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,QAAQ,CAAC,+CAA+C,CAAC;IAC5D,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,CAAC,wDAAwD,CAAC;IACrE,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,QAAQ,CAAC,yEAAyE,CAAC;IACtF,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,oJAAoJ,CAAC;IACjK,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,CAAC,0CAA0C,CAAC;IACvD,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,2CAA2C,CAAC;IACxD,WAAW,EAAE,CAAC;SACX,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;SAClB,QAAQ,EAAE;SACV,QAAQ,CAAC,yDAAyD,CAAC;IACtE,UAAU,EAAE,CAAC;SACV,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CACP,mDAAmD;QACjD,gDAAgD,CACnD;CACJ,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,UAAU,2BAA2B,CAAC,KAAoB;IAC9D,IAAI,gBAAgB,GAAG,EAAE,CAAC;IAE1B,0DAA0D;IAC1D,IAAI,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,MAAM,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAEvD,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,gBAAgB,GAAG,wBAAwB,CAAC;YAE5C,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;gBAClC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAK,CAAC;gBACxB,gBAAgB,IAAI,WAAW,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC3C,gBAAgB,IAAI,kBAAkB,IAAI,CAAC,OAAO,IAAI,CAAC;gBAEvD,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;oBACrB,gBAAgB,IAAI,wBAAwB,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjE,CAAC;gBAED,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAC3D,gBAAgB,IAAI,mBAAmB,UAAU,EAAE,CAAC;gBACtD,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,sDAAsD;IACtD,OAAO,oBAAoB,CAAC,OAAO,CAAC,aAAa,EAAE,gBAAgB,CAAC,CAAC;AACvE,CAAC;AAED,gEAAgE;AAChE,MAAM,CAAC,MAAM,mBAAmB,GAAG,2BAA2B,EAAE,CAAC"}
+{"version":3,"file":"delegate.js","sourceRoot":"","sources":["../../src/tools/delegate.ts"],"names":[],"mappings":"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"}

package/dist/tools/delegate.txt

@@ -24,11 +24,42 @@ Consider delegating any task that would take significant time — tests, refacto
 
 Use background=false **only** when you have nothing else to do and must wait for this result.
 
+## Snapshot modes
+
+- **auto** (default): Executor's changes are automatically applied to your workspace
+- **staged**: Changes are saved but require manual review and apply via `delegate_snapshots` and `delegate_apply_snapshot`
+- **discard**: Changes are not saved (useful for read-only analysis tasks)
+
+Use `staged` when you want to review the executor's work before accepting it.
+
+## Multi-resource support
+
+You can delegate multiple directories with different access modes:
+
+```
+delegate(
+  resources: [
+    { name: "src", path: "/project/src", mode: "rw" },
+    { name: "data", path: "/project/data", mode: "ro" },
+  ],
+  ...
+)
+```
+
+Or use the simpler `workspace_dir` for single-directory delegations.
+
+## Authentication
+
+If the executor requires authentication, provide:
+- `auth_type`: "api_key", "bearer", or "oauth2"
+- `auth_credential`: The actual token or key
+
 ## Typical workflow
 
 1. Launch delegation with `background: true`
 2. Continue with other independent work (local tasks, more delegations, etc.)
 3. When ready for results, call `delegate_output(delegation_id, block: true, timeout: ...)`
+4. If using `snapshot_mode: "staged"`, review with `delegate_snapshots` then apply or discard
 
 This pattern maximizes parallelism and avoids idle waiting.
 
@@ -60,6 +91,15 @@ delegate_output(delegation_id: "dlg_1", block: true)
 delegate_output(delegation_id: "dlg_2", block: true)
 ```
 
+### Staged snapshot workflow
+```
+delegate(background: true, snapshot_mode: "staged", description: "Refactor auth", ...) → "dlg_abc"
+# ... wait for completion ...
+delegate_snapshots(delegation_id: "dlg_abc")
+# Review the snapshots, then:
+delegate_apply_snapshot(delegation_id: "dlg_abc", snapshot_id: "snap_1")
+```
+
 ### Synchronous (only when nothing else to do)
 ```
 delegate(background: false, description: "Generate config", ...)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awcp/mcp",
-  "version": "0.0.12",
+  "version": "0.0.13",
   "description": "MCP tools for AWCP delegation",
   "type": "module",
   "main": "dist/index.js",
@@ -21,11 +21,11 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@awcp/sdk": "^0.0.12",
-    "@awcp/core": "^0.0.12",
-    "@awcp/transport-archive": "^0.0.12",
-    "@awcp/transport-sshfs": "^0.0.12",
-    "@awcp/transport-git": "^0.0.12",
+    "@awcp/sdk": "^0.0.13",
+    "@awcp/core": "^0.0.13",
+    "@awcp/transport-archive": "^0.0.13",
+    "@awcp/transport-sshfs": "^0.0.13",
+    "@awcp/transport-git": "^0.0.13",
     "@a2a-js/sdk": "^0.3.5",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "zod": "^3.23.0"