callman-core 1.11.5 → 1.11.7

package/dist-cjs/script/pm-api-reference.js

@@ -0,0 +1,52 @@
+"use strict";
+// Renders the human/AI-readable `pm.*` reference from PM_API_METADATA — the
+// SAME text the ai-packs generator emits into ai-packs/pm-api.md. Kept here (in
+// the library) so every consumer that needs the reference as a string — the
+// pack generator AND the backend AI script-generator prompt — derives it from
+// one place and can never drift from the metadata.
+//
+// `stages` narrows the output to members meaningful in the given stage(s):
+// e.g. a pre-request prompt drops `pm.response`, `pm.db.post`, `pm.kafka`.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderPmApiReference = void 0;
+const pm_api_metadata_js_1 = require("./pm-api-metadata.js");
+const INTRO = "Scripts are plain JavaScript (top-level `await` allowed). Use ONLY the API below — anything else (fetch, require, process, Buffer, ...) is blocked by the sandbox.";
+const STAGE_RULES = [
+    "## Stage rules",
+    "",
+    "- `pre-request`: runs BEFORE the HTTP call. `pm.response` does not exist; `pm.request` mutations take effect.",
+    "- `post-response` / `tests`: run AFTER the call. `pm.response` is available; `pm.request` mutations have no effect.",
+    '- `scenario-script`: a scenario Script node. Prior node outputs are readable via `pm.variables.resolve("{{NodeLabel.path}}")`; the script\'s return value becomes the node output.',
+    "- Members without a stage note are available in every stage.",
+];
+const memberInStages = (member, stages) => {
+    // No stage filter, or a member with no stage note (available everywhere).
+    if (!stages || stages.length === 0 || !member.stages)
+        return true;
+    return member.stages.some((stage) => stages.includes(stage));
+};
+const renderPmApiReference = (options = {}) => {
+    const { stages, includeIntro = true, includeStageRules = true } = options;
+    const lines = [];
+    if (includeIntro)
+        lines.push(INTRO, "");
+    for (const namespace of pm_api_metadata_js_1.PM_API_METADATA) {
+        const members = namespace.members.filter((member) => memberInStages(member, stages));
+        if (members.length === 0)
+            continue;
+        lines.push(`## ${namespace.name}`, "", namespace.description, "");
+        for (const member of members) {
+            const stageNote = member.stages ? ` _(stages: ${member.stages.join(", ")})_` : "";
+            const requiresNote = member.requires
+                ? ` _(requires the ${member.requires} capability — may be disabled by feature policy)_`
+                : "";
+            lines.push(`- \`${member.signature}\` — ${member.description}${stageNote}${requiresNote}`);
+        }
+        lines.push("");
+    }
+    if (includeStageRules)
+        lines.push(...STAGE_RULES);
+    return lines.join("\n");
+};
+exports.renderPmApiReference = renderPmApiReference;
+//# sourceMappingURL=pm-api-reference.js.map

package/dist-cjs/script/pm-api-reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pm-api-reference.js","sourceRoot":"","sources":["../../src/script/pm-api-reference.ts"],"names":[],"mappings":";AAAA,4EAA4E;AAC5E,gFAAgF;AAChF,4EAA4E;AAC5E,8EAA8E;AAC9E,mDAAmD;AACnD,EAAE;AACF,2EAA2E;AAC3E,2EAA2E;;;AAE3E,6DAA0F;AAW1F,MAAM,KAAK,GACT,oKAAoK,CAAC;AAEvK,MAAM,WAAW,GAAG;IAClB,gBAAgB;IAChB,EAAE;IACF,+GAA+G;IAC/G,qHAAqH;IACrH,oLAAoL;IACpL,8DAA8D;CAC/D,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,MAAmB,EAAE,MAAqB,EAAW,EAAE;IAC7E,0EAA0E;IAC1E,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAClE,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/D,CAAC,CAAC;AAEK,MAAM,oBAAoB,GAAG,CAAC,UAA8B,EAAE,EAAU,EAAE;IAC/E,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,EAAE,iBAAiB,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAC1E,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,YAAY;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAExC,KAAK,MAAM,SAAS,IAAI,oCAAe,EAAE,CAAC;QACxC,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QACrF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACnC,KAAK,CAAC,IAAI,CAAC,MAAM,SAAS,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAClE,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAClF,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ;gBAClC,CAAC,CAAC,mBAAmB,MAAM,CAAC,QAAQ,mDAAmD;gBACvF,CAAC,CAAC,EAAE,CAAC;YACP,KAAK,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,SAAS,QAAQ,MAAM,CAAC,WAAW,GAAG,SAAS,GAAG,YAAY,EAAE,CAAC,CAAC;QAC7F,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,iBAAiB;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;IAElD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC,CAAC;AAvBW,QAAA,oBAAoB,wBAuB/B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "callman-core",
-  "version": "1.11.5",
+  "version": "1.11.7",
   "main": "dist-cjs/index.js",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",