@yh-ui/yh-ui-skill 1.0.30

package/README.md

@@ -0,0 +1,40 @@
+# @yh-ui/yh-ui-skill
+
+`@yh-ui/yh-ui-skill` packages the YH-UI agent knowledge base as a publishable CLI.
+
+## Install
+
+```bash
+npm i -g @yh-ui/yh-ui-skill
+```
+
+Or run it without a global install:
+
+```bash
+npx @yh-ui/yh-ui-skill install --target cursor
+```
+
+## Usage
+
+```bash
+yh-ui-skill install
+yh-ui-skill install --target cursor
+yh-ui-skill install --target codex --force
+yh-ui-skill install --out-dir ./.yh-ui
+yh-ui-skill doctor --target claude
+```
+
+## Targets
+
+- `project`: install into `.yh-ui/`
+- `cursor`: install into `.cursor/`
+- `claude`: install into `.claude/`
+- `codex`: install into `.codex/`
+- `markdown`: export into `yh-ui-skill/`
+
+## Package Contents
+
+- `skills/yh-ui/`
+- `llms.txt`
+- `llms-full.txt`
+- install manifest for doctor checks

package/assets/llms-full.txt

@@ -0,0 +1,38 @@
+# YH-UI Full AI Context
+
+Read `skills/yh-ui/SKILL.md` first. Then load only the references relevant to the task.
+
+## Skill Files
+
+- `skills/yh-ui/SKILL.md`
+- `skills/yh-ui/README.md`
+- `skills/yh-ui/references/source-truth.md`
+- `skills/yh-ui/references/agent-workflows.md`
+- `skills/yh-ui/references/vue-component-practices.md`
+- `skills/yh-ui/references/component-map.md`
+- `skills/yh-ui/references/usage-patterns.md`
+- `skills/yh-ui/references/api-cheatsheet.md`
+- `skills/yh-ui/references/nuxt.md`
+- `skills/yh-ui/references/ai-components.md`
+- `skills/yh-ui/references/request.md`
+- `skills/yh-ui/references/flow.md`
+- `skills/yh-ui/references/recipes-table.md`
+- `skills/yh-ui/references/recipes-form-schema.md`
+- `skills/yh-ui/references/recipes-ai.md`
+- `skills/yh-ui/references/recipes-flow.md`
+- `skills/yh-ui/references/codegen-rubric.md`
+- `skills/yh-ui/references/eval-scenarios.md`
+
+## Verification
+
+- Regenerate generated references: `pnpm generate:yh-ui-skill`
+- Verify skill consistency: `pnpm verify:yh-ui-skill`
+- Typecheck repository: `pnpm typecheck`
+
+## Anti-Hallucination Rules
+
+- Do not invent `Yh*` components. Check `source-truth.md`.
+- Do not use `createYhTheme` or `createRequestInstance`.
+- Do not import locale files from `@yh-ui/yh-ui/locale/zh-CN`.
+- Do not expose AI provider keys in frontend code.
+- In SSR/Nuxt, wrap browser-heavy Flow examples in `<ClientOnly>`.

package/assets/llms.txt

@@ -0,0 +1,22 @@
+# YH-UI AI Entry
+
+YH-UI is a Vue 3.5+ component system with core components, AI UI, flow editor, request hooks, theme, icons, locale, and Nuxt integration.
+
+Primary AI skill:
+
+- `skills/yh-ui/SKILL.md`
+
+High-value references:
+
+- `skills/yh-ui/references/source-truth.md`: generated package/component/API source truth.
+- `skills/yh-ui/references/agent-workflows.md`: task routing for AI coding agents.
+- `skills/yh-ui/references/vue-component-practices.md`: Vue 3 component-library practices.
+- `skills/yh-ui/references/codegen-rubric.md`: code generation acceptance checklist.
+- `skills/yh-ui/references/component-map.md`: scenario-to-component mapping.
+- `skills/yh-ui/references/api-cheatsheet.md`: generated priority API cheatsheet.
+- `skills/yh-ui/references/recipes-table.md`: YhTable deep recipe.
+- `skills/yh-ui/references/recipes-form-schema.md`: YhFormSchema deep recipe.
+- `skills/yh-ui/references/recipes-ai.md`: YhAi component deep recipe.
+- `skills/yh-ui/references/recipes-flow.md`: Flow deep recipe.
+
+Use `@yh-ui/nuxt` for Nuxt, `@yh-ui/components` for component-only imports, `@yh-ui/yh-ui` for all-in-one Vue install, `@yh-ui/request` for request state, `@yh-ui/flow` for flow editors, and `@yh-ui/ai-sdk` for AI SDK integrations.

