@guuey/config 0.1.0 → 0.1.2

package/dist/guuey-context.d.ts

@@ -0,0 +1,90 @@
+/**
+ * `GuueyContext` — everything the platform resolved for one turn, handed to a
+ * graceful-mode agent factory. THE import channel for graceful devs:
+ *
+ * ```ts
+ * import type { GuueyContext } from "@guuey/config";
+ * export default (guuey: GuueyContext) => new LlmAgent({
+ *   model: guuey.model,
+ *   // Function form — safe for every framework; required for ADK, which
+ *   // applies `{var}` substitution to a plain-string instruction.
+ *   instruction: () => guuey.instruction,
+ *   tools: [myTool, ...guuey.mcpToolsets],
+ * });
+ * ```
+ *
+ * Types-only and dependency-free by design (`@guuey/config` is already a
+ * template dependency; the host — which ASSEMBLES the context — is not). The
+ * tiny shapes below are structurally identical to `@guuey/worker`'s protocol
+ * types; duplicating them here keeps config free of a runtime package
+ * dependency for what is purely a type channel.
+ *
+ * The factory runs PER INVOKE (matching the per-invoke agent construction the
+ * platform host has always done), so per-turn surfaces — the user, this
+ * turn's state — are first-class, not bolted on.
+ */
+/** Router-vouched end-user identity for this turn (multi-tenant). */
+export interface GuueyContextUser {
+    id: string;
+    authMode: "anonymous" | "authenticated";
+}
+/**
+ * The three GuueyFS layer mounts (absolute paths):
+ *  - `app` — read-only app assets,
+ *  - `home` — per-USER durable storage,
+ *  - `session` — per-session scratch.
+ */
+export interface GuueyContextFiles {
+    app: string;
+    home: string;
+    session: string;
+}
+/** One prior message from the recent history window. */
+export interface GuueyContextMessage {
+    role: "user" | "agent";
+    text: string;
+}
+/** One thread-memory record folded from prior turns. */
+export interface GuueyContextMemoryRecord {
+    key?: string;
+    value: unknown;
+}
+/**
+ * The full per-turn platform context. `TToolset` is the framework's MCP
+ * toolset type (e.g. `MCPToolset` from `@google/adk`) — defaults to `unknown`
+ * so the type stays framework-neutral.
+ *
+ * History, memory, and working state are ALSO auto-injected into
+ * `instruction` as the standard context preamble — a factory that ignores
+ * them still yields a conversational agent. They appear here read-only so an
+ * advanced factory can do better than the default preamble.
+ */
+export interface GuueyContext<TToolset = unknown> {
+    /** Resolved model id (from guuey.json / registry default). */
+    model: string;
+    /**
+     * The system prompt WITH the standard context preamble (history, thread
+     * memory, working state) already prepended. Feed this to the agent unless
+     * you are rendering context yourself from the raw fields below.
+     */
+    instruction: string;
+    /** Ready-to-use MCP toolsets for every server declared in guuey.json. */
+    mcpToolsets: TToolset[];
+    /** The end user this turn serves. */
+    user: GuueyContextUser;
+    /** The three-tier file storage paths. */
+    files: GuueyContextFiles;
+    /** Recent conversation window (read side; auto-preambled). */
+    history: GuueyContextMessage[];
+    /** Thread memory records (read side; auto-preambled). */
+    memory: GuueyContextMemoryRecord[];
+    /** Prior working state carried from the previous turn (read side). */
+    workingState: unknown | undefined;
+}
+/**
+ * What a graceful agent module's default export may be: the framework-native
+ * agent object itself, or a factory receiving the {@link GuueyContext}.
+ * Factories may be async.
+ */
+export type GuueyAgentExport<TAgent = object, TToolset = unknown> = TAgent | ((guuey: GuueyContext<TToolset>) => TAgent | Promise<TAgent>);
+//# sourceMappingURL=guuey-context.d.ts.map

