@superatomai/sdk-node 0.0.84-dsp → 0.0.86-dsp

package/dist/index.d.mts

@@ -1624,6 +1624,8 @@ interface PromptContext {
     dashboardId?: string;
     /** The filter values set on that dashboard, keyed by parameter name. */
     filters?: Record<string, unknown>;
+    /** Follow the question already running in this thread (a reloaded page); never starts a new one. */
+    follow?: boolean;
 }
 /**
  * Everything a replacement answer flow is handed for one question. Deliberately
@@ -4449,6 +4451,8 @@ interface PolicyExceptionTable {
     link?: string;
     columns?: string[];
     own?: string;
+    /** A predicate (`{t}` is the table) that makes more rows visible, with only `columns` readable; no key list. */
+    visibleWhere?: string;
 }
 /**
  * A named grant: extra rows a restricted user may see outside their branch. `visibleKeys` is

package/dist/index.d.ts

@@ -1624,6 +1624,8 @@ interface PromptContext {
     dashboardId?: string;
     /** The filter values set on that dashboard, keyed by parameter name. */
     filters?: Record<string, unknown>;
+    /** Follow the question already running in this thread (a reloaded page); never starts a new one. */
+    follow?: boolean;
 }
 /**
  * Everything a replacement answer flow is handed for one question. Deliberately
@@ -4449,6 +4451,8 @@ interface PolicyExceptionTable {
     link?: string;
     columns?: string[];
     own?: string;
+    /** A predicate (`{t}` is the table) that makes more rows visible, with only `columns` readable; no key list. */
+    visibleWhere?: string;
 }
 /**
  * A named grant: extra rows a restricted user may see outside their branch. `visibleKeys` is

package/dist/index.js

@@ -2694,16 +2694,18 @@ function exceptionsFromConfig(raw) {
       const s = spec;
       const link = str(s.link);
       const own = str(s.own);
+      const visibleWhere = str(s.visibleWhere);
       const columns = Array.isArray(s.columns) ? s.columns.filter((c) => typeof c === "string" && !!c) : [];
       let bad = null;
       if (!own && !link) bad = 'it has neither "link" nor "own"';
       else if (!own && columns.length === 0) bad = 'it lists no "columns"';
-      else if (!own && !visibleKeys) bad = 'the exception has no "visibleKeys"';
+      else if (own && visibleWhere && columns.length === 0) bad = 'it has "visibleWhere" with "own" but lists no "columns"';
+      else if (!own && !visibleKeys && !visibleWhere) bad = 'the exception has no "visibleKeys" and the table no "visibleWhere"';
       if (bad) {
         logger.warn(`[RequestIdentity] Exception "${name ?? "?"}": table "${table}" dropped because ${bad}.`);
         continue;
       }
-      tables[table] = own ? { own } : { link, columns };
+      tables[table] = own ? visibleWhere ? { own, columns, visibleWhere } : { own } : { link, columns, ...visibleWhere ? { visibleWhere } : {} };
     }
     if (Object.keys(tables).length === 0) continue;
     out.push({ name, visibleKeys, tables });
@@ -9839,6 +9841,8 @@ var PromptLoader = class {
       // Excel sources use DuckDB engine
       "csv": "duckdb",
       // CSV sources use DuckDB engine
+      "s3": "duckdb",
+      // S3 Parquet sources use DuckDB engine
       "dynamodb": "dynamodb",
       // DynamoDB uses its own PartiQL rules (no JOIN/GROUP BY/aggregates)
       "redis": "redis",
@@ -11007,6 +11011,7 @@ Analyze the error and try again with a corrected query.`;
       "mysql": `Add LIMIT ${this.config.maxRowsFetched} at the end of every query`,
       "excel": `Add LIMIT ${this.config.maxRowsFetched} at the end of every query`,
       "csv": `Add LIMIT ${this.config.maxRowsFetched} at the end of every query`,
+      "s3": `Add LIMIT ${this.config.maxRowsFetched} at the end of every query`,
       "dynamodb": `Add LIMIT ${this.config.maxRowsFetched} at the end (this tool applies it \u2014 DynamoDB has no LIMIT clause) and always filter by the partition key`,
       "redis": `Provide ONE Redis read command in the query field (e.g. HGETALL key, or SCAN 0 MATCH pattern:* COUNT ${this.config.maxRowsFetched}). Look up by exact key when known; never use KEYS`,
       "netsuite": `Add LIMIT ${this.config.maxRowsFetched} at the end of every query (this tool converts it internally \u2014 SuiteQL itself has no LIMIT keyword, so never write FETCH FIRST/OFFSET/TOP yourself)`
@@ -11055,7 +11060,7 @@ Even if a table appears in the detailed schema above, search_schema returns samp
     } catch (traceErr) {
       logger.warn(`[SourceAgent:${this.tool.name}] Trace capture failed for schemaSearchInstructionsText (non-blocking): ${traceErr}`);
     }
-    const displaySourceType = sourceType === "excel" || sourceType === "csv" ? `${sourceType} \u2014 uses DuckDB SQL engine` : sourceType;
+    const displaySourceType = sourceType === "excel" || sourceType === "csv" || sourceType === "s3" ? `${sourceType} \u2014 uses DuckDB SQL engine` : sourceType;
     const userAccessContextText = buildAccessSection(this.config.userAccessContext ?? "", "source");
     try {
       if (this.traceSchemaEntry) this.traceSchemaEntry.userAccessContextText = userAccessContextText;
@@ -19725,6 +19730,7 @@ function promptContextFrom(raw) {
   if (source.filters && typeof source.filters === "object" && !Array.isArray(source.filters)) {
     context.filters = source.filters;
   }
+  if (source.follow === true) context.follow = true;
   return Object.keys(context).length ? context : void 0;
 }
 var inFlightAborts = /* @__PURE__ */ new Map();
