diff --git a/src/CrestApps.Core.Docs/docs/core/default-orchestrator.md b/src/CrestApps.Core.Docs/docs/core/default-orchestrator.md index d63380c1..fb5f264e 100644 --- a/src/CrestApps.Core.Docs/docs/core/default-orchestrator.md +++ b/src/CrestApps.Core.Docs/docs/core/default-orchestrator.md @@ -40,8 +40,3 @@ builder.Services .AddCoreAIOpenAI(); ``` -## Relationship to the orchestration docs - -This page is the conceptual overview for the built-in orchestrator. - -Use **[Orchestration](./orchestration.md)** for the full pipeline details, registered services, progressive tool scoping, configuration knobs, and extension points. diff --git a/src/CrestApps.Core.Docs/docs/core/orchestration.md b/src/CrestApps.Core.Docs/docs/core/orchestration.md index d9076666..49d0502b 100644 --- a/src/CrestApps.Core.Docs/docs/core/orchestration.md +++ b/src/CrestApps.Core.Docs/docs/core/orchestration.md @@ -1,11 +1,11 @@ --- -sidebar_label: Orchestration +sidebar_label: Overview sidebar_position: 4 -title: Orchestration +title: Overview description: The orchestration pipeline manages tool calling, progressive scoping, RAG, and the agentic execution loop. --- -# Orchestration +# Overview > High-level agentic pipeline that manages tool calling, progressive scoping, retrieval-augmented generation, and streaming responses. @@ -412,5 +412,3 @@ Errors from AI providers (rate limits, authentication failures, server errors) p | `OperationCanceledException` | Re-thrown immediately | | Provider error (rate limit, auth, etc.) | Propagated to caller | | Tool execution error | Logged, tool result indicates failure, model continues | - - diff --git a/src/CrestApps.Core.Docs/package-lock.json b/src/CrestApps.Core.Docs/package-lock.json index e820f0f7..c8f43eeb 100644 --- a/src/CrestApps.Core.Docs/package-lock.json +++ b/src/CrestApps.Core.Docs/package-lock.json @@ -161,7 +161,6 @@ "resolved": "https://registry.npmjs.org/@algolia/client-search/-/client-search-5.50.0.tgz", "integrity": "sha512-Jc360x4yqb3eEg4OY4KEIdGePBxZogivKI+OGIU8aLXgAYPTECvzeOBc90312yHA1hr3AeRlAFl0rIc8lQaIrQ==", "license": "MIT", - "peer": true, "dependencies": { "@algolia/client-common": "5.50.0", "@algolia/requester-browser-xhr": "5.50.0", @@ -287,7 +286,6 @@ "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.29.0.tgz", "integrity": "sha512-CGOfOJqWjg2qW/Mb6zNsDm+u5vFQ8DxXfbM09z69p5Z6+mE1ikP2jUXw+j42Pf1XTYED2Rni5f95npYeuwMDQA==", "license": "MIT", - "peer": true, "dependencies": { "@babel/code-frame": "^7.29.0", "@babel/generator": "^7.29.0", @@ -2090,7 +2088,6 @@ } ], "license": "MIT", - "peer": true, "engines": { "node": ">=18" }, @@ -2113,7 +2110,6 @@ } ], "license": "MIT", - "peer": true, "engines": { "node": ">=18" } @@ -2223,7 +2219,6 @@ "resolved": "https://registry.npmjs.org/postcss-selector-parser/-/postcss-selector-parser-7.1.1.tgz", "integrity": "sha512-orRsuYpJVw8LdAwqqLykBj9ecS5/cRHlI5+nvTo8LcCKmzDmqVORXtOIYEEQuL9D4BxtA1lm5isAqzQZCoQ6Eg==", "license": "MIT", - "peer": true, "dependencies": { "cssesc": "^3.0.0", "util-deprecate": "^1.0.2" @@ -2645,7 +2640,6 @@ "resolved": "https://registry.npmjs.org/postcss-selector-parser/-/postcss-selector-parser-7.1.1.tgz", "integrity": "sha512-orRsuYpJVw8LdAwqqLykBj9ecS5/cRHlI5+nvTo8LcCKmzDmqVORXtOIYEEQuL9D4BxtA1lm5isAqzQZCoQ6Eg==", "license": "MIT", - "peer": true, "dependencies": { "cssesc": "^3.0.0", "util-deprecate": "^1.0.2" @@ -3734,7 +3728,6 @@ "resolved": "https://registry.npmjs.org/@docusaurus/plugin-content-docs/-/plugin-content-docs-3.9.2.tgz", "integrity": "sha512-C5wZsGuKTY8jEYsqdxhhFOe1ZDjH0uIYJ9T/jebHwkyxqnr4wW0jTkB72OMqNjsoQRcb0JN3PcSeTwFlVgzCZg==", "license": "MIT", - "peer": true, "dependencies": { "@docusaurus/core": "3.9.2", "@docusaurus/logger": "3.9.2", @@ -4399,7 +4392,6 @@ "resolved": "https://registry.npmjs.org/@docusaurus/theme-common/-/theme-common-3.9.2.tgz", "integrity": "sha512-6c4DAbR6n6nPbnZhY2V3tzpnKnGL+6aOsLvFL26VRqhlczli9eWG0VDUNoCQEPnGwDMhPS42UhSAnz5pThm5Ag==", "license": "MIT", - "peer": true, "dependencies": { "@docusaurus/mdx-loader": "3.9.2", "@docusaurus/module-type-aliases": "3.9.2", @@ -5341,7 +5333,6 @@ "resolved": "https://registry.npmjs.org/@mdx-js/react/-/react-3.1.1.tgz", "integrity": "sha512-f++rKLQgUVYDAtECQ6fn/is15GkEH9+nZPM3MS0RcxVqoTfawHvDlSCH7JbMhAM6uJ32v3eXLvLmLvjGu7PTQw==", "license": "MIT", - "peer": true, "dependencies": { "@types/mdx": "^2.0.0" }, @@ -6070,7 +6061,6 @@ "resolved": "https://registry.npmjs.org/@svgr/core/-/core-8.1.0.tgz", "integrity": "sha512-8QqtOQT5ACVlmsvKOJNEaWmRPmcojMOzCz4Hs2BGG/toAp/K38LcsMRyLp349glq5AzJbCEeimEoxaX6v/fLrA==", "license": "MIT", - "peer": true, "dependencies": { "@babel/core": "^7.21.3", "@svgr/babel-preset": "8.1.0", @@ -6434,7 +6424,6 @@ "resolved": "https://registry.npmjs.org/@types/react/-/react-19.2.14.tgz", "integrity": "sha512-ilcTH/UniCkMdtexkoCN0bI7pMcJDvmQFPvuPvmEaYA/NSfFTAgdUSLAoVjaRJm7+6PvcM+q1zYOwS4wTYMF9w==", "license": "MIT", - "peer": true, "dependencies": { "csstype": "^3.2.2" } @@ -6776,7 +6765,6 @@ "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.16.0.tgz", "integrity": "sha512-UVJyE9MttOsBQIDKw1skb9nAwQuR5wuGD3+82K6JgJlm/Y+KI92oNsMNGZCYdDsVtRHSak0pcV5Dno5+4jh9sw==", "license": "MIT", - "peer": true, "bin": { "acorn": "bin/acorn" }, @@ -6844,7 +6832,6 @@ "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.18.0.tgz", "integrity": "sha512-PlXPeEWMXMZ7sPYOHqmDyCJzcfNrUr3fGNKtezX14ykXOEIvyK81d+qydx89KY5O71FKMPaQ2vBfBFI5NHR63A==", "license": "MIT", - "peer": true, "dependencies": { "fast-deep-equal": "^3.1.3", "fast-uri": "^3.0.1", @@ -6890,7 +6877,6 @@ "resolved": "https://registry.npmjs.org/algoliasearch/-/algoliasearch-5.50.0.tgz", "integrity": "sha512-yE5I83Q2s8euVou8Y3feXK08wyZInJWLYXgWO6Xti9jBUEZAGUahyeQ7wSZWkifLWVnQVKEz5RAmBlXG5nqxog==", "license": "MIT", - "peer": true, "dependencies": { "@algolia/abtesting": "1.16.0", "@algolia/client-abtesting": "5.50.0", @@ -7375,7 +7361,6 @@ } ], "license": "MIT", - "peer": true, "dependencies": { "baseline-browser-mapping": "^2.9.0", "caniuse-lite": "^1.0.30001759", @@ -8341,7 +8326,6 @@ "resolved": "https://registry.npmjs.org/postcss-selector-parser/-/postcss-selector-parser-7.1.1.tgz", "integrity": "sha512-orRsuYpJVw8LdAwqqLykBj9ecS5/cRHlI5+nvTo8LcCKmzDmqVORXtOIYEEQuL9D4BxtA1lm5isAqzQZCoQ6Eg==", "license": "MIT", - "peer": true, "dependencies": { "cssesc": "^3.0.0", "util-deprecate": "^1.0.2" @@ -9731,7 +9715,6 @@ "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.14.0.tgz", "integrity": "sha512-IWrosm/yrn43eiKqkfkHis7QioDleaXQHdDVPKg0FSwwd/DuvyX79TZnFOnYpB7dcsFAMmtFztZuXPDvSePkFw==", "license": "MIT", - "peer": true, "dependencies": { "fast-deep-equal": "^3.1.1", "fast-json-stable-stringify": "^2.0.0", @@ -14198,7 +14181,6 @@ "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.14.0.tgz", "integrity": "sha512-IWrosm/yrn43eiKqkfkHis7QioDleaXQHdDVPKg0FSwwd/DuvyX79TZnFOnYpB7dcsFAMmtFztZuXPDvSePkFw==", "license": "MIT", - "peer": true, "dependencies": { "fast-deep-equal": "^3.1.1", "fast-json-stable-stringify": "^2.0.0", @@ -14743,7 +14725,6 @@ } ], "license": "MIT", - "peer": true, "dependencies": { "nanoid": "^3.3.11", "picocolors": "^1.1.1", @@ -15647,7 +15628,6 @@ "resolved": "https://registry.npmjs.org/postcss-selector-parser/-/postcss-selector-parser-7.1.1.tgz", "integrity": "sha512-orRsuYpJVw8LdAwqqLykBj9ecS5/cRHlI5+nvTo8LcCKmzDmqVORXtOIYEEQuL9D4BxtA1lm5isAqzQZCoQ6Eg==", "license": "MIT", - "peer": true, "dependencies": { "cssesc": "^3.0.0", "util-deprecate": "^1.0.2" @@ -16455,7 +16435,6 @@ "resolved": "https://registry.npmjs.org/react/-/react-19.2.4.tgz", "integrity": "sha512-9nfp2hYpCwOjAN+8TZFGhtWEwgvWHXqESH8qT89AT/lWklpLON22Lc8pEtnpsZz7VmawabSU0gCjnj8aC0euHQ==", "license": "MIT", - "peer": true, "engines": { "node": ">=0.10.0" } @@ -16465,7 +16444,6 @@ "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-19.2.4.tgz", "integrity": "sha512-AXJdLo8kgMbimY95O2aKQqsz2iWi9jMgKJhRBAxECE4IFxfcazB2LmzloIoibJI3C12IlY20+KFaLv+71bUJeQ==", "license": "MIT", - "peer": true, "dependencies": { "scheduler": "^0.27.0" }, @@ -16521,7 +16499,6 @@ "resolved": "https://registry.npmjs.org/@docusaurus/react-loadable/-/react-loadable-6.0.0.tgz", "integrity": "sha512-YMMxTUQV/QFSnbgrP3tjDzLHRg7vsbMn8e9HAa8o/1iXoiomo48b7sk/kkmWEuWNDPJVlKSJRB6Y2fHqdJk+SQ==", "license": "MIT", - "peer": true, "dependencies": { "@types/react": "*" }, @@ -16550,7 +16527,6 @@ "resolved": "https://registry.npmjs.org/react-router/-/react-router-5.3.4.tgz", "integrity": "sha512-Ys9K+ppnJah3QuaRiLxk+jDWOR1MekYQrlytiXxC1RyfbdsZkS5pvKAzCCr031xHixZwpnsYNT5xysdFHQaYsA==", "license": "MIT", - "peer": true, "dependencies": { "@babel/runtime": "^7.12.13", "history": "^4.9.0", @@ -18312,8 +18288,7 @@ "version": "2.8.1", "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz", "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==", - "license": "0BSD", - "peer": true + "license": "0BSD" }, "node_modules/tsyringe": { "version": "4.10.0", @@ -18730,7 +18705,6 @@ "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.14.0.tgz", "integrity": "sha512-IWrosm/yrn43eiKqkfkHis7QioDleaXQHdDVPKg0FSwwd/DuvyX79TZnFOnYpB7dcsFAMmtFztZuXPDvSePkFw==", "license": "MIT", - "peer": true, "dependencies": { "fast-deep-equal": "^3.1.1", "fast-json-stable-stringify": "^2.0.0", @@ -18929,7 +18903,6 @@ "resolved": "https://registry.npmjs.org/webpack/-/webpack-5.105.2.tgz", "integrity": "sha512-dRXm0a2qcHPUBEzVk8uph0xWSjV/xZxenQQbLwnwP7caQCYpqG1qddwlyEkIDkYn0K8tvmcrZ+bOrzoQ3HxCDw==", "license": "MIT", - "peer": true, "dependencies": { "@types/eslint-scope": "^3.7.7", "@types/estree": "^1.0.8", diff --git a/src/CrestApps.Core.Docs/sidebars.js b/src/CrestApps.Core.Docs/sidebars.js index 6118f77f..c0741545 100644 --- a/src/CrestApps.Core.Docs/sidebars.js +++ b/src/CrestApps.Core.Docs/sidebars.js @@ -10,12 +10,12 @@ const sidebars = { label: 'Core', collapsed: false, items: [ - 'core/architecture', + 'core/index', 'core/core-services', - 'core/extensible-entity', + 'core/architecture', 'core/getting-started-aspnet', - 'core/index', 'core/interfaces', + 'core/extensible-entity', 'core/mvc-example', ], }, @@ -44,8 +44,8 @@ const sidebars = { type: 'category', label: 'Orchestrators', items: [ - 'core/default-orchestrator', 'core/orchestration', + 'core/default-orchestrator', 'core/copilot', 'core/claude', ], diff --git a/src/CrestApps.Core.Docs/src/css/custom.css b/src/CrestApps.Core.Docs/src/css/custom.css index a3f65a31..27206f12 100644 --- a/src/CrestApps.Core.Docs/src/css/custom.css +++ b/src/CrestApps.Core.Docs/src/css/custom.css @@ -82,3 +82,39 @@ .footer--dark a:hover { color: #eaa52c; } + +.theme-doc-sidebar-menu .menu__list .menu__list { + margin-top: 0.35rem; + margin-left: 0.5rem; + padding: 0.4rem 0.45rem 0.45rem; + border-left: 1px solid rgba(24, 22, 24, 0.12); + border-radius: 0.5rem; +} + +.theme-doc-sidebar-item-category-level-1 > .menu__list { + background-color: rgba(24, 22, 24, 0.04); +} + +.theme-doc-sidebar-item-category-level-2 > .menu__list { + background-color: rgba(24, 22, 24, 0.08); +} + +.theme-doc-sidebar-item-category-level-3 > .menu__list { + background-color: rgba(24, 22, 24, 0.12); +} + +[data-theme='dark'] .theme-doc-sidebar-menu .menu__list .menu__list { + border-left-color: rgba(217, 217, 217, 0.16); +} + +[data-theme='dark'] .theme-doc-sidebar-item-category-level-1 > .menu__list { + background-color: rgba(217, 217, 217, 0.04); +} + +[data-theme='dark'] .theme-doc-sidebar-item-category-level-2 > .menu__list { + background-color: rgba(217, 217, 217, 0.08); +} + +[data-theme='dark'] .theme-doc-sidebar-item-category-level-3 > .menu__list { + background-color: rgba(217, 217, 217, 0.12); +}