@guuey/create-agentic-app 0.1.1 → 0.1.2

package/dist/cli.cjs

@@ -171,7 +171,7 @@ var packageRoot2 = (0, import_node_path2.join)(here2, "..");
 var defaultTemplatesDir2 = (0, import_node_path2.join)(packageRoot2, "dist", "templates");
 
 // src/cli.ts
-var FRAMEWORKS = ["claude-agent-sdk", "openai-agents-sdk"];
+var FRAMEWORKS = ["claude-agent-sdk", "openai-agents-sdk", "google-adk"];
 function isFramework(value) {
   return FRAMEWORKS.includes(value);
 }

package/dist/cli.js

@@ -6,7 +6,7 @@ import {
 // src/cli.ts
 import { createInterface } from "readline/promises";
 import { stdin, stdout } from "process";
-var FRAMEWORKS = ["claude-agent-sdk", "openai-agents-sdk"];
+var FRAMEWORKS = ["claude-agent-sdk", "openai-agents-sdk", "google-adk"];
 function isFramework(value) {
   return FRAMEWORKS.includes(value);
 }

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 /** Frameworks the scaffolder ships templates for. */
-type Framework = 'claude-agent-sdk' | 'openai-agents-sdk';
+type Framework = 'claude-agent-sdk' | 'openai-agents-sdk' | 'google-adk';
 interface ScaffoldOptions {
     /** Absolute or cwd-relative path to create/populate the new project in. */
     targetDir: string;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /** Frameworks the scaffolder ships templates for. */
-type Framework = 'claude-agent-sdk' | 'openai-agents-sdk';
+type Framework = 'claude-agent-sdk' | 'openai-agents-sdk' | 'google-adk';
 interface ScaffoldOptions {
     /** Absolute or cwd-relative path to create/populate the new project in. */
     targetDir: string;

package/dist/templates/claude-agent-sdk/package.json

@@ -10,11 +10,11 @@
   },
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "^0.3.199",
-    "@guuey/config": "0.0.1",
-    "@guuey/worker": "0.0.1"
+    "@guuey/config": "0.1.1",
+    "@guuey/worker": "0.1.1"
   },
   "devDependencies": {
-    "@guuey/cli": "0.0.1",
+    "@guuey/cli": "0.1.2",
     "tsup": "^8.5.0",
     "tsx": "^4.19.0",
     "typescript": "^5.8.0"

package/dist/templates/claude-agent-sdk/web/package.json

@@ -10,7 +10,7 @@
   },
   "dependencies": {
     "@mcp-ui/client": "^7.1.1",
-    "@silverprotocol/core": "0.1.0",
+    "@silverprotocol/core": "0.3.2",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },

package/dist/templates/google-adk/.env.example

@@ -0,0 +1,4 @@
+# LLM key for local dev — the deployed agent uses guuey's managed broker instead.
+ANTHROPIC_API_KEY=
+# Only needed for the openai-agents-sdk template:
+OPENAI_API_KEY=

package/dist/templates/google-adk/.mcp.json

@@ -0,0 +1 @@
+{ "mcpServers": { "ggui-dev": { "type": "http", "url": "https://mcp.ggui.ai/dev" } } }

package/dist/templates/google-adk/README.md

@@ -0,0 +1,74 @@
+# Your Google-ADK agent on Guuey
+
+You write **pure [Google ADK](https://google.github.io/adk-docs/) code** —
+`src/agent.ts` exports your agent, and Guuey runs it. There is no Guuey SDK
+to learn, no worker loop, no event plumbing: the platform injects the
+harness around your export, locally (`pnpm dev`) and in production
+(`guuey deploy`) identically.
+
+```ts
+import type { GuueyContext } from "@guuey/config";
+
+export default (guuey: GuueyContext<MCPToolset>) =>
+  new LlmAgent({
+    model: guuey.model,
+    instruction: guuey.instruction,
+    tools: [myTool, ...guuey.mcpToolsets],
+  });
+```
+
+## Quick start
+
+```bash
+pnpm install
+cp .env.example .env.local      # set GEMINI_API_KEY
+pnpm dev                        # local stack: your agent + the todo MCP + chat
+guuey deploy                    # same code, hosted
+```
+
+## The GuueyContext (everything the platform hands you)
+
+Your factory runs **once per turn** and receives:
+
+| field                                 | what it is                                                                                                                                        |
+| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `model`                               | resolved model id (from `guuey.json`, registry default otherwise)                                                                                 |
+| `instruction`                         | your system prompt **with the conversation preamble already prepended** — feed it to the agent and it is conversational with zero state code      |
+| `mcpToolsets`                         | ready-to-use ADK `MCPToolset`s for every server in `guuey.json#mcpServers` — credentials, URLs, and auth headers already resolved by the platform |
+| `user`                                | the end user this turn serves: `{ id, authMode }` — build multi-tenant behavior on `user.id`                                                      |
+| `files`                               | three storage tiers (absolute paths — see the state map below)                                                                                    |
+| `history` / `memory` / `workingState` | the raw conversation state, if you want to render context yourself instead of using `instruction`                                                 |
+
+## Where state lives (the three-tier map)
+
+| you want to…                                                     | use                                                                                                                            | persistence                                                                                                                                                         |
+| ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| save/read **files** from agent code or tools                     | `guuey.files.home` (per-USER durable) · `guuey.files.session` (per-session scratch) · `guuey.files.app` (read-only app assets) | `home` survives across sessions per user                                                                                                                            |
+| have the agent **remember the conversation**                     | nothing — `instruction` already carries history + thread memory + working state                                                | automatic (Guuey folds every turn)                                                                                                                                  |
+| store data from your **MCP server's tools** (e.g. the todo list) | `@guuey/state` KV inside the MCP server — scoped per `(user, server)`                                                          | **in-memory in the current release** (durable managed KV + console export/delete is on the roadmap) — persist anything you can't lose to `guuey.files.home` for now |
+
+Two honest notes:
+
+- **ADK-native session state does not persist across turns here.** Guuey
+  runs your agent with a fresh `InMemoryRunner` per turn (that's what makes
+  turns cheap and stateless); `session.state` / `outputKey` /
+  `DatabaseSessionService` won't carry data forward. Use the table above —
+  history and thread memory ARE the persistence, and they arrive
+  pre-rendered in `instruction`.
+- **Writing `workingState` for the next turn** is a platform feature in
+  flight; today the fold carries what the conversation itself establishes.
+
+## MCP servers
+
+`guuey.json#mcpServers` declares them; the platform connects them and hands
+you `guuey.mcpToolsets`. Locally, `pnpm dev` boots the colocated `mcps/todo`
+server on its `devPort`. Note: ADK speaks **Streamable HTTP** only — an
+`sse` transport server will be rejected with a clear error.
+
+## When you outgrow the factory
+
+If you need to own the turn loop itself (custom streaming, multiple agents
+per turn, your own protocol), graduate to a full worker: add a
+`guuey.worker.js` build via `@guuey/worker`'s `serveNative()` — see the
+Guuey docs. `agent.entry` and a full worker are mutually exclusive; the
+worker wins if both exist.

package/dist/templates/google-adk/ggui/ggui.json

@@ -0,0 +1,15 @@
+{
+  "schema": "1",
+  "protocol": "draft-2026-06-12",
+  "app": {
+    "slug": "agentic-app-template",
+    "name": "agentic-app-template"
+  },
+  "generation": {
+    "model": "anthropic:claude-haiku-4-5-20251001"
+  },
+  "theme": {
+    "preset": "indigo",
+    "mode": "dark"
+  }
+}

package/dist/templates/google-adk/guuey.json

@@ -0,0 +1,14 @@
+{
+  "schema": "1",
+  "agent": {
+    "mode": "code",
+    "framework": "google-adk",
+    "model": "gemini-3.5-flash",
+    "entry": "agent.js",
+    "systemPrompt": { "file": "prompts/system.md" },
+    "mcpServers": {
+      "todo": { "kind": "hosted", "source": "./mcps/todo", "devPort": 6782 }
+    }
+  },
+  "ggui": { "configFile": "./ggui/ggui.json" }
+}

package/dist/templates/google-adk/mcps/todo/Dockerfile

@@ -0,0 +1,46 @@
+# todo-mcp — guuey hosted MCP server image.
+#
+# Self-sufficient multi-stage build: `guuey mcp deploy` packs this directory
+# into a tarball and hands it straight to the builder with no external
+# pre-build step and no build args — this Dockerfile installs its own deps
+# and builds itself. (Different from guuey's own first-party MCP servers,
+# which use a "copy-prebuilt" pattern that expects `dist/` + `node_modules/`
+# to already exist before `docker build` runs — that pattern does not apply
+# to a standalone project like this one.)
+#
+# Build + run locally:
+#
+#   docker build -t todo-mcp .
+#   docker run -p 8080:8080 todo-mcp
+#   curl http://localhost:8080/health
+#
+# Deploy to guuey:
+#
+#   cd mcps/todo && guuey mcp deploy
+
+FROM node:22-slim AS build
+WORKDIR /app
+COPY package.json ./
+RUN npm install
+COPY tsconfig.json ./
+COPY src ./src
+RUN npm run build
+
+FROM node:22-slim
+WORKDIR /app
+ENV NODE_ENV=production
+# guuey's hosted-MCP runtime injects PORT=8080 and probes GET /health at that
+# port — this default matches so `docker run` alone also works.
+ENV PORT=8080
+
+COPY package.json ./
+RUN npm install --omit=dev
+COPY --from=build /app/dist ./dist
+
+USER node
+EXPOSE 8080
+
+HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 \
+  CMD node -e "fetch('http://localhost:' + (process.env.PORT || 8080) + '/health').then(r => { if (!r.ok) throw 1 }).catch(() => process.exit(1))"
+
+CMD ["node", "dist/server.js"]

package/dist/templates/google-adk/mcps/todo/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@agentic-app-template/todo-mcp",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "tsx src/server.ts",
+    "build": "tsup src/server.ts --format esm -d dist",
+    "start": "node dist/server.js",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.0",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.8.0"
+  }
+}

