@superatomai/sdk-node 0.0.2 → 0.0.3-dsp

package/dist/userResponse/scripts/script-bootstrap.d.mts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/userResponse/scripts/script-bootstrap.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/userResponse/scripts/script-bootstrap.js

@@ -0,0 +1,286 @@
+"use strict";
+
+// src/userResponse/scripts/script-bootstrap.ts
+var import_url = require("url");
+
+// src/userResponse/scripts/script-ipc.ts
+function encodeMessage(msg) {
+  return JSON.stringify(msg) + "\n";
+}
+var LineOverflowError = class extends Error {
+  constructor(buffered, limit) {
+    super(`IPC message exceeded ${limit} bytes without a newline (${buffered} buffered) \u2014 aborting to avoid unbounded memory.`);
+    this.buffered = buffered;
+    this.limit = limit;
+    this.name = "LineOverflowError";
+  }
+};
+var DEFAULT_MAX_IPC_BYTES = (() => {
+  const envVal = Number(process.env.SCRIPT_MAX_IPC_BYTES);
+  return Number.isFinite(envVal) && envVal > 0 ? Math.floor(envVal) : 64 * 1024 * 1024;
+})();
+var LineSplitter = class {
+  constructor(maxBytes = DEFAULT_MAX_IPC_BYTES) {
+    this.maxBytes = maxBytes;
+    this.buffer = "";
+  }
+  push(chunk) {
+    this.buffer += chunk;
+    const lines = [];
+    let idx;
+    while ((idx = this.buffer.indexOf("\n")) !== -1) {
+      const line = this.buffer.slice(0, idx);
+      this.buffer = this.buffer.slice(idx + 1);
+      if (line.length > 0) lines.push(line);
+    }
+    if (this.buffer.length > this.maxBytes) {
+      const buffered = this.buffer.length;
+      this.buffer = "";
+      throw new LineOverflowError(buffered, this.maxBytes);
+    }
+    return lines;
+  }
+  /** Flush any remaining partial data (useful on stream close) */
+  flush() {
+    if (this.buffer.length === 0) return null;
+    const rest = this.buffer;
+    this.buffer = "";
+    return rest;
+  }
+};
+
+// src/userResponse/scripts/script-bootstrap.ts
+var SCRIPT_ARG = process.argv[2];
+if (!SCRIPT_ARG) {
+  sendError("Bootstrap was invoked without a script path.", "compile");
+  process.exit(1);
+}
+var BRIDGE_URL = process.env.SCRIPT_BRIDGE_URL;
+var executedQueries = [];
+var PREVIEW_MAX_ROWS = 10;
+var PREVIEW_MAX_CHARS = 200;
+function previewRows(data) {
+  return data.slice(0, PREVIEW_MAX_ROWS).map((row) => {
+    if (!row || typeof row !== "object") return row;
+    const out = {};
+    for (const [k, v] of Object.entries(row)) {
+      out[k] = typeof v === "string" && v.length > PREVIEW_MAX_CHARS ? v.slice(0, PREVIEW_MAX_CHARS) + "\u2026" : v;
+    }
+    return out;
+  });
+}
+var initResolve = null;
+var initPromise = new Promise((resolve) => {
+  initResolve = resolve;
+});
+function buildCtx(init) {
+  return {
+    now: init.now,
+    async query(toolId, sql) {
+      if (!BRIDGE_URL) throw new Error("SCRIPT_BRIDGE_URL is not set \u2014 script bridge server is not running");
+      const startedAt = Date.now();
+      send({ type: "stream", chunk: `
+\u{1F4DD} **Querying ${toolId}:**
+\`\`\`sql
+${sql}
+\`\`\`
+
+` });
+      send({ type: "stream", chunk: `__QUERY_TIMER_START_Executing query__` });
+      const res = await fetch(`${BRIDGE_URL}/query`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ toolId, sql })
+      });
+      const json = await res.json();
+      const executionTimeMs = Date.now() - startedAt;
+      send({ type: "stream", chunk: `__QUERY_TIMER_DONE_${(executionTimeMs / 1e3).toFixed(1)}__
+
+` });
+      if (!res.ok || !json.success) {
+        const errMsg = json.error || `Bridge query failed (${res.status})`;
+        send({ type: "stream", chunk: `\u274C **Query failed on ${toolId}:** ${errMsg}
+
+` });
+        throw new Error(errMsg);
+      }
+      const data = json.data ?? [];
+      const count = json.count ?? data.length;
+      send({ type: "stream", chunk: `\u2705 **${count} rows from ${toolId}**
+
+` });
+      if (data.length > 0) {
+        send({ type: "stream", chunk: `<DataTable>${JSON.stringify(previewRows(data))}</DataTable>
+
+` });
+      }
+      executedQueries.push({
+        sourceId: toolId,
+        sourceName: toolId,
+        // enriched by runner after result arrives
+        sql,
+        data,
+        count,
+        executionTimeMs
+      });
+      return { data, count };
+    },
+    /**
+     * Call a tool with structured params (typically a direct tool whose
+     * fn(params) does not expect a SQL string). Returns whatever the tool
+     * returned — shape is up to the tool.
+     *
+     * Use this when you need a pre-built business-logic tool (e.g.,
+     * "Calculate Shelf Life") that takes structured input rather than SQL.
+     * For SQL source tools, keep using ctx.query.
+     *
+     * runTool results do NOT auto-flow into executedQueries. If you want
+     * the result visualised, register it via ctx.emit() after extracting
+     * the array you want to chart.
+     */
+    async runTool(toolId, params = {}) {
+      if (!BRIDGE_URL) throw new Error("SCRIPT_BRIDGE_URL is not set \u2014 script bridge server is not running");
+      const res = await fetch(`${BRIDGE_URL}/run-tool`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ toolId, params })
+      });
+      const json = await res.json();
+      if (!res.ok || !json.success) throw new Error(json.error || `Bridge run-tool failed (${res.status})`);
+      return json.result;
+    },
+    /**
+     * Register a computed dataset. Flows into executedQueries alongside
+     * real SQL query results so component generation can render post-SQL
+     * transforms (weighted averages, clustering, joins) as charts.
+     */
+    emit(name, rows, meta) {
+      executedQueries.push({
+        sourceId: `computed:${name}`,
+        sourceName: meta?.description || name,
+        sql: `-- computed dataset: ${name}`,
+        data: Array.isArray(rows) ? rows : [],
+        count: Array.isArray(rows) ? rows.length : 0,
+        executionTimeMs: 0,
+        virtual: true
+      });
+    },
+    /**
+     * Forward a short progress message to the parent's StreamBuffer so the UI
+     * continues to see per-script feedback during execution.
+     */
+    log(chunk) {
+      send({ type: "stream", chunk });
+    }
+  };
+}
+function send(msg) {
+  process.stdout.write(encodeMessage(msg));
+}
+function sendError(message, phase, stack) {
+  send({ type: "error", message, stack, phase });
+}
+var splitter = new LineSplitter();
+process.stdin.setEncoding("utf-8");
+process.stdin.on("data", (chunk) => {
+  let lines;
+  try {
+    lines = splitter.push(chunk);
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    sendError(msg, "runtime");
+    process.exit(1);
+  }
+  for (const line of lines) {
+    let msg;
+    try {
+      msg = JSON.parse(line);
+    } catch {
+      continue;
+    }
+    handleMessage(msg);
+  }
+});
+function handleMessage(msg) {
+  switch (msg.type) {
+    case "init": {
+      if (initResolve) {
+        const now = new Date(msg.now || (/* @__PURE__ */ new Date()).toISOString());
+        const params = restoreParamTypes(msg.params || {}, msg.paramSchema);
+        initResolve({ params, now });
+        initResolve = null;
+      }
+      break;
+    }
+  }
+}
+(async () => {
+  let getData;
+  try {
+    const mod = await import((0, import_url.pathToFileURL)(SCRIPT_ARG).href);
+    getData = mod.getData ?? mod.default;
+    if (typeof getData !== "function") {
+      throw new Error(
+        `Script at ${SCRIPT_ARG} does not export getData \u2014 expected \`export async function getData(ctx, params)\``
+      );
+    }
+  } catch (err) {
+    const e = err;
+    sendError(e.message || String(err), "compile", e.stack);
+    process.exit(1);
+    return;
+  }
+  const init = await initPromise;
+  const ctx = buildCtx(init);
+  const startedAt = Date.now();
+  try {
+    const raw = await getData(ctx, init.params);
+    const executionTimeMs = Date.now() - startedAt;
+    const data = normalizeResultData(raw);
+    const count = typeof raw?.count === "number" ? raw.count : data.length;
+    const sampleRows = data.slice(0, 5);
+    const result = {
+      type: "result",
+      data,
+      count,
+      executedQueries,
+      executionTimeMs,
+      sampleRows
+    };
+    send(result);
+    process.stdout.once("drain", () => process.exit(0));
+    setImmediate(() => process.exit(0));
+  } catch (err) {
+    const e = err;
+    sendError(e.message || String(err), "runtime", e.stack);
+    process.exit(1);
+  }
+})();
+function normalizeResultData(raw) {
+  if (!raw) return [];
+  if (Array.isArray(raw)) return raw;
+  if (Array.isArray(raw.data)) return raw.data;
+  if (raw.data && typeof raw.data === "object") return [raw.data];
+  return [];
+}
+function restoreParamTypes(params, schema) {
+  if (!schema) return params;
+  const out = { ...params };
+  for (const [name, type] of Object.entries(schema)) {
+    const v = out[name];
+    if (v === void 0 || v === null) continue;
+    if (type === "date" && typeof v === "string") {
+      const d = new Date(v);
+      if (!isNaN(d.getTime())) out[name] = d;
+    } else if (type === "date_range" && typeof v === "object") {
+      const from = v.from;
+      const to = v.to;
+      out[name] = {
+        from: typeof from === "string" ? new Date(from) : from,
+        to: typeof to === "string" ? new Date(to) : to
+      };
+    }
+  }
+  return out;
+}
+//# sourceMappingURL=script-bootstrap.js.map

