@vostride/agent-qa-core 0.2.3 → 0.2.4

package/dist/run-text-output.cjs

@@ -0,0 +1,86 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/run-text-output.ts
+var run_text_output_exports = {};
+__export(run_text_output_exports, {
+  guardJsonText: () => guardJsonText,
+  guardRunText: () => guardRunText,
+  isGitHubActions: () => isGitHubActions,
+  printRunText: () => printRunText,
+  reserveStdoutForData: () => reserveStdoutForData
+});
+module.exports = __toCommonJS(run_text_output_exports);
+
+// src/logging/run-text-output.ts
+var import_node_crypto = require("crypto");
+var STDOUT_RESERVATIONS = /* @__PURE__ */ Symbol.for("agent-qa.run-text-output.stdout-reservations");
+function stdoutReservations() {
+  const holder = globalThis;
+  holder[STDOUT_RESERVATIONS] ??= { count: 0 };
+  return holder[STDOUT_RESERVATIONS];
+}
+function isGitHubActions(env = process.env) {
+  const value = env.GITHUB_ACTIONS;
+  return value !== void 0 && value !== "" && value.toLowerCase() !== "false" && value !== "0";
+}
+function guardRunText(text, env = process.env) {
+  if (!isGitHubActions(env)) return text;
+  const token = (0, import_node_crypto.randomBytes)(16).toString("hex");
+  const block = text.endsWith("\n") ? text : `${text}
+`;
+  return `::stop-commands::${token}
+${block}::${token}::
+`;
+}
+function guardJsonText(serialized, env = process.env) {
+  return isGitHubActions(env) ? serialized.replaceAll("#", "\\u0023") : serialized;
+}
+function reserveStdoutForData() {
+  const reservations = stdoutReservations();
+  reservations.count += 1;
+  let released = false;
+  return () => {
+    if (released) return;
+    released = true;
+    reservations.count -= 1;
+  };
+}
+function printRunText(text, print = (line) => console.log(line), options = {}) {
+  const env = options.env ?? process.env;
+  if (!isGitHubActions(env)) {
+    print(text);
+    return;
+  }
+  const block = guardRunText(text, env);
+  if (options.stdoutIsData ?? stdoutReservations().count > 0) {
+    process.stderr.write(block);
+    return;
+  }
+  process.stdout.write(block);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  guardJsonText,
+  guardRunText,
+  isGitHubActions,
+  printRunText,
+  reserveStdoutForData
+});
+//# sourceMappingURL=run-text-output.cjs.map