package/dist/templates/google-adk/mcps/todo/src/server.ts

@@ -0,0 +1,173 @@
+/**
+ * todo-mcp — the copy-me example MCP server for @agentic-app-template.
+ *
+ * A minimal, stateless Streamable HTTP MCP server: four tools over an
+ * in-memory todo list. Swap the `Map` for a real database when you outgrow
+ * a single replica; everything else (transport wiring, tool shape) stays
+ * the same.
+ *
+ * Transport pattern mirrors guuey's canonical hosted-MCP scaffold
+ * (`mcp-servers/_template` in the guuey monorepo): a fresh `McpServer` +
+ * `StreamableHTTPServerTransport` are created **per request** and torn down
+ * when the response closes. Stateless mode — the guuey proxy (and, locally,
+ * whatever MCP client you point at this server) handles sessions, so this
+ * server never keeps request state around between calls.
+ *
+ * Runtime contract when deployed via `guuey mcp deploy` (see mcps/todo's
+ * Dockerfile): the platform injects `PORT=8080` and probes `GET /health`
+ * for both liveness and readiness. Locally, `pnpm dev` runs this on
+ * `PORT=6782` (see ../../scripts/dev.mjs).
+ */
+import { createServer, type IncomingMessage, type ServerResponse } from "node:http";
+import { randomUUID } from "node:crypto";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { z } from "zod";
+
+interface Todo {
+  id: string;
+  title: string;
+  done: boolean;
+}
+
+const todos = new Map<string, Todo>();
+
+const todoShape = {
+  id: z.string(),
+  title: z.string(),
+  done: z.boolean(),
+};
+
+/** Wrap a structured result as both `structuredContent` and a text block. */
+function toolResult(data: Record<string, unknown>) {
+  return {
+    structuredContent: data,
+    content: [{ type: "text" as const, text: JSON.stringify(data) }],
+  };
+}
+
+function buildMcpServer(): McpServer {
+  const server = new McpServer({
+    name: "todo-mcp",
+    version: "0.0.0",
+    description: "Create, list, toggle, and delete todos.",
+  });
+
+  server.registerTool(
+    "todo_list",
+    {
+      title: "List todos",
+      description: "List every todo, in creation order.",
+      inputSchema: {},
+      outputSchema: { todos: z.array(z.object(todoShape)) },
+    },
+    async () => toolResult({ todos: [...todos.values()] }),
+  );
+
+  server.registerTool(
+    "todo_create",
+    {
+      title: "Create todo",
+      description: "Create a new todo item.",
+      inputSchema: { title: z.string().min(1).describe("Todo title.") },
+      outputSchema: todoShape,
+    },
+    async ({ title }) => {
+      const todo: Todo = { id: randomUUID(), title, done: false };
+      todos.set(todo.id, todo);
+      // Spread into a fresh object literal — `toolResult` takes
+      // `Record<string, unknown>`, and a named interface like `Todo` isn't
+      // structurally assignable to that without an (unwanted) index
+      // signature of its own; a fresh literal is.
+      return toolResult({ ...todo });
+    },
+  );
+
+  server.registerTool(
+    "todo_toggle",
+    {
+      title: "Toggle todo",
+      description: "Flip a todo's done state.",
+      inputSchema: { id: z.string().describe("Todo id.") },
+      outputSchema: todoShape,
+    },
+    async ({ id }) => {
+      const todo = todos.get(id);
+      if (!todo) throw new Error(`todo not found: ${id}`);
+      todo.done = !todo.done;
+      return toolResult({ ...todo }); // fresh literal — see the create() comment above
+    },
+  );
+
+  server.registerTool(
+    "todo_delete",
+    {
+      title: "Delete todo",
+      description: "Delete a todo by id.",
+      inputSchema: { id: z.string().describe("Todo id.") },
+      outputSchema: { id: z.string(), deleted: z.boolean() },
+    },
+    async ({ id }) => {
+      const deleted = todos.delete(id);
+      return toolResult({ id, deleted });
+    },
+  );
+
+  return server;
+}
+
+const PORT = Number(process.env.PORT ?? 6782);
+
+const httpServer = createServer(async (req: IncomingMessage, res: ServerResponse) => {
+  if (req.method === "GET" && req.url === "/health") {
+    res.writeHead(200, { "content-type": "application/json" });
+    res.end(JSON.stringify({ status: "ok", server: "todo-mcp", version: "0.0.0" }));
+    return;
+  }
+
+  if (req.url !== "/mcp") {
+    res.writeHead(404, { "content-type": "application/json" }).end(
+      JSON.stringify({ error: "not found" }),
+    );
+    return;
+  }
+
+  // Fresh server + transport per request (stateless mode) — see module doc.
+  const mcp = buildMcpServer();
+  const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
+
+  res.on("close", () => {
+    transport.close().catch(() => undefined);
+    mcp.close().catch(() => undefined);
+  });
+
+  try {
+    await mcp.connect(transport);
+    await transport.handleRequest(req, res);
+  } catch (err) {
+    console.error("mcp_handle_failed", err);
+    if (!res.headersSent) {
+      res.writeHead(500, { "content-type": "application/json" });
+      res.end(
+        JSON.stringify({
+          jsonrpc: "2.0",
+          error: { code: -32603, message: "Internal server error" },
+          id: null,
+        }),
+      );
+    }
+  }
+});
+
+httpServer.listen(PORT, () => {
+  console.log(`todo-mcp listening on :${PORT}`);
+});
+
+function shutdown(signal: string): void {
+  console.log(`${signal} received — shutting down`);
+  httpServer.close(() => process.exit(0));
+  // Force-exit if connections don't drain in time.
+  setTimeout(() => process.exit(1), 10_000).unref();
+}
+process.on("SIGTERM", () => shutdown("SIGTERM"));
+process.on("SIGINT", () => shutdown("SIGINT"));