package/assets/metadata.json

@@ -0,0 +1,4 @@
+{
+  "packageName": "@yh-ui/yh-ui-skill",
+  "version": "1.0.30"
+}

package/assets/skills/yh-ui/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 YH-UI Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/assets/skills/yh-ui/README.md

@@ -0,0 +1,53 @@
+# YH-UI Agent Skill
+
+This directory packages YH-UI knowledge for modern AI coding agents. It is designed as a small cross-platform skill: one `SKILL.md` file plus progressively loaded reference files.
+
+## Use Cases
+
+- Generate Vue 3 or Nuxt code with YH-UI components.
+- Choose the right YH-UI package for a task.
+- Avoid hallucinated component names, package paths, theme APIs, and locale paths.
+- Give AI agents compact examples for admin pages, AI chat, request hooks, flow editors, themes, icons, and locale setup.
+- Anchor generated code to source exports documented in `references/source-truth.md`.
+
+## Design Principles
+
+- `SKILL.md` stays as the operating manual and trigger surface.
+- Reference files are loaded progressively by task, keeping agent context small.
+- `source-truth.md` is the compact export map and must match source exports.
+- `api-cheatsheet.md` is generated from source using TypeScript AST extraction for priority props, emits, slots, and exposed methods.
+- Deep recipe files hold opinionated high-value patterns for complex components.
+- `codegen-rubric.md` defines what generated YH-UI code must satisfy.
+- `eval-scenarios.md` captures regression prompts for checking AI behavior over time.
+
+## How To Use
+
+### ChatGPT, Codex, Claude, and compatible skill loaders
+
+Add the `skills/yh-ui` folder as a project skill or knowledge folder. The primary entry is `SKILL.md`.
+
+### Claude.ai / Claude Code style
+
+Upload or reference this folder as a skill. The YAML frontmatter in `SKILL.md` provides the name and trigger description. Reference files are intentionally split so the model can load only what it needs.
+
+### Cursor, Codex, and engineering agents
+
+Point the agent to `skills/yh-ui/SKILL.md` before asking it to generate YH-UI code. For repository-level rules, reuse the core rules from `SKILL.md` in your agent instructions.
+
+### ChatGPT project knowledge
+
+Upload `SKILL.md` plus the `references` directory. Tell the assistant to read `SKILL.md` first and open reference files only when relevant.
+
+## Release Checklist
+
+- Run `pnpm verify:yh-ui-skill`.
+- Run `pnpm generate:yh-ui-skill` when component exports or priority APIs change.
+- Confirm package versions in the repository are current.
+- Confirm `references/source-truth.md` matches package exports when components are added or renamed.
+- Run the prompts in `references/eval-scenarios.md` against at least one target AI model before a major skill release.
+- Confirm README links still resolve.
+- Regenerate the skill if component package boundaries change.
+
+## License
+
+MIT. See `LICENSE.txt`.

package/assets/skills/yh-ui/SKILL.md

