@superatomai/sdk-node 0.0.54-dsp → 0.0.55-dsp

package/dist/index.d.mts

@@ -852,6 +852,59 @@ interface RunTrace {
                 kind: string;
                 body: string;
             }>;
+            /** This dispatch's `SourceToolInput.aggregation` ('raw' | 'pre-aggregate' | 'summary') — decides which AGGREGATION_MODE text this SourceAgent's own prompt got. */
+            aggregation?: string;
+            /** The exact DATABASE_RULES text this SourceAgent's own prompt got (promptLoader.loadDatabaseRulesForType). */
+            databaseRulesText?: string;
+            /** The exact ROW_LIMIT_SYNTAX text this SourceAgent's own prompt got. */
+            rowLimitSyntaxText?: string;
+            /** The exact SCHEMA_SEARCH_INSTRUCTIONS text this SourceAgent's own prompt got — the guidance, not the runtime searchSchemaLookups results above. */
+            schemaSearchInstructionsText?: string;
+            /** The literal tool definitions (query tool + search_schema tool, when offered) handed to this SourceAgent's own LLM.streamWithTools call. */
+            toolsSent?: any[];
+            /** This SourceAgent's own LLM.streamWithTools call config. */
+            callConfig?: {
+                model?: string;
+                maxTokens?: number;
+                temperature?: number;
+                maxIterations?: number;
+            };
+            /** The exact USER_ACCESS_CONTEXT text this SourceAgent's own prompt got — its own copy of the same value captured once at the turn level in userAccessContext. */
+            userAccessContextText?: string;
+        }>;
+    };
+    /**
+     * Concept-catalog activity this turn (see main-agent.ts's loadConceptCatalog /
+     * loadConceptInvariants / RESOLVE_CONCEPTS_TOOL_DEF). Parallel to
+     * `entityResolution` above. Absent/empty for a project with no concepts
+     * collection registered.
+     */
+    concepts: {
+        /** The exact {{CONCEPT_CATALOG}} text injected into MainAgent's system prompt (names + aliases only — bodies come back via resolve_concepts). */
+        catalogText?: string;
+        /** The exact {{CONCEPT_INVARIANTS}} text injected into MainAgent's system prompt — always-on, never requested by the LLM. Distinct from the resolved-concept bodies below, which mix invariants and explicitly-resolved concepts together. */
+        invariantsText?: string;
+        /** One entry per resolve_concepts-driven resolution this turn — explicit tool calls, resolve_entities-triggered concept lookups, and (for the dashboard flow) its own concept tool. */
+        calls: Array<{
+            via: 'resolve_concepts' | 'resolve_entities' | 'dashboard-agent';
+            asked?: string[];
+            implied?: string[];
+            returned?: Array<{
+                kind: string;
+                name: string;
+                returns?: any;
+                definition: string;
+                viaRequires?: boolean;
+            }>;
+            viaFloor?: string[];
+            corrected?: Array<{
+                asked: string;
+                matched: string;
+            }>;
+            unmatched?: string[];
+            suggestions?: string[];
+            error?: string;
+            note?: string;
         }>;
     };
     /** The script that produced this answer, if any. Null for a general (no-tool) answer. */
@@ -897,6 +950,10 @@ interface RunTrace {
             activeScript: string;
             /** Active bindings offered as edit candidates this turn. */
             activeBindingCount: number;
+            /** This call's LLM.stream config. */
+            model?: string;
+            maxTokens?: number;
+            temperature?: number;
         };
         /**
          * Everything that came back OUT — the LLM's raw answer plus what the
@@ -990,6 +1047,95 @@ interface RunTrace {
      * only because traces saved before this field existed won't have it.
      */
     userAccessContext?: string;