package/dist/templates/google-adk/mcps/todo/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2023",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "outDir": "dist",
+    "rootDir": "src",
+    "resolveJsonModule": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/dist/templates/google-adk/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "agentic-app-template",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "node scripts/dev.mjs",
+    "build": "tsup",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@google/adk": "^1.3.0",
+    "zod": "^4.2.1"
+  },
+  "devDependencies": {
+    "@guuey/cli": "0.1.2",
+    "tsup": "^8.5.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.8.0",
+    "@guuey/config": "0.1.1"
+  }
+}

package/dist/templates/google-adk/pnpm-workspace.yaml

@@ -0,0 +1,34 @@
+packages:
+  - "mcps/*"
+  - "web"
+
+# pnpm 11 default `strictDepBuilds: true` blocks install scripts for any
+# dependency with a build script (esbuild's native binary fetch, sharp,
+# etc.) unless individually allowlisted, and fails the whole `install`
+# with ERR_PNPM_IGNORED_BUILDS otherwise. Scaffolded apps pull in build-
+# script deps transitively (tsup/vite -> esbuild, mcp/ui deps, etc.) that
+# we can't enumerate up front, so match pnpm 9/10 behavior here.
+strictDepBuilds: false
+
+# pnpm 11 default `verifyDepsBeforeRun: 'install'` re-verifies the
+# lockfile against supply-chain policies (including minimumReleaseAge)
+# before every `pnpm run <script>`, hitting the registry even for
+# already-installed deps. That check 404s for any dependency that only
+# exists as a local tarball (not yet published), which is expected
+# during local/dev/CI installs. Restore pnpm 9/10 behavior: only verify
+# on an explicit `pnpm install`.
+verifyDepsBeforeRun: false
+
+# See above — same registry-lookback problem hits a plain `pnpm install`
+# too when minimumReleaseAge is nonzero; disable it for scaffolded apps.
+minimumReleaseAge: 0
+
+# @google/adk declares five NON-optional @mikro-orm/* database-driver peer
+# dependencies (mariadb/mssql/mysql/postgresql/sqlite). Auto-installing
+# them drags in sqlite3 — a NATIVE module whose install script needs a
+# GitHub prebuild download or a full node-gyp toolchain, neither of which
+# exists in the platform's image build. None of the drivers is needed:
+# they back DatabaseSessionService, and Guuey runs the ADK with
+# InMemoryRunner (conversation state rides Guuey's own history/memory
+# fold). The unmet-peer warnings this produces are expected and harmless.
+autoInstallPeers: false

