@managoat/fountain-sdk 3.0.0 → 4.0.0

package/CHANGELOG.md

@@ -11,6 +11,16 @@ server releases.
 
 ---
 
+## [4.0.0] — 2026-09-14
+
+### Breaking changes
+
+- Removed `Catalog.avatar` and the generated avatar-generation request,
+  response, and operation types. The server no longer provides
+  `POST /api/avatars/generate` or the catalog's avatar bases and moods.
+  Remove avatar-generation controls and calls from clients. Avatar uploads,
+  reads, and removal remain available.
+
 ## [3.0.0] — 2026-09-13
 
 ### Breaking changes

package/dist/generated/openapi.d.ts

@@ -940,26 +940,6 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/api/avatars/generate": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Generate an avatar image
-         * @description Generates a square PNG avatar with the tenant's OpenAI credential from a `base` and a `mood` (`GET /api/catalog` lists both). Returns base64 `data` and `media_type` in the shape `PUT /api/agents/:id/avatar` accepts. 422 `no_openai_key` when the tenant has no OpenAI credential; 502 when the provider refused.
-         */
-        post: operations["FountainWeb.AvatarGenerateController.create"];
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
     "/api/buzz/agents": {
         parameters: {
             query?: never;
@@ -1009,7 +989,7 @@ export interface paths {
         };
         /**
          * The instance's form vocabulary
-         * @description Runtimes with model suggestions per runtime (suggestions, not an allowlist — any `provider/model` under a known provider is accepted), sandbox providers usable on this instance and the default, package managers an environment accepts, the avatar generator's bases and moods, the URLs of the browser apps this instance sends people to for conversations and the team, and remote MCP servers verified to complete connection discovery (again suggestions — any URL can be discovered), each with the date it was last verified. Also `first_request`, the one onboarding snippet this deployment hands out, with its base URL already in it and the caller's own key and agent left as placeholders.
+         * @description Runtimes with model suggestions per runtime (suggestions, not an allowlist — any `provider/model` under a known provider is accepted), sandbox providers usable on this instance and the default, package managers an environment accepts, the URLs of the browser apps this instance sends people to for conversations and the team, and remote MCP servers verified to complete connection discovery (again suggestions — any URL can be discovered), each with the date it was last verified. Also `first_request`, the one onboarding snippet this deployment hands out, with its base URL already in it and the caller's own key and agent left as placeholders.
          */
         get: operations["FountainWeb.CatalogController.show"];
         put?: never;
@@ -3154,22 +3134,6 @@ export interface components {
             /** @description Leading characters of the key, the only part stored in the clear. */
             prefix: string;
         };
-        /** AvatarGenerateRequest */
-        AvatarGenerateRequest: {
-            /** @description One of `GET /api/catalog` `avatar.bases`. */
-            base: string;
-            /** @description One of `GET /api/catalog` `avatar.moods`. */
-            mood: string;
-        };
-        /** AvatarGenerateResponse */
-        AvatarGenerateResponse: {
-            data: {
-                /** @description Base64 PNG bytes. */
-                data: string;
-                /** @example image/png */
-                media_type: string;
-            };
-        };
         /**
          * AvatarRequest
          * @description JSON form of an avatar upload. The raw-bytes form sends the image directly with an image content-type instead.
@@ -3364,10 +3328,6 @@ export interface components {
                     conversations: string | null;
                     team: string | null;
                 };
-                avatar: {
-                    bases: string[];
-                    moods: string[];
-                };
                 /** @description The one onboarding request this deployment hands out (ADR 0038), the same text the verified landing and the manual print. The base URL is already in it. The caller's key and agent are not: the server stores only a hash of a key, so a client substitutes the key it holds and an agent from `GET /api/agents`. */
                 first_request: {
                     /** @description The `curl`, with placeholders. */
@@ -9441,94 +9401,6 @@ export interface operations {
             };
         };
     };
-    "FountainWeb.AvatarGenerateController.create": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /** @description Base and mood */
-        requestBody?: {
-            content: {
-                "application/json": components["schemas"]["AvatarGenerateRequest"];
-            };
-        };
-        responses: {
-            /** @description Generated image */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["AvatarGenerateResponse"];
-                };
-            };
-            /** @description Invalid request */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-            /** @description Unauthorized */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-            /** @description Forbidden */
-            403: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-            /** @description No acceptable representation */
-            406: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["NegotiationError"];
-                };
-            };
-            /** @description No OpenAI credential, or unknown base/mood */
-            422: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-            /** @description Too Many Requests */
-            429: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-            /** @description The image provider refused */
-            502: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-        };
-    };
     "FountainWeb.BuzzAgentController.index": {
         parameters: {
             query?: never;

package/dist/http.d.ts

@@ -15,7 +15,7 @@ export interface RequestOptions {
  * this string is already what Fountain's request logs are keyed on. The
  * version half is asserted against `package.json` by a test.
  */
-export declare const USER_AGENT = "fountain-sdk-js/3.0.0";
+export declare const USER_AGENT = "fountain-sdk-js/4.0.0";
 export declare class HttpClient {
     readonly config: ResolvedConfig;
     private readonly fetchImpl;

package/dist/http.js

@@ -5,7 +5,7 @@ import { AuthError, ConnectionError, FountainError, errorForStatus } from "./err
  * this string is already what Fountain's request logs are keyed on. The
  * version half is asserted against `package.json` by a test.
  */
-export const USER_AGENT = "fountain-sdk-js/3.0.0";
+export const USER_AGENT = "fountain-sdk-js/4.0.0";
 /**
  * The thin layer everything else is built on: one bearer token, JSON in and
  * out, and errors that say which call failed. `Fountain#api` exposes it

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@managoat/fountain-sdk",
-  "version": "3.0.0",
+  "version": "4.0.0",
   "description": "Run a coding agent on a real computer, with your repos and your credentials, in one call.",
   "license": "Apache-2.0",
   "publishConfig": {