+    /**
+     * The exact per-user knowledge-base text injected into MainAgent's system
+     * prompt (getUserKnowledgeBase's output, folded into KNOWLEDGE_BASE_CONTEXT
+     * alongside the query-matched half already captured in kbNodes.query).
+     * Captured separately because it's a distinct fetch with no node-level
+     * structure to list, unlike kbNodes.
+     */
+    userKbContext?: string;
+    /** The literal tool definitions (source, direct, workflow, resolve_entities, resolve_concepts, write_script, execute_script, write_analysis, write_components — whichever were actually offered this turn) handed to MainAgent's LLM.streamWithTools call. */
+    toolsSent?: any[];
+    /** The exact {{DIRECT_TOOLS}} text injected into MainAgent's system prompt. */
+    directToolsText?: string;
+    /** The exact {{WORKFLOW_COMPONENTS}} text injected into MainAgent's system prompt. */
+    workflowsText?: string;
+    /** The exact {{SCRIPT_BODY_CONTRACT}} text injected into MainAgent's system prompt (promptLoader.loadScriptBodyContract). */
+    scriptBodyContractText?: string;
+    /**
+     * Full edit-mode context as sent to MainAgent this turn — every EditContext
+     * field, not just the instruction already folded into `script.reasoning`.
+     * Null for a non-edit turn.
+     */
+    editContext?: {
+        recipeId?: string;
+        parentName?: string;
+        parentBody?: string;
+        instruction?: string;
+        lastResultColumns?: string[];
+        parentParams?: string;
+    } | null;
+    /**
+     * The fork-mode preamble as actually assembled and prepended to the user
+     * prompt (agent-user-response.ts) — parentBody/gaps/modificationHint as
+     * sent, plus the lineage fields also written to the script store separately
+     * (parentRecipeId/forkDepth/forkReason). Null for a non-fork turn.
+     */
+    forkContext?: {
+        parentBody?: string;
+        gaps?: string;
+        modificationHint?: string;
+        parentRecipeId?: string;
+        forkDepth?: number;
+        forkReason?: string;
+    } | null;
+    /** The write_analysis tool call's analysisBody argument this turn, when called. */
+    writeAnalysisBody?: string;
+    /** The write_components tool call's componentsBody argument this turn, when called. */
+    writeComponentsBody?: string;
+    /**
+     * Component-generation/re-authoring activity this turn — one entry per call
+     * to `authorComponentsProgram` (script-component-generator.ts — the
+     * display-edit path, reauthoring getComponents as a program),
+     * `generateScriptComponents` (the script-replay fallback, spec/analysis-based
+     * generation), or `summarizeToMarkdown` (its own small analysis-summary LLM
+     * call, reached via `assembleComponentsFromSpecs`). A turn can hit more than
+     * one of these across its fallback chain, so this is an array, not a
+     * singleton — same pattern as `concepts.calls`/`entityResolution.calls`.
+     */
+    componentGen: Array<{
+        via: 'authorComponentsProgram' | 'generateScriptComponents' | 'summarizeToMarkdown';
+        /** authorComponentsProgram only: the edit instruction driving the re-author. */
+        instruction?: string;
+        /** authorComponentsProgram only: the component body being revised, before this attempt. */
+        currentBody?: string;
+        /** Dataset shapes/schemas the LLM was shown (both generation paths, different derivation). */
+        datasetShapes?: string;
+        /** The component catalog text/list handed to the LLM. */
+        componentCatalog?: string;
+        /** generateScriptComponents only: source name(s) shown (SOURCE_NAME). */
+        sourceName?: string;
+        /** generateScriptComponents only: row count(s) shown (ROW_COUNT). */
+        rowCount?: string;
+        /** generateScriptComponents only: column descriptions text shown. */
+        columnDescriptions?: string;
+        /** generateScriptComponents/summarizeToMarkdown: the analysis text handed to the LLM. */
+        analysisText?: string;
+        /** This call's LLM config. */
+        callConfig?: {
+            model?: string;
+            maxTokens?: number;
+            temperature?: number;
+        };
+        /** authorComponentsProgram only: one entry per retry attempt — the feedback fed back in and the raw response for that attempt, in order. */
+        attempts?: Array<{
+            feedback?: string;
+            rawResponse?: string;
+        }>;
+        /** The final raw LLM response text for this call (last attempt, for authorComponentsProgram's retry loop; the single response otherwise). */
+        rawResponse?: string;
+    }>;
 }
 /**
  * Configuration for the multi-agent system.

package/dist/index.d.ts

@@ -852,6 +852,59 @@ interface RunTrace {
                 kind: string;
                 body: string;
             }>;
+            /** This dispatch's `SourceToolInput.aggregation` ('raw' | 'pre-aggregate' | 'summary') — decides which AGGREGATION_MODE text this SourceAgent's own prompt got. */
+            aggregation?: string;
+            /** The exact DATABASE_RULES text this SourceAgent's own prompt got (promptLoader.loadDatabaseRulesForType). */
+            databaseRulesText?: string;
+            /** The exact ROW_LIMIT_SYNTAX text this SourceAgent's own prompt got. */
+            rowLimitSyntaxText?: string;
+            /** The exact SCHEMA_SEARCH_INSTRUCTIONS text this SourceAgent's own prompt got — the guidance, not the runtime searchSchemaLookups results above. */
+            schemaSearchInstructionsText?: string;
+            /** The literal tool definitions (query tool + search_schema tool, when offered) handed to this SourceAgent's own LLM.streamWithTools call. */
+            toolsSent?: any[];
+            /** This SourceAgent's own LLM.streamWithTools call config. */
+            callConfig?: {
+                model?: string;
+                maxTokens?: number;
+                temperature?: number;
+                maxIterations?: number;
+            };
+            /** The exact USER_ACCESS_CONTEXT text this SourceAgent's own prompt got — its own copy of the same value captured once at the turn level in userAccessContext. */
+            userAccessContextText?: string;
+        }>;
+    };
+    /**
+     * Concept-catalog activity this turn (see main-agent.ts's loadConceptCatalog /
+     * loadConceptInvariants / RESOLVE_CONCEPTS_TOOL_DEF). Parallel to
+     * `entityResolution` above. Absent/empty for a project with no concepts
+     * collection registered.
+     */
+    concepts: {
+        /** The exact {{CONCEPT_CATALOG}} text injected into MainAgent's system prompt (names + aliases only — bodies come back via resolve_concepts). */
+        catalogText?: string;
+        /** The exact {{CONCEPT_INVARIANTS}} text injected into MainAgent's system prompt — always-on, never requested by the LLM. Distinct from the resolved-concept bodies below, which mix invariants and explicitly-resolved concepts together. */
+        invariantsText?: string;
+        /** One entry per resolve_concepts-driven resolution this turn — explicit tool calls, resolve_entities-triggered concept lookups, and (for the dashboard flow) its own concept tool. */
+        calls: Array<{
+            via: 'resolve_concepts' | 'resolve_entities' | 'dashboard-agent';
+            asked?: string[];
+            implied?: string[];
+            returned?: Array<{
+                kind: string;
+                name: string;
+                returns?: any;
+                definition: string;
+                viaRequires?: boolean;
+            }>;
+            viaFloor?: string[];
+            corrected?: Array<{
+                asked: string;
+                matched: string;
+            }>;
+            unmatched?: string[];
+            suggestions?: string[];
+            error?: string;
+            note?: string;
         }>;
     };
     /** The script that produced this answer, if any. Null for a general (no-tool) answer. */