@@ -0,0 +1,179 @@
+---
+name: yh-ui
+description: Use this skill when building Vue 3 or Nuxt interfaces with YH-UI, including admin screens, AI chat products, request hooks, flow editors, themes, icons, locale setup, and component selection. It helps coding agents choose real YH-UI packages/components and produce correct examples without inventing APIs.
+---
+
+# YH-UI Agent Skill
+
+YH-UI is a Vue 3.5+ component system for product-grade applications. Use this skill to generate code that uses the actual YH-UI package boundaries, component names, and integration patterns.
+
+## When To Use
+
+Use this skill for:
+
+- Vue 3 or Nuxt UI built with YH-UI.
+- Selecting YH-UI components for admin, AI, ecommerce, workflow, data, theme, locale, or request tasks.
+- Fixing hallucinated YH-UI imports, component names, paths, or outdated examples.
+- Reviewing whether generated YH-UI code follows source-aligned package boundaries.
+- Improving YH-UI code so it follows modern Vue 3 component-library practices.
+
+Do not use this skill for:
+
+- Non-Vue UI libraries.
+- Generic prompt writing unrelated to YH-UI implementation.
+- Backend-only AI workflows unless they use `@yh-ui/ai-sdk`, MCP, RAG, or provider adapters.
+
+## Core Rules
+
+- Prefer existing YH-UI components over hand-written base controls.
+- Do not invent components, props, hooks, package paths, or theme APIs.
+- Use `@yh-ui/yh-ui` for ordinary Vue apps that want the all-in-one entry.
+- Use `@yh-ui/nuxt` for Nuxt apps and rely on auto-imported components/composables.
+- Use `@yh-ui/components` when the user asks for component-only usage.
+- Use `@yh-ui/request` for request state, SSE, pagination, queues, GraphQL, WebSocket, or HTTP cache helpers.
+- Use `@yh-ui/flow` for flow charts, node editors, BPMN sketches, or AI workflow diagrams.
+- Use `@yh-ui/ai-sdk` with `@yh-ui/components` for AI chat, streaming, tools, and provider adapters.
+- Use `@yh-ui/theme` tokens and CSS variables instead of hard-coded visual systems.
+- Keep model API keys on the server. Never put provider secrets in browser code.
+- In SSR/Nuxt, wrap browser-heavy flow editors in `<ClientOnly>`.
+
+## Agent Workflow
+
+1. Classify the task: Vue app, Nuxt app, AI UI, request/data, flow/workflow, theme/locale, icon, or review.
+2. Read `references/source-truth.md` when component/package accuracy matters.
+3. Read only the specialized reference needed for the classified task.
+4. Apply `references/vue-component-practices.md` for SFC structure, TypeScript, props/emits, slots, accessibility, SSR, and performance.
+5. Generate code with real package imports and YH-UI components.
+6. Check the result against `references/codegen-rubric.md` before answering.
+
+## Quick Package Decision
+
+| Task                                | Package                               |
+| ----------------------------------- | ------------------------------------- |
+| Full Vue component library          | `@yh-ui/yh-ui`                        |
+| Component-only import               | `@yh-ui/components`                   |
+| Nuxt integration                    | `@yh-ui/nuxt`                         |
+| AI chat UI and streams              | `@yh-ui/components` + `@yh-ui/ai-sdk` |
+| Request hooks and clients           | `@yh-ui/request`                      |
+| Flow editor and workflow canvas     | `@yh-ui/flow`                         |
+| Iconify runtime and icon components | `@yh-ui/icons`                        |
+| Theme tokens and runtime theme      | `@yh-ui/theme`                        |
+| Locale files                        | `@yh-ui/locale`                       |
+
+## High-Frequency Patterns
+
+### Vue Install
+
+```ts
+import { createApp } from 'vue'
+import YhUI from '@yh-ui/yh-ui'
+import '@yh-ui/yh-ui/css'
+import App from './App.vue'
+
+createApp(App).use(YhUI).mount('#app')
+```
+
+### On-Demand Components
+
+```vue
+<script setup lang="ts">
+import { YhButton, YhInput, YhTable } from '@yh-ui/components'
+import '@yh-ui/components/style.css'
+</script>
+
+<template>
+  <YhInput clearable placeholder="Search" />
+  <YhButton type="primary">Submit</YhButton>
+  <YhTable :data="rows" :columns="columns" />
+</template>
+```
+
+### Nuxt
+
+```ts
+export default defineNuxtConfig({
+  modules: ['@yh-ui/nuxt'],
+  yhUI: {
+    importStyle: true,
+    buildTranspile: true,
+    prefix: 'Yh'
+  }
+})
+```
+
+### AI Chat
+
+```vue
+<script setup lang="ts">
+import { YhAiBubble, YhAiSender } from '@yh-ui/components'
+import { useAIChat } from '@yh-ui/ai-sdk/vue'
+
+const { messages, input, isLoading, sendMessage, stop } = useAIChat({
+  api: '/api/chat'
+})
+</script>
+
+<template>
+  <YhAiBubble
+    v-for="message in messages"
+    :key="message.id"
+    :role="message.role"
+    :content="message.content"
+    streaming
+  />
+  <YhAiSender v-model="input" :loading="isLoading" @send="sendMessage" @cancel="stop" />
+</template>
+```
+
+### Flow Editor
+
+```vue
+<script setup lang="ts">
+import { Controls, Flow, FlowBackground, Minimap } from '@yh-ui/flow'
+import type { FlowEdge, FlowNode } from '@yh-ui/flow'
+
+const nodes: FlowNode[] = [
+  { id: 'start', type: 'input', label: 'Start', position: { x: 80, y: 80 } }
+]
+const edges: FlowEdge[] = []
+</script>
+
+<template>
+  <Flow :nodes="nodes" :edges="edges" fit-view style="height: 560px">
+    <Minimap />
+    <Controls />
+    <FlowBackground />
+  </Flow>
+</template>
+```
+
+## Progressive References
+
+Read only the file needed for the task:
+
+- Source-aligned exports and package boundaries: `references/source-truth.md`
+- Agent task workflows: `references/agent-workflows.md`
+- Vue component-library practices: `references/vue-component-practices.md`
+- Component selection: `references/component-map.md`
+- Common implementation patterns: `references/usage-patterns.md`
+- Frequently used props/events: `references/api-cheatsheet.md`
+- Nuxt auto-import and SSR: `references/nuxt.md`
+- AI components and AI SDK: `references/ai-components.md`
+- Request hooks: `references/request.md`
+- Flow editor: `references/flow.md`
+- Deep table recipe: `references/recipes-table.md`
+- Deep form schema recipe: `references/recipes-form-schema.md`
+- Deep AI recipe: `references/recipes-ai.md`
+- Deep Flow recipe: `references/recipes-flow.md`
+- Code generation acceptance rubric: `references/codegen-rubric.md`
+- Evaluation prompts for regression testing: `references/eval-scenarios.md`
+
+## Common Failure Guards
+
+- Do not use old or non-existing APIs such as `createYhTheme` or `createRequestInstance`.
+- Locale files use paths like `@yh-ui/locale/lang/zh-cn`.
+- Nuxt users should not manually import every component in ordinary pages.
+- Flow canvases need an explicit height.
+- Prefer `YhConfigProvider` for runtime locale/config boundaries.
+- Prefer theme CSS variables such as `var(--yh-color-primary)` in custom styles.
+- If unsure whether a component exists, check `references/source-truth.md` before generating code.

