@odatano/core-mcp 0.1.0

package/dist/tools/worker.js

@@ -0,0 +1,60 @@
+import { z } from 'zod';
+import { jsonValue, uuid } from '../schemas.js';
+import { makeRunner } from './shared.js';
+/*
+ * ODATANO v2.0 wallet worker (CardanoWorkerService). Status/read tools are
+ * always registered when the service exists. The write tools queue jobs that
+ * a SERVER-HELD wallet signs, so they are opt-in (ODATANO_MCP_ENABLE_WALLET_JOBS)
+ * and meant to be used with a scoped credential; PauseWorker / ResumeWorker
+ * (Admin) are never exposed.
+ */
+const JOB_KINDS = ['simpleAda', 'metadata', 'multiAsset', 'mint', 'plutusSpend', 'submitSigned'];
+export function registerWorkerTools(server, ctx) {
+    const { client, config } = ctx;
+    const run = makeRunner(ctx);
+    server.registerTool('get_worker_status', {
+        description: 'Live wallet-worker summary on the host (ODATANO >= 2.0): running flag, configured wallet ids, ' +
+            'in-flight executions, jobs awaiting confirmation, queue depth.',
+        inputSchema: {},
+    }, run(async () => client.callFunction('worker', 'GetWorkerStatus')));
+    server.registerTool('get_wallet_job_status', {
+        description: 'Lifecycle state of a wallet-worker job: status (pending / building / submitting / submitted / ' +
+            'confirmed / failed / cancelled), attempt, txHash, fee, error code/message, timestamps. Poll every few ' +
+            'seconds until confirmed or failed. Non-admin callers see their own jobs only.',
+        inputSchema: {
+            jobId: uuid('jobId').describe('Job id returned by submit_wallet_job'),
+        },
+    }, run(async (args) => client.callFunction('worker', 'GetJobStatus', { jobId: args.jobId }), {
+        notFoundAs: (args) => ({ jobId: args.jobId }),
+    }));
+    if (!config.enableWalletJobs)
+        return;
+    server.registerTool('submit_wallet_job', {
+        description: 'Queue an asynchronous transaction job for a SERVER-MANAGED worker wallet (ODATANO >= 2.0): the host ' +
+            'builds, signs with the wallet\'s software/HSM key, submits and tracks confirmation. requestJson is the ' +
+            'same payload shape as the matching build_* tool (senderAddress is overridden with the wallet address); ' +
+            'kind submitSigned takes {signedTxCbor} and only submits. ' +
+            'Idempotent per (walletId, kind, idempotencyKey) - a retry returns the original job. Returns ' +
+            '{ jobId, status, deduplicated }; poll get_wallet_job_status. THIS MOVES FUNDS once confirmed - only ' +
+            'use with an explicit instruction and a wallet you are allowed to spend from.',
+        inputSchema: {
+            walletId: z.string().min(1).max(50).describe('Configured worker wallet id'),
+            kind: z.enum(JOB_KINDS).describe('Job kind: simpleAda | metadata | multiAsset | mint | plutusSpend | submitSigned'),
+            requestJson: jsonValue('requestJson', 'object')
+                .describe('Build request payload (same fields as the corresponding build_* tool, minus senderAddress)'),
+            idempotencyKey: z.string().min(1).max(100).optional().describe('Caller key that dedupes retries (strongly recommended)'),
+            priority: z.number().int().optional().describe('Higher runs first within a wallet'),
+            notBefore: z.string().datetime().optional().describe('ISO timestamp; do not start before'),
+        },
+    }, run(async (args) => client.callAction('worker', 'SubmitWalletJob', args)));
+    server.registerTool('cancel_wallet_job', {
+        description: 'Cancel a still-pending wallet job. Jobs that already started building may reach the chain and cannot ' +
+            'be cancelled (returns false).',
+        inputSchema: {
+            jobId: uuid('jobId').describe('Job id'),
+        },
+    }, run(async (args) => client.callAction('worker', 'CancelJob', { jobId: args.jobId }), {
+        notFoundAs: (args) => ({ jobId: args.jobId }),
+    }));
+}
+//# sourceMappingURL=worker.js.map

package/dist/tools/worker.js.map

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

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@odatano/core-mcp",
+  "version": "0.1.0",
+  "description": "MCP server exposing ODATANO (Cardano OData bridge, SAP CAP) to AI agents: reads, unsigned tx builds, signing handoff, submit",
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "odatano-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "start": "node dist/index.js",
+    "test": "tsc -p tsconfig.test.json && node --test .test-dist/schemas.test.js .test-dist/output.test.js .test-dist/client.test.js",
+    "integration": "npm run build && node scripts/integration-mcp.mjs",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ODATANO/ODATANO-MCP.git"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "cardano",
+    "blockchain",
+    "odata",
+    "sap-cap",
+    "utxo",
+    "plutus",
+    "ai-agent"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.5.0"
+  }
+}