@@ -897,6 +950,10 @@ interface RunTrace {
             activeScript: string;
             /** Active bindings offered as edit candidates this turn. */
             activeBindingCount: number;
+            /** This call's LLM.stream config. */
+            model?: string;
+            maxTokens?: number;
+            temperature?: number;
         };
         /**
          * Everything that came back OUT — the LLM's raw answer plus what the
@@ -990,6 +1047,95 @@ interface RunTrace {
      * only because traces saved before this field existed won't have it.
      */
     userAccessContext?: string;
+    /**
+     * The exact per-user knowledge-base text injected into MainAgent's system
+     * prompt (getUserKnowledgeBase's output, folded into KNOWLEDGE_BASE_CONTEXT
+     * alongside the query-matched half already captured in kbNodes.query).
+     * Captured separately because it's a distinct fetch with no node-level
+     * structure to list, unlike kbNodes.
+     */
+    userKbContext?: string;
+    /** The literal tool definitions (source, direct, workflow, resolve_entities, resolve_concepts, write_script, execute_script, write_analysis, write_components — whichever were actually offered this turn) handed to MainAgent's LLM.streamWithTools call. */
+    toolsSent?: any[];
+    /** The exact {{DIRECT_TOOLS}} text injected into MainAgent's system prompt. */
+    directToolsText?: string;
+    /** The exact {{WORKFLOW_COMPONENTS}} text injected into MainAgent's system prompt. */
+    workflowsText?: string;
+    /** The exact {{SCRIPT_BODY_CONTRACT}} text injected into MainAgent's system prompt (promptLoader.loadScriptBodyContract). */
+    scriptBodyContractText?: string;
+    /**
+     * Full edit-mode context as sent to MainAgent this turn — every EditContext
+     * field, not just the instruction already folded into `script.reasoning`.
+     * Null for a non-edit turn.
+     */
+    editContext?: {
+        recipeId?: string;
+        parentName?: string;
+        parentBody?: string;
+        instruction?: string;
+        lastResultColumns?: string[];
+        parentParams?: string;
+    } | null;
+    /**
+     * The fork-mode preamble as actually assembled and prepended to the user
+     * prompt (agent-user-response.ts) — parentBody/gaps/modificationHint as
+     * sent, plus the lineage fields also written to the script store separately
+     * (parentRecipeId/forkDepth/forkReason). Null for a non-fork turn.
+     */
+    forkContext?: {
+        parentBody?: string;
+        gaps?: string;
+        modificationHint?: string;
+        parentRecipeId?: string;
+        forkDepth?: number;
+        forkReason?: string;
+    } | null;
+    /** The write_analysis tool call's analysisBody argument this turn, when called. */
+    writeAnalysisBody?: string;
+    /** The write_components tool call's componentsBody argument this turn, when called. */
+    writeComponentsBody?: string;
+    /**
+     * Component-generation/re-authoring activity this turn — one entry per call
+     * to `authorComponentsProgram` (script-component-generator.ts — the
+     * display-edit path, reauthoring getComponents as a program),
+     * `generateScriptComponents` (the script-replay fallback, spec/analysis-based
+     * generation), or `summarizeToMarkdown` (its own small analysis-summary LLM
+     * call, reached via `assembleComponentsFromSpecs`). A turn can hit more than
+     * one of these across its fallback chain, so this is an array, not a
+     * singleton — same pattern as `concepts.calls`/`entityResolution.calls`.
+     */
+    componentGen: Array<{
+        via: 'authorComponentsProgram' | 'generateScriptComponents' | 'summarizeToMarkdown';
+        /** authorComponentsProgram only: the edit instruction driving the re-author. */
+        instruction?: string;
+        /** authorComponentsProgram only: the component body being revised, before this attempt. */
+        currentBody?: string;
+        /** Dataset shapes/schemas the LLM was shown (both generation paths, different derivation). */
+        datasetShapes?: string;
+        /** The component catalog text/list handed to the LLM. */
+        componentCatalog?: string;
+        /** generateScriptComponents only: source name(s) shown (SOURCE_NAME). */
+        sourceName?: string;
+        /** generateScriptComponents only: row count(s) shown (ROW_COUNT). */
+        rowCount?: string;
+        /** generateScriptComponents only: column descriptions text shown. */
+        columnDescriptions?: string;
+        /** generateScriptComponents/summarizeToMarkdown: the analysis text handed to the LLM. */
+        analysisText?: string;
+        /** This call's LLM config. */
+        callConfig?: {
+            model?: string;
+            maxTokens?: number;
+            temperature?: number;
+        };
+        /** authorComponentsProgram only: one entry per retry attempt — the feedback fed back in and the raw response for that attempt, in order. */
+        attempts?: Array<{
+            feedback?: string;
+            rawResponse?: string;
+        }>;
+        /** The final raw LLM response text for this call (last attempt, for authorComponentsProgram's retry loop; the single response otherwise). */
+        rawResponse?: string;
+    }>;
 }
 /**
  * Configuration for the multi-agent system.