package/dist/templates/google-adk/prompts/system.md

@@ -0,0 +1,4 @@
+You are the agentic-app-template assistant. You have a todo tool server —
+use it to create, list, toggle, and delete the user's todos. When the ggui
+server is available, prefer rendering rich UI for lists and forms over
+plain text.

package/dist/templates/google-adk/scripts/dev.mjs

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+// pnpm dev — boots the whole local stack. Ctrl-C tears everything down.
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+
+const procs = [];
+function boot(name, command, args, opts = {}) {
+  const child = spawn(command, args, { stdio: ["ignore", "pipe", "pipe"], ...opts });
+  const prefix = `[${name}]`.padEnd(9);
+  child.stdout.on("data", (d) => process.stdout.write(String(d).replace(/^/gm, prefix)));
+  child.stderr.on("data", (d) => process.stderr.write(String(d).replace(/^/gm, prefix)));
+  child.on("exit", (code) => {
+    if (code !== 0 && !shuttingDown) shutdown(`${name} exited (${code})`, 1);
+  });
+  procs.push(child);
+}
+let shuttingDown = false;
+function shutdown(reason, code = 0) {
+  if (shuttingDown) return;
+  shuttingDown = true;
+  console.log(`\n${reason} — shutting down`);
+  for (const p of procs) p.kill("SIGTERM");
+  setTimeout(() => process.exit(code), 500);
+}
+process.on("SIGINT", () => shutdown("interrupted"));
+process.on("SIGTERM", () => shutdown("terminated"));
+
+if (!existsSync(".env.local"))
+  console.warn("hint: cp .env.example .env.local and set your LLM key");
+
+boot("worker", "pnpm", ["exec", "tsup", "--watch"]); // rebuilds guuey.worker.js on change
+boot("agent", "pnpm", ["exec", "guuey", "dev", "--serve", "--port", "6790"]);
+boot("todo", "pnpm", ["--filter", "@agentic-app-template/todo-mcp", "dev"], {
+  env: { ...process.env, PORT: "6782" },
+});
+boot("ggui", "pnpm", ["exec", "ggui", "serve", "--mcp-only", "--dev-allow-all", "--port", "6781"], {
+  cwd: "ggui",
+});
+boot("web", "pnpm", ["--filter", "@agentic-app-template/web", "dev"], {
+  env: { ...process.env, PORT: "6890" },
+});
+
+console.log("\n  agent  http://localhost:6790   todo-mcp http://localhost:6782");
+console.log("  ggui   http://localhost:6781   web      http://localhost:6890\n");

