@stackfactor/agent-utils 1.2.2 → 1.2.4

package/dist/cjs/langChain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"langChain.d.ts","sourceRoot":"","sources":["../../src/langChain.ts"],"names":[],"mappings":";0CAiD6C,GAAG,KAAG,IAAI;wBAyhB/C,MAAM,aACD,MAAM,gBACH,MAAM,SACb,GAAG,EAAE,kBACI,GAAG,UACX,GAAG,KACV,GAAG;sBAyBG,GAAG,UACF,MAAM,UACN,GAAG,eACC,QAAQ,GAAG,IAAI,KAC1B,OAAO,CAAC,GAAG,CAAC;oCAqXF,MAAM,UACT,GAAG,UACH,GAAG,oBACO,GAAG,eACT,MAAM,eACN,MAAM,wBACG,OAAO,WACpB,GAAG,cACA,MAAM,UACV,GAAG,EAAE,KACX,OAAO,CAAC,GAAG,CAAC;sDAosBF,MAAM,UACT,GAAG,UACH,MAAM,YACL,GAAG,KACX,OAAO,CAAC,GAAG,CAAC;0CAn+B8B,GAAG,KAAG,MAAM;mCAoBxC,MAAM,mBACJ,MAAM,EAAE,KACxB,MAAM;;AAwgCT,wBAQE"}
+{"version":3,"file":"langChain.d.ts","sourceRoot":"","sources":["../../src/langChain.ts"],"names":[],"mappings":";0CAiD6C,GAAG,KAAG,IAAI;wBA0hB/C,MAAM,aACD,MAAM,gBACH,MAAM,SACb,GAAG,EAAE,kBACI,GAAG,UACX,GAAG,KACV,GAAG;sBAyBG,GAAG,UACF,MAAM,UACN,GAAG,eACC,QAAQ,GAAG,IAAI,KAC1B,OAAO,CAAC,GAAG,CAAC;oCAqXF,MAAM,UACT,GAAG,UACH,GAAG,oBACO,GAAG,eACT,MAAM,eACN,MAAM,wBACG,OAAO,WACpB,GAAG,cACA,MAAM,UACV,GAAG,EAAE,KACX,OAAO,CAAC,GAAG,CAAC;sDAosBF,MAAM,UACT,GAAG,UACH,MAAM,YACL,GAAG,KACX,OAAO,CAAC,GAAG,CAAC;0CAn+B8B,GAAG,KAAG,MAAM;mCAoBxC,MAAM,mBACJ,MAAM,EAAE,KACxB,MAAM;;AAwgCT,wBAQE"}

package/dist/cjs/langChain.js

@@ -457,6 +457,7 @@ const getLLMModel = (modelName, config, schema = null) => {
             maxTokens,
             modelName: modelName,
             streaming: maxTokens > 16384,
+            invocationKwargs: { cache_control: { type: "ephemeral" } },
             ...modelSettings,
         });
     }

package/dist/cjs/serve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/serve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,eAAe,CAAC;AA6JtC;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;AAE/D;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAC1B,OAAO,EAAE,GAAG,KACT,OAAO,CAAC;IAAE,IAAI,EAAE,GAAG,CAAC;IAAC,MAAM,EAAE,GAAG,CAAA;CAAE,CAAC,CAAC;AAEzC,MAAM,WAAW,YAAY;IAC3B,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wFAAwF;IACxF,YAAY,CAAC,EAAE,aAAa,CAAC;CAC9B;AAkDD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,KAAK,GAChB,MAAM,SAAS,EACf,UAAS,YAAiB,KACzB,IAAI,CAAC,MAuKP,CAAC"}
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/serve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,eAAe,CAAC;AA8LtC;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;AAE/D;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAC1B,OAAO,EAAE,GAAG,KACT,OAAO,CAAC;IAAE,IAAI,EAAE,GAAG,CAAC;IAAC,MAAM,EAAE,GAAG,CAAA;CAAE,CAAC,CAAC;AAEzC,MAAM,WAAW,YAAY;IAC3B,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wFAAwF;IACxF,YAAY,CAAC,EAAE,aAAa,CAAC;CAC9B;AAkDD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,KAAK,GAChB,MAAM,SAAS,EACf,UAAS,YAAiB,KACzB,IAAI,CAAC,MAuKP,CAAC"}

