skillfullstack 0.0.0-stage → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (775) hide show
  1. package/.skillsRegistry/catalog.json +231 -0
  2. package/AGENTS.md +89 -0
  3. package/README.md +210 -2
  4. package/bin/index.js +508 -0
  5. package/package.json +57 -4
  6. package/skills/backend/apiEngineering/SKILL.md +102 -0
  7. package/skills/backend/apiEngineering/evals/evalApiEngineering.py +81 -0
  8. package/skills/backend/apiEngineering/evals/fixtures/invalid/sampleInvalidOpenApi.json +40 -0
  9. package/skills/backend/apiEngineering/evals/fixtures/valid/sampleValidOpenApi.json +47 -0
  10. package/skills/backend/apiEngineering/policies/compatibility.md +42 -0
  11. package/skills/backend/apiEngineering/policies/mandatory.md +48 -0
  12. package/skills/backend/apiEngineering/policies/performance.md +39 -0
  13. package/skills/backend/apiEngineering/policies/security.md +36 -0
  14. package/skills/backend/apiEngineering/references/apiObservability.md +39 -0
  15. package/skills/backend/apiEngineering/references/apiReference.md +3 -0
  16. package/skills/backend/apiEngineering/references/apiSecurityOwasp.md +47 -0
  17. package/skills/backend/apiEngineering/references/contractCompatibility.md +26 -0
  18. package/skills/backend/apiEngineering/references/databaseTransactions.md +40 -0
  19. package/skills/backend/apiEngineering/references/distributedReliability.md +26 -0
  20. package/skills/backend/apiEngineering/references/multiTenancy.md +27 -0
  21. package/skills/backend/apiEngineering/references/openApi32Standards.md +58 -0
  22. package/skills/backend/apiEngineering/references/paginationVersioning.md +57 -0
  23. package/skills/backend/apiEngineering/references/responseStandards.md +94 -0
  24. package/skills/backend/apiEngineering/scripts/auditApiContract.py +123 -0
  25. package/skills/backend/apiEngineering/scripts/checkBreakingChanges.py +77 -0
  26. package/skills/backend/apiEngineering/scripts/generateResponseEnvelope.py +88 -0
  27. package/skills/backend/apiEngineering/templates/apiChecklist.md +27 -0
  28. package/skills/backend/apiEngineering/templates/openapi.yaml +125 -0
  29. package/skills/backend/apiEngineering/templates/problemDetails.json +44 -0
  30. package/skills/backend/databaseArchitecture/SKILL.md +118 -0
  31. package/skills/backend/databaseArchitecture/evals/evalDatabaseArchitecture.py +85 -0
  32. package/skills/backend/databaseArchitecture/evals/fixtures/dangerousMigration.sql +4 -0
  33. package/skills/backend/databaseArchitecture/evals/fixtures/invalidSchema.sql +23 -0
  34. package/skills/backend/databaseArchitecture/evals/fixtures/safeMigration.sql +3 -0
  35. package/skills/backend/databaseArchitecture/evals/fixtures/validSchema.sql +37 -0
  36. package/skills/backend/databaseArchitecture/policies/integrity.md +25 -0
  37. package/skills/backend/databaseArchitecture/policies/mandatory.md +32 -0
  38. package/skills/backend/databaseArchitecture/policies/migration.md +22 -0
  39. package/skills/backend/databaseArchitecture/policies/normalization.md +25 -0
  40. package/skills/backend/databaseArchitecture/policies/performance.md +26 -0
  41. package/skills/backend/databaseArchitecture/policies/recovery.md +23 -0
  42. package/skills/backend/databaseArchitecture/policies/security.md +26 -0
  43. package/skills/backend/databaseArchitecture/policies/tableCreationChecklist.md +70 -0
  44. package/skills/backend/databaseArchitecture/references/analyticsWarehousing.md +32 -0
  45. package/skills/backend/databaseArchitecture/references/apiReference.md +3 -0
  46. package/skills/backend/databaseArchitecture/references/backupDisasterRecovery.md +27 -0
  47. package/skills/backend/databaseArchitecture/references/dataModelingLifecycle.md +30 -0
  48. package/skills/backend/databaseArchitecture/references/databaseTaxonomy.md +32 -0
  49. package/skills/backend/databaseArchitecture/references/indexingOptimization.md +32 -0
  50. package/skills/backend/databaseArchitecture/references/normalizationTheory.md +61 -0
  51. package/skills/backend/databaseArchitecture/references/scalabilitySharding.md +37 -0
  52. package/skills/backend/databaseArchitecture/references/transactionConcurrency.md +39 -0
  53. package/skills/backend/databaseArchitecture/scripts/analyzeMigration.py +99 -0
  54. package/skills/backend/databaseArchitecture/scripts/auditDatabaseSchema.py +177 -0
  55. package/skills/backend/databaseArchitecture/scripts/inspectDatabaseIndexes.py +149 -0
  56. package/skills/backend/databaseArchitecture/templates/adrTemplate.md +32 -0
  57. package/skills/backend/databaseArchitecture/templates/databaseChecklist.md +29 -0
  58. package/skills/backend/databaseArchitecture/templates/migrationPlan.md +40 -0
  59. package/skills/backend/durableBackgroundJobs/SKILL.md +112 -0
  60. package/skills/backend/durableBackgroundJobs/evals/durableJobVerification.json +14 -0
  61. package/skills/backend/durableBackgroundJobs/references/apiReference.md +3 -0
  62. package/skills/backend/durableBackgroundJobs/references/durableStepPatterns.md +6 -0
  63. package/skills/backend/durableBackgroundJobs/references/idempotencyKeys.md +5 -0
  64. package/skills/backend/durableBackgroundJobs/scripts/testWorkflowDispatch.py +24 -0
  65. package/skills/backend/golangStandard/SKILL.md +155 -0
  66. package/skills/backend/golangStandard/evals/goVerification.json +14 -0
  67. package/skills/backend/golangStandard/references/apiReference.md +3 -0
  68. package/skills/backend/golangStandard/references/layoutGuide.md +26 -0
  69. package/skills/backend/golangStandard/references/slogPatterns.md +26 -0
  70. package/skills/backend/golangStandard/scripts/scaffoldGoModule.py +105 -0
  71. package/skills/backend/pythonStandard/SKILL.md +138 -0
  72. package/skills/backend/pythonStandard/evals/pythonVerification.json +14 -0
  73. package/skills/backend/pythonStandard/references/apiReference.md +3 -0
  74. package/skills/backend/pythonStandard/references/pydanticPatterns.md +16 -0
  75. package/skills/backend/pythonStandard/references/pyprojectSpecs.md +37 -0
  76. package/skills/backend/pythonStandard/scripts/scaffoldUvProject.py +79 -0
  77. package/skills/backend/upstash/SKILL.md +98 -0
  78. package/skills/backend/upstash/evals/upstashVerification.json +14 -0
  79. package/skills/backend/upstash/references/apiReference.md +3 -0
  80. package/skills/backend/upstash/references/qstashFlowControl.md +34 -0
  81. package/skills/backend/upstash/references/ratelimitPatterns.md +53 -0
  82. package/skills/backend/upstash/references/workflowPatterns.md +35 -0
  83. package/skills/backend/upstash/scripts/testRedisConnection.py +36 -0
  84. package/skills/cicdDevops/cicdPipeline/SKILL.md +148 -0
  85. package/skills/cicdDevops/cicdPipeline/evals/evalCicd.py +37 -0
  86. package/skills/cicdDevops/cicdPipeline/references/apiReference.md +3 -0
  87. package/skills/cicdDevops/cicdPipeline/references/cicdDeploymentPatterns.md +27 -0
  88. package/skills/cicdDevops/cicdPipeline/scripts/auditDockerfileSecurity.py +56 -0
  89. package/skills/dataAi/mcpServerDevelopment/SKILL.md +123 -0
  90. package/skills/dataAi/mcpServerDevelopment/evals/mcpVerification.json +14 -0
  91. package/skills/dataAi/mcpServerDevelopment/references/apiReference.md +3 -0
  92. package/skills/dataAi/mcpServerDevelopment/references/mcpClientConfigs.md +38 -0
  93. package/skills/dataAi/mcpServerDevelopment/references/toolSchemaDesign.md +6 -0
  94. package/skills/dataAi/mcpServerDevelopment/scripts/runFastMcpBoilerplate.py +36 -0
  95. package/skills/dataAi/ragPipelineProduction/SKILL.md +113 -0
  96. package/skills/dataAi/ragPipelineProduction/evals/ragVerification.json +14 -0
  97. package/skills/dataAi/ragPipelineProduction/references/apiReference.md +3 -0
  98. package/skills/dataAi/ragPipelineProduction/references/chunkingStrategies.md +10 -0
  99. package/skills/dataAi/ragPipelineProduction/references/rrfAlgorithm.md +13 -0
  100. package/skills/dataAi/ragPipelineProduction/scripts/runHybridRrfSearch.py +33 -0
  101. package/skills/devopsCloud/cloudflare/SKILL.md +282 -0
  102. package/skills/devopsCloud/cloudflare/assets/README.md +48 -0
  103. package/skills/devopsCloud/cloudflare/assets/ai/agents-sdk.md +118 -0
  104. package/skills/devopsCloud/cloudflare/assets/ai/ai-gateway.md +105 -0
  105. package/skills/devopsCloud/cloudflare/assets/ai/ai-search.md +129 -0
  106. package/skills/devopsCloud/cloudflare/assets/ai/workers-ai.md +127 -0
  107. package/skills/devopsCloud/cloudflare/assets/cli/c3.md +292 -0
  108. package/skills/devopsCloud/cloudflare/assets/cli/cf-cli.md +90 -0
  109. package/skills/devopsCloud/cloudflare/assets/cli/wrangler.md +43 -0
  110. package/skills/devopsCloud/cloudflare/assets/compute/cron-triggers.md +486 -0
  111. package/skills/devopsCloud/cloudflare/assets/compute/service-bindings.md +251 -0
  112. package/skills/devopsCloud/cloudflare/assets/compute/smart-placement.md +435 -0
  113. package/skills/devopsCloud/cloudflare/assets/compute/static-assets.md +220 -0
  114. package/skills/devopsCloud/cloudflare/assets/compute/workers.md +129 -0
  115. package/skills/devopsCloud/cloudflare/assets/database-storage/d1.md +105 -0
  116. package/skills/devopsCloud/cloudflare/assets/database-storage/durable-objects.md +122 -0
  117. package/skills/devopsCloud/cloudflare/assets/database-storage/hyperdrive.md +210 -0
  118. package/skills/devopsCloud/cloudflare/assets/database-storage/kv.md +198 -0
  119. package/skills/devopsCloud/cloudflare/assets/database-storage/queues.md +105 -0
  120. package/skills/devopsCloud/cloudflare/assets/database-storage/r2.md +105 -0
  121. package/skills/devopsCloud/cloudflare/assets/database-storage/vectorize.md +97 -0
  122. package/skills/devopsCloud/cloudflare/assets/database-storage/workflows.md +141 -0
  123. package/skills/devopsCloud/cloudflare/assets/llms.txt +143 -0
  124. package/skills/devopsCloud/cloudflare/assets/networking-security/cache-cdn.md +109 -0
  125. package/skills/devopsCloud/cloudflare/assets/networking-security/dns.md +71 -0
  126. package/skills/devopsCloud/cloudflare/assets/networking-security/rate-limiting.md +130 -0
  127. package/skills/devopsCloud/cloudflare/assets/networking-security/tunnels.md +57 -0
  128. package/skills/devopsCloud/cloudflare/assets/networking-security/waf.md +143 -0
  129. package/skills/devopsCloud/cloudflare/assets/troubleshooting/1xxx-errors.md +209 -0
  130. package/skills/devopsCloud/cloudflare/assets/troubleshooting/5xx-errors.md +111 -0
  131. package/skills/devopsCloud/cloudflare/assets/troubleshooting/http-status-codes.md +38 -0
  132. package/skills/devopsCloud/cloudflare/evals/evals.json +75 -0
  133. package/skills/devopsCloud/cloudflare/references/ai-gateway/README.md +27 -0
  134. package/skills/devopsCloud/cloudflare/references/ai-gateway/configuration.md +18 -0
  135. package/skills/devopsCloud/cloudflare/references/ai-gateway/dynamic-routing.md +15 -0
  136. package/skills/devopsCloud/cloudflare/references/ai-gateway/features.md +22 -0
  137. package/skills/devopsCloud/cloudflare/references/ai-gateway/sdk-integration.md +19 -0
  138. package/skills/devopsCloud/cloudflare/references/ai-gateway/troubleshooting.md +16 -0
  139. package/skills/devopsCloud/cloudflare/references/ai-search/README.md +25 -0
  140. package/skills/devopsCloud/cloudflare/references/ai-search/api.md +13 -0
  141. package/skills/devopsCloud/cloudflare/references/ai-search/configuration.md +16 -0
  142. package/skills/devopsCloud/cloudflare/references/ai-search/gotchas.md +13 -0
  143. package/skills/devopsCloud/cloudflare/references/ai-search/patterns.md +15 -0
  144. package/skills/devopsCloud/cloudflare/references/bindings/README.md +16 -0
  145. package/skills/devopsCloud/cloudflare/references/bindings/api.md +19 -0
  146. package/skills/devopsCloud/cloudflare/references/bindings/configuration.md +20 -0
  147. package/skills/devopsCloud/cloudflare/references/bindings/gotchas.md +18 -0
  148. package/skills/devopsCloud/cloudflare/references/bindings/patterns.md +20 -0
  149. package/skills/devopsCloud/cloudflare/references/browser-rendering/README.md +18 -0
  150. package/skills/devopsCloud/cloudflare/references/browser-rendering/api.md +12 -0
  151. package/skills/devopsCloud/cloudflare/references/browser-rendering/configuration.md +12 -0
  152. package/skills/devopsCloud/cloudflare/references/browser-rendering/gotchas.md +15 -0
  153. package/skills/devopsCloud/cloudflare/references/browser-rendering/patterns.md +12 -0
  154. package/skills/devopsCloud/cloudflare/references/cliComparison.md +93 -0
  155. package/skills/devopsCloud/cloudflare/references/containers/README.md +23 -0
  156. package/skills/devopsCloud/cloudflare/references/containers/api.md +13 -0
  157. package/skills/devopsCloud/cloudflare/references/containers/configuration.md +15 -0
  158. package/skills/devopsCloud/cloudflare/references/containers/gotchas.md +16 -0
  159. package/skills/devopsCloud/cloudflare/references/containers/patterns.md +18 -0
  160. package/skills/devopsCloud/cloudflare/references/cron-triggers/README.md +20 -0
  161. package/skills/devopsCloud/cloudflare/references/cron-triggers/api.md +16 -0
  162. package/skills/devopsCloud/cloudflare/references/cron-triggers/configuration.md +16 -0
  163. package/skills/devopsCloud/cloudflare/references/cron-triggers/gotchas.md +17 -0
  164. package/skills/devopsCloud/cloudflare/references/cron-triggers/patterns.md +18 -0
  165. package/skills/devopsCloud/cloudflare/references/d1/README.md +15 -0
  166. package/skills/devopsCloud/cloudflare/references/d1/api.md +18 -0
  167. package/skills/devopsCloud/cloudflare/references/d1/configuration.md +18 -0
  168. package/skills/devopsCloud/cloudflare/references/d1/gotchas.md +18 -0
  169. package/skills/devopsCloud/cloudflare/references/d1/patterns.md +21 -0
  170. package/skills/devopsCloud/cloudflare/references/frameworkCompatibility.md +110 -0
  171. package/skills/devopsCloud/cloudflare/references/hyperdrive/README.md +28 -0
  172. package/skills/devopsCloud/cloudflare/references/hyperdrive/api.md +26 -0
  173. package/skills/devopsCloud/cloudflare/references/hyperdrive/configuration.md +34 -0
  174. package/skills/devopsCloud/cloudflare/references/hyperdrive/gotchas.md +20 -0
  175. package/skills/devopsCloud/cloudflare/references/hyperdrive/patterns.md +15 -0
  176. package/skills/devopsCloud/cloudflare/references/images/README.md +12 -0
  177. package/skills/devopsCloud/cloudflare/references/images/api.md +13 -0
  178. package/skills/devopsCloud/cloudflare/references/images/configuration.md +17 -0
  179. package/skills/devopsCloud/cloudflare/references/images/gotchas.md +16 -0
  180. package/skills/devopsCloud/cloudflare/references/images/patterns.md +16 -0
  181. package/skills/devopsCloud/cloudflare/references/kv/README.md +15 -0
  182. package/skills/devopsCloud/cloudflare/references/kv/api.md +18 -0
  183. package/skills/devopsCloud/cloudflare/references/kv/configuration.md +16 -0
  184. package/skills/devopsCloud/cloudflare/references/kv/gotchas.md +17 -0
  185. package/skills/devopsCloud/cloudflare/references/kv/patterns.md +21 -0
  186. package/skills/devopsCloud/cloudflare/references/miniflare/README.md +22 -0
  187. package/skills/devopsCloud/cloudflare/references/miniflare/api.md +16 -0
  188. package/skills/devopsCloud/cloudflare/references/miniflare/configuration.md +16 -0
  189. package/skills/devopsCloud/cloudflare/references/miniflare/gotchas.md +15 -0
  190. package/skills/devopsCloud/cloudflare/references/miniflare/patterns.md +19 -0
  191. package/skills/devopsCloud/cloudflare/references/observability/README.md +27 -0
  192. package/skills/devopsCloud/cloudflare/references/observability/api.md +20 -0
  193. package/skills/devopsCloud/cloudflare/references/observability/configuration.md +23 -0
  194. package/skills/devopsCloud/cloudflare/references/observability/gotchas.md +25 -0
  195. package/skills/devopsCloud/cloudflare/references/observability/patterns.md +14 -0
  196. package/skills/devopsCloud/cloudflare/references/pages/README.md +20 -0
  197. package/skills/devopsCloud/cloudflare/references/pages/api.md +13 -0
  198. package/skills/devopsCloud/cloudflare/references/pages/configuration.md +16 -0
  199. package/skills/devopsCloud/cloudflare/references/pages/gotchas.md +19 -0
  200. package/skills/devopsCloud/cloudflare/references/pages/patterns.md +15 -0
  201. package/skills/devopsCloud/cloudflare/references/pages-functions/README.md +20 -0
  202. package/skills/devopsCloud/cloudflare/references/pages-functions/api.md +13 -0
  203. package/skills/devopsCloud/cloudflare/references/pages-functions/configuration.md +14 -0
  204. package/skills/devopsCloud/cloudflare/references/pages-functions/gotchas.md +17 -0
  205. package/skills/devopsCloud/cloudflare/references/pages-functions/patterns.md +16 -0
  206. package/skills/devopsCloud/cloudflare/references/productSelectionMatrix.md +54 -0
  207. package/skills/devopsCloud/cloudflare/references/queues/README.md +24 -0
  208. package/skills/devopsCloud/cloudflare/references/queues/api.md +16 -0
  209. package/skills/devopsCloud/cloudflare/references/queues/configuration.md +20 -0
  210. package/skills/devopsCloud/cloudflare/references/queues/gotchas.md +18 -0
  211. package/skills/devopsCloud/cloudflare/references/queues/patterns.md +21 -0
  212. package/skills/devopsCloud/cloudflare/references/r2/README.md +26 -0
  213. package/skills/devopsCloud/cloudflare/references/r2/api.md +16 -0
  214. package/skills/devopsCloud/cloudflare/references/r2/configuration.md +19 -0
  215. package/skills/devopsCloud/cloudflare/references/r2/gotchas.md +17 -0
  216. package/skills/devopsCloud/cloudflare/references/r2/patterns.md +18 -0
  217. package/skills/devopsCloud/cloudflare/references/secrets-store/README.md +22 -0
  218. package/skills/devopsCloud/cloudflare/references/secrets-store/api.md +21 -0
  219. package/skills/devopsCloud/cloudflare/references/secrets-store/configuration.md +25 -0
  220. package/skills/devopsCloud/cloudflare/references/secrets-store/gotchas.md +19 -0
  221. package/skills/devopsCloud/cloudflare/references/secrets-store/patterns.md +27 -0
  222. package/skills/devopsCloud/cloudflare/references/skill-feedback.md +41 -0
  223. package/skills/devopsCloud/cloudflare/references/static-assets/README.md +21 -0
  224. package/skills/devopsCloud/cloudflare/references/static-assets/api.md +16 -0
  225. package/skills/devopsCloud/cloudflare/references/static-assets/configuration.md +16 -0
  226. package/skills/devopsCloud/cloudflare/references/static-assets/gotchas.md +18 -0
  227. package/skills/devopsCloud/cloudflare/references/static-assets/patterns.md +17 -0
  228. package/skills/devopsCloud/cloudflare/references/stream/README.md +22 -0
  229. package/skills/devopsCloud/cloudflare/references/stream/api-live.md +18 -0
  230. package/skills/devopsCloud/cloudflare/references/stream/api.md +21 -0
  231. package/skills/devopsCloud/cloudflare/references/stream/configuration.md +18 -0
  232. package/skills/devopsCloud/cloudflare/references/stream/gotchas.md +18 -0
  233. package/skills/devopsCloud/cloudflare/references/stream/patterns.md +22 -0
  234. package/skills/devopsCloud/cloudflare/references/tail-workers/README.md +21 -0
  235. package/skills/devopsCloud/cloudflare/references/tail-workers/api.md +13 -0
  236. package/skills/devopsCloud/cloudflare/references/tail-workers/configuration.md +15 -0
  237. package/skills/devopsCloud/cloudflare/references/tail-workers/gotchas.md +16 -0
  238. package/skills/devopsCloud/cloudflare/references/tail-workers/patterns.md +15 -0
  239. package/skills/devopsCloud/cloudflare/references/tunnel/README.md +20 -0
  240. package/skills/devopsCloud/cloudflare/references/tunnel/api.md +14 -0
  241. package/skills/devopsCloud/cloudflare/references/tunnel/configuration.md +14 -0
  242. package/skills/devopsCloud/cloudflare/references/tunnel/gotchas.md +15 -0
  243. package/skills/devopsCloud/cloudflare/references/tunnel/networking.md +14 -0
  244. package/skills/devopsCloud/cloudflare/references/tunnel/patterns.md +15 -0
  245. package/skills/devopsCloud/cloudflare/references/vectorize/README.md +22 -0
  246. package/skills/devopsCloud/cloudflare/references/vectorize/api.md +18 -0
  247. package/skills/devopsCloud/cloudflare/references/vectorize/configuration.md +19 -0
  248. package/skills/devopsCloud/cloudflare/references/vectorize/gotchas.md +15 -0
  249. package/skills/devopsCloud/cloudflare/references/vectorize/patterns.md +24 -0
  250. package/skills/devopsCloud/cloudflare/references/waf/README.md +21 -0
  251. package/skills/devopsCloud/cloudflare/references/waf/api.md +17 -0
  252. package/skills/devopsCloud/cloudflare/references/waf/configuration.md +18 -0
  253. package/skills/devopsCloud/cloudflare/references/waf/gotchas.md +19 -0
  254. package/skills/devopsCloud/cloudflare/references/waf/patterns.md +17 -0
  255. package/skills/devopsCloud/cloudflare/references/workers-ai/README.md +24 -0
  256. package/skills/devopsCloud/cloudflare/references/workers-ai/api.md +13 -0
  257. package/skills/devopsCloud/cloudflare/references/workers-ai/configuration.md +16 -0
  258. package/skills/devopsCloud/cloudflare/references/workers-ai/gotchas.md +15 -0
  259. package/skills/devopsCloud/cloudflare/references/workers-ai/patterns.md +14 -0
  260. package/skills/devopsCloud/cloudflare/references/workflows/README.md +23 -0
  261. package/skills/devopsCloud/cloudflare/references/workflows/api.md +17 -0
  262. package/skills/devopsCloud/cloudflare/references/workflows/configuration.md +18 -0
  263. package/skills/devopsCloud/cloudflare/references/workflows/gotchas.md +19 -0
  264. package/skills/devopsCloud/cloudflare/references/workflows/patterns.md +30 -0
  265. package/skills/devopsCloud/cloudflare/scripts/auditCloudflareProduction.py +95 -0
  266. package/skills/foundation/promptEvalTesting/SKILL.md +114 -0
  267. package/skills/foundation/promptEvalTesting/evals/promptEvalVerification.json +14 -0
  268. package/skills/foundation/promptEvalTesting/references/apiReference.md +3 -0
  269. package/skills/foundation/promptEvalTesting/references/evalMetricsCatalog.md +7 -0
  270. package/skills/foundation/promptEvalTesting/references/promptfooConfigSpecs.md +16 -0
  271. package/skills/foundation/promptEvalTesting/scripts/runPromptEvalSuite.py +29 -0
  272. package/skills/frontend/astro/SKILL.md +327 -0
  273. package/skills/frontend/astro/assets/README.md +71 -0
  274. package/skills/frontend/astro/assets/add-content-to-your-site/content-collections.md +1061 -0
  275. package/skills/frontend/astro/assets/add-content-to-your-site/data-fetching.md +109 -0
  276. package/skills/frontend/astro/assets/add-content-to-your-site/images.md +719 -0
  277. package/skills/frontend/astro/assets/add-content-to-your-site/markdown.md +725 -0
  278. package/skills/frontend/astro/assets/build-your-ui/components.md +402 -0
  279. package/skills/frontend/astro/assets/build-your-ui/fonts.md +437 -0
  280. package/skills/frontend/astro/assets/build-your-ui/front-end-frameworks.md +245 -0
  281. package/skills/frontend/astro/assets/build-your-ui/layouts.md +267 -0
  282. package/skills/frontend/astro/assets/build-your-ui/scripts-and-event-handling.md +229 -0
  283. package/skills/frontend/astro/assets/build-your-ui/styles-and-css.md +782 -0
  284. package/skills/frontend/astro/assets/build-your-ui/syntax-highlighting.md +269 -0
  285. package/skills/frontend/astro/assets/configuration/build-with-ai.md +389 -0
  286. package/skills/frontend/astro/assets/configuration/configuration-overview.md +122 -0
  287. package/skills/frontend/astro/assets/configuration/dev-toolbar.md +86 -0
  288. package/skills/frontend/astro/assets/configuration/editor-setup.md +166 -0
  289. package/skills/frontend/astro/assets/configuration/environment-variables.md +352 -0
  290. package/skills/frontend/astro/assets/configuration/typescript.md +379 -0
  291. package/skills/frontend/astro/assets/configuration/working-with-integrations.md +606 -0
  292. package/skills/frontend/astro/assets/reference/adapter-reference.md +1242 -0
  293. package/skills/frontend/astro/assets/reference/cli-reference.md +575 -0
  294. package/skills/frontend/astro/assets/reference/configuration-reference.md +3144 -0
  295. package/skills/frontend/astro/assets/reference/content-loader-reference.md +1682 -0
  296. package/skills/frontend/astro/assets/reference/directives-reference.md +324 -0
  297. package/skills/frontend/astro/assets/reference/image-service-reference.md +346 -0
  298. package/skills/frontend/astro/assets/reference/integrations-reference.md +2813 -0
  299. package/skills/frontend/astro/assets/reference/modules/astro-actions.md +604 -0
  300. package/skills/frontend/astro/assets/reference/modules/astro-app.md +460 -0
  301. package/skills/frontend/astro/assets/reference/modules/astro-assets.md +1657 -0
  302. package/skills/frontend/astro/assets/reference/modules/astro-config.md +395 -0
  303. package/skills/frontend/astro/assets/reference/modules/astro-content.md +720 -0
  304. package/skills/frontend/astro/assets/reference/modules/astro-env.md +46 -0
  305. package/skills/frontend/astro/assets/reference/modules/astro-fetch.md +346 -0
  306. package/skills/frontend/astro/assets/reference/modules/astro-hono.md +37 -0
  307. package/skills/frontend/astro/assets/reference/modules/astro-i18n.md +462 -0
  308. package/skills/frontend/astro/assets/reference/modules/astro-middleware.md +292 -0
  309. package/skills/frontend/astro/assets/reference/modules/astro-static-paths.md +74 -0
  310. package/skills/frontend/astro/assets/reference/modules/astro-transitions.md +595 -0
  311. package/skills/frontend/astro/assets/reference/modules/astro-zod.md +120 -0
  312. package/skills/frontend/astro/assets/reference/session-driver-reference.md +205 -0
  313. package/skills/frontend/astro/assets/routing-and-navigation/endpoints.md +251 -0
  314. package/skills/frontend/astro/assets/routing-and-navigation/internationalization.md +374 -0
  315. package/skills/frontend/astro/assets/routing-and-navigation/middleware.md +288 -0
  316. package/skills/frontend/astro/assets/routing-and-navigation/pages.md +205 -0
  317. package/skills/frontend/astro/assets/routing-and-navigation/prefetch.md +273 -0
  318. package/skills/frontend/astro/assets/routing-and-navigation/routing.md +760 -0
  319. package/skills/frontend/astro/assets/routing-and-navigation/view-transitions.md +792 -0
  320. package/skills/frontend/astro/assets/server-rendering/actions.md +770 -0
  321. package/skills/frontend/astro/assets/server-rendering/caching.md +255 -0
  322. package/skills/frontend/astro/assets/server-rendering/on-demand-rendering.md +289 -0
  323. package/skills/frontend/astro/assets/server-rendering/server-islands.md +126 -0
  324. package/skills/frontend/astro/assets/server-rendering/sessions.md +270 -0
  325. package/skills/frontend/astro/assets/start-a-new-project/develop-and-build.md +147 -0
  326. package/skills/frontend/astro/assets/start-a-new-project/installation.md +342 -0
  327. package/skills/frontend/astro/assets/start-a-new-project/project-structure.md +137 -0
  328. package/skills/frontend/astro/assets/upgrade-and-troubleshooting/testing.md +412 -0
  329. package/skills/frontend/astro/assets/upgrade-and-troubleshooting/troubleshooting.md +229 -0
  330. package/skills/frontend/astro/assets/upgrade-and-troubleshooting/upgrade-astro.md +205 -0
  331. package/skills/frontend/astro/assets/welcome/courses.md +46 -0
  332. package/skills/frontend/astro/assets/welcome/islands-architecture.md +135 -0
  333. package/skills/frontend/astro/assets/welcome/why-astro.md +90 -0
  334. package/skills/frontend/astro/evals/evals.json +66 -0
  335. package/skills/frontend/astro/references/contentCollections.md +164 -0
  336. package/skills/frontend/astro/references/islandsArchitecture.md +128 -0
  337. package/skills/frontend/astro/references/serverIslandsAndActions.md +187 -0
  338. package/skills/frontend/astro/scripts/auditAstroProduction.py +78 -0
  339. package/skills/frontend/generativeUi/SKILL.md +128 -0
  340. package/skills/frontend/generativeUi/evals/generativeUiVerification.json +14 -0
  341. package/skills/frontend/generativeUi/references/apiReference.md +3 -0
  342. package/skills/frontend/generativeUi/references/clientToolComponentMapping.md +8 -0
  343. package/skills/frontend/generativeUi/references/dataStreamProtocol.md +10 -0
  344. package/skills/frontend/generativeUi/scripts/generateUiComponentStub.py +46 -0
  345. package/skills/frontend/nextjs/SKILL.md +138 -0
  346. package/skills/frontend/nextjs/assets/README.md +67 -0
  347. package/skills/frontend/nextjs/assets/api-reference/cli/create-next-app.md +210 -0
  348. package/skills/frontend/nextjs/assets/api-reference/cli/next.md +484 -0
  349. package/skills/frontend/nextjs/assets/api-reference/components/font.md +952 -0
  350. package/skills/frontend/nextjs/assets/api-reference/components/form.md +387 -0
  351. package/skills/frontend/nextjs/assets/api-reference/components/image.md +1372 -0
  352. package/skills/frontend/nextjs/assets/api-reference/components/link.md +954 -0
  353. package/skills/frontend/nextjs/assets/api-reference/components/script.md +421 -0
  354. package/skills/frontend/nextjs/assets/api-reference/directives/use-cache-private.md +211 -0
  355. package/skills/frontend/nextjs/assets/api-reference/directives/use-cache-remote.md +652 -0
  356. package/skills/frontend/nextjs/assets/api-reference/directives/use-cache.md +848 -0
  357. package/skills/frontend/nextjs/assets/api-reference/directives/use-client.md +149 -0
  358. package/skills/frontend/nextjs/assets/api-reference/directives/use-server.md +234 -0
  359. package/skills/frontend/nextjs/assets/api-reference/edge-runtime.md +188 -0
  360. package/skills/frontend/nextjs/assets/api-reference/file-conventions/default.md +80 -0
  361. package/skills/frontend/nextjs/assets/api-reference/file-conventions/dynamic-routes.md +417 -0
  362. package/skills/frontend/nextjs/assets/api-reference/file-conventions/error.md +361 -0
  363. package/skills/frontend/nextjs/assets/api-reference/file-conventions/forbidden.md +75 -0
  364. package/skills/frontend/nextjs/assets/api-reference/file-conventions/instrumentation-client.md +308 -0
  365. package/skills/frontend/nextjs/assets/api-reference/file-conventions/instrumentation.md +177 -0
  366. package/skills/frontend/nextjs/assets/api-reference/file-conventions/intercepting-routes.md +78 -0
  367. package/skills/frontend/nextjs/assets/api-reference/file-conventions/layout.md +803 -0
  368. package/skills/frontend/nextjs/assets/api-reference/file-conventions/loading.md +209 -0
  369. package/skills/frontend/nextjs/assets/api-reference/file-conventions/mdx-components.md +84 -0
  370. package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/app-icons.md +302 -0
  371. package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/manifest.md +90 -0
  372. package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/opengraph-image.md +580 -0
  373. package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/robots.md +234 -0
  374. package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/sitemap.md +459 -0
  375. package/skills/frontend/nextjs/assets/api-reference/file-conventions/not-found.md +278 -0
  376. package/skills/frontend/nextjs/assets/api-reference/file-conventions/page.md +283 -0
  377. package/skills/frontend/nextjs/assets/api-reference/file-conventions/parallel-routes.md +517 -0
  378. package/skills/frontend/nextjs/assets/api-reference/file-conventions/proxy.md +857 -0
  379. package/skills/frontend/nextjs/assets/api-reference/file-conventions/public-folder.md +47 -0
  380. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-groups.md +40 -0
  381. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/dynamicParams.md +40 -0
  382. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/ensureStatic.md +195 -0
  383. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/instant.md +204 -0
  384. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/maxDuration.md +42 -0
  385. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/preferredRegion.md +55 -0
  386. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/prefetch.md +113 -0
  387. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/runtime.md +43 -0
  388. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route.md +772 -0
  389. package/skills/frontend/nextjs/assets/api-reference/file-conventions/src-folder.md +42 -0
  390. package/skills/frontend/nextjs/assets/api-reference/file-conventions/template.md +174 -0
  391. package/skills/frontend/nextjs/assets/api-reference/file-conventions/unauthorized.md +143 -0
  392. package/skills/frontend/nextjs/assets/api-reference/functions/after.md +332 -0
  393. package/skills/frontend/nextjs/assets/api-reference/functions/cacheLife.md +642 -0
  394. package/skills/frontend/nextjs/assets/api-reference/functions/cacheTag.md +272 -0
  395. package/skills/frontend/nextjs/assets/api-reference/functions/catchError.md +267 -0
  396. package/skills/frontend/nextjs/assets/api-reference/functions/connection.md +114 -0
  397. package/skills/frontend/nextjs/assets/api-reference/functions/cookies.md +349 -0
  398. package/skills/frontend/nextjs/assets/api-reference/functions/draft-mode.md +173 -0
  399. package/skills/frontend/nextjs/assets/api-reference/functions/fetch.md +141 -0
  400. package/skills/frontend/nextjs/assets/api-reference/functions/forbidden.md +327 -0
  401. package/skills/frontend/nextjs/assets/api-reference/functions/generate-image-metadata.md +311 -0
  402. package/skills/frontend/nextjs/assets/api-reference/functions/generate-metadata.md +1510 -0
  403. package/skills/frontend/nextjs/assets/api-reference/functions/generate-sitemaps.md +102 -0
  404. package/skills/frontend/nextjs/assets/api-reference/functions/generate-static-params.md +606 -0
  405. package/skills/frontend/nextjs/assets/api-reference/functions/generate-viewport.md +347 -0
  406. package/skills/frontend/nextjs/assets/api-reference/functions/headers.md +92 -0
  407. package/skills/frontend/nextjs/assets/api-reference/functions/image-response.md +225 -0
  408. package/skills/frontend/nextjs/assets/api-reference/functions/io.md +131 -0
  409. package/skills/frontend/nextjs/assets/api-reference/functions/navigation.md +220 -0
  410. package/skills/frontend/nextjs/assets/api-reference/functions/next-request.md +116 -0
  411. package/skills/frontend/nextjs/assets/api-reference/functions/next-response.md +219 -0
  412. package/skills/frontend/nextjs/assets/api-reference/functions/next-root-params.md +479 -0
  413. package/skills/frontend/nextjs/assets/api-reference/functions/not-found.md +269 -0
  414. package/skills/frontend/nextjs/assets/api-reference/functions/permanentRedirect.md +92 -0
  415. package/skills/frontend/nextjs/assets/api-reference/functions/prefetch.md +202 -0
  416. package/skills/frontend/nextjs/assets/api-reference/functions/redirect.md +255 -0
  417. package/skills/frontend/nextjs/assets/api-reference/functions/refresh.md +91 -0
  418. package/skills/frontend/nextjs/assets/api-reference/functions/revalidatePath.md +248 -0
  419. package/skills/frontend/nextjs/assets/api-reference/functions/revalidateTag.md +175 -0
  420. package/skills/frontend/nextjs/assets/api-reference/functions/unauthorized.md +389 -0
  421. package/skills/frontend/nextjs/assets/api-reference/functions/unstable_cache.md +131 -0
  422. package/skills/frontend/nextjs/assets/api-reference/functions/unstable_noStore.md +61 -0
  423. package/skills/frontend/nextjs/assets/api-reference/functions/unstable_rethrow.md +79 -0
  424. package/skills/frontend/nextjs/assets/api-reference/functions/updateTag.md +173 -0
  425. package/skills/frontend/nextjs/assets/api-reference/functions/use-link-status.md +268 -0
  426. package/skills/frontend/nextjs/assets/api-reference/functions/use-offline.md +222 -0
  427. package/skills/frontend/nextjs/assets/api-reference/functions/use-params.md +102 -0
  428. package/skills/frontend/nextjs/assets/api-reference/functions/use-pathname.md +189 -0
  429. package/skills/frontend/nextjs/assets/api-reference/functions/use-report-web-vitals.md +175 -0
  430. package/skills/frontend/nextjs/assets/api-reference/functions/use-router.md +214 -0
  431. package/skills/frontend/nextjs/assets/api-reference/functions/use-search-params.md +416 -0
  432. package/skills/frontend/nextjs/assets/api-reference/functions/use-selected-layout-segment.md +214 -0
  433. package/skills/frontend/nextjs/assets/api-reference/functions/use-selected-layout-segments.md +116 -0
  434. package/skills/frontend/nextjs/assets/api-reference/functions/use-server-inserted-html.md +145 -0
  435. package/skills/frontend/nextjs/assets/api-reference/functions/userAgent.md +95 -0
  436. package/skills/frontend/nextjs/assets/api-reference/turbopack.md +552 -0
  437. package/skills/frontend/nextjs/assets/architecture/accessibility.md +47 -0
  438. package/skills/frontend/nextjs/assets/architecture/fast-refresh.md +122 -0
  439. package/skills/frontend/nextjs/assets/architecture/nextjs-compiler.md +376 -0
  440. package/skills/frontend/nextjs/assets/architecture/supported-browsers.md +146 -0
  441. package/skills/frontend/nextjs/assets/community/contribution-guide.md +459 -0
  442. package/skills/frontend/nextjs/assets/community/rspack.md +25 -0
  443. package/skills/frontend/nextjs/assets/getting-started/caching.md +626 -0
  444. package/skills/frontend/nextjs/assets/getting-started/css.md +336 -0
  445. package/skills/frontend/nextjs/assets/getting-started/deploying.md +115 -0
  446. package/skills/frontend/nextjs/assets/getting-started/error-handling.md +485 -0
  447. package/skills/frontend/nextjs/assets/getting-started/fetching-data.md +743 -0
  448. package/skills/frontend/nextjs/assets/getting-started/fonts.md +232 -0
  449. package/skills/frontend/nextjs/assets/getting-started/images.md +272 -0
  450. package/skills/frontend/nextjs/assets/getting-started/installation.md +446 -0
  451. package/skills/frontend/nextjs/assets/getting-started/layouts-and-pages.md +386 -0
  452. package/skills/frontend/nextjs/assets/getting-started/linking-and-navigating.md +475 -0
  453. package/skills/frontend/nextjs/assets/getting-started/metadata-and-og-images.md +370 -0
  454. package/skills/frontend/nextjs/assets/getting-started/mutating-data.md +679 -0
  455. package/skills/frontend/nextjs/assets/getting-started/project-structure.md +290 -0
  456. package/skills/frontend/nextjs/assets/getting-started/proxy.md +107 -0
  457. package/skills/frontend/nextjs/assets/getting-started/revalidating.md +241 -0
  458. package/skills/frontend/nextjs/assets/getting-started/route-handlers.md +233 -0
  459. package/skills/frontend/nextjs/assets/getting-started/server-and-client-components.md +683 -0
  460. package/skills/frontend/nextjs/assets/getting-started/upgrading.md +137 -0
  461. package/skills/frontend/nextjs/assets/glossary.md +315 -0
  462. package/skills/frontend/nextjs/evals/nextjsVerification.json +14 -0
  463. package/skills/frontend/nextjs/references/apiReference.md +3 -0
  464. package/skills/frontend/nextjs/references/dataAccessLayer.md +39 -0
  465. package/skills/frontend/nextjs/references/nextjsFeatureMap.md +276 -0
  466. package/skills/frontend/nextjs/references/productionChecklist.md +49 -0
  467. package/skills/frontend/nextjs/references/securityHeadersCsp.md +44 -0
  468. package/skills/frontend/nextjs/scripts/auditProductionReadiness.py +85 -0
  469. package/skills/frontend/shadcn-ui/SKILL.md +102 -0
  470. package/skills/frontend/shadcn-ui/assets/README.md +82 -0
  471. package/skills/frontend/shadcn-ui/assets/advanced/javascript.md +44 -0
  472. package/skills/frontend/shadcn-ui/assets/advanced/monorepo.md +254 -0
  473. package/skills/frontend/shadcn-ui/assets/advanced/react-19.md +166 -0
  474. package/skills/frontend/shadcn-ui/assets/advanced/tailwind-v4.md +333 -0
  475. package/skills/frontend/shadcn-ui/assets/ai-elements/chain-of-thought.md +519 -0
  476. package/skills/frontend/shadcn-ui/assets/ai-elements/chat.md +581 -0
  477. package/skills/frontend/shadcn-ui/assets/ai-elements/checkpoint.md +243 -0
  478. package/skills/frontend/shadcn-ui/assets/ai-elements/confirmation.md +382 -0
  479. package/skills/frontend/shadcn-ui/assets/ai-elements/context.md +188 -0
  480. package/skills/frontend/shadcn-ui/assets/ai-elements/file-tree.md +248 -0
  481. package/skills/frontend/shadcn-ui/assets/ai-elements/index.md +307 -0
  482. package/skills/frontend/shadcn-ui/assets/ai-elements/inline-citation.md +219 -0
  483. package/skills/frontend/shadcn-ui/assets/ai-elements/message.md +298 -0
  484. package/skills/frontend/shadcn-ui/assets/ai-elements/model-selector.md +368 -0
  485. package/skills/frontend/shadcn-ui/assets/ai-elements/plan.md +398 -0
  486. package/skills/frontend/shadcn-ui/assets/ai-elements/prompt-input.md +403 -0
  487. package/skills/frontend/shadcn-ui/assets/ai-elements/queue.md +517 -0
  488. package/skills/frontend/shadcn-ui/assets/ai-elements/reasoning.md +349 -0
  489. package/skills/frontend/shadcn-ui/assets/ai-elements/sources.md +303 -0
  490. package/skills/frontend/shadcn-ui/assets/ai-elements/stack-trace.md +514 -0
  491. package/skills/frontend/shadcn-ui/assets/ai-elements/subagent.md +551 -0
  492. package/skills/frontend/shadcn-ui/assets/ai-elements/suggestion.md +246 -0
  493. package/skills/frontend/shadcn-ui/assets/ai-elements/task.md +380 -0
  494. package/skills/frontend/shadcn-ui/assets/ai-elements/terminal.md +463 -0
  495. package/skills/frontend/shadcn-ui/assets/ai-elements/test-results.md +641 -0
  496. package/skills/frontend/shadcn-ui/assets/ai-elements/tool.md +915 -0
  497. package/skills/frontend/shadcn-ui/assets/components/accordion.md +490 -0
  498. package/skills/frontend/shadcn-ui/assets/components/alert-dialog.md +520 -0
  499. package/skills/frontend/shadcn-ui/assets/components/alert.md +351 -0
  500. package/skills/frontend/shadcn-ui/assets/components/aspect-ratio.md +206 -0
  501. package/skills/frontend/shadcn-ui/assets/components/attachment.md +715 -0
  502. package/skills/frontend/shadcn-ui/assets/components/avatar.md +581 -0
  503. package/skills/frontend/shadcn-ui/assets/components/badge.md +276 -0
  504. package/skills/frontend/shadcn-ui/assets/components/breadcrumb.md +556 -0
  505. package/skills/frontend/shadcn-ui/assets/components/bubble.md +706 -0
  506. package/skills/frontend/shadcn-ui/assets/components/button-group.md +969 -0
  507. package/skills/frontend/shadcn-ui/assets/components/button.md +523 -0
  508. package/skills/frontend/shadcn-ui/assets/components/calendar.md +959 -0
  509. package/skills/frontend/shadcn-ui/assets/components/card.md +684 -0
  510. package/skills/frontend/shadcn-ui/assets/components/carousel.md +643 -0
  511. package/skills/frontend/shadcn-ui/assets/components/chart.md +1295 -0
  512. package/skills/frontend/shadcn-ui/assets/components/checkbox.md +553 -0
  513. package/skills/frontend/shadcn-ui/assets/components/code-block.md +2041 -0
  514. package/skills/frontend/shadcn-ui/assets/components/collapsible.md +504 -0
  515. package/skills/frontend/shadcn-ui/assets/components/combobox.md +1102 -0
  516. package/skills/frontend/shadcn-ui/assets/components/command.md +682 -0
  517. package/skills/frontend/shadcn-ui/assets/components/context-menu.md +949 -0
  518. package/skills/frontend/shadcn-ui/assets/components/data-table.md +1667 -0
  519. package/skills/frontend/shadcn-ui/assets/components/date-picker.md +698 -0
  520. package/skills/frontend/shadcn-ui/assets/components/dialog.md +454 -0
  521. package/skills/frontend/shadcn-ui/assets/components/direction.md +205 -0
  522. package/skills/frontend/shadcn-ui/assets/components/drawer.md +806 -0
  523. package/skills/frontend/shadcn-ui/assets/components/dropdown-menu.md +1315 -0
  524. package/skills/frontend/shadcn-ui/assets/components/empty.md +562 -0
  525. package/skills/frontend/shadcn-ui/assets/components/field.md +1321 -0
  526. package/skills/frontend/shadcn-ui/assets/components/hover-card.md +342 -0
  527. package/skills/frontend/shadcn-ui/assets/components/index.md +82 -0
  528. package/skills/frontend/shadcn-ui/assets/components/input-group.md +980 -0
  529. package/skills/frontend/shadcn-ui/assets/components/input-otp.md +551 -0
  530. package/skills/frontend/shadcn-ui/assets/components/input.md +555 -0
  531. package/skills/frontend/shadcn-ui/assets/components/item.md +937 -0
  532. package/skills/frontend/shadcn-ui/assets/components/kbd.md +290 -0
  533. package/skills/frontend/shadcn-ui/assets/components/label.md +327 -0
  534. package/skills/frontend/shadcn-ui/assets/components/marker.md +445 -0
  535. package/skills/frontend/shadcn-ui/assets/components/menubar.md +804 -0
  536. package/skills/frontend/shadcn-ui/assets/components/message-scroller.md +2770 -0
  537. package/skills/frontend/shadcn-ui/assets/components/message.md +618 -0
  538. package/skills/frontend/shadcn-ui/assets/components/native-select.md +321 -0
  539. package/skills/frontend/shadcn-ui/assets/components/navigation-menu.md +568 -0
  540. package/skills/frontend/shadcn-ui/assets/components/pagination.md +425 -0
  541. package/skills/frontend/shadcn-ui/assets/components/popover.md +402 -0
  542. package/skills/frontend/shadcn-ui/assets/components/progress.md +240 -0
  543. package/skills/frontend/shadcn-ui/assets/components/questionnaire.md +2055 -0
  544. package/skills/frontend/shadcn-ui/assets/components/radio-group.md +440 -0
  545. package/skills/frontend/shadcn-ui/assets/components/resizable.md +302 -0
  546. package/skills/frontend/shadcn-ui/assets/components/scroll-area.md +226 -0
  547. package/skills/frontend/shadcn-ui/assets/components/select.md +647 -0
  548. package/skills/frontend/shadcn-ui/assets/components/separator.md +235 -0
  549. package/skills/frontend/shadcn-ui/assets/components/sheet.md +354 -0
  550. package/skills/frontend/shadcn-ui/assets/components/sidebar.md +1156 -0
  551. package/skills/frontend/shadcn-ui/assets/components/skeleton.md +217 -0
  552. package/skills/frontend/shadcn-ui/assets/components/slider.md +253 -0
  553. package/skills/frontend/shadcn-ui/assets/components/spinner.md +352 -0
  554. package/skills/frontend/shadcn-ui/assets/components/switch.md +296 -0
  555. package/skills/frontend/shadcn-ui/assets/components/table.md +572 -0
  556. package/skills/frontend/shadcn-ui/assets/components/tabs.md +425 -0
  557. package/skills/frontend/shadcn-ui/assets/components/textarea.md +218 -0
  558. package/skills/frontend/shadcn-ui/assets/components/toast.md +260 -0
  559. package/skills/frontend/shadcn-ui/assets/components/toggle-group.md +419 -0
  560. package/skills/frontend/shadcn-ui/assets/components/toggle.md +220 -0
  561. package/skills/frontend/shadcn-ui/assets/components/tooltip.md +332 -0
  562. package/skills/frontend/shadcn-ui/assets/components/trace.md +1890 -0
  563. package/skills/frontend/shadcn-ui/assets/components/typography.md +561 -0
  564. package/skills/frontend/shadcn-ui/assets/dark-mode/next.md +108 -0
  565. package/skills/frontend/shadcn-ui/assets/dark-mode/overview.md +75 -0
  566. package/skills/frontend/shadcn-ui/assets/dark-mode/vite.md +144 -0
  567. package/skills/frontend/shadcn-ui/assets/forms/next.md +716 -0
  568. package/skills/frontend/shadcn-ui/assets/forms/overview.md +60 -0
  569. package/skills/frontend/shadcn-ui/assets/forms/react-hook-form.md +2055 -0
  570. package/skills/frontend/shadcn-ui/assets/forms/tanstack-form.md +2236 -0
  571. package/skills/frontend/shadcn-ui/assets/installation/astro.md +252 -0
  572. package/skills/frontend/shadcn-ui/assets/installation/manual.md +255 -0
  573. package/skills/frontend/shadcn-ui/assets/installation/next.md +256 -0
  574. package/skills/frontend/shadcn-ui/assets/installation/react-router.md +226 -0
  575. package/skills/frontend/shadcn-ui/assets/installation/remix.md +52 -0
  576. package/skills/frontend/shadcn-ui/assets/installation/vite.md +314 -0
  577. package/skills/frontend/shadcn-ui/assets/mcp/mcp.md +338 -0
  578. package/skills/frontend/shadcn-ui/assets/overview/changelog.md +6 -0
  579. package/skills/frontend/shadcn-ui/assets/overview/cli.md +738 -0
  580. package/skills/frontend/shadcn-ui/assets/overview/components-json.md +379 -0
  581. package/skills/frontend/shadcn-ui/assets/overview/directory.md +74 -0
  582. package/skills/frontend/shadcn-ui/assets/overview/introduction.md +77 -0
  583. package/skills/frontend/shadcn-ui/assets/overview/skills.md +71 -0
  584. package/skills/frontend/shadcn-ui/assets/overview/theming.md +304 -0
  585. package/skills/frontend/shadcn-ui/assets/overview/typeset.md +242 -0
  586. package/skills/frontend/shadcn-ui/assets/registry/getting-started.md +648 -0
  587. package/skills/frontend/shadcn-ui/assets/registry/overview.md +90 -0
  588. package/skills/frontend/shadcn-ui/assets/registry/registry-item-json.md +483 -0
  589. package/skills/frontend/shadcn-ui/assets/registry/registry-json.md +178 -0
  590. package/skills/frontend/shadcn-ui/evals/componentVerification.json +19 -0
  591. package/skills/frontend/shadcn-ui/references/aiComponentsCatalog.md +51 -0
  592. package/skills/frontend/shadcn-ui/references/apiReference.md +3 -0
  593. package/skills/frontend/shadcn-ui/references/blocksCatalog.md +32 -0
  594. package/skills/frontend/shadcn-ui/references/cliCommands.md +47 -0
  595. package/skills/frontend/shadcn-ui/references/componentMarkdownSources.md +48 -0
  596. package/skills/frontend/shadcn-ui/scripts/fetchComponentDocs.py +43 -0
  597. package/skills/frontend/tsxReactStandard/SKILL.md +150 -0
  598. package/skills/frontend/tsxReactStandard/evals/tsxVerification.json +14 -0
  599. package/skills/frontend/tsxReactStandard/references/apiReference.md +3 -0
  600. package/skills/frontend/tsxReactStandard/references/discriminatedUnions.md +31 -0
  601. package/skills/frontend/tsxReactStandard/references/tsconfigStrict.md +36 -0
  602. package/skills/frontend/tsxReactStandard/scripts/validateTsxTypes.py +44 -0
  603. package/skills/gitVersionControl/gitWorkflow/SKILL.md +128 -0
  604. package/skills/gitVersionControl/gitWorkflow/assets/README.md +23 -0
  605. package/skills/gitVersionControl/gitWorkflow/assets/cli/gh-environment.md +87 -0
  606. package/skills/gitVersionControl/gitWorkflow/assets/cli/gh-formatting.md +156 -0
  607. package/skills/gitVersionControl/gitWorkflow/assets/cli/gh-reference.md +2363 -0
  608. package/skills/gitVersionControl/gitWorkflow/assets/using-git/about-git.md +156 -0
  609. package/skills/gitVersionControl/gitWorkflow/assets/using-git/about-remote-repositories.md +65 -0
  610. package/skills/gitVersionControl/gitWorkflow/assets/using-git/associating-text-editors-with-git.md +93 -0
  611. package/skills/gitVersionControl/gitWorkflow/assets/using-git/caching-your-github-credentials.md +115 -0
  612. package/skills/gitVersionControl/gitWorkflow/assets/using-git/getting-changes-from-a-remote-repository.md +76 -0
  613. package/skills/gitVersionControl/gitWorkflow/assets/using-git/ignoring-files.md +51 -0
  614. package/skills/gitVersionControl/gitWorkflow/assets/using-git/managing-remote-repositories.md +231 -0
  615. package/skills/gitVersionControl/gitWorkflow/assets/using-git/pushing-commits-to-a-remote-repository.md +119 -0
  616. package/skills/gitVersionControl/gitWorkflow/evals/evalGitWorkflow.py +43 -0
  617. package/skills/gitVersionControl/gitWorkflow/references/apiReference.md +3 -0
  618. package/skills/gitVersionControl/gitWorkflow/references/branchingModels.md +32 -0
  619. package/skills/gitVersionControl/gitWorkflow/scripts/diagnoseGitGraph.py +68 -0
  620. package/skills/github/assets/README.md +39 -0
  621. package/skills/github/assets/cli/gh-environment.md +87 -0
  622. package/skills/github/assets/cli/gh-formatting.md +156 -0
  623. package/skills/github/assets/cli/gh-reference.md +2363 -0
  624. package/skills/github/assets/docs-api/github-docs-api.md +60 -0
  625. package/skills/github/assets/rest-api/actions-secrets.md +1272 -0
  626. package/skills/github/assets/rest-api/actions-variables.md +1247 -0
  627. package/skills/github/assets/rest-api/actions-workflow-runs.md +1697 -0
  628. package/skills/github/assets/rest-api/actions-workflows.md +348 -0
  629. package/skills/github/assets/rest-api/authenticating.md +174 -0
  630. package/skills/github/assets/rest-api/branches.md +727 -0
  631. package/skills/github/assets/rest-api/checks-runs.md +1013 -0
  632. package/skills/github/assets/rest-api/checks-suites.md +1142 -0
  633. package/skills/github/assets/rest-api/code-scanning.md +2957 -0
  634. package/skills/github/assets/rest-api/collaborators.md +547 -0
  635. package/skills/github/assets/rest-api/commits.md +957 -0
  636. package/skills/github/assets/rest-api/dependabot-alerts.md +895 -0
  637. package/skills/github/assets/rest-api/orgs.md +1172 -0
  638. package/skills/github/assets/rest-api/overview.md +875 -0
  639. package/skills/github/assets/rest-api/pull-reviews.md +722 -0
  640. package/skills/github/assets/rest-api/pulls.md +1605 -0
  641. package/skills/github/assets/rest-api/quickstart.md +344 -0
  642. package/skills/github/assets/rest-api/releases.md +650 -0
  643. package/skills/github/assets/rest-api/repos.md +2957 -0
  644. package/skills/github/assets/rest-api/rules.md +1507 -0
  645. package/skills/github/assets/rest-api/secret-scanning.md +947 -0
  646. package/skills/github/assets/rest-api/teams.md +1690 -0
  647. package/skills/github/githubAction/SKILL.md +159 -0
  648. package/skills/github/githubAction/assets/README.md +38 -0
  649. package/skills/github/githubAction/assets/reference/contexts.md +918 -0
  650. package/skills/github/githubAction/assets/reference/dependency-caching.md +393 -0
  651. package/skills/github/githubAction/assets/reference/events-that-trigger-workflows.md +1348 -0
  652. package/skills/github/githubAction/assets/reference/expressions.md +441 -0
  653. package/skills/github/githubAction/assets/reference/metadata-syntax.md +803 -0
  654. package/skills/github/githubAction/assets/reference/variables.md +149 -0
  655. package/skills/github/githubAction/assets/reference/workflow-cancellation.md +22 -0
  656. package/skills/github/githubAction/assets/reference/workflow-commands.md +1056 -0
  657. package/skills/github/githubAction/assets/reference/workflow-syntax.md +1721 -0
  658. package/skills/github/githubAction/assets/rest-api/secrets.md +1272 -0
  659. package/skills/github/githubAction/assets/rest-api/workflow-runs.md +1697 -0
  660. package/skills/github/githubAction/assets/rest-api/workflows.md +348 -0
  661. package/skills/github/githubAction/assets/starter-workflows/automation/stale.yml +27 -0
  662. package/skills/github/githubAction/assets/starter-workflows/ci/blank.yml +36 -0
  663. package/skills/github/githubAction/assets/starter-workflows/ci/docker-image.yml +18 -0
  664. package/skills/github/githubAction/assets/starter-workflows/ci/go.yml +28 -0
  665. package/skills/github/githubAction/assets/starter-workflows/ci/maven.yml +35 -0
  666. package/skills/github/githubAction/assets/starter-workflows/ci/node.js.yml +31 -0
  667. package/skills/github/githubAction/assets/starter-workflows/ci/python-app.yml +39 -0
  668. package/skills/github/githubAction/assets/starter-workflows/ci/rust.yml +22 -0
  669. package/skills/github/githubAction/assets/starter-workflows/code-scanning/codeql.yml +97 -0
  670. package/skills/github/githubAction/evals/actionVerification.json +14 -0
  671. package/skills/github/githubAction/references/apiReference.md +3 -0
  672. package/skills/github/githubAction/references/workflowPatterns.md +81 -0
  673. package/skills/github/githubAction/scripts/validateWorkflowYaml.py +53 -0
  674. package/skills/github/githubQuality/SKILL.md +136 -0
  675. package/skills/github/githubQuality/assets/README.md +24 -0
  676. package/skills/github/githubQuality/assets/pull-requests/about-code-owners.md +178 -0
  677. package/skills/github/githubQuality/assets/pull-requests/about-merge-methods.md +48 -0
  678. package/skills/github/githubQuality/assets/pull-requests/creating-a-pull-request.md +170 -0
  679. package/skills/github/githubQuality/assets/pull-requests/giving-reviews.md +48 -0
  680. package/skills/github/githubQuality/assets/pull-requests/managing-a-merge-queue.md +134 -0
  681. package/skills/github/githubQuality/assets/pull-requests/merging-a-pull-request.md +101 -0
  682. package/skills/github/githubQuality/assets/pull-requests/resolving-reviews.md +59 -0
  683. package/skills/github/githubQuality/assets/pull-requests/status-checks.md +135 -0
  684. package/skills/github/githubQuality/assets/rest-api/checks-runs.md +1013 -0
  685. package/skills/github/githubQuality/assets/rest-api/checks-suites.md +1142 -0
  686. package/skills/github/githubQuality/assets/rest-api/commits.md +957 -0
  687. package/skills/github/githubQuality/assets/rest-api/pulls.md +1605 -0
  688. package/skills/github/githubQuality/assets/rest-api/reviews.md +722 -0
  689. package/skills/github/githubQuality/evals/qualityVerification.json +14 -0
  690. package/skills/github/githubQuality/references/apiReference.md +3 -0
  691. package/skills/github/githubQuality/references/codeownersExample.md +26 -0
  692. package/skills/github/githubQuality/references/prTemplate.md +20 -0
  693. package/skills/github/githubQuality/scripts/auditPrQuality.py +52 -0
  694. package/skills/github/githubSecurity/SKILL.md +170 -0
  695. package/skills/github/githubSecurity/assets/README.md +32 -0
  696. package/skills/github/githubSecurity/assets/code-scanning/code-scanning-alerts.md +133 -0
  697. package/skills/github/githubSecurity/assets/code-scanning/code-scanning.md +67 -0
  698. package/skills/github/githubSecurity/assets/code-scanning/codeql-code-scanning.md +79 -0
  699. package/skills/github/githubSecurity/assets/code-scanning/configure-code-scanning.md +121 -0
  700. package/skills/github/githubSecurity/assets/dependabot/about-the-dependabot-yml-file.md +74 -0
  701. package/skills/github/githubSecurity/assets/dependabot/dependabot-alerts.md +133 -0
  702. package/skills/github/githubSecurity/assets/dependabot/dependabot-security-updates.md +95 -0
  703. package/skills/github/githubSecurity/assets/dependabot/dependabot-version-updates.md +80 -0
  704. package/skills/github/githubSecurity/assets/rest-api/code-scanning.md +2957 -0
  705. package/skills/github/githubSecurity/assets/rest-api/dependabot-alerts.md +895 -0
  706. package/skills/github/githubSecurity/assets/rest-api/secret-scanning.md +947 -0
  707. package/skills/github/githubSecurity/assets/secret-scanning/enable-secret-scanning.md +59 -0
  708. package/skills/github/githubSecurity/assets/secret-scanning/secret-scanning.md +105 -0
  709. package/skills/github/githubSecurity/assets/security-advisories/github-advisory-database.md +148 -0
  710. package/skills/github/githubSecurity/evals/securityVerification.json +14 -0
  711. package/skills/github/githubSecurity/references/apiReference.md +3 -0
  712. package/skills/github/githubSecurity/references/codeqlAnalysis.yml +42 -0
  713. package/skills/github/githubSecurity/references/dependabotConfig.yml +27 -0
  714. package/skills/github/githubSecurity/scripts/auditRepoSecurity.py +47 -0
  715. package/skills/github/githubSetup/SKILL.md +137 -0
  716. package/skills/github/githubSetup/assets/README.md +40 -0
  717. package/skills/github/githubSetup/assets/branches/about-protected-branches.md +198 -0
  718. package/skills/github/githubSetup/assets/branches/changing-the-default-branch.md +49 -0
  719. package/skills/github/githubSetup/assets/branches/deleting-and-restoring-branches.md +44 -0
  720. package/skills/github/githubSetup/assets/branches/managing-a-branch-protection-rule.md +115 -0
  721. package/skills/github/githubSetup/assets/branches/renaming-a-branch.md +74 -0
  722. package/skills/github/githubSetup/assets/branches/viewing-branches-in-your-repository.md +30 -0
  723. package/skills/github/githubSetup/assets/repositories/about-repositories.md +127 -0
  724. package/skills/github/githubSetup/assets/repositories/cloning-a-repository.md +114 -0
  725. package/skills/github/githubSetup/assets/repositories/creating-a-new-repository.md +82 -0
  726. package/skills/github/githubSetup/assets/repositories/creating-a-repository-from-a-template.md +51 -0
  727. package/skills/github/githubSetup/assets/repositories/deleting-a-repository.md +34 -0
  728. package/skills/github/githubSetup/assets/repositories/managing-teams-and-people-with-access.md +69 -0
  729. package/skills/github/githubSetup/assets/repositories/renaming-a-repository.md +47 -0
  730. package/skills/github/githubSetup/assets/repositories/restoring-a-deleted-repository.md +61 -0
  731. package/skills/github/githubSetup/assets/repositories/setting-repository-visibility.md +137 -0
  732. package/skills/github/githubSetup/assets/rest-api/branches.md +727 -0
  733. package/skills/github/githubSetup/assets/rest-api/quickstart.md +344 -0
  734. package/skills/github/githubSetup/assets/rest-api/repos.md +2957 -0
  735. package/skills/github/githubSetup/assets/rulesets/about-rulesets.md +72 -0
  736. package/skills/github/githubSetup/assets/rulesets/available-rules-for-rulesets.md +383 -0
  737. package/skills/github/githubSetup/assets/rulesets/converting-branch-protections-to-rulesets.md +92 -0
  738. package/skills/github/githubSetup/assets/rulesets/creating-rulesets-for-a-repository.md +108 -0
  739. package/skills/github/githubSetup/assets/rulesets/managing-rulesets-for-a-repository.md +149 -0
  740. package/skills/github/githubSetup/assets/rulesets/troubleshooting-rules.md +122 -0
  741. package/skills/github/githubSetup/evals/setupVerification.json +14 -0
  742. package/skills/github/githubSetup/references/apiReference.md +3 -0
  743. package/skills/github/githubSetup/references/repoSettingsBlueprint.md +13 -0
  744. package/skills/github/githubSetup/references/rulesetTemplates.json +42 -0
  745. package/skills/github/githubSetup/scripts/configureRepoBaseline.py +46 -0
  746. package/skills/github/githubTeam/SKILL.md +115 -0
  747. package/skills/github/githubTeam/assets/README.md +21 -0
  748. package/skills/github/githubTeam/assets/organizations/about-organizations.md +69 -0
  749. package/skills/github/githubTeam/assets/organizations/repository-roles-for-an-organization.md +94 -0
  750. package/skills/github/githubTeam/assets/rest-api/collaborators.md +547 -0
  751. package/skills/github/githubTeam/assets/rest-api/orgs.md +1172 -0
  752. package/skills/github/githubTeam/assets/rest-api/teams.md +1690 -0
  753. package/skills/github/githubTeam/assets/teams/about-teams.md +82 -0
  754. package/skills/github/githubTeam/assets/teams/adding-members-to-a-team.md +55 -0
  755. package/skills/github/githubTeam/evals/teamVerification.json +14 -0
  756. package/skills/github/githubTeam/references/apiReference.md +3 -0
  757. package/skills/github/githubTeam/references/permissionMatrix.md +17 -0
  758. package/skills/github/githubTeam/references/reviewAssignment.md +17 -0
  759. package/skills/github/githubTeam/scripts/manageTeamSync.py +31 -0
  760. package/skills/securityQa/llmSecurityRedteaming/SKILL.md +86 -0
  761. package/skills/securityQa/llmSecurityRedteaming/evals/securityRedteamVerification.json +14 -0
  762. package/skills/securityQa/llmSecurityRedteaming/references/apiReference.md +3 -0
  763. package/skills/securityQa/llmSecurityRedteaming/references/jailbreakTaxonomy.md +6 -0
  764. package/skills/securityQa/llmSecurityRedteaming/references/owaspLlmTopTen.md +12 -0
  765. package/skills/securityQa/llmSecurityRedteaming/scripts/testPromptInjection.py +34 -0
  766. package/skills/softwareDevelopment/requirementsEngineering/SKILL.md +110 -0
  767. package/skills/softwareDevelopment/requirementsEngineering/evals/evalRequirements.py +33 -0
  768. package/skills/softwareDevelopment/requirementsEngineering/references/apiReference.md +3 -0
  769. package/skills/softwareDevelopment/requirementsEngineering/references/requirementsAnalysisModels.md +34 -0
  770. package/skills/softwareDevelopment/requirementsEngineering/scripts/validateUserStories.py +49 -0
  771. package/skills/testing/testDrivenDevelopment/SKILL.md +122 -0
  772. package/skills/testing/testDrivenDevelopment/evals/evalTdd.py +25 -0
  773. package/skills/testing/testDrivenDevelopment/references/apiReference.md +3 -0
  774. package/skills/testing/testDrivenDevelopment/references/testPyramidDoubles.md +35 -0
  775. package/skills/testing/testDrivenDevelopment/scripts/auditTestPyramid.py +58 -0