package/dist/userResponse/scripts/script-bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/userResponse/scripts/script-bootstrap.ts","../../../src/userResponse/scripts/script-ipc.ts"],"sourcesContent":["/**\n * script-bootstrap.ts — Child-side entrypoint for subprocess script execution.\n *\n * Runs as a separate process spawned by ScriptRunner via tsx. Reads the\n * target user-script path from argv[2], listens for INIT on stdin, builds\n * the ctx object, dynamic-imports the user script's `getData` export,\n * and reports the result (or error) back via stdout.\n *\n * See backend/docs/SCRIPT-FLOW-IMPLEMENTATION.md § IPC Bridge.\n */\n\nimport { pathToFileURL } from 'url';\nimport {\n\tencodeMessage,\n\tLineSplitter,\n\ttype ChildToParentMessage,\n\ttype ParentToChildMessage,\n\ttype ExecutedQuery,\n} from './script-ipc';\n\nconst SCRIPT_ARG = process.argv[2];\nif (!SCRIPT_ARG) {\n\tsendError('Bootstrap was invoked without a script path.', 'compile');\n\tprocess.exit(1);\n}\n\nconst BRIDGE_URL = process.env.SCRIPT_BRIDGE_URL;\n\n/** Completed queries — reported to the parent as part of RESULT */\nconst executedQueries: ExecutedQuery[] = [];\n\n// Stream-preview limits — kept in sync with the SDK's STREAM_PREVIEW_* constants.\n// Inlined (not imported) so this child-process bundle stays minimal.\nconst PREVIEW_MAX_ROWS = 10;\nconst PREVIEW_MAX_CHARS = 200;\n\n/** Bounded, char-truncated preview of result rows for the live <DataTable> stream. */\nfunction previewRows(data: any[]): any[] {\n\treturn data.slice(0, PREVIEW_MAX_ROWS).map((row) => {\n\t\tif (!row || typeof row !== 'object') return row;\n\t\tconst out: Record<string, any> = {};\n\t\tfor (const [k, v] of Object.entries(row)) {\n\t\t\tout[k] = (typeof v === 'string' && v.length > PREVIEW_MAX_CHARS)\n\t\t\t\t? v.slice(0, PREVIEW_MAX_CHARS) + '…'\n\t\t\t\t: v;\n\t\t}\n\t\treturn out;\n\t});\n}\n\n/** Resolvers for the INIT handshake — getData waits for this */\nlet initResolve: ((init: { params: Record<string, any>; now: Date }) => void) | null = null;\nconst initPromise = new Promise<{ params: Record<string, any>; now: Date }>((resolve) => {\n\tinitResolve = resolve;\n});\n\n/**\n * Source name lookup is not available in the child (the parent holds the\n * ExternalTool list). We use toolId as sourceName and let the parent fill\n * it in when building the final ScriptResult, if needed.\n */\nfunction buildCtx(init: { params: Record<string, any>; now: Date }) {\n\treturn {\n\t\tnow: init.now,\n\n\t\tasync query(toolId: string, sql: string): Promise<{ data: any[]; count: number }> {\n\t\t\tif (!BRIDGE_URL) throw new Error('SCRIPT_BRIDGE_URL is not set — script bridge server is not running');\n\n\t\t\tconst startedAt = Date.now();\n\n\t\t\tsend({ type: 'stream', chunk: `\\n📝 **Querying ${toolId}:**\\n\\`\\`\\`sql\\n${sql}\\n\\`\\`\\`\\n\\n` });\n\t\t\tsend({ type: 'stream', chunk: `__QUERY_TIMER_START_Executing query__` });\n\n\t\t\tconst res = await fetch(`${BRIDGE_URL}/query`, {\n\t\t\t\tmethod: 'POST',\n\t\t\t\theaders: { 'content-type': 'application/json' },\n\t\t\t\tbody: JSON.stringify({ toolId, sql }),\n\t\t\t});\n\n\t\t\tconst json = await res.json() as any;\n\t\t\tconst executionTimeMs = Date.now() - startedAt;\n\n\t\t\tsend({ type: 'stream', chunk: `__QUERY_TIMER_DONE_${(executionTimeMs / 1000).toFixed(1)}__\\n\\n` });\n\n\t\t\tif (!res.ok || !json.success) {\n\t\t\t\tconst errMsg = json.error || `Bridge query failed (${res.status})`;\n\t\t\t\tsend({ type: 'stream', chunk: `❌ **Query failed on ${toolId}:** ${errMsg}\\n\\n` });\n\t\t\t\tthrow new Error(errMsg);\n\t\t\t}\n\n\t\t\tconst data: any[] = json.data ?? [];\n\t\t\tconst count: number = json.count ?? data.length;\n\n\t\t\tsend({ type: 'stream', chunk: `✅ **${count} rows from ${toolId}**\\n\\n` });\n\t\t\tif (data.length > 0) {\n\t\t\t\tsend({ type: 'stream', chunk: `<DataTable>${JSON.stringify(previewRows(data))}</DataTable>\\n\\n` });\n\t\t\t}\n\n\t\t\texecutedQueries.push({\n\t\t\t\tsourceId: toolId,\n\t\t\t\tsourceName: toolId, // enriched by runner after result arrives\n\t\t\t\tsql,\n\t\t\t\tdata,\n\t\t\t\tcount,\n\t\t\t\texecutionTimeMs,\n\t\t\t});\n\n\t\t\treturn { data, count };\n\t\t},\n\n\t\t/**\n\t\t * Call a tool with structured params (typically a direct tool whose\n\t\t * fn(params) does not expect a SQL string). Returns whatever the tool\n\t\t * returned — shape is up to the tool.\n\t\t *\n\t\t * Use this when you need a pre-built business-logic tool (e.g.,\n\t\t * \"Calculate Shelf Life\") that takes structured input rather than SQL.\n\t\t * For SQL source tools, keep using ctx.query.\n\t\t *\n\t\t * runTool results do NOT auto-flow into executedQueries. If you want\n\t\t * the result visualised, register it via ctx.emit() after extracting\n\t\t * the array you want to chart.\n\t\t */\n\t\tasync runTool<T = any>(toolId: string, params: Record<string, any> = {}): Promise<T> {\n\t\t\tif (!BRIDGE_URL) throw new Error('SCRIPT_BRIDGE_URL is not set — script bridge server is not running');\n\n\t\t\tconst res = await fetch(`${BRIDGE_URL}/run-tool`, {\n\t\t\t\tmethod: 'POST',\n\t\t\t\theaders: { 'content-type': 'application/json' },\n\t\t\t\tbody: JSON.stringify({ toolId, params }),\n\t\t\t});\n\n\t\t\tconst json = await res.json() as any;\n\t\t\tif (!res.ok || !json.success) throw new Error(json.error || `Bridge run-tool failed (${res.status})`);\n\n\t\t\treturn json.result as T;\n\t\t},\n\n\t\t/**\n\t\t * Register a computed dataset. Flows into executedQueries alongside\n\t\t * real SQL query results so component generation can render post-SQL\n\t\t * transforms (weighted averages, clustering, joins) as charts.\n\t\t */\n\t\temit(name: string, rows: any[], meta?: { description?: string }): void {\n\t\t\texecutedQueries.push({\n\t\t\t\tsourceId: `computed:${name}`,\n\t\t\t\tsourceName: meta?.description || name,\n\t\t\t\tsql: `-- computed dataset: ${name}`,\n\t\t\t\tdata: Array.isArray(rows) ? rows : [],\n\t\t\t\tcount: Array.isArray(rows) ? rows.length : 0,\n\t\t\t\texecutionTimeMs: 0,\n\t\t\t\tvirtual: true,\n\t\t\t});\n\t\t},\n\n\t\t/**\n\t\t * Forward a short progress message to the parent's StreamBuffer so the UI\n\t\t * continues to see per-script feedback during execution.\n\t\t */\n\t\tlog(chunk: string): void {\n\t\t\tsend({ type: 'stream', chunk });\n\t\t},\n\t};\n}\n\nfunction send(msg: ChildToParentMessage): void {\n\tprocess.stdout.write(encodeMessage(msg));\n}\n\nfunction sendError(message: string, phase: 'compile' | 'runtime', stack?: string): void {\n\tsend({ type: 'error', message, stack, phase });\n}\n\n// ============================================\n// stdin reader — parse NDJSON messages from the parent (INIT only)\n// ============================================\n\nconst splitter = new LineSplitter();\n\nprocess.stdin.setEncoding('utf-8');\nprocess.stdin.on('data', (chunk: string) => {\n\tlet lines: string[];\n\ttry {\n\t\tlines = splitter.push(chunk);\n\t} catch (err) {\n\t\tconst msg = err instanceof Error ? err.message : String(err);\n\t\tsendError(msg, 'runtime');\n\t\tprocess.exit(1);\n\t}\n\tfor (const line of lines) {\n\t\tlet msg: ParentToChildMessage;\n\t\ttry {\n\t\t\tmsg = JSON.parse(line);\n\t\t} catch {\n\t\t\tcontinue;\n\t\t}\n\t\thandleMessage(msg);\n\t}\n});\n\nfunction handleMessage(msg: ParentToChildMessage): void {\n\tswitch (msg.type) {\n\t\tcase 'init': {\n\t\t\tif (initResolve) {\n\t\t\t\tconst now = new Date(msg.now || new Date().toISOString());\n\t\t\t\tconst params = restoreParamTypes(msg.params || {}, msg.paramSchema);\n\t\t\t\tinitResolve({ params, now });\n\t\t\t\tinitResolve = null;\n\t\t\t}\n\t\t\tbreak;\n\t\t}\n\t}\n}\n\n// ============================================\n// Main — import the user script and run getData\n// ============================================\n\n(async () => {\n\tlet getData: (ctx: any, params: any) => Promise<any>;\n\n\ttry {\n\t\t// Dynamic import — tsx transpiles the user .ts file on the fly\n\t\tconst mod = await import(pathToFileURL(SCRIPT_ARG).href);\n\t\tgetData = mod.getData ?? mod.default;\n\t\tif (typeof getData !== 'function') {\n\t\t\tthrow new Error(\n\t\t\t\t`Script at ${SCRIPT_ARG} does not export getData — expected \\`export async function getData(ctx, params)\\``,\n\t\t\t);\n\t\t}\n\t} catch (err) {\n\t\tconst e = err as Error;\n\t\tsendError(e.message || String(err), 'compile', e.stack);\n\t\tprocess.exit(1);\n\t\treturn;\n\t}\n\n\tconst init = await initPromise;\n\tconst ctx = buildCtx(init);\n\tconst startedAt = Date.now();\n\n\ttry {\n\t\tconst raw = await getData(ctx, init.params);\n\t\tconst executionTimeMs = Date.now() - startedAt;\n\n\t\tconst data = normalizeResultData(raw);\n\t\tconst count = typeof raw?.count === 'number' ? raw.count : data.length;\n\t\tconst sampleRows = data.slice(0, 5);\n\n\t\tconst result: ChildToParentMessage = {\n\t\t\ttype: 'result',\n\t\t\tdata,\n\t\t\tcount,\n\t\t\texecutedQueries,\n\t\t\texecutionTimeMs,\n\t\t\tsampleRows,\n\t\t};\n\t\tsend(result);\n\t\t// Give stdout a tick to flush before we exit\n\t\tprocess.stdout.once('drain', () => process.exit(0));\n\t\tsetImmediate(() => process.exit(0));\n\t} catch (err) {\n\t\tconst e = err as Error;\n\t\tsendError(e.message || String(err), 'runtime', e.stack);\n\t\tprocess.exit(1);\n\t}\n})();\n\n/**\n * Normalize whatever getData returned into an array. Mirrors the old\n * ScriptRunner semantics: direct array, { data: [] }, or { data: {...} }\n * wrapped as single-element array.\n */\nfunction normalizeResultData(raw: any): any[] {\n\tif (!raw) return [];\n\tif (Array.isArray(raw)) return raw;\n\tif (Array.isArray(raw.data)) return raw.data;\n\tif (raw.data && typeof raw.data === 'object') return [raw.data];\n\treturn [];\n}\n\n/**\n * Restore typed values that JSON stripped during IPC transport. Date and\n * date_range params arrive as ISO strings; re-wrap them so scripts can call\n * `.toISOString()` and other Date methods the same way they would in-process.\n */\nfunction restoreParamTypes(\n\tparams: Record<string, any>,\n\tschema?: Record<string, 'string' | 'number' | 'date' | 'date_range' | 'enum' | 'boolean'>,\n): Record<string, any> {\n\tif (!schema) return params;\n\tconst out = { ...params };\n\tfor (const [name, type] of Object.entries(schema)) {\n\t\tconst v = out[name];\n\t\tif (v === undefined || v === null) continue;\n\t\tif (type === 'date' && typeof v === 'string') {\n\t\t\tconst d = new Date(v);\n\t\t\tif (!isNaN(d.getTime())) out[name] = d;\n\t\t} else if (type === 'date_range' && typeof v === 'object') {\n\t\t\tconst from = v.from;\n\t\t\tconst to = v.to;\n\t\t\tout[name] = {\n\t\t\t\tfrom: typeof from === 'string' ? new Date(from) : from,\n\t\t\t\tto: typeof to === 'string' ? new Date(to) : to,\n\t\t\t};\n\t\t}\n\t}\n\treturn out;\n}\n","/**\n * script-ipc.ts — Protocol definitions for parent/child IPC.\n *\n * Transport: newline-delimited JSON over the child's stdin/stdout.\n * stderr is passed through for uncaught exceptions and compile errors.\n *\n * See backend/docs/SCRIPT-FLOW-IMPLEMENTATION.md § IPC Bridge.\n */\n\n// ============================================\n// Parent → Child\n// ============================================\n\nexport interface InitMessage {\n\ttype: 'init';\n\t/**\n\t * Params passed to getData(). Date/date_range values cross the IPC boundary\n\t * as ISO strings and are restored to Date objects in the child via paramSchema.\n\t */\n\tparams: Record<string, any>;\n\t/** Frozen timestamp for ctx.now — ISO string */\n\tnow: string;\n\t/**\n\t * Maps each parameter name to its declared type so the child can restore\n\t * Date objects (lost during JSON serialization).\n\t */\n\tparamSchema?: Record<string, 'string' | 'number' | 'date' | 'date_range' | 'enum' | 'boolean'>;\n}\n\nexport interface QueryResultMessage {\n\ttype: 'query_result';\n\t/** Matches the `id` from the child's QUERY message */\n\tid: string;\n\tdata: any[];\n\tcount: number;\n\tmetadata?: {\n\t\ttotalCount?: number;\n\t\texecutionTimeMs?: number;\n\t};\n}\n\nexport interface QueryErrorMessage {\n\ttype: 'query_error';\n\tid: string;\n\terror: string;\n}\n\n/**\n * Response to a `run_tool` request — carries whatever the direct-tool's fn()\n * returned. Shape is arbitrary; the script is expected to know what its chosen\n * tool yields and unwrap accordingly.\n */\nexport interface RunToolResultMessage {\n\ttype: 'run_tool_result';\n\tid: string;\n\tresult: any;\n}\n\nexport type ParentToChildMessage =\n\t| InitMessage\n\t| QueryResultMessage\n\t| QueryErrorMessage\n\t| RunToolResultMessage;\n\n// ============================================\n// Child → Parent\n// ============================================\n\nexport interface QueryMessage {\n\ttype: 'query';\n\t/** Short uuid — parent uses this to correlate its response */\n\tid: string;\n\ttoolId: string;\n\tsql: string;\n}\n\n/**\n * Run an arbitrary tool with structured params. Used by ctx.runTool() to call\n * direct tools (and any tool whose `fn(params)` doesn't expect a SQL string).\n * Reply is RunToolResultMessage or QueryErrorMessage.\n */\nexport interface RunToolMessage {\n\ttype: 'run_tool';\n\tid: string;\n\ttoolId: string;\n\tparams: Record<string, any>;\n}\n\nexport interface StreamMessage {\n\ttype: 'stream';\n\tchunk: string;\n}\n\nexport interface ExecutedQuery {\n\tsourceId: string;\n\tsourceName: string;\n\tsql: string;\n\tdata: any[];\n\tcount: number;\n\ttotalCount?: number;\n\texecutionTimeMs: number;\n\t/**\n\t * When the script registered a computed dataset via ctx.emit(), this is\n\t * marked virtual so component generation can distinguish it from a real SQL query.\n\t */\n\tvirtual?: boolean;\n}\n\nexport interface ResultMessage {\n\ttype: 'result';\n\tdata: any[];\n\tcount: number;\n\texecutedQueries: ExecutedQuery[];\n\texecutionTimeMs: number;\n\t/** First 5 rows of the final `data` — lets the parent judge intent-match cheaply */\n\tsampleRows: any[];\n}\n\nexport interface ErrorMessage {\n\ttype: 'error';\n\tmessage: string;\n\tstack?: string;\n\t/** \"compile\" → tsx couldn't parse; \"runtime\" → thrown during getData */\n\tphase?: 'compile' | 'runtime';\n}\n\nexport type ChildToParentMessage =\n\t| QueryMessage\n\t| RunToolMessage\n\t| StreamMessage\n\t| ResultMessage\n\t| ErrorMessage;\n\n// ============================================\n// Utilities\n// ============================================\n\n/**\n * Encode a message for transport: JSON + newline.\n */\nexport function encodeMessage(msg: ParentToChildMessage | ChildToParentMessage): string {\n\treturn JSON.stringify(msg) + '\\n';\n}\n\n/**\n * Thrown when a single NDJSON line grows past the byte ceiling without a\n * newline — a runaway writer or a pathologically large message. Callers abort\n * (kill the child / exit) instead of buffering toward OOM. See #9 in\n * backend/docs/SCRIPT-FLOW-SCALING-ISSUES.md.\n */\nexport class LineOverflowError extends Error {\n\tconstructor(public readonly buffered: number, public readonly limit: number) {\n\t\tsuper(`IPC message exceeded ${limit} bytes without a newline (${buffered} buffered) — aborting to avoid unbounded memory.`);\n\t\tthis.name = 'LineOverflowError';\n\t}\n}\n\n/** Default per-message ceiling — generous enough for large result sets, low\n *  enough to catch a runaway/infinite writer. Override via SCRIPT_MAX_IPC_BYTES. */\nconst DEFAULT_MAX_IPC_BYTES = (() => {\n\tconst envVal = Number(process.env.SCRIPT_MAX_IPC_BYTES);\n\treturn Number.isFinite(envVal) && envVal > 0 ? Math.floor(envVal) : 64 * 1024 * 1024;\n})();\n\n/**\n * Split a stream of data chunks on newlines and emit each complete JSON line.\n * Partial lines are buffered until the next chunk arrives, up to `maxBytes` —\n * past which `push` throws `LineOverflowError` rather than grow unbounded.\n */\nexport class LineSplitter {\n\tprivate buffer = '';\n\n\tconstructor(private readonly maxBytes: number = DEFAULT_MAX_IPC_BYTES) {}\n\n\tpush(chunk: string): string[] {\n\t\tthis.buffer += chunk;\n\t\tconst lines: string[] = [];\n\t\tlet idx: number;\n\t\twhile ((idx = this.buffer.indexOf('\\n')) !== -1) {\n\t\t\tconst line = this.buffer.slice(0, idx);\n\t\t\tthis.buffer = this.buffer.slice(idx + 1);\n\t\t\tif (line.length > 0) lines.push(line);\n\t\t}\n\t\t// A partial line past the ceiling means no newline is coming (or the\n\t\t// message is pathologically large). Drop the buffer and signal abort.\n\t\tif (this.buffer.length > this.maxBytes) {\n\t\t\tconst buffered = this.buffer.length;\n\t\t\tthis.buffer = '';\n\t\t\tthrow new LineOverflowError(buffered, this.maxBytes);\n\t\t}\n\t\treturn lines;\n\t}\n\n\t/** Flush any remaining partial data (useful on stream close) */\n\tflush(): string | null {\n\t\tif (this.buffer.length === 0) return null;\n\t\tconst rest = this.buffer;\n\t\tthis.buffer = '';\n\t\treturn rest;\n\t}\n}\n\n/**\n * Generate a short correlation id for in-flight queries.\n * Collision within a single execution is astronomically unlikely.\n */\nexport function shortId(): string {\n\treturn Math.random().toString(36).slice(2, 10);\n}\n"],"mappings":"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","names":[]}