package/dist/cjs/serve.js

@@ -45,9 +45,6 @@ const client_api_1 = require("@stackfactor/client-api");
 const logger_js_1 = __importDefault(require("./logger.js"));
 const agentProto_js_1 = require("./agentProto.js");
 const runtimeContext_js_1 = require("./runtimeContext.js");
-// The conventional self-check module run on a deep HealthCheck when the caller
-// doesn't specify `check_code`. Resolved relative to the agent's app root.
-const DEFAULT_CHECK_PATH = "src/check.js";
 // Genuine dynamic `import()` that survives TypeScript's CJS downlevelling (which
 // would otherwise turn `import()` into `require()` and break file:// URLs and
 // ESM check modules). Built once; see the call site in runSelfCheck.
@@ -60,9 +57,8 @@ const SELF_CHECK_TIMEOUT_MS = 20_000;
  * path that escapes it or is absolute (the path may originate from the
  * integration config, so treat it as untrusted). Returns null when unsafe.
  */
-const resolveCheckPath = (checkCode) => {
+const resolveCheckPath = (rel) => {
     const root = process.cwd();
-    const rel = (checkCode || "").trim() || DEFAULT_CHECK_PATH;
     const dest = (0, node_path_1.resolve)(root, rel);
     const back = (0, node_path_1.relative)(root, dest);
     if (back === "" || back.startsWith("..") || (0, node_path_1.isAbsolute)(back)) {
@@ -85,19 +81,51 @@ const normalizeChecks = (raw) => {
     }));
 };
 /**
- * Loads and runs the agent's self-check module (`check_code` or the default
- * `src/check.js`). The check follows the same programming model as `main`: it
- * receives the request {@link AbortSignal} and reads `config` / `request`
- * (incl. `request.session`) from the per-request globals (bound here via
- * {@link runWithContext}); the logger is imported. The agent owns only its own
- * checks — reachability/version rows are synthesised backend-side. Never throws:
- * a missing module yields no rows; a load error, bad export, thrown error, or
- * timeout collapses to a single failed `self_check` row.
+ * Loads and runs the agent's self-check module named by `check_code`. There is
+ * NO default path — if `check_code` is unset, synthetic testing is reported as
+ * not enabled (we never guess at `src/check.js`). The check follows the same
+ * programming model as `main`: it receives the request {@link AbortSignal} and
+ * reads `config` / `request` (incl. `request.session`) from the per-request
+ * globals (bound here via {@link runWithContext}); the logger is imported. The
+ * agent owns only its own checks — reachability/version rows are synthesised
+ * backend-side. Never throws: a load error, bad export, thrown error, or timeout
+ * collapses to a single failed `synthetic_check` row.
  */
 const runSelfCheck = async (checkCode, config, session) => {
-    const modulePath = resolveCheckPath(checkCode);
-    if (!modulePath || !(0, node_fs_1.existsSync)(modulePath)) {
-        return []; // no self-check module shipped — baseline checks only
+    const rel = (checkCode || "").trim();
+    if (!rel) {
+        // No self-check configured. Don't assume a default module — surface that
+        // synthetic testing simply isn't enabled for this integration.
+        logger_js_1.default.log(null, logger_js_1.default.levels.info, "Self-check skipped: no checkCode configured (synthetic testing not enabled).");
+        return [
+            {
+                name: "synthetic_check",
+                ok: false,
+                detail: "synthetic testing not enabled — no checkCode configured for this integration",
+                severity: "warn",
+            },
+        ];
+    }
+    const modulePath = resolveCheckPath(rel);
+    if (!modulePath) {
+        return [
+            {
+                name: "synthetic_check",
+                ok: false,
+                detail: `invalid checkCode path "${rel}"`,
+                severity: "warn",
+            },
+        ];
+    }
+    if (!(0, node_fs_1.existsSync)(modulePath)) {
+        return [
+            {
+                name: "synthetic_check",
+                ok: false,
+                detail: `checkCode "${rel}" is configured but the module was not found in the agent image`,
+                severity: "warn",
+            },
+        ];
     }
     let checkFn;
     try {

package/dist/esm/langChain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"langChain.d.ts","sourceRoot":"","sources":["../../src/langChain.ts"],"names":[],"mappings":";0CAiD6C,GAAG,KAAG,IAAI;wBAyhB/C,MAAM,aACD,MAAM,gBACH,MAAM,SACb,GAAG,EAAE,kBACI,GAAG,UACX,GAAG,KACV,GAAG;sBAyBG,GAAG,UACF,MAAM,UACN,GAAG,eACC,QAAQ,GAAG,IAAI,KAC1B,OAAO,CAAC,GAAG,CAAC;oCAqXF,MAAM,UACT,GAAG,UACH,GAAG,oBACO,GAAG,eACT,MAAM,eACN,MAAM,wBACG,OAAO,WACpB,GAAG,cACA,MAAM,UACV,GAAG,EAAE,KACX,OAAO,CAAC,GAAG,CAAC;sDAosBF,MAAM,UACT,GAAG,UACH,MAAM,YACL,GAAG,KACX,OAAO,CAAC,GAAG,CAAC;0CAn+B8B,GAAG,KAAG,MAAM;mCAoBxC,MAAM,mBACJ,MAAM,EAAE,KACxB,MAAM;;AAwgCT,wBAQE"}
+{"version":3,"file":"langChain.d.ts","sourceRoot":"","sources":["../../src/langChain.ts"],"names":[],"mappings":";0CAiD6C,GAAG,KAAG,IAAI;wBA0hB/C,MAAM,aACD,MAAM,gBACH,MAAM,SACb,GAAG,EAAE,kBACI,GAAG,UACX,GAAG,KACV,GAAG;sBAyBG,GAAG,UACF,MAAM,UACN,GAAG,eACC,QAAQ,GAAG,IAAI,KAC1B,OAAO,CAAC,GAAG,CAAC;oCAqXF,MAAM,UACT,GAAG,UACH,GAAG,oBACO,GAAG,eACT,MAAM,eACN,MAAM,wBACG,OAAO,WACpB,GAAG,cACA,MAAM,UACV,GAAG,EAAE,KACX,OAAO,CAAC,GAAG,CAAC;sDAosBF,MAAM,UACT,GAAG,UACH,MAAM,YACL,GAAG,KACX,OAAO,CAAC,GAAG,CAAC;0CAn+B8B,GAAG,KAAG,MAAM;mCAoBxC,MAAM,mBACJ,MAAM,EAAE,KACxB,MAAM;;AAwgCT,wBAQE"}

package/dist/esm/langChain.js

@@ -452,6 +452,7 @@ const getLLMModel = (modelName, config, schema = null) => {
             maxTokens,
             modelName: modelName,
             streaming: maxTokens > 16384,
+            invocationKwargs: { cache_control: { type: "ephemeral" } },
             ...modelSettings,
         });
     }

