@tangle-network/agent-app 0.43.17 → 0.43.19

package/dist/assistant/index.d.ts

@@ -176,6 +176,27 @@ type ToolOutcome = {
         message: string;
     };
 };
+/**
+ * The result of a CONFIRMED mutating tool, retained on the resolving `status`
+ * message so a host can render it prominently (e.g. a one-time API-key reveal).
+ *
+ * SECURITY: `output` may carry a one-time secret (e.g. a freshly minted API
+ * key). It lives ONLY in the in-memory transcript for the session — the message
+ * transcript is deliberately never cached (see `persistence.ts`) and is never
+ * sent back to the model (a turn request carries only the new user text, see
+ * {@link ChatRequest}). So the secret is shown once and is gone on reload,
+ * matching how a dedicated create-key page reveals a key exactly once. A host
+ * renderer must uphold the same contract: reveal-on-demand, never persist it.
+ */
+interface ConfirmedResult {
+    /** The confirmed tool's name (e.g. "create_api_key"). */
+    name: string;
+    /** The tool's raw output. May contain a one-time secret — see the type doc. */
+    output: unknown;
+    /** The arguments the action was confirmed with, for a renderer that needs them
+     *  (e.g. the key's name). */
+    args?: unknown;
+}
 interface ChatMessage {
     id: string;
     role: ChatRole;
@@ -188,6 +209,11 @@ interface ChatMessage {
         args?: Record<string, unknown>;
         outcome?: ToolOutcome;
     };
+    /** Present only on a `status` message that resolved a confirmed mutating tool
+     *  which returned a renderable result — carries that result so the transcript
+     *  can render a host-supplied card (e.g. a one-time key reveal) next to the
+     *  status line. See {@link ConfirmedResult} for the one-time-secret contract. */
+    result?: ConfirmedResult;
 }
 /** A mutating action the assistant proposed, awaiting the user's confirmation. */
 interface PendingProposal {
@@ -548,6 +574,10 @@ interface AssistantDockProps {
     formatMoney?: (usd: number | null) => string;
     /** Render workflow YAML as a node graph in a proposal card. */
     renderGraph?: (yaml: string) => ReactNode;
+    /** Render the brand icon for a proposal requirement's integration provider.
+     *  The host owns the provider→icon mapping (its integrations catalog); when
+     *  absent, the card falls back to its built-in provider mark. */
+    renderProviderIcon?: (provider: string) => ReactNode;
     /** Called after a workflow-mutating tool is confirmed (host re-fetches its list). */
     onWorkflowMutation?: () => void;
     /** In-place connect handler for a proposal's integration requirements. The host
@@ -560,12 +590,17 @@ interface AssistantDockProps {
     renderMarkdown?: (content: string) => ReactNode;
     /** Per-tool custom detail renderers for expanded tool cards in the transcript. */
     toolRenderers?: ToolDetailRenderers;
+    /** Render a prominent card for a CONFIRMED tool's result (e.g. a one-time
+     *  API-key reveal for `create_api_key`), shown inline after the action's status
+     *  line. The result's `output` may carry a one-time secret — see
+     *  {@link ConfirmedResult} for the never-persist/never-to-model contract. */
+    renderConfirmedResult?: (result: ConfirmedResult) => ReactNode;
     /** Swap the conversation rendering for a host-supplied renderer (see
      *  {@link AssistantPanelProps.renderTranscript}); the dock chrome, composer,
      *  transport, and proposal flow stay owned by the panel. */
     renderTranscript?: (view: AssistantTranscriptView) => ReactNode;
 }
-declare function AssistantDock({ userId, navigate, balanceUsd, formatMoney, renderGraph, onWorkflowMutation, onConnectRequirement, renderMarkdown, toolRenderers, renderTranscript, }: AssistantDockProps): react.JSX.Element;
+declare function AssistantDock({ userId, navigate, balanceUsd, formatMoney, renderGraph, renderProviderIcon, onWorkflowMutation, onConnectRequirement, renderMarkdown, toolRenderers, renderConfirmedResult, renderTranscript, }: AssistantDockProps): react.JSX.Element;
 
 interface AssistantPanelProps {
     chat: AssistantChat;
@@ -580,11 +615,18 @@ interface AssistantPanelProps {
     /** Render workflow YAML as a node graph in a proposal card (the `./workflows`
      *  WorkflowGraph). When absent, proposals show YAML as text. */
     renderGraph?: (yaml: string) => ReactNode;
+    /** Render the brand icon for a proposal requirement's integration provider.
+     *  When absent, the card falls back to its built-in provider mark. */
+    renderProviderIcon?: (provider: string) => ReactNode;
     /** Markdown renderer for assistant message content. When absent, content
      *  renders as plain pre-wrapped text. */
     renderMarkdown?: (content: string) => ReactNode;
     /** Per-tool custom detail renderers for expanded tool cards in the transcript. */
     toolRenderers?: ToolDetailRenderers;
+    /** Render a prominent card for a CONFIRMED tool's result (e.g. a one-time
+     *  API-key reveal for `create_api_key`), shown inline after the action's status
+     *  line. Ignored when a host swaps the whole transcript via `renderTranscript`. */
+    renderConfirmedResult?: (result: ConfirmedResult) => ReactNode;
     /** Swap ONLY the conversation rendering for a host-supplied renderer (e.g. a
      *  different chat-message component), while the panel keeps owning the header,
      *  composer, model picker, history, transport, and proposal orchestration.
@@ -593,7 +635,7 @@ interface AssistantPanelProps {
      *  conversation. */
     renderTranscript?: (view: AssistantTranscriptView) => ReactNode;
 }
-declare function AssistantPanel({ chat, userId, onClose, navigate, balanceUsd, formatMoney, renderGraph, renderMarkdown, toolRenderers, renderTranscript, }: AssistantPanelProps): react.JSX.Element;
+declare function AssistantPanel({ chat, userId, onClose, navigate, balanceUsd, formatMoney, renderGraph, renderProviderIcon, renderMarkdown, toolRenderers, renderConfirmedResult, renderTranscript, }: AssistantPanelProps): react.JSX.Element;
 
 /**
  * True while a turn is streaming but the model hasn't emitted its first answer
@@ -609,6 +651,10 @@ interface AdaptedTranscript {
     /** The current/most-recent turn's assistant message — where the turn cost line
      *  renders (it carries the turn's metrics), or null when there is none. */
     metricsHostId: string | null;
+    /** Confirmed-tool results to render under their (system) message, keyed by that
+     *  message's id — carried from a `status` message's retained `result` so a host
+     *  card (e.g. a one-time API-key reveal) renders inline right after the action. */
+    confirmedResults: Map<string, ConfirmedResult>;
 }
 /**
  * Fold the transcript view into web-react `ChatUiMessage[]`: each user message is
@@ -627,6 +673,12 @@ interface AssistantTranscriptProps {
     renderMarkdown?: (content: string) => ReactNode;
     /** Per-tool custom detail renderers for expanded tool cards. */
     toolRenderers?: ToolDetailRenderers;
+    /** Render a prominent card for a CONFIRMED tool's result, inline after its
+     *  status line (e.g. a one-time API-key reveal for `create_api_key`). Return
+     *  null to fall back to just the status line. Unlike `toolRenderers` (collapsed
+     *  detail for a read-only tool chip), this is shown expanded, so a one-time
+     *  secret is visible without a click. See {@link ConfirmedResult}. */
+    renderConfirmedResult?: (result: ConfirmedResult) => ReactNode;
     /** Zero-state shown for a fresh, non-streaming thread. */
     emptyState?: ReactNode;
 }