@@ -19907,7 +19913,7 @@ var get_user_request = async (data, components, sendMessage, anthropicApiKey, gr
   };
   let userResponse;
   try {
-    const replayed = answerProvider && !attachments ? (await replayExactMatch({ prompt, collections, userId, threadId, streamCallback, method: "custom-exact-match", startTime: Date.now() }))?.response : void 0;
+    const replayed = answerProvider && !attachments && !payload.context?.follow ? (await replayExactMatch({ prompt, collections, userId, threadId, streamCallback, method: "custom-exact-match", startTime: Date.now() }))?.response : void 0;
     userResponse = replayed ? replayed : answerProvider ? await answerProvider({
       prompt,
       components,
@@ -19952,6 +19958,7 @@ var get_user_request = async (data, components, sendMessage, anthropicApiKey, gr
   if (Array.isArray(narration) && narration.length) uiBlock.setNarration(narration);
   uiBlock.setDurationMs(Date.now() - requestStartTime);
   const uiBlockId = existingUiBlockId;
+  const recordable = !!userId && !userResponse?.data?.followed;
   const wasAborted = abortController.signal.aborted || !userResponse.success && Array.isArray(userResponse.errors) && userResponse.errors.includes("aborted");
   if (wasAborted) {
     thread.removeUIBlock(uiBlockId);
@@ -19961,7 +19968,7 @@ var get_user_request = async (data, components, sendMessage, anthropicApiKey, gr
     }
     let savedConversationId2;
     let savedResponse2;
-    if (userId) {
+    if (recordable) {
       const saveResult = await saveConversation({
         userId,
         userPrompt: prompt,
@@ -19980,7 +19987,7 @@ var get_user_request = async (data, components, sendMessage, anthropicApiKey, gr
         savedResponse2 = saveResult.response;
       }
     }
-    if (userId) {
+    if (recordable) {
       const latencyMs = Date.now() - requestStartTime;
       const turn = reported(userResponse);
       const model = turn.model || mainAgentModel || "unknown";
@@ -20030,7 +20037,7 @@ var get_user_request = async (data, components, sendMessage, anthropicApiKey, gr
     }
     let savedConversationId2;
     let savedResponse2;
-    if (userId) {
+    if (recordable) {
       const saveResult = await saveConversation({
         userId,
         userPrompt: prompt,
@@ -20052,7 +20059,7 @@ var get_user_request = async (data, components, sendMessage, anthropicApiKey, gr
         savedResponse2 = saveResult.response;
       }
     }
-    if (userId) {
+    if (recordable) {
       const latencyMs = Date.now() - requestStartTime;
       const turn = reported(userResponse);
       const model = turn.model || mainAgentModel || "unknown";
@@ -20117,7 +20124,7 @@ var get_user_request = async (data, components, sendMessage, anthropicApiKey, gr
   logger.info(`Completed UIBlock: ${uiBlockId} in Thread: ${threadId}`);
   let savedConversationId;
   let savedResponse;
-  if (userId) {
+  if (recordable) {
     const responseMethod = userResponse.data?.method || "";
     const semanticSimilarity = userResponse.data?.semanticSimilarity || 0;
     const isExactMatch = responseMethod.includes("semantic-match") && semanticSimilarity >= 0.99;
@@ -20156,7 +20163,7 @@ var get_user_request = async (data, components, sendMessage, anthropicApiKey, gr
     }
   }
   llmUsageLogger.logSessionSummary(prompt?.substring(0, 50));
-  if (userId) {
+  if (recordable) {
     const latencyMs = Date.now() - requestStartTime;
     const turn = reported(userResponse);
     const model = turn.model || mainAgentModel || "unknown";

package/dist/index.mjs

@@ -2582,16 +2582,18 @@ function exceptionsFromConfig(raw) {
       const s = spec;
       const link = str(s.link);
       const own = str(s.own);
+      const visibleWhere = str(s.visibleWhere);
       const columns = Array.isArray(s.columns) ? s.columns.filter((c) => typeof c === "string" && !!c) : [];
       let bad = null;
       if (!own && !link) bad = 'it has neither "link" nor "own"';
       else if (!own && columns.length === 0) bad = 'it lists no "columns"';
-      else if (!own && !visibleKeys) bad = 'the exception has no "visibleKeys"';
+      else if (own && visibleWhere && columns.length === 0) bad = 'it has "visibleWhere" with "own" but lists no "columns"';
+      else if (!own && !visibleKeys && !visibleWhere) bad = 'the exception has no "visibleKeys" and the table no "visibleWhere"';
       if (bad) {
         logger.warn(`[RequestIdentity] Exception "${name ?? "?"}": table "${table}" dropped because ${bad}.`);
         continue;
       }
-      tables[table] = own ? { own } : { link, columns };
+      tables[table] = own ? visibleWhere ? { own, columns, visibleWhere } : { own } : { link, columns, ...visibleWhere ? { visibleWhere } : {} };
     }
     if (Object.keys(tables).length === 0) continue;
     out.push({ name, visibleKeys, tables });
@@ -9727,6 +9729,8 @@ var PromptLoader = class {
       // Excel sources use DuckDB engine
       "csv": "duckdb",
       // CSV sources use DuckDB engine
+      "s3": "duckdb",
+      // S3 Parquet sources use DuckDB engine
       "dynamodb": "dynamodb",
       // DynamoDB uses its own PartiQL rules (no JOIN/GROUP BY/aggregates)
       "redis": "redis",
@@ -10895,6 +10899,7 @@ Analyze the error and try again with a corrected query.`;
       "mysql": `Add LIMIT ${this.config.maxRowsFetched} at the end of every query`,
       "excel": `Add LIMIT ${this.config.maxRowsFetched} at the end of every query`,
       "csv": `Add LIMIT ${this.config.maxRowsFetched} at the end of every query`,
+      "s3": `Add LIMIT ${this.config.maxRowsFetched} at the end of every query`,
       "dynamodb": `Add LIMIT ${this.config.maxRowsFetched} at the end (this tool applies it \u2014 DynamoDB has no LIMIT clause) and always filter by the partition key`,
       "redis": `Provide ONE Redis read command in the query field (e.g. HGETALL key, or SCAN 0 MATCH pattern:* COUNT ${this.config.maxRowsFetched}). Look up by exact key when known; never use KEYS`,
       "netsuite": `Add LIMIT ${this.config.maxRowsFetched} at the end of every query (this tool converts it internally \u2014 SuiteQL itself has no LIMIT keyword, so never write FETCH FIRST/OFFSET/TOP yourself)`
@@ -10943,7 +10948,7 @@ Even if a table appears in the detailed schema above, search_schema returns samp
     } catch (traceErr) {
       logger.warn(`[SourceAgent:${this.tool.name}] Trace capture failed for schemaSearchInstructionsText (non-blocking): ${traceErr}`);
     }
-    const displaySourceType = sourceType === "excel" || sourceType === "csv" ? `${sourceType} \u2014 uses DuckDB SQL engine` : sourceType;
+    const displaySourceType = sourceType === "excel" || sourceType === "csv" || sourceType === "s3" ? `${sourceType} \u2014 uses DuckDB SQL engine` : sourceType;
     const userAccessContextText = buildAccessSection(this.config.userAccessContext ?? "", "source");
     try {
       if (this.traceSchemaEntry) this.traceSchemaEntry.userAccessContextText = userAccessContextText;
@@ -19613,6 +19618,7 @@ function promptContextFrom(raw) {
   if (source.filters && typeof source.filters === "object" && !Array.isArray(source.filters)) {
     context.filters = source.filters;
   }
+  if (source.follow === true) context.follow = true;
   return Object.keys(context).length ? context : void 0;
 }
 var inFlightAborts = /* @__PURE__ */ new Map();
@@ -19795,7 +19801,7 @@ var get_user_request = async (data, components, sendMessage, anthropicApiKey, gr
   };
   let userResponse;
   try {
-    const replayed = answerProvider && !attachments ? (await replayExactMatch({ prompt, collections, userId, threadId, streamCallback, method: "custom-exact-match", startTime: Date.now() }))?.response : void 0;
+    const replayed = answerProvider && !attachments && !payload.context?.follow ? (await replayExactMatch({ prompt, collections, userId, threadId, streamCallback, method: "custom-exact-match", startTime: Date.now() }))?.response : void 0;
     userResponse = replayed ? replayed : answerProvider ? await answerProvider({
       prompt,
       components,
@@ -19840,6 +19846,7 @@ var get_user_request = async (data, components, sendMessage, anthropicApiKey, gr
   if (Array.isArray(narration) && narration.length) uiBlock.setNarration(narration);
   uiBlock.setDurationMs(Date.now() - requestStartTime);
   const uiBlockId = existingUiBlockId;
+  const recordable = !!userId && !userResponse?.data?.followed;
   const wasAborted = abortController.signal.aborted || !userResponse.success && Array.isArray(userResponse.errors) && userResponse.errors.includes("aborted");
   if (wasAborted) {
     thread.removeUIBlock(uiBlockId);
@@ -19849,7 +19856,7 @@ var get_user_request = async (data, components, sendMessage, anthropicApiKey, gr
     }
     let savedConversationId2;
     let savedResponse2;
-    if (userId) {
+    if (recordable) {
       const saveResult = await saveConversation({
         userId,
         userPrompt: prompt,
@@ -19868,7 +19875,7 @@ var get_user_request = async (data, components, sendMessage, anthropicApiKey, gr
         savedResponse2 = saveResult.response;
       }
     }
-    if (userId) {
+    if (recordable) {
       const latencyMs = Date.now() - requestStartTime;
       const turn = reported(userResponse);
       const model = turn.model || mainAgentModel || "unknown";
@@ -19918,7 +19925,7 @@ var get_user_request = async (data, components, sendMessage, anthropicApiKey, gr
     }
     let savedConversationId2;
     let savedResponse2;
-    if (userId) {
+    if (recordable) {
       const saveResult = await saveConversation({
         userId,
         userPrompt: prompt,
@@ -19940,7 +19947,7 @@ var get_user_request = async (data, components, sendMessage, anthropicApiKey, gr
         savedResponse2 = saveResult.response;
       }
     }
-    if (userId) {
+    if (recordable) {
       const latencyMs = Date.now() - requestStartTime;
       const turn = reported(userResponse);
       const model = turn.model || mainAgentModel || "unknown";
@@ -20005,7 +20012,7 @@ var get_user_request = async (data, components, sendMessage, anthropicApiKey, gr
   logger.info(`Completed UIBlock: ${uiBlockId} in Thread: ${threadId}`);
   let savedConversationId;
   let savedResponse;
-  if (userId) {
+  if (recordable) {
     const responseMethod = userResponse.data?.method || "";
     const semanticSimilarity = userResponse.data?.semanticSimilarity || 0;
     const isExactMatch = responseMethod.includes("semantic-match") && semanticSimilarity >= 0.99;
@@ -20044,7 +20051,7 @@ var get_user_request = async (data, components, sendMessage, anthropicApiKey, gr
     }
   }
   llmUsageLogger.logSessionSummary(prompt?.substring(0, 50));
-  if (userId) {
+  if (recordable) {
     const latencyMs = Date.now() - requestStartTime;
     const turn = reported(userResponse);
     const model = turn.model || mainAgentModel || "unknown";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superatomai/sdk-node",
-  "version": "0.0.84-dsp",
+  "version": "0.0.86-dsp",
   "description": "Node.js TypeScript SDK for Superatom",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",