@guuey/create-agentic-app 0.8.1 → 0.10.0

package/dist/templates/base/openai-agents-sdk/README.md

@@ -0,0 +1,171 @@
+# agentic-app-template
+
+A guuey agentic app: a code-mode agent, a custom MCP server you can copy to
+add your own tools, and a `ggui` config for generative UI — all runnable
+locally with one command, and deployable to guuey with one more.
+
+## What got scaffolded
+
+```
+.
+├── guuey.json          # the deploy contract: agent framework/model, system prompt,
+│                        #   mcpServers (name → colocated source + devPort), ggui config
+├── package.json         # agent deps + the pnpm workspace root (workspaces: mcps/*, web)
+├── src/worker.ts        # your agent code (code-mode worker); build emits ./guuey.worker.js
+├── prompts/system.md    # system prompt, referenced from guuey.json#agent.systemPrompt.file
+├── mcps/todo/           # the "copy-me" custom MCP server — @modelcontextprotocol/sdk,
+│                         #   Streamable HTTP, in-memory todo list, port :6782
+├── 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/                 # 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)
+```
+
+The project root **is** the agent package — `guuey deploy` packs this directory
+directly as the deploy tarball, so `guuey.json` and `src/worker.ts` live at the top
+level rather than nested under a `servers/` or `apps/` folder.
+
+## Quick start
+
+```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.
+
+| process      | port  | what                                                                                                                                       |
+| ------------ | ----- | ------------------------------------------------------------------------------------------------------------------------------------------ |
+| `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 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`
+entries in `guuey.json` are auto-spawned the same way).
+
+> **If a server's deps carry build scripts** (the classic: `tsx` → esbuild's
+> platform-binary fetch), pnpm ≥11 refuses to run them on a fresh install —
+> `ERR_PNPM_IGNORED_BUILDS` — and the server never boots. Approve the
+> specific packages declaratively in the workspace-root `package.json` (or
+> the server's own, for a standalone install):
+> `"pnpm": { "onlyBuiltDependencies": ["esbuild"] }`. This scaffold ships
+> the approval already; add to the list when a new dep needs its build step.
+> Don't disable the gate wholesale — it's pnpm's supply-chain protection.
+
+Open http://localhost:6890 to chat with your agent locally.
+
+## Local dev vs. deployed — what's different
+
+`guuey dev` is the open, local equivalent of the pod router that runs your
+worker in production. It mirrors the real spawn/stream contract closely — the
+same normalizer, the same SSE shape — but it deliberately cuts three corners:
+two that only matter once real users and real money are involved, and one
+you should read twice:
+
+- **No sandboxing — read this one twice.** Locally your worker runs as a
+  plain child process: no `bwrap`/gVisor isolation on any platform, it
+  inherits your **full shell environment** (every variable, including
+  credentials unrelated to this agent), and when filesystem layers are
+  bound the host grants the agent shell and file tools **without
+  prompting** (the production jail those tools assume does not exist
+  locally). Net: `guuey dev` runs an LLM-driven agent with unprompted
+  shell access as you, with your env. That's a deliberate dev-trust
+  posture, not an accident — treat the agent like any script you'd run
+  from the internet: run `guuey dev` in a throwaway shell/container with
+  a minimal environment if your agent (or any MCP server it talks to)
+  handles untrusted input. In production every invocation runs inside a
+  gVisor-isolated pod with only its declared environment.
+- **Permissive auth.** `ggui serve --dev-allow-all` accepts any bearer
+  locally. The deployed ggui instance enforces real auth.
+- **No metering or history.** Local runs aren't billed and aren't persisted.
+  Deployed conversations are metered and their history is written to
+  DynamoDB so users can resume a thread.
+
+None of this changes your code — `guuey.json` is the same file in both
+worlds; only how it's resolved differs. Locally, `guuey dev` auto-spawns each
+`colocated` entry on its `devPort` and points the agent at
+`localhost:<devPort>`; deployed, the same server code runs as a supervised
+child inside your agent's pod, reached over the pod's loopback with a
+per-request federated identity. (`hosted` entries deploy to the platform's
+federated URLs; locally they need a `devPort` pointing at a server you run
+yourself, or they're skipped with a warning.)
+
+## Deploying
+
+```bash
+guuey login    # device-flow auth; stores a token in ~/.guuey/auth.json
+guuey deploy   # ships everything
+```
+
+`guuey deploy` runs four legs, in order, so a hard failure aborts before
+anything user-visible changes:
+
+1. **MCP leg** — deploys each `hosted` entry under `guuey.json#agent.mcpServers`
+   as its own hosted MCP server (build → deploy → registry), then writes the
+   resulting server id back into `guuey.json`. This scaffold has none — the
+   todo MCP is `colocated`, so this leg is a no-op here.
+2. **ggui asset leg** — pushes `ggui/` (ggui.json, blueprints, themes) to your
+   app's guuey-managed ggui instance.
+3. **Agent leg** — builds `src/worker.ts` into `guuey.worker.js`, packs the
+   project root (including `mcps/`), and deploys it as a gVisor-isolated,
+   scale-to-zero pod. Each `colocated` entry (e.g. `mcps/todo`) is built into
+   the worker image and auto-spawned as a supervised, sandboxed child at pod
+   boot — no separate server, registry row, or write-back.
+4. **Output** — prints your agent's endpoint URL and a Portal deep link.
+
+Re-running `guuey deploy` converges: unchanged pieces are skipped or reused,
+nothing is duplicated.
+
+## Filesystem + memory
+
+Every deployed invoke gets three bound directories — `$GUUEY_HOME_DIR`
+(durable, per-user), `$GUUEY_APP_DIR` (read-only, shared), and cwd (session
+scratch) — plain `node:fs`, no wrapper API required. Signed-in users get
+durable cross-session memory for free (a platform-owned prompt tells the
+model to read/write `$GUUEY_HOME_DIR/memories/MEMORY.md`); guests never get
+durable storage, by design. **This recall is `claude-agent-sdk`-only today**
+— openai-agents-sdk and google-adk agents get the three bound directories
+but not the automatic memory-file recall; all-framework support arrives
+with guuey's own memory MCP (a platform tool every framework can call over
+its existing MCP channel). Framework-native memory backends (e.g. ADK's
+Vertex MemoryBank) are unsupported on Guuey — they'd store user data
+outside guuey's deletion boundary. Full contract, code examples, and
+rollout status: the "Your agent's filesystem" section of the guuey
+monorepo's `docs/quickstart.md`, or
+[`@guuey/fs`](https://www.npmjs.com/package/@guuey/fs)'s own README — an
+optional, three-helper sugar layer over the same paths.
+
+## How people talk to your agent
+
+- **guuey Portal** — a Telegram-like agent App Store and universal chat
+  client. Once deployed, your agent is reachable from Portal with **zero
+  frontend code** — most builders never need to touch `web/` at all.
+- **`web/`** — ships anyway, because the local dev loop needs a chat surface,
+  and it's a worked example of the bring-your-own-frontend path if you want
+  to embed your agent somewhere Portal doesn't reach.
+- **Future: guuey widgets** — an embeddable web-chat widget for dropping
+  your agent into an existing site is planned as a separate feature; `web/`
+  is designed to make that graduation straightforward when it lands.

package/dist/templates/base/openai-agents-sdk/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/base/openai-agents-sdk/gitignore

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

package/dist/templates/base/openai-agents-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/base/openai-agents-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/base/openai-agents-sdk/guuey.json

@@ -0,0 +1,27 @@
+{
+  "schema": "1",
+  "worker": "worker.js",
+  "agent": {
+    "mode": "code",
+    "framework": "openai-agents-sdk",
+    "model": "gpt-5.6-terra",
+    "systemPrompt": {
+      "file": "prompts/system.md"
+    },
+    "mcpServers": {
+      "todo": {
+        "kind": "colocated",
+        "source": "./mcps/todo",
+        "devPort": 6782
+      },
+      "ggui": {
+        "kind": "external",
+        "url": "https://mcp.ggui.ai",
+        "transport": "http"
+      }
+    }
+  },
+  "ggui": {
+    "configFile": "./ggui/ggui.json"
+  }
+}

package/dist/templates/base/openai-agents-sdk/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/base/openai-agents-sdk/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",
+    "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/base/openai-agents-sdk/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/base/openai-agents-sdk/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/base/openai-agents-sdk/mcps/todo/tsup.config.ts

@@ -0,0 +1,14 @@
+import { defineConfig } from 'tsup';
+
+// Self-contained ON PURPOSE — do not delete this file. Without a local
+// config, tsup's upward config discovery finds the scaffold ROOT
+// tsup.config.ts; its bundled form imports 'tsup' from the scaffold root,
+// which the platform image build deliberately leaves un-installed when the
+// bundled guuey.worker.js skips the root install — every colocated build
+// then dies with ERR_MODULE_NOT_FOUND (guuey#19). A config here stops the
+// walk; `defineConfig` resolves from this package's own devDependencies.
+export default defineConfig({
+  entry: ['src/server.ts'],
+  format: 'esm',
+  outDir: 'dist',
+});