@@ -0,0 +1,1890 @@
1
+ ---
2
+ title: Trace
3
+ description: The building block for reasoning, tool calls, sources and more.
4
+ base: base
5
+ component: true
6
+ ---
7
+
8
+ ```tsx
9
+ "use client"
10
+
11
+ import * as React from "react"
12
+ import { useChat } from "@ai-sdk/react"
13
+ import type { UIDataTypes, UIMessage } from "ai"
14
+ import {
15
+ ArrowUpRightIcon,
16
+ CircleAlertIcon,
17
+ CircleCheckIcon,
18
+ GlobeIcon,
19
+ LoaderCircleIcon,
20
+ } from "lucide-react"
21
+
22
+ import { createChat, getMessageText } from "@/lib/ai"
23
+ import { Bubble, BubbleContent } from "@/components/ui/bubble"
24
+ import { Button } from "@/components/ui/button"
25
+ import { CodeBlock, CodeBlockContent } from "@/components/ui/code-block"
26
+ import { Message, MessageContent } from "@/components/ui/message"
27
+ import {
28
+ Trace,
29
+ TraceCollapsible,
30
+ TraceCollapsibleContent,
31
+ TraceCollapsibleTrigger,
32
+ TraceIcon,
33
+ TraceLine,
34
+ TraceTitle,
35
+ } from "@/components/ui/trace"
36
+
37
+ type ChatMessage = UIMessage<
38
+ unknown,
39
+ UIDataTypes,
40
+ {
41
+ runCommand: {
42
+ input: { command: string }
43
+ output: { stdout: string }
44
+ }
45
+ }
46
+ >
47
+
48
+ type Part = ChatMessage["parts"][number]
49
+
50
+ const chat = createChat<ChatMessage>()
51
+ .user("Why does pnpm install fail in CI?")
52
+ .assistant(({ writer }) => {
53
+ writer.reasoning(
54
+ "CI installs with a frozen lockfile, so the install stops when package.json and pnpm-lock.yaml disagree. I should check what the last commit changed, then reproduce the install.",
55
+ { delayMs: 40 }
56
+ )
57
+ writer
58
+ .tool("runCommand", { input: { command: "pnpm --version" } })
59
+ .sleep(700)
60
+ .output({ stdout: "10.18.0" })
61
+ writer
62
+ .tool("runCommand", {
63
+ input: {
64
+ command: "git diff --stat HEAD~1 -- package.json pnpm-lock.yaml",
65
+ },
66
+ })
67
+ .sleep(900)
68
+ .output({
69
+ stdout:
70
+ " package.json | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)",
71
+ })
72
+ writer
73
+ .tool("runCommand", {
74
+ input: { command: "pnpm install --frozen-lockfile" },
75
+ })
76
+ .sleep(1200)
77
+ .error(
78
+ 'ERR_PNPM_OUTDATED_LOCKFILE Cannot install with "frozen-lockfile" because pnpm-lock.yaml is not up to date with package.json'
79
+ )
80
+ writer.sourceUrl({
81
+ url: "https://pnpm.io/cli/install#--frozen-lockfile",
82
+ title: "pnpm install | pnpm.io",
83
+ })
84
+ writer.sourceUrl({
85
+ url: "https://pnpm.io/continuous-integration",
86
+ title: "Continuous Integration | pnpm.io",
87
+ })
88
+ writer.sleep(1000)
89
+ writer.text(
90
+ "The last commit bumped a version in package.json without updating pnpm-lock.yaml, so the frozen install fails. Run pnpm install locally and commit the lockfile."
91
+ )
92
+ })
93
+
94
+ const transcript = chat.get()
95
+ const [question] = chat.get(1)
96
+ const transport = chat.transport({ delayMs: 20 })
97
+
98
+ function ThinkingRow({ text, running }: { text: string; running: boolean }) {
99
+ const [open, setOpen] = React.useState<boolean>()
100
+
101
+ const line = (
102
+ <TraceLine status={running ? "running" : undefined}>
103
+ <TraceIcon>
104
+ {running ? (
105
+ <LoaderCircleIcon className="animate-spin" />
106
+ ) : (
107
+ <CircleCheckIcon />
108
+ )}
109
+ </TraceIcon>
110
+ <TraceTitle>{running ? "Thinking" : "Thought for 5s"}</TraceTitle>
111
+ </TraceLine>
112
+ )
113
+
114
+ if (text.length === 0) {
115
+ return line
116
+ }
117
+
118
+ return (
119
+ <TraceCollapsible open={open ?? running} onOpenChange={setOpen}>
120
+ <TraceCollapsibleTrigger>{line}</TraceCollapsibleTrigger>
121
+ <TraceCollapsibleContent className="whitespace-pre-wrap">
122
+ {text}
123
+ </TraceCollapsibleContent>
124
+ </TraceCollapsible>
125
+ )
126
+ }
127
+
128
+ function ToolRow({
129
+ part,
130
+ streaming,
131
+ defaultOpen,
132
+ }: {
133
+ part: Extract<Part, { type: "tool-runCommand" }>
134
+ streaming: boolean
135
+ defaultOpen?: boolean
136
+ }) {
137
+ const command = part.input?.command
138
+
139
+ if (part.state === "output-available" || part.state === "output-error") {
140
+ const failed = part.state === "output-error"
141
+
142
+ return (
143
+ <TraceCollapsible defaultOpen={defaultOpen}>
144
+ <TraceCollapsibleTrigger>
145
+ <TraceLine status={failed ? "error" : undefined}>
146
+ <TraceIcon>
147
+ {failed ? <CircleAlertIcon /> : <CircleCheckIcon />}
148
+ </TraceIcon>
149
+ <TraceTitle>
150
+ {failed ? "Failed to run" : "Ran"} {command}
151
+ </TraceTitle>
152
+ </TraceLine>
153
+ </TraceCollapsibleTrigger>
154
+ <TraceCollapsibleContent>
155
+ {failed ? (
156
+ <CodeBlock size="sm" variant="destructive">
157
+ <CodeBlockContent wrap className="max-h-64">
158
+ {part.errorText}
159
+ </CodeBlockContent>
160
+ </CodeBlock>
161
+ ) : (
162
+ <CodeBlock size="sm">
163
+ <CodeBlockContent wrap className="max-h-64">
164
+ {part.output.stdout}
165
+ </CodeBlockContent>
166
+ </CodeBlock>
167
+ )}
168
+ </TraceCollapsibleContent>
169
+ </TraceCollapsible>
170
+ )
171
+ }
172
+
173
+ return (
174
+ <TraceLine status={streaming ? "running" : "error"}>
175
+ <TraceIcon>
176
+ {streaming ? (
177
+ <LoaderCircleIcon className="animate-spin" />
178
+ ) : (
179
+ <CircleAlertIcon />
180
+ )}
181
+ </TraceIcon>
182
+ <TraceTitle>
183
+ {streaming ? "Running" : "Failed to run"} {command}
184
+ </TraceTitle>
185
+ </TraceLine>
186
+ )
187
+ }
188
+
189
+ function SourcesRow({
190
+ sources,
191
+ running,
192
+ }: {
193
+ sources: Extract<Part, { type: "source-url" }>[]
194
+ running: boolean
195
+ }) {
196
+ return (
197
+ <TraceCollapsible>
198
+ <TraceCollapsibleTrigger>
199
+ <TraceLine status={running ? "running" : undefined}>
200
+ <TraceIcon>
201
+ {running ? (
202
+ <LoaderCircleIcon className="animate-spin" />
203
+ ) : (
204
+ <GlobeIcon />
205
+ )}
206
+ </TraceIcon>
207
+ <TraceTitle>
208
+ {running ? "Using" : "Used"} {sources.length} sources
209
+ </TraceTitle>
210
+ </TraceLine>
211
+ </TraceCollapsibleTrigger>
212
+ <TraceCollapsibleContent>
213
+ <Trace>
214
+ {sources.map((source) => (
215
+ <a
216
+ key={source.url}
217
+ href={source.url}
218
+ target="_blank"
219
+ rel="noreferrer"
220
+ >
221
+ <TraceLine>
222
+ <TraceIcon>
223
+ <GlobeIcon />
224
+ </TraceIcon>
225
+ <TraceTitle>
226
+ {source.title ?? new URL(source.url).hostname}
227
+ <span className="sr-only"> (opens in a new tab)</span>
228
+ </TraceTitle>
229
+ <TraceIcon>
230
+ <ArrowUpRightIcon />
231
+ </TraceIcon>
232
+ </TraceLine>
233
+ </a>
234
+ ))}
235
+ </Trace>
236
+ </TraceCollapsibleContent>
237
+ </TraceCollapsible>
238
+ )
239
+ }
240
+
241
+ export function TraceDemo() {
242
+ const { messages, sendMessage, setMessages, status } = useChat({
243
+ messages: transcript,
244
+ transport,
245
+ })
246
+ const busy = status === "submitted" || status === "streaming"
247
+
248
+ return (
249
+ <div className="flex min-h-72 w-full max-w-sm flex-col gap-4 py-6 text-sm">
250
+ {messages.map((message) => {
251
+ if (message.role === "user") {
252
+ return (
253
+ <Message key={message.id} align="end">
254
+ <MessageContent>
255
+ <Bubble align="end" variant="muted">
256
+ <BubbleContent>{getMessageText(message)}</BubbleContent>
257
+ </Bubble>
258
+ </MessageContent>
259
+ </Message>
260
+ )
261
+ }
262
+
263
+ const streaming = busy && message === messages.at(-1)
264
+ const rows = message.parts.filter(
265
+ (part) => part.type === "reasoning" || part.type === "tool-runCommand"
266
+ )
267
+ const sources = message.parts.filter(
268
+ (part) => part.type === "source-url"
269
+ )
270
+ const text = getMessageText(message)
271
+
272
+ return (
273
+ <Message key={message.id}>
274
+ <MessageContent className="gap-4">
275
+ {rows.length + sources.length > 0 && (
276
+ <Trace>
277
+ {rows.map((part, index) =>
278
+ part.type === "reasoning" ? (
279
+ <ThinkingRow
280
+ key={index}
281
+ text={part.text}
282
+ running={streaming && part.state === "streaming"}
283
+ />
284
+ ) : part.type === "tool-runCommand" ? (
285
+ <ToolRow
286
+ key={part.toolCallId}
287
+ part={part}
288
+ streaming={streaming}
289
+ defaultOpen={index === 2}
290
+ />
291
+ ) : null
292
+ )}
293
+ {sources.length > 0 && (
294
+ <SourcesRow
295
+ sources={sources}
296
+ running={streaming && text.length === 0}
297
+ />
298
+ )}
299
+ </Trace>
300
+ )}
301
+ {text && <p>{text}</p>}
302
+ </MessageContent>
303
+ </Message>
304
+ )
305
+ })}
306
+ {!busy && (
307
+ <Button
308
+ variant="outline"
309
+ size="sm"
310
+ className="mt-auto self-start"
311
+ onClick={() => {
312
+ setMessages([])
313
+ sendMessage(question)
314
+ }}
315
+ >
316
+ Replay
317
+ </Button>
318
+ )}
319
+ </div>
320
+ )
321
+ }
322
+
323
+ ```
324
+
325
+ `Trace` is a list of lines. Each line has an icon, a title, and an optional description and status. A line can expand to show more detail, link to a page, or open a dialog or sheet.
326
+
327
+ Every line has the same shape, so reasoning, tool calls, sources and plans built from `Trace` look and behave the same.
328
+
329
+ Use `Trace` for the steps an agent takes, like calling a tool, running a subagent or editing a file. Use [Message](/docs/components/base/message) for its reply, and [Marker](/docs/components/base/marker) for notes and dividers between turns.
330
+
331
+ ## Built with Trace
332
+
333
+ Every pattern below is a composition of `Trace` parts. See [AI Elements](/docs/ai-elements) for examples and code.
334
+
335
+ | Pattern | Shows |
336
+ | ----------------------------------------------------------- | ---------------------------------------------------------------- |
337
+ | [Chain of Thought](/docs/ai-elements/base/chain-of-thought) | A summary that expands into the steps behind it. |
338
+ | [Plan](/docs/ai-elements/base/plan) | The steps the agent plans to take, and how far it has got. |
339
+ | [Queue](/docs/ai-elements/base/queue) | The agent's todo list, split into what is left and what is done. |
340
+ | [Reasoning](/docs/ai-elements/base/reasoning) | The agent's thinking as it streams. |
341
+ | [Sources](/docs/ai-elements/base/sources) | The links the agent used for a reply. |
342
+ | [Stack Trace](/docs/ai-elements/base/stack-trace) | A failed tool call and its stack frames. |
343
+ | [Subagent](/docs/ai-elements/base/subagent) | A subagent run, with its tool calls and result. |
344
+ | [Task](/docs/ai-elements/base/task) | The steps the agent takes, as it takes them. |
345
+ | [Terminal](/docs/ai-elements/base/terminal) | A command the agent runs, with its output as it streams. |
346
+ | [Test Results](/docs/ai-elements/base/test-results) | A test run by the agent, with its suites and failures. |
347
+ | [Tool](/docs/ai-elements/base/tool) | A tool call the agent makes, from input to output. |
348
+
349
+ ## Installation
350
+
351
+ <CodeTabs>
352
+
353
+ <TabsList>
354
+ <TabsTrigger value="cli">Command</TabsTrigger>
355
+ <TabsTrigger value="manual">Manual</TabsTrigger>
356
+ </TabsList>
357
+ <TabsContent value="cli">
358
+
359
+ ```bash
360
+ npx shadcn@latest add trace
361
+ ```
362
+
363
+ </TabsContent>
364
+
365
+ <TabsContent value="manual">
366
+
367
+ <Steps className="mb-0 pt-2">
368
+
369
+ <Step>Install the required shadcn/ui dependencies:</Step>
370
+
371
+ ```bash
372
+ npx shadcn@latest add collapsible
373
+ ```
374
+
375
+ <Step>Copy and paste the following code into your project.</Step>
376
+
377
+ <ComponentSource
378
+ name="trace"
379
+ title="components/ui/trace.tsx"
380
+ styleName="base-rhea"
381
+ />
382
+
383
+ <Step>Update the import paths to match your project setup.</Step>
384
+
385
+ </Steps>
386
+
387
+ </TabsContent>
388
+
389
+ </CodeTabs>
390
+
391
+ ## Usage
392
+
393
+ Use a `TraceLine` for a single step:
394
+
395
+ ```tsx showLineNumbers
396
+ import { Trace, TraceIcon, TraceLine, TraceTitle } from "@/components/ui/trace"
397
+ ```
398
+
399
+ ```tsx showLineNumbers
400
+ <Trace>
401
+ <TraceLine>
402
+ <TraceIcon>
403
+ <SearchIcon />
404
+ </TraceIcon>
405
+ <TraceTitle>Searched for minimumReleaseAge</TraceTitle>
406
+ </TraceLine>
407
+ </Trace>
408
+ ```
409
+
410
+ Wrap the line in a `TraceCollapsible` to show more detail when it expands:
411
+
412
+ ```tsx showLineNumbers
413
+ import {
414
+ Trace,
415
+ TraceCollapsible,
416
+ TraceCollapsibleContent,
417
+ TraceCollapsibleTrigger,
418
+ TraceIcon,
419
+ TraceLine,
420
+ TraceTitle,
421
+ } from "@/components/ui/trace"
422
+ ```
423
+
424
+ ```tsx showLineNumbers
425
+ <Trace>
426
+ <TraceCollapsible>
427
+ <TraceCollapsibleTrigger>
428
+ <TraceLine>
429
+ <TraceIcon>
430
+ <TerminalIcon />
431
+ </TraceIcon>
432
+ <TraceTitle>Ran node --version</TraceTitle>
433
+ </TraceLine>
434
+ </TraceCollapsibleTrigger>
435
+ <TraceCollapsibleContent>v24.18.0</TraceCollapsibleContent>
436
+ </TraceCollapsible>
437
+ </Trace>
438
+ ```
439
+
440
+ ## Composition
441
+
442
+ Use the following composition to build a trace line:
443
+
444
+ ```text
445
+ Trace
446
+ └── TraceLine
447
+ ├── TraceIcon
448
+ ├── TraceTitle
449
+ ├── TraceDescription
450
+ └── TraceIcon
451
+ ```
452
+
453
+ Wrap the line in a `TraceCollapsible` to show more detail when it expands:
454
+
455
+ ```text
456
+ Trace
457
+ └── TraceCollapsible
458
+ ├── TraceCollapsibleTrigger
459
+ │ └── TraceLine
460
+ └── TraceCollapsibleContent
461
+ ```
462
+
463
+ `TraceLine` is always the line. To make a line do something, wrap it in that thing's trigger.
464
+
465
+ ## Features
466
+
467
+ - One row for reasoning, tool calls, sources, plans and tasks
468
+ - Rows that expand, link out, or open a dialog, sheet, drawer or popover
469
+ - `running`, `error` and `pending` states, with a shimmer while running
470
+ - Nested rows, so a summary expands into steps and a step into its output
471
+ - Works with reasoning, tool and source parts from the AI SDK
472
+ - Keyboard and screen reader support from the trigger that wraps each row
473
+ - Customizable styling through the `className` prop on every part
474
+
475
+ ## Trace Line
476
+
477
+ Use a `TraceLine` on its own for a step with no detail to show. It reads as plain text.
478
+
479
+ ```tsx
480
+ import { GitBranchIcon } from "lucide-react"
481
+
482
+ import {
483
+ Trace,
484
+ TraceIcon,
485
+ TraceLine,
486
+ TraceTitle,
487
+ } from "@/components/ui/trace"
488
+
489
+ export function TraceStatic() {
490
+ return (
491
+ <Trace className="max-w-sm">
492
+ <TraceLine>
493
+ <TraceIcon>
494
+ <GitBranchIcon />
495
+ </TraceIcon>
496
+ <TraceTitle>Created branch fix/frozen-lockfile</TraceTitle>
497
+ </TraceLine>
498
+ </Trace>
499
+ )
500
+ }
501
+
502
+ ```
503
+
504
+ ## Status
505
+
506
+ Set `status` on `TraceLine` when a step is running, has failed or hasn't started yet.
507
+
508
+ ```tsx
509
+ import {
510
+ CircleAlertIcon,
511
+ CircleCheckIcon,
512
+ CircleIcon,
513
+ LoaderCircleIcon,
514
+ } from "lucide-react"
515
+
516
+ import {
517
+ Trace,
518
+ TraceIcon,
519
+ TraceLine,
520
+ TraceTitle,
521
+ } from "@/components/ui/trace"
522
+
523
+ export function TraceStatus() {
524
+ return (
525
+ <Trace className="max-w-sm">
526
+ <TraceLine>
527
+ <TraceIcon>
528
+ <CircleCheckIcon />
529
+ </TraceIcon>
530
+ <TraceTitle>Ran pnpm install</TraceTitle>
531
+ </TraceLine>
532
+ <TraceLine status="error">
533
+ <TraceIcon>
534
+ <CircleAlertIcon />
535
+ </TraceIcon>
536
+ <TraceTitle>Failed to run pnpm lint</TraceTitle>
537
+ </TraceLine>
538
+ <TraceLine status="running">
539
+ <TraceIcon>
540
+ <LoaderCircleIcon className="animate-spin" />
541
+ </TraceIcon>
542
+ <TraceTitle>Running pnpm build</TraceTitle>
543
+ </TraceLine>
544
+ <TraceLine status="pending">
545
+ <TraceIcon>
546
+ <CircleIcon />
547
+ </TraceIcon>
548
+ <TraceTitle>Run pnpm test</TraceTitle>
549
+ </TraceLine>
550
+ </Trace>
551
+ )
552
+ }
553
+
554
+ ```
555
+
556
+ | Status | Use for |
557
+ | ----------- | ----------------------------------------------------------------------------- |
558
+ | none | Work that is done: "Ran pnpm install". |
559
+ | `"error"` | Work that failed. Say so in the title: "Failed to run pnpm lint". |
560
+ | `"running"` | Work in progress. Write the title in the present tense: "Running pnpm build". |
561
+ | `"pending"` | Work that has not started, such as a plan step: "Run pnpm test". |
562
+
563
+ ## Description
564
+
565
+ Put secondary text such as a diff stat, a duration or a count in a `TraceDescription` after the `TraceTitle`. It does not truncate.
566
+
567
+ ```tsx
568
+ import { FilePenIcon, SearchIcon, TerminalIcon } from "lucide-react"
569
+
570
+ import {
571
+ Trace,
572
+ TraceDescription,
573
+ TraceIcon,
574
+ TraceLine,
575
+ TraceTitle,
576
+ } from "@/components/ui/trace"
577
+
578
+ export function TraceDescriptionDemo() {
579
+ return (
580
+ <Trace className="max-w-sm">
581
+ <TraceLine>
582
+ <TraceIcon>
583
+ <FilePenIcon />
584
+ </TraceIcon>
585
+ <TraceTitle>
586
+ Edited components/settings/notification-preferences-form.tsx
587
+ </TraceTitle>
588
+ <TraceDescription className="font-mono">+48 −12</TraceDescription>
589
+ </TraceLine>
590
+ <TraceLine>
591
+ <TraceIcon>
592
+ <TerminalIcon />
593
+ </TraceIcon>
594
+ <TraceTitle>Ran pnpm test</TraceTitle>
595
+ <TraceDescription>14s</TraceDescription>
596
+ </TraceLine>
597
+ <TraceLine>
598
+ <TraceIcon>
599
+ <SearchIcon />
600
+ </TraceIcon>
601
+ <TraceTitle>Searched for useChat</TraceTitle>
602
+ <TraceDescription>8 results</TraceDescription>
603
+ </TraceLine>
604
+ </Trace>
605
+ )
606
+ }
607
+
608
+ ```
609
+
610
+ ## Collapsible
611
+
612
+ Wrap the line in a `TraceCollapsible` to show more detail when it expands. Put the `TraceLine` inside `TraceCollapsibleTrigger` and the detail in `TraceCollapsibleContent`.
613
+
614
+ ```tsx
615
+ import { TerminalIcon } from "lucide-react"
616
+
617
+ import { CodeBlock, CodeBlockContent } from "@/components/ui/code-block"
618
+ import {
619
+ TraceCollapsible,
620
+ TraceCollapsibleContent,
621
+ TraceCollapsibleTrigger,
622
+ TraceIcon,
623
+ TraceLine,
624
+ TraceTitle,
625
+ } from "@/components/ui/trace"
626
+
627
+ export function TraceCollapsibleDemo() {
628
+ return (
629
+ <div className="w-full max-w-sm">
630
+ <TraceCollapsible>
631
+ <TraceCollapsibleTrigger>
632
+ <TraceLine>
633
+ <TraceIcon>
634
+ <TerminalIcon />
635
+ </TraceIcon>
636
+ <TraceTitle>Ran node --version</TraceTitle>
637
+ </TraceLine>
638
+ </TraceCollapsibleTrigger>
639
+ <TraceCollapsibleContent>
640
+ <CodeBlock size="sm">
641
+ <CodeBlockContent wrap className="max-h-64">
642
+ {"$ node --version\nv24.18.0"}
643
+ </CodeBlockContent>
644
+ </CodeBlock>
645
+ </TraceCollapsibleContent>
646
+ </TraceCollapsible>
647
+ </div>
648
+ )
649
+ }
650
+
651
+ ```
652
+
653
+ ## Open State
654
+
655
+ Rows start closed. Use `defaultOpen` on `TraceCollapsible` to start open, or `open` with `onOpenChange` to control a row.
656
+
657
+ ```tsx
658
+ "use client"
659
+
660
+ import * as React from "react"
661
+ import { TerminalIcon } from "lucide-react"
662
+
663
+ import { Button } from "@/components/ui/button"
664
+ import { CodeBlock, CodeBlockContent } from "@/components/ui/code-block"
665
+ import {
666
+ TraceCollapsible,
667
+ TraceCollapsibleContent,
668
+ TraceCollapsibleTrigger,
669
+ TraceIcon,
670
+ TraceLine,
671
+ TraceTitle,
672
+ } from "@/components/ui/trace"
673
+
674
+ export function TraceOpen() {
675
+ const [open, setOpen] = React.useState(false)
676
+
677
+ return (
678
+ <div className="flex w-full max-w-sm flex-col items-start gap-4">
679
+ <TraceCollapsible defaultOpen>
680
+ <TraceCollapsibleTrigger>
681
+ <TraceLine>
682
+ <TraceIcon>
683
+ <TerminalIcon />
684
+ </TraceIcon>
685
+ <TraceTitle>Ran node --version</TraceTitle>
686
+ </TraceLine>
687
+ </TraceCollapsibleTrigger>
688
+ <TraceCollapsibleContent>
689
+ <CodeBlock size="sm">
690
+ <CodeBlockContent wrap className="max-h-64">
691
+ {"$ node --version\nv24.18.0"}
692
+ </CodeBlockContent>
693
+ </CodeBlock>
694
+ </TraceCollapsibleContent>
695
+ </TraceCollapsible>
696
+ <TraceCollapsible open={open} onOpenChange={setOpen}>
697
+ <TraceCollapsibleTrigger>
698
+ <TraceLine>
699
+ <TraceIcon>
700
+ <TerminalIcon />
701
+ </TraceIcon>
702
+ <TraceTitle>Ran pnpm --version</TraceTitle>
703
+ </TraceLine>
704
+ </TraceCollapsibleTrigger>
705
+ <TraceCollapsibleContent>
706
+ <CodeBlock size="sm">
707
+ <CodeBlockContent wrap className="max-h-64">
708
+ {"$ pnpm --version\n10.33.4"}
709
+ </CodeBlockContent>
710
+ </CodeBlock>
711
+ </TraceCollapsibleContent>
712
+ </TraceCollapsible>
713
+ <Button variant="outline" size="sm" onClick={() => setOpen(!open)}>
714
+ {open ? "Hide" : "Show"} the pnpm output
715
+ </Button>
716
+ </div>
717
+ )
718
+ }
719
+
720
+ ```
721
+
722
+ To open a row while it streams and let the reader's click win, pass `open ?? running`.
723
+
724
+ ```tsx showLineNumbers
725
+ const [open, setOpen] = React.useState<boolean>()
726
+
727
+ <TraceCollapsible
728
+ open={open ?? running}
729
+ onOpenChange={setOpen}
730
+ >
731
+ <TraceCollapsibleTrigger>
732
+ <TraceLine status={running ? "running" : undefined}>…</TraceLine>
733
+ </TraceCollapsibleTrigger>
734
+ <TraceCollapsibleContent>{text}</TraceCollapsibleContent>
735
+ </TraceCollapsible>
736
+ ```
737
+
738
+ ## Link
739
+
740
+ Wrap the `TraceLine` in an anchor. For a new tab, use an arrow-up-right icon and sr-only "(opens in a new tab)".
741
+
742
+ ```tsx
743
+ import {
744
+ ArrowUpRightIcon,
745
+ ChevronRightIcon,
746
+ FileTextIcon,
747
+ GlobeIcon,
748
+ } from "lucide-react"
749
+
750
+ import {
751
+ Trace,
752
+ TraceIcon,
753
+ TraceLine,
754
+ TraceTitle,
755
+ } from "@/components/ui/trace"
756
+
757
+ export function TraceLink() {
758
+ return (
759
+ <Trace className="max-w-sm">
760
+ <a href="#link">
761
+ <TraceLine>
762
+ <TraceIcon>
763
+ <FileTextIcon />
764
+ </TraceIcon>
765
+ <TraceTitle>Read apps/v4/lib/docs.ts</TraceTitle>
766
+ <TraceIcon>
767
+ <ChevronRightIcon />
768
+ </TraceIcon>
769
+ </TraceLine>
770
+ </a>
771
+ <a
772
+ href="https://docs.astro.build/en/install-and-setup/"
773
+ target="_blank"
774
+ rel="noreferrer"
775
+ >
776
+ <TraceLine>
777
+ <TraceIcon>
778
+ <GlobeIcon />
779
+ </TraceIcon>
780
+ <TraceTitle>
781
+ Install Astro | docs.astro.build
782
+ <span className="sr-only"> (opens in a new tab)</span>
783
+ </TraceTitle>
784
+ <TraceIcon>
785
+ <ArrowUpRightIcon />
786
+ </TraceIcon>
787
+ </TraceLine>
788
+ </a>
789
+ </Trace>
790
+ )
791
+ }
792
+
793
+ ```
794
+
795
+ ```tsx showLineNumbers
796
+ <a href="https://docs.astro.build" target="_blank" rel="noreferrer">
797
+ <TraceLine>
798
+ <TraceTitle>
799
+ Install Astro
800
+ <span className="sr-only"> (opens in a new tab)</span>
801
+ </TraceTitle>
802
+ <TraceIcon>
803
+ <ArrowUpRightIcon />
804
+ </TraceIcon>
805
+ </TraceLine>
806
+ </a>
807
+ ```
808
+
809
+ ## Dialog
810
+
811
+ Wrap the `TraceLine` in the dialog's trigger. The dialog owns its open state, Escape and focus return.
812
+
813
+ ```tsx
814
+ import { ArrowUpRightIcon, ChevronRightIcon, GlobeIcon } from "lucide-react"
815
+
816
+ import {
817
+ Dialog,
818
+ DialogContent,
819
+ DialogDescription,
820
+ DialogHeader,
821
+ DialogTitle,
822
+ DialogTrigger,
823
+ } from "@/components/ui/dialog"
824
+ import {
825
+ Trace,
826
+ TraceIcon,
827
+ TraceLine,
828
+ TraceTitle,
829
+ } from "@/components/ui/trace"
830
+
831
+ const results = [
832
+ {
833
+ title: "Caching build outputs",
834
+ url: "https://nextjs.org/docs/app/guides/caching",
835
+ },
836
+ {
837
+ title: "Image optimization reference",
838
+ url: "https://nextjs.org/docs/app/api-reference/components/image",
839
+ },
840
+ {
841
+ title: "Deploy hooks and cache keys",
842
+ url: "https://vercel.com/docs/deploy-hooks",
843
+ },
844
+ ]
845
+
846
+ export function TraceDialog() {
847
+ return (
848
+ <Trace className="max-w-sm">
849
+ <Dialog>
850
+ <DialogTrigger>
851
+ <TraceLine>
852
+ <TraceIcon>
853
+ <GlobeIcon />
854
+ </TraceIcon>
855
+ <TraceTitle>Searched the web for cache keys</TraceTitle>
856
+ <TraceIcon>
857
+ <ChevronRightIcon />
858
+ </TraceIcon>
859
+ </TraceLine>
860
+ </DialogTrigger>
861
+ <DialogContent>
862
+ <DialogHeader>
863
+ <DialogTitle>Searched the web for cache keys</DialogTitle>
864
+ <DialogDescription>
865
+ Three results were used in the response.
866
+ </DialogDescription>
867
+ </DialogHeader>
868
+ <Trace>
869
+ {results.map((result) => (
870
+ <a
871
+ key={result.url}
872
+ href={result.url}
873
+ target="_blank"
874
+ rel="noreferrer"
875
+ >
876
+ <TraceLine>
877
+ <TraceIcon>
878
+ <GlobeIcon />
879
+ </TraceIcon>
880
+ <TraceTitle>
881
+ {result.title}
882
+ <span className="sr-only"> (opens in a new tab)</span>
883
+ </TraceTitle>
884
+ <TraceIcon>
885
+ <ArrowUpRightIcon />
886
+ </TraceIcon>
887
+ </TraceLine>
888
+ </a>
889
+ ))}
890
+ </Trace>
891
+ </DialogContent>
892
+ </Dialog>
893
+ </Trace>
894
+ )
895
+ }
896
+
897
+ ```
898
+
899
+ ```tsx showLineNumbers
900
+ <Dialog>
901
+ <DialogTrigger>
902
+ <TraceLine>
903
+ <TraceTitle>Searched the web for cache keys</TraceTitle>
904
+ <TraceIcon>
905
+ <ChevronRightIcon />
906
+ </TraceIcon>
907
+ </TraceLine>
908
+ </DialogTrigger>
909
+ <DialogContent>…</DialogContent>
910
+ </Dialog>
911
+ ```
912
+
913
+ ## Sheet
914
+
915
+ The same shape as the dialog. Drawer and Popover work the same way.
916
+
917
+ ```tsx
918
+ import { ChevronRightIcon, FolderSearchIcon } from "lucide-react"
919
+
920
+ import {
921
+ Sheet,
922
+ SheetContent,
923
+ SheetDescription,
924
+ SheetHeader,
925
+ SheetTitle,
926
+ SheetTrigger,
927
+ } from "@/components/ui/sheet"
928
+ import {
929
+ Trace,
930
+ TraceIcon,
931
+ TraceLine,
932
+ TraceTitle,
933
+ } from "@/components/ui/trace"
934
+
935
+ export function TraceSheet() {
936
+ return (
937
+ <Trace className="max-w-sm">
938
+ <Sheet>
939
+ <SheetTrigger>
940
+ <TraceLine>
941
+ <TraceIcon>
942
+ <FolderSearchIcon />
943
+ </TraceIcon>
944
+ <TraceTitle>Explored 4 files</TraceTitle>
945
+ <TraceIcon>
946
+ <ChevronRightIcon />
947
+ </TraceIcon>
948
+ </TraceLine>
949
+ </SheetTrigger>
950
+ <SheetContent>
951
+ <SheetHeader>
952
+ <SheetTitle>Explored 4 files</SheetTitle>
953
+ <SheetDescription>
954
+ Files read while preparing the response.
955
+ </SheetDescription>
956
+ </SheetHeader>
957
+ <ul className="flex flex-col gap-2 px-6 font-mono text-xs">
958
+ <li>apps/v4/lib/docs.ts</li>
959
+ <li>apps/v4/lib/components.ts</li>
960
+ <li>apps/v4/next.config.mjs</li>
961
+ <li>apps/v4/package.json</li>
962
+ </ul>
963
+ </SheetContent>
964
+ </Sheet>
965
+ </Trace>
966
+ )
967
+ }
968
+
969
+ ```
970
+
971
+ ## Group
972
+
973
+ Put rows that sit next to each other in a `Trace`. It also styles any trigger or link that wraps a `TraceLine`.
974
+
975
+ ```tsx
976
+ import { FileTextIcon, SearchIcon, TerminalIcon } from "lucide-react"
977
+
978
+ import {
979
+ Trace,
980
+ TraceIcon,
981
+ TraceLine,
982
+ TraceTitle,
983
+ } from "@/components/ui/trace"
984
+
985
+ export function TraceGroupDemo() {
986
+ return (
987
+ <Trace className="max-w-sm">
988
+ <TraceLine>
989
+ <TraceIcon>
990
+ <SearchIcon />
991
+ </TraceIcon>
992
+ <TraceTitle>Searched for minimumReleaseAge</TraceTitle>
993
+ </TraceLine>
994
+ <TraceLine>
995
+ <TraceIcon>
996
+ <FileTextIcon />
997
+ </TraceIcon>
998
+ <TraceTitle>Read pnpm-workspace.yaml</TraceTitle>
999
+ </TraceLine>
1000
+ <TraceLine>
1001
+ <TraceIcon>
1002
+ <TerminalIcon />
1003
+ </TraceIcon>
1004
+ <TraceTitle>Ran pnpm install</TraceTitle>
1005
+ </TraceLine>
1006
+ </Trace>
1007
+ )
1008
+ }
1009
+
1010
+ ```
1011
+
1012
+ ## Sources
1013
+
1014
+ A collapsible row whose detail is a `Trace` of link rows.
1015
+
1016
+ ```tsx
1017
+ import { ArrowUpRightIcon, GlobeIcon } from "lucide-react"
1018
+
1019
+ import {
1020
+ Trace,
1021
+ TraceCollapsible,
1022
+ TraceCollapsibleContent,
1023
+ TraceCollapsibleTrigger,
1024
+ TraceIcon,
1025
+ TraceLine,
1026
+ TraceTitle,
1027
+ } from "@/components/ui/trace"
1028
+
1029
+ const sources = [
1030
+ {
1031
+ title: "Install Astro | docs.astro.build",
1032
+ href: "https://docs.astro.build/en/install-and-setup/",
1033
+ },
1034
+ {
1035
+ title: "create-astro | npmjs.com",
1036
+ href: "https://www.npmjs.com/package/create-astro",
1037
+ },
1038
+ {
1039
+ title: "Settings: minimumReleaseAge | pnpm.io",
1040
+ href: "https://pnpm.io/settings#minimumreleaseage",
1041
+ },
1042
+ ]
1043
+
1044
+ export function TraceSources() {
1045
+ return (
1046
+ <div className="w-full max-w-sm">
1047
+ <TraceCollapsible defaultOpen>
1048
+ <TraceCollapsibleTrigger>
1049
+ <TraceLine>
1050
+ <TraceIcon>
1051
+ <GlobeIcon />
1052
+ </TraceIcon>
1053
+ <TraceTitle>Used {sources.length} sources</TraceTitle>
1054
+ </TraceLine>
1055
+ </TraceCollapsibleTrigger>
1056
+ <TraceCollapsibleContent>
1057
+ <Trace>
1058
+ {sources.map((source) => (
1059
+ <a
1060
+ key={source.href}
1061
+ href={source.href}
1062
+ target="_blank"
1063
+ rel="noreferrer"
1064
+ >
1065
+ <TraceLine>
1066
+ <TraceIcon>
1067
+ <GlobeIcon />
1068
+ </TraceIcon>
1069
+ <TraceTitle>
1070
+ {source.title}
1071
+ <span className="sr-only"> (opens in a new tab)</span>
1072
+ </TraceTitle>
1073
+ <TraceIcon>
1074
+ <ArrowUpRightIcon />
1075
+ </TraceIcon>
1076
+ </TraceLine>
1077
+ </a>
1078
+ ))}
1079
+ </Trace>
1080
+ </TraceCollapsibleContent>
1081
+ </TraceCollapsible>
1082
+ </div>
1083
+ )
1084
+ }
1085
+
1086
+ ```
1087
+
1088
+ See [Sources](/docs/ai-elements/base/sources) for more examples.
1089
+
1090
+ ## Chain of Thought
1091
+
1092
+ A chain of thought is a collapsible row with step rows inside. Set the parent's status and title from its children.
1093
+
1094
+ ```tsx
1095
+ import { ChevronRightIcon, FileTextIcon, SearchIcon } from "lucide-react"
1096
+
1097
+ import { Badge } from "@/components/ui/badge"
1098
+ import { CodeBlock, CodeBlockContent } from "@/components/ui/code-block"
1099
+ import {
1100
+ Trace,
1101
+ TraceCollapsible,
1102
+ TraceCollapsibleContent,
1103
+ TraceCollapsibleTrigger,
1104
+ TraceIcon,
1105
+ TraceLine,
1106
+ TraceTitle,
1107
+ } from "@/components/ui/trace"
1108
+
1109
+ export function TraceSteps() {
1110
+ return (
1111
+ <div className="w-full max-w-sm">
1112
+ <TraceCollapsible defaultOpen>
1113
+ <TraceCollapsibleTrigger>
1114
+ <TraceLine status="running">
1115
+ <TraceTitle>Looking into the slow deploy</TraceTitle>
1116
+ </TraceLine>
1117
+ </TraceCollapsibleTrigger>
1118
+ <TraceCollapsibleContent keepMounted>
1119
+ <Trace>
1120
+ <TraceCollapsible>
1121
+ <TraceCollapsibleTrigger>
1122
+ <TraceLine>
1123
+ <TraceIcon>
1124
+ <SearchIcon />
1125
+ </TraceIcon>
1126
+ <TraceTitle>Searched for the checkout build log</TraceTitle>
1127
+ </TraceLine>
1128
+ </TraceCollapsibleTrigger>
1129
+ <TraceCollapsibleContent className="flex flex-wrap gap-1.5">
1130
+ <Badge variant="secondary">vercel.com</Badge>
1131
+ <Badge variant="secondary">github.com</Badge>
1132
+ </TraceCollapsibleContent>
1133
+ </TraceCollapsible>
1134
+ <a href="#steps">
1135
+ <TraceLine>
1136
+ <TraceIcon>
1137
+ <FileTextIcon />
1138
+ </TraceIcon>
1139
+ <TraceTitle>Read the last twelve deploys</TraceTitle>
1140
+ <TraceIcon>
1141
+ <ChevronRightIcon />
1142
+ </TraceIcon>
1143
+ </TraceLine>
1144
+ </a>
1145
+ <TraceCollapsible>
1146
+ <TraceCollapsibleTrigger>
1147
+ <TraceLine status="running">
1148
+ <TraceIcon>
1149
+ <SearchIcon />
1150
+ </TraceIcon>
1151
+ <TraceTitle>Searching for the cache key</TraceTitle>
1152
+ </TraceLine>
1153
+ </TraceCollapsibleTrigger>
1154
+ <TraceCollapsibleContent>
1155
+ <CodeBlock size="sm">
1156
+ <CodeBlockContent wrap className="max-h-64">
1157
+ cache key image optimization
1158
+ </CodeBlockContent>
1159
+ </CodeBlock>
1160
+ </TraceCollapsibleContent>
1161
+ </TraceCollapsible>
1162
+ </Trace>
1163
+ </TraceCollapsibleContent>
1164
+ </TraceCollapsible>
1165
+ </div>
1166
+ )
1167
+ }
1168
+
1169
+ ```
1170
+
1171
+ See [Chain of Thought](/docs/ai-elements/base/chain-of-thought) and [Task](/docs/ai-elements/base/task) for more examples.
1172
+
1173
+ ## Commit
1174
+
1175
+ A commit is a collapsible row with a line for each changed file. Say what changed in the title, Added, Edited or Deleted, and put the line counts in the description. Each file opens its diff in a [Sheet](#sheet).
1176
+
1177
+ ```tsx
1178
+ import {
1179
+ ChevronRightIcon,
1180
+ FilePenIcon,
1181
+ FilePlusIcon,
1182
+ GitCommitHorizontalIcon,
1183
+ } from "lucide-react"
1184
+
1185
+ import {
1186
+ CodeBlock,
1187
+ CodeBlockContent,
1188
+ CodeBlockLine,
1189
+ } from "@/components/ui/code-block"
1190
+ import {
1191
+ Sheet,
1192
+ SheetContent,
1193
+ SheetDescription,
1194
+ SheetHeader,
1195
+ SheetTitle,
1196
+ SheetTrigger,
1197
+ } from "@/components/ui/sheet"
1198
+ import {
1199
+ Trace,
1200
+ TraceCollapsible,
1201
+ TraceCollapsibleContent,
1202
+ TraceCollapsibleTrigger,
1203
+ TraceDescription,
1204
+ TraceIcon,
1205
+ TraceLine,
1206
+ TraceTitle,
1207
+ } from "@/components/ui/trace"
1208
+
1209
+ const files = [
1210
+ {
1211
+ path: "app/login/page.tsx",
1212
+ added: false,
1213
+ additions: 2,
1214
+ deletions: 2,
1215
+ diff: `@@ -14,7 +14,7 @@ export async function LoginPage({
1216
+ searchParams,
1217
+ }) {
1218
+ const { next } = await searchParams
1219
+ - const redirectTo =
1220
+ - next && next.startsWith("/") ? next : "/"
1221
+ + const redirectTo = safeRedirect(next)
1222
+ +
1223
+ return <LoginForm redirectTo={redirectTo} />
1224
+ }`,
1225
+ },
1226
+ {
1227
+ path: "lib/auth/redirect.ts",
1228
+ added: true,
1229
+ additions: 7,
1230
+ deletions: 0,
1231
+ diff: `@@ -0,0 +1,7 @@
1232
+ +export function safeRedirect(next: string | undefined) {
1233
+ + if (!next || !next.startsWith("/") || next.startsWith("//")) {
1234
+ + return "/"
1235
+ + }
1236
+ +
1237
+ + return next
1238
+ +}`,
1239
+ },
1240
+ ]
1241
+
1242
+ function DiffLines({ diff }: { diff: string }) {
1243
+ return diff.split("\n").map((line, index) => {
1244
+ if (line.startsWith("@@")) {
1245
+ return (
1246
+ <CodeBlockLine key={index} className="text-muted-foreground">
1247
+ {line}
1248
+ </CodeBlockLine>
1249
+ )
1250
+ }
1251
+
1252
+ return (
1253
+ <CodeBlockLine
1254
+ key={index}
1255
+ variant={
1256
+ line.startsWith("+")
1257
+ ? "added"
1258
+ : line.startsWith("-")
1259
+ ? "removed"
1260
+ : "default"
1261
+ }
1262
+ >
1263
+ {line.slice(1)}
1264
+ </CodeBlockLine>
1265
+ )
1266
+ })
1267
+ }
1268
+
1269
+ export function TraceCommit() {
1270
+ return (
1271
+ <Trace className="max-w-sm">
1272
+ <TraceCollapsible defaultOpen>
1273
+ <TraceCollapsibleTrigger>
1274
+ <TraceLine>
1275
+ <TraceIcon>
1276
+ <GitCommitHorizontalIcon />
1277
+ </TraceIcon>
1278
+ <TraceTitle>Committed a1b2c3: Fix the login redirect</TraceTitle>
1279
+ </TraceLine>
1280
+ </TraceCollapsibleTrigger>
1281
+ <TraceCollapsibleContent>
1282
+ <Trace>
1283
+ {files.map((file) => (
1284
+ <Sheet key={file.path}>
1285
+ <SheetTrigger>
1286
+ <TraceLine>
1287
+ <TraceIcon>
1288
+ {file.added ? <FilePlusIcon /> : <FilePenIcon />}
1289
+ </TraceIcon>
1290
+ <TraceTitle>
1291
+ {file.added ? "Added" : "Edited"} {file.path}
1292
+ </TraceTitle>
1293
+ <TraceDescription className="font-mono">
1294
+ +{file.additions} −{file.deletions}
1295
+ </TraceDescription>
1296
+ <TraceIcon>
1297
+ <ChevronRightIcon />
1298
+ </TraceIcon>
1299
+ </TraceLine>
1300
+ </SheetTrigger>
1301
+ <SheetContent>
1302
+ <SheetHeader>
1303
+ <SheetTitle className="font-mono">{file.path}</SheetTitle>
1304
+ <SheetDescription>
1305
+ {file.additions} additions, {file.deletions} deletions
1306
+ </SheetDescription>
1307
+ </SheetHeader>
1308
+ <CodeBlock className="mx-6 mb-6 w-auto">
1309
+ <CodeBlockContent>
1310
+ <DiffLines diff={file.diff} />
1311
+ </CodeBlockContent>
1312
+ </CodeBlock>
1313
+ </SheetContent>
1314
+ </Sheet>
1315
+ ))}
1316
+ </Trace>
1317
+ </TraceCollapsibleContent>
1318
+ </TraceCollapsible>
1319
+ </Trace>
1320
+ )
1321
+ }
1322
+
1323
+ ```
1324
+
1325
+ ## Whole Turn
1326
+
1327
+ Three levels: the turn, a summary, and the rows. Text between steps sits between two `Trace` lists.
1328
+
1329
+ ```tsx
1330
+ import {
1331
+ BrainIcon,
1332
+ ChevronRightIcon,
1333
+ FileTextIcon,
1334
+ TerminalIcon,
1335
+ } from "lucide-react"
1336
+
1337
+ import { CodeBlock, CodeBlockContent } from "@/components/ui/code-block"
1338
+ import {
1339
+ Trace,
1340
+ TraceCollapsible,
1341
+ TraceCollapsibleContent,
1342
+ TraceCollapsibleTrigger,
1343
+ TraceDescription,
1344
+ TraceIcon,
1345
+ TraceLine,
1346
+ TraceTitle,
1347
+ } from "@/components/ui/trace"
1348
+
1349
+ export function TraceTurn() {
1350
+ return (
1351
+ <div className="w-full max-w-sm">
1352
+ <TraceCollapsible defaultOpen>
1353
+ <TraceCollapsibleTrigger>
1354
+ <TraceLine status="error">
1355
+ <TraceTitle>Worked for 2m 4s, 1 command failed</TraceTitle>
1356
+ </TraceLine>
1357
+ </TraceCollapsibleTrigger>
1358
+ <TraceCollapsibleContent keepMounted className="flex flex-col gap-2">
1359
+ <Trace>
1360
+ <TraceCollapsible>
1361
+ <TraceCollapsibleTrigger>
1362
+ <TraceLine>
1363
+ <TraceIcon>
1364
+ <BrainIcon />
1365
+ </TraceIcon>
1366
+ <TraceTitle>Thought</TraceTitle>
1367
+ <TraceDescription>12s</TraceDescription>
1368
+ </TraceLine>
1369
+ </TraceCollapsibleTrigger>
1370
+ <TraceCollapsibleContent className="whitespace-pre-wrap">
1371
+ I should check which package managers are installed before I
1372
+ scaffold anything.
1373
+ </TraceCollapsibleContent>
1374
+ </TraceCollapsible>
1375
+ <TraceCollapsible defaultOpen>
1376
+ <TraceCollapsibleTrigger>
1377
+ <TraceLine status="error">
1378
+ <TraceIcon>
1379
+ <TerminalIcon />
1380
+ </TraceIcon>
1381
+ <TraceTitle>Ran 2 commands, 1 failed</TraceTitle>
1382
+ </TraceLine>
1383
+ </TraceCollapsibleTrigger>
1384
+ <TraceCollapsibleContent keepMounted>
1385
+ <Trace>
1386
+ <TraceLine>
1387
+ <TraceIcon>
1388
+ <TerminalIcon />
1389
+ </TraceIcon>
1390
+ <TraceTitle>Ran node --version</TraceTitle>
1391
+ </TraceLine>
1392
+ <TraceCollapsible>
1393
+ <TraceCollapsibleTrigger>
1394
+ <TraceLine status="error">
1395
+ <TraceIcon>
1396
+ <TerminalIcon />
1397
+ </TraceIcon>
1398
+ <TraceTitle>Failed to run pnpm --version</TraceTitle>
1399
+ </TraceLine>
1400
+ </TraceCollapsibleTrigger>
1401
+ <TraceCollapsibleContent>
1402
+ <CodeBlock size="sm" variant="destructive">
1403
+ <CodeBlockContent wrap className="max-h-64">
1404
+ command not found: pnpm
1405
+ </CodeBlockContent>
1406
+ </CodeBlock>
1407
+ </TraceCollapsibleContent>
1408
+ </TraceCollapsible>
1409
+ </Trace>
1410
+ </TraceCollapsibleContent>
1411
+ </TraceCollapsible>
1412
+ </Trace>
1413
+ <p>Node is installed and pnpm is not. Reading the docs config.</p>
1414
+ <Trace>
1415
+ <a href="#turn">
1416
+ <TraceLine>
1417
+ <TraceIcon>
1418
+ <FileTextIcon />
1419
+ </TraceIcon>
1420
+ <TraceTitle>Read apps/v4/lib/docs.ts</TraceTitle>
1421
+ <TraceIcon>
1422
+ <ChevronRightIcon />
1423
+ </TraceIcon>
1424
+ </TraceLine>
1425
+ </a>
1426
+ </Trace>
1427
+ </TraceCollapsibleContent>
1428
+ </TraceCollapsible>
1429
+ </div>
1430
+ )
1431
+ }
1432
+
1433
+ ```
1434
+
1435
+ ## Reasoning
1436
+
1437
+ Render a `reasoning` part from the AI SDK. The row is a `TraceLine` until the first text arrives. See [Open State](#open-state).
1438
+
1439
+ ```tsx
1440
+ "use client"
1441
+
1442
+ import * as React from "react"
1443
+ import { useChat } from "@ai-sdk/react"
1444
+ import type { UIMessage } from "ai"
1445
+ import { BrainIcon } from "lucide-react"
1446
+
1447
+ import { createChat, getMessageText } from "@/lib/ai"
1448
+ import { Bubble, BubbleContent } from "@/components/ui/bubble"
1449
+ import { Button } from "@/components/ui/button"
1450
+ import { Message, MessageContent } from "@/components/ui/message"
1451
+ import {
1452
+ Trace,
1453
+ TraceCollapsible,
1454
+ TraceCollapsibleContent,
1455
+ TraceCollapsibleTrigger,
1456
+ TraceIcon,
1457
+ TraceLine,
1458
+ TraceTitle,
1459
+ } from "@/components/ui/trace"
1460
+
1461
+ const chat = createChat()
1462
+ .user("Why is the checkout deploy so slow?")
1463
+ .assistant(({ writer }) => {
1464
+ writer.reasoning(
1465
+ "The build log shows install and compile finish in under a minute. Image optimization takes almost four, and it reruns on every deploy because the cache key includes the commit hash.",
1466
+ { delayMs: 60 }
1467
+ )
1468
+ writer.sleep(400)
1469
+ writer.text(
1470
+ "Image optimization is the bottleneck. Key its cache on the lockfile and the image directory instead of the commit hash."
1471
+ )
1472
+ })
1473
+
1474
+ const initialMessages = chat.get(0)
1475
+ const transport = chat.transport({ delayMs: 20 })
1476
+
1477
+ function ThinkingTrace({ text, running }: { text: string; running: boolean }) {
1478
+ const [open, setOpen] = React.useState<boolean>()
1479
+
1480
+ const line = (
1481
+ <TraceLine status={running ? "running" : undefined}>
1482
+ <TraceIcon>
1483
+ <BrainIcon />
1484
+ </TraceIcon>
1485
+ <TraceTitle>{running ? "Thinking" : "Thought"}</TraceTitle>
1486
+ </TraceLine>
1487
+ )
1488
+
1489
+ if (text.length === 0) {
1490
+ return line
1491
+ }
1492
+
1493
+ return (
1494
+ <TraceCollapsible open={open ?? running} onOpenChange={setOpen}>
1495
+ <TraceCollapsibleTrigger>{line}</TraceCollapsibleTrigger>
1496
+ <TraceCollapsibleContent className="whitespace-pre-wrap">
1497
+ {text}
1498
+ </TraceCollapsibleContent>
1499
+ </TraceCollapsible>
1500
+ )
1501
+ }
1502
+
1503
+ function groupParts(parts: UIMessage["parts"]) {
1504
+ const runs: { trace: boolean; parts: UIMessage["parts"] }[] = []
1505
+
1506
+ for (const part of parts) {
1507
+ const trace = part.type === "reasoning"
1508
+
1509
+ if (!trace && part.type !== "text") {
1510
+ continue
1511
+ }
1512
+
1513
+ const last = runs.at(-1)
1514
+
1515
+ if (last?.trace === trace) {
1516
+ last.parts.push(part)
1517
+ } else {
1518
+ runs.push({ trace, parts: [part] })
1519
+ }
1520
+ }
1521
+
1522
+ return runs
1523
+ }
1524
+
1525
+ export function TraceThinking() {
1526
+ const { messages, sendMessage, setMessages, status } = useChat({
1527
+ messages: initialMessages,
1528
+ transport,
1529
+ })
1530
+ const nextMessage = chat.next(messages)
1531
+ const busy = status === "submitted" || status === "streaming"
1532
+
1533
+ return (
1534
+ <div className="flex min-h-72 w-full max-w-sm flex-col gap-4 py-6 text-sm">
1535
+ {messages.map((message) => {
1536
+ if (message.role === "user") {
1537
+ return (
1538
+ <Message key={message.id} align="end">
1539
+ <MessageContent>
1540
+ <Bubble align="end" variant="muted">
1541
+ <BubbleContent>{getMessageText(message)}</BubbleContent>
1542
+ </Bubble>
1543
+ </MessageContent>
1544
+ </Message>
1545
+ )
1546
+ }
1547
+
1548
+ const live = status === "streaming" && message === messages.at(-1)
1549
+
1550
+ return (
1551
+ <Message key={message.id}>
1552
+ <MessageContent className="gap-4">
1553
+ {groupParts(message.parts).map((run, runIndex) =>
1554
+ run.trace ? (
1555
+ <Trace key={runIndex}>
1556
+ {run.parts.map((part, index) =>
1557
+ part.type === "reasoning" ? (
1558
+ <ThinkingTrace
1559
+ key={index}
1560
+ text={part.text}
1561
+ running={live && part.state === "streaming"}
1562
+ />
1563
+ ) : null
1564
+ )}
1565
+ </Trace>
1566
+ ) : (
1567
+ run.parts.map((part, index) =>
1568
+ part.type === "text" ? (
1569
+ <p key={`${runIndex}-${index}`}>{part.text}</p>
1570
+ ) : null
1571
+ )
1572
+ )
1573
+ )}
1574
+ </MessageContent>
1575
+ </Message>
1576
+ )
1577
+ })}
1578
+ {!busy && (
1579
+ <Button
1580
+ variant="outline"
1581
+ size="sm"
1582
+ className="mt-auto self-start"
1583
+ onClick={() =>
1584
+ nextMessage
1585
+ ? sendMessage(nextMessage)
1586
+ : setMessages(initialMessages)
1587
+ }
1588
+ >
1589
+ {nextMessage ? "Send message" : "Reset"}
1590
+ </Button>
1591
+ )}
1592
+ </div>
1593
+ )
1594
+ }
1595
+
1596
+ ```
1597
+
1598
+ See [Reasoning](/docs/ai-elements/base/reasoning) for more examples.
1599
+
1600
+ ## Tool
1601
+
1602
+ Render tool parts from the AI SDK. Map the tool part as in [Tool](/docs/ai-elements/base/tool#states).
1603
+
1604
+ ```tsx
1605
+ "use client"
1606
+
1607
+ import * as React from "react"
1608
+ import { useChat } from "@ai-sdk/react"
1609
+ import type { DynamicToolUIPart, UIMessage } from "ai"
1610
+ import { TerminalIcon } from "lucide-react"
1611
+
1612
+ import { createChat, getMessageText } from "@/lib/ai"
1613
+ import { Bubble, BubbleContent } from "@/components/ui/bubble"
1614
+ import { Button } from "@/components/ui/button"
1615
+ import { CodeBlock, CodeBlockContent } from "@/components/ui/code-block"
1616
+ import { Message, MessageContent } from "@/components/ui/message"
1617
+ import {
1618
+ Trace,
1619
+ TraceCollapsible,
1620
+ TraceCollapsibleContent,
1621
+ TraceCollapsibleTrigger,
1622
+ TraceIcon,
1623
+ TraceLine,
1624
+ TraceTitle,
1625
+ } from "@/components/ui/trace"
1626
+
1627
+ const chat = createChat()
1628
+ .user("Which package managers are installed?")
1629
+ .assistant(({ writer }) => {
1630
+ writer
1631
+ .tool("runCommand", {
1632
+ dynamic: true,
1633
+ input: { command: "node --version" },
1634
+ })
1635
+ .sleep(900)
1636
+ .output({ stdout: "v24.18.0" })
1637
+ writer
1638
+ .tool("runCommand", {
1639
+ dynamic: true,
1640
+ input: { command: "npm --version" },
1641
+ })
1642
+ .sleep(900)
1643
+ .output({ stdout: "11.6.2" })
1644
+ writer
1645
+ .tool("runCommand", {
1646
+ dynamic: true,
1647
+ input: { command: "pnpm --version" },
1648
+ })
1649
+ .sleep(900)
1650
+ .error("command not found: pnpm")
1651
+ writer.text("Node 24 and npm 11 are installed. pnpm is not.")
1652
+ })
1653
+
1654
+ const initialMessages = chat.get(0)
1655
+ const transport = chat.transport({ delayMs: 20 })
1656
+
1657
+ function ToolTrace({ part, live }: { part: DynamicToolUIPart; live: boolean }) {
1658
+ const command = (part.input as { command?: string } | undefined)?.command
1659
+
1660
+ if (part.state === "output-available" || part.state === "output-error") {
1661
+ const failed = part.state === "output-error"
1662
+
1663
+ return (
1664
+ <TraceCollapsible>
1665
+ <TraceCollapsibleTrigger>
1666
+ <TraceLine status={failed ? "error" : undefined}>
1667
+ <TraceIcon>
1668
+ <TerminalIcon />
1669
+ </TraceIcon>
1670
+ <TraceTitle>
1671
+ {failed ? "Failed to run" : "Ran"} {command}
1672
+ </TraceTitle>
1673
+ </TraceLine>
1674
+ </TraceCollapsibleTrigger>
1675
+ <TraceCollapsibleContent>
1676
+ <CodeBlock size="sm">
1677
+ <CodeBlockContent wrap className="max-h-64">
1678
+ {failed
1679
+ ? part.errorText
1680
+ : (part.output as { stdout: string }).stdout}
1681
+ </CodeBlockContent>
1682
+ </CodeBlock>
1683
+ </TraceCollapsibleContent>
1684
+ </TraceCollapsible>
1685
+ )
1686
+ }
1687
+
1688
+ if (part.state === "output-denied") {
1689
+ return (
1690
+ <TraceLine>
1691
+ <TraceIcon>
1692
+ <TerminalIcon />
1693
+ </TraceIcon>
1694
+ <TraceTitle>Denied {command}</TraceTitle>
1695
+ </TraceLine>
1696
+ )
1697
+ }
1698
+
1699
+ return (
1700
+ <TraceLine status={live ? "running" : "error"}>
1701
+ <TraceIcon>
1702
+ <TerminalIcon />
1703
+ </TraceIcon>
1704
+ <TraceTitle>
1705
+ {live ? "Running" : "Failed to run"} {command}
1706
+ </TraceTitle>
1707
+ </TraceLine>
1708
+ )
1709
+ }
1710
+
1711
+ function groupParts(parts: UIMessage["parts"]) {
1712
+ const runs: { trace: boolean; parts: UIMessage["parts"] }[] = []
1713
+
1714
+ for (const part of parts) {
1715
+ const trace = part.type === "dynamic-tool"
1716
+
1717
+ if (!trace && part.type !== "text") {
1718
+ continue
1719
+ }
1720
+
1721
+ const last = runs.at(-1)
1722
+
1723
+ if (last?.trace === trace) {
1724
+ last.parts.push(part)
1725
+ } else {
1726
+ runs.push({ trace, parts: [part] })
1727
+ }
1728
+ }
1729
+
1730
+ return runs
1731
+ }
1732
+
1733
+ export function TraceToolCalls() {
1734
+ const { messages, sendMessage, setMessages, status } = useChat({
1735
+ messages: initialMessages,
1736
+ transport,
1737
+ })
1738
+ const nextMessage = chat.next(messages)
1739
+ const busy = status === "submitted" || status === "streaming"
1740
+
1741
+ return (
1742
+ <div className="flex min-h-72 w-full max-w-sm flex-col gap-4 py-6 text-sm">
1743
+ {messages.map((message) => {
1744
+ if (message.role === "user") {
1745
+ return (
1746
+ <Message key={message.id} align="end">
1747
+ <MessageContent>
1748
+ <Bubble align="end" variant="muted">
1749
+ <BubbleContent>{getMessageText(message)}</BubbleContent>
1750
+ </Bubble>
1751
+ </MessageContent>
1752
+ </Message>
1753
+ )
1754
+ }
1755
+
1756
+ const live = status === "streaming" && message === messages.at(-1)
1757
+
1758
+ return (
1759
+ <Message key={message.id}>
1760
+ <MessageContent className="gap-4">
1761
+ {groupParts(message.parts).map((run, runIndex) =>
1762
+ run.trace ? (
1763
+ <Trace key={runIndex}>
1764
+ {run.parts.map((part) =>
1765
+ part.type === "dynamic-tool" ? (
1766
+ <ToolTrace
1767
+ key={part.toolCallId}
1768
+ part={part}
1769
+ live={live}
1770
+ />
1771
+ ) : null
1772
+ )}
1773
+ </Trace>
1774
+ ) : (
1775
+ run.parts.map((part, index) =>
1776
+ part.type === "text" ? (
1777
+ <p key={`${runIndex}-${index}`}>{part.text}</p>
1778
+ ) : null
1779
+ )
1780
+ )
1781
+ )}
1782
+ </MessageContent>
1783
+ </Message>
1784
+ )
1785
+ })}
1786
+ {!busy && (
1787
+ <Button
1788
+ variant="outline"
1789
+ size="sm"
1790
+ className="mt-auto self-start"
1791
+ onClick={() =>
1792
+ nextMessage
1793
+ ? sendMessage(nextMessage)
1794
+ : setMessages(initialMessages)
1795
+ }
1796
+ >
1797
+ {nextMessage ? "Send message" : "Reset"}
1798
+ </Button>
1799
+ )}
1800
+ </div>
1801
+ )
1802
+ }
1803
+
1804
+ ```
1805
+
1806
+ See [Tool](/docs/ai-elements/base/tool) for more examples.
1807
+
1808
+ ## Accessibility
1809
+
1810
+ `Trace` adds no roles of its own. Each line gets its semantics from the element that wraps it.
1811
+
1812
+ - A `TraceLine` on its own is a `span`. It is read as text and is not a tab stop.
1813
+ - Wrap it in a `TraceCollapsibleTrigger` and it becomes a button with `aria-expanded`. Wrap it in a link, or in the trigger for a dialog or sheet, and it takes the keyboard and focus behavior of that element.
1814
+ - `TraceIcon` is hidden from assistive tech, so `TraceTitle` is the accessible name. Write it as a sentence that says what happened, like "Edited trace.tsx", not just "trace.tsx".
1815
+ - When a link opens a new tab, add "(opens in a new tab)" to the title with `sr-only`.
1816
+ - Status is shown with color and motion, so put it in the title too. Write "Running pnpm build" while it runs and "Failed to run pnpm build" when it errors.
1817
+ - The shimmer on a running title stops when the reader prefers reduced motion. The title still says what is happening.
1818
+ - Inside a [Message Scroller](/docs/components/base/message-scroller), each line is announced once when it is added.
1819
+ - `TraceCollapsibleContent` mutes its text. If you put a block with a muted background inside it, give the block `text-foreground` so it keeps its contrast. `CodeBlock` sets its own text color.
1820
+
1821
+ ## API Reference
1822
+
1823
+ ### Trace
1824
+
1825
+ A list of rows. It also styles any trigger or link that wraps a `TraceLine`.
1826
+
1827
+ | Prop | Type | Default | Description |
1828
+ | ----------- | -------- | ------- | ---------------------------------------- |
1829
+ | `className` | `string` | - | Additional classes to apply to the list. |
1830
+
1831
+ ### TraceLine
1832
+
1833
+ One line: an icon and a title. It is a span, so it is not a button or a tab stop. Wrap it in a trigger or a link to make it do something.
1834
+
1835
+ | Prop | Type | Default | Description |
1836
+ | ----------- | ----------------------------------- | ------- | ---------------------------------------- |
1837
+ | `status` | `"running" \| "error" \| "pending"` | - | The state of the work the line reports. |
1838
+ | `className` | `string` | - | Additional classes to apply to the line. |
1839
+
1840
+ ### TraceIcon
1841
+
1842
+ A decorative icon slot, hidden from assistive tech. Before the title it names the action; after it, it is the indicator.
1843
+
1844
+ | Prop | Type | Default | Description |
1845
+ | ----------- | -------- | ------- | --------------------------------------------- |
1846
+ | `className` | `string` | - | Additional classes to apply to the icon slot. |
1847
+
1848
+ ### TraceTitle
1849
+
1850
+ One sentence on one line. It truncates and shimmers while the line is running.
1851
+
1852
+ | Prop | Type | Default | Description |
1853
+ | ----------- | -------- | ------- | ----------------------------------------- |
1854
+ | `className` | `string` | - | Additional classes to apply to the title. |
1855
+
1856
+ ### TraceDescription
1857
+
1858
+ Secondary text after the title, such as a count or a duration. It does not truncate.
1859
+
1860
+ | Prop | Type | Default | Description |
1861
+ | ----------- | -------- | ------- | ----------------------------------------------- |
1862
+ | `className` | `string` | - | Additional classes to apply to the description. |
1863
+
1864
+ ### TraceCollapsible
1865
+
1866
+ A row that expands. It accepts the props of [`Collapsible`](/docs/components/base/collapsible).
1867
+
1868
+ | Prop | Type | Default | Description |
1869
+ | -------------- | ------------------------- | ------- | ------------------------------------------------------- |
1870
+ | `open` | `boolean` | - | The controlled open state. Pass it with `onOpenChange`. |
1871
+ | `defaultOpen` | `boolean` | `false` | Whether the row starts open. |
1872
+ | `onOpenChange` | `(open: boolean) => void` | - | Called when the open state changes. |
1873
+ | `className` | `string` | - | Additional classes to apply to the row. |
1874
+
1875
+ ### TraceCollapsibleTrigger
1876
+
1877
+ The button that opens and closes the row. Put a `TraceLine` inside it. It adds a chevron after the line.
1878
+
1879
+ | Prop | Type | Default | Description |
1880
+ | ----------- | -------- | ------- | ------------------------------------------- |
1881
+ | `className` | `string` | - | Additional classes to apply to the trigger. |
1882
+
1883
+ ### TraceCollapsibleContent
1884
+
1885
+ The detail of a row that expands.
1886
+
1887
+ | Prop | Type | Default | Description |
1888
+ | ------------- | --------- | ------- | --------------------------------------------------------------------------- |
1889
+ | `keepMounted` | `boolean` | `false` | Keep the detail mounted while closed, so nested rows keep their open state. |
1890
+ | `className` | `string` | - | Additional classes to apply to the content. |