@superatomai/sdk-node 0.0.32 → 0.0.33-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,305 @@
+"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;
+var QUERY_ROW_CAP = 250;
+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, limit: QUERY_ROW_CAP })
+      });
+      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);
+      }
+      if (json.metadata?.truncated) {
+        const total = json.metadata.totalCount ?? "more";
+        const hasGroupBy = /\bGROUP\s+BY\b/i.test(sql);
+        if (hasGroupBy) {
+          send({ type: "stream", chunk: `\u2139\uFE0F Only the top ${QUERY_ROW_CAP} of ${total} grouped rows are returned (query is already aggregated via GROUP BY) \u2014 expected for a top-N request.
+
+` });
+        } else {
+          const msg = `ctx.query truncated the result of this query to ${QUERY_ROW_CAP} rows (it matched ${total}). Do NOT compute over raw rows \u2014 AGGREGATE IN SQL (GROUP BY / mode() / mode(...) FILTER (WHERE \u2026) / COUNT(...) FILTER (\u2026) / CASE) so the query returns the final, already-reduced rows, then have getData return those.`;
+          send({ type: "stream", chunk: `\u274C **Result truncated on ${toolId}:** ${msg}
+
+` });
+          throw new Error(msg);
+        }
+      }
+      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) {
+  return 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 ?? (typeof mod.default === "function" ? mod.default : mod.default?.getData);
+    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
+    };
+    const flushed = send(result);
+    if (flushed) {
+      process.exit(0);
+    } else {
+      process.stdout.once("drain", () => 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.mjs

@@ -0,0 +1,303 @@
+// 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;
+var QUERY_ROW_CAP = 250;
+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, limit: QUERY_ROW_CAP })
+      });
+      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);
+      }
+      if (json.metadata?.truncated) {
+        const total = json.metadata.totalCount ?? "more";
+        const hasGroupBy = /\bGROUP\s+BY\b/i.test(sql);
+        if (hasGroupBy) {
+          send({ type: "stream", chunk: `\u2139\uFE0F Only the top ${QUERY_ROW_CAP} of ${total} grouped rows are returned (query is already aggregated via GROUP BY) \u2014 expected for a top-N request.
+
+` });
+        } else {
+          const msg = `ctx.query truncated the result of this query to ${QUERY_ROW_CAP} rows (it matched ${total}). Do NOT compute over raw rows \u2014 AGGREGATE IN SQL (GROUP BY / mode() / mode(...) FILTER (WHERE \u2026) / COUNT(...) FILTER (\u2026) / CASE) so the query returns the final, already-reduced rows, then have getData return those.`;
+          send({ type: "stream", chunk: `\u274C **Result truncated on ${toolId}:** ${msg}
+
+` });
+          throw new Error(msg);
+        }
+      }
+      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) {
+  return 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 ?? (typeof mod.default === "function" ? mod.default : mod.default?.getData);
+    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
+    };
+    const flushed = send(result);
+    if (flushed) {
+      process.exit(0);
+    } else {
+      process.stdout.once("drain", () => 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