@vapi-network/core 0.9.0 → 0.9.2

package/dist/tasks.js

@@ -38100,6 +38100,7 @@ function guardError(url2) {
 
 // src/tasks/types.ts
 var uuidSchema = external_exports.uuid();
+var profileIdSchema = external_exports.string().min(1).max(64).regex(/^[A-Za-z0-9_-]+$/);
 var isoDateTimeSchema = external_exports.iso.datetime();
 var addressSchema2 = external_exports.string().regex(/^0x[0-9a-fA-F]{40}$/).transform((value) => value.toLowerCase());
 var bytes32Schema = external_exports.string().regex(/^0x[0-9a-fA-F]{64}$/).transform((value) => value.toLowerCase());
@@ -38437,7 +38438,7 @@ var deliveryResponseSchema = external_exports.looseObject({
   version: external_exports.number().int().positive(),
   manifest: manifestResponseSchema,
   manifestHash: bytes32Schema,
-  submittedByProfileId: uuidSchema,
+  submittedByProfileId: profileIdSchema,
   createdAt: isoDateTimeSchema
 });
 var orderDeliveryResponseSchema = external_exports.looseObject({
@@ -38543,7 +38544,7 @@ var reviewResponseSchema = external_exports.looseObject({
   id: uuidSchema,
   workOrderId: uuidSchema,
   clientAddress: addressSchema2,
-  vendorProfileId: uuidSchema,
+  vendorProfileId: profileIdSchema,
   rating: external_exports.number().int().min(1).max(5),
   body: external_exports.string(),
   subRatings: external_exports.json().nullable(),
@@ -39086,12 +39087,15 @@ function createTasksClient(options) {
         const parsed2 = serverErrorSchema.safeParse(errorBody);
         const server = parsed2.success ? parsed2.data : void 0;
         const nested = typeof server?.error === "object" ? server.error : void 0;
-        const message = (typeof server?.error === "string" ? server.error : nested?.message) || server?.message || response.statusText || `HTTP ${response.status}`;
+        const serverCode = nested?.code ?? server?.code;
+        const serverMessage = (typeof server?.error === "string" ? server.error : nested?.message) || server?.message;
+        const fallback = response.statusText || `HTTP ${response.status}`;
+        const message = response.status === 401 || response.status === 403 ? serverCode ?? fallback : serverMessage || (errorBody === void 0 && raw.trim() ? raw.replace(/\s+/gu, " ").trim().slice(0, 300) : fallback);
         throw new TasksClientError(
           "http",
           message,
           response.status,
-          nested?.code ?? server?.code,
+          serverCode,
           response.headers.get("Retry-After") ?? void 0
         );
       }
@@ -39494,9 +39498,10 @@ function safeTasksChainError(cause, broadcast, authorizationExposed, txHash) {
   let message = "Task chain operation failed.";
   if (cause instanceof TasksValidationError || cause instanceof TasksChainError)
     message = cause.message;
-  else if (cause instanceof TasksClientError)
-    message = `Tasks service request failed${cause.status === void 0 ? "" : ` (status ${cause.status})`}.`;
-  else if (cause instanceof Error) {
+  else if (cause instanceof TasksClientError) {
+    const code = cause.serverCode ?? (cause.status ? `http_${cause.status}` : cause.code);
+    message = cause.status === 401 || cause.status === 403 ? `${code} (status ${cause.status})` : `${code}: ${cause.message}`;
+  } else if (cause instanceof Error) {
     const short = "shortMessage" in cause && typeof cause.shortMessage === "string" ? cause.shortMessage : void 0;
     let statusCode;
     const seen = /* @__PURE__ */ new Set();
@@ -40463,6 +40468,44 @@ function createTasksChain(options) {
       return idempotencyKey;
     });
   }
+  async function prepareOrResume(prepare, expected, idempotencyKey, kind, steps, authorizationExposed = false, beforeSign) {
+    let prepared;
+    let resumedFromServer = false;
+    try {
+      prepared = await prepare();
+    } catch (error61) {
+      if (!uncertainPreparation(error61)) throw error61;
+      const fresh = await order(expected.milestone.workOrderId);
+      const matches = fresh.milestones.filter((item) => item.id === expected.milestone.id);
+      if (matches.length !== 1 || matches[0].workOrderId !== fresh.id)
+        throw new TasksValidationError("The task milestone does not match its parent order.");
+      const selected = matches[0];
+      const operation = selected.chainOperation;
+      if (expected.verb === "deliver" && selected.delivery && !operation)
+        throw new TasksValidationError(
+          "The server recorded this delivery but has no chain operation for it; open the task in the console to continue."
+        );
+      if (!operation || operation.kind !== kind || !(typeof steps === "string" ? [steps] : steps).includes(operation.step) || !["prepared", "submitted", "confirmed"].includes(operation.state))
+        throw error61;
+      if (expected.verb === "deliver" && selected.delivery && selected.delivery.manifestHash !== expected.manifestHash)
+        throw new TasksValidationError(
+          "The server recorded a different delivery manifest; refusing to continue."
+        );
+      prepared = {
+        operation,
+        milestone: { id: selected.id, workOrderId: selected.workOrderId }
+      };
+      resumedFromServer = true;
+    }
+    const result = await execute(
+      prepared,
+      expected,
+      idempotencyKey,
+      authorizationExposed,
+      beforeSign
+    );
+    return resumedFromServer ? { ...result, resumedFromServer: true } : result;
+  }
   async function verifyReceipt(operation, expected, hash5) {
     const rpc = rpcFor(expected.deployment.chainId);
     const receipt = await rpc.waitForTransactionReceipt({ hash: hash5, confirmations });
@@ -40504,6 +40547,7 @@ function createTasksChain(options) {
       throw new TasksValidationError(
         "The RPC transaction input does not match the verified task plan."
       );
+    return receipt.blockNumber.toString();
   }
   async function retryConflict(call2) {
     let waited = 0;
@@ -40531,6 +40575,7 @@ function createTasksChain(options) {
       current = { ...initial, operation: live };
     let broadcast = current.operation.state === "submitted";
     let txHash = current.operation.transactionHash ?? void 0;
+    let blockNumber;
     const operationId = initial.operation.id;
     function checkTransition(previous, next) {
       if (previous !== next && !(previous === "approve-usdc" && next === afterApproval))
@@ -40566,7 +40611,7 @@ function createTasksChain(options) {
           if (!operation.transactionHash)
             throw new TasksValidationError("The confirmed task operation has no transaction hash.");
           if (!checkpoint) {
-            await verifyReceipt(operation, expected, operation.transactionHash);
+            blockNumber = await verifyReceipt(operation, expected, operation.transactionHash);
             await pending.complete(operation.id, operation.step, current);
           }
           const fresh = await order(expected.milestone.workOrderId);
@@ -40575,7 +40620,12 @@ function createTasksChain(options) {
           );
           if (!resultMilestone)
             throw new TasksValidationError("The reconciled task milestone is unavailable.");
-          return { txHash: operation.transactionHash, operation, milestone: resultMilestone };
+          return {
+            txHash: operation.transactionHash,
+            operation,
+            milestone: resultMilestone,
+            blockNumber
+          };
         }
         const rpc = rpcFor(expected.deployment.chainId);
         if (operation.state === "prepared") {
@@ -40771,7 +40821,7 @@ function createTasksChain(options) {
         }
         if (operation.state !== "submitted" || !operation.transactionHash)
           throw new TasksValidationError("The task operation has no submitted transaction.");
-        await verifyReceipt(operation, expected, operation.transactionHash);
+        blockNumber = await verifyReceipt(operation, expected, operation.transactionHash);
         const reconciled = await retryConflict(
           () => client.reconcileOperation(
             operation.id,
@@ -40794,6 +40844,7 @@ function createTasksChain(options) {
         if (reconciled.operation.state !== "confirmed" && !(operation.step === "approve-usdc" && reconciled.operation.state === "prepared" && reconciled.operation.step === afterApproval))
           throw new TasksValidationError("The task transaction was not reconciled.");
         await pending.complete(operation.id, operation.step, reconciled);
+        if (reconciled.operation.step !== operation.step) blockNumber = void 0;
         current = reconciled;
       }
       throw new TasksValidationError("The task operation exceeded its allowed step transitions.");
@@ -40828,14 +40879,16 @@ function createTasksChain(options) {
         );
       const prepareKey = await preparation(input2, verb, { evidenceHash: input2.evidenceHash });
       const call2 = verb === "dispute" ? client.disputeEscrow.bind(client) : client.counterEvidenceEscrow.bind(client);
-      return await execute(
-        await call2(
+      return await prepareOrResume(
+        () => call2(
           input2.escrowId,
           { evidenceHash: input2.evidenceHash },
           { idempotencyKey: prepareKey }
         ),
         { ...expected, evidenceHash: input2.evidenceHash },
         prepareKey,
+        verb === "dispute" ? "escrow-dispute" : "escrow-counter-evidence",
+        expected.steps,
         exposed,
         input2.beforeSign
       );
@@ -40855,11 +40908,34 @@ function createTasksChain(options) {
       await options.bindings.put(binding);
     },
     createEscrow: (input2) => safe(async () => {
-      const workOrder = await order(input2.orderId);
+      let workOrder = await order(input2.orderId);
       const ready = await deployment();
-      const prepared = await client.createEscrow(input2.orderId, {
-        idempotencyKey: input2.idempotencyKey
-      });
+      let prepared;
+      let resumedFromServer = false;
+      try {
+        prepared = await client.createEscrow(input2.orderId, {
+          idempotencyKey: input2.idempotencyKey
+        });
+      } catch (error61) {
+        if (!uncertainPreparation(error61)) throw error61;
+        const fresh = await order(input2.orderId);
+        const candidates = fresh.milestones.filter((item) => {
+          const previous = workOrder.milestones.find((prior) => prior.id === item.id);
+          const operation = item.chainOperation;
+          return item.workOrderId === input2.orderId && previous && operation && operation.kind === "escrow-create" && operation.step === "create-escrow" && (previous.escrowState === null || previous.chainOperation?.id === operation.id);
+        });
+        if (candidates.length !== 1) throw error61;
+        const selected2 = candidates[0];
+        prepared = {
+          operation: selected2.chainOperation,
+          milestone: {
+            id: selected2.id,
+            workOrderId: selected2.workOrderId
+          }
+        };
+        workOrder = fresh;
+        resumedFromServer = true;
+      }
       const selected = workOrder.milestones.find((item) => item.id === prepared.milestone.id);
       if (!selected || selected.workOrderId !== input2.orderId)
         throw new TasksValidationError(
@@ -40869,11 +40945,12 @@ function createTasksChain(options) {
         { escrowId: selected.id, idempotencyKey: input2.idempotencyKey },
         "createEscrow"
       );
-      return await execute(
+      const result = await execute(
         prepared,
         await expectation(selected, ready, "createEscrow", ["create-escrow"], input2.counterparty),
         prepareKey
       );
+      return resumedFromServer ? { ...result, resumedFromServer: true } : result;
     }),
     async fund(input2) {
       let exposed = true;
@@ -40961,10 +41038,14 @@ function createTasksChain(options) {
         }
         exposed = true;
         await pending.markExposure(selected.id);
-        const prepared = await client.fundEscrow(input2.escrowId, body, {
-          idempotencyKey: prepareKey
-        });
-        return await execute(prepared, expected, prepareKey, exposed);
+        return await prepareOrResume(
+          () => client.fundEscrow(input2.escrowId, body, { idempotencyKey: prepareKey }),
+          expected,
+          prepareKey,
+          "escrow-funding",
+          expected.steps,
+          exposed
+        );
       } catch (cause) {
         throw chainError(cause, false, exposed);
       }
@@ -40989,22 +41070,26 @@ function createTasksChain(options) {
         manifest: frozen.manifest,
         note: input2.note
       });
-      const prepared = await client.deliverEscrow(
-        input2.escrowId,
-        { fileIds: frozen.manifest.files.map((file2) => file2.fileId), note: input2.note },
-        { idempotencyKey: prepareKey }
-      );
-      if (prepared.delivery.manifestHash !== frozen.manifestHash)
-        throw new TasksValidationError(
-          "The server task delivery manifest hash does not match the local manifest."
-        );
-      return await execute(
-        prepared,
+      return await prepareOrResume(
+        async () => {
+          const prepared = await client.deliverEscrow(
+            input2.escrowId,
+            { fileIds: frozen.manifest.files.map((file2) => file2.fileId), note: input2.note },
+            { idempotencyKey: prepareKey }
+          );
+          if (prepared.delivery.manifestHash !== frozen.manifestHash)
+            throw new TasksValidationError(
+              "The server task delivery manifest hash does not match the local manifest."
+            );
+          return prepared;
+        },
         {
           ...expected,
           manifestHash: frozen.manifestHash
         },
-        prepareKey
+        prepareKey,
+        "escrow-delivery",
+        "submit-delivery"
       );
     }),
     release: (input2) => safe(async () => {
@@ -41018,10 +41103,12 @@ function createTasksChain(options) {
         input2.counterparty
       );
       const prepareKey = await preparation(input2, "release");
-      return await execute(
-        await client.releaseEscrow(input2.escrowId, { idempotencyKey: prepareKey }),
+      return await prepareOrResume(
+        () => client.releaseEscrow(input2.escrowId, { idempotencyKey: prepareKey }),
         expected,
-        prepareKey
+        prepareKey,
+        "escrow-release",
+        "release-funds"
       );
     }),
     refund: (input2) => safe(async () => {
@@ -41035,10 +41122,12 @@ function createTasksChain(options) {
         input2.counterparty
       );
       const prepareKey = await preparation(input2, "refund");
-      return await execute(
-        await client.refundEscrow(input2.escrowId, { idempotencyKey: prepareKey }),
+      return await prepareOrResume(
+        () => client.refundEscrow(input2.escrowId, { idempotencyKey: prepareKey }),
         expected,
-        prepareKey
+        prepareKey,
+        "escrow-release",
+        "refund-buyer"
       );
     }),
     disputeFee: (input2) => safe(async () => {
@@ -41066,16 +41155,21 @@ function createTasksChain(options) {
         input2.counterparty
       );
       const prepareKey = await preparation(input2, "resolve-unmatched");
-      return execute(
-        await client.resolveUnmatchedEscrow(input2.escrowId, { idempotencyKey: prepareKey }),
+      return prepareOrResume(
+        () => client.resolveUnmatchedEscrow(input2.escrowId, { idempotencyKey: prepareKey }),
         expected,
-        prepareKey
+        prepareKey,
+        "escrow-unmatched-resolution",
+        "resolve-unmatched-dispute"
       );
     }),
     signScopeMessage: (message) => safe(() => account.signMessage({ message }))
   };
 }
 var chainError = safeTasksChainError;
+function uncertainPreparation(error61) {
+  return error61 instanceof TasksClientError && ((error61.status ?? 0) >= 400 || error61.code === "network" || error61.code === "timeout");
+}
 function retryDelay(header, now) {
   if (/^\d+(?:\.\d+)?$/u.test(header.trim())) return Math.max(1, Math.ceil(Number(header) * 1e3));
   const date5 = Date.parse(header);
@@ -41092,6 +41186,60 @@ function alreadySent(error61) {
   return error61 instanceof Error && /already known|known transaction|nonce (?:is )?too low/iu.test(error61.message);
 }
 
+// src/tasks/wait.ts
+async function waitForMilestone(client, input2) {
+  const timeoutMs = input2.timeoutMs ?? 12e4;
+  const intervalMs = input2.intervalMs ?? 3e3;
+  if (!Number.isFinite(timeoutMs) || timeoutMs < 0)
+    throw new RangeError("The milestone wait timeout must be non-negative and finite.");
+  if (!Number.isFinite(intervalMs) || intervalMs <= 0)
+    throw new RangeError("The milestone wait interval must be positive and finite.");
+  const sleep = input2.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+  const now = input2.now ?? (() => /* @__PURE__ */ new Date());
+  const started = now().getTime();
+  const deadline = started + timeoutMs;
+  let polls = 0;
+  let milestone;
+  function result(reached) {
+    return { reached, milestone, polls, elapsedMs: now().getTime() - started };
+  }
+  for (; ; ) {
+    const remaining = deadline - now().getTime();
+    if (remaining <= 0) return result(false);
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), remaining);
+    let response;
+    polls++;
+    try {
+      response = await client.getOrder(input2.orderId, { signal: controller.signal });
+    } catch (error61) {
+      if (controller.signal.aborted) return result(false);
+      throw error61;
+    } finally {
+      clearTimeout(timer);
+    }
+    if (controller.signal.aborted || now().getTime() >= deadline) return result(false);
+    const { workOrder } = response;
+    milestone = workOrder.id === input2.orderId && workOrder.version === "work-order-view-v1" ? workOrder.milestones.find(
+      (item) => item.id === input2.milestoneId && item.workOrderId === input2.orderId
+    ) : void 0;
+    if (milestone && reachedTarget(milestone, input2.target)) return result(true);
+    await sleep(Math.min(intervalMs, deadline - now().getTime()));
+  }
+}
+function reachedTarget(milestone, target) {
+  switch (target) {
+    case "created":
+      return milestone.escrowState !== null;
+    case "locked":
+      return ["locked", "submitted", "disputed", "resolved"].includes(milestone.escrowState ?? "");
+    case "delivered":
+      return ["submitted", "disputed", "resolved"].includes(milestone.escrowState ?? "");
+    case "released":
+      return milestone.escrowState === "resolved";
+  }
+}
+
 // src/tasks/rpc.ts
 function createTasksRpcFor(config2, options = {}) {
   const clients = /* @__PURE__ */ new Map();
@@ -42949,7 +43097,10 @@ async function taskRequest(verb, route, operation, options) {
           "not_signed_in",
           `${verb} needs sign-in. ${options.signInHint}`
         );
-      throw new TaskOperationError(error61.serverCode ?? error61.code, error61.message);
+      throw new TaskOperationError(
+        error61.serverCode ?? (error61.status ? `http_${error61.status}` : error61.code),
+        error61.message
+      );
     }
     throw error61;
   }
@@ -43070,7 +43221,8 @@ function proposalTerms(id, address3, deployment, terms) {
   return {
     version: "work-proposal-v1",
     workOrderId: id,
-    providerAddress: address3,
+    // The server lowercases addresses before canonicalizing the signed payload.
+    providerAddress: address3.toLowerCase(),
     pricingModel: "fixed",
     milestones: [
       {
@@ -43457,6 +43609,55 @@ async function showTask(context, input2) {
   };
 }
 async function taskStatus(context, input2) {
+  if (input2.signedIn) {
+    const chainState = await taskRequest(
+      "status",
+      "chainState",
+      async () => {
+        try {
+          return await context.client.chainState(input2.id);
+        } catch (error61) {
+          if (error61 instanceof TasksClientError && error61.status === 404) {
+            if (isMissingTaskEntity(error61.serverCode, error61.message))
+              throw new TaskOperationError("not_found", error61.message);
+            throw new TaskOperationError(
+              "not_available",
+              "GET /v1/work-orders/:id/chain-state is not available on this server."
+            );
+          }
+          throw error61;
+        }
+      },
+      context
+    );
+    if (chainState.workOrderId !== input2.id)
+      throw new TaskOperationError("invalid_response", "The response belongs to a different task.");
+    const page = await taskRequest(
+      "status",
+      "events",
+      async () => {
+        try {
+          return await context.client.events(input2.id, { wait: 0 });
+        } catch (error61) {
+          if (error61 instanceof TasksClientError && error61.status === 404) {
+            if (isMissingTaskEntity(error61.serverCode, error61.message)) return null;
+            throw new TaskOperationError(
+              "not_available",
+              "GET /v1/work-orders/:id/events is not available on this server."
+            );
+          }
+          throw error61;
+        }
+      },
+      context
+    );
+    return {
+      task: { id: input2.id },
+      chainState,
+      events: page ? [...page.events].sort((a, b) => a.sequence - b.sequence) : null,
+      nextAfter: page?.nextAfter ?? null
+    };
+  }
   const task = await taskRequest(
     "status",
     "publicTask",
@@ -43901,6 +44102,7 @@ export {
   taskStateMatches,
   taskStatus,
   threadTask,
-  validTaskBrief
+  validTaskBrief,
+  waitForMilestone
 };
 //# sourceMappingURL=tasks.js.map