@nexvora/mcp-server 0.3.3 → 0.4.0

package/dist/tools/nexvora_submit_task.d.ts

@@ -4,21 +4,24 @@ declare const InputSchema: z.ZodObject<{
     prompt: z.ZodString;
     model: z.ZodOptional<z.ZodEnum<["PLATFORM_CHOICE", "GEMINI_FLASH", "CLAUDE_SONNET", "CLAUDE_OPUS"]>>;
     agentId: z.ZodOptional<z.ZodString>;
+    timeoutSeconds: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     prompt: string;
     agentId?: string | undefined;
     model?: "PLATFORM_CHOICE" | "GEMINI_FLASH" | "CLAUDE_SONNET" | "CLAUDE_OPUS" | undefined;
+    timeoutSeconds?: number | undefined;
 }, {
     prompt: string;
     agentId?: string | undefined;
     model?: "PLATFORM_CHOICE" | "GEMINI_FLASH" | "CLAUDE_SONNET" | "CLAUDE_OPUS" | undefined;
+    timeoutSeconds?: number | undefined;
 }>;
-interface TaskResponse {
-    id: string;
+interface TaskResult {
+    taskId: string;
     status: string;
     result?: string;
-    coinsCharged?: number;
+    feeCoins?: number;
 }
-export declare const nexvora_submit_task: ToolDefinition<typeof InputSchema, TaskResponse>;
+export declare const nexvora_submit_task: ToolDefinition<typeof InputSchema, TaskResult>;
 export {};
 //# sourceMappingURL=nexvora_submit_task.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"nexvora_submit_task.d.ts","sourceRoot":"","sources":["../../src/tools/nexvora_submit_task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,QAAA,MAAM,WAAW;;;;;;;;;;;;EAWf,CAAC;AAEH,UAAU,YAAY;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,mBAAmB,EAAE,cAAc,CAAC,OAAO,WAAW,EAAE,YAAY,CAgBhF,CAAC"}
+{"version":3,"file":"nexvora_submit_task.d.ts","sourceRoot":"","sources":["../../src/tools/nexvora_submit_task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAclD,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;EAqBf,CAAC;AAgBH,UAAU,UAAU;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD,eAAO,MAAM,mBAAmB,EAAE,cAAc,CAAC,OAAO,WAAW,EAAE,UAAU,CAwE9E,CAAC"}

package/dist/tools/nexvora_submit_task.js

@@ -1,4 +1,13 @@
 import { z } from "zod";
+const DEFAULT_TIMEOUT_SECONDS = 120;
+const POLL_INTERVAL_MS = 2_000;
+/**
+ * Statuses that mean the task will never produce a result, so we stop polling
+ * immediately rather than waiting out the timeout. Matched case-insensitively
+ * as substrings so we tolerate the backend's exact enum spelling
+ * (FAILED / TIMED_OUT / CANCELLED / EXPIRED / REJECTED / NO_DONOR_*).
+ */
+const TERMINAL_FAILURE = /FAIL|CANCEL|EXPIR|TIMEOUT|TIMED_OUT|REJECT|NO_DONOR|ERROR/;
 const InputSchema = z.object({
     prompt: z.string().min(1).describe("The task prompt to submit to the AI relay"),
     model: z
@@ -10,19 +19,80 @@ const InputSchema = z.object({
         .uuid()
         .optional()
         .describe("UUID of the donor agent to bill; omit for platform billing"),
+    timeoutSeconds: z
+        .number()
+        .int()
+        .min(5)
+        .max(300)
+        .optional()
+        .describe("How long to wait for the assigned agent to finish before returning. " +
+        "Default 120. The task keeps running server-side even if this elapses."),
 });
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
 export const nexvora_submit_task = {
     name: "nexvora_submit_task",
-    description: "Submit an AI task to the NexVora relay network. The platform selects the best " +
-        "available agent, executes the prompt, and returns the result. Coins are deducted " +
-        "from the authenticated user's wallet.",
+    description: "Submit an AI task to the NexVora relay network and wait for the result. The " +
+        "platform selects the best available agent, executes the prompt, and this tool " +
+        "blocks until that agent returns the answer (or the timeout elapses), then returns " +
+        "the result text. Coins are deducted from the authenticated user's wallet.",
     inputSchema: InputSchema,
     async handler(input, client) {
-        return client.post("/tasks", {
+        // 1. Submit. POST /tasks returns immediately with the task id; the assigned
+        //    agent runs the prompt asynchronously and posts its output later via
+        //    PATCH /tasks/{id}/result. Returning here (the old behaviour) handed the
+        //    caller a bare "QUEUED" ack with no answer.
+        const submitted = await client.post("/tasks", {
             prompt: input.prompt,
             model: input.model ?? "PLATFORM_CHOICE",
             agentId: input.agentId,
         });
+        const taskId = submitted.taskId;
+        const timeoutSeconds = input.timeoutSeconds ?? DEFAULT_TIMEOUT_SECONDS;
+        const deadline = Date.now() + timeoutSeconds * 1_000;
+        // 2. Poll GET /tasks/{id} until the result lands, a terminal failure state
+        //    is reached, or we run out of time. GET only carries the decrypted
+        //    `result` once status is COMPLETED.
+        let lastStatus = submitted.status ?? "QUEUED";
+        while (Date.now() < deadline) {
+            // Check first, sleep after: an already-finished task returns immediately
+            // without burning a poll interval, and the sleep is never reached on the
+            // happy path (important under fake timers in tests).
+            const detail = await client.get(`/tasks/${taskId}`);
+            lastStatus = detail.status ?? lastStatus;
+            const status = lastStatus.toUpperCase();
+            if (detail.result != null && detail.result !== "") {
+                return { taskId, status, result: detail.result, feeCoins: detail.feeCoins };
+            }
+            if (status === "COMPLETED") {
+                return {
+                    taskId,
+                    status,
+                    result: detail.result ?? "(completed with empty result)",
+                    feeCoins: detail.feeCoins,
+                };
+            }
+            if (TERMINAL_FAILURE.test(status)) {
+                return {
+                    taskId,
+                    status,
+                    result: `Task ended as ${status} before producing a result.`,
+                    feeCoins: detail.feeCoins,
+                };
+            }
+            await sleep(POLL_INTERVAL_MS);
+        }
+        // 3. Timed out waiting. The task is not cancelled — it keeps running and can
+        //    be fetched later by id; we just stop blocking the tool call.
+        return {
+            taskId,
+            status: lastStatus.toUpperCase(),
+            result: `No agent returned a result within ${timeoutSeconds}s (current status: ` +
+                `${lastStatus}). The task is still running server-side; retry later or ` +
+                `raise timeoutSeconds. Often this means no donor is currently online for ` +
+                `the requested model.`,
+        };
     },
 };
 //# sourceMappingURL=nexvora_submit_task.js.map

package/dist/tools/nexvora_submit_task.js.map

@@ -1 +1 @@
-{"version":3,"file":"nexvora_submit_task.js","sourceRoot":"","sources":["../../src/tools/nexvora_submit_task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IAC/E,KAAK,EAAE,CAAC;SACL,IAAI,CAAC,CAAC,iBAAiB,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,CAAC,CAAC;SACzE,QAAQ,EAAE;SACV,QAAQ,CAAC,8CAA8C,CAAC;IAC3D,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,IAAI,EAAE;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,4DAA4D,CAAC;CAC1E,CAAC,CAAC;AASH,MAAM,CAAC,MAAM,mBAAmB,GAAqD;IACnF,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EACT,gFAAgF;QAChF,mFAAmF;QACnF,uCAAuC;IAEzC,WAAW,EAAE,WAAW;IAExB,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,MAAqB;QACxC,OAAO,MAAM,CAAC,IAAI,CAAe,QAAQ,EAAE;YACzC,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,iBAAiB;YACvC,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}
+{"version":3,"file":"nexvora_submit_task.js","sourceRoot":"","sources":["../../src/tools/nexvora_submit_task.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexvora/mcp-server",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "description": "NexVora MCP server — exposes platform tools to Claude and other LLM agents",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",