create-lykomi-app 0.9.21 → 0.10.0

package/README.md

@@ -1,8 +1,8 @@
 # create-lykomi-app
 
-Create a Foundry UI agent app: React chat UI, AG-UI protocol, Microsoft Agent Framework, and [Microsoft Foundry](https://learn.microsoft.com/azure/foundry/).
+Create a LYKOMI UI agent app: React chat UI, AG-UI protocol, Microsoft Agent Framework, and [Microsoft Foundry](https://learn.microsoft.com/azure/foundry/).
 
-Foundry UI is built by [iLoveAgents](https://iloveagents.ai).
+LYKOMI UI is maintained at [lykomi/ui](https://github.com/lykomi/ui).
 
 ## Create An App
 
@@ -10,6 +10,7 @@ Foundry UI is built by [iLoveAgents](https://iloveagents.ai).
 npm create lykomi-app my-agent-app
 cd my-agent-app
 cp agent/.env.example agent/.env
+# Edit agent/.env with your project endpoint and model deployment.
 az login
 pnpm dev
 ```
@@ -20,7 +21,7 @@ Set these in `agent/.env`:
 
 ```bash
 FOUNDRY_PROJECT_ENDPOINT=https://<account>.services.ai.azure.com/api/projects/<project>
-FOUNDRY_MODEL=gpt-5.4
+FOUNDRY_MODEL=<model-deployment-name>
 ```
 
 The generated app starts:
@@ -29,18 +30,20 @@ The generated app starts:
 - Agent service: `http://localhost:8020`
 - AG-UI endpoint: `/api/agent`
 
-The first screen is the chat. The bundled agent can call `hello_world` and `get_weather`.
+Home opens with a chat composer and clickable prompts. Guide demonstrates a page beside the persistent chat. The bundled agent can call `hello_world` and `get_weather`.
+
+The lower interface menu links to the Guide in local demo mode. Connecting a real auth provider makes it the signed-in user menu.
 
 ## Theme The App
 
-Generated apps default to `Foundry UI` for both the shell title and browser title. Change branding, logos, colors, radius, and fonts through the `theme` layers in `src/main.tsx`.
+Generated apps use LYKOMI's neutral and deep-petrol palette, light and dark V2 favicons, a locally bundled Manrope font, and `LYKOMI UI` for the shell and browser title. Edit `src/theme.ts` to change branding, colors, radius, and typography.
 
 ## Two Ways To Use It
 
-| Mode                   | Use when                                                         | Update story                                                                                                            |
-| ---------------------- | ---------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
-| Package-backed app     | You want central Foundry UI fixes and a small local app surface. | Keep the generated app and update `@iloveagents/foundry-*` packages with your package manager.                          |
-| GitHub template / copy | You want to fully own and reshape the app.                       | Copy the generated app into your own template repo. You can customize everything, but you manually pull upstream ideas. |
+| Mode                   | Use when                                                        | Update story                                                                                                            |
+| ---------------------- | --------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| Package-backed app     | You want central LYKOMI UI fixes and a small local app surface. | Keep the generated app and update `@lykomi/*` packages with your package manager.                                       |
+| GitHub template / copy | You want to fully own and reshape the app.                      | Copy the generated app into your own template repo. You can customize everything, but you manually pull upstream ideas. |
 
 The package-backed path updates shared UI, shell, theme resources, and AG-UI transport through npm packages. It does not overwrite local files like `agent/app/tools.py`, `src/main.tsx`, or your README.
 
@@ -71,19 +74,19 @@ The generated `AGENTS.md` explains the local project contract for coding agents.
 
 ## Presets
 
-| Preset       | What you get                                                                            |
-| ------------ | --------------------------------------------------------------------------------------- |
-| `default`    | Chat-first Foundry UI app with FastAPI Agent Framework service and hello/weather tools. |
-| `foundry-iq` | Default plus an Azure AI Search Foundry IQ knowledge base retrieval tool.               |
+| Preset       | What you get                                                                           |
+| ------------ | -------------------------------------------------------------------------------------- |
+| `default`    | Chat-first LYKOMI UI app with FastAPI Agent Framework service and hello/weather tools. |
+| `foundry-iq` | Default plus an Azure AI Search Foundry IQ knowledge base retrieval tool.              |
 
 ## Packages
 
-The starter consumes the Foundry UI packages from npm:
+The starter consumes the LYKOMI UI packages from npm:
 
-- `@iloveagents/foundry-web-shell` - browser shell and `bootstrapShell`
-- `@iloveagents/foundry-web-ui` - chat UI, AG-UI adapter, tool panels, theme resource
-- `@iloveagents/foundry-web-primitives` - shared UI primitives
-- `@iloveagents/foundry-agent` - AG-UI client transport
+- `@lykomi/web-shell` - browser shell and `bootstrapShell`
+- `@lykomi/web-ui` - chat UI, AG-UI adapter, tool panels, theme resource
+- `@lykomi/web-primitives` - shared UI primitives
+- `@lykomi/agent` - AG-UI client transport
 
 The packages publish built ESM JavaScript and `.d.ts` declarations. The
 generated Vite app is already configured to scan their Tailwind classes from the

package/dist/index.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import{copyFileSync as e,existsSync as t,mkdirSync as n,readFileSync as r,readdirSync as i,statSync as a,writeFileSync as o}from"node:fs";import{basename as s,dirname as c,join as l,resolve as u}from"node:path";import{spawnSync as d}from"node:child_process";import*as f from"@clack/prompts";import{readFile as p}from"node:fs/promises";import{fileURLToPath as m}from"node:url";const h=new Set([`.ts`,`.tsx`,`.js`,`.jsx`,`.mjs`,`.cjs`,`.md`,`.css`,`.html`,`.yml`,`.yaml`,`.toml`,`.env`,`.sh`,`.py`]);function g(e){let t=e.lastIndexOf(`.`);return t===-1?!0:h.has(e.slice(t))}function _(t){let{srcDir:s,dstDir:c,projectName:u,foundryPackageVersion:d,rewriteRootPackageJson:f}=t;function p(t,s,c){for(let m of i(t)){let i=l(t,m),h=a(i),_=l(s,m.startsWith(`_`)&&!m.startsWith(`__`)&&m!==`_`?`.`+m.slice(1):m);if(h.isDirectory()){n(_,{recursive:!0}),p(i,_,c+1);continue}if(f&&c===0&&m===`package.json`){let e=JSON.parse(r(i,`utf-8`));e.name=u,d&&C(e,d),o(_,JSON.stringify(e,null,2)+`
-`);continue}if(g(m)){o(_,r(i,`utf-8`).split(`__PROJECT_NAME__`).join(u));continue}e(i,_)}}p(s,c,0)}async function v(e){_({srcDir:e.sourceDir,dstDir:e.targetDir,projectName:e.projectName,foundryPackageVersion:e.foundryPackageVersion,rewriteRootPackageJson:!0})}async function y(e){_({srcDir:e.overlayDir,dstDir:e.targetDir,projectName:e.projectName,rewriteRootPackageJson:!1})}async function b(e){if(!e.extraDependencies&&!e.extraDevDependencies&&!e.extraScripts)return;let t=l(e.targetDir,`package.json`),n=JSON.parse(r(t,`utf-8`));e.extraDependencies&&(n.dependencies=x({...n.dependencies??{},...e.extraDependencies})),e.extraDevDependencies&&(n.devDependencies=x({...n.devDependencies??{},...e.extraDevDependencies})),e.extraScripts&&(n.scripts={...n.scripts??{},...e.extraScripts}),o(t,JSON.stringify(n,null,2)+`
-`)}function x(e){let t={};for(let n of Object.keys(e).sort())t[n]=e[n];return t}const S=[`@iloveagents/foundry-agent`,`@iloveagents/foundry-web-graph`,`@iloveagents/foundry-web-primitives`,`@iloveagents/foundry-web-shell`,`@iloveagents/foundry-web-ui`];function C(e,t){for(let n of[`dependencies`,`devDependencies`]){let r=e[n];if(!r||typeof r!=`object`||Array.isArray(r))continue;let i=r;for(let e of S)e in i&&(i[e]=t)}}async function w(e){if(e===`default`)return{name:e,templateDir:T()};if(e===`foundry-iq`||e===`neo4j`)return await D({name:e,presetRoot:E(e)});throw Error(`Unknown preset: ${e}`)}function T(){let e=c(m(import.meta.url)),n=e;for(let e=0;e<5;e++){let e=l(n,`template`);if(t(e))return e;let r=c(n);if(r===n)break;n=r}throw Error(`Could not locate bundled template/ relative to ${e}. Did you build the CLI? Run \`pnpm build\` in packages/create-foundry-ui-app.`)}function E(e){let n=c(m(import.meta.url)),r=n;for(let n=0;n<5;n++){let n=l(r,`presets`,e);if(t(n))return n;let i=c(r);if(i===r)break;r=i}throw Error(`Could not locate bundled presets/${e}/ relative to ${n}. Did you build the CLI? Run \`pnpm build\` in packages/create-foundry-ui-app.`)}async function D(e){let n=l(e.presetRoot,`manifest.json`);if(!t(n))throw Error(`Bundled preset '${e.name}' has no manifest.json.`);let r=JSON.parse(await p(n,`utf-8`));return O(e.name,e.presetRoot,r)}function O(e,n,r){if(r.extends&&r.extends!==`default`)throw Error(`Preset '${e}' extends '${r.extends}', but only 'default' is supported.`);let i=r.filesDir??`files`,a=l(n,i);if(!t(a))throw Error(r.filesDir===void 0?`Preset '${e}' has no '${i}/' directory at the package root (default filesDir).`:`Preset '${e}' declares filesDir='${i}' but the directory is missing in the package.`);return{name:e,templateDir:T(),overlayDir:a,extraDependencies:r.extraDependencies,extraDevDependencies:r.extraDevDependencies,extraScripts:r.extraScripts,envVars:r.envVars,postInstall:r.postInstall}}function k(e){let t={targetDir:null,preset:`default`,install:!0,force:!1,help:!1};for(let n=0;n<e.length;n++){let r=e[n];switch(r){case`-h`:case`--help`:t.help=!0;break;case`--no-install`:t.install=!1;break;case`--force`:t.force=!0;break;case`--preset`:t.preset=e[++n]??`default`;break;default:if(r.startsWith(`--`))throw Error(`Unknown flag: ${r}`);t.targetDir===null&&(t.targetDir=r)}}return t}function A(){console.log(`Usage: create-lykomi-app <target-dir> [options]
+import{copyFileSync as e,existsSync as t,mkdirSync as n,readFileSync as r,readdirSync as i,statSync as a,writeFileSync as o}from"node:fs";import{basename as s,dirname as c,join as l,resolve as u}from"node:path";import{spawnSync as d}from"node:child_process";import*as f from"@clack/prompts";import{readFile as p}from"node:fs/promises";import{fileURLToPath as m}from"node:url";const h=new Set([`.ts`,`.tsx`,`.js`,`.jsx`,`.mjs`,`.cjs`,`.md`,`.css`,`.html`,`.yml`,`.yaml`,`.toml`,`.env`,`.sh`,`.py`]);function g(e){let t=e.lastIndexOf(`.`);return t===-1?!0:h.has(e.slice(t))}function _(t){let{srcDir:s,dstDir:c,projectName:u,lykomiPackageVersion:d,rewriteRootPackageJson:f}=t;function p(t,s,c){for(let m of i(t)){let i=l(t,m),h=a(i),_=l(s,m.startsWith(`_`)&&!m.startsWith(`__`)&&m!==`_`?`.`+m.slice(1):m);if(h.isDirectory()){n(_,{recursive:!0}),p(i,_,c+1);continue}if(f&&c===0&&m===`package.json`){let e=JSON.parse(r(i,`utf-8`));e.name=u,d&&C(e,d),o(_,JSON.stringify(e,null,2)+`
+`);continue}if(g(m)){o(_,r(i,`utf-8`).split(`__PROJECT_NAME__`).join(u));continue}e(i,_)}}p(s,c,0)}async function v(e){_({srcDir:e.sourceDir,dstDir:e.targetDir,projectName:e.projectName,lykomiPackageVersion:e.lykomiPackageVersion,rewriteRootPackageJson:!0})}async function y(e){_({srcDir:e.overlayDir,dstDir:e.targetDir,projectName:e.projectName,rewriteRootPackageJson:!1})}async function b(e){if(!e.extraDependencies&&!e.extraDevDependencies&&!e.extraScripts)return;let t=l(e.targetDir,`package.json`),n=JSON.parse(r(t,`utf-8`));e.extraDependencies&&(n.dependencies=x({...n.dependencies??{},...e.extraDependencies})),e.extraDevDependencies&&(n.devDependencies=x({...n.devDependencies??{},...e.extraDevDependencies})),e.extraScripts&&(n.scripts={...n.scripts??{},...e.extraScripts}),o(t,JSON.stringify(n,null,2)+`
+`)}function x(e){let t={};for(let n of Object.keys(e).sort())t[n]=e[n];return t}const S=[`@lykomi/agent`,`@lykomi/web-graph`,`@lykomi/web-primitives`,`@lykomi/web-shell`,`@lykomi/web-ui`];function C(e,t){for(let n of[`dependencies`,`devDependencies`]){let r=e[n];if(!r||typeof r!=`object`||Array.isArray(r))continue;let i=r;for(let e of S)e in i&&(i[e]=t)}}async function w(e){if(e===`default`)return{name:e,templateDir:T()};if(e===`foundry-iq`||e===`neo4j`)return await D({name:e,presetRoot:E(e)});throw Error(`Unknown preset: ${e}`)}function T(){let e=c(m(import.meta.url)),n=e;for(let e=0;e<5;e++){let e=l(n,`template`);if(t(e))return e;let r=c(n);if(r===n)break;n=r}throw Error(`Could not locate bundled template/ relative to ${e}. Did you build the CLI? Run \`pnpm build\` in packages/create-lykomi-app.`)}function E(e){let n=c(m(import.meta.url)),r=n;for(let n=0;n<5;n++){let n=l(r,`presets`,e);if(t(n))return n;let i=c(r);if(i===r)break;r=i}throw Error(`Could not locate bundled presets/${e}/ relative to ${n}. Did you build the CLI? Run \`pnpm build\` in packages/create-lykomi-app.`)}async function D(e){let n=l(e.presetRoot,`manifest.json`);if(!t(n))throw Error(`Bundled preset '${e.name}' has no manifest.json.`);let r=JSON.parse(await p(n,`utf-8`));return O(e.name,e.presetRoot,r)}function O(e,n,r){if(r.extends&&r.extends!==`default`)throw Error(`Preset '${e}' extends '${r.extends}', but only 'default' is supported.`);let i=r.filesDir??`files`,a=l(n,i);if(!t(a))throw Error(r.filesDir===void 0?`Preset '${e}' has no '${i}/' directory at the package root (default filesDir).`:`Preset '${e}' declares filesDir='${i}' but the directory is missing in the package.`);return{name:e,templateDir:T(),overlayDir:a,extraDependencies:r.extraDependencies,extraDevDependencies:r.extraDevDependencies,extraScripts:r.extraScripts,envVars:r.envVars,postInstall:r.postInstall}}function k(e){let t={targetDir:null,preset:`default`,install:!0,force:!1,help:!1};for(let n=0;n<e.length;n++){let r=e[n];switch(r){case`-h`:case`--help`:t.help=!0;break;case`--no-install`:t.install=!1;break;case`--force`:t.force=!0;break;case`--preset`:t.preset=e[++n]??`default`;break;default:if(r.startsWith(`--`))throw Error(`Unknown flag: ${r}`);t.targetDir===null&&(t.targetDir=r)}}return t}function A(){console.log(`Usage: create-lykomi-app <target-dir> [options]
 
 Scaffold a new LYKOMI app — AG-UI protocol + Microsoft Agent Framework + Azure Foundry.
 
@@ -22,4 +22,4 @@ Example:
 `+t.map(e=>`  - ${e.name}: ${e.description}`).join(`
 `)),n.length>0&&f.log.info(`Optional env vars:
 `+n.map(e=>`  - ${e.name}: ${e.description}`).join(`
-`))}function M(e){let t=l(e,`package.json`),n=JSON.parse(r(t,`utf-8`)).dependencies?.[`@iloveagents/foundry-agent`];if(!n)throw Error(`Template package.json is missing @iloveagents/foundry-agent.`);if(!/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(n))throw Error(`Template @iloveagents/foundry-agent must use an exact version, got '${n}'.`);return n}async function N(){let e=k(process.argv.slice(2));if(e.help)return A(),0;let r=e.targetDir;if(!r){let e=await f.text({message:`Project directory:`,placeholder:`my-foundry-app`,validate:e=>!e||e.length===0?`Required`:void 0});if(f.isCancel(e))return f.cancel(`Cancelled.`),1;r=String(e)}let a=u(process.cwd(),r),o=t(a);if(o&&!e.force&&i(a).length>0)return f.log.error(`Target ${a} is not empty. Use --force to scaffold over it.`),1;o||n(a,{recursive:!0}),f.log.step(`Scaffolding into ${a}`),f.log.step(`Preset: ${e.preset}`);let c=await w(e.preset),l=s(a).replace(/^[^a-zA-Z]+/,``).replace(/[^a-zA-Z0-9-_]/g,`-`)||`my-app`;if(await v({sourceDir:c.templateDir,targetDir:a,projectName:l,foundryPackageVersion:M(c.templateDir)}),c.overlayDir&&await y({overlayDir:c.overlayDir,targetDir:a,projectName:l}),await b({targetDir:a,extraDependencies:c.extraDependencies,extraDevDependencies:c.extraDevDependencies,extraScripts:c.extraScripts}),f.log.success(`Files copied (preset: ${c.name}).`),e.install){let e=f.spinner();e.start(`pnpm install`);let t=d(`pnpm`,[`install`],{cwd:a,stdio:`inherit`});if(t.status!==0)return e.error(`pnpm install failed`),f.log.warn("Scaffold completed but install failed. cd into the dir and re-run `pnpm install`."),t.status??1;e.stop(`pnpm install done`)}else f.log.info(`Skipped pnpm install (--no-install).`);return j(c.envVars),f.outro(`✓ Done. Next:\n  cd ${r}\n  pnpm dev`),0}N().then(e=>process.exit(e),e=>{console.error(e instanceof Error?e.message:e),process.exit(1)});export{};
+`))}function M(e){let t=l(e,`package.json`),n=JSON.parse(r(t,`utf-8`)).dependencies?.[`@lykomi/agent`];if(!n)throw Error(`Template package.json is missing @lykomi/agent.`);if(!/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(n))throw Error(`Template @lykomi/agent must use an exact version, got '${n}'.`);return n}async function N(){let e=k(process.argv.slice(2));if(e.help)return A(),0;let r=e.targetDir;if(!r){let e=await f.text({message:`Project directory:`,placeholder:`my-lykomi-app`,validate:e=>!e||e.length===0?`Required`:void 0});if(f.isCancel(e))return f.cancel(`Cancelled.`),1;r=String(e)}let a=u(process.cwd(),r),o=t(a);if(o&&!e.force&&i(a).length>0)return f.log.error(`Target ${a} is not empty. Use --force to scaffold over it.`),1;o||n(a,{recursive:!0}),f.log.step(`Scaffolding into ${a}`),f.log.step(`Preset: ${e.preset}`);let c=await w(e.preset),l=s(a).replace(/^[^a-zA-Z]+/,``).replace(/[^a-zA-Z0-9-_]/g,`-`)||`my-app`;if(await v({sourceDir:c.templateDir,targetDir:a,projectName:l,lykomiPackageVersion:M(c.templateDir)}),c.overlayDir&&await y({overlayDir:c.overlayDir,targetDir:a,projectName:l}),await b({targetDir:a,extraDependencies:c.extraDependencies,extraDevDependencies:c.extraDevDependencies,extraScripts:c.extraScripts}),f.log.success(`Files copied (preset: ${c.name}).`),e.install){let e=f.spinner();e.start(`pnpm install`);let t=d(`pnpm`,[`install`],{cwd:a,stdio:`inherit`});if(t.status!==0)return e.error(`pnpm install failed`),f.log.warn("Scaffold completed but install failed. cd into the dir and re-run `pnpm install`."),t.status??1;e.stop(`pnpm install done`)}else f.log.info(`Skipped pnpm install (--no-install).`);return j(c.envVars),f.outro(`✓ Done. Next:\n  cd ${r}\n  pnpm dev`),0}N().then(e=>process.exit(e),e=>{console.error(e instanceof Error?e.message:e),process.exit(1)});export{};

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "create-lykomi-app",
-  "version": "0.9.21",
+  "version": "0.10.0",
   "license": "MIT",
   "description": "Scaffold a new LYKOMI app — AG-UI protocol + Microsoft Agent Framework + Azure Foundry, ready to run.",
   "keywords": [
     "create-app",
-    "foundry-ui",
+    "lykomi-ui",
     "ag-ui",
     "agent-framework",
     "azure-foundry",
@@ -26,9 +26,9 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/lykomi/ui.git",
-    "directory": "packages/create-foundry-ui-app"
+    "directory": "packages/create-lykomi-app"
   },
-  "homepage": "https://github.com/lykomi/ui/tree/main/packages/create-foundry-ui-app#readme",
+  "homepage": "https://github.com/lykomi/ui/tree/main/packages/create-lykomi-app#readme",
   "bugs": "https://github.com/lykomi/ui/issues",
   "publishConfig": {
     "access": "public"

package/presets/foundry-iq/files/AGENTS.md

@@ -1,11 +1,11 @@
-This is a Foundry UI starter app with Foundry IQ retrieval: React chat UI, AG-UI transport, Microsoft Agent Framework, and an Azure AI Search knowledge base MCP tool.
+This is a LYKOMI UI starter app with Foundry IQ retrieval: React chat UI, AG-UI transport, Microsoft Agent Framework, and an Azure AI Search knowledge base MCP tool.
 
 # Architecture
 
 ```text
-src/main.tsx              Foundry UI shell bootstrap
+src/main.tsx              LYKOMI UI shell bootstrap
 src/pages/chat-page.tsx   Chat screen and Foundry IQ starter prompts
-src/index.css             Tailwind v4 plus @iloveagents/foundry-web-ui/styles.css
+src/index.css             Tailwind v4 plus @lykomi/web-ui/styles.css
 src/tools/                Foundry IQ search result tool card and ChatModule registration
 agent/app/main.py         FastAPI app, AG-UI endpoint, and request header capture
 agent/app/agent.py        FoundryChatClient + Agent configuration
@@ -60,7 +60,7 @@ FOUNDRY_IQ_KNOWLEDGE_BASE=<knowledge-base-name>
 - Keep the `foundry_iq_search` tool card and activity viewer in `src/tools/search-results-tool-ui.tsx`. If the tool output shape changes, normalize it there instead of leaking Foundry IQ-specific parsing into the shared package.
 - Configure app name, browser title, logos, colors, radius, and fonts through `theme` layers in `src/main.tsx`.
 - Keep `@source "../node_modules/@iloveagents/.../dist"` entries in `src/index.css`; Tailwind v4 needs them to scan package component classes.
-- Keep `@import "@iloveagents/foundry-web-ui/styles.css";`; it provides the Foundry UI theme tokens.
+- Keep `@import "@lykomi/web-ui/styles.css";`; it provides the LYKOMI UI theme tokens.
 
 # Checks
 

package/presets/foundry-iq/files/README.md

@@ -1,6 +1,6 @@
 # __PROJECT_NAME__
 
-Foundry UI starter with a Microsoft Agent Framework service, AG-UI chat, and a Foundry IQ knowledge base tool.
+LYKOMI UI starter with a Microsoft Agent Framework service, AG-UI chat, and a Foundry IQ knowledge base tool.
 
 ## Quick Start
 
@@ -124,10 +124,10 @@ Restart `pnpm dev` after changing Python dependencies or environment variables.
 agent/                      FastAPI + Microsoft Agent Framework AG-UI endpoint
 agent/app/foundry_iq.py     Foundry IQ MCP retrieval tool
 agent/app/tools.py          Add local agent tools here
-src/main.tsx                Foundry UI shell bootstrap
+src/main.tsx                LYKOMI UI shell bootstrap
 src/pages/chat-page.tsx     Chat screen and quick starts
 src/tools/                  Custom tool cards registered through ChatModules
-src/index.css               Tailwind v4 + Foundry UI theme resource and package dist scanning
+src/index.css               Tailwind v4 + LYKOMI UI theme resource and package dist scanning
 ```
 
 ## Auth

package/presets/foundry-iq/files/agent/app/agent.py

@@ -16,7 +16,7 @@ def get_agent() -> Agent:
         client=client,
         name="FoundryIQAgent",
         instructions=(
-            "You are a concise assistant for a Foundry UI app. "
+            "You are a concise assistant for a LYKOMI UI app. "
             "Use foundry_iq_search when the user asks about knowledge-base content, "
             "documents, SharePoint-backed content, or retrieval-backed answers. "
             "Use hello_world when the user asks for hello world or a hello demo. "

package/presets/foundry-iq/files/agent/app/foundry_iq.py

@@ -316,7 +316,7 @@ async def _call_knowledge_base(query: str) -> str:
                     "params": {
                         "protocolVersion": MCP_PROTOCOL_VERSION,
                         "capabilities": {},
-                        "clientInfo": {"name": "foundry-ui-starter", "version": "0.0.0"},
+                        "clientInfo": {"name": "lykomi-ui-starter", "version": "0.0.0"},
                     },
                 },
             )

package/presets/foundry-iq/files/agent/app/main.py

@@ -36,7 +36,7 @@ async def foundry_iq_security_trimming_context(request: Request, call_next):
 STATE_SCHEMA = {
     "navigation": {
         "type": "object",
-        "description": "Current app route and navigation metadata from Foundry UI.",
+        "description": "Current app route and navigation metadata from LYKOMI UI.",
         "additionalProperties": True,
     },
     "selectedItemId": {

package/presets/foundry-iq/files/src/main.tsx

@@ -1,6 +1,6 @@
 import "./index.css";
-import { bootstrapShell } from "@iloveagents/foundry-web-shell";
-import type { AuthAdapter } from "@iloveagents/foundry-web-shell";
+import { bootstrapShell } from "@lykomi/web-shell";
+import type { AuthAdapter } from "@lykomi/web-shell";
 import { customerPages } from "@/pages/index.tsx";
 import { foundryIqModule } from "@/tools/foundry-iq-module.tsx";
 
@@ -18,8 +18,8 @@ bootstrapShell({
       id: "app-branding",
       definition: {
         branding: {
-          appName: "Foundry UI",
-          appTitle: "Foundry UI",
+          appName: "LYKOMI UI",
+          appTitle: "LYKOMI UI",
         },
       },
     },

package/presets/foundry-iq/files/src/pages/chat-page.tsx

@@ -1,4 +1,4 @@
-import { ChatContent } from "@iloveagents/foundry-web-ui";
+import { ChatContent } from "@lykomi/web-ui";
 
 const starterSuggestions = [
   "Search Foundry IQ for a knowledge base summary",

package/presets/foundry-iq/files/src/tools/foundry-iq-module.tsx

@@ -1,4 +1,4 @@
-import { defineChatModule } from "@iloveagents/foundry-web-shell";
+import { defineChatModule } from "@lykomi/web-shell";
 import { FoundryIQSearchToolUI } from "./search-results-tool-ui.tsx";
 
 export const foundryIqModule = defineChatModule({

package/presets/foundry-iq/files/src/tools/search-results-tool-ui.tsx

@@ -1,6 +1,6 @@
 import { makeAssistantToolUI } from "@assistant-ui/react";
-import { cn } from "@iloveagents/foundry-web-primitives";
-import { ToolCallCard, type ToolCallStatus } from "@iloveagents/foundry-web-ui";
+import { cn } from "@lykomi/web-primitives";
+import { ToolCallCard, type ToolCallStatus } from "@lykomi/web-ui";
 import { Brain, Clock3, Database, ExternalLink, FileText, Search, Wrench } from "lucide-react";
 
 interface SearchToolArgs {

package/presets/neo4j/files/AGENTS.md

@@ -1,11 +1,11 @@
-This is a Foundry UI starter that gives an agent a Neo4j graph: React chat UI, AG-UI transport, Microsoft Agent Framework, and graph tools whose results render as an interactive graph.
+This is a LYKOMI UI starter that gives an agent a Neo4j graph: React chat UI, AG-UI transport, Microsoft Agent Framework, and graph tools whose results render as an interactive graph.
 
 # Architecture
 
 ```text
-src/main.tsx                 Foundry UI shell bootstrap
+src/main.tsx                 LYKOMI UI shell bootstrap
 src/pages/chat-page.tsx      Chat screen and graph starter prompts
-src/index.css                Tailwind v4 + foundry-web-ui and foundry-web-graph styles
+src/index.css                Tailwind v4 + web-ui and web-graph styles
 src/tools/graph-module.tsx   Binds tool names to the graph card; registers the panel renderer
 vite.config.ts               manualChunks — the vendor-graph rule MUST stay above the react rule
 agent/app/main.py            FastAPI app, AG-UI endpoint, driver lifespan
@@ -65,8 +65,8 @@ Aura instead of local: change `NEO4J_URI` to `neo4j+s://<instance-id>.databases.
   interface, so on a shared network anyone routable could read and rewrite the
   graph.
 - **Parameters, never string interpolation.** Cypher is built as a constant with `$name` placeholders. No f-strings, no `.format()`, no `%`.
-- **`vite.config.ts` chunk order.** `react-force-graph-2d`, `react-kapsule` and `foundry-web-graph` all contain "react"; the `vendor-graph` rule has to come before `id.includes("react")` or the whole force engine lands in `vendor-react`.
-- **`src/index.css` needs the `@source` line for `foundry-web-graph/dist`.** Tailwind v4 cannot infer classes from package output without it, and the graph chrome renders unstyled.
+- **`vite.config.ts` chunk order.** `react-force-graph-2d`, `react-kapsule` and `web-graph` all contain "react"; the `vendor-graph` rule has to come before `id.includes("react")` or the whole force engine lands in `vendor-react`.
+- **`src/index.css` needs the `@source` line for `web-graph/dist`.** Tailwind v4 cannot infer classes from package output without it, and the graph chrome renders unstyled.
 
 # Adding a graph tool
 
@@ -87,4 +87,4 @@ The agent can also call `show_graph` with a payload to put any graph in the side
 
 # Where the visualization lives
 
-`@iloveagents/foundry-web-graph`, an npm package. It is source-neutral: it takes the payload contract and knows nothing about Neo4j or Cypher. Its `@iloveagents/foundry-web-graph/adapters/neo4j` entry point converts driver-shaped records in the browser, for apps that query a graph directly rather than through an agent.
+`@lykomi/web-graph`, an npm package. It is source-neutral: it takes the payload contract and knows nothing about Neo4j or Cypher. Its `@lykomi/web-graph/adapters/neo4j` entry point converts driver-shaped records in the browser, for apps that query a graph directly rather than through an agent.

package/presets/neo4j/files/README.md

@@ -1,6 +1,6 @@
 # __PROJECT_NAME__
 
-A Foundry UI starter that gives an agent a Neo4j graph: it reads the schema,
+A LYKOMI UI starter that gives an agent a Neo4j graph: it reads the schema,
 writes its own Cypher, and every result comes back as an interactive graph
 rather than a wall of JSON.
 
@@ -182,6 +182,6 @@ scripts/seed_graph.py       the demo graph
 docker-compose.yml          local Neo4j (development only)
 ```
 
-The visualization itself is `@iloveagents/foundry-web-graph`, which knows
+The visualization itself is `@lykomi/web-graph`, which knows
 nothing about Neo4j — it takes a source-neutral payload. You can point it at
 any graph data you have.

package/presets/neo4j/files/agent/app/graph_payload.py

@@ -1,6 +1,6 @@
 """Neo4j driver records -> the ``foundry.graph`` payload the UI renders.
 
-The contract is defined by ``@iloveagents/foundry-web-graph`` and is
+The contract is defined by ``@lykomi/web-graph`` and is
 deliberately source-neutral: the visualizer never learns that Neo4j exists.
 Keep the field names here in step with ``GraphPayload`` in that package.
 """
@@ -207,7 +207,7 @@ def select_connected_core(
     Every node after the first seed is adjacent to one already chosen, so the
     result is a handful of connected neighbourhoods rather than scattered dust.
 
-    Mirrors ``selectConnectedCore`` in ``@iloveagents/foundry-web-graph``; both
+    Mirrors ``selectConnectedCore`` in ``@lykomi/web-graph``; both
     sides cap, and they have to agree on what the important part of a graph is.
     """
     if len(node_ids) <= limit:

package/presets/neo4j/files/agent/app/graph_tools.py

@@ -1,7 +1,7 @@
 """Graph tools for the agent.
 
 Every tool returns the ``foundry.graph`` payload that
-``@iloveagents/foundry-web-graph`` renders, so any result the agent produces can
+``@lykomi/web-graph`` renders, so any result the agent produces can
 be drawn as a graph rather than read as JSON.
 
 Read and write are separate tools, and the write tool is only registered when

package/presets/neo4j/files/agent/app/main.py

@@ -32,7 +32,7 @@ app.add_middleware(
 STATE_SCHEMA = {
     "navigation": {
         "type": "object",
-        "description": "Current app route and navigation metadata from Foundry UI.",
+        "description": "Current app route and navigation metadata from LYKOMI UI.",
         "additionalProperties": True,
     },
     "selectedItemId": {

package/presets/neo4j/files/agent/tests/test_graph_payload.py

@@ -1,7 +1,7 @@
 """The payload contract, without a database.
 
 Everything here is pure: given driver-shaped values, does the payload come out
-in the shape ``@iloveagents/foundry-web-graph`` renders? These are the rules a
+in the shape ``@lykomi/web-graph`` renders? These are the rules a
 change to the tools is most likely to break silently, because the failure
 shows up as a graph that looks slightly wrong rather than as an error.
 """

package/presets/neo4j/files/src/index.css

@@ -1,17 +1,17 @@
 @import "tailwindcss";
-@import "@iloveagents/foundry-web-ui/styles.css";
+@import "@lykomi/web-ui/styles.css";
 /* Graph node palette. Optional — without it the graph falls back to the
  * host's --chart-* tokens — but these give eight well-separated hues instead
  * of five. */
-@import "@iloveagents/foundry-web-graph/styles.css";
+@import "@lykomi/web-graph/styles.css";
 
 /* Tailwind v4 needs explicit @source paths to scan package output
- * for utility classes. Without these, the Foundry UI components render
+ * for utility classes. Without these, the LYKOMI UI components render
  * without spacing, borders, or theme tokens. */
-@source "../node_modules/@iloveagents/foundry-web-primitives/dist";
-@source "../node_modules/@iloveagents/foundry-web-ui/dist";
-@source "../node_modules/@iloveagents/foundry-web-shell/dist";
-@source "../node_modules/@iloveagents/foundry-web-graph/dist";
+@source "../node_modules/@lykomi/web-primitives/dist";
+@source "../node_modules/@lykomi/web-ui/dist";
+@source "../node_modules/@lykomi/web-shell/dist";
+@source "../node_modules/@lykomi/web-graph/dist";
 
 @plugin "tailwindcss-animate";
 

package/presets/neo4j/files/src/main.tsx

@@ -1,7 +1,7 @@
 import "./index.css";
-import { bootstrapShell } from "@iloveagents/foundry-web-shell";
-import type { AuthAdapter } from "@iloveagents/foundry-web-shell";
-import { createVoiceModule } from "@iloveagents/foundry-web-voice";
+import { bootstrapShell } from "@lykomi/web-shell";
+import type { AuthAdapter } from "@lykomi/web-shell";
+import { createVoiceModule } from "@lykomi/web-voice";
 import { customerPages } from "@/pages/index.tsx";
 import { graphModule } from "@/tools/graph-module.tsx";
 

package/presets/neo4j/files/src/pages/chat-page.tsx

@@ -1,4 +1,4 @@
-import { ChatContent } from "@iloveagents/foundry-web-ui";
+import { ChatContent } from "@lykomi/web-ui";
 
 const starterSuggestions = [
   "What's in this graph?",

package/presets/neo4j/files/src/tools/graph-module.tsx

@@ -1,12 +1,12 @@
 import { useEffect } from "react";
-import { defineChatModule } from "@iloveagents/foundry-web-shell";
+import { defineChatModule } from "@lykomi/web-shell";
 import {
   GraphResultSeeder,
   GraphToolUI,
   makeGraphToolUI,
   registerGraphClientTools,
   registerGraphPanelRenderer,
-} from "@iloveagents/foundry-web-graph/assistant-ui";
+} from "@lykomi/web-graph/assistant-ui";
 
 /**
  * Bind the graph card to this app's tool names.

package/presets/neo4j/files/vite.config.ts

@@ -33,8 +33,8 @@ export default defineConfig({
         manualChunks(id) {
           if (!id.includes("node_modules")) return;
           // Match on the PACKAGE, not the path: pnpm's store directories
-          // embed peer names ("…foundry-web-ui@…_@ag-ui+client@…_@assistant-u…"),
-          // so a substring match on the full path filed foundry-web-ui under
+          // embed peer names ("…web-ui@…_@ag-ui+client@…_@assistant-u…"),
+          // so a substring match on the full path filed web-ui under
           // whichever peer name the rules met first, and "react" matched
           // half the store. The last node_modules segment is the package.
           const pkg = id.slice(id.lastIndexOf("node_modules/") + "node_modules/".length);
@@ -50,7 +50,7 @@ export default defineConfig({
           // The force engine and its d3 stack, in one chunk of their own.
           // ORDER MATTERS: "react-force-graph-2d" and "react-kapsule" would
           // otherwise be caught by a react rule and load on first paint.
-          // And note what is NOT here: `@iloveagents/foundry-web-graph` is
+          // And note what is NOT here: `@lykomi/web-graph` is
           // deliberately left unassigned. It lazy-imports its canvas module,
           // and naming the package in a manualChunk puts the importer and the
           // imported module in the SAME chunk — which collapses the boundary
@@ -74,16 +74,16 @@ export default defineConfig({
           if (pkg.startsWith("@ag-ui/")) return "vendor-ag-ui";
           if (pkg.startsWith("@azure/msal")) return "vendor-auth";
           if (
-            pkg.startsWith("@iloveagents/foundry-web-ui/dist/workbench.js") ||
-            pkg.startsWith("@iloveagents/foundry-web-ui/dist/workbench/")
+            pkg.startsWith("@lykomi/web-ui/dist/workbench.js") ||
+            pkg.startsWith("@lykomi/web-ui/dist/workbench/")
           )
-            return "foundry-workbench";
-          if (pkg.startsWith("@iloveagents/foundry-web-ui/")) return "vendor-foundry-ui";
-          if (pkg.startsWith("@iloveagents/foundry-web-shell/")) return "vendor-foundry-shell";
-          if (pkg.startsWith("@iloveagents/foundry-agent/")) return "vendor-foundry-agent";
+            return "lykomi-workbench";
+          if (pkg.startsWith("@lykomi/web-ui/")) return "vendor-lykomi-ui";
+          if (pkg.startsWith("@lykomi/web-shell/")) return "vendor-lykomi-shell";
+          if (pkg.startsWith("@lykomi/agent/")) return "vendor-lykomi-agent";
           // Voice is optional at runtime and heavy at build; its own chunk
           // keeps the main path light and the size gate honest.
-          if (pkg.startsWith("@iloveagents/foundry-web-voice/")) return "vendor-foundry-voice";
+          if (pkg.startsWith("@lykomi/web-voice/")) return "vendor-lykomi-voice";
           // Before the react rule: recharts drags react-smooth + the d3
           // sub-packages along, and "react-smooth" would land in
           // vendor-react and push it past the chunk-size gate.

package/presets/neo4j/manifest.json

@@ -5,7 +5,7 @@
   "extends": "default",
   "filesDir": "files",
   "extraDependencies": {
-    "@iloveagents/foundry-web-graph": "0.3.16"
+    "@lykomi/web-graph": "0.3.18"
   },
   "extraScripts": {
     "graph:up": "docker compose up -d",

package/template/AGENTS.md

@@ -1,11 +1,15 @@
-This is a Foundry UI starter app: React chat UI, AG-UI transport, and a Microsoft Agent Framework service.
+This is a LYKOMI UI starter app: React chat UI, AG-UI transport, and a Microsoft Agent Framework service.
 
 # Architecture
 
 ```text
-src/main.tsx              Foundry UI shell bootstrap
-src/pages/chat-page.tsx   Chat screen and starter prompts
-src/index.css             Tailwind v4 plus @iloveagents/foundry-web-ui/styles.css
+src/main.tsx              LYKOMI UI shell bootstrap
+src/pages/chat-page.tsx   Chat route
+src/pages/starter-prompts.tsx  Home prompts
+src/pages/guide-page.tsx       Example content page
+src/starter-module.ts          Navigation, agent context, interface menu
+src/theme.ts                   App palette and branding
+src/index.css             Tailwind v4 plus @lykomi/web-ui/styles.css
 agent/app/main.py         FastAPI app and AG-UI endpoint
 agent/app/agent.py        FoundryChatClient + Agent configuration
 agent/app/tools.py        Agent Framework tools; update AGENT_TOOLS here
@@ -28,7 +32,7 @@ Set these in `agent/.env`:
 
 ```bash
 FOUNDRY_PROJECT_ENDPOINT=https://<account>.services.ai.azure.com/api/projects/<project>
-FOUNDRY_MODEL=gpt-5.4
+FOUNDRY_MODEL=your-model-deployment
 ```
 
 `FoundryChatClient` reads the Microsoft Agent Framework env vars directly. The Python agent passes `DefaultAzureCredential`; prefer `az login` locally and managed identity or service principal env vars in hosted environments.
@@ -43,19 +47,20 @@ FOUNDRY_MODEL=gpt-5.4
 
 # Update Modes
 
-- Package-backed mode: keep `@iloveagents/foundry-*` dependencies and update them through npm/pnpm for central fixes to UI, shell, theme resources, and AG-UI transport.
+- Package-backed mode: keep `@lykomi/*` dependencies and update them through npm/pnpm for central fixes to UI, shell, theme resources, and AG-UI transport.
 - Copy/template mode: once this app is copied into its own GitHub template or deeply customized repo, local `src/` and `agent/` files are owned by that repo. Pull upstream starter ideas manually.
 - Package updates must not overwrite local app code. Template structure changes only apply when a new app is scaffolded or manually merged.
 
 # UI
 
 - Keep the starter chat-first. Do not add landing pages, marketing heroes, or domain-specific clutter.
-- Configure quick starts in `src/pages/chat-page.tsx`.
-- Configure app name, browser title, logos, colors, radius, and fonts through `theme` layers in `src/main.tsx`.
-- Keep the default generated app name and browser title as `Foundry UI` unless the app is intentionally rebranded.
-- Use Foundry UI components from `@iloveagents/foundry-web-ui` and primitives from `@iloveagents/foundry-web-primitives`.
-- Keep `@source "../node_modules/@iloveagents/.../dist"` entries in `src/index.css`; Tailwind v4 needs them to scan package component classes.
-- Keep `@import "@iloveagents/foundry-web-ui/styles.css";`; it provides the Foundry UI theme tokens.
+- Configure quick starts in `src/pages/starter-prompts.tsx`.
+- Configure app name, browser title, logos, colors, radius, and fonts in `src/theme.ts`.
+- Keep the Guide page and its `ChatModule` as an example of page context and persistent chat; replace them when building your app.
+- Keep the default generated app name and browser title as `LYKOMI UI` unless the app is intentionally rebranded.
+- Use LYKOMI UI components from `@lykomi/web-ui` and primitives from `@lykomi/web-primitives`.
+- Keep `@source "../node_modules/@lykomi/.../dist"` entries in `src/index.css`; Tailwind v4 needs them to scan package component classes.
+- Keep `@import "@lykomi/web-ui/styles.css";`; it provides the LYKOMI UI theme tokens.
 
 # Attachments