package/dist/userResponse/scripts/script-bootstrap.mjs

@@ -0,0 +1,284 @@
+// src/userResponse/scripts/script-bootstrap.ts
+import { pathToFileURL } from "url";
+
+// src/userResponse/scripts/script-ipc.ts
+function encodeMessage(msg) {
+  return JSON.stringify(msg) + "\n";
+}
+var LineOverflowError = class extends Error {
+  constructor(buffered, limit) {
+    super(`IPC message exceeded ${limit} bytes without a newline (${buffered} buffered) \u2014 aborting to avoid unbounded memory.`);
+    this.buffered = buffered;
+    this.limit = limit;
+    this.name = "LineOverflowError";
+  }
+};
+var DEFAULT_MAX_IPC_BYTES = (() => {
+  const envVal = Number(process.env.SCRIPT_MAX_IPC_BYTES);
+  return Number.isFinite(envVal) && envVal > 0 ? Math.floor(envVal) : 64 * 1024 * 1024;
+})();
+var LineSplitter = class {
+  constructor(maxBytes = DEFAULT_MAX_IPC_BYTES) {
+    this.maxBytes = maxBytes;
+    this.buffer = "";
+  }
+  push(chunk) {
+    this.buffer += chunk;
+    const lines = [];
+    let idx;
+    while ((idx = this.buffer.indexOf("\n")) !== -1) {
+      const line = this.buffer.slice(0, idx);
+      this.buffer = this.buffer.slice(idx + 1);
+      if (line.length > 0) lines.push(line);
+    }
+    if (this.buffer.length > this.maxBytes) {
+      const buffered = this.buffer.length;
+      this.buffer = "";
+      throw new LineOverflowError(buffered, this.maxBytes);
+    }
+    return lines;
+  }
+  /** Flush any remaining partial data (useful on stream close) */
+  flush() {
+    if (this.buffer.length === 0) return null;
+    const rest = this.buffer;
+    this.buffer = "";
+    return rest;
+  }
+};
+
+// src/userResponse/scripts/script-bootstrap.ts
+var SCRIPT_ARG = process.argv[2];
+if (!SCRIPT_ARG) {
+  sendError("Bootstrap was invoked without a script path.", "compile");
+  process.exit(1);
+}
+var BRIDGE_URL = process.env.SCRIPT_BRIDGE_URL;
+var executedQueries = [];
+var PREVIEW_MAX_ROWS = 10;
+var PREVIEW_MAX_CHARS = 200;
+function previewRows(data) {
+  return data.slice(0, PREVIEW_MAX_ROWS).map((row) => {
+    if (!row || typeof row !== "object") return row;
+    const out = {};
+    for (const [k, v] of Object.entries(row)) {
+      out[k] = typeof v === "string" && v.length > PREVIEW_MAX_CHARS ? v.slice(0, PREVIEW_MAX_CHARS) + "\u2026" : v;
+    }
+    return out;
+  });
+}
+var initResolve = null;
+var initPromise = new Promise((resolve) => {
+  initResolve = resolve;
+});
+function buildCtx(init) {
+  return {
+    now: init.now,
+    async query(toolId, sql) {
+      if (!BRIDGE_URL) throw new Error("SCRIPT_BRIDGE_URL is not set \u2014 script bridge server is not running");
+      const startedAt = Date.now();
+      send({ type: "stream", chunk: `
+\u{1F4DD} **Querying ${toolId}:**
+\`\`\`sql
+${sql}
+\`\`\`
+
+` });
+      send({ type: "stream", chunk: `__QUERY_TIMER_START_Executing query__` });
+      const res = await fetch(`${BRIDGE_URL}/query`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ toolId, sql })
+      });
+      const json = await res.json();
+      const executionTimeMs = Date.now() - startedAt;
+      send({ type: "stream", chunk: `__QUERY_TIMER_DONE_${(executionTimeMs / 1e3).toFixed(1)}__
+
+` });
+      if (!res.ok || !json.success) {
+        const errMsg = json.error || `Bridge query failed (${res.status})`;
+        send({ type: "stream", chunk: `\u274C **Query failed on ${toolId}:** ${errMsg}
+
+` });
+        throw new Error(errMsg);
+      }
+      const data = json.data ?? [];
+      const count = json.count ?? data.length;
+      send({ type: "stream", chunk: `\u2705 **${count} rows from ${toolId}**
+
+` });
+      if (data.length > 0) {
+        send({ type: "stream", chunk: `<DataTable>${JSON.stringify(previewRows(data))}</DataTable>
+
+` });
+      }
+      executedQueries.push({
+        sourceId: toolId,
+        sourceName: toolId,
+        // enriched by runner after result arrives
+        sql,
+        data,
+        count,
+        executionTimeMs
+      });
+      return { data, count };
+    },
+    /**
+     * Call a tool with structured params (typically a direct tool whose
+     * fn(params) does not expect a SQL string). Returns whatever the tool
+     * returned — shape is up to the tool.
+     *
+     * Use this when you need a pre-built business-logic tool (e.g.,
+     * "Calculate Shelf Life") that takes structured input rather than SQL.
+     * For SQL source tools, keep using ctx.query.
+     *
+     * runTool results do NOT auto-flow into executedQueries. If you want
+     * the result visualised, register it via ctx.emit() after extracting
+     * the array you want to chart.
+     */
+    async runTool(toolId, params = {}) {
+      if (!BRIDGE_URL) throw new Error("SCRIPT_BRIDGE_URL is not set \u2014 script bridge server is not running");
+      const res = await fetch(`${BRIDGE_URL}/run-tool`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ toolId, params })
+      });
+      const json = await res.json();
+      if (!res.ok || !json.success) throw new Error(json.error || `Bridge run-tool failed (${res.status})`);
+      return json.result;
+    },
+    /**
+     * Register a computed dataset. Flows into executedQueries alongside
+     * real SQL query results so component generation can render post-SQL
+     * transforms (weighted averages, clustering, joins) as charts.
+     */
+    emit(name, rows, meta) {
+      executedQueries.push({
+        sourceId: `computed:${name}`,
+        sourceName: meta?.description || name,
+        sql: `-- computed dataset: ${name}`,
+        data: Array.isArray(rows) ? rows : [],
+        count: Array.isArray(rows) ? rows.length : 0,
+        executionTimeMs: 0,
+        virtual: true
+      });
+    },
+    /**
+     * Forward a short progress message to the parent's StreamBuffer so the UI
+     * continues to see per-script feedback during execution.
+     */
+    log(chunk) {
+      send({ type: "stream", chunk });
+    }
+  };
+}
+function send(msg) {
+  process.stdout.write(encodeMessage(msg));
+}
+function sendError(message, phase, stack) {
+  send({ type: "error", message, stack, phase });
+}
+var splitter = new LineSplitter();
+process.stdin.setEncoding("utf-8");
+process.stdin.on("data", (chunk) => {
+  let lines;
+  try {
+    lines = splitter.push(chunk);
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    sendError(msg, "runtime");
+    process.exit(1);
+  }
+  for (const line of lines) {
+    let msg;
+    try {
+      msg = JSON.parse(line);
+    } catch {
+      continue;
+    }
+    handleMessage(msg);
+  }
+});
+function handleMessage(msg) {
+  switch (msg.type) {
+    case "init": {
+      if (initResolve) {
+        const now = new Date(msg.now || (/* @__PURE__ */ new Date()).toISOString());
+        const params = restoreParamTypes(msg.params || {}, msg.paramSchema);
+        initResolve({ params, now });
+        initResolve = null;
+      }
+      break;
+    }
+  }
+}
+(async () => {
+  let getData;
+  try {
+    const mod = await import(pathToFileURL(SCRIPT_ARG).href);
+    getData = mod.getData ?? mod.default;
+    if (typeof getData !== "function") {
+      throw new Error(
+        `Script at ${SCRIPT_ARG} does not export getData \u2014 expected \`export async function getData(ctx, params)\``
+      );
+    }
+  } catch (err) {
+    const e = err;
+    sendError(e.message || String(err), "compile", e.stack);
+    process.exit(1);
+    return;
+  }
+  const init = await initPromise;
+  const ctx = buildCtx(init);
+  const startedAt = Date.now();
+  try {
+    const raw = await getData(ctx, init.params);
+    const executionTimeMs = Date.now() - startedAt;
+    const data = normalizeResultData(raw);
+    const count = typeof raw?.count === "number" ? raw.count : data.length;
+    const sampleRows = data.slice(0, 5);
+    const result = {
+      type: "result",
+      data,
+      count,
+      executedQueries,
+      executionTimeMs,
+      sampleRows
+    };
+    send(result);
+    process.stdout.once("drain", () => process.exit(0));
+    setImmediate(() => process.exit(0));
+  } catch (err) {
+    const e = err;
+    sendError(e.message || String(err), "runtime", e.stack);
+    process.exit(1);
+  }
+})();
+function normalizeResultData(raw) {
+  if (!raw) return [];
+  if (Array.isArray(raw)) return raw;
+  if (Array.isArray(raw.data)) return raw.data;
+  if (raw.data && typeof raw.data === "object") return [raw.data];
+  return [];
+}
+function restoreParamTypes(params, schema) {
+  if (!schema) return params;
+  const out = { ...params };
+  for (const [name, type] of Object.entries(schema)) {
+    const v = out[name];
+    if (v === void 0 || v === null) continue;
+    if (type === "date" && typeof v === "string") {
+      const d = new Date(v);
+      if (!isNaN(d.getTime())) out[name] = d;
+    } else if (type === "date_range" && typeof v === "object") {
+      const from = v.from;
+      const to = v.to;
+      out[name] = {
+        from: typeof from === "string" ? new Date(from) : from,
+        to: typeof to === "string" ? new Date(to) : to
+      };
+    }
+  }
+  return out;
+}
+//# sourceMappingURL=script-bootstrap.mjs.map