@dypai-ai/mcp 1.6.11 → 1.6.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dypai-ai/mcp",
-  "version": "1.6.11",
+  "version": "1.6.12",
   "description": "DYPAI MCP Server — AI agent toolkit for building and deploying full-stack apps",
   "type": "module",
   "main": "src/index.js",

package/src/tools/sync/test-endpoint.js

@@ -105,10 +105,12 @@ async function resolveLocal(rootDir, endpoint, mapsCtx, projectId = null) {
     return {
       workflow_code: effective.data.workflowCode,
       workflowSource: entry.source === "flow" ? "flow" : "legacy-yaml",
+      method: entry.method || effective.data.method || "GET",
       source: {
         mode: "local",
         file: entry.file || `flows/${endpoint}.flow.ts`,
         workflowSource: entry.source === "flow" ? "flow" : "legacy-yaml",
+        method: entry.method || effective.data.method || "GET",
       },
     }
   }
@@ -198,18 +200,20 @@ async function resolveDraft(projectId, endpoint) {
   }
   return {
     workflow_code,
+    method: payload.method || match.method || "GET",
     source: {
       mode: "draft",
       draft_id: match.id,
       created_at: match.created_at,
       created_by: match.created_by,
+      method: payload.method || match.method || "GET",
     },
   }
 }
 
 async function resolveLive(projectId, endpoint) {
   // Look up the deployed row directly. system.endpoints.workflow_code is jsonb.
-  const sql = `SELECT id, name, workflow_code, updated_at
+  const sql = `SELECT id, name, method, workflow_code, updated_at
                FROM system.endpoints
                WHERE name = '${endpoint.replace(/'/g, "''")}'
                LIMIT 1`
@@ -237,10 +241,12 @@ async function resolveLive(projectId, endpoint) {
   }
   return {
     workflow_code,
+    method: row.method || "GET",
     source: {
       mode: "live",
       endpoint_id: row.id,
       updated_at: row.updated_at,
+      method: row.method || "GET",
     },
   }
 }
@@ -288,6 +294,8 @@ async function resolveEndpointWorkflow({ endpoint, mode, rootDir, targetProjectI
 
 function buildSourceMeta(mode, resolved) {
   const sourceMeta = { mode }
+  const method = String(resolved.method || resolved.source?.method || "GET").toUpperCase()
+  sourceMeta.method = method
   if (mode === "local") {
     sourceMeta.file = resolved.source.file
     sourceMeta.workflowSource = resolved.workflowSource || resolved.source.workflowSource || "legacy-yaml"
@@ -302,6 +310,68 @@ function buildSourceMeta(mode, resolved) {
   return sourceMeta
 }
 
+function sdkError(message, extra = {}) {
+  return {
+    message: String(message || "Endpoint execution failed"),
+    ...extra,
+  }
+}
+
+export function endpointResultFromDebugResponse(response) {
+  if (!response || typeof response !== "object" || Array.isArray(response)) {
+    return response
+  }
+
+  // Engine debug responses wrap the public endpoint body in `result` and add
+  // debug-only metadata beside it. The SDK only exposes the public body under
+  // `data`, never the debug wrapper.
+  if (
+    Object.prototype.hasOwnProperty.call(response, "result")
+    && (
+      Object.prototype.hasOwnProperty.call(response, "execution")
+      || Object.prototype.hasOwnProperty.call(response, "trace")
+      || Object.prototype.hasOwnProperty.call(response, "execution_id")
+    )
+  ) {
+    return response.result
+  }
+
+  return response
+}
+
+export function sdkResponseFromEndpointTest(response) {
+  return {
+    data: endpointResultFromDebugResponse(response),
+    error: null,
+  }
+}
+
+function failedSdkResponse(message, extra = {}) {
+  return {
+    data: null,
+    error: sdkError(message, extra),
+  }
+}
+
+export function frontendUsageForEndpoint({ endpoint, method = "GET", input = {} } = {}) {
+  const httpMethod = String(method || "GET").toUpperCase()
+  const sdkMethod = httpMethod.toLowerCase()
+  const usesBody = ["POST", "PUT", "PATCH"].includes(httpMethod)
+  const hasInput = input && typeof input === "object" && !Array.isArray(input) && Object.keys(input).length > 0
+
+  return {
+    sdk_contract: "DYPAI SDK methods return { data, error }. The endpoint response body is inside data.",
+    correct_pattern: usesBody
+      ? `const { data, error } = await dypai.api.${sdkMethod}(${JSON.stringify(endpoint)}, body); if (error) throw error;`
+      : `const { data, error } = await dypai.api.${sdkMethod}(${JSON.stringify(endpoint)}, { params }); if (error) throw error;`,
+    params_or_body: usesBody
+      ? "For this HTTP method, pass request fields as the body argument."
+      : "For GET/DELETE endpoints, pass filters/query fields inside { params }.",
+    tested_input: hasInput ? input : undefined,
+    do_not: "Do not read endpoint fields from the top-level SDK response (for example res.items). Use data?.items.",
+  }
+}
+
 // ─── Tool ───────────────────────────────────────────────────────────────────
 
 export const dypaiTestEndpointTool = {
@@ -507,6 +577,8 @@ export const dypaiTestEndpointTool = {
           endpoint,
           source: sourceMetaRun,
           as_user: as_user || null,
+          sdk_response: failedSdkResponse(result),
+          frontend_usage: frontendUsageForEndpoint({ endpoint, method: sourceMetaRun.method, input }),
           error: result.length > 2000 ? result.slice(0, 2000) + "...[truncated]" : result,
           hint: "The remote returned a raw error string (no per-node trace available). Read the error above for the root cause.",
         }
@@ -517,6 +589,8 @@ export const dypaiTestEndpointTool = {
           endpoint,
           source: sourceMetaRun,
           as_user: as_user || null,
+          sdk_response: failedSdkResponse(`Unexpected response type from remote test_workflow: ${typeof result}`),
+          frontend_usage: frontendUsageForEndpoint({ endpoint, method: sourceMetaRun.method, input }),
           error: `Unexpected response type from remote test_workflow: ${typeof result}`,
           raw_response: result,
         }
@@ -536,6 +610,8 @@ export const dypaiTestEndpointTool = {
         endpoint,
         source: sourceMetaRun,
         as_user: as_user || null,
+        sdk_response: sdkResponseFromEndpointTest(result),
+        frontend_usage: frontendUsageForEndpoint({ endpoint, method: sourceMetaRun.method, input }),
         ...(stopAtStep ? { stop_at_step: stopAtStep } : {}),
         ...(step_outputs && Object.keys(step_outputs).length ? { step_outputs } : {}),
         ...safeSummary,
@@ -549,6 +625,8 @@ export const dypaiTestEndpointTool = {
         error: `Execution failed: ${e.message}`,
         endpoint,
         source: sourceMetaRun,
+        sdk_response: failedSdkResponse(e.message),
+        frontend_usage: frontendUsageForEndpoint({ endpoint, method: sourceMetaRun.method, input }),
         hint: stopAtStep
           ? "Verify stop_at_step with operation:'list_steps'. For full trace use trace_mode:'full'."
           : "If the error is cryptic, try trace_mode: 'full' or search_logs with include_trace:true.",