@invergent/agent-chat-react 2.4.13 → 2.5.0

package/dist/index.d.cts

@@ -326,6 +326,13 @@ interface AgentChatBrowserControlResponse {
     outcome: "granted" | "refreshed" | "conflict";
     ownerUserId: string;
 }
+/** One source the planner curated with research_memory(add). */
+interface AgentChatResearchSource {
+    /** Stable identifier — citations in the report refer to this (e.g. "S3"). */
+    sourceId: string;
+    url: string;
+    title: string;
+}
 interface AgentChatState {
     messages: AgentChatMessage[];
     isRunning: boolean;
@@ -339,6 +346,9 @@ interface AgentChatState {
     workspaceRefreshKey: number;
     browser: AgentChatBrowserState | null;
     viewMode: AgentChatViewMode;
+    /** Sources collected from successful research_memory(add) tool
+     *  results.  Deduped by sourceId on insertion. */
+    researchSources: AgentChatResearchSource[];
 }
 type AgentChatViewMode = "simple" | "expert";
 type AgentChatArtifactKind = "markdown" | "table" | "chart" | "html" | "svg";
@@ -678,6 +688,10 @@ interface AgentChatRuntimeApi {
     viewMode: AgentChatViewMode;
     /** Update the chat view mode + persist via adapter / localStorage. */
     setViewMode(mode: AgentChatViewMode): void;
+    /** Sources collected from ``research_memory(add)`` tool results.
+     *  Hosts render the sources/citations panel from this array; the
+     *  ``CitationText`` helper resolves ``[S#]`` markers against it. */
+    researchSources: AgentChatResearchSource[];
 }
 type ChatMessage = AgentChatMessage;
 type SessionTreeNode = AgentChatSessionTreeNode;
@@ -731,8 +745,17 @@ interface AgentChatProps {
      * their toast system; the SDK does not surface these on its own.
      */
     onComposerError?: (err: ChatComposerError) => void;
+    /**
+     * Per-agent capability flag.  When true, the composer surfaces the
+     * ``/deep-research`` slash command in its builtin menu.  Off by
+     * default; the host (Studio) reads it from the agent record and
+     * passes it through.  Wired this way (not via the runtime) because
+     * the SDK has no notion of the agent's settings -- the host owns
+     * that domain.
+     */
+    deepResearchEnabled?: boolean;
 }
-declare function AgentChat({ adapter, agentId, sessionId, onSessionChange, onFileSelect, onMessagesChange, disabled, onComposerError, }: AgentChatProps): react_jsx_runtime.JSX.Element;
+declare function AgentChat({ adapter, agentId, sessionId, onSessionChange, onFileSelect, onMessagesChange, disabled, onComposerError, deepResearchEnabled, }: AgentChatProps): react_jsx_runtime.JSX.Element;
 
 interface AgentChatAdapterContextValue {
     adapter: AgentChatAdapter;
@@ -818,6 +841,36 @@ declare function groupMissionTasksByBucket(tasks: AgentChatMissionTask[]): Recor
  */
 declare function deriveMissionWorkerActivityLabel(worker: AgentChatMissionWorker): string;
 
+declare function ResearchSourcesPanel({ sources, }: {
+    sources: AgentChatResearchSource[];
+}): react_jsx_runtime.JSX.Element;
+
+type CitationSegment = {
+    kind: "text";
+    value: string;
+} | {
+    kind: "cite";
+    value: string;
+};
+/**
+ * Split *text* into plain-text and citation segments.
+ *
+ * Comma-grouped markers expand into one ``cite`` segment per ID.
+ * Empty input returns an empty array.  Invalid markers are passed
+ * through verbatim as ``text``.
+ */
+declare function splitCitations(text: string): CitationSegment[];
+/**
+ * Render *text* with each ``[S#]`` marker as a chip that links to the
+ * matching :class:`AgentChatResearchSource`.  Hosts pass
+ * ``onCitationClick`` to scroll the sources panel to the entry.
+ */
+declare function CitationText({ text, sources, onCitationClick, }: {
+    text: string;
+    sources: AgentChatResearchSource[];
+    onCitationClick?: (sourceId: string) => void;
+}): react_jsx_runtime.JSX.Element;
+
 interface ScheduledWorkPanelProps {
     adapter: AgentChatAdapter;
     agentId?: string;
@@ -854,4 +907,4 @@ interface SessionTreePanelProps {
 }
 declare function SessionTreePanel({ adapter, sessionId, activeSessionId, agentId, title, sessionListLimit, hideRoot, hideHeader, loadList, onSessionSelect, onSessionDelete, }: SessionTreePanelProps): react_jsx_runtime.JSX.Element | null;
 
-export { ACTIVE_MISSION_STATUSES, AgentChat, type AgentChatAdapter, type AgentChatAdapterContextValue, AgentChatAdapterProvider, type AgentChatArtifactKind, type AgentChatArtifactMeta, type AgentChatArtifactPayload, type AgentChatAskUserQuestionAnswer, type AgentChatAskUserQuestionArgs, type AgentChatAskUserQuestionChoice, type AgentChatAskUserQuestionQuestion, type AgentChatAttachment, type AgentChatChartArtifactSpec, type AgentChatDisplayAttachment, type AgentChatErrorCategory, type AgentChatErrorInfo, type AgentChatEventStream, type AgentChatEventType, type AgentChatExpertFeedbackRating, type AgentChatHtmlArtifactSpec, type AgentChatImageAttachment, type AgentChatInboxEventStream, type AgentChatInboxItem, type AgentChatInboxKind, type AgentChatInboxList, type AgentChatInboxListInput, type AgentChatInboxStatus, type AgentChatInboxStreamEvent, type AgentChatMarkdownArtifactSpec, type AgentChatMessage, type AgentChatMessageStatus, type AgentChatMissionList, type AgentChatMissionStatus, type AgentChatMissionSummary, type AgentChatMissionTask, type AgentChatMissionWorker, type AgentChatPendingAttachment, type AgentChatProps, type AgentChatRole, type AgentChatRuntimeApi, type AgentChatRuntimeEvent, type AgentChatScheduledWorkItem, type AgentChatScheduledWorkKind, type AgentChatScheduledWorkList, type AgentChatSession, type AgentChatSessionList, type AgentChatSessionTree, type AgentChatSessionTreeNode, type AgentChatSlashCommand, type AgentChatSseMessageEvent, type AgentChatState, type AgentChatSvgArtifactSpec, type AgentChatSystemKind, type AgentChatTableArtifactSpec, type AgentChatTokenUsage, type AgentChatToolCallInfo, type AgentChatWorkspaceEntry, type AgentChatWorkspaceFile, type AgentChatWorkspaceTree, type AgentChatWorkspaceUpload, type ArtifactKind, type ArtifactPayload, type AskUserQuestionAnswer, type AskUserQuestionArgs, type AskUserQuestionChoice, type AskUserQuestionQuestion, type ChartArtifactSpec, type ChatComposerError, type ChatMessage, type ErrorInfo, type HtmlArtifactSpec, type InboxItem, type InboxList, InboxPanel, type InboxPanelProps, type InboxUnreadCountState, type MarkdownArtifactSpec, MessageResponse, type MessageResponseProps, MissionDashboard, type MissionDashboardProps, type MissionTaskBucket, MissionsPanel, type MissionsPanelProps, type RetryIndicator, type ScheduledWorkItem, type ScheduledWorkList, ScheduledWorkPanel, type ScheduledWorkPanelProps, type SessionTree, type SessionTreeNode, SessionTreePanel, type SessionTreePanelProps, type SvgArtifactSpec, type TableArtifactSpec, type TokenUsage, type ToolCallInfo, type WorkspaceEntry, type WorkspaceFile, type WorkspaceTree, type WorkspaceUpload, deriveMissionWorkerActivityLabel, groupMissionTasksByBucket, isTerminalMissionStatus, missionTaskBucket, useAgentChatAdapterContext, useAgentChatRuntime, useChatViewMode, useInboxUnreadCount };
+export { ACTIVE_MISSION_STATUSES, AgentChat, type AgentChatAdapter, type AgentChatAdapterContextValue, AgentChatAdapterProvider, type AgentChatArtifactKind, type AgentChatArtifactMeta, type AgentChatArtifactPayload, type AgentChatAskUserQuestionAnswer, type AgentChatAskUserQuestionArgs, type AgentChatAskUserQuestionChoice, type AgentChatAskUserQuestionQuestion, type AgentChatAttachment, type AgentChatChartArtifactSpec, type AgentChatDisplayAttachment, type AgentChatErrorCategory, type AgentChatErrorInfo, type AgentChatEventStream, type AgentChatEventType, type AgentChatExpertFeedbackRating, type AgentChatHtmlArtifactSpec, type AgentChatImageAttachment, type AgentChatInboxEventStream, type AgentChatInboxItem, type AgentChatInboxKind, type AgentChatInboxList, type AgentChatInboxListInput, type AgentChatInboxStatus, type AgentChatInboxStreamEvent, type AgentChatMarkdownArtifactSpec, type AgentChatMessage, type AgentChatMessageStatus, type AgentChatMissionList, type AgentChatMissionStatus, type AgentChatMissionSummary, type AgentChatMissionTask, type AgentChatMissionWorker, type AgentChatPendingAttachment, type AgentChatProps, type AgentChatResearchSource, type AgentChatRole, type AgentChatRuntimeApi, type AgentChatRuntimeEvent, type AgentChatScheduledWorkItem, type AgentChatScheduledWorkKind, type AgentChatScheduledWorkList, type AgentChatSession, type AgentChatSessionList, type AgentChatSessionTree, type AgentChatSessionTreeNode, type AgentChatSlashCommand, type AgentChatSseMessageEvent, type AgentChatState, type AgentChatSvgArtifactSpec, type AgentChatSystemKind, type AgentChatTableArtifactSpec, type AgentChatTokenUsage, type AgentChatToolCallInfo, type AgentChatWorkspaceEntry, type AgentChatWorkspaceFile, type AgentChatWorkspaceTree, type AgentChatWorkspaceUpload, type ArtifactKind, type ArtifactPayload, type AskUserQuestionAnswer, type AskUserQuestionArgs, type AskUserQuestionChoice, type AskUserQuestionQuestion, type ChartArtifactSpec, type ChatComposerError, type ChatMessage, type CitationSegment, CitationText, type ErrorInfo, type HtmlArtifactSpec, type InboxItem, type InboxList, InboxPanel, type InboxPanelProps, type InboxUnreadCountState, type MarkdownArtifactSpec, MessageResponse, type MessageResponseProps, MissionDashboard, type MissionDashboardProps, type MissionTaskBucket, MissionsPanel, type MissionsPanelProps, ResearchSourcesPanel, type RetryIndicator, type ScheduledWorkItem, type ScheduledWorkList, ScheduledWorkPanel, type ScheduledWorkPanelProps, type SessionTree, type SessionTreeNode, SessionTreePanel, type SessionTreePanelProps, type SvgArtifactSpec, type TableArtifactSpec, type TokenUsage, type ToolCallInfo, type WorkspaceEntry, type WorkspaceFile, type WorkspaceTree, type WorkspaceUpload, deriveMissionWorkerActivityLabel, groupMissionTasksByBucket, isTerminalMissionStatus, missionTaskBucket, splitCitations, useAgentChatAdapterContext, useAgentChatRuntime, useChatViewMode, useInboxUnreadCount };

package/dist/index.d.ts

@@ -326,6 +326,13 @@ interface AgentChatBrowserControlResponse {
     outcome: "granted" | "refreshed" | "conflict";
     ownerUserId: string;
 }
+/** One source the planner curated with research_memory(add). */
+interface AgentChatResearchSource {
+    /** Stable identifier — citations in the report refer to this (e.g. "S3"). */
+    sourceId: string;
+    url: string;
+    title: string;
+}
 interface AgentChatState {
     messages: AgentChatMessage[];
     isRunning: boolean;
@@ -339,6 +346,9 @@ interface AgentChatState {
     workspaceRefreshKey: number;
     browser: AgentChatBrowserState | null;
     viewMode: AgentChatViewMode;
+    /** Sources collected from successful research_memory(add) tool
+     *  results.  Deduped by sourceId on insertion. */
+    researchSources: AgentChatResearchSource[];
 }
 type AgentChatViewMode = "simple" | "expert";
 type AgentChatArtifactKind = "markdown" | "table" | "chart" | "html" | "svg";
@@ -678,6 +688,10 @@ interface AgentChatRuntimeApi {
     viewMode: AgentChatViewMode;
     /** Update the chat view mode + persist via adapter / localStorage. */
     setViewMode(mode: AgentChatViewMode): void;
+    /** Sources collected from ``research_memory(add)`` tool results.
+     *  Hosts render the sources/citations panel from this array; the
+     *  ``CitationText`` helper resolves ``[S#]`` markers against it. */
+    researchSources: AgentChatResearchSource[];
 }
 type ChatMessage = AgentChatMessage;
 type SessionTreeNode = AgentChatSessionTreeNode;
@@ -731,8 +745,17 @@ interface AgentChatProps {
      * their toast system; the SDK does not surface these on its own.
      */
     onComposerError?: (err: ChatComposerError) => void;
+    /**
+     * Per-agent capability flag.  When true, the composer surfaces the
+     * ``/deep-research`` slash command in its builtin menu.  Off by
+     * default; the host (Studio) reads it from the agent record and
+     * passes it through.  Wired this way (not via the runtime) because
+     * the SDK has no notion of the agent's settings -- the host owns
+     * that domain.
+     */
+    deepResearchEnabled?: boolean;
 }
-declare function AgentChat({ adapter, agentId, sessionId, onSessionChange, onFileSelect, onMessagesChange, disabled, onComposerError, }: AgentChatProps): react_jsx_runtime.JSX.Element;
+declare function AgentChat({ adapter, agentId, sessionId, onSessionChange, onFileSelect, onMessagesChange, disabled, onComposerError, deepResearchEnabled, }: AgentChatProps): react_jsx_runtime.JSX.Element;
 
 interface AgentChatAdapterContextValue {
     adapter: AgentChatAdapter;
@@ -818,6 +841,36 @@ declare function groupMissionTasksByBucket(tasks: AgentChatMissionTask[]): Recor
  */
 declare function deriveMissionWorkerActivityLabel(worker: AgentChatMissionWorker): string;
 
+declare function ResearchSourcesPanel({ sources, }: {
+    sources: AgentChatResearchSource[];
+}): react_jsx_runtime.JSX.Element;
+
+type CitationSegment = {
+    kind: "text";
+    value: string;
+} | {
+    kind: "cite";
+    value: string;
+};
+/**
+ * Split *text* into plain-text and citation segments.
+ *
+ * Comma-grouped markers expand into one ``cite`` segment per ID.
+ * Empty input returns an empty array.  Invalid markers are passed
+ * through verbatim as ``text``.
+ */
+declare function splitCitations(text: string): CitationSegment[];
+/**
+ * Render *text* with each ``[S#]`` marker as a chip that links to the
+ * matching :class:`AgentChatResearchSource`.  Hosts pass
+ * ``onCitationClick`` to scroll the sources panel to the entry.
+ */
+declare function CitationText({ text, sources, onCitationClick, }: {
+    text: string;
+    sources: AgentChatResearchSource[];
+    onCitationClick?: (sourceId: string) => void;
+}): react_jsx_runtime.JSX.Element;
+
 interface ScheduledWorkPanelProps {
     adapter: AgentChatAdapter;
     agentId?: string;
@@ -854,4 +907,4 @@ interface SessionTreePanelProps {
 }
 declare function SessionTreePanel({ adapter, sessionId, activeSessionId, agentId, title, sessionListLimit, hideRoot, hideHeader, loadList, onSessionSelect, onSessionDelete, }: SessionTreePanelProps): react_jsx_runtime.JSX.Element | null;
 
-export { ACTIVE_MISSION_STATUSES, AgentChat, type AgentChatAdapter, type AgentChatAdapterContextValue, AgentChatAdapterProvider, type AgentChatArtifactKind, type AgentChatArtifactMeta, type AgentChatArtifactPayload, type AgentChatAskUserQuestionAnswer, type AgentChatAskUserQuestionArgs, type AgentChatAskUserQuestionChoice, type AgentChatAskUserQuestionQuestion, type AgentChatAttachment, type AgentChatChartArtifactSpec, type AgentChatDisplayAttachment, type AgentChatErrorCategory, type AgentChatErrorInfo, type AgentChatEventStream, type AgentChatEventType, type AgentChatExpertFeedbackRating, type AgentChatHtmlArtifactSpec, type AgentChatImageAttachment, type AgentChatInboxEventStream, type AgentChatInboxItem, type AgentChatInboxKind, type AgentChatInboxList, type AgentChatInboxListInput, type AgentChatInboxStatus, type AgentChatInboxStreamEvent, type AgentChatMarkdownArtifactSpec, type AgentChatMessage, type AgentChatMessageStatus, type AgentChatMissionList, type AgentChatMissionStatus, type AgentChatMissionSummary, type AgentChatMissionTask, type AgentChatMissionWorker, type AgentChatPendingAttachment, type AgentChatProps, type AgentChatRole, type AgentChatRuntimeApi, type AgentChatRuntimeEvent, type AgentChatScheduledWorkItem, type AgentChatScheduledWorkKind, type AgentChatScheduledWorkList, type AgentChatSession, type AgentChatSessionList, type AgentChatSessionTree, type AgentChatSessionTreeNode, type AgentChatSlashCommand, type AgentChatSseMessageEvent, type AgentChatState, type AgentChatSvgArtifactSpec, type AgentChatSystemKind, type AgentChatTableArtifactSpec, type AgentChatTokenUsage, type AgentChatToolCallInfo, type AgentChatWorkspaceEntry, type AgentChatWorkspaceFile, type AgentChatWorkspaceTree, type AgentChatWorkspaceUpload, type ArtifactKind, type ArtifactPayload, type AskUserQuestionAnswer, type AskUserQuestionArgs, type AskUserQuestionChoice, type AskUserQuestionQuestion, type ChartArtifactSpec, type ChatComposerError, type ChatMessage, type ErrorInfo, type HtmlArtifactSpec, type InboxItem, type InboxList, InboxPanel, type InboxPanelProps, type InboxUnreadCountState, type MarkdownArtifactSpec, MessageResponse, type MessageResponseProps, MissionDashboard, type MissionDashboardProps, type MissionTaskBucket, MissionsPanel, type MissionsPanelProps, type RetryIndicator, type ScheduledWorkItem, type ScheduledWorkList, ScheduledWorkPanel, type ScheduledWorkPanelProps, type SessionTree, type SessionTreeNode, SessionTreePanel, type SessionTreePanelProps, type SvgArtifactSpec, type TableArtifactSpec, type TokenUsage, type ToolCallInfo, type WorkspaceEntry, type WorkspaceFile, type WorkspaceTree, type WorkspaceUpload, deriveMissionWorkerActivityLabel, groupMissionTasksByBucket, isTerminalMissionStatus, missionTaskBucket, useAgentChatAdapterContext, useAgentChatRuntime, useChatViewMode, useInboxUnreadCount };
+export { ACTIVE_MISSION_STATUSES, AgentChat, type AgentChatAdapter, type AgentChatAdapterContextValue, AgentChatAdapterProvider, type AgentChatArtifactKind, type AgentChatArtifactMeta, type AgentChatArtifactPayload, type AgentChatAskUserQuestionAnswer, type AgentChatAskUserQuestionArgs, type AgentChatAskUserQuestionChoice, type AgentChatAskUserQuestionQuestion, type AgentChatAttachment, type AgentChatChartArtifactSpec, type AgentChatDisplayAttachment, type AgentChatErrorCategory, type AgentChatErrorInfo, type AgentChatEventStream, type AgentChatEventType, type AgentChatExpertFeedbackRating, type AgentChatHtmlArtifactSpec, type AgentChatImageAttachment, type AgentChatInboxEventStream, type AgentChatInboxItem, type AgentChatInboxKind, type AgentChatInboxList, type AgentChatInboxListInput, type AgentChatInboxStatus, type AgentChatInboxStreamEvent, type AgentChatMarkdownArtifactSpec, type AgentChatMessage, type AgentChatMessageStatus, type AgentChatMissionList, type AgentChatMissionStatus, type AgentChatMissionSummary, type AgentChatMissionTask, type AgentChatMissionWorker, type AgentChatPendingAttachment, type AgentChatProps, type AgentChatResearchSource, type AgentChatRole, type AgentChatRuntimeApi, type AgentChatRuntimeEvent, type AgentChatScheduledWorkItem, type AgentChatScheduledWorkKind, type AgentChatScheduledWorkList, type AgentChatSession, type AgentChatSessionList, type AgentChatSessionTree, type AgentChatSessionTreeNode, type AgentChatSlashCommand, type AgentChatSseMessageEvent, type AgentChatState, type AgentChatSvgArtifactSpec, type AgentChatSystemKind, type AgentChatTableArtifactSpec, type AgentChatTokenUsage, type AgentChatToolCallInfo, type AgentChatWorkspaceEntry, type AgentChatWorkspaceFile, type AgentChatWorkspaceTree, type AgentChatWorkspaceUpload, type ArtifactKind, type ArtifactPayload, type AskUserQuestionAnswer, type AskUserQuestionArgs, type AskUserQuestionChoice, type AskUserQuestionQuestion, type ChartArtifactSpec, type ChatComposerError, type ChatMessage, type CitationSegment, CitationText, type ErrorInfo, type HtmlArtifactSpec, type InboxItem, type InboxList, InboxPanel, type InboxPanelProps, type InboxUnreadCountState, type MarkdownArtifactSpec, MessageResponse, type MessageResponseProps, MissionDashboard, type MissionDashboardProps, type MissionTaskBucket, MissionsPanel, type MissionsPanelProps, ResearchSourcesPanel, type RetryIndicator, type ScheduledWorkItem, type ScheduledWorkList, ScheduledWorkPanel, type ScheduledWorkPanelProps, type SessionTree, type SessionTreeNode, SessionTreePanel, type SessionTreePanelProps, type SvgArtifactSpec, type TableArtifactSpec, type TokenUsage, type ToolCallInfo, type WorkspaceEntry, type WorkspaceFile, type WorkspaceTree, type WorkspaceUpload, deriveMissionWorkerActivityLabel, groupMissionTasksByBucket, isTerminalMissionStatus, missionTaskBucket, splitCitations, useAgentChatAdapterContext, useAgentChatRuntime, useChatViewMode, useInboxUnreadCount };

package/dist/index.js

@@ -4216,6 +4216,51 @@ function DefaultToolBlock({ tc }) {
     ] })
   ] });
 }
