aui-agent-builder 0.3.149 → 0.3.151

package/dist/utils/payload-store.js

@@ -0,0 +1,82 @@
+/**
+ * Payload store — offload very large runtime payloads to disk.
+ *
+ * Coding agents (Claude Code, agent-builder-bff, …) call `aui` non-interactively
+ * and read the JSON it prints into their context window. Some runtime payloads —
+ * notably `aui apollo trace` and a `send-message`/`rerun` response with
+ * `trace_info` attached — are huge (tens to hundreds of KB) and blow up that
+ * context window, making the agent slow or unable to use the result.
+ *
+ * Instead of inlining those payloads, we write the full object to a `metadata/`
+ * folder inside the relevant agent project and return a small pointer telling
+ * the caller where to read it (with grep / cat / their editor). The folder is
+ * created on demand — no setup required.
+ */
+import * as fs from "fs";
+import * as path from "path";
+/**
+ * Serialized-JSON byte size at/under which a payload is small enough to inline
+ * directly in the command's JSON output. Larger payloads are written to disk.
+ * Override with `AUI_PAYLOAD_INLINE_MAX_BYTES` (e.g. `0` to always offload).
+ */
+const DEFAULT_INLINE_MAX_BYTES = 10_000;
+/** Resolve the inline-size ceiling, honoring the env override when valid. */
+export function inlineMaxBytes() {
+    const raw = process.env.AUI_PAYLOAD_INLINE_MAX_BYTES;
+    if (raw !== undefined) {
+        const n = Number(raw);
+        if (Number.isFinite(n) && n >= 0)
+            return n;
+    }
+    return DEFAULT_INLINE_MAX_BYTES;
+}
+/** Byte length of a payload once serialized to JSON. */
+export function serializedBytes(payload) {
+    return Buffer.byteLength(JSON.stringify(payload) ?? "", "utf8");
+}
+/** Slugify an arbitrary string into a filesystem-safe file-name base. */
+function safeBaseName(input) {
+    return (input
+        .toLowerCase()
+        .replace(/[\/\\:*?"<>|]/g, "-")
+        .replace(/\s+/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-|-$/g, "") || "payload");
+}
+/**
+ * Persist a (potentially huge) payload to the `metadata/` folder inside the
+ * relevant agent project so it never has to travel through a coding agent's
+ * context window. Creates the folder if it doesn't exist.
+ *
+ * @param projectRoot The agent project root (`.auirc` dir). Falls back to the
+ *                     current working directory when undefined.
+ * @param baseName    A descriptive base for the file name (e.g. `trace-<taskId>`).
+ * @param payload     The complete object to write (serialized as pretty JSON).
+ */
+export function savePayloadToMetadata(projectRoot, baseName, payload) {
+    const root = projectRoot || process.cwd();
+    const dir = path.join(root, "metadata");
+    fs.mkdirSync(dir, { recursive: true });
+    // Colons are illegal in file names on some platforms, so flatten the ISO
+    // timestamp. This keeps each saved payload distinct and chronologically
+    // sortable without clobbering earlier ones.
+    const stamp = new Date().toISOString().replace(/[:.]/g, "-");
+    const fileName = `${safeBaseName(baseName)}-${stamp}.json`;
+    const abs = path.join(dir, fileName);
+    const serialized = JSON.stringify(payload, null, 2);
+    fs.writeFileSync(abs, serialized + "\n", "utf8");
+    return {
+        path: abs,
+        relativePath: path.relative(process.cwd(), abs) || fileName,
+        bytes: Buffer.byteLength(serialized, "utf8"),
+    };
+}
+/** Human-readable byte size (e.g. "42.7 KB"). */
+export function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+//# sourceMappingURL=payload-store.js.map

package/dist/utils/payload-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload-store.js","sourceRoot":"","sources":["../../src/utils/payload-store.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aui-agent-builder",
-  "version": "0.3.149",
+  "version": "0.3.151",
   "description": "CLI for building, managing, and deploying AUI AI agent configurations",
   "type": "module",
   "main": "dist/index.js",