@guuey/create-agentic-app 0.8.1 → 0.10.0

package/dist/index.cjs

@@ -22,6 +22,7 @@ var index_exports = {};
 __export(index_exports, {
   isNpmSafeName: () => isNpmSafeName,
   scaffold: () => scaffold,
+  scaffoldExample: () => scaffoldExample,
   scaffoldMcp: () => scaffoldMcp
 });
 module.exports = __toCommonJS(index_exports);
@@ -86,27 +87,33 @@ var execFileAsync = (0, import_node_util.promisify)(import_node_child_process.ex
 var here = (0, import_node_path.dirname)((0, import_node_url.fileURLToPath)(import_meta.url));
 var packageRoot = (0, import_node_path.join)(here, "..");
 var defaultTemplatesDir = (0, import_node_path.join)(packageRoot, "dist", "templates");
-async function listAvailableFrameworks(templatesDir) {
+async function listDirs(root) {
   try {
-    const entries = await import_node_fs2.promises.readdir(templatesDir, { withFileTypes: true });
+    const entries = await import_node_fs2.promises.readdir(root, { withFileTypes: true });
     return entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name);
   } catch (err) {
     if (isErrnoException(err) && err.code === "ENOENT") return [];
     throw err;
   }
 }
-async function resolveTemplateDir(templatesDir, framework) {
-  const dir = (0, import_node_path.join)(templatesDir, framework);
+async function resolveTemplateDir(templatesDir, template, framework) {
+  const dir = (0, import_node_path.join)(templatesDir, template, framework);
   if (await pathExists(dir)) return dir;
-  const available = await listAvailableFrameworks(templatesDir);
-  const list = available.length > 0 ? available.join(", ") : `(none found under ${templatesDir})`;
+  const templates = (await listDirs(templatesDir)).filter((name) => name !== "mcp-base");
+  if (!templates.includes(template)) {
+    const list2 = templates.length > 0 ? templates.join(", ") : `(none found under ${templatesDir})`;
+    throw new Error(`No template "${template}". Available templates: ${list2}`);
+  }
+  const frameworks = await listDirs((0, import_node_path.join)(templatesDir, template));
+  const list = frameworks.length > 0 ? frameworks.join(", ") : `(none found under ${(0, import_node_path.join)(templatesDir, template)})`;
   throw new Error(`No template for framework "${framework}". Available frameworks: ${list}`);
 }
 async function copyTree(src, dest, name, scope) {
   await import_node_fs2.promises.mkdir(dest, { recursive: true });
   const entries = await import_node_fs2.promises.readdir(src, { withFileTypes: true });
   for (const entry of entries) {
-    const destName = renameContent(entry.name, name, scope);
+    const rawName = entry.name === "gitignore" ? ".gitignore" : entry.name;
+    const destName = renameContent(rawName, name, scope);
     const srcPath = (0, import_node_path.join)(src, entry.name);
     const destPath = (0, import_node_path.join)(dest, destName);
     if (entry.isDirectory()) {
@@ -168,7 +175,7 @@ async function scaffold(opts) {
   assertNpmSafeName(opts.name, "project");
   const scope = opts.scope ?? opts.name;
   const templatesDir = opts.templatesDir ?? defaultTemplatesDir;
-  const templateDir = await resolveTemplateDir(templatesDir, opts.framework);
+  const templateDir = await resolveTemplateDir(templatesDir, opts.template ?? "base", opts.framework);
   const projectDir = (0, import_node_path.resolve)(opts.targetDir);
   await ensureTargetDir(projectDir, opts.force);
   await copyTree(templateDir, projectDir, opts.name, scope);
@@ -182,32 +189,100 @@ async function scaffold(opts) {
   return { projectDir };
 }
 
-// src/scaffold-mcp.ts
+// src/scaffold-example.ts
 var import_node_fs3 = require("fs");
 var import_node_path2 = require("path");
+var import_promises = require("stream/promises");
+var import_node_stream = require("stream");
+var import_node_os = require("os");
+var import_tar = require("tar");
+var EXAMPLES_REPO = "withguuey/demos";
+var EXAMPLES_REF = "main";
+var TARBALL_URL = `https://codeload.github.com/${EXAMPLES_REPO}/tar.gz/${EXAMPLES_REF}`;
+async function defaultFetchTarball() {
+  const res = await fetch(TARBALL_URL);
+  if (!res.ok) {
+    throw new Error(
+      `Could not download ${EXAMPLES_REPO} (${res.status} from codeload.github.com). Check your network; the manual alternative is: npx degit ${EXAMPLES_REPO}/<example>`
+    );
+  }
+  return import_node_stream.Readable.from(Buffer.from(await res.arrayBuffer()));
+}
+async function saveTarball(fetchTarball) {
+  const file = (0, import_node_path2.join)(await import_node_fs3.promises.mkdtemp((0, import_node_path2.join)((0, import_node_os.tmpdir)(), "guuey-example-")), "demos.tar.gz");
+  await (0, import_promises.pipeline)(await fetchTarball(), (0, import_node_fs3.createWriteStream)(file));
+  return file;
+}
+async function listTarball(file) {
+  let root = null;
+  const examples = /* @__PURE__ */ new Set();
+  await (0, import_tar.t)({
+    file,
+    onReadEntry: (entry) => {
+      const segments = entry.path.split("/").filter(Boolean);
+      const first = segments[0];
+      if (first === void 0) return;
+      root ??= first;
+      const second = segments[1];
+      if (second !== void 0 && segments[2] === "guuey.json") examples.add(second);
+    }
+  });
+  if (root === null) throw new Error(`The ${EXAMPLES_REPO} tarball was empty.`);
+  return { root, examples: [...examples].sort() };
+}
+async function scaffoldExample(opts) {
+  const tarball = await saveTarball(opts.fetchTarball ?? defaultFetchTarball);
+  const { root, examples } = await listTarball(tarball);
+  if (!examples.includes(opts.example)) {
+    const list = examples.length > 0 ? examples.join(", ") : "(none published yet)";
+    throw new Error(`No example "${opts.example}" in ${EXAMPLES_REPO}. Available: ${list}`);
+  }
+  const projectDir = (0, import_node_path2.resolve)(opts.targetDir);
+  await ensureTargetDir(projectDir, opts.force);
+  const prefix = `${root}/${opts.example}/`;
+  await (0, import_tar.x)({
+    file: tarball,
+    cwd: projectDir,
+    strip: 2,
+    filter: (path) => path.startsWith(prefix)
+  });
+  if (!await pathExists((0, import_node_path2.join)(projectDir, "guuey.json"))) {
+    throw new Error(
+      `Extraction produced no guuey.json in ${projectDir} \u2014 the "${opts.example}" example looks malformed; please report this.`
+    );
+  }
+  await seedEnvLocal(projectDir);
+  if (opts.git !== false) await initGit(projectDir);
+  if (opts.install) await runInstall(projectDir);
+  return { projectDir };
+}
+
+// src/scaffold-mcp.ts
+var import_node_fs4 = require("fs");
+var import_node_path3 = require("path");
 var import_node_url2 = require("url");
 var import_meta2 = {};
-var here2 = (0, import_node_path2.dirname)((0, import_node_url2.fileURLToPath)(import_meta2.url));
-var packageRoot2 = (0, import_node_path2.join)(here2, "..");
-var defaultTemplatesDir2 = (0, import_node_path2.join)(packageRoot2, "dist", "templates");
+var here2 = (0, import_node_path3.dirname)((0, import_node_url2.fileURLToPath)(import_meta2.url));
+var packageRoot2 = (0, import_node_path3.join)(here2, "..");
+var defaultTemplatesDir2 = (0, import_node_path3.join)(packageRoot2, "dist", "templates");
 function renameMcpTokens(content, name, scope) {
   return renameContent(content.replaceAll("NAME_PLACEHOLDER", name), scope, scope);
 }
 async function copyMcpTree(src, dest, name, scope) {
-  await import_node_fs3.promises.mkdir(dest, { recursive: true });
-  const entries = await import_node_fs3.promises.readdir(src, { withFileTypes: true });
+  await import_node_fs4.promises.mkdir(dest, { recursive: true });
+  const entries = await import_node_fs4.promises.readdir(src, { withFileTypes: true });
   for (const entry of entries) {
     const destName = renameMcpTokens(entry.name, name, scope);
-    const srcPath = (0, import_node_path2.join)(src, entry.name);
-    const destPath = (0, import_node_path2.join)(dest, destName);
+    const srcPath = (0, import_node_path3.join)(src, entry.name);
+    const destPath = (0, import_node_path3.join)(dest, destName);
     if (entry.isDirectory()) {
       await copyMcpTree(srcPath, destPath, name, scope);
     } else {
-      const buf = await import_node_fs3.promises.readFile(srcPath);
+      const buf = await import_node_fs4.promises.readFile(srcPath);
       if (isProbablyText(buf)) {
-        await import_node_fs3.promises.writeFile(destPath, renameMcpTokens(buf.toString("utf8"), name, scope), "utf8");
+        await import_node_fs4.promises.writeFile(destPath, renameMcpTokens(buf.toString("utf8"), name, scope), "utf8");
       } else {
-        await import_node_fs3.promises.writeFile(destPath, buf);
+        await import_node_fs4.promises.writeFile(destPath, buf);
       }
     }
   }
@@ -216,11 +291,11 @@ async function scaffoldMcp(opts) {
   assertNpmSafeName(opts.name, "MCP");
   const scope = opts.scope ?? opts.name;
   const templatesDir = opts.templatesDir ?? defaultTemplatesDir2;
-  const templateDir = (0, import_node_path2.join)(templatesDir, "mcp-base");
+  const templateDir = (0, import_node_path3.join)(templatesDir, "mcp-base");
   if (!await pathExists(templateDir)) {
     throw new Error(`No mcp-base template found at ${templateDir}.`);
   }
-  const mcpDir = (0, import_node_path2.resolve)(opts.targetDir);
+  const mcpDir = (0, import_node_path3.resolve)(opts.targetDir);
   await ensureTargetDir(mcpDir, void 0);
   await copyMcpTree(templateDir, mcpDir, opts.name, scope);
   return { mcpDir };
@@ -229,5 +304,6 @@ async function scaffoldMcp(opts) {
 0 && (module.exports = {
   isNpmSafeName,
   scaffold,
+  scaffoldExample,
   scaffoldMcp
 });

package/dist/index.d.cts

@@ -1,11 +1,19 @@
 /** Frameworks the scaffolder ships templates for. */
 type Framework = 'claude-agent-sdk' | 'openai-agents-sdk' | 'google-adk';
+/**
+ * App templates the scaffolder ships. `base` = landing + login + home +
+ * chat; `agentic-app` extends it with the split-sidebar product shell whose
+ * agent dock swaps the main canvas to a fullscreen agent.
+ */
+type Template = 'base' | 'agentic-app';
 interface ScaffoldOptions {
     /** Absolute or cwd-relative path to create/populate the new project in. */
     targetDir: string;
     /** npm-safe project name (also used as the default scope). */
     name: string;
     framework: Framework;
+    /** App template. Default: `base`. */
+    template?: Template;
     /** Package scope for `@<scope>/*` packages. Default: `name`. */
     scope?: string;
     /** Run `pnpm install` in the new project after scaffolding. Default: false. */
@@ -14,7 +22,7 @@ interface ScaffoldOptions {
     git?: boolean;
     /** Scaffold into a non-empty targetDir anyway. Default: false. */
     force?: boolean;
-    /** Root directory holding one subdirectory per framework. Default: dist/templates. */
+    /** Root directory holding `<template>/<framework>` trees (+ `mcp-base/`). Default: dist/templates. */
     templatesDir?: string;
 }
 interface ScaffoldResult {
@@ -31,6 +39,29 @@ interface ScaffoldResult {
  */
 declare function scaffold(opts: ScaffoldOptions): Promise<ScaffoldResult>;
 
+interface ScaffoldExampleOptions {
+    /** Absolute or cwd-relative path to create/populate the new project in. */
+    targetDir: string;
+    /** The example's top-level directory name in withguuey/demos (e.g. `trimly`). */
+    example: string;
+    /** Run `pnpm install` after extraction. Default: false. */
+    install?: boolean;
+    /** Run `git init` + an initial commit. Default: true. */
+    git?: boolean;
+    /** Extract into a non-empty targetDir anyway. Default: false. */
+    force?: boolean;
+    /**
+     * Test seam: returns the repo tarball as a stream. Default fetches the
+     * codeload URL. The tarball's first path segment (`demos-main/`) is
+     * discovered, never assumed.
+     */
+    fetchTarball?: () => Promise<NodeJS.ReadableStream>;
+}
+interface ScaffoldExampleResult {
+    projectDir: string;
+}
+declare function scaffoldExample(opts: ScaffoldExampleOptions): Promise<ScaffoldExampleResult>;
+
 interface ScaffoldMcpOptions {
     /** Absolute or cwd-relative path to create the MCP package in. */
     targetDir: string;
@@ -73,4 +104,4 @@ declare function scaffoldMcp(opts: ScaffoldMcpOptions): Promise<ScaffoldMcpResul
 /** Whether `name` matches the npm-safe {@link NAME_PATTERN} rule. */
 declare function isNpmSafeName(name: string): boolean;
 
-export { type Framework, type ScaffoldMcpOptions, type ScaffoldMcpResult, type ScaffoldOptions, type ScaffoldResult, isNpmSafeName, scaffold, scaffoldMcp };
+export { type Framework, type ScaffoldExampleOptions, type ScaffoldExampleResult, type ScaffoldMcpOptions, type ScaffoldMcpResult, type ScaffoldOptions, type ScaffoldResult, type Template, isNpmSafeName, scaffold, scaffoldExample, scaffoldMcp };

package/dist/index.d.ts

@@ -1,11 +1,19 @@
 /** Frameworks the scaffolder ships templates for. */
 type Framework = 'claude-agent-sdk' | 'openai-agents-sdk' | 'google-adk';
+/**
+ * App templates the scaffolder ships. `base` = landing + login + home +
+ * chat; `agentic-app` extends it with the split-sidebar product shell whose
+ * agent dock swaps the main canvas to a fullscreen agent.
+ */
+type Template = 'base' | 'agentic-app';
 interface ScaffoldOptions {
     /** Absolute or cwd-relative path to create/populate the new project in. */
     targetDir: string;
     /** npm-safe project name (also used as the default scope). */
     name: string;
     framework: Framework;
+    /** App template. Default: `base`. */
+    template?: Template;
     /** Package scope for `@<scope>/*` packages. Default: `name`. */
     scope?: string;
     /** Run `pnpm install` in the new project after scaffolding. Default: false. */
@@ -14,7 +22,7 @@ interface ScaffoldOptions {
     git?: boolean;
     /** Scaffold into a non-empty targetDir anyway. Default: false. */
     force?: boolean;
-    /** Root directory holding one subdirectory per framework. Default: dist/templates. */
+    /** Root directory holding `<template>/<framework>` trees (+ `mcp-base/`). Default: dist/templates. */
     templatesDir?: string;
 }
 interface ScaffoldResult {
@@ -31,6 +39,29 @@ interface ScaffoldResult {
  */
 declare function scaffold(opts: ScaffoldOptions): Promise<ScaffoldResult>;
 
+interface ScaffoldExampleOptions {
+    /** Absolute or cwd-relative path to create/populate the new project in. */
+    targetDir: string;
+    /** The example's top-level directory name in withguuey/demos (e.g. `trimly`). */
+    example: string;
+    /** Run `pnpm install` after extraction. Default: false. */
+    install?: boolean;
+    /** Run `git init` + an initial commit. Default: true. */
+    git?: boolean;
+    /** Extract into a non-empty targetDir anyway. Default: false. */
+    force?: boolean;
+    /**
+     * Test seam: returns the repo tarball as a stream. Default fetches the
+     * codeload URL. The tarball's first path segment (`demos-main/`) is
+     * discovered, never assumed.
+     */
+    fetchTarball?: () => Promise<NodeJS.ReadableStream>;
+}
+interface ScaffoldExampleResult {
+    projectDir: string;
+}
+declare function scaffoldExample(opts: ScaffoldExampleOptions): Promise<ScaffoldExampleResult>;
+
 interface ScaffoldMcpOptions {
     /** Absolute or cwd-relative path to create the MCP package in. */
     targetDir: string;
@@ -73,4 +104,4 @@ declare function scaffoldMcp(opts: ScaffoldMcpOptions): Promise<ScaffoldMcpResul
 /** Whether `name` matches the npm-safe {@link NAME_PATTERN} rule. */
 declare function isNpmSafeName(name: string): boolean;
 
-export { type Framework, type ScaffoldMcpOptions, type ScaffoldMcpResult, type ScaffoldOptions, type ScaffoldResult, isNpmSafeName, scaffold, scaffoldMcp };
+export { type Framework, type ScaffoldExampleOptions, type ScaffoldExampleResult, type ScaffoldMcpOptions, type ScaffoldMcpResult, type ScaffoldOptions, type ScaffoldResult, type Template, isNpmSafeName, scaffold, scaffoldExample, scaffoldMcp };

package/dist/index.js

@@ -1,10 +1,12 @@
 import {
   isNpmSafeName,
   scaffold,
+  scaffoldExample,
   scaffoldMcp
-} from "./chunk-JD4RAKEG.js";
+} from "./chunk-5V2IFXD4.js";
 export {
   isNpmSafeName,
   scaffold,
+  scaffoldExample,
   scaffoldMcp
 };

package/dist/templates/{openai-agents-sdk → agentic-app/claude-agent-sdk}/AGENTS.md

@@ -4,7 +4,7 @@ You (the coding agent) are extending a guuey agentic app. Before you reach
 for a database or a cache, read this file. The single most common mistake
 here is standing up local Redis/SQLite/file-based state "just to get
 something working" — **don't.** Every pod this project deploys to
-(`src/worker.ts`'s agent pod — including every `kind: colocated` `mcps/*`
+(the agent entry's pod — `src/worker.ts`, or `src/agent.ts` in a google-adk scaffold — including every `kind: colocated` `mcps/*`
 server auto-spawned inside it, like this scaffold's `mcps/todo` — and every
 `mcps/*` server deployed with `kind: hosted`) is **ephemeral and horizontally
 replaced**: gVisor-isolated,
@@ -19,7 +19,7 @@ Use this table to route persistence decisions. Pick a row, don't invent one.
 | Small per-user state on an MCP server (idempotency keys, rate-limit counters, OAuth nonces, prefs, a few KB) | [`@guuey/state`](https://www.npmjs.com/package/@guuey/state) — `withGuueyContext(scopeFromAuthorization(...), fn)`                                                                                                                                                                                                                                                     | Zero auth code — guuey owns the identity rails. Durable, per-`(user, mcp)`, survives pod restarts.                                                                                                                                                                                                                                      |
 | Large or relational data (rows, queries, joins, anything you'd reach for Postgres/Redis for)                 | An external managed serverless DB — Neon, Upstash, Supabase, or Turso — wired in via `guuey mcp secrets set DATABASE_URL=... --server <id>` (hosted MCP) or `guuey env set DATABASE_URL=...` (the agent worker and its colocated MCP children — the pod's declared env/secrets are handed to every colocated child), consumed through the provider's serverless driver | Guuey **integrates, never operates** databases — that's the platform's hosting policy, not a v1 gap. Pick the provider's **`us-east-1`** region: a guuey-hosted MCP → provider hop is then same-region AWS backbone, single-digit-ms — comparable to a cross-AZ hop, and agent turns are already dominated by seconds of LLM inference. |
 | Local Redis, SQLite, or any file written as a database                                                       | **Never.** Not for v1, not "temporarily."                                                                                                                                                                                                                                                                                                                              | Pods are ephemeral and horizontally replaced — a local store vanishes on the next deploy, restart, or scale event, with no warning to you or the user.                                                                                                                                                                                  |
-| Per-user files/blobs from **inside the agent pod** (`src/worker.ts`)                                         | [`@guuey/fs`](https://www.npmjs.com/package/@guuey/fs)'s `homeDir()`/`appDir()`/`sessionDir()`, or the raw `$GUUEY_HOME_DIR`/`$GUUEY_APP_DIR` env vars + `node:fs`                                                                                                                                                                                                     | Every invoke already gets these three bound directories — `$GUUEY_HOME_DIR` is durable per-user, `$GUUEY_APP_DIR` is read-only shared, cwd is session scratch. No wrapper API required, but the helpers save you the env-var lookups.                                                                                                   |
+| Per-user files/blobs from **inside the agent pod** (the agent entry)                                         | [`@guuey/fs`](https://www.npmjs.com/package/@guuey/fs)'s `homeDir()`/`appDir()`/`sessionDir()`, or the raw `$GUUEY_HOME_DIR`/`$GUUEY_APP_DIR` env vars + `node:fs`                                                                                                                                                                                                     | Every invoke already gets these three bound directories — `$GUUEY_HOME_DIR` is durable per-user, `$GUUEY_APP_DIR` is read-only shared, cwd is session scratch. No wrapper API required, but the helpers save you the env-var lookups.                                                                                                   |
 | Per-user files/blobs from **inside an MCP server** (`mcps/*`)                                                | Not yet available — `@guuey/files` is planned but not shipped. Fall back to the managed-DB row above (e.g. store blobs in the provider's object storage) until it lands.                                                                                                                                                                                               | Don't build against an API that doesn't exist yet.                                                                                                                                                                                                                                                                                      |
 | Conversation / chat history                                                                                  | **Do not re-implement.** The platform already persists it.                                                                                                                                                                                                                                                                                                             | Guuey writes thread history to DynamoDB and streams it back over AppSync; agents that keep their own transcript store are duplicating (and diverging from) data the platform already owns.                                                                                                                                              |
 

package/dist/templates/{openai-agents-sdk → agentic-app/claude-agent-sdk}/README.md

@@ -18,9 +18,15 @@ locally with one command, and deployable to guuey with one more.
 ├── ggui/                # ggui.json + blueprints/ + themes/ — generative-UI config.
 │                         #   `ggui serve` runs against this locally; it's pushed to your
 │                         #   deployed app's guuey-managed ggui instance on `guuey deploy`.
-├── web/                 # a small Vite SPA chat client — the local dev surface, and a
-│                         #   worked example of the bring-your-own-frontend path
+├── web/                 # the product frontend (Vite + React on @guuey/chat):
+│                         #   landing (widget) · login (guest + BYO-OIDC seam) · home
+│                         #   (status + distribution guide) · the chat surface
+├── guuey.app.json       # frontend/brand config — written by `pnpm bootstrap`
+│                         #   (schema: guuey.app.schema.json; public-safe by design)
+├── AGENTS.md            # coding-agent steering; `pnpm bootstrap` maintains the
+│                         #   managed block with this project's real facts
 ├── scripts/dev.mjs      # `pnpm dev` orchestrator — boots the whole local stack
+├── scripts/bootstrap.mjs # `pnpm bootstrap` — configure, then `-- --link` to bind
 ├── .env.example          # ANTHROPIC_API_KEY / OPENAI_API_KEY for local dev
 └── .mcp.json             # Claude Code convenience wiring (mcp.ggui.ai/dev)
 ```
@@ -33,11 +39,19 @@ level rather than nested under a `servers/` or `apps/` folder.
 
 ```bash
 pnpm install
+pnpm bootstrap               # brand, theme, copy → guuey.app.json + AGENTS.md (no account needed;
+                             #   every web page is gated on this, and production builds fail without it)
 cp .env.example .env.local   # done automatically on scaffold if .env.local is absent
 # set ANTHROPIC_API_KEY (or OPENAI_API_KEY, for the openai-agents-sdk template) in .env.local
 pnpm dev
 ```
 
+When the agent is deployed (`guuey login && guuey deploy`), bind it into the
+frontend: `pnpm bootstrap -- --link` — that records the app id, endpoint,
+widget origin and portal link in `guuey.app.json` and pushes brand basics to
+the platform. `pnpm status` shows the live app state; `pnpm bootstrap -- --check`
+prints machine-readable configuration state.
+
 `pnpm dev` (`scripts/dev.mjs`) boots four processes with prefixed, interleaved
 logs. Ctrl-C tears all of them down together.
 
@@ -46,7 +60,7 @@ logs. Ctrl-C tears all of them down together.
 | `worker`     | —     | `tsup --watch` — rebuilds `guuey.worker.js` on every save                                                                                  |
 | `guuey dev`  | :6790 | local router: spawns your worker per turn, streams SSE; auto-spawns every `colocated` MCP entry — `mcps/todo` lands on its `devPort` :6782 |
 | `ggui serve` | :6781 | local generative-UI server, over `ggui/`                                                                                                   |
-| `web`        | :6890 | the Vite chat SPA                                                                                                                          |
+| `web`        | :6890 | the product frontend (landing/login/home/chat on @guuey/chat)                                                                              |
 
 The todo MCP still answers on :6782 — it's just a supervised child of
 `guuey dev` now (copy `mcps/todo/` to add your own server; new `colocated`

package/dist/templates/agentic-app/claude-agent-sdk/gitignore

@@ -0,0 +1,5 @@
+node_modules/
+dist/
+.env.local
+guuey.worker.js
+.guuey-dev/

package/dist/templates/agentic-app/claude-agent-sdk/guuey.app.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "./guuey.app.schema.json",
+  "schema": 1,
+  "bootstrapped": false,
+  "brand": {
+    "name": "agentic-app-template",
+    "tagline": "An agentic app built on guuey",
+    "logoText": "AA"
+  },
+  "theme": {
+    "accent": "#6c5ce7",
+    "mode": "light"
+  },
+  "copy": {
+    "landing": {
+      "headline": "Ask anything.",
+      "sub": "This site has an agent. Open the chat, or use the launcher in the corner."
+    },
+    "login": {
+      "guestHint": "One click, no account — this browser gets its own private thread the agent remembers."
+    }
+  },
+  "auth": {
+    "oidc": null
+  },
+  "link": null,
+  "demoMode": false
+}

package/dist/templates/agentic-app/claude-agent-sdk/guuey.app.schema.json

@@ -0,0 +1,119 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "guuey.app.json",
+  "description": "App-level configuration for this guuey agentic app. Written by `pnpm bootstrap`; safe to hand-edit. Public-safe by construction: nothing in this file is a secret (the appId ships in page HTML by design).",
+  "type": "object",
+  "required": ["schema", "bootstrapped", "brand", "theme", "copy", "auth", "link", "demoMode"],
+  "additionalProperties": false,
+  "properties": {
+    "$schema": { "type": "string" },
+    "schema": { "const": 1 },
+    "bootstrapped": {
+      "type": "boolean",
+      "description": "Flipped true by `pnpm bootstrap`. Dev renders a setup screen until then; production builds fail."
+    },
+    "brand": {
+      "type": "object",
+      "required": ["name", "tagline", "logoText"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "tagline": { "type": "string" },
+        "logoText": {
+          "type": "string",
+          "maxLength": 4,
+          "description": "1-4 characters shown in the square brand mark."
+        }
+      }
+    },
+    "theme": {
+      "type": "object",
+      "required": ["accent", "mode"],
+      "additionalProperties": false,
+      "properties": {
+        "accent": { "type": "string", "pattern": "^#[0-9a-fA-F]{6}$" },
+        "mode": { "enum": ["light", "dark"] }
+      }
+    },
+    "copy": {
+      "type": "object",
+      "required": ["landing", "login"],
+      "additionalProperties": false,
+      "properties": {
+        "landing": {
+          "type": "object",
+          "required": ["headline", "sub"],
+          "additionalProperties": false,
+          "properties": {
+            "headline": { "type": "string" },
+            "sub": { "type": "string" }
+          }
+        },
+        "login": {
+          "type": "object",
+          "required": ["guestHint"],
+          "additionalProperties": false,
+          "properties": {
+            "guestHint": { "type": "string" }
+          }
+        }
+      }
+    },
+    "auth": {
+      "type": "object",
+      "required": ["oidc"],
+      "additionalProperties": false,
+      "properties": {
+        "oidc": {
+          "description": "BYO-OIDC sign-in. null = guest-only. When set, the bound guuey app must be in BYO auth mode for the same issuer: `guuey apps update <appId> --auth-mode byo --issuer-url <issuer> --audience <clientId>`.",
+          "oneOf": [
+            { "type": "null" },
+            {
+              "type": "object",
+              "required": ["issuer", "clientId"],
+              "additionalProperties": false,
+              "properties": {
+                "issuer": { "type": "string", "format": "uri" },
+                "clientId": { "type": "string", "minLength": 1 }
+              }
+            }
+          ]
+        }
+      }
+    },
+    "link": {
+      "description": "The bound guuey app. null until `pnpm bootstrap -- --link`. Every value here is read back from the platform, never derived by hand.",
+      "oneOf": [
+        { "type": "null" },
+        {
+          "type": "object",
+          "required": [
+            "appId",
+            "env",
+            "apiBaseUrl",
+            "endpointUrl",
+            "widgetOrigin",
+            "portalUrl",
+            "slug",
+            "pageUrl"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "appId": { "type": "string", "minLength": 1 },
+            "env": { "enum": ["dev", "staging", "release"] },
+            "apiBaseUrl": { "type": "string", "format": "uri" },
+            "endpointUrl": { "type": "string", "format": "uri" },
+            "widgetOrigin": { "type": "string", "format": "uri" },
+            "portalUrl": { "type": "string", "format": "uri" },
+            "slug": { "oneOf": [{ "type": "string" }, { "type": "null" }] },
+            "pageUrl": { "oneOf": [{ "type": "string", "format": "uri" }, { "type": "null" }] }
+          }
+        }
+      ]
+    },
+    "demoMode": {
+      "type": "boolean",
+      "description": "Renders the demo chrome (banner + fictional-product honesty strip). Off in every customer clone."
+    }
+  }
+}

package/dist/templates/{claude-agent-sdk → agentic-app/claude-agent-sdk}/package.json

@@ -5,16 +5,19 @@
   "type": "module",
   "scripts": {
     "dev": "node scripts/dev.mjs",
+    "bootstrap": "node scripts/bootstrap.mjs",
+    "status": "guuey apps get && guuey agent status",
     "build": "tsup",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "^0.3.199",
-    "@guuey/config": "0.8.1",
-    "@guuey/worker": "0.8.1"
+    "@guuey/config": "0.10.0",
+    "@guuey/worker": "0.10.0"
   },
   "devDependencies": {
-    "@guuey/cli": "0.8.1",
+    "@ggui-ai/cli": "0.6.3",
+    "@guuey/cli": "0.10.0",
     "tsup": "^8.5.0",
     "tsx": "^4.19.0",
     "typescript": "^5.8.0"