package/dist/esm/serve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/serve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,eAAe,CAAC;AA6JtC;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;AAE/D;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAC1B,OAAO,EAAE,GAAG,KACT,OAAO,CAAC;IAAE,IAAI,EAAE,GAAG,CAAC;IAAC,MAAM,EAAE,GAAG,CAAA;CAAE,CAAC,CAAC;AAEzC,MAAM,WAAW,YAAY;IAC3B,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wFAAwF;IACxF,YAAY,CAAC,EAAE,aAAa,CAAC;CAC9B;AAkDD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,KAAK,GAChB,MAAM,SAAS,EACf,UAAS,YAAiB,KACzB,IAAI,CAAC,MAuKP,CAAC"}
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/serve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,eAAe,CAAC;AA8LtC;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;AAE/D;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAC1B,OAAO,EAAE,GAAG,KACT,OAAO,CAAC;IAAE,IAAI,EAAE,GAAG,CAAC;IAAC,MAAM,EAAE,GAAG,CAAA;CAAE,CAAC,CAAC;AAEzC,MAAM,WAAW,YAAY;IAC3B,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wFAAwF;IACxF,YAAY,CAAC,EAAE,aAAa,CAAC;CAC9B;AAkDD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,KAAK,GAChB,MAAM,SAAS,EACf,UAAS,YAAiB,KACzB,IAAI,CAAC,MAuKP,CAAC"}

