@guuey/config 0.1.0

package/dist/schema.js

@@ -0,0 +1,125 @@
+/**
+ * `guuey.json` v1 — the merged platform config.
+ *
+ * Single source of truth for a guuey-deployed project. Composed of:
+ *
+ * - `agent` (required for agent deploys) — declarative runtime + deploy config
+ * - `app`   (optional) — App Store / Portal listing metadata
+ * - `ggui`  (optional) — cross-protocol integration if the agent uses ggui rendering
+ *
+ * Plus top-level platform identity (`appId`, `workspaceId`) populated by
+ * the CLI after `guuey create` / `guuey link`.
+ *
+ * **Filename convention** (filename = artifact kind, see design doc §3):
+ * ```
+ * guuey.json       ← agent deploy (this file's schema)
+ * guuey.mcp.json   ← MCP server deploy (separate schema — see guuey-mcp.ts when added)
+ * ```
+ *
+ * **History.** Pre-2026-05-25 the repo carried two separate files:
+ *   - `agent.json` — runtime contract (slice 2.0)
+ *   - `guuey.json` — hosted overlay (project, deploy, deployments, mcpProxies, mcpServers)
+ *
+ * Slice 7.2 (2026-05-25) merged them per platform-architecture design doc §3.1
+ * + §14.2 field-by-field migration table. Pre-launch no-backcompat rule —
+ * the old shape is GONE, not deprecated.
+ *
+ * **Minimum valid `guuey.json`** (every other field defaults):
+ *
+ * ```jsonc
+ * {
+ *   "schema": "1",
+ *   "agent": {
+ *     "framework": "claude-agent-sdk",
+ *     "model": "claude-sonnet-4-6",
+ *     "systemPrompt": { "file": "prompts/system.md" }
+ *   }
+ * }
+ * ```
+ */
+import { z } from 'zod';
+import { AgentSectionV1 } from './agent.js';
+import { AppSectionV1 } from './app.js';
+import { GguiSectionV1 } from './ggui.js';
+/**
+ * Top-level guuey.json v1 schema.
+ *
+ * `agent` is required — there's no "empty" guuey.json. A repo that hosts
+ * only an MCP server uses `guuey.mcp.json` instead (separate schema).
+ *
+ * `appId` and `workspaceId` are platform-resolved identifiers stamped by
+ * the CLI after `guuey create` / `guuey link`. A fresh project has neither.
+ * After first `guuey create`, both may be present.
+ *
+ * Re-exports the sub-section types for consumer convenience.
+ */
+export const GuueyJsonV1 = z.strictObject({
+    schema: z.literal('1'),
+    /** Stable agent identifier minted by the control plane on first `guuey create`. */
+    appId: z.string().min(1).max(128).optional(),
+    /** Workspace the project lives under. Optional — personal apps + freshly-linked apps. */
+    workspaceId: z.string().min(1).max(128).optional(),
+    /** The deployable agent definition + deploy config. */
+    agent: AgentSectionV1,
+    /** App Store / Portal listing metadata. Optional. */
+    app: AppSectionV1.optional(),
+    /** Cross-protocol integration (ggui.ai rendering). Optional. */
+    ggui: GguiSectionV1.optional(),
+    /**
+     * Worker entry override — path to the built worker bundle, relative to the
+     * project root. Absence means the default build output, `guuey.worker.js`.
+     *
+     * This is the template-authored escape hatch `guuey dev` (`commands/
+     * dev.ts`) and `guuey deploy` (`commands/deploy.ts`) resolve for a
+     * non-default build output path; without this field in the schema the
+     * strict parse rejected any document that used it, contradicting both
+     * consumers' documented contract.
+     */
+    worker: z.string().min(1).optional(),
+    /**
+     * Transport selector — which AgJSON protocol leg the pod uses when
+     * streaming responses to the client.
+     *
+     * - `'silver'` (default) — SilverProtocol / AgJSON streaming (native guuey).
+     * - `'bypass'` — raw pass-through; the agent pod writes directly to the SSE
+     *   stream without AgJSON framing. Useful for agents that produce their own
+     *   structured output or during protocol migration.
+     *
+     * No `'ag-ui'` value — AgJSON has no AG-UI output leg.
+     */
+    protocol: z.enum(['silver', 'bypass']).default('silver'),
+    /**
+     * Platform runtime pin — lets a code-mode agent declare which Guuey Router
+     * version its worker is built against. Absence means v1 (the default and
+     * currently only supported version).
+     */
+    runtime: z.strictObject({
+        /** Guuey Router version this agent's worker is built against. */
+        router: z.enum(['v1']).default('v1'),
+    }).optional(),
+});
+/**
+ * Canonical filename — always at the project root, always this name.
+ * Exported so tooling uses the same constant instead of hard-coding.
+ */
+export const GUUEY_JSON_FILENAME = 'guuey.json';
+/**
+ * Parse a raw JSON value into a validated {@link GuueyJsonV1}.
+ * Throws a `ZodError` with human-readable issues on invalid input.
+ *
+ * Callers must have already JSON-decoded the source. Does NOT resolve
+ * `agent.systemPrompt.file` references — that's the loader's job (see
+ * `./loader.ts#loadGuueyJson`). Pure parse is safe to run anywhere;
+ * file resolution requires a base directory and is Node-only.
+ */
+export function parseGuueyJson(raw) {
+    return GuueyJsonV1.parse(raw);
+}
+/**
+ * Safe-parse variant — returns a discriminated `z.safeParse` result.
+ * Prefer this inside CLI tooling where you want to render the issue
+ * list without try/catch.
+ */
+export function safeParseGuueyJson(raw) {
+    return GuueyJsonV1.safeParse(raw);
+}