package/assets/skills/yh-ui/evals/model-eval-2026-05-16.md

@@ -0,0 +1,47 @@
+# YH-UI Skill Eval Record: 2026-05-16
+
+## Scope
+
+This record evaluates the current skill package against `references/eval-scenarios.md`.
+
+No external model provider credentials are available in this workspace, so this run is a local rubric-based evaluation of the skill package and generated references. It records expected model behavior, likely failure modes, and follow-up optimizations.
+
+## Result Summary
+
+| Scenario                 | Local skill support | Expected model risk                                | Follow-up                                                |
+| ------------------------ | ------------------- | -------------------------------------------------- | -------------------------------------------------------- |
+| Vue Admin Table          | Strong              | Medium: may omit loading/error/empty states        | Added `recipes-table.md` and rubric checks               |
+| Nuxt Setup               | Strong              | Low: may manually import components                | Nuxt reference already warns against manual page imports |
+| AI Chat Surface          | Strong              | Medium: may invent source/attachment props         | Added `recipes-ai.md` and generated API highlights       |
+| Request Hook             | Good                | Low: may use stale factory names                   | `request.md` and forbidden API checks cover this         |
+| Flow In Nuxt             | Strong              | Medium: may omit height or `<ClientOnly>`          | Added `recipes-flow.md` and rubric checks                |
+| Reusable Vue Wrapper     | Good                | Medium: may mutate props or skip accessible labels | Added `vue-component-practices.md`                       |
+| Repair Hallucinated Code | Strong              | Low                                                | Forbidden patterns and repair workflow cover this        |
+
+## Failure Examples To Watch
+
+- `YhDataTable`, `YhAiSuggestion`, or other invented components.
+- `createYhTheme` instead of `ThemePlugin` or `useTheme`.
+- `createRequestInstance` instead of `createRequest`.
+- Nuxt pages manually importing many components despite `@yh-ui/nuxt`.
+- Flow examples without explicit height.
+- AI examples using `VITE_OPENAI_API_KEY` in client code.
+- Schema forms mutating props directly or skipping typed `v-model`.
+
+## Optimizations Applied
+
+- Generated `source-truth.md` and `api-cheatsheet.md` from source.
+- Upgraded generation to TypeScript AST extraction for exported props/emits, typed `defineEmits`, interface slots/exposes, and `defineExpose(expose)` patterns.
+- Added deep recipes for `YhTable`, `YhFormSchema`, `YhAi*`, and `Flow`.
+- Added `llms.txt` and `llms-full.txt` for retrieval-oriented AI tools.
+- Expanded verification so generated source truth must cover source-exported `Yh*` components.
+
+## Next Real Model Run
+
+Run each prompt in `references/eval-scenarios.md` against target tools such as ChatGPT, Claude, Cursor, and Codex with this skill attached. Record:
+
+- Whether package imports are correct.
+- Whether component names exist in `source-truth.md`.
+- Whether generated code passes the `codegen-rubric.md`.
+- Any hallucinated props/events/slots.
+- Any missing Vue best-practice behaviors.