package/dist/guuey-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guuey-context.d.ts","sourceRoot":"","sources":["../src/guuey-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,qEAAqE;AACrE,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,WAAW,GAAG,eAAe,CAAC;CACzC;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wDAAwD;AACxD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wDAAwD;AACxD,MAAM,WAAW,wBAAwB;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,YAAY,CAAC,QAAQ,GAAG,OAAO;IAC9C,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,WAAW,EAAE,QAAQ,EAAE,CAAC;IACxB,qCAAqC;IACrC,IAAI,EAAE,gBAAgB,CAAC;IACvB,yCAAyC;IACzC,KAAK,EAAE,iBAAiB,CAAC;IACzB,8DAA8D;IAC9D,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,yDAAyD;IACzD,MAAM,EAAE,wBAAwB,EAAE,CAAC;IACnC,sEAAsE;IACtE,YAAY,EAAE,OAAO,GAAG,SAAS,CAAC;CACnC;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,CAAC,MAAM,GAAG,MAAM,EAAE,QAAQ,GAAG,OAAO,IAC5D,MAAM,GACN,CAAC,CAAC,KAAK,EAAE,YAAY,CAAC,QAAQ,CAAC,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC"}

package/dist/guuey-context.js

@@ -0,0 +1,26 @@
+/**
+ * `GuueyContext` — everything the platform resolved for one turn, handed to a
+ * graceful-mode agent factory. THE import channel for graceful devs:
+ *
+ * ```ts
+ * import type { GuueyContext } from "@guuey/config";
+ * export default (guuey: GuueyContext) => new LlmAgent({
+ *   model: guuey.model,
+ *   // Function form — safe for every framework; required for ADK, which
+ *   // applies `{var}` substitution to a plain-string instruction.
+ *   instruction: () => guuey.instruction,
+ *   tools: [myTool, ...guuey.mcpToolsets],
+ * });
+ * ```
+ *
+ * Types-only and dependency-free by design (`@guuey/config` is already a
+ * template dependency; the host — which ASSEMBLES the context — is not). The
+ * tiny shapes below are structurally identical to `@guuey/worker`'s protocol
+ * types; duplicating them here keeps config free of a runtime package
+ * dependency for what is purely a type channel.
+ *
+ * The factory runs PER INVOKE (matching the per-invoke agent construction the
+ * platform host has always done), so per-turn surfaces — the user, this
+ * turn's state — are first-class, not bolted on.
+ */
+export {};

package/dist/index.d.ts

@@ -12,10 +12,12 @@
  */
 export * from './schema.js';
 export * from './agent.js';
+export * from './colocated.js';
 export * from './app.js';
 export * from './ggui.js';
 export * from './loader.js';
 export * from './hosting.js';
 export * from './system-prompt.js';
 export * from './registry.js';
+export * from './guuey-context.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -12,9 +12,11 @@
  */
 export * from './schema.js';
 export * from './agent.js';
+export * from './colocated.js';
 export * from './app.js';
 export * from './ggui.js';
 export * from './loader.js';
 export * from './hosting.js';
 export * from './system-prompt.js';
 export * from './registry.js';
+export * from './guuey-context.js';

package/dist/registry.d.ts

@@ -18,6 +18,13 @@ export interface FrameworkEntry {
     readonly facetSupportedRange: string | null;
     readonly defaultProvider: "anthropic" | "openai" | "google";
 }