package/dist/system-prompt.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Default system prompt baked into every guuey-hosted agent that doesn't
+ * supply its own in `agent.json#systemPrompt`. Generic agent posture only —
+ * ggui-specific behavior is taught by the MCP server's `InitializeResult.instructions`
+ * field on handshake (lives at `mcp.ggui.ai`, not in guuey).
+ *
+ * When a customer's `agent.json` overrides this, the override wins. When the
+ * default MCP server (`mcp.ggui.ai`) is swapped for a different one, this
+ * prompt still applies and the new server teaches its own conventions on
+ * handshake.
+ */
+export declare const GUUEY_DEFAULT_SYSTEM_PROMPT: string;
+//# sourceMappingURL=system-prompt.d.ts.map

package/dist/system-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../src/system-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,2BAA2B,QAOhC,CAAC"}

package/dist/system-prompt.js

@@ -0,0 +1,19 @@
+/**
+ * Default system prompt baked into every guuey-hosted agent that doesn't
+ * supply its own in `agent.json#systemPrompt`. Generic agent posture only —
+ * ggui-specific behavior is taught by the MCP server's `InitializeResult.instructions`
+ * field on handshake (lives at `mcp.ggui.ai`, not in guuey).
+ *
+ * When a customer's `agent.json` overrides this, the override wins. When the
+ * default MCP server (`mcp.ggui.ai`) is swapped for a different one, this
+ * prompt still applies and the new server teaches its own conventions on
+ * handshake.
+ */
+export const GUUEY_DEFAULT_SYSTEM_PROMPT = `
+You are a helpful agent hosted on guuey.com. Conversation is shown to the
+user as a chat. When you have MCP tools available, prefer calling them over
+describing what you would do — tools are how you take action in the user's
+environment. Follow each tool's own description for guidance on when and how
+to use it. Maintain the thread of conversation across turns and ask
+clarifying questions when intent is ambiguous.
+`.trim();

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@guuey/config",
+  "version": "0.1.0",
+  "description": "Open-source schemas + loaders for the three guuey config files: agent.json (declarative agent definition), guuey.json (hosted-deploy overlay), and the helper types around them. Consumed by @guuey/cli, the guuey backend, and devs writing their own agent or MCP server.",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^3.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "guuey",
+    "agent",
+    "mcp",
+    "config",
+    "schema",
+    "zod"
+  ],
+  "homepage": "https://guuey.com",
+  "bugs": {
+    "url": "https://github.com/loqu-co/guuey/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/withguuey/guuey-sdks.git",
+    "directory": "packages/config"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}