@superblocksteam/vite-plugin-file-sync 2.0.105-next.0 → 2.0.105-next.2

package/dist/ai-service/agent/middleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../src/ai-service/agent/middleware.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAUnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAIxD,eAAO,MAAM,wBAAwB,QAAS,CAAC;AAC/C;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,GAAE,MAAiC,GAC1C,cAAc,CA0BhB;AA0BD;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,CAAC,EAAE;IACjD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,cAAc,CAsCjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KAEjB,CAAC;CACH;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAiBhE;AAuND;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CA0BpE"}
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../src/ai-service/agent/middleware.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAWnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAIxD,eAAO,MAAM,wBAAwB,QAAS,CAAC;AAC/C;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,GAAE,MAAiC,GAC1C,cAAc,CA0BhB;AA4DD;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,CAAC,EAAE;IACjD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,cAAc,CAsCjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KAEjB,CAAC;CACH;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAiBhE;AA0ND;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CA0BpE"}

package/dist/ai-service/agent/middleware.js

@@ -3,6 +3,7 @@ import { scanContentForSecrets, SecretRedactor } from "../security/index.js";
 import { getApiDocsToolFactory } from "./tools/apis/get-api-docs.js";
 import { testApiToolFactory } from "./tools/apis/test-api.js";
 import { buildCaptureScreenshotToolFactory } from "./tools/build-capture-screenshot.js";
+import { buildDebugToolFactory } from "./tools/build-debug.js";
 import { buildReadFileToolFactory } from "./tools/build-read-file.js";
 import { executeRequestToIntegrationToolFactory } from "./tools/index.js";
 import { grepToolFactory } from "./tools2/tools/grep.js";