+/**
+ * Array order is picker order AFTER `modelsForProvider` floats the default to
+ * the front — the platform's app-behavior picker shows only `.slice(0, 2)` for
+ * google + openai, so the second array entry per provider is a product-visible
+ * choice, not incidental. Pinned by
+ * `apps/platform/.../ModelSection/ModelSection.test.ts`.
+ */
 export declare const MODEL_REGISTRY: readonly ModelEntry[];
 export declare const FRAMEWORK_REGISTRY: readonly FrameworkEntry[];
 /**

package/dist/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,WAAW,GAAG,YAAY,CAAC;AAExE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,CAAC;IACpE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,kBAAkB,GAAG,mBAAmB,GAAG,YAAY,GAAG,SAAS,CAAC;IACxF,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9C,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,eAAe,EAAE,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;CAC7D;AAED,eAAO,MAAM,cAAc,EAAE,SAAS,UAAU,EAe/C,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,SAAS,cAAc,EA6BvD,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,GAAG,SAAS,UAAU,EAAE,CAQlF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,cAAc,CAAC,WAAW,CAAC,GAAG,MAAM,CAM9E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAE7D"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,WAAW,GAAG,YAAY,CAAC;AAExE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,CAAC;IACpE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,kBAAkB,GAAG,mBAAmB,GAAG,YAAY,GAAG,SAAS,CAAC;IACxF,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9C,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,eAAe,EAAE,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;CAC7D;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,UAAU,EA0B/C,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,SAAS,cAAc,EA6BvD,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,GAAG,SAAS,UAAU,EAAE,CAQlF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,cAAc,CAAC,WAAW,CAAC,GAAG,MAAM,CAM9E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAE7D"}

package/dist/registry.js

@@ -2,18 +2,36 @@
  * Model + framework registry — single source of truth per the model-release
  * playbook §8 item A; a release = one entry change here + rate-card row.
  */