package/dist/run-text-output.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/run-text-output.ts","../src/logging/run-text-output.ts"],"sourcesContent":["export {\n  isGitHubActions,\n  guardRunText,\n  guardJsonText,\n  reserveStdoutForData,\n  printRunText,\n} from './logging/run-text-output.js'\nexport type { RunTextEnv, PrintRunTextOptions } from './logging/run-text-output.js'\n","import { randomBytes } from 'node:crypto'\n\nexport type RunTextEnv = Readonly<Record<string, string | undefined>>\n\nexport interface PrintRunTextOptions {\n  readonly env?: RunTextEnv\n  readonly stdoutIsData?: boolean\n}\n\n// The root entry and the subpath entry each bundle a copy of this module, so the count lives on\n// globalThis where a reservation taken through either is seen by both.\nconst STDOUT_RESERVATIONS = Symbol.for('agent-qa.run-text-output.stdout-reservations')\n\ninterface StdoutReservations {\n  count: number\n}\n\nfunction stdoutReservations(): StdoutReservations {\n  const holder = globalThis as typeof globalThis & { [STDOUT_RESERVATIONS]?: StdoutReservations }\n  holder[STDOUT_RESERVATIONS] ??= { count: 0 }\n  return holder[STDOUT_RESERVATIONS]\n}\n\nexport function isGitHubActions(env: RunTextEnv = process.env): boolean {\n  const value = env.GITHUB_ACTIONS\n  return value !== undefined && value !== '' && value.toLowerCase() !== 'false' && value !== '0'\n}\n\nexport function guardRunText(text: string, env: RunTextEnv = process.env): string {\n  if (!isGitHubActions(env)) return text\n  // Longer than 6 characters, so the runner masks the token in the log.\n  const token = randomBytes(16).toString('hex')\n  const block = text.endsWith('\\n') ? text : `${text}\\n`\n  return `::stop-commands::${token}\\n${block}::${token}::\\n`\n}\n\nexport function guardJsonText(serialized: string, env: RunTextEnv = process.env): string {\n  return isGitHubActions(env) ? serialized.replaceAll('#', '\\\\u0023') : serialized\n}\n\n/** Marks this process's stdout as carrying a JSON document or protocol; returns the release. */\nexport function reserveStdoutForData(): () => void {\n  const reservations = stdoutReservations()\n  reservations.count += 1\n  let released = false\n  return () => {\n    if (released) return\n    released = true\n    reservations.count -= 1\n  }\n}\n\nexport function printRunText(\n  text: string,\n  print: (text: string) => void = (line) => console.log(line),\n  options: PrintRunTextOptions = {},\n): void {\n  const env = options.env ?? process.env\n  if (!isGitHubActions(env)) {\n    print(text)\n    return\n  }\n  const block = guardRunText(text, env)\n  // The runner reads stdout and stderr on separate threads, so every wrapped block shares one\n  // stream: stdout, or stderr when stdout carries data. The caller's print never sees a block.\n  if (options.stdoutIsData ?? stdoutReservations().count > 0) {\n    process.stderr.write(block)\n    return\n  }\n  process.stdout.write(block)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,yBAA4B;AAW5B,IAAM,sBAAsB,uBAAO,IAAI,8CAA8C;AAMrF,SAAS,qBAAyC;AAChD,QAAM,SAAS;AACf,SAAO,mBAAmB,MAAM,EAAE,OAAO,EAAE;AAC3C,SAAO,OAAO,mBAAmB;AACnC;AAEO,SAAS,gBAAgB,MAAkB,QAAQ,KAAc;AACtE,QAAM,QAAQ,IAAI;AAClB,SAAO,UAAU,UAAa,UAAU,MAAM,MAAM,YAAY,MAAM,WAAW,UAAU;AAC7F;AAEO,SAAS,aAAa,MAAc,MAAkB,QAAQ,KAAa;AAChF,MAAI,CAAC,gBAAgB,GAAG,EAAG,QAAO;AAElC,QAAM,YAAQ,gCAAY,EAAE,EAAE,SAAS,KAAK;AAC5C,QAAM,QAAQ,KAAK,SAAS,IAAI,IAAI,OAAO,GAAG,IAAI;AAAA;AAClD,SAAO,oBAAoB,KAAK;AAAA,EAAK,KAAK,KAAK,KAAK;AAAA;AACtD;AAEO,SAAS,cAAc,YAAoB,MAAkB,QAAQ,KAAa;AACvF,SAAO,gBAAgB,GAAG,IAAI,WAAW,WAAW,KAAK,SAAS,IAAI;AACxE;AAGO,SAAS,uBAAmC;AACjD,QAAM,eAAe,mBAAmB;AACxC,eAAa,SAAS;AACtB,MAAI,WAAW;AACf,SAAO,MAAM;AACX,QAAI,SAAU;AACd,eAAW;AACX,iBAAa,SAAS;AAAA,EACxB;AACF;AAEO,SAAS,aACd,MACA,QAAgC,CAAC,SAAS,QAAQ,IAAI,IAAI,GAC1D,UAA+B,CAAC,GAC1B;AACN,QAAM,MAAM,QAAQ,OAAO,QAAQ;AACnC,MAAI,CAAC,gBAAgB,GAAG,GAAG;AACzB,UAAM,IAAI;AACV;AAAA,EACF;AACA,QAAM,QAAQ,aAAa,MAAM,GAAG;AAGpC,MAAI,QAAQ,gBAAgB,mBAAmB,EAAE,QAAQ,GAAG;AAC1D,YAAQ,OAAO,MAAM,KAAK;AAC1B;AAAA,EACF;AACA,UAAQ,OAAO,MAAM,KAAK;AAC5B;","names":[]}

package/dist/run-text-output.d.cts

@@ -0,0 +1,13 @@
+type RunTextEnv = Readonly<Record<string, string | undefined>>;
+interface PrintRunTextOptions {
+    readonly env?: RunTextEnv;
+    readonly stdoutIsData?: boolean;
+}
+declare function isGitHubActions(env?: RunTextEnv): boolean;
+declare function guardRunText(text: string, env?: RunTextEnv): string;
+declare function guardJsonText(serialized: string, env?: RunTextEnv): string;
+/** Marks this process's stdout as carrying a JSON document or protocol; returns the release. */
+declare function reserveStdoutForData(): () => void;
+declare function printRunText(text: string, print?: (text: string) => void, options?: PrintRunTextOptions): void;
+
+export { type PrintRunTextOptions, type RunTextEnv, guardJsonText, guardRunText, isGitHubActions, printRunText, reserveStdoutForData };

package/dist/run-text-output.d.ts

