@superatomai/sdk-node 0.0.51-dsp → 0.0.52-dsp

package/dist/index.d.mts

@@ -557,8 +557,15 @@ interface SourceAgentResult {
     sourceName: string;
     /** Whether the query succeeded */
     success: boolean;
-    /** Result data rows */
+    /** Result data rows — bounded to MAIN_AGENT_COMPLETE_ROWS (Stage 2: what the LLM
+     *  sees verbatim in its own prompt). NOT render-sized — do not bind a UI
+     *  component's dataset to this field; use renderData instead. */
     data: any[];
+    /** Result data rows bounded to MAX_ROWS_RENDERED (Stage 3: render-appropriate).
+     *  This is what already-fetched (Stage 1, <=MAX_ROWS_FETCHED) rows look like
+     *  before Stage 2 further truncates `data` down for the LLM's own context —
+     *  use this, not `data`, whenever binding a UI component's dataset. */
+    renderData: any[];
     /** Metadata about the query execution */
     metadata: SourceAgentMetadata;
     /** Tool execution info for the last successful query (backward compat) */
@@ -813,10 +820,11 @@ interface RunTrace {
             sourceId: string;
             sourceName?: string;
             /**
-             * The exact intent text MainAgent wrote for this dispatch (before the
-             * resolved-entities block gets appended by code — see
-             * buildResolvedEntitiesBlock) — what MainAgent actually asked this
-             * source agent to go find.
+             * The exact intent text this dispatch's own prompt was built from —
+             * captured in SourceAgent.buildPrompt, so it ALREADY includes the
+             * resolved-entities and resolved-concepts blocks MainAgent appends by
+             * code before calling execute() (see buildResolvedEntitiesBlock /
+             * buildResolvedConceptsBlock) — not just what the LLM itself wrote.
              */
             intent: string;
             /** How `schemaText` was sourced — see SourceAgent.buildPrompt's fullSchema fallback chain. */
@@ -829,6 +837,21 @@ interface RunTrace {
             }>;
             /** The tool_result text MainAgent's LLM read back for this dispatch (formatResultForMainAgent output). */
             result?: string;
+            /**
+             * The full resolved-concept bodies this dispatch's intent was built
+             * with (the same content already baked into `intent` via
+             * buildResolvedConceptsBlock, surfaced here structured/separately so a
+             * trace reader doesn't have to parse it back out of the raw text).
+             * Stamped AFTER execute() resolves — same timing as `result` above —
+             * specifically so its presence here is proof the concepts were part
+             * of the prompt actually sent, not just of what MainAgent intended to
+             * send before the call happened.
+             */
+            resolvedConcepts?: Array<{
+                name: string;
+                kind: string;
+                body: string;
+            }>;
         }>;
     };
     /** The script that produced this answer, if any. Null for a general (no-tool) answer. */

package/dist/index.d.ts

@@ -557,8 +557,15 @@ interface SourceAgentResult {
     sourceName: string;
     /** Whether the query succeeded */
     success: boolean;
-    /** Result data rows */
+    /** Result data rows — bounded to MAIN_AGENT_COMPLETE_ROWS (Stage 2: what the LLM
+     *  sees verbatim in its own prompt). NOT render-sized — do not bind a UI
+     *  component's dataset to this field; use renderData instead. */
     data: any[];
+    /** Result data rows bounded to MAX_ROWS_RENDERED (Stage 3: render-appropriate).
+     *  This is what already-fetched (Stage 1, <=MAX_ROWS_FETCHED) rows look like
+     *  before Stage 2 further truncates `data` down for the LLM's own context —
+     *  use this, not `data`, whenever binding a UI component's dataset. */
+    renderData: any[];
     /** Metadata about the query execution */
     metadata: SourceAgentMetadata;
     /** Tool execution info for the last successful query (backward compat) */
@@ -813,10 +820,11 @@ interface RunTrace {
             sourceId: string;
             sourceName?: string;
             /**
-             * The exact intent text MainAgent wrote for this dispatch (before the
-             * resolved-entities block gets appended by code — see
-             * buildResolvedEntitiesBlock) — what MainAgent actually asked this
-             * source agent to go find.
+             * The exact intent text this dispatch's own prompt was built from —
+             * captured in SourceAgent.buildPrompt, so it ALREADY includes the
+             * resolved-entities and resolved-concepts blocks MainAgent appends by
+             * code before calling execute() (see buildResolvedEntitiesBlock /
+             * buildResolvedConceptsBlock) — not just what the LLM itself wrote.
              */
             intent: string;
             /** How `schemaText` was sourced — see SourceAgent.buildPrompt's fullSchema fallback chain. */
@@ -829,6 +837,21 @@ interface RunTrace {
             }>;
             /** The tool_result text MainAgent's LLM read back for this dispatch (formatResultForMainAgent output). */
             result?: string;
+            /**
+             * The full resolved-concept bodies this dispatch's intent was built
+             * with (the same content already baked into `intent` via
+             * buildResolvedConceptsBlock, surfaced here structured/separately so a
+             * trace reader doesn't have to parse it back out of the raw text).
+             * Stamped AFTER execute() resolves — same timing as `result` above —
+             * specifically so its presence here is proof the concepts were part
+             * of the prompt actually sent, not just of what MainAgent intended to
+             * send before the call happened.
+             */
+            resolvedConcepts?: Array<{
+                name: string;
+                kind: string;
+                body: string;
+            }>;
         }>;
     };
     /** The script that produced this answer, if any. Null for a general (no-tool) answer. */