@truefoundry/trueforge-core 0.0.0 → 0.1.0-rc.0

package/dist/core/capabilities/builtins/LargeToolResponse.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/core/capabilities/builtins/LargeToolResponse.ts"],"sourcesContent":["import dedent from 'dedent';\nimport type { Logger } from 'winston';\nimport { estimateTokensForString } from '../../llm/usage';\nimport type { ToolCallResult } from '../../mcp/executeToolCalls';\nimport type { Sandbox, SandboxInfo } from '../../sandbox/Sandbox';\nimport { createSandboxLargeToolResponseGuidance, SANDBOX_SCHEMA_INFER_TAG } from '../../sandbox/Sandbox';\nimport { extractErrorLogFields } from '../../util/errorLogFields';\nimport type { AgentCapability } from '../AgentCapability';\nimport type { AgentThreadExecutionContext } from '../AgentContextProcessor';\nimport type { ToolResponseProcessor, ToolResponseProcessorResult } from '../ToolResponseProcessor';\nimport { createDynamicSubAgentLargeToolResponseGuidance } from './DynamicSubAgents';\n\nexport const DEFAULT_INDIVIDUAL_TOOL_TOKEN_THRESHOLD = 6000;\nexport const DEFAULT_TOTAL_TOOL_TOKEN_THRESHOLD = 10000;\nexport const DEFAULT_PREVIEW_NUMBER_OF_CHARACTERS = 100;\nconst FAILURE_MESSAGE_TRUNCATION_LENGTH = 500;\n\ntype ResultCategory = 'failure' | 'sandbox' | 'mcp';\n\ninterface ToolResultWithInfo {\n  toolCallResult: ToolCallResult;\n  originalContent: string;\n  originalTokens: number;\n  category: ResultCategory;\n}\n\nfunction categorize(result: ToolCallResult, sandbox: Sandbox | undefined): ResultCategory {\n  if (result.failure) return 'failure';\n  if (!result.info) {\n    throw new Error(`Unreachable`);\n  }\n  if (sandbox && result.info.toolSet === sandbox) return 'sandbox';\n  return 'mcp';\n}\n\nfunction createContentPreview(content: string, previewChars: number): string {\n  if (content.length <= previewChars * 2) {\n    return content;\n  }\n  return `${content.slice(0, previewChars)}\\n...\\n${content.slice(-previewChars)}`;\n}\n\nexport class LargeToolResponseProcessor implements ToolResponseProcessor {\n  private dynamicSubAgentsPresent: boolean;\n  private individualTokenThreshold: number;\n  private totalTokenThreshold: number;\n  private previewNumberOfCharacters: number;\n  private readonly logger: Logger;\n\n  constructor(param: {\n    dynamicSubAgentsPresent: boolean;\n    individualTokenThreshold: number;\n    totalTokenThreshold: number;\n    previewNumberOfCharacters: number;\n    logger: Logger;\n  }) {\n    if (param.individualTokenThreshold > param.totalTokenThreshold) {\n      throw new Error(\n        `individualTokenThreshold (${String(param.individualTokenThreshold)}) must be <= totalTokenThreshold (${String(param.totalTokenThreshold)})`,\n      );\n    }\n    this.dynamicSubAgentsPresent = param.dynamicSubAgentsPresent;\n    this.individualTokenThreshold = param.individualTokenThreshold;\n    this.totalTokenThreshold = param.totalTokenThreshold;\n    this.previewNumberOfCharacters = param.previewNumberOfCharacters;\n    this.logger = param.logger.child({ module: 'LargeToolResponse' });\n  }\n\n  private createLargeToolResponseGuidance(sandbox: Sandbox | undefined): string {\n    const steps = ['Check if some parameter can be passed in order to reduce the output size.'];\n\n    if (sandbox) {\n      steps.push(createSandboxLargeToolResponseGuidance());\n    }\n\n    if (this.dynamicSubAgentsPresent) {\n      steps.push(createDynamicSubAgentLargeToolResponseGuidance());\n    }\n\n    return `Content too big. To handle a large tool call the Agent can do the following:\\n${steps\n      .map((step, index) => `${String(index + 1)}. ${step}`)\n      .join('\\n')}`;\n  }\n\n  private createFileDumpMessage(params: { filePath: string; preview: string }): string {\n    const { filePath, preview } = params;\n    const steps: string[] = [\n      dedent`Use sandbox to read parts of the file or extract data.\n      Use ${SANDBOX_SCHEMA_INFER_TAG} to undertand the schema.`,\n    ];\n\n    if (this.dynamicSubAgentsPresent) {\n      steps.push(\n        `${createDynamicSubAgentLargeToolResponseGuidance()} The Agent must pass file path to sub-agent also.`,\n      );\n    }\n\n    const guidance = `The Agent can do the following to handle it:\\n${steps\n      .map((step, index) => `${String(index + 1)}. ${step}`)\n      .join('\\n')}`;\n\n    return `Content too large. Result saved to: ${filePath}.\\n\\n${guidance}\\n\\nPreview (first and last ${String(this.previewNumberOfCharacters)} chars):\\n${preview}`;\n  }\n\n  private buildResultsWithInfo(results: ToolCallResult[], sandbox: Sandbox | undefined): ToolResultWithInfo[] {\n    return results.map(toolCallResult => ({\n      toolCallResult,\n      originalContent: toolCallResult.message.content,\n      originalTokens: estimateTokensForString(toolCallResult.message.content),\n      category: categorize(toolCallResult, sandbox),\n    }));\n  }\n\n  private blockResult(\n    entry: ToolResultWithInfo,\n    pendingSandboxDumps: ToolResultWithInfo[],\n    sandbox: Sandbox | undefined,\n  ): number {\n    const preview = createContentPreview(entry.originalContent, this.previewNumberOfCharacters);\n\n    let newContent: string;\n    switch (entry.category) {\n      case 'failure':\n        newContent = entry.originalContent.slice(0, FAILURE_MESSAGE_TRUNCATION_LENGTH);\n        break;\n      case 'sandbox':\n        newContent = `Content too big. The Agent should write to a file if required and use grep and sed.\\n\\nPreview:\\n${preview}`;\n        break;\n      case 'mcp':\n        newContent = `${this.createLargeToolResponseGuidance(sandbox)}\\n\\nPreview (first and last ${String(this.previewNumberOfCharacters)} chars):\\n${preview}`;\n        if (sandbox) {\n          pendingSandboxDumps.push(entry);\n        }\n        break;\n    }\n\n    entry.toolCallResult.message.content = newContent;\n    entry.toolCallResult.isStructuredContent = false;\n    return Math.max(0, entry.originalTokens - estimateTokensForString(newContent));\n  }\n\n  private async uploadToSandboxAndPrependFilePath(\n    entry: ToolResultWithInfo,\n    index: number,\n    sandbox: Sandbox,\n  ): Promise<SandboxInfo | undefined> {\n    if (!entry.toolCallResult.info) {\n      throw new Error(`Unreachable`);\n    }\n    const sanitizedName = entry.toolCallResult.info.originalToolName.replace(/[^a-zA-Z0-9_-]/g, '_').slice(0, 40);\n    const epoch = Date.now();\n    const fileName = `${sanitizedName}_${String(index)}_${String(epoch)}.txt`;\n    try {\n      const stored = await sandbox.writeArtifact({\n        fileName,\n        content: Buffer.from(entry.originalContent),\n        sourceTool: entry.toolCallResult.info,\n      });\n      const preview = createContentPreview(entry.originalContent, this.previewNumberOfCharacters);\n      entry.toolCallResult.message.content = this.createFileDumpMessage({ filePath: stored.filePath, preview });\n      entry.toolCallResult.isStructuredContent = false;\n      return stored.sandboxCreated;\n    } catch (error) {\n      this.logger.error('Failed to upload to sandbox', extractErrorLogFields(error));\n      return undefined;\n    }\n  }\n\n  private async executeSandboxDumps(entries: ToolResultWithInfo[], sandbox: Sandbox): Promise<SandboxInfo | undefined> {\n    const results = await Promise.all(\n      entries.map((entry, index) => this.uploadToSandboxAndPrependFilePath(entry, index, sandbox)),\n    );\n    return results.find(r => r !== undefined);\n  }\n\n  async process(\n    results: ToolCallResult[],\n    execution: Readonly<AgentThreadExecutionContext>,\n  ): Promise<ToolResponseProcessorResult> {\n    const sandbox = execution.sandbox;\n    const resultsWithInfo = this.buildResultsWithInfo(results, sandbox);\n    let runningTotal = resultsWithInfo.reduce((sum, e) => sum + e.originalTokens, 0);\n\n    if (runningTotal < this.individualTokenThreshold) {\n      return {};\n    }\n\n    const pendingSandboxDumps: ToolResultWithInfo[] = [];\n\n    const unblocked: ToolResultWithInfo[] = [];\n    for (const entry of resultsWithInfo) {\n      if (entry.originalTokens >= this.individualTokenThreshold) {\n        runningTotal -= this.blockResult(entry, pendingSandboxDumps, sandbox);\n      } else {\n        unblocked.push(entry);\n      }\n    }\n\n    const sortedUnblocked = [...unblocked].sort((a, b) => b.originalTokens - a.originalTokens);\n    for (const entry of sortedUnblocked) {\n      if (runningTotal < this.totalTokenThreshold) {\n        break;\n      }\n      runningTotal -= this.blockResult(entry, pendingSandboxDumps, sandbox);\n    }\n\n    const sandboxCreated = sandbox ? await this.executeSandboxDumps(pendingSandboxDumps, sandbox) : undefined;\n    return sandboxCreated !== undefined ? { sandboxCreated } : {};\n  }\n}\n\nexport interface LargeToolResponseSettings {\n  individualTokenThreshold?: number | undefined;\n  totalTokenThreshold?: number | undefined;\n  previewNumberOfCharacters?: number | undefined;\n}\n\nexport function largeToolResponse(options: {\n  dynamicSubAgentsPresent: boolean;\n  settings?: LargeToolResponseSettings | undefined;\n  logger: Logger;\n}): AgentCapability {\n  return {\n    toolResponseProcessors: [\n      new LargeToolResponseProcessor({\n        dynamicSubAgentsPresent: options.dynamicSubAgentsPresent,\n        individualTokenThreshold: options.settings?.individualTokenThreshold ?? DEFAULT_INDIVIDUAL_TOOL_TOKEN_THRESHOLD,\n        totalTokenThreshold: options.settings?.totalTokenThreshold ?? DEFAULT_TOTAL_TOOL_TOKEN_THRESHOLD,\n        previewNumberOfCharacters: options.settings?.previewNumberOfCharacters ?? DEFAULT_PREVIEW_NUMBER_OF_CHARACTERS,\n        logger: options.logger,\n      }),\n    ],\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/core/capabilities/builtins/OpenUI.d.ts

@@ -0,0 +1,31 @@
+import { InstructionBuilder } from '../../InstructionBuilder';
+import { LocalToolMCP, type ToolDefinition } from '../../mcp/LocalToolMCP';
+import type { AgentTracing } from '../../tracing/AgentTracing';
+import type { AgentCapability } from '../AgentCapability';
+export declare const OPENUI_SERVER_ID = "openui";
+export declare const GET_OPENUI_INSTRUCTIONS_TOOL_NAME = "get_openui_instructions";
+export declare const OPENUI_SECTION_TAG = "openui";
+export declare const OPENUI_MARKDOWN_FENCING_TAG = "openui-markdown-fencing";
+export declare const OPENUI_SYNTAX_RULES_TAG = "openui-syntax-rules";
+export declare const OPENUI_COMPONENT_SIGNATURES_TAG = "openui-component-signatures";
+export declare const OPENUI_BUILTIN_FUNCTIONS_TAG = "openui-builtin-functions";
+export declare const OPENUI_HOISTING_AND_STREAMING_TAG = "openui-hoisting-and-streaming";
+export declare const OPENUI_EXAMPLES_TAG = "openui-examples";
+export declare const OPENUI_IMPORTANT_RULES_TAG = "openui-important-rules";
+export declare const OPENUI_FINAL_VERIFICATION_TAG = "openui-final-verification";
+export declare const OPENUI_USER_INTERACTION_CHECKLIST_TAG = "openui-user-interaction-checklist";
+export declare function buildOpenUIInstruction(builder: InstructionBuilder): void;
+/** Renders the existing OpenUI prompt tree without duplicating section bodies. */
+export declare function renderOpenUIPrompt(): string;
+export declare class OpenUIInstructions extends LocalToolMCP {
+    readonly name = "openui";
+    readonly displayName = "OpenUI";
+    constructor(tracing: AgentTracing);
+    private tools;
+    protected getTools(): ToolDefinition[];
+}
+export declare function openUI(options?: {
+    preload?: boolean;
+    tracing?: AgentTracing;
+}): AgentCapability;
+//# sourceMappingURL=OpenUI.d.ts.map

package/dist/core/capabilities/builtins/OpenUI.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenUI.d.ts","sourceRoot":"","sources":["../../../../src/core/capabilities/builtins/OpenUI.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,EAAc,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACvF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,eAAO,MAAM,gBAAgB,WAAW,CAAC;AACzC,eAAO,MAAM,iCAAiC,4BAA4B,CAAC;AAI3E,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAC3C,eAAO,MAAM,2BAA2B,4BAA4B,CAAC;AACrE,eAAO,MAAM,uBAAuB,wBAAwB,CAAC;AAC7D,eAAO,MAAM,+BAA+B,gCAAgC,CAAC;AAC7E,eAAO,MAAM,4BAA4B,6BAA6B,CAAC;AACvE,eAAO,MAAM,iCAAiC,kCAAkC,CAAC;AACjF,eAAO,MAAM,mBAAmB,oBAAoB,CAAC;AACrD,eAAO,MAAM,0BAA0B,2BAA2B,CAAC;AACnE,eAAO,MAAM,6BAA6B,8BAA8B,CAAC;AACzE,eAAO,MAAM,qCAAqC,sCAAsC,CAAC;AAEzF,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CA4OxE;AAED,kFAAkF;AAClF,wBAAgB,kBAAkB,IAAI,MAAM,CAY3C;AAgBD,qBAAa,kBAAmB,SAAQ,YAAY;IAClD,QAAQ,CAAC,IAAI,YAAoB;IACjC,QAAQ,CAAC,WAAW,YAAY;IAEhC,YAAY,OAAO,EAAE,YAAY,EAEhC;IAED,OAAO,CAAC,KAAK,CAUX;IAEF,SAAS,CAAC,QAAQ,IAAI,cAAc,EAAE,CAErC;CACF;AAED,wBAAgB,MAAM,CAAC,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,YAAY,CAAA;CAAE,GAAG,eAAe,CAW/F"}

package/dist/core/capabilities/builtins/OpenUI.js

@@ -0,0 +1,376 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/core/capabilities/builtins/OpenUI.ts
+var OpenUI_exports = {};
+__export(OpenUI_exports, {
+  GET_OPENUI_INSTRUCTIONS_TOOL_NAME: () => GET_OPENUI_INSTRUCTIONS_TOOL_NAME,
+  OPENUI_BUILTIN_FUNCTIONS_TAG: () => OPENUI_BUILTIN_FUNCTIONS_TAG,
+  OPENUI_COMPONENT_SIGNATURES_TAG: () => OPENUI_COMPONENT_SIGNATURES_TAG,
+  OPENUI_EXAMPLES_TAG: () => OPENUI_EXAMPLES_TAG,
+  OPENUI_FINAL_VERIFICATION_TAG: () => OPENUI_FINAL_VERIFICATION_TAG,
+  OPENUI_HOISTING_AND_STREAMING_TAG: () => OPENUI_HOISTING_AND_STREAMING_TAG,
+  OPENUI_IMPORTANT_RULES_TAG: () => OPENUI_IMPORTANT_RULES_TAG,
+  OPENUI_MARKDOWN_FENCING_TAG: () => OPENUI_MARKDOWN_FENCING_TAG,
+  OPENUI_SECTION_TAG: () => OPENUI_SECTION_TAG,
+  OPENUI_SERVER_ID: () => OPENUI_SERVER_ID,
+  OPENUI_SYNTAX_RULES_TAG: () => OPENUI_SYNTAX_RULES_TAG,
+  OPENUI_USER_INTERACTION_CHECKLIST_TAG: () => OPENUI_USER_INTERACTION_CHECKLIST_TAG,
+  OpenUIInstructions: () => OpenUIInstructions,
+  buildOpenUIInstruction: () => buildOpenUIInstruction,
+  openUI: () => openUI,
+  renderOpenUIPrompt: () => renderOpenUIPrompt
+});
+module.exports = __toCommonJS(OpenUI_exports);
+var import_dedent = __toESM(require("dedent"), 1);
+var import_zod = require("zod");
+var import_InstructionBuilder = require("../../InstructionBuilder.js");
+var import_IMCPServer = require("../../mcp/IMCPServer.js");
+var import_LocalToolMCP = require("../../mcp/LocalToolMCP.js");
+var import_NoopAgentTracing = require("../../tracing/NoopAgentTracing.js");
+var OPENUI_SERVER_ID = "openui";
+var GET_OPENUI_INSTRUCTIONS_TOOL_NAME = "get_openui_instructions";
+var getOpenUIInstructionsInputSchema = import_zod.z.object({}).strict();
+var OPENUI_SECTION_TAG = "openui";
+var OPENUI_MARKDOWN_FENCING_TAG = "openui-markdown-fencing";
+var OPENUI_SYNTAX_RULES_TAG = "openui-syntax-rules";
+var OPENUI_COMPONENT_SIGNATURES_TAG = "openui-component-signatures";
+var OPENUI_BUILTIN_FUNCTIONS_TAG = "openui-builtin-functions";
+var OPENUI_HOISTING_AND_STREAMING_TAG = "openui-hoisting-and-streaming";
+var OPENUI_EXAMPLES_TAG = "openui-examples";
+var OPENUI_IMPORTANT_RULES_TAG = "openui-important-rules";
+var OPENUI_FINAL_VERIFICATION_TAG = "openui-final-verification";
+var OPENUI_USER_INTERACTION_CHECKLIST_TAG = "openui-user-interaction-checklist";
+function buildOpenUIInstruction(builder) {
+  const openui = builder.beginSection(OPENUI_SECTION_TAG);
+  openui.addSection(
+    OPENUI_MARKDOWN_FENCING_TAG,
+    import_dedent.default`
+      All openui, code must be fenced within openui block.
+      \`\`\`openui
+      code
+      \`\`\``
+  );
+  openui.addSection(
+    OPENUI_SYNTAX_RULES_TAG,
+    import_dedent.default`
+      1. Each statement is on its own line: \`identifier = Expression\`
+      2. \`root\` is the entry point — every program must define \`root = Stack(...)\`
+      3. Expressions are: strings ("..."), numbers, booleans (true/false), null, arrays ([...]), objects ({...}), or component calls TypeName(arg1, arg2, ...)
+      4. Use references for readability: define \`name = ...\` on one line, then use \`name\` later
+      5. EVERY variable (except root) MUST be referenced by at least one other variable. Unreferenced variables are silently dropped and will NOT render. Always include defined variables in their parent's children/items array.
+      6. Arguments are POSITIONAL (order matters, not names). Write \`Stack([children], "row", "l")\` NOT \`Stack([children], direction: "row", gap: "l")\` — colon syntax is NOT supported and silently breaks
+      7. Optional arguments can be omitted from the end
+      - Strings use double quotes with backslash escaping`
+  );
+  openui.addSection(
+    OPENUI_COMPONENT_SIGNATURES_TAG,
+    import_dedent.default`
+      Arguments marked with ? are optional. Sub-components can be inline or referenced; prefer references for better streaming.
+      Props typed \`ActionExpression\` accept an Action([@steps...]) expression. See the Action section for available steps (@ToAssistant, @OpenUrl).
+      Props marked \`$binding<type>\` accept a \`$variable\` reference for two-way binding.
+
+      Layout:
+      Stack([children], direction?: "row" | "column", gap?: "none" | "xs" | "s" | "m" | "l" | "xl" | "2xl", align?: "start" | "center" | "end" | "stretch" | "baseline", justify?: "start" | "center" | "end" | "between" | "around" | "evenly", wrap?: boolean) — Flex container. direction: "row"|"column" (default "column"). gap: "none"|"xs"|"s"|"m"|"l"|"xl"|"2xl" (default "m"). align: "start"|"center"|"end"|"stretch"|"baseline". justify: "start"|"center"|"end"|"between"|"around"|"evenly".
+      Tabs(items: TabItem[]) — Tabbed container
+      TabItem(value: string, trigger: string, content: (TextContent | MarkDownRenderer | CardHeader | Callout | TextCallout | CodeBlock | Image | ImageBlock | ImageGallery | Separator | HorizontalBarChart | RadarChart | PieChart | RadialChart | SingleStackedBarChart | ScatterChart | AreaChart | BarChart | LineChart | Table | TagBlock | Form | Buttons | Steps)[]) — value is unique id, trigger is tab label, content is array of components
+      Accordion(items: AccordionItem[]) — Collapsible sections
+      AccordionItem(value: string, trigger: string, content: (TextContent | MarkDownRenderer | CardHeader | Callout | TextCallout | CodeBlock | Image | ImageBlock | ImageGallery | Separator | HorizontalBarChart | RadarChart | PieChart | RadialChart | SingleStackedBarChart | ScatterChart | AreaChart | BarChart | LineChart | Table | TagBlock | Form | Buttons | Steps)[]) — value is unique id, trigger is section title
+      Steps(items: StepsItem[]) — Step-by-step guide
+      StepsItem(title: string, details: string) — title and details text for one step
+      Carousel(children: (TextContent | MarkDownRenderer | CardHeader | Callout | TextCallout | CodeBlock | Image | ImageBlock | ImageGallery | Separator | HorizontalBarChart | RadarChart | PieChart | RadialChart | SingleStackedBarChart | ScatterChart | AreaChart | BarChart | LineChart | Table | TagBlock | Form | Buttons | Steps)[][], variant?: "card" | "sunk") — Horizontal scrollable carousel
+      Separator(orientation?: "horizontal" | "vertical", decorative?: boolean) — Visual divider between content sections
+      Modal(title: string, open?: $binding<boolean>, children: (TextContent | MarkDownRenderer | CardHeader | Callout | TextCallout | CodeBlock | Image | ImageBlock | ImageGallery | Separator | HorizontalBarChart | RadarChart | PieChart | RadialChart | SingleStackedBarChart | ScatterChart | AreaChart | BarChart | LineChart | Table | TagBlock | Form | Buttons | Steps)[], size?: "sm" | "md" | "lg") — Modal dialog. open is a reactive $boolean binding — set to true to open, X/Escape/backdrop auto-closes. Put Form with buttons inside children.
+      - For grid-like layouts, use Stack with direction "row" and wrap set to true.
+      - Prefer justify "start" (or omit justify) with wrap=true for stable columns instead of uneven gutters.
+      - Use nested Stacks when you need explicit rows/sections.
+      - Show/hide sections: $editId != "" ? Card([editForm]) : null
+      - Modal: Modal("Title", $showModal, [content]) — $showModal is boolean, X/Escape auto-closes. Put Form with its own buttons inside children.
+      - Use Tabs for alternative views (chart types, data sections) — no $variable needed
+      - Shared filter across Tabs: same $days binding in Query args works across all TabItems
+
+      Content:
+      Card(children: (TextContent | MarkDownRenderer | CardHeader | Callout | TextCallout | CodeBlock | Image | ImageBlock | ImageGallery | Separator | HorizontalBarChart | RadarChart | PieChart | RadialChart | SingleStackedBarChart | ScatterChart | AreaChart | BarChart | LineChart | Table | TagBlock | Form | Buttons | Steps | Tabs | Carousel | Stack)[], variant?: "card" | "sunk" | "clear", direction?: "row" | "column", gap?: "none" | "xs" | "s" | "m" | "l" | "xl" | "2xl", align?: "start" | "center" | "end" | "stretch" | "baseline", justify?: "start" | "center" | "end" | "between" | "around" | "evenly", wrap?: boolean) — Styled container. variant: "card" (default, elevated) | "sunk" (recessed) | "clear" (transparent). Always full width. Accepts all Stack flex params (default: direction "column"). Cards flex to share space in row/wrap layouts.
+      CardHeader(title?: string, subtitle?: string) — Header with optional title and subtitle
+      TextContent(text: string, size?: "small" | "default" | "large" | "small-heavy" | "large-heavy") — Text block. Supports markdown. Optional size: "small" | "default" | "large" | "small-heavy" | "large-heavy".
+      MarkDownRenderer(textMarkdown: string, variant?: "clear" | "card" | "sunk") — Renders markdown text with optional container variant
+      Callout(variant: "info" | "warning" | "error" | "success" | "neutral", title: string, description: string, visible?: $binding<boolean>) — Callout banner. Optional visible is a reactive $boolean — auto-dismisses after 3s by setting $visible to false.
+      TextCallout(variant?: "neutral" | "info" | "warning" | "success" | "danger", title?: string, description?: string) — Text callout with variant, title, and description
+      Image(alt: string, src?: string) — Image with alt text and optional URL
+      ImageBlock(src: string, alt?: string) — Image block with loading state
+      ImageGallery(images: {src: string, alt?: string, details?: string}[]) — Gallery grid of images with modal preview
+      CodeBlock(language: string, codeString: string) — Syntax-highlighted code block
+      - Use Cards to group related KPIs or sections. Stack with direction "row" for side-by-side layouts.
+      - Success toast: Callout("success", "Saved", "Done.", $showSuccess) — use @Set($showSuccess, true) in save action, auto-dismisses after 3s. For errors: result.status == "error" ? Callout("error", "Failed", result.error) : null
+      - KPI card: Card([TextContent("Label", "small"), TextContent("" + @Count(@Filter(data.rows, "field", "==", "value")), "large-heavy")])
+
+      Tables:
+      Table(columns: Col[]) — Data table — column-oriented. Each Col holds its own data array.
+      Col(label: string, data, type?: "string" | "number" | "action") — Column definition — holds label + data array
+      - Table is COLUMN-oriented: Table([Col("Label", dataArray), Col("Count", countArray, "number")]). Use array pluck for data: data.rows.fieldName
+      - Col data can be component arrays for styled cells: Col("Status", @Each(data.rows, "item", Tag(item.status, null, "sm", item.status == "open" ? "success" : "danger")))
+      - Row actions: Col("Actions", @Each(data.rows, "t", Button("Edit", Action([@Set($showEdit, true), @Set($editId, t.id)]))))
+      - Sortable: sorted = @Sort(data.rows, $sortField, "desc"). Bind $sortField to Select. Use sorted.fieldName for Col data
+      - Searchable: filtered = @Filter(data.rows, "title", "contains", $search). Bind $search to Input
+      - Chain sort + filter: filtered = @Filter(...) then sorted = @Sort(filtered, ...) — use sorted for both Table and Charts
+      - Empty state: @Count(data.rows) > 0 ? Table([...]) : TextContent("No data yet")
+
+      Charts (2D):
+      BarChart(labels: string[], series: Series[], variant?: "grouped" | "stacked", xLabel?: string, yLabel?: string) — Vertical bars; use for comparing values across categories with one or more series
+      LineChart(labels: string[], series: Series[], variant?: "linear" | "natural" | "step", xLabel?: string, yLabel?: string) — Lines over categories; use for trends and continuous data over time
+      AreaChart(labels: string[], series: Series[], variant?: "linear" | "natural" | "step", xLabel?: string, yLabel?: string) — Filled area under lines; use for cumulative totals or volume trends over time
+      RadarChart(labels: string[], series: Series[]) — Spider/web chart; use for comparing multiple variables across one or more entities
+      HorizontalBarChart(labels: string[], series: Series[], variant?: "grouped" | "stacked", xLabel?: string, yLabel?: string) — Horizontal bars; prefer when category labels are long or for ranked lists
+      Series(category: string, values: number[]) — One data series
+      - Charts accept column arrays: LineChart(labels, [Series("Name", values)]). Use array pluck: LineChart(data.rows.day, [Series("Views", data.rows.views)])
+      - Use Cards to wrap charts with CardHeader for titled sections
+      - Chart + Table from same source: use @Sort or @Filter result for both LineChart and Table Col data
+      - Multiple chart views: use Tabs — Tabs([TabItem("line", "Line", [LineChart(...)]), TabItem("bar", "Bar", [BarChart(...)])])
+
+      Charts (1D):
+      PieChart(labels: string[], values: number[], variant?: "pie" | "donut") — Circular slices; use plucked arrays: PieChart(data.categories, data.values)
+      RadialChart(labels: string[], values: number[]) — Radial bars; use plucked arrays: RadialChart(data.categories, data.values)
+      SingleStackedBarChart(labels: string[], values: number[]) — Single horizontal stacked bar; use plucked arrays: SingleStackedBarChart(data.categories, data.values)
+      Slice(category: string, value: number) — One slice with label and numeric value
+      - PieChart and BarChart need NUMBERS, not objects. For list data, use @Count(@Filter(...)) to aggregate:
+      - PieChart from list: \`PieChart(["Low", "Med", "High"], [@Count(@Filter(data.rows, "priority", "==", "low")), @Count(@Filter(data.rows, "priority", "==", "medium")), @Count(@Filter(data.rows, "priority", "==", "high"))], "donut")\`
+      - KPI from count: \`TextContent("" + @Count(@Filter(data.rows, "status", "==", "open")), "large-heavy")\`
+
+      Charts (Scatter):
+      ScatterChart(datasets: ScatterSeries[], xLabel?: string, yLabel?: string) — X/Y scatter plot; use for correlations, distributions, and clustering
+      ScatterSeries(name: string, points: Point[]) — Named dataset
+      Point(x: number, y: number, z?: number) — Data point with numeric coordinates
+
+      Data Display:
+      TagBlock(tags: string[]) — tags is an array of strings
+      Tag(text: string, icon?: string, size?: "sm" | "md" | "lg", variant?: "neutral" | "info" | "success" | "warning" | "danger") — Styled tag/badge with optional icon and variant
+      - Color-mapped Tag: Tag(value, null, "sm", value == "high" ? "danger" : value == "medium" ? "warning" : "neutral")`
+  );
+  openui.addSection(
+    OPENUI_BUILTIN_FUNCTIONS_TAG,
+    import_dedent.default`
+      Data functions prefixed with \`@\` to distinguish from components. These are the ONLY functions available — do NOT invent new ones.
+      Use @-prefixed built-in functions (@Count, @Sum, @Avg, @Min, @Max, @Round) on Query results — do NOT hardcode computed values.
+
+      @Count(array) → number — Returns array length
+      @First(array) → element — Returns first element of array
+      @Last(array) → element — Returns last element of array
+      @Sum(numbers[]) → number — Sum of numeric array
+      @Avg(numbers[]) → number — Average of numeric array
+      @Min(numbers[]) → number — Minimum value in array
+      @Max(numbers[]) → number — Maximum value in array
+      @Sort(array, field, direction?) → sorted array — Sort array by field. Direction: "asc" (default) or "desc"
+      @Filter(array, field, operator: "==" | "!=" | ">" | "<" | ">=" | "<=" | "contains", value) → filtered array — Filter array by field value
+      @Round(number, decimals?) → number — Round to N decimal places (default 0)
+      @Abs(number) → number — Absolute value
+      @Floor(number) → number — Round down to nearest integer
+      @Ceil(number) → number — Round up to nearest integer
+      @Each(array, varName, template) — Evaluate template for each element. varName is the loop variable — use it ONLY inside the template expression (inline). Do NOT create a separate statement for the template.
+
+      Builtins compose — output of one is input to the next:
+      \`@Count(@Filter(data.rows, "field", "==", "val"))\` for KPIs/chart values, \`@Round(@Avg(data.rows.score), 1)\`, \`@Each(data.rows, "item", Comp(item.field))\` for per-item rendering.
+      Array pluck: \`data.rows.field\` extracts a field from every row → use with @Sum, @Avg, charts, tables.
+
+      IMPORTANT @Each rule: The loop variable (e.g. "item") is ONLY available inside the @Each template expression. Always inline the template — do NOT extract it to a separate statement.
+      CORRECT: \`Col("Actions", @Each(rows, "t", Button("Edit", Action([@Set($id, t.id)]))))\`
+      WRONG: \`myBtn = Button("Edit", Action([@Set($id, t.id)]))\` then \`Col("Actions", @Each(rows, "t", myBtn))\` — t is undefined in myBtn.`
+  );
+  openui.addSection(
+    OPENUI_HOISTING_AND_STREAMING_TAG,
+    import_dedent.default`
+      openui-lang supports hoisting: a reference can be used BEFORE it is defined. The parser resolves all references after the full input is parsed.
+
+      During streaming, the output is re-parsed on every chunk. Undefined references are temporarily unresolved and appear once their definitions stream in. This creates a progressive top-down reveal — structure first, then data fills in.
+
+      Recommended statement order for optimal streaming:
+      1. \`root = Stack(...)\` — UI shell appears immediately
+      2. $variable declarations — state ready for bindings
+      3. Query statements — defaults resolve immediately so components render with data
+      4. Component definitions — fill in with data already available
+      5. Data values — leaf content last
+
+      Always write the root = Stack(...) statement first so the UI shell appears immediately, even before child data has streamed in.`
+  );
+  openui.addSection(
+    OPENUI_EXAMPLES_TAG,
+    import_dedent.default`
+      Example 1 — Table (column-oriented):
+
+      root = Stack([title, tbl])
+      title = TextContent("Top Languages", "large-heavy")
+      tbl = Table([Col("Language", langs), Col("Users (M)", users), Col("Year", years)])
+      langs = ["Python", "JavaScript", "Java", "TypeScript", "Go"]
+      users = [15.7, 14.2, 12.1, 8.5, 5.2]
+      years = [1991, 1995, 1995, 2012, 2009]
+
+      Example 2 — Bar chart:
+
+      root = Stack([title, chart])
+      title = TextContent("Q4 Revenue", "large-heavy")
+      chart = BarChart(labels, [s1, s2], "grouped")
+      labels = ["Oct", "Nov", "Dec"]
+      s1 = Series("Product A", [120, 150, 180])
+      s2 = Series("Product B", [90, 110, 140])
+
+      Example 3 — Form with validation:
+
+      root = Stack([title, form])
+      title = TextContent("Contact Us", "large-heavy")
+      form = Form("contact", btns, [nameField, emailField, countryField, msgField])
+      nameField = FormControl("Name", Input("name", "Your name", "text", { required: true, minLength: 2 }))
+      emailField = FormControl("Email", Input("email", "you@example.com", "email", { required: true, email: true }))
+      countryField = FormControl("Country", Select("country", countryOpts, "Select...", { required: true }))
+      msgField = FormControl("Message", TextArea("message", "Tell us more...", 4, { required: true, minLength: 10 }))
+      countryOpts = [SelectItem("us", "United States"), SelectItem("uk", "United Kingdom"), SelectItem("de", "Germany")]
+      btns = Buttons([Button("Submit", Action([@ToAssistant("Submit")]), "primary"), Button("Cancel", Action([@ToAssistant("Cancel")]), "secondary")])
+
+      Example 4 — Tabs with mixed content:
+
+      root = Stack([title, tabs])
+      title = TextContent("React vs Vue", "large-heavy")
+      tabs = Tabs([tabReact, tabVue])
+      tabReact = TabItem("react", "React", reactContent)
+      tabVue = TabItem("vue", "Vue", vueContent)
+      reactContent = [TextContent("React is a library by Meta for building UIs."), Callout("info", "Note", "React uses JSX syntax.")]
+      vueContent = [TextContent("Vue is a progressive framework by Evan You."), Callout("success", "Tip", "Vue has a gentle learning curve.")]`
+  );
+  openui.addSection(
+    OPENUI_IMPORTANT_RULES_TAG,
+    import_dedent.default`
+      - When asked about data, generate realistic/plausible data
+      - Choose components that best represent the content (tables for comparisons, charts for trends, forms for input, etc.)
+      - When you render data in an openui block (tables, charts, KPI cards), do NOT repeat the same numbers/facts in the markdown text outside the block.
+      - Text outside the openui block can optionally include:
+        1. **Qualitative insights** — patterns, anomalies, or recommendations that aren't obvious from the visual (e.g. "the high input-to-output ratio suggests document processing")
+        2. **Actionable next steps** — what the user can do next
+        3. **Caveats/context** — things the data doesn't show
+      - If all the information is already visible in the openui components, a brief one-line summary is sufficient — do not enumerate the same values again.`
+  );
+  openui.addSection(
+    OPENUI_FINAL_VERIFICATION_TAG,
+    import_dedent.default`
+      Before finishing, walk your output and verify:
+      1. root = Stack(...) is the FIRST line (for optimal streaming).
+      2. Every referenced name is defined. Every defined name (other than root) is reachable from root.
+
+      - For grid-like layouts, use Stack with direction "row" and wrap=true. Avoid justify="between" unless you specifically want large gutters.
+      - For forms, define one FormControl reference per field so controls can stream progressively.
+      - For forms, always provide the second Form argument with Buttons(...) actions: Form(name, buttons, fields).
+      - Never nest Form inside Form.
+      - Use @Reset($var1, $var2) after form submit to restore defaults — not @Set($var, "")
+      - Multi-query refresh: Action([@Run(mutation), @Run(query1), @Run(query2), @Reset(...)])
+      - $variables are reactive: changing via Select or @Set re-evaluates all Queries and expressions referencing them
+      - Use existing components (Tabs, Accordion, Modal) before inventing ternary show/hide patterns`
+  );
+  openui.addSection(
+    OPENUI_USER_INTERACTION_CHECKLIST_TAG,
+    import_dedent.default`
+      1. Will the response be UI heavy and will contain components which are not supported by markdown? Use openui if the answer is yes.
+      2. \`\`\`openui\`\`\` fencing must be closed.`
+  );
+}
+function renderOpenUIPrompt() {
+  const root = new import_InstructionBuilder.InstructionBuilder("_openui_render");
+  buildOpenUIInstruction(root);
+  const wrapped = root.build();
+  const openTag = `<${OPENUI_SECTION_TAG}>`;
+  const closeTag = `</${OPENUI_SECTION_TAG}>`;
+  const start = wrapped.indexOf(openTag);
+  const end = wrapped.lastIndexOf(closeTag);
+  if (start === -1 || end === -1) {
+    throw new Error("Failed to render OpenUI prompt from buildOpenUIInstruction");
+  }
+  return wrapped.slice(start, end + closeTag.length);
+}
+function buildOpenUIDeferredInstruction(builder) {
+  builder.addSection(
+    OPENUI_SECTION_TAG,
+    import_dedent.default`
+      The Agent can render interactive UI that markdown cannot express by emitting a fenced \`\`\`openui block.
+
+      Before writing any \`\`\`openui fence, the Agent MUST call ${GET_OPENUI_INSTRUCTIONS_TOOL_NAME} with arguments {}.
+      Do not invent OpenUI syntax or component APIs without loading those instructions.
+
+      Use OpenUI only when the response is UI-heavy and needs components markdown does not support.
+    `.trim()
+  );
+}
+var OpenUIInstructions = class extends import_LocalToolMCP.LocalToolMCP {
+  name = OPENUI_SERVER_ID;
+  displayName = "OpenUI";
+  constructor(tracing) {
+    super({ tracing });
+  }
+  tools = [
+    (0, import_LocalToolMCP.defineTool)({
+      name: GET_OPENUI_INSTRUCTIONS_TOOL_NAME,
+      description: [
+        "Load the full OpenUI generative-UI authoring instructions (syntax, components, builtins, examples, rules).",
+        "Call this before emitting any ```openui fenced block. Pass an empty object as arguments: {}."
+      ].join(" "),
+      schema: getOpenUIInstructionsInputSchema,
+      handler: () => Promise.resolve((0, import_IMCPServer.toolResultResponse)({ text: renderOpenUIPrompt() }))
+    })
+  ];
+  getTools() {
+    return this.tools;
+  }
+};
+function openUI(options) {
+  const preload = options?.preload ?? true;
+  if (preload) {
+    return {
+      instructionBuilders: [buildOpenUIInstruction]
+    };
+  }
+  return {
+    systemToolSets: [new OpenUIInstructions(options?.tracing ?? import_NoopAgentTracing.NOOP_AGENT_TRACING)],
+    instructionBuilders: [buildOpenUIDeferredInstruction]
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  GET_OPENUI_INSTRUCTIONS_TOOL_NAME,
+  OPENUI_BUILTIN_FUNCTIONS_TAG,
+  OPENUI_COMPONENT_SIGNATURES_TAG,
+  OPENUI_EXAMPLES_TAG,
+  OPENUI_FINAL_VERIFICATION_TAG,
+  OPENUI_HOISTING_AND_STREAMING_TAG,
+  OPENUI_IMPORTANT_RULES_TAG,
+  OPENUI_MARKDOWN_FENCING_TAG,
+  OPENUI_SECTION_TAG,
+  OPENUI_SERVER_ID,
+  OPENUI_SYNTAX_RULES_TAG,
+  OPENUI_USER_INTERACTION_CHECKLIST_TAG,
+  OpenUIInstructions,
+  buildOpenUIInstruction,
+  openUI,
+  renderOpenUIPrompt
+});
+//# sourceMappingURL=OpenUI.js.map

package/dist/core/capabilities/builtins/OpenUI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/core/capabilities/builtins/OpenUI.ts"],"sourcesContent":["import dedent from 'dedent';\nimport { z } from 'zod';\nimport { InstructionBuilder } from '../../InstructionBuilder';\nimport { toolResultResponse } from '../../mcp/IMCPServer';\nimport { defineTool, LocalToolMCP, type ToolDefinition } from '../../mcp/LocalToolMCP';\nimport type { AgentTracing } from '../../tracing/AgentTracing';\nimport { NOOP_AGENT_TRACING } from '../../tracing/NoopAgentTracing';\nimport type { AgentCapability } from '../AgentCapability';\n\nexport const OPENUI_SERVER_ID = 'openui';\nexport const GET_OPENUI_INSTRUCTIONS_TOOL_NAME = 'get_openui_instructions';\n\nconst getOpenUIInstructionsInputSchema = z.object({}).strict();\n\nexport const OPENUI_SECTION_TAG = 'openui';\nexport const OPENUI_MARKDOWN_FENCING_TAG = 'openui-markdown-fencing';\nexport const OPENUI_SYNTAX_RULES_TAG = 'openui-syntax-rules';\nexport const OPENUI_COMPONENT_SIGNATURES_TAG = 'openui-component-signatures';\nexport const OPENUI_BUILTIN_FUNCTIONS_TAG = 'openui-builtin-functions';\nexport const OPENUI_HOISTING_AND_STREAMING_TAG = 'openui-hoisting-and-streaming';\nexport const OPENUI_EXAMPLES_TAG = 'openui-examples';\nexport const OPENUI_IMPORTANT_RULES_TAG = 'openui-important-rules';\nexport const OPENUI_FINAL_VERIFICATION_TAG = 'openui-final-verification';\nexport const OPENUI_USER_INTERACTION_CHECKLIST_TAG = 'openui-user-interaction-checklist';\n\nexport function buildOpenUIInstruction(builder: InstructionBuilder): void {\n  const openui = builder.beginSection(OPENUI_SECTION_TAG);\n\n  openui.addSection(\n    OPENUI_MARKDOWN_FENCING_TAG,\n    dedent`\n      All openui, code must be fenced within openui block.\n      \\`\\`\\`openui\n      code\n      \\`\\`\\``,\n  );\n\n  openui.addSection(\n    OPENUI_SYNTAX_RULES_TAG,\n    dedent`\n      1. Each statement is on its own line: \\`identifier = Expression\\`\n      2. \\`root\\` is the entry point — every program must define \\`root = Stack(...)\\`\n      3. Expressions are: strings (\"...\"), numbers, booleans (true/false), null, arrays ([...]), objects ({...}), or component calls TypeName(arg1, arg2, ...)\n      4. Use references for readability: define \\`name = ...\\` on one line, then use \\`name\\` later\n      5. EVERY variable (except root) MUST be referenced by at least one other variable. Unreferenced variables are silently dropped and will NOT render. Always include defined variables in their parent's children/items array.\n      6. Arguments are POSITIONAL (order matters, not names). Write \\`Stack([children], \"row\", \"l\")\\` NOT \\`Stack([children], direction: \"row\", gap: \"l\")\\` — colon syntax is NOT supported and silently breaks\n      7. Optional arguments can be omitted from the end\n      - Strings use double quotes with backslash escaping`,\n  );\n\n  openui.addSection(\n    OPENUI_COMPONENT_SIGNATURES_TAG,\n    dedent`\n      Arguments marked with ? are optional. Sub-components can be inline or referenced; prefer references for better streaming.\n      Props typed \\`ActionExpression\\` accept an Action([@steps...]) expression. See the Action section for available steps (@ToAssistant, @OpenUrl).\n      Props marked \\`$binding<type>\\` accept a \\`$variable\\` reference for two-way binding.\n\n      Layout:\n      Stack([children], direction?: \"row\" | \"column\", gap?: \"none\" | \"xs\" | \"s\" | \"m\" | \"l\" | \"xl\" | \"2xl\", align?: \"start\" | \"center\" | \"end\" | \"stretch\" | \"baseline\", justify?: \"start\" | \"center\" | \"end\" | \"between\" | \"around\" | \"evenly\", wrap?: boolean) — Flex container. direction: \"row\"|\"column\" (default \"column\"). gap: \"none\"|\"xs\"|\"s\"|\"m\"|\"l\"|\"xl\"|\"2xl\" (default \"m\"). align: \"start\"|\"center\"|\"end\"|\"stretch\"|\"baseline\". justify: \"start\"|\"center\"|\"end\"|\"between\"|\"around\"|\"evenly\".\n      Tabs(items: TabItem[]) — Tabbed container\n      TabItem(value: string, trigger: string, content: (TextContent | MarkDownRenderer | CardHeader | Callout | TextCallout | CodeBlock | Image | ImageBlock | ImageGallery | Separator | HorizontalBarChart | RadarChart | PieChart | RadialChart | SingleStackedBarChart | ScatterChart | AreaChart | BarChart | LineChart | Table | TagBlock | Form | Buttons | Steps)[]) — value is unique id, trigger is tab label, content is array of components\n      Accordion(items: AccordionItem[]) — Collapsible sections\n      AccordionItem(value: string, trigger: string, content: (TextContent | MarkDownRenderer | CardHeader | Callout | TextCallout | CodeBlock | Image | ImageBlock | ImageGallery | Separator | HorizontalBarChart | RadarChart | PieChart | RadialChart | SingleStackedBarChart | ScatterChart | AreaChart | BarChart | LineChart | Table | TagBlock | Form | Buttons | Steps)[]) — value is unique id, trigger is section title\n      Steps(items: StepsItem[]) — Step-by-step guide\n      StepsItem(title: string, details: string) — title and details text for one step\n      Carousel(children: (TextContent | MarkDownRenderer | CardHeader | Callout | TextCallout | CodeBlock | Image | ImageBlock | ImageGallery | Separator | HorizontalBarChart | RadarChart | PieChart | RadialChart | SingleStackedBarChart | ScatterChart | AreaChart | BarChart | LineChart | Table | TagBlock | Form | Buttons | Steps)[][], variant?: \"card\" | \"sunk\") — Horizontal scrollable carousel\n      Separator(orientation?: \"horizontal\" | \"vertical\", decorative?: boolean) — Visual divider between content sections\n      Modal(title: string, open?: $binding<boolean>, children: (TextContent | MarkDownRenderer | CardHeader | Callout | TextCallout | CodeBlock | Image | ImageBlock | ImageGallery | Separator | HorizontalBarChart | RadarChart | PieChart | RadialChart | SingleStackedBarChart | ScatterChart | AreaChart | BarChart | LineChart | Table | TagBlock | Form | Buttons | Steps)[], size?: \"sm\" | \"md\" | \"lg\") — Modal dialog. open is a reactive $boolean binding — set to true to open, X/Escape/backdrop auto-closes. Put Form with buttons inside children.\n      - For grid-like layouts, use Stack with direction \"row\" and wrap set to true.\n      - Prefer justify \"start\" (or omit justify) with wrap=true for stable columns instead of uneven gutters.\n      - Use nested Stacks when you need explicit rows/sections.\n      - Show/hide sections: $editId != \"\" ? Card([editForm]) : null\n      - Modal: Modal(\"Title\", $showModal, [content]) — $showModal is boolean, X/Escape auto-closes. Put Form with its own buttons inside children.\n      - Use Tabs for alternative views (chart types, data sections) — no $variable needed\n      - Shared filter across Tabs: same $days binding in Query args works across all TabItems\n\n      Content:\n      Card(children: (TextContent | MarkDownRenderer | CardHeader | Callout | TextCallout | CodeBlock | Image | ImageBlock | ImageGallery | Separator | HorizontalBarChart | RadarChart | PieChart | RadialChart | SingleStackedBarChart | ScatterChart | AreaChart | BarChart | LineChart | Table | TagBlock | Form | Buttons | Steps | Tabs | Carousel | Stack)[], variant?: \"card\" | \"sunk\" | \"clear\", direction?: \"row\" | \"column\", gap?: \"none\" | \"xs\" | \"s\" | \"m\" | \"l\" | \"xl\" | \"2xl\", align?: \"start\" | \"center\" | \"end\" | \"stretch\" | \"baseline\", justify?: \"start\" | \"center\" | \"end\" | \"between\" | \"around\" | \"evenly\", wrap?: boolean) — Styled container. variant: \"card\" (default, elevated) | \"sunk\" (recessed) | \"clear\" (transparent). Always full width. Accepts all Stack flex params (default: direction \"column\"). Cards flex to share space in row/wrap layouts.\n      CardHeader(title?: string, subtitle?: string) — Header with optional title and subtitle\n      TextContent(text: string, size?: \"small\" | \"default\" | \"large\" | \"small-heavy\" | \"large-heavy\") — Text block. Supports markdown. Optional size: \"small\" | \"default\" | \"large\" | \"small-heavy\" | \"large-heavy\".\n      MarkDownRenderer(textMarkdown: string, variant?: \"clear\" | \"card\" | \"sunk\") — Renders markdown text with optional container variant\n      Callout(variant: \"info\" | \"warning\" | \"error\" | \"success\" | \"neutral\", title: string, description: string, visible?: $binding<boolean>) — Callout banner. Optional visible is a reactive $boolean — auto-dismisses after 3s by setting $visible to false.\n      TextCallout(variant?: \"neutral\" | \"info\" | \"warning\" | \"success\" | \"danger\", title?: string, description?: string) — Text callout with variant, title, and description\n      Image(alt: string, src?: string) — Image with alt text and optional URL\n      ImageBlock(src: string, alt?: string) — Image block with loading state\n      ImageGallery(images: {src: string, alt?: string, details?: string}[]) — Gallery grid of images with modal preview\n      CodeBlock(language: string, codeString: string) — Syntax-highlighted code block\n      - Use Cards to group related KPIs or sections. Stack with direction \"row\" for side-by-side layouts.\n      - Success toast: Callout(\"success\", \"Saved\", \"Done.\", $showSuccess) — use @Set($showSuccess, true) in save action, auto-dismisses after 3s. For errors: result.status == \"error\" ? Callout(\"error\", \"Failed\", result.error) : null\n      - KPI card: Card([TextContent(\"Label\", \"small\"), TextContent(\"\" + @Count(@Filter(data.rows, \"field\", \"==\", \"value\")), \"large-heavy\")])\n\n      Tables:\n      Table(columns: Col[]) — Data table — column-oriented. Each Col holds its own data array.\n      Col(label: string, data, type?: \"string\" | \"number\" | \"action\") — Column definition — holds label + data array\n      - Table is COLUMN-oriented: Table([Col(\"Label\", dataArray), Col(\"Count\", countArray, \"number\")]). Use array pluck for data: data.rows.fieldName\n      - Col data can be component arrays for styled cells: Col(\"Status\", @Each(data.rows, \"item\", Tag(item.status, null, \"sm\", item.status == \"open\" ? \"success\" : \"danger\")))\n      - Row actions: Col(\"Actions\", @Each(data.rows, \"t\", Button(\"Edit\", Action([@Set($showEdit, true), @Set($editId, t.id)]))))\n      - Sortable: sorted = @Sort(data.rows, $sortField, \"desc\"). Bind $sortField to Select. Use sorted.fieldName for Col data\n      - Searchable: filtered = @Filter(data.rows, \"title\", \"contains\", $search). Bind $search to Input\n      - Chain sort + filter: filtered = @Filter(...) then sorted = @Sort(filtered, ...) — use sorted for both Table and Charts\n      - Empty state: @Count(data.rows) > 0 ? Table([...]) : TextContent(\"No data yet\")\n\n      Charts (2D):\n      BarChart(labels: string[], series: Series[], variant?: \"grouped\" | \"stacked\", xLabel?: string, yLabel?: string) — Vertical bars; use for comparing values across categories with one or more series\n      LineChart(labels: string[], series: Series[], variant?: \"linear\" | \"natural\" | \"step\", xLabel?: string, yLabel?: string) — Lines over categories; use for trends and continuous data over time\n      AreaChart(labels: string[], series: Series[], variant?: \"linear\" | \"natural\" | \"step\", xLabel?: string, yLabel?: string) — Filled area under lines; use for cumulative totals or volume trends over time\n      RadarChart(labels: string[], series: Series[]) — Spider/web chart; use for comparing multiple variables across one or more entities\n      HorizontalBarChart(labels: string[], series: Series[], variant?: \"grouped\" | \"stacked\", xLabel?: string, yLabel?: string) — Horizontal bars; prefer when category labels are long or for ranked lists\n      Series(category: string, values: number[]) — One data series\n      - Charts accept column arrays: LineChart(labels, [Series(\"Name\", values)]). Use array pluck: LineChart(data.rows.day, [Series(\"Views\", data.rows.views)])\n      - Use Cards to wrap charts with CardHeader for titled sections\n      - Chart + Table from same source: use @Sort or @Filter result for both LineChart and Table Col data\n      - Multiple chart views: use Tabs — Tabs([TabItem(\"line\", \"Line\", [LineChart(...)]), TabItem(\"bar\", \"Bar\", [BarChart(...)])])\n\n      Charts (1D):\n      PieChart(labels: string[], values: number[], variant?: \"pie\" | \"donut\") — Circular slices; use plucked arrays: PieChart(data.categories, data.values)\n      RadialChart(labels: string[], values: number[]) — Radial bars; use plucked arrays: RadialChart(data.categories, data.values)\n      SingleStackedBarChart(labels: string[], values: number[]) — Single horizontal stacked bar; use plucked arrays: SingleStackedBarChart(data.categories, data.values)\n      Slice(category: string, value: number) — One slice with label and numeric value\n      - PieChart and BarChart need NUMBERS, not objects. For list data, use @Count(@Filter(...)) to aggregate:\n      - PieChart from list: \\`PieChart([\"Low\", \"Med\", \"High\"], [@Count(@Filter(data.rows, \"priority\", \"==\", \"low\")), @Count(@Filter(data.rows, \"priority\", \"==\", \"medium\")), @Count(@Filter(data.rows, \"priority\", \"==\", \"high\"))], \"donut\")\\`\n      - KPI from count: \\`TextContent(\"\" + @Count(@Filter(data.rows, \"status\", \"==\", \"open\")), \"large-heavy\")\\`\n\n      Charts (Scatter):\n      ScatterChart(datasets: ScatterSeries[], xLabel?: string, yLabel?: string) — X/Y scatter plot; use for correlations, distributions, and clustering\n      ScatterSeries(name: string, points: Point[]) — Named dataset\n      Point(x: number, y: number, z?: number) — Data point with numeric coordinates\n\n      Data Display:\n      TagBlock(tags: string[]) — tags is an array of strings\n      Tag(text: string, icon?: string, size?: \"sm\" | \"md\" | \"lg\", variant?: \"neutral\" | \"info\" | \"success\" | \"warning\" | \"danger\") — Styled tag/badge with optional icon and variant\n      - Color-mapped Tag: Tag(value, null, \"sm\", value == \"high\" ? \"danger\" : value == \"medium\" ? \"warning\" : \"neutral\")`,\n  );\n\n  openui.addSection(\n    OPENUI_BUILTIN_FUNCTIONS_TAG,\n    dedent`\n      Data functions prefixed with \\`@\\` to distinguish from components. These are the ONLY functions available — do NOT invent new ones.\n      Use @-prefixed built-in functions (@Count, @Sum, @Avg, @Min, @Max, @Round) on Query results — do NOT hardcode computed values.\n\n      @Count(array) → number — Returns array length\n      @First(array) → element — Returns first element of array\n      @Last(array) → element — Returns last element of array\n      @Sum(numbers[]) → number — Sum of numeric array\n      @Avg(numbers[]) → number — Average of numeric array\n      @Min(numbers[]) → number — Minimum value in array\n      @Max(numbers[]) → number — Maximum value in array\n      @Sort(array, field, direction?) → sorted array — Sort array by field. Direction: \"asc\" (default) or \"desc\"\n      @Filter(array, field, operator: \"==\" | \"!=\" | \">\" | \"<\" | \">=\" | \"<=\" | \"contains\", value) → filtered array — Filter array by field value\n      @Round(number, decimals?) → number — Round to N decimal places (default 0)\n      @Abs(number) → number — Absolute value\n      @Floor(number) → number — Round down to nearest integer\n      @Ceil(number) → number — Round up to nearest integer\n      @Each(array, varName, template) — Evaluate template for each element. varName is the loop variable — use it ONLY inside the template expression (inline). Do NOT create a separate statement for the template.\n\n      Builtins compose — output of one is input to the next:\n      \\`@Count(@Filter(data.rows, \"field\", \"==\", \"val\"))\\` for KPIs/chart values, \\`@Round(@Avg(data.rows.score), 1)\\`, \\`@Each(data.rows, \"item\", Comp(item.field))\\` for per-item rendering.\n      Array pluck: \\`data.rows.field\\` extracts a field from every row → use with @Sum, @Avg, charts, tables.\n\n      IMPORTANT @Each rule: The loop variable (e.g. \"item\") is ONLY available inside the @Each template expression. Always inline the template — do NOT extract it to a separate statement.\n      CORRECT: \\`Col(\"Actions\", @Each(rows, \"t\", Button(\"Edit\", Action([@Set($id, t.id)]))))\\`\n      WRONG: \\`myBtn = Button(\"Edit\", Action([@Set($id, t.id)]))\\` then \\`Col(\"Actions\", @Each(rows, \"t\", myBtn))\\` — t is undefined in myBtn.`,\n  );\n\n  openui.addSection(\n    OPENUI_HOISTING_AND_STREAMING_TAG,\n    dedent`\n      openui-lang supports hoisting: a reference can be used BEFORE it is defined. The parser resolves all references after the full input is parsed.\n\n      During streaming, the output is re-parsed on every chunk. Undefined references are temporarily unresolved and appear once their definitions stream in. This creates a progressive top-down reveal — structure first, then data fills in.\n\n      Recommended statement order for optimal streaming:\n      1. \\`root = Stack(...)\\` — UI shell appears immediately\n      2. $variable declarations — state ready for bindings\n      3. Query statements — defaults resolve immediately so components render with data\n      4. Component definitions — fill in with data already available\n      5. Data values — leaf content last\n\n      Always write the root = Stack(...) statement first so the UI shell appears immediately, even before child data has streamed in.`,\n  );\n\n  openui.addSection(\n    OPENUI_EXAMPLES_TAG,\n    dedent`\n      Example 1 — Table (column-oriented):\n\n      root = Stack([title, tbl])\n      title = TextContent(\"Top Languages\", \"large-heavy\")\n      tbl = Table([Col(\"Language\", langs), Col(\"Users (M)\", users), Col(\"Year\", years)])\n      langs = [\"Python\", \"JavaScript\", \"Java\", \"TypeScript\", \"Go\"]\n      users = [15.7, 14.2, 12.1, 8.5, 5.2]\n      years = [1991, 1995, 1995, 2012, 2009]\n\n      Example 2 — Bar chart:\n\n      root = Stack([title, chart])\n      title = TextContent(\"Q4 Revenue\", \"large-heavy\")\n      chart = BarChart(labels, [s1, s2], \"grouped\")\n      labels = [\"Oct\", \"Nov\", \"Dec\"]\n      s1 = Series(\"Product A\", [120, 150, 180])\n      s2 = Series(\"Product B\", [90, 110, 140])\n\n      Example 3 — Form with validation:\n\n      root = Stack([title, form])\n      title = TextContent(\"Contact Us\", \"large-heavy\")\n      form = Form(\"contact\", btns, [nameField, emailField, countryField, msgField])\n      nameField = FormControl(\"Name\", Input(\"name\", \"Your name\", \"text\", { required: true, minLength: 2 }))\n      emailField = FormControl(\"Email\", Input(\"email\", \"you@example.com\", \"email\", { required: true, email: true }))\n      countryField = FormControl(\"Country\", Select(\"country\", countryOpts, \"Select...\", { required: true }))\n      msgField = FormControl(\"Message\", TextArea(\"message\", \"Tell us more...\", 4, { required: true, minLength: 10 }))\n      countryOpts = [SelectItem(\"us\", \"United States\"), SelectItem(\"uk\", \"United Kingdom\"), SelectItem(\"de\", \"Germany\")]\n      btns = Buttons([Button(\"Submit\", Action([@ToAssistant(\"Submit\")]), \"primary\"), Button(\"Cancel\", Action([@ToAssistant(\"Cancel\")]), \"secondary\")])\n\n      Example 4 — Tabs with mixed content:\n\n      root = Stack([title, tabs])\n      title = TextContent(\"React vs Vue\", \"large-heavy\")\n      tabs = Tabs([tabReact, tabVue])\n      tabReact = TabItem(\"react\", \"React\", reactContent)\n      tabVue = TabItem(\"vue\", \"Vue\", vueContent)\n      reactContent = [TextContent(\"React is a library by Meta for building UIs.\"), Callout(\"info\", \"Note\", \"React uses JSX syntax.\")]\n      vueContent = [TextContent(\"Vue is a progressive framework by Evan You.\"), Callout(\"success\", \"Tip\", \"Vue has a gentle learning curve.\")]`,\n  );\n\n  openui.addSection(\n    OPENUI_IMPORTANT_RULES_TAG,\n    dedent`\n      - When asked about data, generate realistic/plausible data\n      - Choose components that best represent the content (tables for comparisons, charts for trends, forms for input, etc.)\n      - When you render data in an openui block (tables, charts, KPI cards), do NOT repeat the same numbers/facts in the markdown text outside the block.\n      - Text outside the openui block can optionally include:\n        1. **Qualitative insights** — patterns, anomalies, or recommendations that aren't obvious from the visual (e.g. \"the high input-to-output ratio suggests document processing\")\n        2. **Actionable next steps** — what the user can do next\n        3. **Caveats/context** — things the data doesn't show\n      - If all the information is already visible in the openui components, a brief one-line summary is sufficient — do not enumerate the same values again.`,\n  );\n\n  openui.addSection(\n    OPENUI_FINAL_VERIFICATION_TAG,\n    dedent`\n      Before finishing, walk your output and verify:\n      1. root = Stack(...) is the FIRST line (for optimal streaming).\n      2. Every referenced name is defined. Every defined name (other than root) is reachable from root.\n\n      - For grid-like layouts, use Stack with direction \"row\" and wrap=true. Avoid justify=\"between\" unless you specifically want large gutters.\n      - For forms, define one FormControl reference per field so controls can stream progressively.\n      - For forms, always provide the second Form argument with Buttons(...) actions: Form(name, buttons, fields).\n      - Never nest Form inside Form.\n      - Use @Reset($var1, $var2) after form submit to restore defaults — not @Set($var, \"\")\n      - Multi-query refresh: Action([@Run(mutation), @Run(query1), @Run(query2), @Reset(...)])\n      - $variables are reactive: changing via Select or @Set re-evaluates all Queries and expressions referencing them\n      - Use existing components (Tabs, Accordion, Modal) before inventing ternary show/hide patterns`,\n  );\n\n  openui.addSection(\n    OPENUI_USER_INTERACTION_CHECKLIST_TAG,\n    dedent`\n      1. Will the response be UI heavy and will contain components which are not supported by markdown? Use openui if the answer is yes.\n      2. \\`\\`\\`openui\\`\\`\\` fencing must be closed.`,\n  );\n}\n\n/** Renders the existing OpenUI prompt tree without duplicating section bodies. */\nexport function renderOpenUIPrompt(): string {\n  const root = new InstructionBuilder('_openui_render');\n  buildOpenUIInstruction(root);\n  const wrapped = root.build();\n  const openTag = `<${OPENUI_SECTION_TAG}>`;\n  const closeTag = `</${OPENUI_SECTION_TAG}>`;\n  const start = wrapped.indexOf(openTag);\n  const end = wrapped.lastIndexOf(closeTag);\n  if (start === -1 || end === -1) {\n    throw new Error('Failed to render OpenUI prompt from buildOpenUIInstruction');\n  }\n  return wrapped.slice(start, end + closeTag.length);\n}\n\nfunction buildOpenUIDeferredInstruction(builder: InstructionBuilder): void {\n  builder.addSection(\n    OPENUI_SECTION_TAG,\n    dedent`\n      The Agent can render interactive UI that markdown cannot express by emitting a fenced \\`\\`\\`openui block.\n\n      Before writing any \\`\\`\\`openui fence, the Agent MUST call ${GET_OPENUI_INSTRUCTIONS_TOOL_NAME} with arguments {}.\n      Do not invent OpenUI syntax or component APIs without loading those instructions.\n\n      Use OpenUI only when the response is UI-heavy and needs components markdown does not support.\n    `.trim(),\n  );\n}\n\nexport class OpenUIInstructions extends LocalToolMCP {\n  readonly name = OPENUI_SERVER_ID;\n  readonly displayName = 'OpenUI';\n\n  constructor(tracing: AgentTracing) {\n    super({ tracing });\n  }\n\n  private tools: ToolDefinition[] = [\n    defineTool({\n      name: GET_OPENUI_INSTRUCTIONS_TOOL_NAME,\n      description: [\n        'Load the full OpenUI generative-UI authoring instructions (syntax, components, builtins, examples, rules).',\n        'Call this before emitting any ```openui fenced block. Pass an empty object as arguments: {}.',\n      ].join(' '),\n      schema: getOpenUIInstructionsInputSchema,\n      handler: () => Promise.resolve(toolResultResponse({ text: renderOpenUIPrompt() })),\n    }),\n  ];\n\n  protected getTools(): ToolDefinition[] {\n    return this.tools;\n  }\n}\n\nexport function openUI(options?: { preload?: boolean; tracing?: AgentTracing }): AgentCapability {\n  const preload = options?.preload ?? true;\n  if (preload) {\n    return {\n      instructionBuilders: [buildOpenUIInstruction],\n    };\n  }\n  return {\n    systemToolSets: [new OpenUIInstructions(options?.tracing ?? NOOP_AGENT_TRACING)],\n    instructionBuilders: [buildOpenUIDeferredInstruction],\n  };\n}\n"],"mappings":"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","names":["dedent"]}