package/assets/skills/yh-ui/references/agent-workflows.md

@@ -0,0 +1,53 @@
+# Agent Workflows
+
+Use this file to route an AI coding task before writing code. Load only the workflow that matches the user request.
+
+## Vue Component Page
+
+1. Use `@yh-ui/yh-ui` for full-app setup or `@yh-ui/components` for local imports.
+2. Choose components from `component-map.md`.
+3. Apply `vue-component-practices.md` for SFC structure, typed props/emits, slots, accessibility, and performance.
+4. Use `@yh-ui/components/style.css` only for component-only examples.
+5. Use theme variables in custom CSS.
+6. Avoid inventing app state libraries unless the user asks.
+
+## Nuxt Page
+
+1. Use `@yh-ui/nuxt` in `nuxt.config.ts`.
+2. Do not import every component inside pages when Nuxt auto-import is enabled.
+3. Apply Vue SSR and hydration rules from `vue-component-practices.md`.
+4. Use `<ClientOnly>` for flow editors or browser-heavy AI rendering.
+5. Use server routes for AI provider secrets and private APIs.
+
+## AI Product UI
+
+1. Decide whether the user wants a complete chat app or composable parts.
+2. Use `YhAiChat` for a complete surface; otherwise compose `YhAiBubbleList`, `YhAiBubble`, `YhAiSender`, `YhAiSources`, `YhAiAttachments`, and `YhAiActionGroup`.
+3. Use `@yh-ui/ai-sdk/vue` for Vue chat state.
+4. Keep provider keys server-side.
+5. Show tool or reasoning progress as UI state, not hidden chain-of-thought text.
+
+## Request/Data Task
+
+1. Use `createRequest` for clients.
+2. Use `useRequest` for component request state.
+3. Use `useSSE`, `useAIStream`, GraphQL, queue, or WebSocket helpers only when the task calls for them.
+4. Put auth and cross-cutting behavior in interceptors.
+5. Keep loading, error, retry, and empty states visible in UI examples.
+
+## Flow/Workflow Task
+
+1. Use `@yh-ui/flow`.
+2. Always set an explicit canvas height.
+3. Use `Flow`, `Minimap`, `Controls`, and `FlowBackground` for ordinary canvases.
+4. Use BPMN exports for BPMN diagrams and AI workflow exports for agent/workflow diagrams.
+5. In Nuxt, wrap flow canvases in `<ClientOnly>`.
+
+## Review Or Repair Task
+
+1. Compare imports and component names against `source-truth.md`.
+2. Look for stale APIs: `createYhTheme`, `createRequestInstance`, and `@yh-ui/yh-ui/locale/zh-CN`.
+3. Check SFC, reactivity, props/emits, slot, accessibility, and SSR issues against `vue-component-practices.md`.
+4. Check whether Nuxt examples unnecessarily import components.
+5. Check whether AI examples expose provider keys in browser code.
+6. Check whether flow examples have an explicit height.

