@mastra/playground-ui 68.0.0-alpha.2 → 68.0.0-alpha.3

package/dist/{span-payload-primitives-B3RdahsC.js.map → span-payload-primitives-CKKIAVPJ.js.map}

@@ -1 +1 @@
-{"version":3,"file":"span-payload-primitives-B3RdahsC.js","names":[],"sources":["../src/domains/traces/components/span-payload/span-payload-tool.tsx","../src/domains/traces/components/span-payload/span-payload-primitives.tsx"],"sourcesContent":["import { SpanPayloadJson } from './span-payload-json';\nimport { SpanPayloadField } from './span-payload-primitives';\nimport { getDelegatedTool, getDelegatedToolHref } from './span-payload-registry';\nimport { BadgeWrapper } from '@/domains/chat/components/badge-wrapper';\nimport { ActivityHeadline } from '@/ds/components/ai/activity';\nimport { presentTool } from '@/ds/components/ai/tool-call/tool-presentation';\nimport { DataKeysAndValues } from '@/ds/components/DataKeysAndValues';\nimport { useLinkComponent } from '@/lib/framework';\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\n/** A tool name in a key/value list, linked to its page when the tool is a workflow or sub-agent. */\nexport function SpanToolNameValue({ toolName }: { toolName: string }) {\n  const { Link, paths } = useLinkComponent();\n  const href = getDelegatedToolHref(paths, toolName);\n  if (!href) return <DataKeysAndValues.Value>{toolName}</DataKeysAndValues.Value>;\n  return (\n    <DataKeysAndValues.ValueLink href={href} as={Link}>\n      {toolName}\n    </DataKeysAndValues.ValueLink>\n  );\n}\n\nexport function SpanPayloadTool({ value }: { value: unknown }) {\n  const { Link, paths } = useLinkComponent();\n  if (!isRecord(value)) return <SpanPayloadJson value={value} />;\n  const call = value.type === 'tool-invocation' ? value.toolInvocation : value;\n  if (!isRecord(call) || typeof call.toolName !== 'string' || !call.toolName) {\n    return <SpanPayloadJson value={value} />;\n  }\n  const input = 'args' in call ? call.args : call.input;\n  const output = 'result' in call ? call.result : call.output;\n  const error = call.isError === true || call.state === 'output-error';\n  const errorText = typeof call.errorText === 'string' ? call.errorText : undefined;\n  const { icon: ToolIcon, label, detail, description } = presentTool(call.toolName, input);\n  const delegated = getDelegatedTool(call.toolName);\n  // The header toggles the body, so the workflow or agent link sits in the body rather than in it.\n  const delegatedHref = getDelegatedToolHref(paths, call.toolName);\n  const hasBody = Boolean(delegatedHref) || input !== undefined || output !== undefined || errorText !== undefined;\n  return (\n    <div data-slot=\"span-payload-tool\" className=\"flex flex-col gap-2\">\n      <BadgeWrapper\n        status={error ? 'error' : 'idle'}\n        header={\n          <ActivityHeadline icon={<ToolIcon aria-hidden />} label={label} detail={detail} description={description} />\n        }\n      >\n        {hasBody && (\n          <div className=\"flex flex-col gap-3\">\n            {delegated && delegatedHref && (\n              <DataKeysAndValues>\n                <DataKeysAndValues.Key>{delegated.kind === 'workflow' ? 'Workflow' : 'Agent'}</DataKeysAndValues.Key>\n                <DataKeysAndValues.ValueLink href={delegatedHref} as={Link}>\n                  {delegated.key}\n                </DataKeysAndValues.ValueLink>\n              </DataKeysAndValues>\n            )}\n            {input !== undefined && (\n              <SpanPayloadField label=\"Arguments\">\n                <SpanPayloadJson value={input} />\n              </SpanPayloadField>\n            )}\n            {output !== undefined && (\n              <SpanPayloadField label=\"Result\">\n                <SpanPayloadJson value={output} />\n              </SpanPayloadField>\n            )}\n            {errorText !== undefined && (\n              <SpanPayloadField label=\"Error\">\n                <SpanPayloadJson value={errorText} />\n              </SpanPayloadField>\n            )}\n          </div>\n        )}\n      </BadgeWrapper>\n    </div>\n  );\n}\n","import type { ReactNode } from 'react';\nimport { SpanPayloadTool } from './span-payload-tool';\nimport { Collapsible, CollapsibleContent, CollapsibleTrigger } from '@/ds/components/Collapsible';\nimport { DisclosureChevron } from '@/ds/components/DisclosureChevron';\nimport { MarkdownRenderer } from '@/ds/components/MarkdownRenderer';\nimport { ScrollArea } from '@/ds/components/ScrollArea';\nimport { Txt } from '@/ds/components/Txt';\nimport { raisedSurfaceStyle } from '@/ds/primitives/raised-surface';\nimport { cn } from '@/lib/utils';\n\n/** Small-caps label above a field of a rich payload. */\nexport function SpanPayloadLabel({ children }: { children: ReactNode }) {\n  return (\n    <Txt as=\"span\" variant=\"meta\" tone=\"faint\" className=\"block uppercase\">\n      {children}\n    </Txt>\n  );\n}\n\nexport function SpanPayloadField({ label, children }: { label: ReactNode; children: ReactNode }) {\n  return (\n    <div data-slot=\"span-payload-field\" className=\"flex flex-col gap-1.5\">\n      <SpanPayloadLabel>{label}</SpanPayloadLabel>\n      {children}\n    </div>\n  );\n}\n\nexport function SpanPayloadMarkdown({ children }: { children: string }) {\n  return (\n    <div data-slot=\"span-payload-markdown\" className=\"text-foreground\">\n      <MarkdownRenderer>{children}</MarkdownRenderer>\n    </div>\n  );\n}\n\n/** A collapsed block for secondary data (reasoning, steps, warnings…). */\nexport function SpanPayloadCollapsible({\n  label,\n  children,\n  defaultOpen = false,\n}: {\n  label: ReactNode;\n  children: ReactNode;\n  defaultOpen?: boolean;\n}) {\n  return (\n    <Collapsible defaultOpen={defaultOpen}>\n      <CollapsibleTrigger className=\"flex items-center gap-1 text-meta text-placeholder uppercase\">\n        <DisclosureChevron direction=\"right\" className=\"size-3\" />\n        {label}\n      </CollapsibleTrigger>\n      <CollapsibleContent className=\"pt-1.5\">{children}</CollapsibleContent>\n    </Collapsible>\n  );\n}\n\nexport interface SpanPayloadListItem {\n  key: string;\n  /** The item name, a link when it has a page to open. */\n  name: ReactNode;\n  description?: string;\n}\n\n/**\n * A scrollable list of named items with an optional description (tools, skills…). The scrollbar\n * stays visible while the list overflows, so readers can tell there are more items below.\n * `card` frames it on its own surface, for a list that stands alone in a section.\n */\nexport function SpanPayloadList({ items, slot, card }: { items: SpanPayloadListItem[]; slot: string; card?: boolean }) {\n  return (\n    <ScrollArea\n      maxHeight=\"12rem\"\n      alwaysShowScrollbar\n      className={cn(card && cn(raisedSurfaceStyle, 'rounded-lg [--scroll-area-scrollbar-inset:0.5rem]'))}\n    >\n      <ul data-slot={slot} className={cn('flex flex-col gap-2', card ? 'p-3 pr-4' : 'pr-3')}>\n        {items.map(item => (\n          <li key={item.key} className=\"flex min-w-0 flex-col\">\n            {item.name}\n            {item.description && (\n              // Payload content reads in ink like the messages around it; grey is kept for the labels.\n              <Txt as=\"span\" variant=\"body-sm\" className=\"line-clamp-2\" title={item.description}>\n                {item.description}\n              </Txt>\n            )}\n          </li>\n        ))}\n      </ul>\n    </ScrollArea>\n  );\n}\n\n/** A list item name rendered as plain text. */\nexport function SpanPayloadListName({ children }: { children: string }) {\n  return (\n    <Txt as=\"span\" variant=\"label\" tone=\"ink\" className=\"truncate\">\n      {children}\n    </Txt>\n  );\n}\n\n/** Tool calls as core records them: `{ toolName, args | input }` when they have that shape, JSON otherwise. */\nexport function SpanPayloadToolCalls({ toolCalls }: { toolCalls: unknown[] }) {\n  return (\n    <ul data-slot=\"span-payload-tool-calls\" className=\"flex flex-col gap-2\">\n      {toolCalls.map((call, index) => (\n        <li key={index}>\n          <SpanPayloadTool value={call} />\n        </li>\n      ))}\n    </ul>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"span-payload-primitives-CKKIAVPJ.js","names":[],"sources":["../src/domains/traces/components/span-payload/span-payload-tool.tsx","../src/domains/traces/components/span-payload/span-payload-primitives.tsx"],"sourcesContent":["import { SpanPayloadJson } from './span-payload-json';\nimport { SpanPayloadField } from './span-payload-primitives';\nimport { getDelegatedTool, getDelegatedToolHref } from './span-payload-registry';\nimport { BadgeWrapper } from '@/domains/chat/components/badge-wrapper';\nimport { ActivityHeadline } from '@/ds/components/ai/activity';\nimport { presentTool } from '@/ds/components/ai/tool-call/tool-presentation';\nimport { DataKeysAndValues } from '@/ds/components/DataKeysAndValues';\nimport { useLinkComponent } from '@/lib/framework';\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\n/** A tool name in a key/value list, linked to its page when the tool is a workflow or sub-agent. */\nexport function SpanToolNameValue({ toolName }: { toolName: string }) {\n  const { Link, paths } = useLinkComponent();\n  const href = getDelegatedToolHref(paths, toolName);\n  if (!href) return <DataKeysAndValues.Value>{toolName}</DataKeysAndValues.Value>;\n  return (\n    <DataKeysAndValues.ValueLink href={href} as={Link}>\n      {toolName}\n    </DataKeysAndValues.ValueLink>\n  );\n}\n\nexport function SpanPayloadTool({ value }: { value: unknown }) {\n  const { Link, paths } = useLinkComponent();\n  if (!isRecord(value)) return <SpanPayloadJson value={value} />;\n  const call = value.type === 'tool-invocation' ? value.toolInvocation : value;\n  if (!isRecord(call) || typeof call.toolName !== 'string' || !call.toolName) {\n    return <SpanPayloadJson value={value} />;\n  }\n  const input = 'args' in call ? call.args : call.input;\n  const output = 'result' in call ? call.result : call.output;\n  const error = call.isError === true || call.state === 'output-error';\n  const errorText = typeof call.errorText === 'string' ? call.errorText : undefined;\n  const { icon: ToolIcon, label, detail, description } = presentTool(call.toolName, input);\n  const delegated = getDelegatedTool(call.toolName);\n  // The header toggles the body, so the workflow or agent link sits in the body rather than in it.\n  const delegatedHref = getDelegatedToolHref(paths, call.toolName);\n  const hasBody = Boolean(delegatedHref) || input !== undefined || output !== undefined || errorText !== undefined;\n  return (\n    <div data-slot=\"span-payload-tool\" className=\"flex flex-col gap-2\">\n      <BadgeWrapper\n        status={error ? 'error' : 'idle'}\n        header={\n          <ActivityHeadline icon={<ToolIcon aria-hidden />} label={label} detail={detail} description={description} />\n        }\n      >\n        {hasBody && (\n          <div className=\"flex flex-col gap-3\">\n            {delegated && delegatedHref && (\n              <DataKeysAndValues>\n                <DataKeysAndValues.Key>{delegated.kind === 'workflow' ? 'Workflow' : 'Agent'}</DataKeysAndValues.Key>\n                <DataKeysAndValues.ValueLink href={delegatedHref} as={Link}>\n                  {delegated.key}\n                </DataKeysAndValues.ValueLink>\n              </DataKeysAndValues>\n            )}\n            {input !== undefined && (\n              <SpanPayloadField label=\"Arguments\">\n                <SpanPayloadJson value={input} />\n              </SpanPayloadField>\n            )}\n            {output !== undefined && (\n              <SpanPayloadField label=\"Result\">\n                <SpanPayloadJson value={output} />\n              </SpanPayloadField>\n            )}\n            {errorText !== undefined && (\n              <SpanPayloadField label=\"Error\">\n                <SpanPayloadJson value={errorText} />\n              </SpanPayloadField>\n            )}\n          </div>\n        )}\n      </BadgeWrapper>\n    </div>\n  );\n}\n","import type { ReactNode } from 'react';\nimport { SpanPayloadTool } from './span-payload-tool';\nimport { Collapsible, CollapsibleContent, CollapsibleTrigger } from '@/ds/components/Collapsible';\nimport { DisclosureChevron } from '@/ds/components/DisclosureChevron';\nimport { MarkdownRenderer } from '@/ds/components/MarkdownRenderer';\nimport { ScrollArea } from '@/ds/components/ScrollArea';\nimport { Txt } from '@/ds/components/Txt';\nimport { raisedSurfaceStyle } from '@/ds/primitives/raised-surface';\nimport { cn } from '@/lib/utils';\n\n/** Small-caps label above a field of a rich payload. */\nexport function SpanPayloadLabel({ children }: { children: ReactNode }) {\n  return (\n    <Txt as=\"span\" variant=\"meta\" tone=\"faint\" className=\"block uppercase\">\n      {children}\n    </Txt>\n  );\n}\n\nexport function SpanPayloadField({ label, children }: { label: ReactNode; children: ReactNode }) {\n  return (\n    <div data-slot=\"span-payload-field\" className=\"flex flex-col gap-1.5\">\n      <SpanPayloadLabel>{label}</SpanPayloadLabel>\n      {children}\n    </div>\n  );\n}\n\nexport function SpanPayloadMarkdown({ children }: { children: string }) {\n  return (\n    <div data-slot=\"span-payload-markdown\" className=\"text-foreground\">\n      <MarkdownRenderer>{children}</MarkdownRenderer>\n    </div>\n  );\n}\n\n/** A collapsed block for secondary data (reasoning, steps, warnings…). */\nexport function SpanPayloadCollapsible({\n  label,\n  children,\n  defaultOpen = false,\n}: {\n  label: ReactNode;\n  children: ReactNode;\n  defaultOpen?: boolean;\n}) {\n  return (\n    <Collapsible defaultOpen={defaultOpen}>\n      <CollapsibleTrigger className=\"flex items-center gap-1 text-meta text-placeholder uppercase\">\n        <DisclosureChevron direction=\"right\" className=\"size-3\" />\n        {label}\n      </CollapsibleTrigger>\n      <CollapsibleContent className=\"pt-1.5\">{children}</CollapsibleContent>\n    </Collapsible>\n  );\n}\n\nexport interface SpanPayloadListItem {\n  key: string;\n  /** The item name, a link when it has a page to open. */\n  name: ReactNode;\n  description?: string;\n}\n\n/**\n * A scrollable list of named items with an optional description (tools, skills…). The scrollbar\n * stays visible while the list overflows, so readers can tell there are more items below.\n * `card` frames it on its own surface, for a list that stands alone in a section.\n */\nexport function SpanPayloadList({ items, slot, card }: { items: SpanPayloadListItem[]; slot: string; card?: boolean }) {\n  return (\n    <ScrollArea\n      maxHeight=\"12rem\"\n      alwaysShowScrollbar\n      className={cn(card && cn(raisedSurfaceStyle, 'rounded-lg [--scroll-area-scrollbar-inset:0.5rem]'))}\n    >\n      <ul data-slot={slot} className={cn('flex flex-col gap-2', card ? 'p-3 pr-4' : 'pr-3')}>\n        {items.map(item => (\n          <li key={item.key} className=\"flex min-w-0 flex-col\">\n            {item.name}\n            {item.description && (\n              // Payload content reads in ink like the messages around it; grey is kept for the labels.\n              <Txt as=\"span\" variant=\"body-sm\" className=\"line-clamp-2\" title={item.description}>\n                {item.description}\n              </Txt>\n            )}\n          </li>\n        ))}\n      </ul>\n    </ScrollArea>\n  );\n}\n\n/** A list item name rendered as plain text. */\nexport function SpanPayloadListName({ children }: { children: string }) {\n  return (\n    <Txt as=\"span\" variant=\"label\" tone=\"ink\" className=\"truncate\">\n      {children}\n    </Txt>\n  );\n}\n\n/** Tool calls as core records them: `{ toolName, args | input }` when they have that shape, JSON otherwise. */\nexport function SpanPayloadToolCalls({ toolCalls }: { toolCalls: unknown[] }) {\n  return (\n    <ul data-slot=\"span-payload-tool-calls\" className=\"flex flex-col gap-2\">\n      {toolCalls.map((call, index) => (\n        <li key={index}>\n          <SpanPayloadTool value={call} />\n        </li>\n      ))}\n    </ul>\n  );\n}\n"],"mappings":"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"}

package/dist/{span-payload-primitives-_2d-pAOD.cjs → span-payload-primitives-D4tHWN2W.cjs}

@@ -3,11 +3,11 @@ const require_utils = require("./utils-uDc1ofX1.cjs");
 require("./primitives/raised-surface.cjs.js");
 const require_scroll_area = require("./scroll-area-BP4gPZ4G.cjs");
 const require_Txt = require("./Txt-BnoSqxKE.cjs");
-const require_tool_presentation = require("./tool-presentation-CQlDEwgS.cjs");
-const require_activity = require("./activity-DyB5H3gF.cjs");
+const require_tool_presentation = require("./tool-presentation-D6nzVruN.cjs");
+const require_activity = require("./activity-CcQZeDYi.cjs");
 const require_components_Collapsible = require("./components/Collapsible.cjs.js");
 const require_components_DisclosureChevron = require("./components/DisclosureChevron.cjs.js");
-const require_MarkdownRenderer = require("./MarkdownRenderer-CB8Z_CHc.cjs");
+const require_MarkdownRenderer = require("./MarkdownRenderer-y65WGBhC.cjs");
 const require_domains_chat_components_badge_wrapper = require("./domains/chat/components/badge-wrapper.cjs.js");
 const require_DataKeysAndValues = require("./DataKeysAndValues-DsH6AbAo.cjs");
 const require_domains_traces_components_span_payload_span_payload_registry = require("./domains/traces/components/span-payload/span-payload-registry.cjs.js");
@@ -214,4 +214,4 @@ Object.defineProperty(exports, "SpanToolNameValue", {
 	}
 });
 
-//# sourceMappingURL=span-payload-primitives-_2d-pAOD.cjs.map
+//# sourceMappingURL=span-payload-primitives-D4tHWN2W.cjs.map

package/dist/{span-payload-primitives-_2d-pAOD.cjs.map → span-payload-primitives-D4tHWN2W.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"span-payload-primitives-_2d-pAOD.cjs","names":["useLinkComponent","getDelegatedToolHref","DataKeysAndValues","SpanPayloadJson","presentTool","getDelegatedTool","BadgeWrapper","ActivityHeadline","Txt","MarkdownRenderer","Collapsible","CollapsibleTrigger","DisclosureChevron","CollapsibleContent","ScrollArea","cn"],"sources":["../src/domains/traces/components/span-payload/span-payload-tool.tsx","../src/domains/traces/components/span-payload/span-payload-primitives.tsx"],"sourcesContent":["import { SpanPayloadJson } from './span-payload-json';\nimport { SpanPayloadField } from './span-payload-primitives';\nimport { getDelegatedTool, getDelegatedToolHref } from './span-payload-registry';\nimport { BadgeWrapper } from '@/domains/chat/components/badge-wrapper';\nimport { ActivityHeadline } from '@/ds/components/ai/activity';\nimport { presentTool } from '@/ds/components/ai/tool-call/tool-presentation';\nimport { DataKeysAndValues } from '@/ds/components/DataKeysAndValues';\nimport { useLinkComponent } from '@/lib/framework';\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\n/** A tool name in a key/value list, linked to its page when the tool is a workflow or sub-agent. */\nexport function SpanToolNameValue({ toolName }: { toolName: string }) {\n  const { Link, paths } = useLinkComponent();\n  const href = getDelegatedToolHref(paths, toolName);\n  if (!href) return <DataKeysAndValues.Value>{toolName}</DataKeysAndValues.Value>;\n  return (\n    <DataKeysAndValues.ValueLink href={href} as={Link}>\n      {toolName}\n    </DataKeysAndValues.ValueLink>\n  );\n}\n\nexport function SpanPayloadTool({ value }: { value: unknown }) {\n  const { Link, paths } = useLinkComponent();\n  if (!isRecord(value)) return <SpanPayloadJson value={value} />;\n  const call = value.type === 'tool-invocation' ? value.toolInvocation : value;\n  if (!isRecord(call) || typeof call.toolName !== 'string' || !call.toolName) {\n    return <SpanPayloadJson value={value} />;\n  }\n  const input = 'args' in call ? call.args : call.input;\n  const output = 'result' in call ? call.result : call.output;\n  const error = call.isError === true || call.state === 'output-error';\n  const errorText = typeof call.errorText === 'string' ? call.errorText : undefined;\n  const { icon: ToolIcon, label, detail, description } = presentTool(call.toolName, input);\n  const delegated = getDelegatedTool(call.toolName);\n  // The header toggles the body, so the workflow or agent link sits in the body rather than in it.\n  const delegatedHref = getDelegatedToolHref(paths, call.toolName);\n  const hasBody = Boolean(delegatedHref) || input !== undefined || output !== undefined || errorText !== undefined;\n  return (\n    <div data-slot=\"span-payload-tool\" className=\"flex flex-col gap-2\">\n      <BadgeWrapper\n        status={error ? 'error' : 'idle'}\n        header={\n          <ActivityHeadline icon={<ToolIcon aria-hidden />} label={label} detail={detail} description={description} />\n        }\n      >\n        {hasBody && (\n          <div className=\"flex flex-col gap-3\">\n            {delegated && delegatedHref && (\n              <DataKeysAndValues>\n                <DataKeysAndValues.Key>{delegated.kind === 'workflow' ? 'Workflow' : 'Agent'}</DataKeysAndValues.Key>\n                <DataKeysAndValues.ValueLink href={delegatedHref} as={Link}>\n                  {delegated.key}\n                </DataKeysAndValues.ValueLink>\n              </DataKeysAndValues>\n            )}\n            {input !== undefined && (\n              <SpanPayloadField label=\"Arguments\">\n                <SpanPayloadJson value={input} />\n              </SpanPayloadField>\n            )}\n            {output !== undefined && (\n              <SpanPayloadField label=\"Result\">\n                <SpanPayloadJson value={output} />\n              </SpanPayloadField>\n            )}\n            {errorText !== undefined && (\n              <SpanPayloadField label=\"Error\">\n                <SpanPayloadJson value={errorText} />\n              </SpanPayloadField>\n            )}\n          </div>\n        )}\n      </BadgeWrapper>\n    </div>\n  );\n}\n","import type { ReactNode } from 'react';\nimport { SpanPayloadTool } from './span-payload-tool';\nimport { Collapsible, CollapsibleContent, CollapsibleTrigger } from '@/ds/components/Collapsible';\nimport { DisclosureChevron } from '@/ds/components/DisclosureChevron';\nimport { MarkdownRenderer } from '@/ds/components/MarkdownRenderer';\nimport { ScrollArea } from '@/ds/components/ScrollArea';\nimport { Txt } from '@/ds/components/Txt';\nimport { raisedSurfaceStyle } from '@/ds/primitives/raised-surface';\nimport { cn } from '@/lib/utils';\n\n/** Small-caps label above a field of a rich payload. */\nexport function SpanPayloadLabel({ children }: { children: ReactNode }) {\n  return (\n    <Txt as=\"span\" variant=\"meta\" tone=\"faint\" className=\"block uppercase\">\n      {children}\n    </Txt>\n  );\n}\n\nexport function SpanPayloadField({ label, children }: { label: ReactNode; children: ReactNode }) {\n  return (\n    <div data-slot=\"span-payload-field\" className=\"flex flex-col gap-1.5\">\n      <SpanPayloadLabel>{label}</SpanPayloadLabel>\n      {children}\n    </div>\n  );\n}\n\nexport function SpanPayloadMarkdown({ children }: { children: string }) {\n  return (\n    <div data-slot=\"span-payload-markdown\" className=\"text-foreground\">\n      <MarkdownRenderer>{children}</MarkdownRenderer>\n    </div>\n  );\n}\n\n/** A collapsed block for secondary data (reasoning, steps, warnings…). */\nexport function SpanPayloadCollapsible({\n  label,\n  children,\n  defaultOpen = false,\n}: {\n  label: ReactNode;\n  children: ReactNode;\n  defaultOpen?: boolean;\n}) {\n  return (\n    <Collapsible defaultOpen={defaultOpen}>\n      <CollapsibleTrigger className=\"flex items-center gap-1 text-meta text-placeholder uppercase\">\n        <DisclosureChevron direction=\"right\" className=\"size-3\" />\n        {label}\n      </CollapsibleTrigger>\n      <CollapsibleContent className=\"pt-1.5\">{children}</CollapsibleContent>\n    </Collapsible>\n  );\n}\n\nexport interface SpanPayloadListItem {\n  key: string;\n  /** The item name, a link when it has a page to open. */\n  name: ReactNode;\n  description?: string;\n}\n\n/**\n * A scrollable list of named items with an optional description (tools, skills…). The scrollbar\n * stays visible while the list overflows, so readers can tell there are more items below.\n * `card` frames it on its own surface, for a list that stands alone in a section.\n */\nexport function SpanPayloadList({ items, slot, card }: { items: SpanPayloadListItem[]; slot: string; card?: boolean }) {\n  return (\n    <ScrollArea\n      maxHeight=\"12rem\"\n      alwaysShowScrollbar\n      className={cn(card && cn(raisedSurfaceStyle, 'rounded-lg [--scroll-area-scrollbar-inset:0.5rem]'))}\n    >\n      <ul data-slot={slot} className={cn('flex flex-col gap-2', card ? 'p-3 pr-4' : 'pr-3')}>\n        {items.map(item => (\n          <li key={item.key} className=\"flex min-w-0 flex-col\">\n            {item.name}\n            {item.description && (\n              // Payload content reads in ink like the messages around it; grey is kept for the labels.\n              <Txt as=\"span\" variant=\"body-sm\" className=\"line-clamp-2\" title={item.description}>\n                {item.description}\n              </Txt>\n            )}\n          </li>\n        ))}\n      </ul>\n    </ScrollArea>\n  );\n}\n\n/** A list item name rendered as plain text. */\nexport function SpanPayloadListName({ children }: { children: string }) {\n  return (\n    <Txt as=\"span\" variant=\"label\" tone=\"ink\" className=\"truncate\">\n      {children}\n    </Txt>\n  );\n}\n\n/** Tool calls as core records them: `{ toolName, args | input }` when they have that shape, JSON otherwise. */\nexport function SpanPayloadToolCalls({ toolCalls }: { toolCalls: unknown[] }) {\n  return (\n    <ul data-slot=\"span-payload-tool-calls\" className=\"flex flex-col gap-2\">\n      {toolCalls.map((call, index) => (\n        <li key={index}>\n          <SpanPayloadTool value={call} />\n        </li>\n      ))}\n    </ul>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"span-payload-primitives-D4tHWN2W.cjs","names":["useLinkComponent","getDelegatedToolHref","DataKeysAndValues","SpanPayloadJson","presentTool","getDelegatedTool","BadgeWrapper","ActivityHeadline","Txt","MarkdownRenderer","Collapsible","CollapsibleTrigger","DisclosureChevron","CollapsibleContent","ScrollArea","cn"],"sources":["../src/domains/traces/components/span-payload/span-payload-tool.tsx","../src/domains/traces/components/span-payload/span-payload-primitives.tsx"],"sourcesContent":["import { SpanPayloadJson } from './span-payload-json';\nimport { SpanPayloadField } from './span-payload-primitives';\nimport { getDelegatedTool, getDelegatedToolHref } from './span-payload-registry';\nimport { BadgeWrapper } from '@/domains/chat/components/badge-wrapper';\nimport { ActivityHeadline } from '@/ds/components/ai/activity';\nimport { presentTool } from '@/ds/components/ai/tool-call/tool-presentation';\nimport { DataKeysAndValues } from '@/ds/components/DataKeysAndValues';\nimport { useLinkComponent } from '@/lib/framework';\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\n/** A tool name in a key/value list, linked to its page when the tool is a workflow or sub-agent. */\nexport function SpanToolNameValue({ toolName }: { toolName: string }) {\n  const { Link, paths } = useLinkComponent();\n  const href = getDelegatedToolHref(paths, toolName);\n  if (!href) return <DataKeysAndValues.Value>{toolName}</DataKeysAndValues.Value>;\n  return (\n    <DataKeysAndValues.ValueLink href={href} as={Link}>\n      {toolName}\n    </DataKeysAndValues.ValueLink>\n  );\n}\n\nexport function SpanPayloadTool({ value }: { value: unknown }) {\n  const { Link, paths } = useLinkComponent();\n  if (!isRecord(value)) return <SpanPayloadJson value={value} />;\n  const call = value.type === 'tool-invocation' ? value.toolInvocation : value;\n  if (!isRecord(call) || typeof call.toolName !== 'string' || !call.toolName) {\n    return <SpanPayloadJson value={value} />;\n  }\n  const input = 'args' in call ? call.args : call.input;\n  const output = 'result' in call ? call.result : call.output;\n  const error = call.isError === true || call.state === 'output-error';\n  const errorText = typeof call.errorText === 'string' ? call.errorText : undefined;\n  const { icon: ToolIcon, label, detail, description } = presentTool(call.toolName, input);\n  const delegated = getDelegatedTool(call.toolName);\n  // The header toggles the body, so the workflow or agent link sits in the body rather than in it.\n  const delegatedHref = getDelegatedToolHref(paths, call.toolName);\n  const hasBody = Boolean(delegatedHref) || input !== undefined || output !== undefined || errorText !== undefined;\n  return (\n    <div data-slot=\"span-payload-tool\" className=\"flex flex-col gap-2\">\n      <BadgeWrapper\n        status={error ? 'error' : 'idle'}\n        header={\n          <ActivityHeadline icon={<ToolIcon aria-hidden />} label={label} detail={detail} description={description} />\n        }\n      >\n        {hasBody && (\n          <div className=\"flex flex-col gap-3\">\n            {delegated && delegatedHref && (\n              <DataKeysAndValues>\n                <DataKeysAndValues.Key>{delegated.kind === 'workflow' ? 'Workflow' : 'Agent'}</DataKeysAndValues.Key>\n                <DataKeysAndValues.ValueLink href={delegatedHref} as={Link}>\n                  {delegated.key}\n                </DataKeysAndValues.ValueLink>\n              </DataKeysAndValues>\n            )}\n            {input !== undefined && (\n              <SpanPayloadField label=\"Arguments\">\n                <SpanPayloadJson value={input} />\n              </SpanPayloadField>\n            )}\n            {output !== undefined && (\n              <SpanPayloadField label=\"Result\">\n                <SpanPayloadJson value={output} />\n              </SpanPayloadField>\n            )}\n            {errorText !== undefined && (\n              <SpanPayloadField label=\"Error\">\n                <SpanPayloadJson value={errorText} />\n              </SpanPayloadField>\n            )}\n          </div>\n        )}\n      </BadgeWrapper>\n    </div>\n  );\n}\n","import type { ReactNode } from 'react';\nimport { SpanPayloadTool } from './span-payload-tool';\nimport { Collapsible, CollapsibleContent, CollapsibleTrigger } from '@/ds/components/Collapsible';\nimport { DisclosureChevron } from '@/ds/components/DisclosureChevron';\nimport { MarkdownRenderer } from '@/ds/components/MarkdownRenderer';\nimport { ScrollArea } from '@/ds/components/ScrollArea';\nimport { Txt } from '@/ds/components/Txt';\nimport { raisedSurfaceStyle } from '@/ds/primitives/raised-surface';\nimport { cn } from '@/lib/utils';\n\n/** Small-caps label above a field of a rich payload. */\nexport function SpanPayloadLabel({ children }: { children: ReactNode }) {\n  return (\n    <Txt as=\"span\" variant=\"meta\" tone=\"faint\" className=\"block uppercase\">\n      {children}\n    </Txt>\n  );\n}\n\nexport function SpanPayloadField({ label, children }: { label: ReactNode; children: ReactNode }) {\n  return (\n    <div data-slot=\"span-payload-field\" className=\"flex flex-col gap-1.5\">\n      <SpanPayloadLabel>{label}</SpanPayloadLabel>\n      {children}\n    </div>\n  );\n}\n\nexport function SpanPayloadMarkdown({ children }: { children: string }) {\n  return (\n    <div data-slot=\"span-payload-markdown\" className=\"text-foreground\">\n      <MarkdownRenderer>{children}</MarkdownRenderer>\n    </div>\n  );\n}\n\n/** A collapsed block for secondary data (reasoning, steps, warnings…). */\nexport function SpanPayloadCollapsible({\n  label,\n  children,\n  defaultOpen = false,\n}: {\n  label: ReactNode;\n  children: ReactNode;\n  defaultOpen?: boolean;\n}) {\n  return (\n    <Collapsible defaultOpen={defaultOpen}>\n      <CollapsibleTrigger className=\"flex items-center gap-1 text-meta text-placeholder uppercase\">\n        <DisclosureChevron direction=\"right\" className=\"size-3\" />\n        {label}\n      </CollapsibleTrigger>\n      <CollapsibleContent className=\"pt-1.5\">{children}</CollapsibleContent>\n    </Collapsible>\n  );\n}\n\nexport interface SpanPayloadListItem {\n  key: string;\n  /** The item name, a link when it has a page to open. */\n  name: ReactNode;\n  description?: string;\n}\n\n/**\n * A scrollable list of named items with an optional description (tools, skills…). The scrollbar\n * stays visible while the list overflows, so readers can tell there are more items below.\n * `card` frames it on its own surface, for a list that stands alone in a section.\n */\nexport function SpanPayloadList({ items, slot, card }: { items: SpanPayloadListItem[]; slot: string; card?: boolean }) {\n  return (\n    <ScrollArea\n      maxHeight=\"12rem\"\n      alwaysShowScrollbar\n      className={cn(card && cn(raisedSurfaceStyle, 'rounded-lg [--scroll-area-scrollbar-inset:0.5rem]'))}\n    >\n      <ul data-slot={slot} className={cn('flex flex-col gap-2', card ? 'p-3 pr-4' : 'pr-3')}>\n        {items.map(item => (\n          <li key={item.key} className=\"flex min-w-0 flex-col\">\n            {item.name}\n            {item.description && (\n              // Payload content reads in ink like the messages around it; grey is kept for the labels.\n              <Txt as=\"span\" variant=\"body-sm\" className=\"line-clamp-2\" title={item.description}>\n                {item.description}\n              </Txt>\n            )}\n          </li>\n        ))}\n      </ul>\n    </ScrollArea>\n  );\n}\n\n/** A list item name rendered as plain text. */\nexport function SpanPayloadListName({ children }: { children: string }) {\n  return (\n    <Txt as=\"span\" variant=\"label\" tone=\"ink\" className=\"truncate\">\n      {children}\n    </Txt>\n  );\n}\n\n/** Tool calls as core records them: `{ toolName, args | input }` when they have that shape, JSON otherwise. */\nexport function SpanPayloadToolCalls({ toolCalls }: { toolCalls: unknown[] }) {\n  return (\n    <ul data-slot=\"span-payload-tool-calls\" className=\"flex flex-col gap-2\">\n      {toolCalls.map((call, index) => (\n        <li key={index}>\n          <SpanPayloadTool value={call} />\n        </li>\n      ))}\n    </ul>\n  );\n}\n"],"mappings":"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"}

package/dist/src/domains/chat/knowledge/knowledge-links.d.ts

@@ -1,21 +1,49 @@
 import type { ReactNode } from 'react';
+import type { KnowledgePageCardProps } from '../../knowledge/components/KnowledgePageCard';
 import type { LinkComponent } from '../../../lib/framework';
+/** Names the page a link points at: by id, or by reference the way `refHref` takes it. */
+export type KnowledgePageTarget = {
+    pageId: string;
+    pageRef?: never;
+} | {
+    pageRef: string;
+    pageId?: never;
+};
+/**
+ * What a hover card says about a page. Called, as a hook, only while a card is open, so a host fetches
+ * the page on hover and not for every link in the transcript. (Chat prose is the exception: a bare address
+ * in text calls it on render, since it links only if the page resolves.) `undefined` while loading or unreadable.
+ */
+export type UseKnowledgePagePreview = (target: KnowledgePageTarget) => KnowledgePageCardProps | undefined;
 interface KnowledgeLinks {
+    /** Left out where the host cannot look a page up; links then have no hover card. */
+    usePagePreview?: UseKnowledgePagePreview;
     /** Undefined when this host has no page to open, e.g. a chat outside any project; the name shows as text. */
     pageHref: (pageId: string) => string | undefined;
+    /**
+     * Where a page named by reference (a scope address, or `scope#key/path` as `knowledge_list` names
+     * entries) opens. Studio's Knowledge page resolves the reference itself, so it uses the page URL. A
+     * host that only opens pages by id leaves it out, and those names show as text.
+     */
+    refHref?: (ref: string) => string | undefined;
     Link?: LinkComponent;
+    /** Set by the provider: this host has Knowledge pages, so references in chat prose become links. */
+    provided?: boolean;
 }
 /**
  * Where Knowledge page links in chat (tool cards, pinned Knowledge) point. Studio's default opens its own
  * Knowledge page; a host with its own route (Factory's per-project page) or its own router passes both.
  */
-export declare function KnowledgeLinksProvider({ pageHref, Link, children }: KnowledgeLinks & {
+export declare function KnowledgeLinksProvider({ pageHref, refHref, Link, usePagePreview, children, }: Omit<KnowledgeLinks, 'provided'> & {
     children: ReactNode;
 }): import("react").JSX.Element;
+/** What the host gave the provider; for renderers that must decide before drawing a link. */
+export declare function useKnowledgeLinksContext(): KnowledgeLinks;
+/** Whether this host mounted a `KnowledgeLinksProvider`, i.e. has Knowledge pages chat prose can link to. */
+export declare function useHasKnowledgeLinks(): boolean;
 /** A link to a Knowledge page, through the host's link component and route. */
-export declare function KnowledgePageLink({ pageId, children, className, }: {
-    pageId: string;
+export declare function KnowledgePageLink({ pageId, pageRef, children, className, }: {
     children: ReactNode;
     className?: string;
-}): import("react").JSX.Element;
+} & KnowledgePageTarget): import("react").JSX.Element;
 export {};

package/dist/src/domains/chat/knowledge/pinned-knowledge-data.d.ts

@@ -6,6 +6,8 @@ export interface PinnedPage {
     /** From the pin itself on newer cores; read off the delivered text's `<name> (<id>): ` prefix on older ones. */
     name?: string;
     scope?: string;
+    /** For a pinned listing, the id of the page whose subtree it lists; the row links there. */
+    listOf?: string;
     /** What the agent was given for this pin, verbatim. */
     text?: string;
 }

package/dist/src/domains/chat/tools/badges/knowledge-body-range.d.ts

@@ -0,0 +1,12 @@
+/** What part of a page a Knowledge call read or wrote: a short tag for the collapsed row, a sentence for the body. */
+export interface BodyExtent {
+    row: string | undefined;
+    summary: string;
+}
+/**
+ * Which part of the body a `knowledge_read` result holds, from the call's arguments and its page. A whole
+ * body has no row tag; undefined when the result is not a body read at all (a notes-only read, a scope listing).
+ */
+export declare function readExtent(output: Record<string, unknown>, args: Record<string, unknown>): BodyExtent | undefined;
+/** Which lines a `knowledge_page` write replaced, from its `range` argument; undefined for a whole-body write. */
+export declare function writeExtent(args: Record<string, unknown>): BodyExtent | undefined;

package/dist/src/domains/chat/tools/badges/knowledge-tool-badge.d.ts

@@ -9,8 +9,11 @@ export interface KnowledgeCard {
     detail?: string;
     body: ReactNode;
 }
-/** What each Knowledge tool's settled result says, or null when the shape isn't one we know. */
-export declare function knowledgeCard(toolName: string, input: unknown, output: unknown): KnowledgeCard | null;
+/**
+ * What each Knowledge tool's settled result says, or null when the shape isn't one we know.
+ * A failed call (`errorText` set) gets a card naming what it tried and the error it got.
+ */
+export declare function knowledgeCard(toolName: string, input: unknown, output: unknown, errorText?: string): KnowledgeCard | null;
 export interface KnowledgeToolBadgeProps extends Omit<ToolApprovalRequest, 'toolCalled'> {
     card: KnowledgeCard;
     metadata?: MessageMetadata;

package/dist/src/domains/chat/tools/badges/mcp-input-request-badge.d.ts

@@ -0,0 +1,18 @@
+import type { McpInputRequestPayload } from '../mcp-input-request';
+import type { OpenInputRequest } from './use-deferred-input-request';
+/** A call the run is parked on: answering resumes the run, like any other suspended tool. */
+export declare function ForegroundMcpInputRequest({ toolCallId, payload, readOnly, isNetwork, }: {
+    toolCallId: string;
+    payload: McpInputRequestPayload;
+    readOnly?: boolean;
+    /** A network run resumes through its own route, which can't carry these answers yet. */
+    isNetwork?: boolean;
+}): import("react").JSX.Element;
+/**
+ * A deferred call whose background task waits on the question. The agent's turn already ended, so
+ * the answer goes to the task directly and the chat stays free for other messages meanwhile.
+ */
+export declare function DeferredMcpInputRequest({ backgroundTaskId, request, }: {
+    backgroundTaskId: string;
+    request: OpenInputRequest;
+}): import("react").JSX.Element;

package/dist/src/domains/chat/tools/badges/tool-badge.d.ts

@@ -1,3 +1,4 @@
+import type { McpInputRequestPayload } from '../mcp-input-request';
 import type { MessageMetadata } from '../..';
 import type { ToolApprovalRequest } from './tool-approval-badge';
 import type { ActivityStatus } from '../../../../ds/components/ai/activity';
@@ -17,5 +18,7 @@ export interface ToolBadgeProps extends Omit<ToolApprovalRequest, 'toolCalled'>
     backgroundTaskId?: string;
     /** `running` while the part holds a deferred call's placeholder; `completed`/`failed` once it holds the result. */
     backgroundTaskStatus?: string;
+    /** The MCP task question the call is waiting on, if it is. */
+    mcpInputRequest?: McpInputRequestPayload;
 }
-export declare const ToolBadge: ({ toolName, args, result, metadata, toolOutput, toolCallId, toolApprovalMetadata, suspendPayload, isNetwork, toolCalled: toolCalledProp, withoutArgs, status, backgroundTaskId, backgroundTaskStatus, }: ToolBadgeProps) => import("react").JSX.Element;
+export declare const ToolBadge: ({ toolName, args, result, metadata, toolOutput, toolCallId, toolApprovalMetadata, suspendPayload, isNetwork, toolCalled: toolCalledProp, withoutArgs, status, backgroundTaskId, backgroundTaskStatus, mcpInputRequest, }: ToolBadgeProps) => import("react").JSX.Element;

package/dist/src/domains/chat/tools/badges/use-deferred-input-request.d.ts

@@ -0,0 +1,44 @@
+import type { McpInputRequestPayload, McpInputResumeData } from '../mcp-input-request';
+export declare const backgroundTaskQueryKey: (backgroundTaskId: string) => readonly ['background-task', string];
+export interface OpenInputRequest {
+    payload: McpInputRequestPayload;
+    /** The suspension being answered; the server refuses an answer to an older one. */
+    suspendedAt?: string | Date;
+}
+/**
+ * The MCP input request a deferred call's background task is suspended on, if any. The task is read
+ * once (so a reloaded chat still sees an open request) and then followed over the task's event
+ * stream, whose events are folded into the same cache entry the task chip polls.
+ */
+export declare function useDeferredInputRequest(backgroundTaskId: string, enabled: boolean): OpenInputRequest | undefined;
+/** Answers a deferred call's suspended background task, fenced on the suspension that was shown. */
+export declare function useResumeBackgroundTask(backgroundTaskId: string): import("@tanstack/react-query").UseMutationResult<{
+    id: string;
+    status: 'pending' | 'running' | 'suspended' | 'completed' | 'failed' | 'cancelled' | 'timed_out';
+    toolName: string;
+    toolCallId: string;
+    args: {
+        [x: string]: unknown;
+    };
+    agentId: string;
+    threadId?: string | undefined;
+    resourceId?: string | undefined;
+    runId: string;
+    result?: unknown | undefined;
+    error?: {
+        message: string;
+        stack?: string | undefined;
+    } | undefined;
+    createdAt: string;
+    startedAt?: string | undefined;
+    completedAt?: string | undefined;
+    retryCount: number;
+    maxRetries: number;
+    timeoutMs: number;
+    suspendPayload?: unknown | undefined;
+    suspendedAt?: string | undefined;
+}, Error, {
+    resumeData: McpInputResumeData;
+    suspendedAt?: string | Date;
+}, unknown>;
+export declare const resumeErrorMessage: (error: Error) => string;

package/dist/src/domains/chat/tools/badges/use-mcp-task-progress.d.ts

@@ -1,3 +1,4 @@
+import type { McpInputRequestPayload } from '../mcp-input-request';
 import type { ActivityStatus } from '../../../../ds/components/ai/activity';
 export type McpTaskStatus = 'working' | 'input_required' | 'completed' | 'failed' | 'cancelled';
 /** What `@mastra/mcp`'s client writes to a task-backed tool's output stream (`MCPTaskProgress`). */
@@ -21,7 +22,11 @@ export interface McpTaskView extends McpTaskProgress {
  *
  * A deferred call (one running as a Mastra background task) settles its part with a placeholder
  * long before the task ends, so its end is never inferred here: the background task says when.
+ *
+ * While the call is suspended on the task's input request, the request names the task, so the chip
+ * reads `input_required` even on a reloaded card with no progress.
  */
-export declare function useMcpTaskProgress(result: unknown, status: ActivityStatus, { deferred }?: {
+export declare function useMcpTaskProgress(result: unknown, status: ActivityStatus, { deferred, request }?: {
     deferred?: boolean;
+    request?: McpInputRequestPayload;
 }): McpTaskView | undefined;

package/dist/src/domains/chat/tools/mcp-input-request-tool.d.ts

@@ -0,0 +1,18 @@
+import type { McpInputRequestPayload, McpInputResumeData } from './mcp-input-request';
+export interface McpInputRequestToolProps {
+    payload: McpInputRequestPayload;
+    /** Sends the answers; the request stays open (and answerable again) if the returned promise rejects. */
+    onSubmit: (resumeData: McpInputResumeData) => void | Promise<unknown>;
+    isSubmitting?: boolean;
+    /** Why the last answer didn't go through. */
+    error?: string;
+    /** History view: show the question without answering it. */
+    readOnly?: boolean;
+    /** Why the request can't be answered here, shown with the questions. */
+    notice?: string;
+}
+/**
+ * The questions an MCP server asked while a tool call's task waits. Every request key needs an answer
+ * before the call can continue, so answers are held until the last one is given, then sent together.
+ */
+export declare function McpInputRequestTool({ payload, onSubmit, isSubmitting, error, readOnly, notice, }: McpInputRequestToolProps): import("react").JSX.Element;

package/dist/src/domains/chat/tools/mcp-input-request.d.ts

@@ -0,0 +1,40 @@
+import type { MessageMetadata, SuspendedToolMetadata } from '../messages/message-metadata';
+/** An embedded request an MCP server sent while its task waits (`{ method, params }`). */
+export interface McpInputRequest {
+    method: string;
+    params?: Record<string, unknown>;
+}
+/** What `@mastra/mcp` suspends a task-backed tool call with (`MCPInputRequestSuspendPayload`). */
+export interface McpInputRequestPayload {
+    type: 'mcp-input-request';
+    serverName: string;
+    toolName: string;
+    taskId: string;
+    createdAt: string;
+    /** When the call suspended; new each time the same task asks again, unlike `createdAt`. */
+    requestedAt?: string;
+    requests: Record<string, McpInputRequest>;
+}
+export type McpInputAction = 'accept' | 'decline' | 'cancel';
+export interface McpInputResponse {
+    action: McpInputAction;
+    content?: Record<string, unknown>;
+}
+/** Resume data answering every request key (`MCPInputRequestResumeData`). */
+export interface McpInputResumeData {
+    inputResponses: Record<string, McpInputResponse>;
+}
+export declare function isMcpInputRequest(payload: unknown): payload is McpInputRequestPayload;
+/** More questions at once than any real task asks; the server decides these, so Studio bounds them. */
+export declare const MAX_INPUT_REQUESTS = 20;
+export declare const MAX_REQUEST_MESSAGE_LENGTH = 2000;
+export declare const MAX_INPUT_REQUESTS_SIZE: number;
+/** Whether the server sent more than Studio draws: too many questions, a huge message, or huge params. */
+export declare function inputRequestTooLarge(payload: McpInputRequestPayload): boolean;
+/**
+ * This call's own suspension. Saved entries are keyed by call id, but a live run keys them by tool
+ * name (two calls of one tool share that key), so the entry's own `toolCallId` decides.
+ */
+export declare function findSuspension(metadata: MessageMetadata | undefined, toolCallId: string): SuspendedToolMetadata | undefined;
+/** The MCP input request this call is suspended on, if it is. */
+export declare function suspendedMcpInputRequest(metadata: MessageMetadata | undefined, toolCallId: string): McpInputRequestPayload | undefined;

package/dist/src/domains/chat/tools/tool-card-kind.d.ts

@@ -2,7 +2,7 @@ import type { MessageMetadata, SuspendedToolMetadata, ToolApprovalMetadata } fro
 import type { ToolPartFields } from '../messages/renderers/tool-part';
 import type { ActivityStatus } from '../../../ds/components/ai/activity';
 /** Which card draws a call. Decided once, shared by the dispatcher and the fold. */
-export type ToolCardKind = 'hidden' | 'observation' | 'ask_user' | 'connect_prompt' | 'submit_plan' | 'background' | 'agent' | 'workflow' | 'file_tree' | 'sandbox' | 'code_mode' | 'mcp_app' | 'knowledge' | 'plain';
+export type ToolCardKind = 'hidden' | 'observation' | 'ask_user' | 'connect_prompt' | 'submit_plan' | 'mcp_input_request' | 'background' | 'agent' | 'workflow' | 'file_tree' | 'sandbox' | 'code_mode' | 'mcp_app' | 'knowledge' | 'plain';
 export interface ToolCardContext {
     metadata?: MessageMetadata;
     mcpAppTools?: Record<string, unknown>;
@@ -14,6 +14,8 @@ export interface ToolInteraction {
 export declare const isAgentCall: (metadata: MessageMetadata | undefined, toolName: string) => boolean;
 export declare const isWorkflowCall: (metadata: MessageMetadata | undefined, toolName: string) => boolean;
 export declare const isSettledState: (state: string | undefined) => boolean;
+/** A call running as a Mastra background task. An awaited call's part also names its task, but holds the final result. */
+export declare const isDeferredCall: (backgroundTaskId: string | undefined, backgroundTaskStatus: string | undefined) => boolean;
 /** A call neither settled nor carried by a live run reads as idle, so stale history never shimmers. */
 export declare function badgeStatus(state: string | undefined, chatRunning: boolean): ActivityStatus;
 export declare const codeModeCall: (input: unknown, output: unknown) => {
@@ -24,4 +26,4 @@ export declare const codeModeCall: (input: unknown, output: unknown) => {
 export declare function toolInteraction(metadata: MessageMetadata | undefined, toolName: string, toolCallId: string): ToolInteraction;
 /** Tools the transcript never draws: working memory updates and task tools (shown in the docked task list). */
 export declare function isHiddenTool(toolName: string): boolean;
-export declare function toolCardKind({ toolName, toolCallId, input, output, state }: ToolPartFields, { metadata, mcpAppTools }: ToolCardContext): ToolCardKind;
+export declare function toolCardKind({ toolName, toolCallId, input, output, state, backgroundTaskId, backgroundTaskStatus }: ToolPartFields, { metadata, mcpAppTools }: ToolCardContext): ToolCardKind;

package/dist/src/domains/chat/tools/tool-card.d.ts

@@ -27,4 +27,4 @@ export interface ToolCardProps {
 }
 /** Its own workflow run scope, so a streaming workflow result can drive a live graph inside the card. */
 export declare const ToolCard: (props: ToolCardProps) => import("react").JSX.Element;
-export declare const ToolCardInner: ({ toolName, input, output, modelOutput, backgroundTaskId, backgroundTaskStatus, toolCallId, state, errorText, metadata, dataParts, readOnly, }: ToolCardProps) => import("react").JSX.Element | null;
+export declare const ToolCardInner: ({ toolName, input, output, modelOutput, backgroundTaskId, backgroundTaskStatus, toolCallId, state, errorText, metadata, dataParts, readOnly, }: ToolCardProps) => import("react").JSX.Element;

package/dist/src/domains/knowledge/components/KnowledgePageCard.d.ts

@@ -0,0 +1,23 @@
+export interface KnowledgePageCardProps {
+    name: string;
+    /** `Page`, `Scope` or a scope's display label. */
+    kind: string;
+    /** Where the page is addressed, e.g. `org:acme#policies/refunds`. */
+    pageRef?: string;
+    /** Where the page sits, from its root scope down. */
+    path?: string;
+    /** Already formatted (`1000+` when the server capped the count); left out when unknown or zero. */
+    childCount?: string;
+    /** Left out when unknown or both zero. */
+    links?: {
+        in: number;
+        out: number;
+    };
+    /** Of `links`, how many go to pages the graph doesn't draw. */
+    notShown?: number;
+}
+/**
+ * What the explorer's graph tooltip says about a page: name, kind and ref, children, links. The graph's
+ * dots and the hover cards on page links in chat both draw it.
+ */
+export declare function KnowledgePageCard({ name, kind, pageRef, path, childCount, links, notShown }: KnowledgePageCardProps): import("react").JSX.Element;

package/dist/src/domains/knowledge/components/KnowledgePageExplorer.d.ts

@@ -36,6 +36,16 @@ export interface KnowledgeExplorerQueryState<T> {
     isError: boolean;
     error: Error | null;
 }
+export interface KnowledgeExplorerPageLinks {
+    edges: Array<{
+        fromPageId: string;
+        toPageId: string;
+        kind: 'body' | 'note';
+        count: number;
+    }>;
+    pages: KnowledgePagePayload[];
+    truncated: boolean;
+}
 /** One request for a tree level: `parentId: null` for the root scopes. */
 export interface KnowledgeExplorerTreeRequest {
     parentId: string | null;
@@ -58,6 +68,23 @@ export interface KnowledgeExplorerSource {
     };
     /** Tree levels, one result per request in order (e.g. `useQueries`). Enables the lazily loaded tree and child pages. */
     useTreeLevels?: (requests: KnowledgeExplorerTreeRequest[]) => Array<KnowledgeExplorerQueryState<KnowledgeExplorerTreeLevel>>;
+    /**
+     * Pages a link reaches, by id or `[[ref]]` (`scope#path`), one result per entry in order (e.g.
+     * `useQueries`). Lets the focused page draw links to pages the graph hasn't loaded; without it only
+     * links to loaded pages are drawn. A key the host can't resolve should come back as an error.
+     */
+    useLinkedPages?: (keys: string[]) => Array<KnowledgeExplorerQueryState<KnowledgeExplorerPageDetail>>;
+    /**
+     * Exact links into and out of each page (by `[[ref]]` or note mention), counted over the whole store, for
+     * the pages the graph draws. Without it, or when it errors (a server with no link index answers 501), the
+     * graph counts only the links between pages it has loaded.
+     */
+    useLinkCounts?: (pageIds: string[]) => KnowledgeExplorerQueryState<Record<string, {
+        in: number;
+        out: number;
+    }>>;
+    /** One page's links with the pages at their other ends; fetched for the page under the pointer. Null disables it. */
+    usePageLinks?: (pageId: string | null) => KnowledgeExplorerQueryState<KnowledgeExplorerPageLinks>;
     /** A page's recent activity, newest first. */
     useActivity?: (pageId: string) => KnowledgeExplorerQueryState<KnowledgeExplorerActivity>;
 }
@@ -70,6 +97,8 @@ export interface KnowledgePageExplorerProps {
     view: KnowledgeExplorerView;
     onViewChange: (view: KnowledgeExplorerView) => void;
 }
+/** Links of the selected page drawn at most in each direction; the rest are counted. */
+export declare const FOCUS_LINK_CAP = 20;
 /**
  * Search, the page tree, and either the page graph or the selected page, kept in sync on one selection.
  * Wide screens show the tree beside the graph or the page; below `lg` one toggle picks tree, graph or page.

package/dist/src/domains/knowledge/components/KnowledgePageGraph.d.ts

@@ -1,12 +1,38 @@
 import type { KnowledgePageEdge, KnowledgePagePayload, KnowledgeScopeGrantPayload } from '../pageTypes';
 export interface KnowledgePageGraphProps {
     pages: KnowledgePagePayload[];
-    /** Mention edges between pages; parent edges are derived from `pages`. */
+    /** Mention and body-link edges between pages; parent edges are derived from `pages`. */
     edges: KnowledgePageEdge[];
     pinnedIds?: readonly string[];
     /** Access grants between scopes, drawn from each principal scope to the scope it reaches. */
     grants?: readonly KnowledgeScopeGrantPayload[];
     selectedPageId?: string | null;
+    /** The page the layout centres on when none is selected, drawn like a focused page without the ring. */
+    centerId?: string | null;
+    /** Per page, links into and out of it that the graph doesn't draw; shown as `→in out→` on full circles. */
+    hiddenLinks?: ReadonlyMap<string, {
+        in: number;
+        out: number;
+    }>;
+    /** Every link between pages, drawn or not: hovering a page draws its own, and tooltips count them. */
+    knownLinks?: readonly KnowledgePageEdge[];
+    /** Pages the focus links to or from that the hierarchy doesn't reach: drawn close around the focus. */
+    nearIds?: ReadonlySet<string>;
+    /** False while the pages the selected page needs are loading: the graph keeps its last layout until they are in. */
+    settled?: boolean;
+    /** Exact links into and out of pages, from the store; they replace the counts taken from `knownLinks`. */
+    exactLinkCounts?: ReadonlyMap<string, {
+        in: number;
+        out: number;
+    }>;
+    /** Links fetched for the page under the pointer: drawn on hover, never counted or laid out. */
+    fetchedLinks?: readonly KnowledgePageEdge[];
+    /** The page under the pointer, or null: a host can fetch that page's links. */
+    onHover?: (pageId: string | null) => void;
+    /** Write each dot's total of links in and out inside it. */
+    showCounts?: boolean;
+    /** The pointer rests on a dot or stand-in: a host can load what it stands for. */
+    onPreview?: (page: KnowledgePagePayload) => void;
     /** A page that wasn't selected was clicked, tapped, or activated with Enter or Space: select it. */
     onSelect: (page: KnowledgePagePayload) => void;
     /** The already-selected page was clicked, tapped, or activated again: open it. Without it, that only reselects. */

package/dist/src/domains/knowledge/components/KnowledgePageTree.d.ts

@@ -9,7 +9,8 @@ export declare const KNOWLEDGE_TREE_ROOT = "";
  *
  * A host that loads the tree a level at a time passes `mayHaveChildren` (so unloaded pages still offer
  * a chevron), listens to `onExpandedChange` to load the opened levels, and passes `loadMore` for
- * levels with more children to fetch.
+ * levels with more children to fetch. A page's `childCount`, when the server sends one, shows beside
+ * its name. Selecting a page with children also opens it.
  */
 export declare function KnowledgePageTree({ pages, pinnedIds, selectedPageId, onSelect, initiallyExpanded, mayHaveChildren, onExpandedChange, loadMore, 'aria-label': ariaLabel, }: {
     pages: KnowledgePagePayload[];

package/dist/src/domains/knowledge/lib/circleText.d.ts

@@ -0,0 +1,2 @@
+/** The text with any word wider than the circle cut short with an ellipsis, so words never break mid-way. */
+export declare function fitWords(text: string, maxChars: number): string;