package/dist/esm/serve.js

@@ -6,9 +6,6 @@ import { session as clientSession } from "@stackfactor/client-api";
 import logger from "./logger.js";
 import { loadAgentService } from "./agentProto.js";
 import { runWithContext, installGlobals } from "./runtimeContext.js";
-// The conventional self-check module run on a deep HealthCheck when the caller
-// doesn't specify `check_code`. Resolved relative to the agent's app root.
-const DEFAULT_CHECK_PATH = "src/check.js";
 // Genuine dynamic `import()` that survives TypeScript's CJS downlevelling (which
 // would otherwise turn `import()` into `require()` and break file:// URLs and
 // ESM check modules). Built once; see the call site in runSelfCheck.
@@ -21,9 +18,8 @@ const SELF_CHECK_TIMEOUT_MS = 20_000;
  * path that escapes it or is absolute (the path may originate from the
  * integration config, so treat it as untrusted). Returns null when unsafe.
  */
-const resolveCheckPath = (checkCode) => {
+const resolveCheckPath = (rel) => {
     const root = process.cwd();
-    const rel = (checkCode || "").trim() || DEFAULT_CHECK_PATH;
     const dest = resolve(root, rel);
     const back = relative(root, dest);
     if (back === "" || back.startsWith("..") || isAbsolute(back)) {
@@ -46,19 +42,51 @@ const normalizeChecks = (raw) => {
     }));
 };
 /**
- * Loads and runs the agent's self-check module (`check_code` or the default
- * `src/check.js`). The check follows the same programming model as `main`: it
- * receives the request {@link AbortSignal} and reads `config` / `request`
- * (incl. `request.session`) from the per-request globals (bound here via
- * {@link runWithContext}); the logger is imported. The agent owns only its own
- * checks — reachability/version rows are synthesised backend-side. Never throws:
- * a missing module yields no rows; a load error, bad export, thrown error, or
- * timeout collapses to a single failed `self_check` row.
+ * Loads and runs the agent's self-check module named by `check_code`. There is
+ * NO default path — if `check_code` is unset, synthetic testing is reported as
+ * not enabled (we never guess at `src/check.js`). The check follows the same
+ * programming model as `main`: it receives the request {@link AbortSignal} and
+ * reads `config` / `request` (incl. `request.session`) from the per-request
+ * globals (bound here via {@link runWithContext}); the logger is imported. The
+ * agent owns only its own checks — reachability/version rows are synthesised
+ * backend-side. Never throws: a load error, bad export, thrown error, or timeout
+ * collapses to a single failed `synthetic_check` row.
  */
 const runSelfCheck = async (checkCode, config, session) => {
-    const modulePath = resolveCheckPath(checkCode);
-    if (!modulePath || !existsSync(modulePath)) {
-        return []; // no self-check module shipped — baseline checks only
+    const rel = (checkCode || "").trim();
+    if (!rel) {
+        // No self-check configured. Don't assume a default module — surface that
+        // synthetic testing simply isn't enabled for this integration.
+        logger.log(null, logger.levels.info, "Self-check skipped: no checkCode configured (synthetic testing not enabled).");
+        return [
+            {
+                name: "synthetic_check",
+                ok: false,
+                detail: "synthetic testing not enabled — no checkCode configured for this integration",
+                severity: "warn",
+            },
+        ];
+    }
+    const modulePath = resolveCheckPath(rel);
+    if (!modulePath) {
+        return [
+            {
+                name: "synthetic_check",
+                ok: false,
+                detail: `invalid checkCode path "${rel}"`,
+                severity: "warn",
+            },
+        ];
+    }
+    if (!existsSync(modulePath)) {
+        return [
+            {
+                name: "synthetic_check",
+                ok: false,
+                detail: `checkCode "${rel}" is configured but the module was not found in the agent image`,
+                severity: "warn",
+            },
+        ];
     }
     let checkFn;
     try {

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "1.2.2",
+  "version": "1.2.4",
   "description": "",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",