package/assets/skills/yh-ui/references/ai-components.md

@@ -0,0 +1,82 @@
+# AI Components And AI SDK
+
+Use `@yh-ui/components` for AI UI and `@yh-ui/ai-sdk` for chat, streaming, provider adapters, tools, cache, and conversation state.
+
+## Core UI Components
+
+| Component           | Use case                                |
+| ------------------- | --------------------------------------- |
+| `YhAiChat`          | Complete chat surface                   |
+| `YhAiBubble`        | Message bubble and streaming content    |
+| `YhAiSender`        | User input and send/cancel interactions |
+| `YhAiProvider`      | AI context boundary                     |
+| `YhAiBubbleList`    | Conversation message list               |
+| `YhAiThoughtChain`  | Reasoning or step display               |
+| `YhAiThinking`      | Thinking state                          |
+| `YhAiActionGroup`   | Message-level actions                   |
+| `YhAiCodeBlock`     | Code answer rendering                   |
+| `YhAiCodeEditor`    | Editable code                           |
+| `YhAiCodeRunner`    | Code execution UI                       |
+| `YhAiArtifacts`     | Rich generated artifacts                |
+| `YhAiAttachments`   | Attached files                          |
+| `YhAiFileCard`      | File message card                       |
+| `YhAiMention`       | Mention-style prompt input              |
+| `YhAiMermaid`       | Mermaid diagram rendering               |
+| `YhAiSources`       | Citations and references                |
+| `YhAiConversations` | Conversation list                       |
+| `YhAiPrompts`       | Prompt suggestions                      |
+| `YhAiAgentCard`     | Agent marketplace/profile card          |
+| `YhAiVoiceTrigger`  | Voice input trigger                     |
+| `YhAiEditorSender`  | Editor-like sender surface              |
+
+## Chat Hook
+
+```vue
+<script setup lang="ts">
+import { YhAiBubble, YhAiSender } from '@yh-ui/components'
+import { useAIChat } from '@yh-ui/ai-sdk/vue'
+
+const { messages, input, isLoading, sendMessage, stop } = useAIChat({
+  api: '/api/chat'
+})
+</script>
+
+<template>
+  <YhAiBubble
+    v-for="message in messages"
+    :key="message.id"
+    :role="message.role"
+    :content="message.content"
+    streaming
+  />
+  <YhAiSender v-model="input" :loading="isLoading" @send="sendMessage" @cancel="stop" />
+</template>
+```
+
+## Provider Adapter
+
+```ts
+import { createProviderAdapter, getProviderPreset } from '@yh-ui/ai-sdk/vue'
+
+const preset = getProviderPreset('deepseek')
+
+const provider = createProviderAdapter({
+  ...preset,
+  apiKey: process.env.DEEPSEEK_API_KEY,
+  defaultModel: 'deepseek-chat'
+})
+```
+
+## Security Rules
+
+- Never expose provider keys in Vite `VITE_*` variables or browser code.
+- Put provider calls in server routes and stream sanitized output to the client.
+- Treat user prompts and model output as untrusted content when rendering custom HTML.
+
+## Modern AI Best Practices
+
+- Compose small surfaces: bubble list, sender, sources, attachments, and actions should be separate when the user needs control.
+- Use `YhAiChat` only when the user wants a complete chat component.
+- Show tool or reasoning state with `YhAiThoughtChain` or `YhAiThinking`; do not fake hidden chain-of-thought text.
+- Render citations with `YhAiSources` and artifacts with `YhAiArtifacts` instead of plain links when the UI needs trust and traceability.
+- Use `createYHFunctionTool` for tool definitions and keep business execution server-side when it touches private data.