+/**
+ * Array order is picker order AFTER `modelsForProvider` floats the default to
+ * the front — the platform's app-behavior picker shows only `.slice(0, 2)` for
+ * google + openai, so the second array entry per provider is a product-visible
+ * choice, not incidental. Pinned by
+ * `apps/platform/.../ModelSection/ModelSection.test.ts`.
+ */
 export const MODEL_REGISTRY = [
     { id: "claude-sonnet-5", provider: "anthropic", label: "Claude Sonnet 5", status: "ga", isDefault: true },
     { id: "claude-fable-5", provider: "anthropic", label: "Claude Fable 5", status: "ga" },
+    { id: "claude-opus-5", provider: "anthropic", label: "Claude Opus 5", status: "ga" },
     { id: "claude-sonnet-4-6", provider: "anthropic", label: "Claude Sonnet 4.6", status: "ga" },
     { id: "claude-haiku-4-5", provider: "anthropic", label: "Claude Haiku 4.5", status: "ga" },
     { id: "claude-opus-4-8", provider: "anthropic", label: "Claude Opus 4.8", status: "ga" },
-    { id: "gpt-5.5", provider: "openai", label: "GPT-5.5", status: "ga", isDefault: true },
+    // Terra — guuey's OpenAI default (founder call 2026-07-25). This DELIBERATELY
+    // diverges from OpenAI's own `gpt-5.6` alias, which routes to Sol: Terra is
+    // half Sol's price and the better cost/balance pick for hosted agent
+    // workloads. The bare `gpt-5.6` alias is intentionally NOT a registry id
+    // (never offered in a picker) — the rate card still rows it at Sol's price so
+    // an alias call from BYO config can't under-meter.
+    { id: "gpt-5.6-terra", provider: "openai", label: "GPT-5.6 Terra", status: "ga", isDefault: true },
+    { id: "gpt-5.6-sol", provider: "openai", label: "GPT-5.6 Sol", status: "ga" },
+    { id: "gpt-5.6-luna", provider: "openai", label: "GPT-5.6 Luna", status: "ga" },
+    { id: "gpt-5.5", provider: "openai", label: "GPT-5.5", status: "ga" },
     { id: "gpt-5.4", provider: "openai", label: "GPT-5.4", status: "ga" },
     { id: "gpt-4o", provider: "openai", label: "GPT-4o", status: "ga" },
     { id: "gpt-4o-mini", provider: "openai", label: "GPT-4o Mini", status: "ga" },
-    { id: "gpt-5.6", provider: "openai", label: "GPT-5.6", status: "announced" },
-    { id: "gemini-3.5-flash", provider: "google", label: "Gemini 3.5 Flash", status: "ga", isDefault: true },
+    { id: "gemini-3.6-flash", provider: "google", label: "Gemini 3.6 Flash", status: "ga", isDefault: true },
+    { id: "gemini-3.5-flash-lite", provider: "google", label: "Gemini 3.5 Flash Lite", status: "ga" },
+    { id: "gemini-3.5-flash", provider: "google", label: "Gemini 3.5 Flash", status: "ga" },
     { id: "gemini-3.1-pro", provider: "google", label: "Gemini 3.1 Pro", status: "ga" },
     { id: "gemini-2.5-flash", provider: "google", label: "Gemini 2.5 Flash", status: "ga" },
     { id: "gemini-2.5-pro", provider: "google", label: "Gemini 2.5 Pro", status: "ga" },
@@ -35,9 +53,9 @@ export const FRAMEWORK_REGISTRY = [
     },
     {
         framework: "google-adk",
-        sdkPackage: "google-adk",
-        platformPinnedVersion: "2.3.0",
-        facetSupportedRange: null,
+        sdkPackage: "@google/adk", // the OFFICIAL JS ADK (the Python lane retired with guuey_adk_host)
+        platformPinnedVersion: "1.3.0", // pinned in @guuey-private/host-shared
+        facetSupportedRange: ">=1.0.0 <2", // @silverprotocol/google-adk peer range
         defaultProvider: "google",
     },
     {

package/dist/schema.d.ts

@@ -8,7 +8,7 @@
  * - `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`.
+ * the CLI after `guuey create` / `guuey pull --app-id`.
  *
  * **Filename convention** (filename = artifact kind, see design doc §3):
  * ```
@@ -48,8 +48,8 @@ import { type GuueyGguiSection } from './ggui.js';
  * 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.
+ * the CLI after `guuey create` / `guuey pull --app-id`. A fresh project has
+ * neither. After first `guuey create`, both may be present.
  *
  * Re-exports the sub-section types for consumer convenience.
  */
@@ -68,6 +68,7 @@ export declare const GuueyJsonV1: z.ZodObject<{
             "google-adk": "google-adk";
             vanilla: "vanilla";
         }>>;
+        entry: z.ZodOptional<z.ZodString>;
         model: z.ZodOptional<z.ZodString>;
         modelProvider: z.ZodOptional<z.ZodEnum<{
             openai: "openai";
@@ -78,9 +79,8 @@ export declare const GuueyJsonV1: z.ZodObject<{
         }, z.core.$strict>]>>;
         mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"colocated">;
-            command: z.ZodString;
-            args: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            source: z.ZodString;
+            devPort: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"hosted">;
             server: z.ZodOptional<z.ZodString>;
@@ -99,6 +99,11 @@ export declare const GuueyJsonV1: z.ZodObject<{
             federate: z.ZodOptional<z.ZodBoolean>;
             headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
             devPort: z.ZodOptional<z.ZodNumber>;
+            mcpResourceUrl: z.ZodOptional<z.ZodURL>;
+            profileAccess: z.ZodOptional<z.ZodEnum<{
+                read: "read";
+                "read-write": "read-write";
+            }>>;
         }, z.core.$strict>], "kind">>>;
         tools: z.ZodOptional<z.ZodObject<{
             allowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -130,6 +135,10 @@ export declare const GuueyJsonV1: z.ZodObject<{
             user: "user";
             app: "app";
         }>>>;
+        profileAccess: z.ZodOptional<z.ZodEnum<{
+            read: "read";
+            "read-write": "read-write";
+        }>>;
         env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         secrets: z.ZodOptional<z.ZodArray<z.ZodString>>;
         endpoint: z.ZodOptional<z.ZodObject<{

package/dist/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAEjE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAmDtB,CAAC;AAEH,kDAAkD;AAClD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAG3D,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC;AAEvD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,eAAe,CAAC;AAEhD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,WAAW,CAExD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,OAAO,GACX,UAAU,CAAC,OAAO,WAAW,CAAC,SAAS,CAAC,CAE1C"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAEjE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAmDtB,CAAC;AAEH,kDAAkD;AAClD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAG3D,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC;AAEvD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,eAAe,CAAC;AAEhD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,WAAW,CAExD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,OAAO,GACX,UAAU,CAAC,OAAO,WAAW,CAAC,SAAS,CAAC,CAE1C"}

package/dist/schema.js

@@ -8,7 +8,7 @@
  * - `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`.
+ * the CLI after `guuey create` / `guuey pull --app-id`.
  *
  * **Filename convention** (filename = artifact kind, see design doc §3):
  * ```
@@ -48,8 +48,8 @@ import { GguiSectionV1 } from './ggui.js';
  * 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.
+ * the CLI after `guuey create` / `guuey pull --app-id`. A fresh project has
+ * neither. After first `guuey create`, both may be present.
  *
  * Re-exports the sub-section types for consumer convenience.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guuey/config",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "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",
@@ -16,6 +16,16 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
+    },
+    "./registry": {
+      "types": "./dist/registry.d.ts",
+      "import": "./dist/registry.js",
+      "default": "./dist/registry.js"
+    },
+    "./browser": {
+      "types": "./dist/browser.d.ts",
+      "import": "./dist/browser.js",
+      "default": "./dist/browser.js"
     }
   },
   "dependencies": {

package/dist/agent-loader.d.ts

@@ -1,65 +0,0 @@
-import { AgentJsonV1 } from './agent.js';
-/**
- * Walk up from `startDir` (default: `process.cwd()`) looking for an
- * `agent.json`. Returns the absolute path to the first match, or
- * `null` if no file is found within `maxDepth` levels.
- *
- * Stops at the filesystem root regardless of `maxDepth`. Never throws —
- * a missing file is a valid result ("this repo is code-mode only"),
- * not an error.
- */
-export declare function findAgentJson(startDir?: string, maxDepth?: number): string | null;
-/**
- * Error thrown when an `agent.json` fails to load — missing file,
- * malformed JSON, schema validation failure, or an unresolvable
- * `systemPrompt.file` reference. Wraps the underlying cause
- * (`SyntaxError` / `ZodError` / filesystem error) on `.cause`.
- */
-export declare class AgentJsonLoadError extends Error {
-    readonly path: string;
-    constructor(message: string, path: string, options?: {
-        cause?: unknown;
-    });
-}
-/**
- * The inlined, ready-to-snapshot form of `agent.json`. Identical
- * shape to {@link AgentJsonV1} EXCEPT `systemPrompt` is always
- * `string | undefined` — file references are resolved and inlined
- * during load. The pod runtime never reads the filesystem; it sees
- * only this resolved shape.
- *
- * `undefined` system prompt means "fall through to the platform
- * default" (see `GUUEY_DEFAULT_SYSTEM_PROMPT` in `./system-prompt`).
- */
-export type ResolvedAgentJson = Omit<AgentJsonV1, 'systemPrompt'> & {
-    systemPrompt?: string;
-};
-/**
- * Read `agent.json` at `path`, parse JSON, validate against v1, and
- * inline any `systemPrompt.file` reference (resolved relative to the
- * `agent.json` directory). Returns the fully-resolved snapshot.
- *
- * Throws {@link AgentJsonLoadError} if:
- *   - the file does not exist,
- *   - the file is not valid JSON,
- *   - the document fails schema validation (cause = `ZodError`),
- *   - `systemPrompt.file` points outside the project directory or
- *     does not exist on disk.
- */
-export declare function loadAgentJson(path: string): ResolvedAgentJson;
-/**
- * Non-throwing variant of {@link loadAgentJson}. Returns a
- * discriminated result mirroring `z.safeParse` for ergonomics in CLI
- * surfaces that render the error inline.
- */
-export type SafeLoadAgentResult = {
-    success: true;
-    data: ResolvedAgentJson;
-} | {
-    success: false;
-    error: AgentJsonLoadError;
-};
-export declare function safeLoadAgentJson(path: string): SafeLoadAgentResult;
-export { AGENT_JSON_FILENAME, AgentJsonV1, parseAgentJson, safeParseAgentJson, DEFAULT_AGENT_MCP_SERVERS, } from './agent.js';
-export type { AgentJsonMcpServer, AgentJsonRuntime, AgentJsonSystemPrompt, AgentJsonToolGates, } from './agent.js';
-//# sourceMappingURL=agent-loader.d.ts.map

package/dist/agent-loader.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-loader.d.ts","sourceRoot":"","sources":["../src/agent-loader.ts"],"names":[],"mappings":"AAoBA,OAAO,EAEL,WAAW,EAEZ,MAAM,YAAY,CAAC;AAUpB;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,GAAE,MAAsB,EAChC,QAAQ,GAAE,MAA+B,GACxC,MAAM,GAAG,IAAI,CAUf;AAED;;;;;GAKG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAKzE;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG;IAClE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CA8C7D;AAED;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,GAC1C;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAElD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CASnE;AAoDD,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/agent-loader.js

@@ -1,155 +0,0 @@
-/**
- * Node-only filesystem helpers for `agent.json`.
- *
- * Pure-parse helpers (`parseAgentJson` / `safeParseAgentJson`) live in
- * `./agent.ts` and are safe to import from non-Node contexts. This
- * module adds the file-resolution layer: reading `agent.json` off
- * disk, inlining `systemPrompt.file` references, and producing the
- * snapshot the deploy upload + pod boot both read.
- *
- * Intended callers:
- *
- * - `guuey` CLI: `guuey deploy --config agent.json` reads the file,
- *   inlines the system prompt, and POSTs the resulting snapshot to
- *   the control plane as the no-tarball declarative deploy body.
- * - Guuey control-plane services that re-validate the submitted
- *   snapshot server-side before persisting to AgentDeployment.
- * - Stock nocode-runtime pod: reads the snapshot back at boot.
- */
-import { existsSync, readFileSync } from 'node:fs';
-import { dirname, isAbsolute, join, resolve } from 'node:path';
-import { AGENT_JSON_FILENAME, parseAgentJson, } from './agent.js';
-/**
- * How many parent directories `findAgentJson` will walk by default.
- * Internal — the public-facing constant of the same name on
- * `./loader.ts` is the one re-exported on the package barrel; the
- * two values are kept in sync intentionally.
- */
-const DEFAULT_FIND_MAX_DEPTH = 8;
-/**
- * Walk up from `startDir` (default: `process.cwd()`) looking for an
- * `agent.json`. Returns the absolute path to the first match, or
- * `null` if no file is found within `maxDepth` levels.
- *
- * Stops at the filesystem root regardless of `maxDepth`. Never throws —
- * a missing file is a valid result ("this repo is code-mode only"),
- * not an error.
- */
-export function findAgentJson(startDir = process.cwd(), maxDepth = DEFAULT_FIND_MAX_DEPTH) {
-    let dir = resolve(startDir);
-    for (let i = 0; i <= maxDepth; i++) {
-        const candidate = join(dir, AGENT_JSON_FILENAME);
-        if (existsSync(candidate))
-            return candidate;
-        const parent = dirname(dir);
-        if (parent === dir)
-            return null;
-        dir = parent;
-    }
-    return null;
-}
-/**
- * Error thrown when an `agent.json` fails to load — missing file,
- * malformed JSON, schema validation failure, or an unresolvable
- * `systemPrompt.file` reference. Wraps the underlying cause
- * (`SyntaxError` / `ZodError` / filesystem error) on `.cause`.
- */
-export class AgentJsonLoadError extends Error {
-    path;
-    constructor(message, path, options) {
-        super(message, options);
-        this.name = 'AgentJsonLoadError';
-        this.path = path;
-    }
-}
-/**
- * Read `agent.json` at `path`, parse JSON, validate against v1, and
- * inline any `systemPrompt.file` reference (resolved relative to the
- * `agent.json` directory). Returns the fully-resolved snapshot.
- *
- * Throws {@link AgentJsonLoadError} if:
- *   - the file does not exist,
- *   - the file is not valid JSON,
- *   - the document fails schema validation (cause = `ZodError`),
- *   - `systemPrompt.file` points outside the project directory or
- *     does not exist on disk.
- */
-export function loadAgentJson(path) {
-    if (!existsSync(path)) {
-        throw new AgentJsonLoadError(`agent.json not found at ${path}`, path);
-    }
-    let raw;
-    try {
-        raw = readFileSync(path, 'utf-8');
-    }
-    catch (cause) {
-        throw new AgentJsonLoadError(`Failed to read agent.json at ${path}`, path, { cause });
-    }
-    let decoded;
-    try {
-        decoded = JSON.parse(raw);
-    }
-    catch (cause) {
-        throw new AgentJsonLoadError(`agent.json at ${path} is not valid JSON`, path, { cause });
-    }
-    let parsed;
-    try {
-        parsed = parseAgentJson(decoded);
-    }
-    catch (cause) {
-        throw new AgentJsonLoadError(`agent.json at ${path} failed schema validation`, path, { cause });
-    }
-    const baseDir = dirname(path);
-    const resolvedPrompt = resolveSystemPrompt(parsed, baseDir, path);
-    const out = { ...parsed, systemPrompt: resolvedPrompt };
-    if (resolvedPrompt === undefined) {
-        delete out.systemPrompt;
-    }
-    return out;
-}
-export function safeLoadAgentJson(path) {
-    try {
-        return { success: true, data: loadAgentJson(path) };
-    }
-    catch (error) {
-        if (error instanceof AgentJsonLoadError) {
-            return { success: false, error };
-        }
-        throw error;
-    }
-}
-/**
- * Resolve the `systemPrompt` field on a parsed `agent.json`. Returns
- * `undefined` when the field is absent (caller falls through to the
- * platform default). Inlines `{ file }` references relative to
- * `baseDir`; rejects absolute paths and parent-directory escapes so
- * the snapshot can't pull arbitrary host files into the deploy.
- */
-function resolveSystemPrompt(doc, baseDir, agentJsonPath) {
-    const sp = doc.systemPrompt;
-    if (sp === undefined)
-        return undefined;
-    if (typeof sp === 'string')
-        return sp;
-    const relPath = sp.file;
-    if (isAbsolute(relPath)) {
-        throw new AgentJsonLoadError(`systemPrompt.file "${relPath}" must be a relative path, not absolute`, agentJsonPath);
-    }
-    const resolved = resolve(baseDir, relPath);
-    const baseResolved = resolve(baseDir);
-    if (!resolved.startsWith(baseResolved + '/') && resolved !== baseResolved) {
-        throw new AgentJsonLoadError(`systemPrompt.file "${relPath}" resolves outside the project directory`, agentJsonPath);
-    }
-    if (!existsSync(resolved)) {
-        throw new AgentJsonLoadError(`systemPrompt.file "${relPath}" does not exist (looked at ${resolved})`, agentJsonPath);
-    }
-    try {
-        return readFileSync(resolved, 'utf-8').trim();
-    }
-    catch (cause) {
-        throw new AgentJsonLoadError(`Failed to read systemPrompt.file "${relPath}"`, agentJsonPath, { cause });
-    }
-}
-// Re-export pure schema + types from the same subpath so Node callers
-// can do one import.
-export { AGENT_JSON_FILENAME, AgentJsonV1, parseAgentJson, safeParseAgentJson, DEFAULT_AGENT_MCP_SERVERS, } from './agent.js';