@@ -62,6 +63,7 @@ const SECRET_SCAN_ENABLED_TOOLS = new Set([
 ]);
 const TOOL_LOG_SUMMARY_NAMES = {
     buildCaptureScreenshot: buildCaptureScreenshotToolFactory.name,
+    buildDebug: buildDebugToolFactory.name,
     buildReadFile: buildReadFileToolFactory.name,
     executeRequestToIntegration: executeRequestToIntegrationToolFactory.name,
     getApiDocs: getApiDocsToolFactory.name,
@@ -69,6 +71,34 @@ const TOOL_LOG_SUMMARY_NAMES = {
     testApi: testApiToolFactory.name,
     webFetch: webFetchToolFactory.name,
 };
+function summarizeBuildDebugResult(result) {
+    if (!result || typeof result !== "object" || Array.isArray(result)) {
+        const outputChars = typeof result === "string"
+            ? result.length
+            : safeJsonStringify(result).length;
+        return {
+            fallback: true,
+            outputChars,
+            type: Array.isArray(result) ? "array" : typeof result,
+        };
+    }
+    const root = result;
+    const typeErrors = typeof root.typeErrors === "string" ? root.typeErrors : undefined;
+    const buildSystemErrors = Array.isArray(root.buildSystemErrors)
+        ? root.buildSystemErrors
+        : undefined;
+    const runtimeErrors = Array.isArray(root.runtimeErrors)
+        ? root.runtimeErrors
+        : undefined;
+    const message = typeof root.message === "string" ? root.message : undefined;
+    return {
+        status: root.status,
+        typeErrorChars: typeErrors?.length ?? 0,
+        buildErrorCount: buildSystemErrors?.length ?? 0,
+        runtimeErrorCount: runtimeErrors?.length ?? 0,
+        messageChars: message?.length ?? 0,
+    };
+}
 /**
  * Middleware to scan and redact secrets from tool outputs.
  *
@@ -166,6 +196,9 @@ function summarizeToolResultForLogs(toolName, result) {
     if (toolName === TOOL_LOG_SUMMARY_NAMES.buildCaptureScreenshot) {
         return summarizeScreenshotResult(result);
     }
+    if (toolName === TOOL_LOG_SUMMARY_NAMES.buildDebug) {
+        return summarizeBuildDebugResult(result);
+    }
     const sanitizedResult = sanitizeLogObject(result);
     const serializedSanitizedResult = JSON.stringify(sanitizedResult);
     const fallbackSummary = (type) => ({

package/dist/ai-service/agent/middleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../../src/ai-service/agent/middleware.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../../src/ai-service/agent/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,iCAAiC,EAAE,MAAM,qCAAqC,CAAC;AACxF,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,sCAAsC,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAGvD,yGAAyG;AACzG,uDAAuD;AACvD,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC;AAC/C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAC3B,WAAmB,wBAAwB;IAE3C,OAAO,CAAC,IAAI,EAAE,EAAE;QACd,OAAO;YACL,GAAG,IAAI;YACP,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;gBAChC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;gBAElD,mEAAmE;gBACnE,IAAI,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;oBACzD,OAAO,MAAM,CAAC;gBAChB,CAAC;gBAED,0BAA0B;gBAC1B,MAAM,YAAY,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;gBAC/C,IAAI,YAAY,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;oBACnC,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;oBAClD,OAAO,oBAAoB,YAAY,CAAC,MAAM,+BAA+B,QAAQ;;EAE7F,SAAS;UACD,CAAC;gBACH,CAAC;gBAED,OAAO,MAAM,CAAC;YAChB,CAAC;SACF,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAC;IACxC,wBAAwB,CAAC,IAAI;IAC7B,kBAAkB,CAAC,IAAI;IACvB,sCAAsC,CAAC,IAAI;CAC5C,CAAC,CAAC;AAEH,MAAM,sBAAsB,GAAG;IAC7B,sBAAsB,EAAE,iCAAiC,CAAC,IAAI;IAC9D,UAAU,EAAE,qBAAqB,CAAC,IAAI;IACtC,aAAa,EAAE,wBAAwB,CAAC,IAAI;IAC5C,2BAA2B,EAAE,sCAAsC,CAAC,IAAI;IACxE,UAAU,EAAE,qBAAqB,CAAC,IAAI;IACtC,IAAI,EAAE,eAAe,CAAC,IAAI;IAC1B,OAAO,EAAE,kBAAkB,CAAC,IAAI;IAChC,QAAQ,EAAE,mBAAmB,CAAC,IAAI;CAC1B,CAAC;AAEX,SAAS,yBAAyB,CAAC,MAAe;IAChD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnE,MAAM,WAAW,GACf,OAAO,MAAM,KAAK,QAAQ;YACxB,CAAC,CAAC,MAAM,CAAC,MAAM;YACf,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;QACvC,OAAO;YACL,QAAQ,EAAE,IAAI;YACd,WAAW;YACX,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,MAAM;SACtD,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,MAAiC,CAAC;IAC/C,MAAM,UAAU,GACd,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;IACpE,MAAM,iBAAiB,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC;QAC7D,CAAC,CAAC,IAAI,CAAC,iBAAiB;QACxB,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC;QACrD,CAAC,CAAC,IAAI,CAAC,aAAa;QACpB,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,OAAO,GAAG,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAE5E,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,cAAc,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;QACvC,eAAe,EAAE,iBAAiB,EAAE,MAAM,IAAI,CAAC;QAC/C,iBAAiB,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;QAC7C,YAAY,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;KACnC,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAGxC;IACC,MAAM,EAAE,OAAO,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IAElD,OAAO,CAAC,IAAI,EAAE,EAAE;QACd,mDAAmD;QACnD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,IAAI,CAAC;QACd,CAAC;QAED,iDAAiD;QACjD,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO;YACL,GAAG,IAAI;YACP,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE;gBACvC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;gBAEzD,wCAAwC;gBACxC,MAAM,YAAY,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;gBAE/C,8BAA8B;gBAC9B,MAAM,UAAU,GAAG,MAAM,qBAAqB,CAAC,YAAY,EAAE;oBAC3D,OAAO;iBACR,CAAC,CAAC;gBAEH,8CAA8C;gBAC9C,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;oBAC3B,OAAO,MAAM,CAAC;gBAChB,CAAC;gBAED,iCAAiC;gBACjC,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;gBACzD,OAAO,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YACrC,CAAC;SACF,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAgBD;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO;YACL,KAAK,EAAE;gBACL,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC;gBAC1C,qDAAqD;aACtD;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAE;YACL,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;SAC3C;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,yBAAyB,CAAC,MAAe;IAChD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnE,OAAO;YACL,QAAQ,EAAE,IAAI;YACd,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,MAAM;SACtD,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,MAAiC,CAAC;IAC/C,MAAM,OAAO,GAAG,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAE5E,OAAO;QACL,YAAY,EAAE,OAAO,EAAE,MAAM;QAC7B,gBAAgB,EAAE,OAAO,IAAI,CAAC,aAAa,KAAK,QAAQ;QACxD,QAAQ,EAAE,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;QACvE,QAAQ,EAAE,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;KACxE,CAAC;AACJ,CAAC;AAED,SAAS,0BAA0B,CACjC,QAAgB,EAChB,MAAe;IAEf,6EAA6E;IAC7E,2EAA2E;IAC3E,wEAAwE;IACxE,IAAI,QAAQ,KAAK,sBAAsB,CAAC,sBAAsB,EAAE,CAAC;QAC/D,OAAO,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,QAAQ,KAAK,sBAAsB,CAAC,UAAU,EAAE,CAAC;QACnD,OAAO,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,eAAe,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,yBAAyB,GAAG,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IAClE,MAAM,eAAe,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC;QACzC,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,yBAAyB,EAAE,MAAM,IAAI,CAAC;QACnD,IAAI;KACL,CAAC,CAAC;IAEH,IAAI,QAAQ,KAAK,sBAAsB,CAAC,aAAa,EAAE,CAAC;QACtD,IAAI,OAAO,eAAe,KAAK,QAAQ,EAAE,CAAC;YACxC,OAAO,eAAe,CACpB,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,eAAe,CAClE,CAAC;QACJ,CAAC;QAED,MAAM,YAAY,GAAG,CAAC,GAAG,eAAe,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAAC;QACxE,MAAM,eAAe,GAAG,eAAe,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;QACtE,OAAO;YACL,WAAW,EAAE,eAAe,CAAC,MAAM;YACnC,UAAU,EAAE,YAAY,CAAC,MAAM;YAC/B,UAAU,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;SAC1E,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,KAAK,sBAAsB,CAAC,2BAA2B,EAAE,CAAC;QACpE,IACE,CAAC,eAAe;YAChB,OAAO,eAAe,KAAK,QAAQ;YACnC,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,EAC9B,CAAC;YACD,OAAO,eAAe,CACpB,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,eAAe,CAClE,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,eAA0C,CAAC;QACxD,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC;QAChC,MAAM,YAAY,GAChB,WAAW;YACX,OAAO,WAAW,KAAK,QAAQ;YAC/B,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;YACzB,CAAC,CAAE,WAAuC;YAC1C,CAAC,CAAC,SAAS,CAAC;QAChB,MAAM,OAAO,GACX,YAAY,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC;YACjD,CAAC,CAAC,YAAY,CAAC,OAAO;YACtB,CAAC,CAAC,SAAS,CAAC;QAEhB,OAAO;YACL,SAAS,EAAE,WAAW,KAAK,SAAS;YACpC,SAAS,EAAE,IAAI,CAAC,SAAS,KAAK,IAAI;YAClC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;YACrD,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;gBACrC,CAAC,CAAC,WAAW,CAAC,MAAM;gBACpB,CAAC,CAAC,OAAO,EAAE,MAAM;SACpB,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,KAAK,sBAAsB,CAAC,IAAI,EAAE,CAAC;QAC7C,IACE,CAAC,eAAe;YAChB,OAAO,eAAe,KAAK,QAAQ;YACnC,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,EAC9B,CAAC;YACD,OAAO,eAAe,CACpB,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,eAAe,CAClE,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,eAA0C,CAAC;QACxD,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChD,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,WAAW,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;SACtC,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,KAAK,sBAAsB,CAAC,QAAQ,EAAE,CAAC;QACjD,IACE,CAAC,eAAe;YAChB,OAAO,eAAe,KAAK,QAAQ;YACnC,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,EAC9B,CAAC;YACD,OAAO,eAAe,CACpB,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,eAAe,CAClE,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,eAA0C,CAAC;QACxD,MAAM,OAAO,GAAG,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5E,OAAO;YACL,YAAY,EAAE,OAAO,EAAE,MAAM;YAC7B,UAAU,EAAE,IAAI,CAAC,IAAI,KAAK,UAAU;YACpC,WAAW,EACT,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ;gBAC9D,CAAC,CAAC,IAAI,CAAC,WAAW;gBAClB,CAAC,CAAC,SAAS;SAChB,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,KAAK,sBAAsB,CAAC,UAAU,EAAE,CAAC;QACnD,IACE,CAAC,eAAe;YAChB,OAAO,eAAe,KAAK,QAAQ;YACnC,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,EAC9B,CAAC;YACD,OAAO,eAAe,CACpB,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,eAAe,CAClE,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,eAA0C,CAAC;QACxD,MAAM,aAAa,GACjB,OAAO,IAAI,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1E,MAAM,gBAAgB,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC;YAC3D,CAAC,CAAC,IAAI,CAAC,gBAAgB;YACvB,CAAC,CAAC,SAAS,CAAC;QACd,OAAO;YACL,kBAAkB,EAAE,aAAa,EAAE,MAAM;YACzC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,aAAa,EAAE,gBAAgB,EAAE,MAAM;YACvC,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,KAAK,sBAAsB,CAAC,OAAO,EAAE,CAAC;QAChD,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,IACE,CAAC,eAAe;QAChB,OAAO,eAAe,KAAK,QAAQ;QACnC,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,EAC9B,CAAC;QACD,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,MAAM,IAAI,GAAG,eAA0C,CAAC;IACxD,MAAM,YAAY,GAChB,IAAI,CAAC,MAAM;QACX,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ;QAC/B,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;QACzB,CAAC,CAAE,IAAI,CAAC,MAAkC;QAC1C,CAAC,CAAC,SAAS,CAAC;IAEhB,oFAAoF;IACpF,MAAM,QAAQ,GAAG,YAAY,IAAI,CAAC,CAAC,aAAa,IAAI,YAAY,CAAC,CAAC;IAElE,MAAM,WAAW,GACf,CAAC,QAAQ;QACT,YAAY,EAAE,WAAW;QACzB,OAAO,YAAY,CAAC,WAAW,KAAK,QAAQ;QAC5C,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,WAAW,CAAC;QACtC,CAAC,CAAE,YAAY,CAAC,WAAuC;QACvD,CAAC,CAAC,SAAS,CAAC;IAEhB,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,MAAM,EAAE,YAAY;YAClB,CAAC,CAAC;gBACE,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC;oBAC5C,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM;oBAC5B,CAAC,CAAC,YAAY,CAAC,KAAK,KAAK,SAAS;wBAChC,CAAC,CAAC,CAAC;wBACH,CAAC,CAAC,SAAS;gBACf,aAAa,EAAE,YAAY,CAAC,aAAa;gBACzC,UAAU,EACR,YAAY,CAAC,OAAO,KAAK,SAAS,IAAI,YAAY,CAAC,OAAO,KAAK,IAAI;gBACrE,cAAc,EAAE,OAAO,CAAC,WAAW,CAAC;gBACpC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS;gBACjE,eAAe,EAAE,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBAClE,OAAO,EAAE,YAAY,CAAC,OAAO;aAC9B;YACH,CAAC,CAAC,SAAS;KACd,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAc;IAClD,OAAO,CAAC,IAAI,EAAE,EAAE;QACd,OAAO;YACL,GAAG,IAAI;YACP,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,cAAc;gBACjC,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,KAAK,EAAE,KAAK,CAAC,CAAC;gBAE5C,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;oBAC3D,MAAM,CAAC,IAAI,CACT,SAAS,IAAI,CAAC,IAAI,KAAK,EACvB,0BAA0B,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAC9C,CAAC;oBACF,OAAO,MAAM,CAAC;gBAChB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,oEAAoE;oBACpE,MAAM,SAAS,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;oBAC3C,MAAM,OAAO,GAAG,SAAS,IAAI,CAAC,IAAI,OAAO,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;oBACnE,MAAM,QAAQ,GACZ,KAAK,YAAY,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;oBACjE,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;oBACrC,MAAM,KAAK,CAAC;gBACd,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/ai-service/agent/prompts/api-prompts.d.ts

@@ -8,7 +8,7 @@
  * YAML-based API prompt section (legacy experience).
  *
  * Uses:
- * - useApi from @superblocksteam/library
+ * - useApi / useApiData / executeApi from @superblocksteam/library
  * - APIs in apis/ApiName/api.yaml
  * - getApiDocs tool is mandatory before API work
  */
@@ -17,8 +17,8 @@ export declare function buildYamlApiSection(): string;
  * SDK-based API prompt section (new experience).
  *
  * Uses:
- * - useApi from @/hooks/useApi.js
- * - APIs in server/apis/ApiName/api.ts
+ * - useApi from @/hooks/useApi.js, useApiData from @/hooks/useApiData.js, executeApi from @/lib/executeApi.js
+ * - API modules under server/apis/ (group by domain or feature, e.g. server/apis/users/get-users.ts; paths are flexible)
  * - SDK READMEs for documentation
  * - Zod schemas and integration IDs
  */

package/dist/ai-service/agent/prompts/api-prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-prompts.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/agent/prompts/api-prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAiJ5C;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAgY3C;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,CAsBhE"}
+{"version":3,"file":"api-prompts.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/agent/prompts/api-prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAkO5C;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAse3C;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,CAiChE"}

package/dist/ai-service/agent/prompts/api-prompts.js

@@ -8,7 +8,7 @@
  * YAML-based API prompt section (legacy experience).
  *
  * Uses:
- * - useApi from @superblocksteam/library
+ * - useApi / useApiData / executeApi from @superblocksteam/library
  * - APIs in apis/ApiName/api.yaml
  * - getApiDocs tool is mandatory before API work
  */
@@ -66,36 +66,41 @@ If the user requests checking user data, like email, ID, this information cannot
 You must NEVER attempt to rely on frontend data for security-critical operations, rely on the injected \`Global\` object in APIs instead.
 </permissions>
 
-APIs MUST be loaded using \`useApi\` from \`@superblocksteam/library\` with the exact API name based on its folder. The hook returns \`{ run, cancel, loading, data, error }\`:
-- \`run(inputs)\` — execute the API imperatively (e.g. on button click)
-- \`cancel()\` — cancel in-flight requests
-- \`loading\` — boolean, true while the most recent call is in flight
-- \`data\` — last successful response (persists across re-runs, stale-while-revalidate)
-- \`error\` — the error from the most recent failed call, or \`undefined\` if the last call succeeded
+APIs MUST be loaded using hooks and utilities from \`@superblocksteam/library\` with the exact API name based on its folder name under apis/. Having apis/<ApiName>/api.yaml, the first argument should be \`<ApiName>\`.
+
+**Three primitives for three use cases:**
+- **\`useApiData\`** — React hook for data loading (reads). Auto-fetches on mount and when inputs change. Has shared cache, stale-while-revalidate, retry, and auto-refetch.
+- **\`useApi\`** — React hook for mutations/actions (writes). Call \`run()\` manually on button click, form submit, etc. No auto-fetch, no cache.
+- **\`executeApi\`** — Plain function for calling APIs outside React (utility functions, event handlers, initialization logic). Returns a Promise.
 
-**Two modes:**
-- **Imperative** — \`const { run, loading, data } = useApi("CreateOrder")\` — call \`run()\` manually
-- **Declarative** — \`const { loading, data } = useApi("GetUsers", { email, name })\` — auto-fetches on mount and when inputs change
+**CRITICAL: Use \`useApiData\` for data loading, \`useApi\` for mutations, and \`executeApi\` outside React components. Do NOT use \`useApi\` with a second argument for data loading — that pattern is deprecated.**
 
-**CRITICAL: Do NOT create custom wrapper hooks around useApi. Do NOT manage loading or data state with separate useState — useApi handles this for you. Do NOT use useRef guards for HMR — declarative mode has built-in double-fetch prevention.**
+**CRITICAL: Do NOT create custom wrapper hooks around these hooks. Do NOT manage loading or data state with separate useState — the hooks handle this for you.**
 
 **CRITICAL: When a user says that an API is not working or has an error, ALWAYS check the API call sites in the application and ensure the inputs are correct! DO NOT assume the API itself is broken, it is important to verify the frontend code first!**
 
 \`\`\`typescript
-// Declarative mode — auto-fetches when inputs change (preferred for data loading)
-import { useApi } from "@superblocksteam/library";
+// Data loading — auto-fetches when inputs change (preferred for reads)
+import { useApiData } from "@superblocksteam/library";
 
-const { loading, data } = useApi("GetUsers", { email: email ?? null, name: name ?? null });
-// \`data\` updates automatically, \`loading\` tracks in-flight state
+const { data, loading, isError, error, fetching } = useApiData("GetUsers", { email: email ?? null, name: name ?? null });
+// \`data\` updates automatically, \`loading\` is true on first fetch with no cached data
+// \`fetching\` is true during any fetch (including background refetch)
+// \`error\` is populated if the fetch fails — no try/catch needed
 // Re-fetches when email or name changes — no useEffect needed
+// IMPORTANT: Always use \`fetching\` to show a loading indicator during refetches
+
+if (loading) return <Skeleton />;
+if (isError) return <ErrorBanner error={error} />;
+return <UserList users={data.users} />;
 \`\`\`
 
 \`\`\`typescript
-// Imperative mode — for event-driven actions (button clicks, form submissions)
+// Mutations — for event-driven actions (button clicks, form submissions)
 import { useApi } from "@superblocksteam/library";
 import { toast } from "sonner";
 
-const { run: createOrder, loading } = useApi("CreateOrder");
+const { run: createOrder, loading, error } = useApi("CreateOrder");
 
 const handleSubmit = useCallback(async () => {
   try {
@@ -110,16 +115,71 @@ const handleSubmit = useCallback(async () => {
 }, [item, qty, createOrder]);
 \`\`\`
 
+\`\`\`typescript
+// Refetch after a mutation — combine useApiData + useApi
+import { useApiData, useApi } from "@superblocksteam/library";
+
+const { data: todos, refetch } = useApiData("GetTodos", {});
+const { run: createTodo } = useApi("CreateTodo");
+
+const handleCreate = async (title: string) => {
+  await createTodo({ title });
+  await refetch(); // Refresh the list after mutation
+};
+\`\`\`
+
+\`\`\`typescript
+// Outside React — utility functions, event handlers, initialization logic
+import { executeApi } from "@superblocksteam/library";
+
+// Simple call — returns a Promise
+const users = await executeApi("GetUsers", { email: "a@b.com" });
+
+// With cancellation
+const controller = new AbortController();
+const data = await executeApi("GetUser", { id: userId }, { signal: controller.signal });
+
+// In a utility function (no React hooks needed)
+async function syncUserData(userId: string) {
+  const user = await executeApi("GetUser", { id: userId });
+  const orders = await executeApi("GetOrders", { userId: user.id });
+  return { user, orders };
+}
+\`\`\`
+
+**\`useApiData\` returns \`{ data, error, status, fetchStatus, loading, fetching, isError, isSuccess, isStale, refetch, cancel }\`:**
+- \`data\` — cached/fetched response (persists across background refetches)
+- \`error\` — error from the last failed fetch (cleared on success)
+- \`loading\` — true when fetching for the first time with no cached data
+- \`fetching\` — true when any fetch is in progress (including background refetch)
+- \`isError\` / \`isSuccess\` — boolean status helpers
+- \`refetch()\` — manually trigger a fresh fetch
+- \`cancel()\` — abort the current in-flight fetch
+
+**\`useApi\` returns \`{ run, cancel, loading, data, error, status, variables, reset }\`:**
+- \`run(inputs)\` — execute the API imperatively
+- \`cancel()\` — cancel in-flight requests
+- \`loading\` — boolean, true while the most recent call is in flight
+- \`data\` — last successful response (persists across re-runs)
+- \`error\` — error from the last failed run (cleared on next success)
+- \`status\` — \`"idle" | "pending" | "success" | "error"\`
+- \`reset()\` — reset state back to idle
+
+**\`executeApi(apiName, inputs?, options?)\` returns \`Promise<TOutput>\`:**
+- Plain async function — no React hooks, no caching, no reactive state
+- Use for utility functions, event handlers, initialization logic, and non-component code
+- Supports \`{ signal: AbortSignal }\` option for cancellation
+- Errors are thrown as exceptions — use try/catch or .catch()
+
 ### Critical Rules
 
 1. **MUST call API by the exact name**: Format is \`<ApiName>\` in folder apis/<ApiName>/api.yaml
-2. **Always pass parameters to the function**: \`await run({ param1: value1, param2: value2 })\`
-3. **Use \`loading\` and \`data\` from useApi**: Do NOT create separate useState for loading or response data
-4. **Prefer declarative mode for data fetching**: Pass inputs directly: \`useApi("GetUsers", { email })\`. Only use imperative mode for event-driven actions.
-5. **Do NOT create wrapper hooks**: Use \`useApi\` directly in components — no \`useGetUsers\` pattern needed
-6. **ALWAYS check API input/output interfaces**: NEVER guess the response structure - use the actual interface defined by the API
-7. **ALWAYS include all parameters in the function call**: NEVER omit parameters the API expects, even if they are optional, they should be included and passed as null
-8. **ALWAYS include error handling**: In imperative mode, wrap \`run()\` in try/catch. In declarative mode, check the \`error\` field for failure details.
+2. **Always pass parameters to the function**: \`await run({ param1: value1, param2: value2 })\` for useApi, or as the second argument for useApiData / executeApi
+3. **Use \`useApiData\` for data loading, \`useApi\` for mutations, \`executeApi\` outside React**: Do NOT create separate useState for loading, response data, or error state
+4. **Do NOT create wrapper hooks**: Use the hooks directly in components — no \`useGetUsers\` pattern needed
+5. **ALWAYS check API input/output interfaces**: NEVER guess the response structure - use the actual interface defined by the API
+6. **ALWAYS include all parameters in the function call**: NEVER omit parameters the API expects, even if they are optional, they should be included and passed as null
+7. **ALWAYS include error handling**: In useApi, wrap \`run()\` in try/catch. In useApiData, check the \`error\` or \`isError\` fields. For executeApi, use try/catch or .catch().
 
 ### File Handling
 
@@ -145,13 +205,34 @@ Efficiency is key when building applications for production. You should always b
 when it comes to loading data from APIs.
 
 Here are some examples (not exhaustive) that you should consider when building applications:
-1. **Default to Smart Loading**: Always check for existing data before showing loading states
+1. **Always show loading indicators on refetch**: When inputs change (e.g. filters, search), show a visual loading indicator while new data loads. Use \`fetching\` from useApiData.
 2. **Loading State Hierarchy**:
-  - Empty state → Full loading
-  - Has data → Keep showing data during refetch
-  - Error state → Show error with retry option, optionally keep stale data in background in case of retry
+  - No data yet (\`loading\`) → Full skeleton placeholder
+  - Has data, refetching (\`fetching\` && !\`loading\`) → Keep showing current data with a loading overlay (e.g. reduced opacity, inline spinner)
+  - Error state (\`isError\`) → Show error with retry option, optionally keep stale data visible
 3. **Debounce Rapid Requests**: Prevent multiple API calls in short succession
-4. **Use declarative useApi for automatic refetching**: Pass inputs directly to useApi for data that should refresh when dependencies change.
+4. **Use useApiData for automatic refetching**: \`useApiData\` auto-refetches when inputs change and supports \`staleTime\`, \`refetchOnWindowFocus\`, and \`refetchOnReconnect\` options.
+
+\`\`\`tsx
+// ✅ CORRECT — loading indicator when filters change
+const { data, loading, fetching, isError, error } = useApiData("GetOrders", { status: statusFilter, search });
+
+if (loading) return <Skeleton />;                // First load: full skeleton
+if (isError) return <ErrorBanner error={error} />;
+return (
+  <div className={fetching ? "opacity-50 pointer-events-none" : ""}>
+    <OrderTable orders={data.orders} />            {/* Keep showing data during refetch */}
+  </div>
+);
+\`\`\`
+
+\`\`\`tsx
+// ❌ WRONG — no loading indicator when filters change. User sees stale data with no feedback.
+const { data, loading } = useApiData("GetOrders", { status: statusFilter, search });
+
+if (loading) return <Skeleton />;
+return <OrderTable orders={data.orders} />;
+\`\`\`
 
 ### Interpreting testApi Results
 
@@ -162,8 +243,8 @@ Here are some examples (not exhaustive) that you should consider when building a
  * SDK-based API prompt section (new experience).
  *
  * Uses:
- * - useApi from @/hooks/useApi.js
- * - APIs in server/apis/ApiName/api.ts
+ * - useApi from @/hooks/useApi.js, useApiData from @/hooks/useApiData.js, executeApi from @/lib/executeApi.js
+ * - API modules under server/apis/ (group by domain or feature, e.g. server/apis/users/get-users.ts; paths are flexible)
  * - SDK READMEs for documentation
  * - Zod schemas and integration IDs
  */
@@ -181,11 +262,13 @@ Before writing ANY API, you MUST:
    - This is REQUIRED before creating or modifying any API
 
 2. **Read the integration-specific README** for EACH integration you plan to use:
-   - Path: \`node_modules/@superblocksteam/sdk-api/src/integrations/<integration>/README.md\`
+   - Path: \`node_modules/@superblocksteam/sdk-api/src/integrations/<pluginId>/README.md\`
+   - The \`<pluginId>\` is the integration's plugin type (e.g. \`postgres\`, \`redshift\`, \`openai_v2\`) — the same value returned in the \`plugin.id\` field from \`searchIntegrations\`
    - Example: For Postgres, read \`node_modules/@superblocksteam/sdk-api/src/integrations/postgres/README.md\`
    - Example: For OpenAI, read \`node_modules/@superblocksteam/sdk-api/src/integrations/openai_v2/README.md\`
    - These contain integration-specific methods, parameters, and usage examples
    - Do NOT guess or hallucinate integration methods - the README is the source of truth
+   - **Important:** \`node_modules\` is excluded from file listing and glob results. Use \`grep\` to find files in \`node_modules\` (e.g. \`grep("redshift", path="node_modules/@superblocksteam/sdk-api/src", files_with_matches)\`), then \`build_readFile\` to read them
 
 **Trace Metadata:**
 All integration client methods accept an optional \`metadata\` parameter as the last argument: \`{ label?: string, description?: string }\`. When \`includeDiagnostics\` is enabled, this metadata appears in the trace view. Always include a \`label\` on each integration call to make traces readable. Example: \`ctx.integrations.db.query(sql, Schema, params, { label: "Fetch active users" })\`.
@@ -193,7 +276,7 @@ All integration client methods accept an optional \`metadata\` parameter as the
 **CRITICAL - Method Validation:**
 Before calling ANY integration client method, you MUST:
 1. Read the integration's README to understand available methods and their signatures
-2. Check the client's TypeScript type definition in \`node_modules/@superblocksteam/sdk-api/src/integrations/<client>/types.ts\` if needed
+2. Check the client's TypeScript type definition in \`node_modules/@superblocksteam/sdk-api/src/integrations/<pluginId>/types.ts\` if needed (use \`grep\` to find files, then \`build_readFile\` to read — glob/listing exclude \`node_modules\`)
 3. Verify the method exists and review its exact signature
 4. Do NOT hallucinate methods based on the real service's API (e.g., \`openai.createChatCompletion()\` doesn't exist - check the README for actual methods)
 </sdk>
@@ -277,12 +360,16 @@ If the user requests checking user data, like email, ID, this information cannot
 You must NEVER attempt to rely on frontend data for security-critical operations, rely on the injected \`Global\` object in APIs instead.
 </permissions>
 
+**First argument to \`useApi\` / \`useApiData\` / \`executeApi\`:** each key on the default export in \`server/apis/index.ts\` — not the \`name\` field inside \`api({ … })\` when those differ. Use \`index.ts\` and existing call sites;
+
 **CRITICAL: When debugging data issues:**
 - If the UI is showing no data, ALWAYS test the relevant APIs first to verify they are actually returning data
 - DO NOT assume the API itself is correct or broken without testing it - verify both the API response AND the frontend code
 
+**File layout:** Group APIs under \`server/apis/\` by domain or feature (e.g. \`users/\`, \`orders/\`, \`billing/\`). Use descriptive file names (\`get-users.ts\`, \`create-order.ts\`) instead of repeating \`api.ts\` inside a folder named after the registry key. The path is independent of the string passed to \`useApi("...")\`—only \`server/apis/index.ts\` maps names to files.
+
 \`\`\`typescript
-// API definition in server/apis/GetUsers/api.ts
+// API definition in server/apis/users/get-users.ts
 import { api, z, postgres } from "@superblocksteam/sdk-api";
 
 // Integration IDs from the integrations panel - store in constants with descriptive names
@@ -344,21 +431,27 @@ WHERE plan = ANY($1::text[])               -- ❌ WRONG: "operator does not exis
 Rule: Before writing \`::type\` casts, check the actual column type via \`grepMetadata\`. Use \`::text\` only for built-in text columns.
 
 \`\`\`typescript
-// Calling the API from frontend — use useApi directly in components
-import { useApi } from "@/hooks/useApi.js";
+// Data loading — auto-fetches when inputs change (preferred for reads)
+import { useApiData } from "@/hooks/useApiData.js";
 
-// Declarative mode — auto-fetches when inputs change (preferred for data loading)
-const { loading, data } = useApi("GetUsers", { email, name });
-// \`data\` updates automatically with the response, \`loading\` tracks in-flight state
+const { data, loading, isError, error, fetching } = useApiData("GetUsers", { email, name });
+// \`data\` updates automatically, \`loading\` is true on first fetch with no cached data
+// \`fetching\` is true during any fetch (including background refetch)
+// \`error\` is populated if the fetch fails — no try/catch needed
 // Re-fetches when email or name changes — no useEffect needed
+// IMPORTANT: Always use \`fetching\` to show a loading indicator during refetches
+
+if (loading) return <Skeleton />;
+if (isError) return <ErrorBanner error={error} />;
+return <UserList users={data.users} />;
 \`\`\`
 
 \`\`\`typescript
-// Imperative mode — for event-driven actions (button clicks, form submissions)
+// Mutations — for event-driven actions (button clicks, form submissions)
 import { useApi } from "@/hooks/useApi.js";
 import { toast } from "sonner";
 
-const { run: createOrder, loading } = useApi("CreateOrder");
+const { run: createOrder, loading, error } = useApi("CreateOrder");
 
 const handleSubmit = useCallback(async () => {
   try {
@@ -373,24 +466,93 @@ const handleSubmit = useCallback(async () => {
 }, [item, qty, createOrder]);
 \`\`\`
 
-**useApi returns \`{ run, cancel, loading, data, error }\`:**
+\`\`\`typescript
+// Refetch after a mutation — combine useApiData + useApi
+import { useApiData } from "@/hooks/useApiData.js";
+import { useApi } from "@/hooks/useApi.js";
+
+const { data: todos, refetch } = useApiData("GetTodos", {});
+const { run: createTodo } = useApi("CreateTodo");
+
+const handleCreate = async (title: string) => {
+  await createTodo({ title });
+  await refetch(); // Refresh the list after mutation
+};
+\`\`\`
+
+\`\`\`typescript
+// Conditional fetching and stale-while-revalidate
+import { useApiData } from "@/hooks/useApiData.js";
+
+// Only fetch when userId is available
+const { data } = useApiData("GetUser", { id: userId }, { enabled: !!userId });
+
+// Show cached data while refreshing in background
+const { data, fetching } = useApiData("GetMetrics", {}, { staleTime: 30_000 });
+\`\`\`
+
+\`\`\`typescript
+// Outside React — utility functions, event handlers, initialization logic
+import { executeApi } from "@/lib/executeApi.js";
+
+// Simple call — returns a Promise
+const users = await executeApi("GetUsers", { email: "a@b.com" });
+
+// With cancellation
+const controller = new AbortController();
+const data = await executeApi("GetUser", { id: userId }, { signal: controller.signal });
+
+// In a utility function (no React hooks needed)
+async function syncUserData(userId: string) {
+  const user = await executeApi("GetUser", { id: userId });
+  const orders = await executeApi("GetOrders", { userId: user.id });
+  return { user, orders };
+}
+\`\`\`
+
+**Three primitives for three use cases:**
+- **\`useApiData\`** — React hook for data loading (reads). Auto-fetches on mount and when inputs change.
+- **\`useApi\`** — React hook for mutations/actions (writes). Call \`run()\` manually.
+- **\`executeApi\`** — Plain function for calling APIs outside React (utility functions, event handlers, initialization logic).
+
+**\`useApiData\` returns \`{ data, error, status, fetchStatus, loading, fetching, isError, isSuccess, isStale, refetch, cancel }\`:**
+- \`data\` — cached/fetched response (persists across background refetches)
+- \`error\` — error from the last failed fetch (cleared on success)
+- \`loading\` — true when fetching for the first time with no cached data
+- \`fetching\` — true when any fetch is in progress (including background refetch)
+- \`isError\` / \`isSuccess\` — boolean status helpers
+- \`refetch()\` — manually trigger a fresh fetch
+- \`cancel()\` — abort the current in-flight fetch
+- Options: \`enabled\`, \`staleTime\`, \`gcTime\`, \`retry\`, \`refetchOnWindowFocus\`, \`refetchOnReconnect\`, \`refetchInterval\`, \`placeholderData\`
+
+**\`useApi\` returns \`{ run, cancel, loading, data, error, status, variables, reset }\`:**
 - \`run(inputs)\` — execute the API imperatively
 - \`cancel()\` — cancel in-flight requests
 - \`loading\` — boolean, true while the most recent call is in flight
-- \`data\` — last successful response (persists across re-runs, stale-while-revalidate)
-- \`error\` — the error from the most recent failed call, or \`undefined\` if the last call succeeded
+- \`data\` — last successful response (persists across re-runs)
+- \`error\` — error from the last failed run (cleared on next success)
+- \`status\` — \`"idle" | "pending" | "success" | "error"\`
+- \`reset()\` — reset state back to idle
+
+**\`executeApi(apiName, inputs?, options?)\` returns \`Promise<TOutput>\`:**
+- Plain async function — no React hooks, no caching, no reactive state
+- Use for utility functions, event handlers, initialization logic, and non-component code
+- Supports \`{ signal: AbortSignal }\` option for cancellation
+- Errors are thrown as exceptions — use try/catch or .catch()
 
-**CRITICAL: Do NOT create custom wrapper hooks around useApi. Do NOT manage loading or data state with separate useState — useApi handles this for you. Do NOT use useRef guards for HMR — declarative mode has built-in double-fetch prevention.**
+**CRITICAL: Use \`useApiData\` for data loading, \`useApi\` for mutations, and \`executeApi\` outside React components. Do NOT use \`useApi\` with a second argument for data loading — that pattern is deprecated.**
+
+**CRITICAL: Do NOT create custom wrapper hooks around these hooks. Do NOT manage loading or data state with separate useState — the hooks handle this for you.**
 
 ### Critical Rules
 
-1. **Import useApi from hooks**: Always import \`useApi\` from \`@/hooks/useApi.js\`, NOT from \`@superblocksteam/library\`. This provides automatic type inference from the API registry.
-2. **Use \`loading\` and \`data\` from useApi**: Do NOT create separate useState for loading or response data
-3. **Prefer declarative mode for data fetching**: Pass inputs directly: \`useApi("GetUsers", { email })\`. Only use imperative mode for event-driven actions.
-4. **Do NOT create wrapper hooks**: Use \`useApi\` directly in components — no \`useGetUsers\` pattern needed
+1. **Import from the app wrappers**: \`useApi\` from \`@/hooks/useApi.js\`, \`useApiData\` from \`@/hooks/useApiData.js\`, \`executeApi\` from \`@/lib/executeApi.js\` — not from \`@superblocksteam/library\` (those wrappers wire \`createTypedApi\` / \`createTypedExecuteApi\` to your registry).
+2. **MUST use the exact property name from \`server/apis/index.ts\`** as the first hook argument.
+3. **Use \`useApiData\` for data loading, \`useApi\` for mutations, \`executeApi\` outside React**: Do NOT create separate useState for loading, response data, or error state
+4. **Do NOT create wrapper hooks**: Use the hooks directly in components — no \`useGetUsers\` pattern needed
 5. **ALWAYS check API input/output interfaces**: NEVER guess the response structure - use the actual interface defined by the API
 6. **ALWAYS include all parameters in the function call**: NEVER omit parameters the API expects, even if they are optional, they should be included and passed as null
-7. **ALWAYS include error handling**: In imperative mode, wrap \`run()\` in try/catch. In declarative mode, check the \`error\` field for failure details.
+7. **ALWAYS include error handling**: In useApi, wrap \`run()\` in try/catch. In useApiData, check the \`error\` or \`isError\` fields. For executeApi, use try/catch or .catch().
 
 ### File Handling
 
@@ -539,13 +701,34 @@ Efficiency is key when building applications for production. You should always b
 when it comes to loading data from APIs.
 
 Here are some examples (not exhaustive) that you should consider when building applications:
-1. **Default to Smart Loading**: Always check for existing data before showing loading states
+1. **Always show loading indicators on refetch**: When inputs change (e.g. filters, search), show a visual loading indicator while new data loads. Use \`fetching\` from useApiData.
 2. **Loading State Hierarchy**:
-  - Empty state → Full loading
-  - Has data → Keep showing data during refetch
-  - Error state → Show error with retry option, optionally keep stale data in background in case of retry
+  - No data yet (\`loading\`) → Full skeleton placeholder
+  - Has data, refetching (\`fetching\` && !\`loading\`) → Keep showing current data with a loading overlay (e.g. reduced opacity, inline spinner)
+  - Error state (\`isError\`) → Show error with retry option, optionally keep stale data visible
 3. **Debounce Rapid Requests**: Prevent multiple API calls in short succession
-4. **Use declarative useApi for automatic refetching**: Pass inputs directly to useApi for data that should refresh when dependencies change.
+4. **Use useApiData for automatic refetching**: \`useApiData\` auto-refetches when inputs change and supports \`staleTime\`, \`refetchOnWindowFocus\`, and \`refetchOnReconnect\` options.
+
+\`\`\`tsx
+// ✅ CORRECT — loading indicator when filters change
+const { data, loading, fetching, isError, error } = useApiData("GetOrders", { status: statusFilter, search });
+
+if (loading) return <Skeleton />;                // First load: full skeleton
+if (isError) return <ErrorBanner error={error} />;
+return (
+  <div className={fetching ? "opacity-50 pointer-events-none" : ""}>
+    <OrderTable orders={data.orders} />            {/* Keep showing data during refetch */}
+  </div>
+);
+\`\`\`
+
+\`\`\`tsx
+// ❌ WRONG — no loading indicator when filters change. User sees stale data with no feedback.
+const { data, loading } = useApiData("GetOrders", { status: statusFilter, search });
+
+if (loading) return <Skeleton />;
+return <OrderTable orders={data.orders} />;
+\`\`\`
 
 ### Interpreting testApi Results
 
@@ -560,14 +743,25 @@ Here are some examples (not exhaustive) that you should consider when building a
  */
 export function buildApiToolGuidance(sdkEnabled) {
     if (sdkEnabled) {
-        return `**Deleting APIs:** When deleting an API, only delete the \`server/apis/ApiName/api.ts\` file. The delete tool will automatically remove the entire API directory (\`server/apis/ApiName/\`), all generated files, and any scratch files. Do NOT make multiple delete calls for the same API.
+        return `**Deleting APIs:** Remove the API from \`server/apis/index.ts\`, then delete its implementation. If the API is part of a larger feature, leave the rest of the code alone.
+
+**Creating APIs:** Register every API in \`server/apis/index.ts\` so \`useApi\` gets types and the runtime can resolve entry points. Use \`.js\` extensions in import specifiers (ESM). Prefer domain folders and descriptive file names, not \`server/apis/SomeApi/api.ts\` by default.
+
+\`\`\`typescript
+// server/apis/index.ts — one module per API (default export)
+import CreateOrder from './orders/create-order.js';
+import GetUsers from './users/get-users.js';
+const apis = { CreateOrder, GetUsers } as const;
+export default apis;
+export type ApiRegistry = typeof apis;
+\`\`\`
+
+**Multiple APIs in one module** — use named imports when several \`api({...})\` definitions share a file (e.g. related mutations):
 
-**Creating APIs:** When creating a new API, also add it to the registry at \`server/apis/index.ts\`. This enables type inference for \`useApi\`:
 \`\`\`typescript
 // server/apis/index.ts
-// IMPORTANT: Use .js extension for imports (required for ESM compatibility)
-import NewApi from './NewApi/api.js';
-const apis = { ..., NewApi } as const;
+import { ArchiveUser, UpdateProfile } from './users/account-mutations.js';
+const apis = { ..., ArchiveUser, UpdateProfile } as const;
 export default apis;
 export type ApiRegistry = typeof apis;
 \`\`\`

package/dist/ai-service/agent/prompts/api-prompts.js.map

@@ -1 +1 @@
-{"version":3,"file":"api-prompts.js","sourceRoot":"","sources":["../../../../src/ai-service/agent/prompts/api-prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA+ID,CAAC;AACT,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA8XD,CAAC;AACT,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,UAAmB;IACtD,IAAI,UAAU,EAAE,CAAC;QACf,OAAO;;;;;;;;;;;;;;;;uCAgB4B,CAAC;IACtC,CAAC;IAED,OAAO,oRAAoR,CAAC;AAC9R,CAAC"}
+{"version":3,"file":"api-prompts.js","sourceRoot":"","sources":["../../../../src/ai-service/agent/prompts/api-prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAgOD,CAAC;AACT,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAoeD,CAAC;AACT,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,UAAmB;IACtD,IAAI,UAAU,EAAE,CAAC;QACf,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;uCA2B4B,CAAC;IACtC,CAAC;IAED,OAAO,oRAAoR,CAAC;AAC9R,CAAC"}

package/dist/ai-service/agent/prompts/build-base-system-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-base-system-prompt.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/agent/prompts/build-base-system-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uCAAuC,CAAC;AAKpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAStD,eAAO,MAAM,qBAAqB,GAChC,QAAQ,eAAe,EACvB,OAAO,MAAM,EACb,eAAe,MAAM,EACrB,sBAAsB,MAAM,EAC5B,yBAAyB,MAAM,WAqPhC,CAAC"}
+{"version":3,"file":"build-base-system-prompt.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/agent/prompts/build-base-system-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uCAAuC,CAAC;AAKpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAStD,eAAO,MAAM,qBAAqB,GAChC,QAAQ,eAAe,EACvB,OAAO,MAAM,EACb,eAAe,MAAM,EACrB,sBAAsB,MAAM,EAC5B,yBAAyB,MAAM,WAqQhC,CAAC"}