package/dist/templates/google-adk/src/agent.ts

@@ -0,0 +1,39 @@
+/**
+ * Your agent — pure Google-ADK code. No Guuey SDK, no harness, no event
+ * plumbing: export it and the platform runs it (locally via `pnpm dev`,
+ * hosted via `guuey deploy`).
+ *
+ * The default export is a FACTORY receiving everything Guuey resolved for
+ * the current turn (`GuueyContext`): the model + instruction from
+ * guuey.json, ready-to-use MCP toolsets for every server declared there,
+ * the end user's identity, file storage paths, and the conversation state.
+ * See the README for the full context tour.
+ */
+import { FunctionTool, LlmAgent, type MCPToolset } from "@google/adk";
+import { z } from "zod";
+import type { GuueyContext } from "@guuey/config";
+
+/** A plain ADK tool — everything the ADK offers works unchanged. */
+const rollDice = new FunctionTool({
+  name: "roll_dice",
+  description: "Roll an N-sided die and return the result.",
+  parameters: z.object({
+    sides: z.number().int().min(2).describe("number of faces on the die"),
+  }),
+  execute: async ({ sides }) => ({
+    result: 1 + Math.floor(Math.random() * sides),
+  }),
+});
+
+export default (guuey: GuueyContext<MCPToolset>) =>
+  new LlmAgent({
+    name: "my_agent",
+    model: guuey.model,
+    // `instruction` already carries your system prompt PLUS the conversation
+    // preamble (history, thread memory, working state) — your agent is
+    // conversational without writing any state code.
+    instruction: guuey.instruction,
+    // Your own tools compose with the MCP servers from guuey.json. Drop
+    // `...guuey.mcpToolsets` if you want a fully self-contained agent.
+    tools: [rollDice, ...guuey.mcpToolsets],
+  });

