@awcp/sdk 0.0.0-dev-202601300724

package/dist/server/express/awcp-executor-handler.js

@@ -0,0 +1,104 @@
+/**
+ * AWCP Executor Express Handler
+ *
+ * Express middleware for enabling AWCP support in an A2A agent (Executor side).
+ */
+import { Router, json } from 'express';
+import { ExecutorService } from '../../executor/service.js';
+/**
+ * Create an Express router that handles AWCP messages (Executor side)
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { executorHandler } from '@awcp/sdk/server/express';
+ *
+ * const app = express();
+ *
+ * // ... existing A2A setup ...
+ *
+ * // Enable AWCP
+ * app.use('/awcp', executorHandler({
+ *   executor: myExecutor,
+ *   config: {
+ *     mount: { root: '/tmp/awcp/mounts' },
+ *   },
+ * }));
+ * ```
+ */
+export function executorHandler(options) {
+    const router = Router();
+    const service = new ExecutorService({
+        executor: options.executor,
+        config: options.config,
+    });
+    // Parse JSON bodies
+    router.use(json());
+    /**
+     * POST / - Receive AWCP messages from Delegator
+     *
+     * The Delegator sends INVITE and START messages to this endpoint.
+     * The Delegator URL for sending responses is provided in the
+     * X-AWCP-Callback-URL header.
+     */
+    router.post('/', async (req, res) => {
+        try {
+            const message = req.body;
+            const delegatorUrl = req.headers['x-awcp-callback-url'];
+            if (!delegatorUrl && message.type !== 'ERROR') {
+                res.status(400).json({
+                    error: 'Missing X-AWCP-Callback-URL header',
+                });
+                return;
+            }
+            // For START messages, respond immediately and handle async
+            if (message.type === 'START') {
+                res.json({ ok: true });
+                // Handle START asynchronously (mount + execute task)
+                service.handleMessage(message, delegatorUrl ?? '').catch((error) => {
+                    console.error('[AWCP Executor] Error handling START:', error);
+                });
+                return;
+            }
+            // Other messages (INVITE, ERROR) are handled synchronously
+            const response = await service.handleMessage(message, delegatorUrl ?? '');
+            if (response) {
+                // INVITE returns ACCEPT/ERROR synchronously
+                res.json(response);
+            }
+            else {
+                res.json({ ok: true });
+            }
+        }
+        catch (error) {
+            console.error('[AWCP Executor] Error handling message:', error);
+            res.status(500).json({
+                error: error instanceof Error ? error.message : 'Internal error',
+            });
+        }
+    });
+    /**
+     * GET /status - Get service status
+     */
+    router.get('/status', (_req, res) => {
+        res.json(service.getStatus());
+    });
+    /**
+     * POST /cancel/:delegationId - Cancel a delegation
+     */
+    router.post('/cancel/:delegationId', async (req, res) => {
+        try {
+            const { delegationId } = req.params;
+            await service.cancelDelegation(delegationId);
+            res.json({ ok: true, cancelled: true });
+        }
+        catch (error) {
+            console.error('[AWCP Executor] Error cancelling delegation:', error);
+            res.status(error instanceof Error && error.message.includes('not found') ? 404 : 500).json({
+                error: error instanceof Error ? error.message : 'Internal error',
+            });
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=awcp-executor-handler.js.map

package/dist/server/express/awcp-executor-handler.js.map

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

package/dist/server/express/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Express integration for AWCP
+ */
+export { executorHandler, type ExecutorHandlerOptions } from './awcp-executor-handler.js';
+export { delegatorHandler, type DelegatorHandlerOptions, type DelegatorHandlerResult, } from './awcp-delegator-handler.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/express/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/express/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAG1F,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,GAC5B,MAAM,6BAA6B,CAAC"}

package/dist/server/express/index.js

@@ -0,0 +1,8 @@
+/**
+ * Express integration for AWCP
+ */
+// Executor-side handler (for A2A agents accepting delegations)
+export { executorHandler } from './awcp-executor-handler.js';
+// Delegator-side handler (for agents creating delegations)
+export { delegatorHandler, } from './awcp-delegator-handler.js';
+//# sourceMappingURL=index.js.map

package/dist/server/express/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/express/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,+DAA+D;AAC/D,OAAO,EAAE,eAAe,EAA+B,MAAM,4BAA4B,CAAC;AAE1F,2DAA2D;AAC3D,OAAO,EACL,gBAAgB,GAGjB,MAAM,6BAA6B,CAAC"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@awcp/sdk",
+  "version": "0.0.0-dev-202601300724",
+  "description": "AWCP SDK - Delegator and Executor Daemon implementations",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./delegator": {
+      "types": "./dist/delegator/index.d.ts",
+      "import": "./dist/delegator/index.js"
+    },
+    "./delegator/client": {
+      "types": "./dist/delegator/bin/client.d.ts",
+      "import": "./dist/delegator/bin/client.js"
+    },
+    "./executor": {
+      "types": "./dist/executor/index.d.ts",
+      "import": "./dist/executor/index.js"
+    },
+    "./server/express": {
+      "types": "./dist/server/express/index.d.ts",
+      "import": "./dist/server/express/index.js"
+    }
+  },
+  "bin": {
+    "delegator-daemon": "./dist/delegator/bin/daemon.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "clean": "rm -rf dist *.tsbuildinfo",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@awcp/core": "0.0.0-dev-202601300724",
+    "@awcp/transport-sshfs": "0.0.0-dev-202601300724",
+    "@a2a-js/sdk": "^0.3.5"
+  },
+  "peerDependencies": {
+    "express": "^4.18.0"
+  },
+  "peerDependenciesMeta": {
+    "express": {
+      "optional": true
+    }
+  },
+  "keywords": [
+    "awcp",
+    "agent",
+    "sdk",
+    "delegator",
+    "executor"
+  ],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/anthropics/awcp.git",
+    "directory": "packages/sdk"
+  }
+}