+function ResearchOutlineBlock({ tc }) {
+  const args = parseArgs(tc.args) ?? {};
+  const result = tc.result ? parseArgs(tc.result) ?? {} : {};
+  const outline = args.action === "set" ? args.outline ?? "" : result.outline ?? "";
+  const sections = result.sections ?? [];
+  return /* @__PURE__ */ jsxs("div", { className: "rounded-sm border border-border bg-muted/40 p-2 text-xs", children: [
+    /* @__PURE__ */ jsxs("div", { className: "mb-1 font-semibold uppercase tracking-widest text-muted-foreground", children: [
+      "Research outline",
+      sections.length ? ` \xB7 ${sections.length} sections` : ""
+    ] }),
+    outline ? /* @__PURE__ */ jsx("pre", { className: "max-h-48 overflow-auto whitespace-pre-wrap font-mono text-[11px] leading-snug", children: outline }) : /* @__PURE__ */ jsx("span", { className: "text-muted-foreground", children: "updated" })
+  ] });
+}
+function ResearchMemoryBlock({ tc }) {
+  const args = parseArgs(tc.args) ?? {};
+  const result = tc.result ? parseArgs(tc.result) ?? {} : {};
+  let label;
+  if (args.action === "add") {
+    const host = args.url ? hostname(args.url) : "";
+    label = `Recorded source ${result.source_id ?? ""}${host ? ` \xB7 ${host}` : ""}`;
+  } else if (args.action === "retrieve") {
+    const n = result.sources?.length ?? 0;
+    label = `Retrieved ${n} source${n === 1 ? "" : "s"}${args.query ? ` for "${truncate2(args.query)}"` : ""}`;
+  } else if (args.action === "list") {
+    const n = result.sources?.length ?? 0;
+    label = `Listed ${n} source${n === 1 ? "" : "s"}`;
+  } else {
+    label = "research_memory";
+  }
+  return /* @__PURE__ */ jsxs("div", { className: "text-xs text-muted-foreground", children: [
+    /* @__PURE__ */ jsx("span", { className: "font-semibold text-foreground", children: "research" }),
+    " ",
+    label
+  ] });
+}
+function hostname(url) {
+  try {
+    return new URL(url).hostname.replace(/^www\./, "");
+  } catch {
+    return url;
+  }
+}
+function truncate2(s, n = 40) {
+  return s.length > n ? `${s.slice(0, n)}\u2026` : s;
+}
 function ToolCallBlock({
   tc,
   resolvedArtifactName,
@@ -4268,6 +4313,10 @@ function ToolCallBlock({
       return /* @__PURE__ */ jsx(DelegateToolBlock, { tc });
     case "memory":
       return /* @__PURE__ */ jsx(MemoryToolBlock, { tc });
+    case "research_outline":
+      return /* @__PURE__ */ jsx(ResearchOutlineBlock, { tc });
+    case "research_memory":
+      return /* @__PURE__ */ jsx(ResearchMemoryBlock, { tc });
     case "spawn_worker":
     case "send_worker_message":
     case "stop_worker":
@@ -5792,6 +5841,7 @@ function ChatComposerInner({
   onToggleWorkspace,
   canShowBrowser = false,
   canShowWorkspace = false,
+  deepResearchEnabled = false,
   viewMode = "simple",
   onViewModeChange
 }) {
@@ -5821,24 +5871,34 @@ function ChatComposerInner({
     }
   }, [adapter, showSlashMenu, menuMode]);
   const builtinCommands = useMemo(
-    () => [
-      { value: "/clear", label: "/clear", description: "Clear conversation" },
-      { value: "/compress", label: "/compress", description: "Compress context" },
-      { value: "/goal", label: "/goal", description: "Define an outcome goal" },
-      { value: "/goal status", label: "/goal status", description: "Show outcome goal status" },
-      { value: "/goal pause", label: "/goal pause", description: "Pause automatic goal continuation" },
-      { value: "/goal resume", label: "/goal resume", description: "Resume a paused goal" },
-      { value: "/goal clear", label: "/goal clear", description: "Clear the current goal" },
-      { value: "/mission ", label: "/mission", description: "Start an orchestrated rubric-judged mission" },
-      { value: "/mission status", label: "/mission status", description: "Show current mission status" },
-      { value: "/mission pause", label: "/mission pause", description: "Pause the mission evaluator" },
-      { value: "/mission resume", label: "/mission resume", description: "Resume a paused mission" },
-      { value: "/mission cancel", label: "/mission cancel", description: "Cancel the mission" },
-      { value: "/loop", label: "/loop", description: "Schedule recurring prompt" },
-      { value: "/loop list", label: "/loop list", description: "List active loops" },
-      { value: "/loop cancel", label: "/loop cancel", description: "Cancel a loop by ID" }
-    ],
-    []
+    () => {
+      const base = [
+        { value: "/clear", label: "/clear", description: "Clear conversation" },
+        { value: "/compress", label: "/compress", description: "Compress context" },
+        { value: "/goal", label: "/goal", description: "Define an outcome goal" },
+        { value: "/goal status", label: "/goal status", description: "Show outcome goal status" },
+        { value: "/goal pause", label: "/goal pause", description: "Pause automatic goal continuation" },
+        { value: "/goal resume", label: "/goal resume", description: "Resume a paused goal" },
+        { value: "/goal clear", label: "/goal clear", description: "Clear the current goal" },
+        { value: "/mission ", label: "/mission", description: "Start an orchestrated rubric-judged mission" },
+        { value: "/mission status", label: "/mission status", description: "Show current mission status" },
+        { value: "/mission pause", label: "/mission pause", description: "Pause the mission evaluator" },
+        { value: "/mission resume", label: "/mission resume", description: "Resume a paused mission" },
+        { value: "/mission cancel", label: "/mission cancel", description: "Cancel the mission" },
+        { value: "/loop", label: "/loop", description: "Schedule recurring prompt" },
+        { value: "/loop list", label: "/loop list", description: "List active loops" },
+        { value: "/loop cancel", label: "/loop cancel", description: "Cancel a loop by ID" }
+      ];
+      if (deepResearchEnabled) {
+        base.push({
+          value: "/deep-research ",
+          label: "/deep-research",
+          description: "Delegate a topic to the deep-research workflow"
+        });
+      }
+      return base;
+    },
+    [deepResearchEnabled]
   );
   const scheduledExamples = useMemo(
     () => [
@@ -8503,11 +8563,11 @@ function extractToolDetail(tc) {
     }
     case "terminal": {
       const cmd = stringArg("command");
-      return cmd ? truncate2(cmd, 40) : null;
+      return cmd ? truncate3(cmd, 40) : null;
     }
     case "execute_code": {
       const code3 = stringArg("code");
-      return code3 ? truncate2(code3.split("\n")[0] ?? "", 40) : null;
+      return code3 ? truncate3(code3.split("\n")[0] ?? "", 40) : null;
     }
     case "web_search":
     case "web_crawl":
@@ -8532,7 +8592,7 @@ function lastPathSegment(path) {
   const idx = cleaned.lastIndexOf("/");
   return idx >= 0 ? cleaned.slice(idx + 1) : cleaned;
 }
-function truncate2(s, max) {
+function truncate3(s, max) {
   return s.length > max ? `${s.slice(0, max - 1)}\u2026` : s;
 }
 var _SIMPLE_MODE_HIDDEN_TOOLS = /* @__PURE__ */ new Set([
@@ -9033,7 +9093,8 @@ function ChatThread({
   canShowBrowser = false,
   canShowWorkspace = false,
   viewMode = "simple",
-  onViewModeChange
+  onViewModeChange,
+  deepResearchEnabled = false
 }) {
   const groups = useMemo(() => groupMessages(messages), [messages]);
   const awaitingInput = useMemo(() => isAwaitingUserInput(messages), [messages]);
@@ -9166,12 +9227,51 @@ function ChatThread({
           canShowBrowser,
           canShowWorkspace,
           viewMode,
-          onViewModeChange
+          onViewModeChange,
+          deepResearchEnabled
         }
       )
     ] })
   ] });
 }
+function ResearchSourcesPanel({
+  sources
+}) {
+  if (sources.length === 0) {
+    return /* @__PURE__ */ jsx("div", { className: "p-3 text-xs text-muted-foreground", children: "No research sources yet. Sources appear here as the deep-research agent curates evidence." });
+  }
+  return /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-1 p-2", children: [
+    /* @__PURE__ */ jsxs("div", { className: "px-1 pb-1 text-[10px] font-semibold uppercase tracking-widest text-muted-foreground", children: [
+      "Sources \xB7 ",
+      sources.length
+    ] }),
+    sources.map((s) => /* @__PURE__ */ jsxs(
+      "a",
+      {
+        id: `source-${s.sourceId}`,
+        href: s.url,
+        target: "_blank",
+        rel: "noreferrer",
+        className: "group flex items-baseline gap-2 rounded-sm px-1 py-1 hover:bg-muted",
+        children: [
+          /* @__PURE__ */ jsx("span", { className: "shrink-0 text-[10px] font-semibold text-primary", children: s.sourceId }),
+          /* @__PURE__ */ jsxs("span", { className: "flex flex-col overflow-hidden", children: [
+            /* @__PURE__ */ jsx("span", { className: "truncate text-xs text-foreground group-hover:underline", children: s.title || s.url }),
+            /* @__PURE__ */ jsx("span", { className: "truncate text-[10px] text-muted-foreground", children: hostname2(s.url) })
+          ] })
+        ]
+      },
+      s.sourceId
+    ))
+  ] });
+}
+function hostname2(url) {
+  try {
+    return new URL(url).hostname.replace(/^www\./, "");
+  } catch {
+    return url;
+  }
+}
 var noop = () => {
 };
 var FileTreeContext = createContext({
@@ -9909,7 +10009,8 @@ function createInitialAgentChatState(options = {}) {
     terminal: false,
     workspaceRefreshKey: 0,
     browser: null,
-    viewMode: options.viewMode ?? "simple"
+    viewMode: options.viewMode ?? "simple",
+    researchSources: []
   };
 }
 function applyAgentChatEvent(state, event) {
@@ -9995,11 +10096,12 @@ function applyAgentChatEvent(state, event) {
       const toolName = findToolNameById(nextState.messages, toolCallId);
       const messages = applyToolResult(nextState.messages, event.data);
       const mutatesWorkspace = toolName !== null && WORKSPACE_MUTATING_TOOLS.has(toolName);
-      return {
+      const withResult = {
         ...nextState,
         messages,
         workspaceRefreshKey: mutatesWorkspace ? nextState.workspaceRefreshKey + 1 : nextState.workspaceRefreshKey
       };
+      return collectResearchSource(withResult, toolName, event.data);
     }
     case "harness.wake":
     case "llm.request":
@@ -10731,6 +10833,32 @@ function findToolNameById(messages, toolCallId) {
   }
   return null;
 }
+function collectResearchSource(state, toolName, data) {
+  if (toolName !== "research_memory") return state;
+  const rawResult = data.content ?? data.result;
+  const resultText = typeof rawResult === "string" ? rawResult : JSON.stringify(rawResult ?? {});
+  let parsed;
+  try {
+    parsed = JSON.parse(resultText);
+  } catch {
+    return state;
+  }
+  if (!parsed.success || !parsed.source_id || !parsed.url) return state;
+  if (state.researchSources.some((s) => s.sourceId === parsed.source_id)) {
+    return state;
+  }
+  return {
+    ...state,
+    researchSources: [
+      ...state.researchSources,
+      {
+        sourceId: parsed.source_id,
+        url: parsed.url,
+        title: parsed.title ?? ""
+      }
+    ]
+  };
+}
 function findLatestConsultExpertCall(messages) {
   for (let i = messages.length - 1; i >= 0; i--) {
     const msg = messages[i];
@@ -11180,7 +11308,8 @@ function useAgentChatRuntime({
     markSending,
     markSendError,
     viewMode: state.viewMode,
-    setViewMode
+    setViewMode,
+    researchSources: state.researchSources
   };
 }
 function parseEventData(data) {
@@ -11239,7 +11368,8 @@ function AgentChat({
   onFileSelect,
   onMessagesChange,
   disabled,
-  onComposerError
+  onComposerError,
+  deepResearchEnabled = false
 }) {
   const [workspacePath, setWorkspacePath] = useState(null);
   const [mobileView, setMobileView] = useState("chat");
@@ -11262,7 +11392,8 @@ function AgentChat({
   const browserVisible = browserAvailable && showBrowser;
   const workspaceAvailable = !!sessionId;
   const workspaceVisible = workspaceAvailable && showWorkspace;
-  const rightStackVisible = browserVisible || workspaceVisible;
+  const sourcesVisible = runtime.researchSources.length > 0;
+  const rightStackVisible = browserVisible || workspaceVisible || sourcesVisible;
   const bothPanesVisible = browserVisible && workspaceVisible;
   useEffect(() => {
     onMessagesChange?.(runtime.messages);
@@ -11377,7 +11508,8 @@ function AgentChat({
                     canShowBrowser: browserAvailable,
                     canShowWorkspace: workspaceAvailable,
                     viewMode: runtime.viewMode,
-                    onViewModeChange: runtime.setViewMode
+                    onViewModeChange: runtime.setViewMode,
+                    deepResearchEnabled
                   }
                 )
               }
@@ -11437,6 +11569,20 @@ function AgentChat({
                         }
                       )
                     }
+                  ),
+                  sourcesVisible && /* @__PURE__ */ jsx(
+                    "div",
+                    {
+                      "data-testid": "research-sources-panel-frame",
+                      className: cn(
+                        "min-h-0 w-full overflow-auto",
+                        // When other panes share the stack the sources
+                        // panel takes a fixed minimum so the source rows
+                        // stay readable; otherwise it fills the column.
+                        browserVisible || workspaceVisible ? "max-h-1/3 border-t border-line" : "h-full"
+                      ),
+                      children: /* @__PURE__ */ jsx(ResearchSourcesPanel, { sources: runtime.researchSources })
+                    }
                   )
                 ]
               }
@@ -12182,7 +12328,7 @@ function groupMissionTasksByBucket(tasks) {
 function deriveMissionWorkerActivityLabel(worker) {
   const kind = worker.latestEventKind;
   if (kind === "tool.call" && worker.latestEventSummary) {
-    return `tool: ${truncate3(worker.latestEventSummary, 80)}`;
+    return `tool: ${truncate4(worker.latestEventSummary, 80)}`;
   }
   if (kind === "llm.response") {
     return "thinking";
@@ -12191,11 +12337,11 @@ function deriveMissionWorkerActivityLabel(worker) {
     return "received tool result";
   }
   if (kind && worker.latestEventSummary) {
-    return `${kind}: ${truncate3(worker.latestEventSummary, 60)}`;
+    return `${kind}: ${truncate4(worker.latestEventSummary, 60)}`;
   }
   return worker.sessionStatus || "active";
 }
-function truncate3(s, max) {
+function truncate4(s, max) {
   if (s.length <= max) return s;
   return `${s.slice(0, max - 1)}\u2026`;
 }
@@ -13182,6 +13328,50 @@ function MissionsPanel({
     )) })
   ] });
 }
+var CITATION_RE = /\[(S\d+(?:\s*,\s*S\d+)*)\]/g;
+function splitCitations(text) {
+  if (!text) return [];
+  const segments = [];
+  let lastIndex = 0;
+  for (const match of text.matchAll(CITATION_RE)) {
+    const start = match.index ?? 0;
+    if (start > lastIndex) {
+      segments.push({ kind: "text", value: text.slice(lastIndex, start) });
+    }
+    for (const id of match[1].split(",")) {
+      segments.push({ kind: "cite", value: id.trim() });
+    }
+    lastIndex = start + match[0].length;
+  }
+  if (lastIndex < text.length) {
+    segments.push({ kind: "text", value: text.slice(lastIndex) });
+  }
+  return segments;
+}
+function CitationText({
+  text,
+  sources,
+  onCitationClick
+}) {
+  const byId = new Map(sources.map((s) => [s.sourceId, s]));
+  return /* @__PURE__ */ jsx(Fragment, { children: splitCitations(text).map((seg, i) => {
+    if (seg.kind === "text") {
+      return /* @__PURE__ */ jsx("span", { children: seg.value }, i);
+    }
+    const src = byId.get(seg.value);
+    return /* @__PURE__ */ jsx(
+      "button",
+      {
+        type: "button",
+        title: src ? `${src.title} \u2014 ${src.url}` : seg.value,
+        onClick: () => onCitationClick?.(seg.value),
+        className: "mx-0.5 inline-flex items-center rounded-sm bg-muted px-1 text-[10px] font-semibold text-primary hover:bg-primary/10",
+        children: seg.value
+      },
+      i
+    );
+  }) });
+}
 var DEFAULT_LIMIT2 = 50;
 var DEFAULT_POLL_INTERVAL_MS3 = 3e4;
 function fingerprint2(items) {
@@ -13855,6 +14045,6 @@ function SessionTreePanel({
   ] });
 }
 
-export { ACTIVE_MISSION_STATUSES, AgentChat, AgentChatAdapterProvider, InboxPanel, MessageResponse, MissionDashboard, MissionsPanel, ScheduledWorkPanel, SessionTreePanel, deriveMissionWorkerActivityLabel, groupMissionTasksByBucket, isTerminalMissionStatus, missionTaskBucket, useAgentChatAdapterContext, useAgentChatRuntime, useChatViewMode, useInboxUnreadCount };
+export { ACTIVE_MISSION_STATUSES, AgentChat, AgentChatAdapterProvider, CitationText, InboxPanel, MessageResponse, MissionDashboard, MissionsPanel, ResearchSourcesPanel, ScheduledWorkPanel, SessionTreePanel, deriveMissionWorkerActivityLabel, groupMissionTasksByBucket, isTerminalMissionStatus, missionTaskBucket, splitCitations, useAgentChatAdapterContext, useAgentChatRuntime, useChatViewMode, useInboxUnreadCount };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map