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

package/dist/index.d.mts

@@ -1696,19 +1696,16 @@ declare const ComponentSchema: z.ZodObject<{
         title: z.ZodOptional<z.ZodString>;
         description: z.ZodOptional<z.ZodString>;
         config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        actions: z.ZodOptional<z.ZodArray<z.ZodAny, "many">>;
     }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
         query: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>]>>>;
         title: z.ZodOptional<z.ZodString>;
         description: z.ZodOptional<z.ZodString>;
         config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        actions: z.ZodOptional<z.ZodArray<z.ZodAny, "many">>;
     }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
         query: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>]>>>;
         title: z.ZodOptional<z.ZodString>;
         description: z.ZodOptional<z.ZodString>;
         config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        actions: z.ZodOptional<z.ZodArray<z.ZodAny, "many">>;
     }, z.ZodTypeAny, "passthrough">>;
     category: z.ZodOptional<z.ZodString>;
     keywords: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -1722,7 +1719,6 @@ declare const ComponentSchema: z.ZodObject<{
         query?: string | {} | null | undefined;
         title?: string | undefined;
         config?: Record<string, unknown> | undefined;
-        actions?: any[] | undefined;
     } & {
         [k: string]: unknown;
     };
@@ -1740,7 +1736,6 @@ declare const ComponentSchema: z.ZodObject<{
         query?: string | {} | null | undefined;
         title?: string | undefined;
         config?: Record<string, unknown> | undefined;
-        actions?: any[] | undefined;
     } & {
         [k: string]: unknown;
     };
@@ -3027,16 +3022,6 @@ declare class MainAgent {
     getSourceSummaries(): SourceSummary[];
 }
 
