keyring-agent-core 0.1.0 → 0.2.0

package/dist/agent/AgentCore.d.ts

@@ -1,4 +1,4 @@
-import type { AgentConfig, ChatMessage, KnowledgeBaseEntry, LLMProvider, ReActTrace, RouterDecision, SubagentResult, Tool, UIPayload, UserContext } from '../types';
+import type { AgentConfig, ChatMessage, KnowledgeBaseEntry, LLMProvider, ReActTrace, RouterDecision, SubagentResult, SuggestedAction, Tool, UIPayload, UserContext } from '../types';
 import { ToolRegistry } from '../tools/ToolRegistry';
 import type { Subagent } from './Subagent';
 import { type RewriteResult } from './QueryRewriter';
@@ -19,6 +19,12 @@ export interface AgentResponse {
      * The FE switches on `component` and forwards `props` verbatim.
      */
     uiActions?: UIPayload[];
+    /**
+     * Tool-emitted clickable buttons aggregated across all subagent tool calls
+     * this turn. Distinct from `suggestedPrompts` (LLM-generated generic
+     * follow-ups) — these are deterministic disambiguation / picker buttons.
+     */
+    actionButtons?: SuggestedAction[];
     /** Full ReAct trace (for debugging / logging) — flattened across all subagents */
     trace?: ReActTrace;
     /** The router's decision for this turn (for debugging) */
@@ -48,6 +54,8 @@ export declare class AgentCore {
     private rewriter;
     private subagents;
     private synthesizer;
+    /** Compiled LangGraph that orchestrates one chat turn. */
+    private chatGraph;
     private systemPrompt;
     private debug;
     private userContext;
@@ -138,12 +146,32 @@ export declare class AgentCore {
      */
     chat(userMessage: string, options?: {
         generateSuggestions?: boolean;
+        language?: string;
     }): Promise<AgentResponse>;
+    /**
+     * Build the host object the chat graph's nodes call into. Each method is a
+     * thin closure over an existing (private) helper, so the graph stays pure
+     * orchestration and AgentCore exposes no new public surface.
+     */
+    private createGraphHost;
     /**
      * Aggregate UI payloads from this turn's tool calls. Tools with kind='ui' or
      * 'action' attach a `ui` field to their ToolResult; the FE renders one
      * component per entry in the order they were produced.
      */
+    /**
+     * Return true when ANY tool successfully executed across the dispatched
+     * subagents carries `noSuggestions: true` in its registry definition. Used to
+     * skip the suggester for turns where the user is already pointed at a
+     * concrete next action (a form / preview).
+     */
+    private subResultsTriggerNoSuggestions;
+    /**
+     * Aggregate `actionButtons` emitted by tools across all subagent tool calls
+     * this turn (e.g. a token-picker after the user said "send token" without
+     * naming one). Preserves emission order; drops malformed entries.
+     */
+    private collectActionButtons;
     private collectUiActions;
     /**
      * Stamp the rewriter-detected user-message language onto a UIPayload so FE
@@ -161,6 +189,14 @@ export declare class AgentCore {
     private formatKBContext;
     private tryAnswerFromKB;
     private answerDirectly;
+    /**
+     * Deterministic short-circuit for the unsupported-connected-chain case: the
+     * wallet is on a chain this core does not support and the user did not name a
+     * supported one, so chain-scoped tools cannot serve the request. We produce a
+     * short, localized "chain X is not supported" reply (no tools, no suggestions)
+     * and persist it like any other assistant turn.
+     */
+    private answerUnsupportedChain;
     /**
      * Flatten the per-subagent ReAct steps into a single trace that the
      * Synthesizer can consume. The `finalAnswer` here is a compact

package/dist/agent/AgentCore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentCore.d.ts","sourceRoot":"","sources":["../../src/agent/AgentCore.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AgentCore.d.ts","sourceRoot":"","sources":["../../src/agent/AgentCore.ts"],"names":[],"mappings":"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"}