@@ -636,7 +688,7 @@ interface AssistantTranscriptProps {
  * after the proposing turn through `renderExtras`; the settled turn cost renders
  * once under its assistant bubble.
  */
-declare function AssistantTranscript({ view, renderMarkdown, toolRenderers, emptyState, }: AssistantTranscriptProps): react.JSX.Element;
+declare function AssistantTranscript({ view, renderMarkdown, toolRenderers, renderConfirmedResult, emptyState, }: AssistantTranscriptProps): react.JSX.Element;
 
 interface ProposalCardProps {
     proposal: PendingProposal;
@@ -655,8 +707,13 @@ interface ProposalCardProps {
     /** Render the workflow YAML as a node graph (the `./workflows` WorkflowGraph).
      *  When absent, the YAML is shown as text. */
     renderGraph?: (yaml: string) => ReactNode;
+    /** Render the brand icon for an integration requirement's provider. The host
+     *  owns the provider→icon mapping (its integrations catalog); when absent, or
+     *  when it returns a nullish node for a provider it doesn't recognize, the row
+     *  falls back to the built-in {@link ProviderLogo} mark. */
+    renderProviderIcon?: (provider: string) => ReactNode;
 }
-declare function ProposalCard({ proposal, confirming, onConfirm, onCancel, navigate, onConnect, renderGraph, }: ProposalCardProps): react.JSX.Element;
+declare function ProposalCard({ proposal, confirming, onConfirm, onCancel, navigate, onConnect, renderGraph, renderProviderIcon, }: ProposalCardProps): react.JSX.Element;
 
 interface AssistantLauncher {
     /** Whether the assistant drawer is open. */
@@ -674,4 +731,4 @@ declare function AssistantLauncherProvider({ children, }: {
 }): react.JSX.Element;
 declare function useAssistantLauncher(): AssistantLauncher;
 
-export { type AssistantChat, type AssistantClient, type AssistantClientConfig, AssistantClientInputError, AssistantClientProvider, type AssistantDeliveryMode, AssistantDock, type AssistantDockProps, type AssistantLauncher, AssistantLauncherProvider, type AssistantModelOption, type AssistantModels, type AssistantModelsResult, AssistantPanel, type AssistantPanelProps, type AssistantSendOptions, type AssistantStreamEvent, type AssistantThreadSummary, type AssistantThreads, AssistantTranscript, type AssistantTranscriptProps, type AssistantTranscriptView, type ChatMessage, type ChatRequest, type ChatRole, type ConfirmResult, type ConnectRequirementResult, type ConnectionRequirement, type ConnectionRequirementKind, type DeltaEventData, type DoneEventData, type ErrorEventData, type PendingProposal, ProposalCard, type ProposalCardProps, type ReasoningEventData, type ThreadEventData, type ThreadHistoryResult, type ToolActivityStatus, type ToolCallEventData, type ToolOutcome, type ToolProposalEventData, type ToolResultEventData, type UsageEventData, type UsageInfo, type UseAssistantChatOptions, adaptTranscript, assistantIsThinking, createAssistantClient, useAssistantChat, useAssistantClient, useAssistantLauncher, useAssistantModels, useAssistantThreads };
+export { type AssistantChat, type AssistantClient, type AssistantClientConfig, AssistantClientInputError, AssistantClientProvider, type AssistantDeliveryMode, AssistantDock, type AssistantDockProps, type AssistantLauncher, AssistantLauncherProvider, type AssistantModelOption, type AssistantModels, type AssistantModelsResult, AssistantPanel, type AssistantPanelProps, type AssistantSendOptions, type AssistantStreamEvent, type AssistantThreadSummary, type AssistantThreads, AssistantTranscript, type AssistantTranscriptProps, type AssistantTranscriptView, type ChatMessage, type ChatRequest, type ChatRole, type ConfirmResult, type ConfirmedResult, type ConnectRequirementResult, type ConnectionRequirement, type ConnectionRequirementKind, type DeltaEventData, type DoneEventData, type ErrorEventData, type PendingProposal, ProposalCard, type ProposalCardProps, type ReasoningEventData, type ThreadEventData, type ThreadHistoryResult, type ToolActivityStatus, type ToolCallEventData, type ToolOutcome, type ToolProposalEventData, type ToolResultEventData, type UsageEventData, type UsageInfo, type UseAssistantChatOptions, adaptTranscript, assistantIsThinking, createAssistantClient, useAssistantChat, useAssistantClient, useAssistantLauncher, useAssistantModels, useAssistantThreads };

package/dist/assistant/index.js

@@ -733,7 +733,7 @@ function describeOutcome(name, output) {
       return wf.enabled ? "Workflow enabled." : "Workflow disabled.";
     }
     case "create_api_key":
-      return o.prefix ? `Created API key (${str(o.prefix)}\u2026). Copy it from the API Keys page.` : "API key created.";
+      return o.prefix ? `Created API key (${str(o.prefix)}\u2026).` : "API key created.";
     case "revoke_api_key":
       return "API key revoked.";
     case "invoke_integration":
@@ -1345,10 +1345,19 @@ function useAssistantChat(userId, options) {
         return;
       }
       const { statusText, error } = resolveConfirmation(proposal.name, result);
+      const status = statusText ? statusMessage(statusText) : null;
+      if (status && result.ok && !error) {
+        const confirmed = {
+          name: proposal.name,
+          output: result.output,
+          args: proposal.args
+        };
+        status.result = confirmed;
+      }
       dispatch({
         type: "proposal_resolved",
         callId: proposal.callId,
-        status: statusText ? statusMessage(statusText) : null,
+        status,
         error
       });
       if (!error && WORKFLOW_MUTATING_TOOLS.has(proposal.name)) {
@@ -1789,7 +1798,7 @@ function providerLabel(provider) {
 }
 
 // src/assistant/ProposalCard.tsx
-import { Fragment, jsx as jsx3, jsxs as jsxs2 } from "react/jsx-runtime";
+import { jsx as jsx3, jsxs as jsxs2 } from "react/jsx-runtime";
 function ProposalCard({
   proposal,
   confirming,
@@ -1797,7 +1806,8 @@ function ProposalCard({
   onCancel,
   navigate,
   onConnect,
-  renderGraph
+  renderGraph,
+  renderProviderIcon
 }) {
   const view = describeProposal(proposal);
   const [tab, setTab] = useState4("graph");
@@ -1853,7 +1863,8 @@ function ProposalCard({
         {
           req: r,
           navigate,
-          onConnect
+          onConnect,
+          renderProviderIcon
         },
         `${r.provider}-${r.kind ?? "integration"}`
       )) }),
@@ -1904,7 +1915,8 @@ function openConnect(target, navigate) {
 function RequirementRow({
   req,
   navigate,
-  onConnect
+  onConnect,
+  renderProviderIcon
 }) {
   const [connecting, setConnecting] = useState4(false);
   const mountedRef = useRef3(true);
@@ -1938,9 +1950,15 @@ function RequirementRow({
       if (mountedRef.current) setConnecting(false);
     });
   };
+  let providerIcon;
+  try {
+    providerIcon = renderProviderIcon?.(req.provider) ?? null;
+  } catch {
+    providerIcon = null;
+  }
   return /* @__PURE__ */ jsxs2("li", { className: "flex items-center justify-between gap-2 text-xs", children: [
     /* @__PURE__ */ jsxs2("span", { className: "flex min-w-0 items-center gap-2", children: [
-      /* @__PURE__ */ jsx3(ProviderLogo, { provider: req.provider, size: 16 }),
+      providerIcon ?? /* @__PURE__ */ jsx3(ProviderLogo, { provider: req.provider, size: 16 }),
       /* @__PURE__ */ jsx3("span", { className: "truncate text-foreground", children: kindLabel }),
       /* @__PURE__ */ jsxs2("span", { className: "flex shrink-0 items-center gap-1", children: [
         /* @__PURE__ */ jsx3(
@@ -1965,11 +1983,8 @@ function RequirementRow({
         type: "button",
         onClick: handleConnect,
         disabled: connecting,
-        className: "shrink-0 text-primary disabled:opacity-50",
-        children: connecting ? isApp ? "Installing\u2026" : "Connecting\u2026" : /* @__PURE__ */ jsxs2(Fragment, { children: [
-          isApp ? "Install" : "Connect",
-          " \u2192"
-        ] })
+        className: "shrink-0 rounded border border-primary px-2 py-0.5 font-medium text-primary transition-colors hover:bg-primary/10 disabled:opacity-50",
+        children: connecting ? isApp ? "Installing\u2026" : "Connecting\u2026" : isApp ? "Install" : "Connect"
       }
     )
   ] });
@@ -1977,7 +1992,7 @@ function RequirementRow({
 
 // src/assistant/transcript.tsx
 import { useCallback as useCallback3, useMemo as useMemo2 } from "react";
-import { Fragment as Fragment2, jsx as jsx4, jsxs as jsxs3 } from "react/jsx-runtime";
+import { Fragment, jsx as jsx4, jsxs as jsxs3 } from "react/jsx-runtime";
 function assistantIsThinking(state) {
   if (state.status !== "streaming") return false;
   const streaming = state.streamingId ? state.messages.find((m) => m.id === state.streamingId) : void 0;
@@ -1994,6 +2009,7 @@ function adaptToolResult(outcome) {
 }
 function adaptTranscript(view) {
   const messages = [];
+  const confirmedResults = /* @__PURE__ */ new Map();
   let turn = null;
   let currentTurnAssistant = null;
   const openTurn = (id) => {
@@ -2037,6 +2053,7 @@ ${text}` : text;
       });
     } else {
       messages.push({ id: msg.id, role: "system", content: msg.text });
+      if (msg.result) confirmedResults.set(msg.id, msg.result);
       turn = null;
     }
   }
@@ -2065,7 +2082,8 @@ ${text}` : text;
   return {
     messages: messages.filter((m) => !isEmptyShell(m)),
     proposalHostId,
-    metricsHostId: currentTurnAssistant && !isEmptyShell(currentTurnAssistant) ? currentTurnAssistant.id : null
+    metricsHostId: currentTurnAssistant && !isEmptyShell(currentTurnAssistant) ? currentTurnAssistant.id : null,
+    confirmedResults
   };
 }
 function formatTurnCost(costUsd) {
@@ -2075,15 +2093,16 @@ function ProposalSlot({
   proposal,
   render
 }) {
-  return /* @__PURE__ */ jsx4(Fragment2, { children: render(proposal) });
+  return /* @__PURE__ */ jsx4(Fragment, { children: render(proposal) });
 }
 function AssistantTranscript({
   view,
   renderMarkdown,
   toolRenderers,
+  renderConfirmedResult,
   emptyState
 }) {
-  const { messages, proposalHostId, metricsHostId } = useMemo2(
+  const { messages, proposalHostId, metricsHostId, confirmedResults } = useMemo2(
     () => adaptTranscript(view),
     [view]
   );
@@ -2092,7 +2111,7 @@ function AssistantTranscript({
     [renderMarkdown]
   );
   if (messages.length === 0 && !view.isStreaming) {
-    return /* @__PURE__ */ jsx4(Fragment2, { children: emptyState });
+    return /* @__PURE__ */ jsx4(Fragment, { children: emptyState });
   }
   return /* @__PURE__ */ jsx4(
     ChatMessages,
@@ -2102,7 +2121,7 @@ function AssistantTranscript({
       agentLabel: "Assistant",
       renderMarkdown: markdown,
       toolRenderers,
-      renderEmpty: () => /* @__PURE__ */ jsx4(Fragment2, { children: emptyState }),
+      renderEmpty: () => /* @__PURE__ */ jsx4(Fragment, { children: emptyState }),
       renderExtras: (message) => {
         const proposals = message.id === proposalHostId && view.pendingProposals.length > 0 ? /* @__PURE__ */ jsx4("div", { className: "mt-3 flex flex-col gap-3", children: view.pendingProposals.map((proposal) => /* @__PURE__ */ jsx4(
           ProposalSlot,
@@ -2112,12 +2131,16 @@ function AssistantTranscript({
           },
           proposal.callId
         )) }) : null;
+        const confirmed = confirmedResults.get(message.id);
+        const confirmedNode = confirmed && renderConfirmedResult ? renderConfirmedResult(confirmed) : null;
+        const confirmedCard = confirmedNode ? /* @__PURE__ */ jsx4("div", { className: "mt-3", children: confirmedNode }) : null;
         const cost = message.id === metricsHostId && !view.isStreaming && view.usage?.costUsd != null && !view.usage.replayed ? /* @__PURE__ */ jsxs3("p", { className: "mt-1 text-[11px] text-muted-foreground", children: [
           formatTurnCost(view.usage.costUsd),
           " this turn"
         ] }) : null;
-        if (!proposals && !cost) return null;
-        return /* @__PURE__ */ jsxs3(Fragment2, { children: [
+        if (!proposals && !cost && !confirmedCard) return null;
+        return /* @__PURE__ */ jsxs3(Fragment, { children: [
+          confirmedCard,
           proposals,
           cost
         ] });
@@ -2318,8 +2341,10 @@ function AssistantPanel({
   balanceUsd = null,
   formatMoney = defaultFormatMoney,
   renderGraph,
+  renderProviderIcon,
   renderMarkdown,
   toolRenderers,
+  renderConfirmedResult,
   renderTranscript
 }) {
   const models = useAssistantModels();
@@ -2394,7 +2419,8 @@ function AssistantPanel({
       onCancel: () => chat.cancel(proposal),
       navigate,
       onConnect: chat.canConnectRequirement ? (requirement) => chat.connectRequirement(proposal, requirement) : void 0,
-      renderGraph
+      renderGraph,
+      renderProviderIcon
     }
   );
   const isThinking = assistantIsThinking(state);
@@ -2560,6 +2586,7 @@ function AssistantPanel({
               view: transcriptView,
               renderMarkdown,
               toolRenderers,
+              renderConfirmedResult,
               emptyState: /* @__PURE__ */ jsx5("p", { className: "px-4 py-8 text-center text-muted-foreground text-sm", children: EMPTY_STATE })
             }
           ) })
@@ -2772,7 +2799,7 @@ function ResizeHandle({
 }
 
 // src/assistant/AssistantDock.tsx
-import { Fragment as Fragment3, jsx as jsx8, jsxs as jsxs5 } from "react/jsx-runtime";
+import { Fragment as Fragment2, jsx as jsx8, jsxs as jsxs5 } from "react/jsx-runtime";
 function focusableWithin(container) {
   const selector = 'a[href], button:not([disabled]), textarea:not([disabled]), input:not([disabled]), select:not([disabled]), [tabindex]:not([tabindex="-1"])';
   return Array.from(container.querySelectorAll(selector)).filter(
@@ -2785,10 +2812,12 @@ function AssistantDock({
   balanceUsd = null,
   formatMoney,
   renderGraph,
+  renderProviderIcon,
   onWorkflowMutation,
   onConnectRequirement,
   renderMarkdown,
   toolRenderers,
+  renderConfirmedResult,
   renderTranscript
 }) {
   const { open, openAssistant, closeAssistant } = useAssistantLauncher();
@@ -2866,7 +2895,7 @@ function AssistantDock({
       first.focus();
     }
   };
-  return /* @__PURE__ */ jsxs5(Fragment3, { children: [
+  return /* @__PURE__ */ jsxs5(Fragment2, { children: [
     /* @__PURE__ */ jsx8(
       "div",
       {
@@ -2897,8 +2926,10 @@ function AssistantDock({
               balanceUsd,
               formatMoney,
               renderGraph,
+              renderProviderIcon,
               renderMarkdown,
               toolRenderers,
+              renderConfirmedResult,
               renderTranscript
             },
             userId ?? "anon"