package/dist/templates/google-adk/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2023",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "noEmit": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist"]
+}

package/dist/templates/google-adk/tsup.config.ts

@@ -0,0 +1,13 @@
+import { defineConfig } from "tsup";
+
+export default defineConfig({
+  entry: { agent: "src/agent.ts" },
+  format: ["esm"],
+  outDir: ".",
+  clean: false,
+  // Dependencies stay EXTERNAL (tsup's default): the platform installs them
+  // from the lockfile at image-build time and the Guuey host imports your
+  // agent.js — with @google/adk resolved from YOUR node_modules (your pinned
+  // version wins). Do NOT bundle @google/adk; its dependency tree is not
+  // bundler-safe.
+});

package/dist/templates/google-adk/web/.env.example

@@ -0,0 +1,17 @@
+# Vite env for the web chat client. Copy to `web/.env.local` and UNCOMMENT
+# the vars you want to override. (Vite reads env files from this directory —
+# not the project root. Keep unused vars commented out: an empty
+# `VITE_X=` declaration loads as "" — not undefined.)
+
+# Agent base URL. Defaults to the local `guuey dev` router (:6790).
+# VITE_AGENT_ENDPOINT_URL=http://localhost:6790
+
+# Second-origin MCP-Apps sandbox page for @mcp-ui/client's <AppRenderer>.
+# The MCP Apps spec requires UI resources to mount from a DIFFERENT origin
+# than the app itself (double-iframe sandbox). In local dev this is served
+# automatically on http://127.0.0.1:6891/sandbox.html by the
+# sandboxProxyPlugin in vite.config.ts — leave unset. For a DEPLOYED build,
+# host ../sandbox-proxy.ts's sandbox page on its own origin and point this
+# at it; if unset in production, UI resources show a plain-text notice
+# instead of rendering.
+# VITE_SANDBOX_URL=https://sandbox.example.com/sandbox.html

package/dist/templates/google-adk/web/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>agentic-app-template</title>
+    <meta name="description" content="Local dev chat client for your guuey agent." />
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>