@mastra/playground-ui 67.0.0 → 68.0.0-alpha.1

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

@@ -1 +1 @@
-{"version":3,"file":"span-payload-primitives-Dyhbqaa7.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-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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"}

package/dist/{span-payload-primitives-B10Xxmx7.cjs → span-payload-primitives-_2d-pAOD.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-BLErsb7c.cjs");
-const require_activity = require("./activity-DAK8tj7r.cjs");
+const require_tool_presentation = require("./tool-presentation-CQlDEwgS.cjs");
+const require_activity = require("./activity-DyB5H3gF.cjs");
 const require_components_Collapsible = require("./components/Collapsible.cjs.js");
 const require_components_DisclosureChevron = require("./components/DisclosureChevron.cjs.js");
-const require_MarkdownRenderer = require("./MarkdownRenderer-CS6u5drO.cjs");
+const require_MarkdownRenderer = require("./MarkdownRenderer-CB8Z_CHc.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-B10Xxmx7.cjs.map
+//# sourceMappingURL=span-payload-primitives-_2d-pAOD.cjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"span-payload-primitives-B10Xxmx7.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-_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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"}

package/dist/src/domains/chat/index.d.ts

@@ -3,6 +3,7 @@ export * from './context/chat-context';
 export * from './context/tool-call-context';
 export * from './messages/message-metadata';
 export * from './messages/signal-data';
+export * from './knowledge';
 export * from './messages/renderers/tool-part';
 export * from './context/dataset-save-context';
 export { useDatasetSaveContext } from './context/dataset-save-context-value';

package/dist/src/domains/chat/knowledge/index.d.ts

@@ -0,0 +1,5 @@
+export * from './knowledge-links';
+export * from './pinned-knowledge';
+export * from './pinned-knowledge-data';
+export { KNOWLEDGE_TOOLS, knowledgeCard } from '../tools/badges/knowledge-tool-badge';
+export type { KnowledgeCard } from '../tools/badges/knowledge-tool-badge';

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

@@ -0,0 +1,21 @@
+import type { ReactNode } from 'react';
+import type { LinkComponent } from '../../../lib/framework';
+interface KnowledgeLinks {
+    /** 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;
+    Link?: LinkComponent;
+}
+/**
+ * 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 & {
+    children: ReactNode;
+}): import("react").JSX.Element;
+/** A link to a Knowledge page, through the host's link component and route. */
+export declare function KnowledgePageLink({ pageId, children, className, }: {
+    pageId: string;
+    children: ReactNode;
+    className?: string;
+}): import("react").JSX.Element;
+export {};

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

@@ -0,0 +1,22 @@
+import type { SignalData } from '../messages/signal-data';
+/** The Studio Knowledge page for a page id, opened in Page view. */
+export declare const knowledgePageHref: (pageId: string) => string;
+export interface PinnedPage {
+    id: string;
+    /** From the pin itself on newer cores; read off the delivered text's `<name> (<id>): ` prefix on older ones. */
+    name?: string;
+    scope?: string;
+    /** What the agent was given for this pin, verbatim. */
+    text?: string;
+}
+export type PinnedRow = PinnedPage & {
+    change?: 'add' | 'change' | 'remove';
+};
+export interface PinnedKnowledge {
+    mode: 'snapshot' | 'delta';
+    rows: PinnedRow[];
+    /** The "Also pinned …" line when stored pins overflowed the budget. */
+    overflow?: string;
+}
+/** A signal's pinned Knowledge, or undefined when it is some other signal or a shape we don't know. */
+export declare function pinnedKnowledgeFromSignal(signal: Pick<SignalData, 'tagName' | 'metadata' | 'attributes'>): PinnedKnowledge | undefined;

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

@@ -0,0 +1,9 @@
+import type { PinnedKnowledge } from './pinned-knowledge-data';
+/**
+ * Pinned Knowledge as the agent received it: a snapshot lists every pinned page, a delta lists the pages
+ * added, changed or removed since. Each page links to the Knowledge viewer; its delivered text opens below it.
+ */
+export declare function PinnedKnowledgeActivity({ pinned, defaultOpen }: {
+    pinned: PinnedKnowledge;
+    defaultOpen?: boolean;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,19 @@
+import type { ReactNode } from 'react';
+import type { MessageMetadata } from '../..';
+import type { ToolApprovalRequest } from './tool-approval-badge';
+import type { ActivityStatus } from '../../../../ds/components/ai/activity';
+/** The tools `Knowledge.createTools()` gives an agent. */
+export declare const KNOWLEDGE_TOOLS: Set<string>;
+export interface KnowledgeCard {
+    title: string;
+    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;
+export interface KnowledgeToolBadgeProps extends Omit<ToolApprovalRequest, 'toolCalled'> {
+    card: KnowledgeCard;
+    metadata?: MessageMetadata;
+    status?: ActivityStatus;
+}
+export declare const KnowledgeToolBadge: ({ card, toolName, metadata, toolCallId, toolApprovalMetadata, isNetwork, status, }: KnowledgeToolBadgeProps) => import("react").JSX.Element;

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' | 'plain';
+export type ToolCardKind = 'hidden' | 'observation' | 'ask_user' | 'connect_prompt' | 'submit_plan' | 'background' | 'agent' | 'workflow' | 'file_tree' | 'sandbox' | 'code_mode' | 'mcp_app' | 'knowledge' | 'plain';
 export interface ToolCardContext {
     metadata?: MessageMetadata;
     mcpAppTools?: Record<string, unknown>;
@@ -24,4 +24,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 }: ToolPartFields, { metadata, mcpAppTools }: ToolCardContext): ToolCardKind;
+export declare function toolCardKind({ toolName, toolCallId, input, output, state }: ToolPartFields, { metadata, mcpAppTools }: ToolCardContext): ToolCardKind;

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

@@ -0,0 +1,42 @@
+import type { ReactNode } from 'react';
+import type { KnowledgePageActivityPayload, KnowledgeNotePayload, KnowledgePagePayload, KnowledgePinPayload } from '../pageTypes';
+/** One note: who wrote it and when, its text with `[[mentions]]` linked when the page is known, and the scopes it is stamped to. */
+export declare function KnowledgeNoteItem({ note, pagesById, onPageClick, highlighted, itemRef, showPage, compact, }: {
+    note: KnowledgeNotePayload;
+    pagesById: ReadonlyMap<string, KnowledgePagePayload>;
+    onPageClick: (page: KnowledgePagePayload) => void;
+    highlighted?: boolean;
+    itemRef?: (element: HTMLLIElement | null) => void;
+    /** Name the page the note sits on, for notes listed away from it. */
+    showPage?: boolean;
+    /** A tighter layout for popups. */
+    compact?: boolean;
+}): import("react").JSX.Element;
+/**
+ * The selected page as a page: where it sits, its body as markdown, its child
+ * pages, its notes (each with the scopes it is stamped to and who wrote it),
+ * the notes elsewhere that mention it, and its recent activity. Bodies are
+ * agent-written, so they render through {@link MarkdownRenderer}, which escapes
+ * raw HTML and drops unsafe link schemes.
+ *
+ * Paged lists take a `…More` slot the host fills with the next page's loader.
+ */
+export declare function KnowledgePageDetail({ page, notes, pin, pagesById, onPageClick, highlightMentionOf, ancestors, mentionedBy, notesMore, childPages, activity, }: {
+    page: KnowledgePagePayload;
+    notes: KnowledgeNotePayload[];
+    pin?: KnowledgePinPayload;
+    /** Loaded pages, for scope names and mention links. */
+    pagesById: ReadonlyMap<string, KnowledgePagePayload>;
+    onPageClick: (page: KnowledgePagePayload) => void;
+    /** Marks the notes that mention this page, e.g. after a mention line in the graph was clicked. */
+    highlightMentionOf?: string;
+    /** Readable ancestors, root first: a breadcrumb and the page's path. */
+    ancestors?: KnowledgePagePayload[];
+    /** Notes on other pages that mention this one. */
+    mentionedBy?: KnowledgeNotePayload[];
+    /** Rendered after the notes: the host's loader for the next page of notes. */
+    notesMore?: ReactNode;
+    /** The page's children, when the host can list them. */
+    childPages?: ReactNode;
+    activity?: KnowledgePageActivityPayload[];
+}): import("react").JSX.Element;

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

@@ -0,0 +1,80 @@
+import type { KnowledgePageActivityPayload, KnowledgeNotePayload, KnowledgePageEdge, KnowledgePagePayload, KnowledgePinPayload, KnowledgeScopeGrantPayload } from '../pageTypes';
+/** `tree` is only a choice below `lg`; wider screens always show the tree beside the graph or the page. */
+export type KnowledgeExplorerView = 'tree' | 'graph' | 'page';
+/** The bounded page graph a host loads. Without `useTreeLevels`, its pages also feed the tree. */
+export interface KnowledgeExplorerGraph {
+    pages: KnowledgePagePayload[];
+    edges: KnowledgePageEdge[];
+    pinnedIds: string[];
+    /** Access grants between scopes; hosts whose server doesn't send them leave this out. */
+    grants?: KnowledgeScopeGrantPayload[];
+    truncated: boolean;
+}
+export interface KnowledgeExplorerPageDetail {
+    page: KnowledgePagePayload;
+    notes: KnowledgeNotePayload[];
+    /** Cursor for the page's next notes. */
+    notesNextCursor?: string;
+    pin?: KnowledgePinPayload | null;
+    /** Ancestors and referenced pages, which may sit outside the loaded graph. */
+    ancestors: KnowledgePagePayload[];
+    related: KnowledgePagePayload[];
+    /** Notes on other pages that mention this one. */
+    mentionedBy?: KnowledgeNotePayload[];
+}
+/** One level of the tree: a parent's child scopes then its child pages, paged. */
+export interface KnowledgeExplorerTreeLevel {
+    pages: KnowledgePagePayload[];
+    nextCursor?: string;
+}
+export interface KnowledgeExplorerActivity {
+    events: KnowledgePageActivityPayload[];
+}
+export interface KnowledgeExplorerQueryState<T> {
+    data?: T;
+    isPending: boolean;
+    isError: boolean;
+    error: Error | null;
+}
+/** One request for a tree level: `parentId: null` for the root scopes. */
+export interface KnowledgeExplorerTreeRequest {
+    parentId: string | null;
+    cursor?: string;
+}
+/**
+ * Host data hooks. Each host binds them to its own routes (Studio to the Mastra client, Factory to its
+ * project-scoped routes), so the explorer never knows a URL or an id outside the page ids it shows.
+ * Pass the same functions every render: they are called as hooks.
+ */
+export interface KnowledgeExplorerSource {
+    /** One page; `noteCursor` fetches a later page of its notes. Disabled when `pageId` is null. */
+    usePage: (pageId: string | null, noteCursor?: string) => KnowledgeExplorerQueryState<KnowledgeExplorerPageDetail>;
+    useSearch: (query: string) => {
+        data?: {
+            results: Array<{
+                page: KnowledgePagePayload;
+            }>;
+        };
+    };
+    /** 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>>;
+    /** A page's recent activity, newest first. */
+    useActivity?: (pageId: string) => KnowledgeExplorerQueryState<KnowledgeExplorerActivity>;
+}
+export interface KnowledgePageExplorerProps {
+    graph: KnowledgeExplorerGraph;
+    source: KnowledgeExplorerSource;
+    selectedPageId: string | null;
+    /** `null` clears the selection: a click on empty graph canvas. */
+    onSelect: (pageId: string | null) => void;
+    view: KnowledgeExplorerView;
+    onViewChange: (view: KnowledgeExplorerView) => void;
+}
+/**
+ * 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.
+ * A first click on a page in the graph selects it; clicking it again opens it as a page. A search result
+ * opens it as a page straight away. Selecting in the tree keeps the current view, so the graph frames the
+ * page instead.
+ */
+export declare function KnowledgePageExplorer({ graph, source, selectedPageId, onSelect, view, onViewChange, }: KnowledgePageExplorerProps): import("react").JSX.Element;

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

@@ -0,0 +1,35 @@
+import type { KnowledgePageEdge, KnowledgePagePayload, KnowledgeScopeGrantPayload } from '../pageTypes';
+export interface KnowledgePageGraphProps {
+    pages: KnowledgePagePayload[];
+    /** Mention 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;
+    /** 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. */
+    onOpen?: (page: KnowledgePagePayload) => void;
+    /** Empty canvas was clicked without moving the pointer (a pan doesn't count): clear the selection. */
+    onClearSelection?: () => void;
+    /** A mention line was clicked: notes on `source` mention `target`. `point` is where, in the graph's own box. */
+    onMentionSelect?: (mention: {
+        source: KnowledgePagePayload;
+        target: KnowledgePagePayload;
+        point: {
+            x: number;
+            y: number;
+        };
+        /** The graph's own size, so a popup can open on whichever side of `point` has room. */
+        pane: {
+            width: number;
+            height: number;
+        };
+    }) => void;
+}
+/**
+ * The schema-4 Knowledge page graph: scopes and pages as circles sized by how often they are mentioned,
+ * parent links as faint edges and mentions as solid ones. The first layout is deterministic for the same pages; later updates start from where pages already sit.
+ */
+export declare function KnowledgePageGraph(props: KnowledgePageGraphProps): import("react").JSX.Element;

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

@@ -0,0 +1,27 @@
+import type { KnowledgePagePayload } from '../pageTypes';
+/** The key {@link KnowledgePageTree}'s `loadMore` uses for the root level. */
+export declare const KNOWLEDGE_TREE_ROOT = "";
+/**
+ * The Knowledge page tree: scopes and pages nested by parent, siblings in
+ * stored order. Selecting a page from elsewhere (graph, search) opens the path
+ * to it. Keyboard follows the WAI-ARIA tree pattern: Up/Down move, Right opens
+ * or enters, Left closes or goes to the parent, Enter/Space selects.
+ *
+ * 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.
+ */
+export declare function KnowledgePageTree({ pages, pinnedIds, selectedPageId, onSelect, initiallyExpanded, mayHaveChildren, onExpandedChange, loadMore, 'aria-label': ariaLabel, }: {
+    pages: KnowledgePagePayload[];
+    pinnedIds?: readonly string[];
+    selectedPageId?: string | null;
+    onSelect: (page: KnowledgePagePayload) => void;
+    /** Ids open on first render; defaults to every root. */
+    initiallyExpanded?: string[];
+    /** True for a page whose children are not loaded yet, so it can still be opened. */
+    mayHaveChildren?: (page: KnowledgePagePayload) => boolean;
+    onExpandedChange?: (expanded: ReadonlySet<string>) => void;
+    /** Parent id ({@link KNOWLEDGE_TREE_ROOT} for the roots) to a loader for its next children. */
+    loadMore?: ReadonlyMap<string, () => void>;
+    'aria-label'?: string;
+}): import("react").JSX.Element;

package/dist/src/domains/knowledge/hooks/useInteractionIdle.d.ts

@@ -0,0 +1,12 @@
+/** Pure gate: idle once the last interaction is at least idleMs ago. */
+export declare function isIdle(lastActivityAt: number, now: number, idleMs: number): boolean;
+/**
+ * Tracks whether the user has left a surface alone for at least idleMs.
+ * Wire `onActivity` to capture-phase pointer/wheel handlers on the surface;
+ * `idle` flips false immediately on activity and back true after idleMs of
+ * silence (checked on a 1s tick). Starts idle — a fresh page updates freely.
+ */
+export declare function useInteractionIdle(idleMs: number): {
+    idle: boolean;
+    onActivity: () => void;
+};

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

@@ -0,0 +1,35 @@
+/**
+ * Synchronous d3-force layout for the knowledge graph. The simulation is run
+ * to a fixed tick count with deterministic initial positions (a phyllotaxis
+ * spiral over the SORTED node ids), so the same input always yields the same
+ * settled layout — that is what makes the layout unit-testable.
+ */
+export interface LayoutNodeInput {
+    id: string;
+    /** Node diameter in px (drives collision radius and link distance). */
+    size: number;
+    /** Pinned position from a user drag — the simulation must not move it. */
+    fixed?: {
+        x: number;
+        y: number;
+    };
+    /** Warm-start position (e.g. spawn a new node near its first neighbor). */
+    initial?: {
+        x: number;
+        y: number;
+    };
+    /** Collision breathing room around the node (default 28; tiny record dots use less). */
+    padding?: number;
+}
+export interface LayoutEdgeInput {
+    source: string;
+    target: string;
+    /** A11: hug links (record dot stubs / junction spokes) stay short so record markers cluster tight. */
+    hug?: boolean;
+}
+export declare function runLayout(nodes: LayoutNodeInput[], edges: LayoutEdgeInput[], options?: {
+    ticks?: number;
+}): Map<string, {
+    x: number;
+    y: number;
+}>;

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

@@ -0,0 +1,45 @@
+/**
+ * Pure page-graph logic for the schema-4 explorer: parent links plus resolved
+ * mentions between loaded pages → React Flow nodes and edges. Every scope is
+ * one size and every page another, so a circle's size says what it is and its
+ * name always fits inside.
+ */
+import type { Edge, Node } from '@xyflow/react';
+import type { KnowledgePageEdge, KnowledgePagePayload, KnowledgeScopeGrantPayload } from '../pageTypes';
+/**
+ * Edges among loaded, live pages: a parent edge for every loaded parent, and
+ * the given mention edges merged per source → target (counts summed). Self
+ * mentions and edges to unloaded pages are dropped.
+ */
+export declare function pageGraphEdges(pages: KnowledgePagePayload[], mentionEdges?: KnowledgePageEdge[]): KnowledgePageEdge[];
+/** Id of the placeholder circle for a declared principal that has no scope page yet. */
+export declare function unplacedScopeId(address: string): string;
+/**
+ * Grants as graph pages and edges. A grant from a principal with a loaded scope page draws from that
+ * page; one whose principal has no scope page yet draws from a placeholder scope (one per address), so
+ * a role nobody has written to still shows what it can reach. Grants to unloaded targets are dropped.
+ */
+export declare function grantGraph(pages: KnowledgePagePayload[], grants?: readonly KnowledgeScopeGrantPayload[]): {
+    placeholders: KnowledgePagePayload[];
+    edges: KnowledgePageEdge[];
+};
+/** The page plus every page one edge away from it, either direction. */
+export declare function pageNeighbourIds(pageId: string, edges: KnowledgePageEdge[]): Set<string>;
+/** Circle diameters: big enough for a kind label and three lines of name. */
+export declare const KNOWLEDGE_SCOPE_SIZE = 124;
+export declare const KNOWLEDGE_PAGE_SIZE = 108;
+export type PageFlowNode = Node<{
+    page: KnowledgePagePayload;
+    size: number;
+    selected: boolean;
+}>;
+export type PageFlowEdge = Edge<{
+    kind: KnowledgePageEdge['kind'];
+    count: number;
+    role?: KnowledgePageEdge['role'];
+}>;
+/** Converts pages and their edges to React Flow elements; positions are left to the layout. */
+export declare function toPageFlow(pages: KnowledgePagePayload[], edges: KnowledgePageEdge[], selectedId?: string | null): {
+    nodes: PageFlowNode[];
+    edges: PageFlowEdge[];
+};

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

@@ -0,0 +1,24 @@
+import type { LayoutEdgeInput } from './layout';
+type Point = {
+    x: number;
+    y: number;
+};
+export interface PageLayout {
+    /** Node ids, sizes and edges the positions were solved for. */
+    key: string;
+    positions: Map<string, Point>;
+}
+/**
+ * Lays out the page graph, reusing the previous layout. The same nodes and
+ * edges return the previous positions as they are, so a refetch or live update
+ * that changes nothing in the graph never moves a node or re-runs the solve.
+ * When most nodes were already placed, they start where they sat, new pages
+ * start beside a placed neighbour, and a short run only pushes apart pages that
+ * overlap, so the rest stay put.
+ * Otherwise the layout is solved from the deterministic cold start.
+ */
+export declare function layoutPageGraph(previous: PageLayout | undefined, nodes: {
+    id: string;
+    size: number;
+}[], edges: LayoutEdgeInput[]): PageLayout;
+export {};

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

@@ -0,0 +1,28 @@
+/**
+ * Pure page-tree logic for the schema-4 explorer: loaded pages → a sorted
+ * tree, the visible rows for a set of expanded ids, and the ancestor path
+ * that must open to reveal a selection. Free of React so it unit-tests alone.
+ */
+import type { KnowledgePagePayload } from '../pageTypes';
+export interface KnowledgePageTreeNode {
+    page: KnowledgePagePayload;
+    children: KnowledgePageTreeNode[];
+}
+export interface KnowledgePageTreeRow {
+    page: KnowledgePagePayload;
+    depth: number;
+    hasChildren: boolean;
+    expanded: boolean;
+}
+/** Sibling order: position by UTF-16 code unit (as the store defines it), then id. */
+export declare function comparePagePosition(a: KnowledgePagePayload, b: KnowledgePagePayload): number;
+/**
+ * Builds the tree from whatever pages are loaded. A page whose parent isn't
+ * loaded (or is deleted/merged) becomes a root, and so does the first page (in
+ * sibling order) of any parent cycle, so no loaded live page is ever lost.
+ */
+export declare function buildPageTree(pages: KnowledgePagePayload[]): KnowledgePageTreeNode[];
+/** Depth-first rows for rendering, descending only into expanded pages. */
+export declare function visiblePageRows(roots: KnowledgePageTreeNode[], expanded: ReadonlySet<string>): KnowledgePageTreeRow[];
+/** Ids from the root down to (not including) `pageId`; stops at unloaded parents and cycles. */
+export declare function pageAncestorIds(pages: KnowledgePagePayload[], pageId: string): string[];

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

@@ -0,0 +1,12 @@
+import type { CSSProperties } from 'react';
+/** Opens below the click, or above it when the click is in the lower half, never taller than the room on that side. */
+export declare function mentionPopupPlacement({ point, pane, }: {
+    point: {
+        x: number;
+        y: number;
+    };
+    pane: {
+        width: number;
+        height: number;
+    };
+}): CSSProperties;

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

@@ -0,0 +1,9 @@
+/** Split knowledge record text into plain-text and [[wikilink]] segments for rendering. */
+export type RecordSegment = {
+    type: 'text';
+    value: string;
+} | {
+    type: 'wikilink';
+    value: string;
+};
+export declare function parseRecordSegments(text: string): RecordSegment[];