-/**
- * Represents an action that can be performed on a UIBlock
- */
-interface Action {
-    id: string;
-    name: string;
-    type: string;
-    [key: string]: any;
-}
-
 type SystemPrompt = string | Anthropic.Messages.TextBlockParam[];
 interface LLMMessages {
     sys: SystemPrompt;
@@ -3296,7 +3281,7 @@ declare class UILogCollector {
 
 /**
  * UIBlock represents a single user and assistant message block in a thread
- * Contains user question, component metadata, component data, text response, and available actions
+ * Contains user question, component metadata, component data, and text response
  */
 declare class UIBlock {
     private id;
@@ -3304,7 +3289,6 @@ declare class UIBlock {
     private generatedComponentMetadata;
     private componentData;
     private textResponse;
-    private actions;
     private createdAt;
     /**
      * Which script recipe produced this answer, when a script did. Read on the
@@ -3318,11 +3302,10 @@ declare class UIBlock {
      * @param userQuestion - The user's question or input
      * @param componentData - The component data object
      * @param generatedComponentMetadata - Optional metadata about the generated component
-     * @param actions - Optional array of available actions
      * @param id - Optional custom ID, generates UUID if not provided
      * @param textResponse - Optional text response from LLM
      */
-    constructor(userQuestion: string, componentData?: Record<string, any>, generatedComponentMetadata?: Record<string, any>, actions?: Action[], id?: string, textResponse?: string | null);
+    constructor(userQuestion: string, componentData?: Record<string, any>, generatedComponentMetadata?: Record<string, any>, id?: string, textResponse?: string | null);
     /**
      * Get the UIBlock ID
      */
@@ -3372,38 +3355,6 @@ declare class UIBlock {
      * Set or update text response
      */
     setTextResponse(textResponse: string | null): void;
-    /**
-     * Get all actions (only if they are resolved, not if fetching)
-     */
-    getActions(): Action[] | null | Promise<Action[]>;
-    /**
-     * Get or fetch actions
-     * If actions don't exist or are a Promise, calls the generateFn and stores the promise
-     * If actions already exist, returns them
-     * @param generateFn - Async function to generate actions
-     * @returns Promise resolving to Action[]
-     */
-    getOrFetchActions(generateFn: () => Promise<Action[]>): Promise<Action[]>;
-    /**
-     * Set or replace all actions
-     */
-    setActions(actions: Action[]): void;
-    /**
-     * Add a single action (only if actions are resolved)
-     */
-    addAction(action: Action): void;
-    /**
-     * Add multiple actions (only if actions are resolved)
-     */
-    addActions(actions: Action[]): void;
-    /**
-     * Remove an action by ID (only if actions are resolved)
-     */
-    removeAction(actionId: string): boolean;
-    /**
-     * Clear all actions
-     */
-    clearActions(): void;
     /** The program-generated half of the answer — see setProgramAnswer. */
     programAnswer?: string | null;
     /**
@@ -3519,8 +3470,23 @@ declare class Thread {
      * since-edited) live body. Owned by the caller (needs a ScriptStore, which
      * Thread doesn't hold) — omit it and every turn falls back to the
      * no-script summary below.
-     */
-    getConversationContext(limit?: number, currentUIBlockId?: string, getScriptBody?: (recipeId: string, version: number) => Promise<string | null>): Promise<string>;
+     * @param fetchRecentFromDb When provided, this is now the SOURCE OF TRUTH
+     * for history instead of this process's in-memory `uiblocks` map — reads
+     * the persisted `user_conversations` rows (DB `response` jsonb shape, see
+     * transformUIBlockForDB in conversation-saver.ts) via the caller's own
+     * `user-conversations.getRecentForContext` collection. Rows come back
+     * newest-first (already excluding status='aborted' — the query itself
+     * filters that, matching what the in-memory path achieved via
+     * thread.removeUIBlock() on abort). Fixes the standing gap where a backend
+     * restart lost every thread's history (ThreadManager has no DB-backed
+     * rehydration) — DB-backed history survives that, and is correct even if
+     * a different process instance saved the row. Omit it and this falls back
+     * to the in-memory map, for any caller not yet updated.
+     */
+    getConversationContext(limit?: number, currentUIBlockId?: string, getScriptBody?: (recipeId: string, version: number) => Promise<string | null>, fetchRecentFromDb?: (limit: number) => Promise<Array<{
+        userprompt?: string;
+        response?: Record<string, any>;
+    }>>): Promise<string>;
     /**
      * Convert Thread to JSON-serializable object
      */
@@ -4114,21 +4080,20 @@ declare abstract class BaseLLM {
      */
     protected containsFormComponent(component: any): boolean;
     /**
-     * Match components from text response suggestions and generate follow-up questions
+     * Match components from text response suggestions
      * Takes a text response with component suggestions (c1:type format) and matches with available components
-     * Also generates title, description, and intelligent follow-up questions (actions) based on the analysis
+     * Also generates title and description based on the analysis
      * All components are placed in a default MultiComponentContainer layout
      * @param analysisContent - The text response containing component suggestions
      * @param components - List of available components
      * @param apiKey - Optional API key
      * @param componentStreamCallback - Optional callback to stream primary KPI component as soon as it's identified
-     * @returns Object containing matched components, layout title/description, and follow-up actions
+     * @returns Object containing matched components and layout title/description
      */
     matchComponentsFromAnalysis(analysisContent: string, components: Component[], userPrompt: string, apiKey?: string, componentStreamCallback?: (component: Component) => void, deferredTools?: any[], executedTools?: any[], collections?: any, userId?: string): Promise<{
         components: Component[];
         layoutTitle: string;
         layoutDescription: string;
-        actions: Action[];
     }>;
     /**
      * Classify user question into category and detect external tools needed
@@ -4177,12 +4142,6 @@ declare abstract class BaseLLM {
      * 3. Route appropriately based on category and response mode
      */
     handleUserRequest(userPrompt: string, components: Component[], apiKey?: string, conversationHistory?: string, responseMode?: 'component' | 'text', streamCallback?: (chunk: string) => void, collections?: any, externalTools?: any[], userId?: string): Promise<T_RESPONSE>;
-    /**
-     * Generate next questions that the user might ask based on the original prompt and generated component
-     * This helps provide intelligent suggestions for follow-up queries
-     * For general/conversational questions without components, pass textResponse instead
-     */
-    generateNextQuestions(originalUserPrompt: string, component?: Component | null, componentData?: Record<string, unknown>, apiKey?: string, conversationHistory?: string, textResponse?: string, signal?: AbortSignal): Promise<string[]>;
 }
 
 interface AnthropicLLMConfig extends BaseLLMConfig {
@@ -4639,40 +4598,67 @@ declare function createCodexSession(opts: CodexSessionOptions): CodingAgentSessi
  *   emitAgentEvent('kb-node.changed', { id, op: 'update' })
  *
  * Which agents care, and how many events it takes, is the agents' business.
+ * The emitter therefore speaks the WORLD's vocabulary, never any one agent's —
+ * translating an event into a particular agent's input is `buildInput` below.
  */
+/** One announced fact, as it reaches a trigger. */
+interface TriggerEvent {
+    /** The event name passed to emitAgentEvent. */
+    name: string;
+    payload?: unknown;
+}
+/**
+ * Turns the events that caused this run into the agent's `input`.
+ *
+ * Takes the whole list, not one payload, because every batching trigger here
+ * fires for MANY events: a debounced burst, or N counted occurrences. Handing
+ * over only the last one silently discarded the rest — five edited nodes became
+ * one.
+ *
+ * Omit it and the agent receives the most recent payload unchanged, which is
+ * the historical behaviour. Any agent that batches should declare one.
+ */
+type BuildTriggerInput = (events: TriggerEvent[]) => unknown;
 type AgentTrigger = 
 /** Only runCodingAgent(). The default. */
 {
     type: 'manual';
 }
-/** Every N milliseconds while the process is up. */
+/** Every N milliseconds while the process is up. Fires with no events. */
  | {
     type: 'interval';
     everyMs: number;
+    buildInput?: BuildTriggerInput;
 }
 /**
  * On a named event. `debounceMs` collapses a burst into one run — editing
- * five knowledge nodes in a row is one reason to rebuild, not five.
+ * five knowledge nodes in a row is one reason to rebuild, not five. The run
+ * still receives all five events; only the RUNS are collapsed.
  */
  | {
     type: 'event';
     on: string | string[];
     debounceMs?: number;
+    buildInput?: BuildTriggerInput;
 }
 /**
- * Every Nth occurrence of an event. The count is PERSISTED, so "after 10
+ * Every Nth occurrence of an event. The events are PERSISTED, so "after 10
  * questions" survives a restart instead of silently starting over.
  */
  | {
     type: 'count';
     on: string;
     every: number;
+    buildInput?: BuildTriggerInput;
 };
 interface TriggerFireInfo {
     agentId: string;
     /** What set it off, for the log line. */
     reason: string;
-    payload?: unknown;
+    /** Everything that caused this run, in arrival order. */
+    events: TriggerEvent[];
+    /** What buildInput produced — exactly what the agent was handed. */
+    input?: unknown;
 }
 /** Notified after every triggered run — for recording history or alerting. */
 type RunListener = (record: AgentRunRecord, info: TriggerFireInfo) => void;
@@ -5002,6 +4988,24 @@ interface RunAgentOptions<TInput> extends AgentRunContext {
     resumeId?: string;
     /** Overrides the definition's prompt entirely. Chat mode: this is the user's message. */
     prompt?: string;
+    /**
+     * A person is typing, rather than a job running.
+     *
+     * For an agent whose mode is 'task' this turns off the JOB — prepare(), the
+     * deliverable contract and apply() are one unit that sets work up and
+     * consumes it, and a conversation should do neither. The turn joins the
+     * workspace as it stands and its answer is the whole result.
+     *
+     * Without this, chatting with a task agent could only ever fail: the user's
+     * message replaces the prompt that names the output path, so the agent never
+     * writes the deliverable, and the run is then reported as an error despite
+     * having answered perfectly well. Worse, prepare() ran on every turn — for a
+     * batching agent that means a chat turn quietly consumed a batch of work.
+     *
+     * An agent whose mode is 'chat' is unaffected: its prepare() is per-turn
+     * context setup, not job setup, so it still runs.
+     */
+    chat?: boolean;
 }
 /**
  * Run one agent, end to end.
@@ -5082,24 +5086,6 @@ interface CodingAgentCollectionConfig {
 }
 declare function registerCodingAgentCollection(sdk: SuperatomSDK, config?: CodingAgentCollectionConfig): void;
 
-/**
- * ScriptMatcher — LLM-Based Script Matching + Parameter Extraction
- *
- * Uses ONE LLM call to:
- * 1. Pick the best matching script from the library (or "none")
- * 2. Extract parameter values from the user question
- *
- * Why LLM over embeddings:
- * - Embeddings capture topic similarity ("overstock" ≈ "inventory" ≈ "revenue")
- *   but can't distinguish structurally different questions about the same domain
- * - LLM understands that "overstock by warehouse" needs a different script than
- *   "revenue by warehouse" even though they're semantically close
- * - One call does both matching AND parameter extraction
- *
- * When script library grows past ~50, add an embedding pre-filter
- * (ChromaDB narrows to top 10 → LLM picks from those 10).
- */
-
 declare class ScriptMatcher {
     private store;
     private collections?;
@@ -5146,15 +5132,16 @@ declare class ScriptMatcher {
      */
     private buildPromptHistoryCatalog;
     /**
-     * The recent script-backed answers in this thread — the bounded set an edit
-     * may target. Rendered as its own prompt section (never merged into the
-     * ranked catalog) so the `edit` rules have an unambiguous referent set, and
-     * numbered newest-first so the prompt's "prefer the most recent when the
-     * instruction is ambiguous" tie-break has something to point at.
+     * The most recent script-backed answer in this thread — the one an `edit`
+     * targets. Rendered as its own prompt section (never merged into the ranked
+     * catalog) so the `edit` rules have an unambiguous referent.
+     *
+     * `candidates` holds at most one entry (see doMatch) — `edit` always means
+     * "the answer I just got", so there is nothing else to show here.
      *
-     * Each entry carries the QUESTION that produced it plus the columns it
-     * returned — that is what lets the matcher resolve "use the mode for the WSP
-     * one" instead of blindly taking the newest.
+     * Carries the QUESTION that produced it plus the columns it returned — that
+     * is what lets the matcher resolve "use the mode for the WSP one" against
+     * this one script's own context.
      */
     private buildActiveScriptBlock;
 }
@@ -5393,4 +5380,4 @@ declare class SuperatomSDK {
     getConversationSimilarityThreshold(): number;
 }
 
-export { type Action, type AgentConfig, type AgentEvent, type AgentResponse, type AgentRunContext, type AgentRunHandlers, type AgentRunRecord, type AgentRunResult, type AgentTrigger, type AgentUsage, type ApplySummary, BM25L, type BM25LOptions, type BaseLLMConfig, CONTEXT_CONFIG, type CapturedLog, CleanupService, type CodexSessionOptions, type CodingAgentCollectionConfig, type CodingAgentDefinition, type CodingAgentSession, type CodingAgentSessionOptions, type CodingAgentsConfig, type CollectionHandler, type CollectionOperation, type DBUIBlock, DEFAULT_AGENT_CONFIG, type DashboardAgentCollectionConfig, type DatabaseType, type Harness, type HybridSearchOptions, type IncomingMessage, type KbNodesQueryFilters, type KbNodesRequestPayload, LLM, type LLMUsageEntry, type LogLevel, MainAgent, type McpServerSpec, type Message, type ModelStrategy, type OutputContract, type OutputField, type OutputValidator, type RerankedResult, type RunAgentOptions, STORAGE_CONFIG, type ScriptComponentSpec, ScriptMatcher, type ScriptParameter, type ScriptRecipe, type ScriptRecipeMetaRow, type ScriptRecipeStore, type ScriptResult, ScriptStore, type ScriptStoreOptions, type SelectedWorkflow, SuperatomSDK, type SuperatomSDKConfig, type TaskType, Thread, ThreadManager, type Tool$1 as Tool, type ToolOutputSchema, UIBlock, UILogCollector, type User, UserManager, type UsersData, type WorkflowDescriptor, type Workspace, anthropicLLM, assertReadOnlySql, createCodexSession, createCodingAgentSession, dashboardConversationHistory, describeTriggers, emitAgentEvent, geminiLLM, getCodingAgent, getCodingAgentsConfig, groqLLM, hybridRerank, listCodingAgents, llmUsageLogger, logger, normalizeScriptBody, onAgentRun, openaiLLM, queryCache, registerCodingAgentCollection, registerCodingAgents, registerDashboardAgentCollection, rerankChromaResults, rerankConversationResults, resolveScriptRecipeStore, runCodingAgent, runScript, startAgentTriggers, stopAgentTriggers, userPromptErrorLogger, writeBridgeShims };
+export { type AgentConfig, type AgentEvent, type AgentResponse, type AgentRunContext, type AgentRunHandlers, type AgentRunRecord, type AgentRunResult, type AgentTrigger, type AgentUsage, type ApplySummary, BM25L, type BM25LOptions, type BaseLLMConfig, type BuildTriggerInput, CONTEXT_CONFIG, type CapturedLog, CleanupService, type CodexSessionOptions, type CodingAgentCollectionConfig, type CodingAgentDefinition, type CodingAgentSession, type CodingAgentSessionOptions, type CodingAgentsConfig, type CollectionHandler, type CollectionOperation, type DBUIBlock, DEFAULT_AGENT_CONFIG, type DashboardAgentCollectionConfig, type DatabaseType, type Harness, type HybridSearchOptions, type IncomingMessage, type KbNodesQueryFilters, type KbNodesRequestPayload, LLM, type LLMUsageEntry, type LogLevel, MainAgent, type McpServerSpec, type Message, type ModelStrategy, type OutputContract, type OutputField, type OutputValidator, type RerankedResult, type RunAgentOptions, STORAGE_CONFIG, type ScriptComponentSpec, ScriptMatcher, type ScriptParameter, type ScriptRecipe, type ScriptRecipeMetaRow, type ScriptRecipeStore, type ScriptResult, ScriptStore, type ScriptStoreOptions, type SelectedWorkflow, SuperatomSDK, type SuperatomSDKConfig, type TaskType, Thread, ThreadManager, type Tool$1 as Tool, type ToolOutputSchema, type TriggerEvent, type TriggerFireInfo, UIBlock, UILogCollector, type User, UserManager, type UsersData, type WorkflowDescriptor, type Workspace, anthropicLLM, assertReadOnlySql, createCodexSession, createCodingAgentSession, dashboardConversationHistory, describeTriggers, emitAgentEvent, geminiLLM, getCodingAgent, getCodingAgentsConfig, groqLLM, hybridRerank, listCodingAgents, llmUsageLogger, logger, normalizeScriptBody, onAgentRun, openaiLLM, queryCache, registerCodingAgentCollection, registerCodingAgents, registerDashboardAgentCollection, rerankChromaResults, rerankConversationResults, resolveScriptRecipeStore, runCodingAgent, runScript, startAgentTriggers, stopAgentTriggers, userPromptErrorLogger, writeBridgeShims };