@@ -0,0 +1,13 @@
+type RunTextEnv = Readonly<Record<string, string | undefined>>;
+interface PrintRunTextOptions {
+    readonly env?: RunTextEnv;
+    readonly stdoutIsData?: boolean;
+}
+declare function isGitHubActions(env?: RunTextEnv): boolean;
+declare function guardRunText(text: string, env?: RunTextEnv): string;
+declare function guardJsonText(serialized: string, env?: RunTextEnv): string;
+/** Marks this process's stdout as carrying a JSON document or protocol; returns the release. */
+declare function reserveStdoutForData(): () => void;
+declare function printRunText(text: string, print?: (text: string) => void, options?: PrintRunTextOptions): void;
+
+export { type PrintRunTextOptions, type RunTextEnv, guardJsonText, guardRunText, isGitHubActions, printRunText, reserveStdoutForData };

package/dist/run-text-output.js

@@ -0,0 +1,55 @@
+// src/logging/run-text-output.ts
+import { randomBytes } from "crypto";
+var STDOUT_RESERVATIONS = /* @__PURE__ */ Symbol.for("agent-qa.run-text-output.stdout-reservations");
+function stdoutReservations() {
+  const holder = globalThis;
+  holder[STDOUT_RESERVATIONS] ??= { count: 0 };
+  return holder[STDOUT_RESERVATIONS];
+}
+function isGitHubActions(env = process.env) {
+  const value = env.GITHUB_ACTIONS;
+  return value !== void 0 && value !== "" && value.toLowerCase() !== "false" && value !== "0";
+}
+function guardRunText(text, env = process.env) {
+  if (!isGitHubActions(env)) return text;
+  const token = randomBytes(16).toString("hex");
+  const block = text.endsWith("\n") ? text : `${text}
+`;
+  return `::stop-commands::${token}
+${block}::${token}::
+`;
+}
+function guardJsonText(serialized, env = process.env) {
+  return isGitHubActions(env) ? serialized.replaceAll("#", "\\u0023") : serialized;
+}
+function reserveStdoutForData() {
+  const reservations = stdoutReservations();
+  reservations.count += 1;
+  let released = false;
+  return () => {
+    if (released) return;
+    released = true;
+    reservations.count -= 1;
+  };
+}
+function printRunText(text, print = (line) => console.log(line), options = {}) {
+  const env = options.env ?? process.env;
+  if (!isGitHubActions(env)) {
+    print(text);
+    return;
+  }
+  const block = guardRunText(text, env);
+  if (options.stdoutIsData ?? stdoutReservations().count > 0) {
+    process.stderr.write(block);
+    return;
+  }
+  process.stdout.write(block);
+}
+export {
+  guardJsonText,
+  guardRunText,
+  isGitHubActions,
+  printRunText,
+  reserveStdoutForData
+};
+//# sourceMappingURL=run-text-output.js.map

package/dist/run-text-output.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/logging/run-text-output.ts"],"sourcesContent":["import { randomBytes } from 'node:crypto'\n\nexport type RunTextEnv = Readonly<Record<string, string | undefined>>\n\nexport interface PrintRunTextOptions {\n  readonly env?: RunTextEnv\n  readonly stdoutIsData?: boolean\n}\n\n// The root entry and the subpath entry each bundle a copy of this module, so the count lives on\n// globalThis where a reservation taken through either is seen by both.\nconst STDOUT_RESERVATIONS = Symbol.for('agent-qa.run-text-output.stdout-reservations')\n\ninterface StdoutReservations {\n  count: number\n}\n\nfunction stdoutReservations(): StdoutReservations {\n  const holder = globalThis as typeof globalThis & { [STDOUT_RESERVATIONS]?: StdoutReservations }\n  holder[STDOUT_RESERVATIONS] ??= { count: 0 }\n  return holder[STDOUT_RESERVATIONS]\n}\n\nexport function isGitHubActions(env: RunTextEnv = process.env): boolean {\n  const value = env.GITHUB_ACTIONS\n  return value !== undefined && value !== '' && value.toLowerCase() !== 'false' && value !== '0'\n}\n\nexport function guardRunText(text: string, env: RunTextEnv = process.env): string {\n  if (!isGitHubActions(env)) return text\n  // Longer than 6 characters, so the runner masks the token in the log.\n  const token = randomBytes(16).toString('hex')\n  const block = text.endsWith('\\n') ? text : `${text}\\n`\n  return `::stop-commands::${token}\\n${block}::${token}::\\n`\n}\n\nexport function guardJsonText(serialized: string, env: RunTextEnv = process.env): string {\n  return isGitHubActions(env) ? serialized.replaceAll('#', '\\\\u0023') : serialized\n}\n\n/** Marks this process's stdout as carrying a JSON document or protocol; returns the release. */\nexport function reserveStdoutForData(): () => void {\n  const reservations = stdoutReservations()\n  reservations.count += 1\n  let released = false\n  return () => {\n    if (released) return\n    released = true\n    reservations.count -= 1\n  }\n}\n\nexport function printRunText(\n  text: string,\n  print: (text: string) => void = (line) => console.log(line),\n  options: PrintRunTextOptions = {},\n): void {\n  const env = options.env ?? process.env\n  if (!isGitHubActions(env)) {\n    print(text)\n    return\n  }\n  const block = guardRunText(text, env)\n  // The runner reads stdout and stderr on separate threads, so every wrapped block shares one\n  // stream: stdout, or stderr when stdout carries data. The caller's print never sees a block.\n  if (options.stdoutIsData ?? stdoutReservations().count > 0) {\n    process.stderr.write(block)\n    return\n  }\n  process.stdout.write(block)\n}\n"],"mappings":";AAAA,SAAS,mBAAmB;AAW5B,IAAM,sBAAsB,uBAAO,IAAI,8CAA8C;AAMrF,SAAS,qBAAyC;AAChD,QAAM,SAAS;AACf,SAAO,mBAAmB,MAAM,EAAE,OAAO,EAAE;AAC3C,SAAO,OAAO,mBAAmB;AACnC;AAEO,SAAS,gBAAgB,MAAkB,QAAQ,KAAc;AACtE,QAAM,QAAQ,IAAI;AAClB,SAAO,UAAU,UAAa,UAAU,MAAM,MAAM,YAAY,MAAM,WAAW,UAAU;AAC7F;AAEO,SAAS,aAAa,MAAc,MAAkB,QAAQ,KAAa;AAChF,MAAI,CAAC,gBAAgB,GAAG,EAAG,QAAO;AAElC,QAAM,QAAQ,YAAY,EAAE,EAAE,SAAS,KAAK;AAC5C,QAAM,QAAQ,KAAK,SAAS,IAAI,IAAI,OAAO,GAAG,IAAI;AAAA;AAClD,SAAO,oBAAoB,KAAK;AAAA,EAAK,KAAK,KAAK,KAAK;AAAA;AACtD;AAEO,SAAS,cAAc,YAAoB,MAAkB,QAAQ,KAAa;AACvF,SAAO,gBAAgB,GAAG,IAAI,WAAW,WAAW,KAAK,SAAS,IAAI;AACxE;AAGO,SAAS,uBAAmC;AACjD,QAAM,eAAe,mBAAmB;AACxC,eAAa,SAAS;AACtB,MAAI,WAAW;AACf,SAAO,MAAM;AACX,QAAI,SAAU;AACd,eAAW;AACX,iBAAa,SAAS;AAAA,EACxB;AACF;AAEO,SAAS,aACd,MACA,QAAgC,CAAC,SAAS,QAAQ,IAAI,IAAI,GAC1D,UAA+B,CAAC,GAC1B;AACN,QAAM,MAAM,QAAQ,OAAO,QAAQ;AACnC,MAAI,CAAC,gBAAgB,GAAG,GAAG;AACzB,UAAM,IAAI;AACV;AAAA,EACF;AACA,QAAM,QAAQ,aAAa,MAAM,GAAG;AAGpC,MAAI,QAAQ,gBAAgB,mBAAmB,EAAE,QAAQ,GAAG;AAC1D,YAAQ,OAAO,MAAM,KAAK;AAC1B;AAAA,EACF;AACA,UAAQ,OAAO,MAAM,KAAK;AAC5B;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vostride/agent-qa-core",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "private": false,
   "description": "Core agent-qa runtime, schemas, tools, and execution services.",
   "keywords": [
@@ -33,6 +33,11 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
+    },
+    "./run-text-output": {
+      "types": "./dist/run-text-output.d.ts",
+      "import": "./dist/run-text-output.js",
+      "require": "./dist/run-text-output.cjs"
     }
   },
   "files": [
@@ -48,16 +53,15 @@
     "clean": "rm -rf dist .turbo"
   },
   "dependencies": {
-    "@vostride/agent-qa-ids": "0.2.3",
-    "@vostride/agent-qa-runner": "0.2.3",
-    "@vostride/agent-qa-schema": "0.2.3",
+    "@vostride/agent-qa-ids": "0.2.4",
+    "@vostride/agent-qa-runner": "0.2.4",
+    "@vostride/agent-qa-schema": "0.2.4",
     "ai": "6.0.174",
     "bytes": "3.1.2",
     "fast-xml-parser": "5.7.2",
     "glob": "13.0.6",
     "ms": "2.1.3",
     "picocolors": "1.1.1",
-    "playwright-core": "1.61.0",
     "semver": "7.8.1",
     "yaml": "2.8.4",
     "zod": "4.6.7"
@@ -66,7 +70,7 @@
     "@types/bytes": "~3.1.5",
     "@types/ms": "~2.1.0",
     "@types/node": "~24.12.2",
-    "@vostride/agent-qa-arch": "0.2.3",
+    "@vostride/agent-qa-arch": "0.2.4",
     "tsup": "~8.5.1",
     "typescript": "~6.0.3",
     "vitest": "~4.1.5"