octocms 0.4.13 → 0.4.16

package/dist/admin/pages/MediaAssetPage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MediaAssetPage.d.ts","sourceRoot":"","sources":["../../../admin/pages/MediaAssetPage.tsx"],"names":[],"mappings":"AAOA;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,EAAE,EAAE,EAAE,EAAE;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,2DAS1D"}
+{"version":3,"file":"MediaAssetPage.d.ts","sourceRoot":"","sources":["../../../admin/pages/MediaAssetPage.tsx"],"names":[],"mappings":"AAYA;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,EAAE,EAAE,EAAE,EAAE;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,2DAS1D"}

package/dist/admin/pages/MediaAssetPage.js

@@ -1,9 +1,13 @@
 import "../../chunk-B5LE2OEC.js";
 import { jsx } from "react/jsx-runtime";
+import dynamic from "next/dynamic";
 import { getServerSession } from "next-auth";
-import { ErrorBoundary } from "../../components/ErrorBoundary";
-import { MediaAsset } from "../../components/MediaAsset/MediaAsset";
+import { MediaAssetPageSkeleton } from "../../components/MediaAsset/skeletons/MediaAssetPageSkeleton";
+import { ErrorBoundary } from "../../components/ErrorBoundary/ErrorBoundary";
 import { authOptions } from "../auth";
+const MediaAsset = dynamic(() => import("../../components/MediaAsset/MediaAsset"), {
+  loading: () => /* @__PURE__ */ jsx(MediaAssetPageSkeleton, {})
+});
 async function MediaAssetPage({ id }) {
   const session = await getServerSession(authOptions);
   if (!session) return null;

package/dist/admin/pages/MediaAssetPage.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../admin/pages/MediaAssetPage.tsx"],"sourcesContent":["import React from 'react';\nimport { getServerSession } from 'next-auth';\n\nimport { ErrorBoundary } from '../../components/ErrorBoundary';\nimport { MediaAsset } from '../../components/MediaAsset/MediaAsset';\nimport { authOptions } from '../auth';\n\n/**\n * Auth-gated thin shell. `MediaAsset` fetches the media list via\n * `useMediaAsset(id)` and shares the cache with `/cms/media`. The not-found\n * case is rendered inside the component once the list resolves, instead of\n * triggering a server-side `notFound()` — keeps navigation between assets\n * instant from the warm cache.\n */\nexport async function MediaAssetPage({ id }: { id: string }) {\n  const session = await getServerSession(authOptions);\n  if (!session) return null;\n\n  return (\n    <ErrorBoundary label=\"media asset\">\n      <MediaAsset id={id} />\n    </ErrorBoundary>\n  );\n}\n"],"mappings":";AAoBM;AAnBN,SAAS,wBAAwB;AAEjC,SAAS,qBAAqB;AAC9B,SAAS,kBAAkB;AAC3B,SAAS,mBAAmB;AAS5B,eAAsB,eAAe,EAAE,GAAG,GAAmB;AAC3D,QAAM,UAAU,MAAM,iBAAiB,WAAW;AAClD,MAAI,CAAC,QAAS,QAAO;AAErB,SACE,oBAAC,iBAAc,OAAM,eACnB,8BAAC,cAAW,IAAQ,GACtB;AAEJ;","names":[]}
+{"version":3,"sources":["../../../admin/pages/MediaAssetPage.tsx"],"sourcesContent":["import React from 'react';\nimport dynamic from 'next/dynamic';\nimport { getServerSession } from 'next-auth';\n\nimport { MediaAssetPageSkeleton } from '../../components/MediaAsset/skeletons/MediaAssetPageSkeleton';\nimport { ErrorBoundary } from '../../components/ErrorBoundary/ErrorBoundary';\nimport { authOptions } from '../auth';\n\nconst MediaAsset = dynamic(() => import('../../components/MediaAsset/MediaAsset'), {\n  loading: () => <MediaAssetPageSkeleton />,\n});\n\n/**\n * Auth-gated thin shell. `MediaAsset` fetches the media list via\n * `useMediaAsset(id)` and shares the cache with `/cms/media`. The not-found\n * case is rendered inside the component once the list resolves, instead of\n * triggering a server-side `notFound()` — keeps navigation between assets\n * instant from the warm cache.\n */\nexport async function MediaAssetPage({ id }: { id: string }) {\n  const session = await getServerSession(authOptions);\n  if (!session) return null;\n\n  return (\n    <ErrorBoundary label=\"media asset\">\n      <MediaAsset id={id} />\n    </ErrorBoundary>\n  );\n}\n"],"mappings":";AASiB;AARjB,OAAO,aAAa;AACpB,SAAS,wBAAwB;AAEjC,SAAS,8BAA8B;AACvC,SAAS,qBAAqB;AAC9B,SAAS,mBAAmB;AAE5B,MAAM,aAAa,QAAQ,MAAM,OAAO,wCAAwC,GAAG;AAAA,EACjF,SAAS,MAAM,oBAAC,0BAAuB;AACzC,CAAC;AASD,eAAsB,eAAe,EAAE,GAAG,GAAmB;AAC3D,QAAM,UAAU,MAAM,iBAAiB,WAAW;AAClD,MAAI,CAAC,QAAS,QAAO;AAErB,SACE,oBAAC,iBAAc,OAAM,eACnB,8BAAC,cAAW,IAAQ,GACtB;AAEJ;","names":[]}

package/dist/admin/pages/MediaPage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MediaPage.d.ts","sourceRoot":"","sources":["../../../admin/pages/MediaPage.tsx"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,wBAAsB,SAAS,4DAY9B"}
+{"version":3,"file":"MediaPage.d.ts","sourceRoot":"","sources":["../../../admin/pages/MediaPage.tsx"],"names":[],"mappings":"AAYA;;;;GAIG;AACH,wBAAsB,SAAS,4DAY9B"}

package/dist/admin/pages/MediaPage.js

@@ -1,9 +1,13 @@
 import "../../chunk-B5LE2OEC.js";
 import { jsx } from "react/jsx-runtime";
+import dynamic from "next/dynamic";
 import { getServerSession } from "next-auth";
-import MediaManager from "../../components/MediaManager/MediaManager";
-import { ErrorBoundary } from "../../components/ErrorBoundary";
+import { MediaManagerPageSkeleton } from "../../components/MediaManager/skeletons/MediaManagerPageSkeleton";
+import { ErrorBoundary } from "../../components/ErrorBoundary/ErrorBoundary";
 import { authOptions } from "../auth";
+const MediaManager = dynamic(() => import("../../components/MediaManager/MediaManager"), {
+  loading: () => /* @__PURE__ */ jsx(MediaManagerPageSkeleton, {})
+});
 async function MediaPage() {
   const session = await getServerSession(authOptions);
   if (!session) {

package/dist/admin/pages/MediaPage.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../admin/pages/MediaPage.tsx"],"sourcesContent":["import React from 'react';\nimport { getServerSession } from 'next-auth';\n\nimport MediaManager from '../../components/MediaManager/MediaManager';\nimport { ErrorBoundary } from '../../components/ErrorBoundary';\nimport { authOptions } from '../auth';\n\n/**\n * Auth-gated thin shell. `MediaManager` fetches its own data via TanStack\n * Query (`useMediaList`) and renders block-level skeletons for the left panel\n * and grid/list slots. See `octocms/admin/query/hooks/useMediaList.ts`.\n */\nexport async function MediaPage() {\n  const session = await getServerSession(authOptions);\n\n  if (!session) {\n    return null;\n  }\n\n  return (\n    <ErrorBoundary label=\"media library\">\n      <MediaManager />\n    </ErrorBoundary>\n  );\n}\n"],"mappings":";AAqBM;AApBN,SAAS,wBAAwB;AAEjC,OAAO,kBAAkB;AACzB,SAAS,qBAAqB;AAC9B,SAAS,mBAAmB;AAO5B,eAAsB,YAAY;AAChC,QAAM,UAAU,MAAM,iBAAiB,WAAW;AAElD,MAAI,CAAC,SAAS;AACZ,WAAO;AAAA,EACT;AAEA,SACE,oBAAC,iBAAc,OAAM,iBACnB,8BAAC,gBAAa,GAChB;AAEJ;","names":[]}
+{"version":3,"sources":["../../../admin/pages/MediaPage.tsx"],"sourcesContent":["import React from 'react';\nimport dynamic from 'next/dynamic';\nimport { getServerSession } from 'next-auth';\n\nimport { MediaManagerPageSkeleton } from '../../components/MediaManager/skeletons/MediaManagerPageSkeleton';\nimport { ErrorBoundary } from '../../components/ErrorBoundary/ErrorBoundary';\nimport { authOptions } from '../auth';\n\nconst MediaManager = dynamic(() => import('../../components/MediaManager/MediaManager'), {\n  loading: () => <MediaManagerPageSkeleton />,\n});\n\n/**\n * Auth-gated thin shell. `MediaManager` fetches its own data via TanStack\n * Query (`useMediaList`) and renders block-level skeletons for the left panel\n * and grid/list slots. See `octocms/admin/query/hooks/useMediaList.ts`.\n */\nexport async function MediaPage() {\n  const session = await getServerSession(authOptions);\n\n  if (!session) {\n    return null;\n  }\n\n  return (\n    <ErrorBoundary label=\"media library\">\n      <MediaManager />\n    </ErrorBoundary>\n  );\n}\n"],"mappings":";AASiB;AARjB,OAAO,aAAa;AACpB,SAAS,wBAAwB;AAEjC,SAAS,gCAAgC;AACzC,SAAS,qBAAqB;AAC9B,SAAS,mBAAmB;AAE5B,MAAM,eAAe,QAAQ,MAAM,OAAO,4CAA4C,GAAG;AAAA,EACvF,SAAS,MAAM,oBAAC,4BAAyB;AAC3C,CAAC;AAOD,eAAsB,YAAY;AAChC,QAAM,UAAU,MAAM,iBAAiB,WAAW;AAElD,MAAI,CAAC,SAAS;AACZ,WAAO;AAAA,EACT;AAEA,SACE,oBAAC,iBAAc,OAAM,iBACnB,8BAAC,gBAAa,GAChB;AAEJ;","names":[]}

package/dist/admin/theme/toggle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toggle.d.ts","sourceRoot":"","sources":["../../../admin/theme/toggle.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,wBAAgB,WAAW,CAAC,EAAE,YAAY,EAAE,EAAE;IAAE,YAAY,EAAE,KAAK,CAAA;CAAE,2CA8BpE"}
+{"version":3,"file":"toggle.d.ts","sourceRoot":"","sources":["../../../admin/theme/toggle.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAqBrC,wBAAgB,WAAW,CAAC,EAAE,YAAY,EAAE,EAAE;IAAE,YAAY,EAAE,KAAK,CAAA;CAAE,2CAkBpE"}

package/dist/admin/theme/toggle.js

@@ -1,35 +1,35 @@
 "use client";
 import "../../chunk-B5LE2OEC.js";
-import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { jsx, jsxs } from "react/jsx-runtime";
 import { useState } from "react";
-import { Moon, Sun } from "lucide-react";
-import { DropdownMenuItem, DropdownMenuSeparator } from "../../components/ui";
+import { Switcher, SwitcherItem } from "../../components/ui";
+function readCurrentTheme(initialTheme) {
+  if (typeof document !== "undefined") {
+    const el = document.getElementById("cms-layout");
+    if (el) return el.classList.contains("light") ? "light" : "dark";
+  }
+  return initialTheme;
+}
+function applyTheme(next) {
+  var _a;
+  const isLight = next === "light";
+  (_a = document.getElementById("cms-layout")) == null ? void 0 : _a.classList.toggle("light", isLight);
+  document.body.classList.toggle("light", isLight);
+  if (isLight) {
+    document.cookie = "cms-theme=light;path=/;max-age=31536000;SameSite=Lax";
+  } else {
+    document.cookie = "cms-theme=;path=/;max-age=0;SameSite=Lax";
+  }
+}
 function ThemeToggle({ initialTheme }) {
-  const [isLight, setIsLight] = useState(() => {
-    if (typeof document !== "undefined") {
-      const el = document.getElementById("cms-layout");
-      if (el) return el.classList.contains("light");
-    }
-    return initialTheme === "light";
-  });
-  const toggle = () => {
-    var _a;
-    const next = !isLight;
-    setIsLight(next);
-    (_a = document.getElementById("cms-layout")) == null ? void 0 : _a.classList.toggle("light", next);
-    document.body.classList.toggle("light", next);
-    if (next) {
-      document.cookie = "cms-theme=light;path=/;max-age=31536000;SameSite=Lax";
-    } else {
-      document.cookie = "cms-theme=;path=/;max-age=0;SameSite=Lax";
-    }
+  const [theme, setThemeState] = useState(() => readCurrentTheme(initialTheme));
+  const setTheme = (next) => {
+    setThemeState(next);
+    applyTheme(next);
   };
-  return /* @__PURE__ */ jsxs(Fragment, { children: [
-    /* @__PURE__ */ jsx(DropdownMenuSeparator, {}),
-    /* @__PURE__ */ jsxs(DropdownMenuItem, { className: "cursor-pointer gap-2", onSelect: toggle, children: [
-      isLight ? /* @__PURE__ */ jsx(Moon, { className: "h-3.5 w-3.5" }) : /* @__PURE__ */ jsx(Sun, { className: "h-3.5 w-3.5" }),
-      isLight ? "Dark mode" : "Light mode"
-    ] })
+  return /* @__PURE__ */ jsxs(Switcher, { "aria-label": "Theme", children: [
+    /* @__PURE__ */ jsx(SwitcherItem, { active: theme === "dark", onClick: () => setTheme("dark"), children: "Dark" }),
+    /* @__PURE__ */ jsx(SwitcherItem, { active: theme === "light", onClick: () => setTheme("light"), children: "Light" })
   ] });
 }
 export {

package/dist/admin/theme/toggle.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../admin/theme/toggle.tsx"],"sourcesContent":["'use client';\n\nimport React, { useState } from 'react';\nimport { Moon, Sun } from 'lucide-react';\n\nimport { DropdownMenuItem, DropdownMenuSeparator } from '../../components/ui';\nimport type { Theme } from './types';\n\nexport function ThemeToggle({ initialTheme }: { initialTheme: Theme }) {\n  const [isLight, setIsLight] = useState(() => {\n    if (typeof document !== 'undefined') {\n      const el = document.getElementById('cms-layout');\n      if (el) return el.classList.contains('light');\n    }\n    return initialTheme === 'light';\n  });\n\n  const toggle = () => {\n    const next = !isLight;\n    setIsLight(next);\n    document.getElementById('cms-layout')?.classList.toggle('light', next);\n    document.body.classList.toggle('light', next);\n    if (next) {\n      document.cookie = 'cms-theme=light;path=/;max-age=31536000;SameSite=Lax';\n    } else {\n      document.cookie = 'cms-theme=;path=/;max-age=0;SameSite=Lax';\n    }\n  };\n\n  return (\n    <>\n      <DropdownMenuSeparator />\n      <DropdownMenuItem className=\"cursor-pointer gap-2\" onSelect={toggle}>\n        {isLight ? <Moon className=\"h-3.5 w-3.5\" /> : <Sun className=\"h-3.5 w-3.5\" />}\n        {isLight ? 'Dark mode' : 'Light mode'}\n      </DropdownMenuItem>\n    </>\n  );\n}\n"],"mappings":";;AA8BI,mBACE,KACA,YAFF;AA5BJ,SAAgB,gBAAgB;AAChC,SAAS,MAAM,WAAW;AAE1B,SAAS,kBAAkB,6BAA6B;AAGjD,SAAS,YAAY,EAAE,aAAa,GAA4B;AACrE,QAAM,CAAC,SAAS,UAAU,IAAI,SAAS,MAAM;AAC3C,QAAI,OAAO,aAAa,aAAa;AACnC,YAAM,KAAK,SAAS,eAAe,YAAY;AAC/C,UAAI,GAAI,QAAO,GAAG,UAAU,SAAS,OAAO;AAAA,IAC9C;AACA,WAAO,iBAAiB;AAAA,EAC1B,CAAC;AAED,QAAM,SAAS,MAAM;AAjBvB;AAkBI,UAAM,OAAO,CAAC;AACd,eAAW,IAAI;AACf,mBAAS,eAAe,YAAY,MAApC,mBAAuC,UAAU,OAAO,SAAS;AACjE,aAAS,KAAK,UAAU,OAAO,SAAS,IAAI;AAC5C,QAAI,MAAM;AACR,eAAS,SAAS;AAAA,IACpB,OAAO;AACL,eAAS,SAAS;AAAA,IACpB;AAAA,EACF;AAEA,SACE,iCACE;AAAA,wBAAC,yBAAsB;AAAA,IACvB,qBAAC,oBAAiB,WAAU,wBAAuB,UAAU,QAC1D;AAAA,gBAAU,oBAAC,QAAK,WAAU,eAAc,IAAK,oBAAC,OAAI,WAAU,eAAc;AAAA,MAC1E,UAAU,cAAc;AAAA,OAC3B;AAAA,KACF;AAEJ;","names":[]}
+{"version":3,"sources":["../../../admin/theme/toggle.tsx"],"sourcesContent":["'use client';\n\nimport React, { useState } from 'react';\nimport { Switcher, SwitcherItem } from '../../components/ui';\nimport type { Theme } from './types';\n\nfunction readCurrentTheme(initialTheme: Theme): Theme {\n  if (typeof document !== 'undefined') {\n    const el = document.getElementById('cms-layout');\n    if (el) return el.classList.contains('light') ? 'light' : 'dark';\n  }\n  return initialTheme;\n}\n\nfunction applyTheme(next: Theme) {\n  const isLight = next === 'light';\n  document.getElementById('cms-layout')?.classList.toggle('light', isLight);\n  document.body.classList.toggle('light', isLight);\n  if (isLight) {\n    document.cookie = 'cms-theme=light;path=/;max-age=31536000;SameSite=Lax';\n  } else {\n    document.cookie = 'cms-theme=;path=/;max-age=0;SameSite=Lax';\n  }\n}\n\nexport function ThemeToggle({ initialTheme }: { initialTheme: Theme }) {\n  const [theme, setThemeState] = useState<Theme>(() => readCurrentTheme(initialTheme));\n\n  const setTheme = (next: Theme) => {\n    setThemeState(next);\n    applyTheme(next);\n  };\n\n  return (\n    <Switcher aria-label=\"Theme\">\n      <SwitcherItem active={theme === 'dark'} onClick={() => setTheme('dark')}>\n        Dark\n      </SwitcherItem>\n      <SwitcherItem active={theme === 'light'} onClick={() => setTheme('light')}>\n        Light\n      </SwitcherItem>\n    </Switcher>\n  );\n}\n"],"mappings":";;AAkCI,SACE,KADF;AAhCJ,SAAgB,gBAAgB;AAChC,SAAS,UAAU,oBAAoB;AAGvC,SAAS,iBAAiB,cAA4B;AACpD,MAAI,OAAO,aAAa,aAAa;AACnC,UAAM,KAAK,SAAS,eAAe,YAAY;AAC/C,QAAI,GAAI,QAAO,GAAG,UAAU,SAAS,OAAO,IAAI,UAAU;AAAA,EAC5D;AACA,SAAO;AACT;AAEA,SAAS,WAAW,MAAa;AAdjC;AAeE,QAAM,UAAU,SAAS;AACzB,iBAAS,eAAe,YAAY,MAApC,mBAAuC,UAAU,OAAO,SAAS;AACjE,WAAS,KAAK,UAAU,OAAO,SAAS,OAAO;AAC/C,MAAI,SAAS;AACX,aAAS,SAAS;AAAA,EACpB,OAAO;AACL,aAAS,SAAS;AAAA,EACpB;AACF;AAEO,SAAS,YAAY,EAAE,aAAa,GAA4B;AACrE,QAAM,CAAC,OAAO,aAAa,IAAI,SAAgB,MAAM,iBAAiB,YAAY,CAAC;AAEnF,QAAM,WAAW,CAAC,SAAgB;AAChC,kBAAc,IAAI;AAClB,eAAW,IAAI;AAAA,EACjB;AAEA,SACE,qBAAC,YAAS,cAAW,SACnB;AAAA,wBAAC,gBAAa,QAAQ,UAAU,QAAQ,SAAS,MAAM,SAAS,MAAM,GAAG,kBAEzE;AAAA,IACA,oBAAC,gBAAa,QAAQ,UAAU,SAAS,SAAS,MAAM,SAAS,OAAO,GAAG,mBAE3E;AAAA,KACF;AAEJ;","names":[]}

package/dist/agent/chatSetup.d.ts

@@ -0,0 +1,19 @@
+import type { AgentConfig } from './types';
+/** OctoCMS product documentation — linked from the in-admin setup screen. */
+export declare const CHAT_AGENT_DOCS_HREF = "https://octocms.com/docs/chat-agent";
+export type ChatSetupReason = 'no-config' | 'no-key' | 'budget-exceeded';
+export type ChatSetupStep = {
+    title: string;
+    detail: string;
+    code?: string;
+};
+export type ChatSetupInfo = {
+    reason: ChatSetupReason;
+    docsHref: string;
+    headline: string;
+    summary: string;
+    steps: ChatSetupStep[];
+};
+export declare function isChatAgentReady(agentConfig: AgentConfig | null | undefined): boolean;
+export declare function buildChatSetupInfo(agentConfig: AgentConfig | null | undefined): ChatSetupInfo;
+//# sourceMappingURL=chatSetup.d.ts.map

package/dist/agent/chatSetup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatSetup.d.ts","sourceRoot":"","sources":["../../agent/chatSetup.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,SAAS,CAAC;AAE1D,6EAA6E;AAC7E,eAAO,MAAM,oBAAoB,wCAAwC,CAAC;AAE1E,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,QAAQ,GAAG,iBAAiB,CAAC;AAEzE,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAGrF;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,aAAa,CAkC7F"}

package/dist/agent/chatSetup.js

@@ -0,0 +1,119 @@
+import "../chunk-B5LE2OEC.js";
+import { getAgentStatus } from "./featureFlag";
+const CHAT_AGENT_DOCS_HREF = "https://octocms.com/docs/chat-agent";
+function isChatAgentReady(agentConfig) {
+  if (!agentConfig) return false;
+  return getAgentStatus(agentConfig).enabled;
+}
+function buildChatSetupInfo(agentConfig) {
+  if (!agentConfig) {
+    return {
+      reason: "no-config",
+      docsHref: CHAT_AGENT_DOCS_HREF,
+      headline: "Chat agent is not configured",
+      summary: "The chat agent is optional. Follow the OctoCMS documentation to install dependencies, add agent settings to your project config, and connect a model provider.",
+      steps: noConfigSteps()
+    };
+  }
+  const status = getAgentStatus(agentConfig);
+  if (status.enabled) {
+    throw new Error("buildChatSetupInfo called while agent is enabled");
+  }
+  if (status.reason === "budget-exceeded") {
+    return {
+      reason: "budget-exceeded",
+      docsHref: CHAT_AGENT_DOCS_HREF,
+      headline: "Chat agent budget reached",
+      summary: `This deploy has reached the configured spend cap ($${status.budgetUSD.toFixed(2)}). Raise the limit in your agent config or restart the server to reset the in-memory counter.`,
+      steps: budgetExceededSteps()
+    };
+  }
+  return {
+    reason: "no-key",
+    docsHref: CHAT_AGENT_DOCS_HREF,
+    headline: "Chat agent is not ready",
+    summary: providerCredentialSummary(agentConfig.provider),
+    steps: noKeySteps(agentConfig.provider)
+  };
+}
+function noConfigSteps() {
+  return [
+    {
+      title: "Read the setup guide",
+      detail: "The documentation covers supported providers, required packages, and a full checklist for your environment."
+    },
+    {
+      title: "Add agent settings to your project",
+      detail: "Export `agentConfig` from `cms/octocms.config.ts` using `defineAgentConfig`, alongside your main CMS config."
+    },
+    {
+      title: "Connect your model provider",
+      detail: "Configure the provider block (hosted API or local endpoint) and add the credentials or URL your deployment expects. Restart the app after changing secrets."
+    },
+    {
+      title: "Index content for search (recommended)",
+      detail: "Run the embeddings command from the docs so the agent can retrieve entries from your repository."
+    }
+  ];
+}
+function noKeySteps(provider) {
+  if (provider.type === "local") {
+    return [
+      {
+        title: "Confirm the local endpoint",
+        detail: "Ensure your OpenAI-compatible server is running and that `agentConfig` points at the correct base URL for this deployment."
+      },
+      {
+        title: "Check optional auth",
+        detail: "If your server requires an API key, set the env var named in `provider.apiKeyEnv` and restart."
+      },
+      {
+        title: "Restart after changes",
+        detail: "Restart the dev server or redeploy so new environment variables are loaded."
+      }
+    ];
+  }
+  return [
+    {
+      title: "Add provider credentials",
+      detail: "Set the API key (or custom env var) described in the setup guide for your chosen hosted provider, in local env files and production secrets."
+    },
+    {
+      title: "Restart or redeploy",
+      detail: "Restart the dev server locally. On hosted platforms, redeploy after updating secrets."
+    },
+    {
+      title: "Install required packages",
+      detail: "Install the chat and embedding dependencies listed in the documentation before sending a message."
+    }
+  ];
+}
+function budgetExceededSteps() {
+  return [
+    {
+      title: "Raise the deploy cap",
+      detail: "Increase `totalBudgetUSD` in `cms/octocms.config.ts`, or set it to `0` to disable the cap for this deploy."
+    },
+    {
+      title: "Or reset the in-memory counter",
+      detail: "The spend tracker resets on cold start \u2014 redeploy or restart the dev server during testing."
+    },
+    {
+      title: "Use provider-side alerts",
+      detail: "For production, also configure spend alerts in your model provider\u2019s dashboard."
+    }
+  ];
+}
+function providerCredentialSummary(provider) {
+  if (provider.type === "local") {
+    return provider.baseURL ? "A local provider is configured, but the server could not reach the endpoint. Confirm the model server is running and accessible from this app." : "A local provider needs an endpoint URL in `agentConfig`. See the setup guide for examples.";
+  }
+  const label = provider.type === "anthropic" ? "Anthropic" : "OpenAI";
+  return `${label} is selected in config, but the required credentials are missing or empty. Follow the setup guide to add them and restart.`;
+}
+export {
+  CHAT_AGENT_DOCS_HREF,
+  buildChatSetupInfo,
+  isChatAgentReady
+};
+//# sourceMappingURL=chatSetup.js.map

package/dist/agent/chatSetup.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../agent/chatSetup.ts"],"sourcesContent":["import { getAgentStatus } from './featureFlag';\nimport type { AgentConfig, AgentProvider } from './types';\n\n/** OctoCMS product documentation — linked from the in-admin setup screen. */\nexport const CHAT_AGENT_DOCS_HREF = 'https://octocms.com/docs/chat-agent';\n\nexport type ChatSetupReason = 'no-config' | 'no-key' | 'budget-exceeded';\n\nexport type ChatSetupStep = {\n  title: string;\n  detail: string;\n  code?: string;\n};\n\nexport type ChatSetupInfo = {\n  reason: ChatSetupReason;\n  docsHref: string;\n  headline: string;\n  summary: string;\n  steps: ChatSetupStep[];\n};\n\nexport function isChatAgentReady(agentConfig: AgentConfig | null | undefined): boolean {\n  if (!agentConfig) return false;\n  return getAgentStatus(agentConfig).enabled;\n}\n\nexport function buildChatSetupInfo(agentConfig: AgentConfig | null | undefined): ChatSetupInfo {\n  if (!agentConfig) {\n    return {\n      reason: 'no-config',\n      docsHref: CHAT_AGENT_DOCS_HREF,\n      headline: 'Chat agent is not configured',\n      summary:\n        'The chat agent is optional. Follow the OctoCMS documentation to install dependencies, add agent settings to your project config, and connect a model provider.',\n      steps: noConfigSteps(),\n    };\n  }\n\n  const status = getAgentStatus(agentConfig);\n  if (status.enabled) {\n    throw new Error('buildChatSetupInfo called while agent is enabled');\n  }\n\n  if (status.reason === 'budget-exceeded') {\n    return {\n      reason: 'budget-exceeded',\n      docsHref: CHAT_AGENT_DOCS_HREF,\n      headline: 'Chat agent budget reached',\n      summary: `This deploy has reached the configured spend cap ($${status.budgetUSD.toFixed(2)}). Raise the limit in your agent config or restart the server to reset the in-memory counter.`,\n      steps: budgetExceededSteps(),\n    };\n  }\n\n  return {\n    reason: 'no-key',\n    docsHref: CHAT_AGENT_DOCS_HREF,\n    headline: 'Chat agent is not ready',\n    summary: providerCredentialSummary(agentConfig.provider),\n    steps: noKeySteps(agentConfig.provider),\n  };\n}\n\nfunction noConfigSteps(): ChatSetupStep[] {\n  return [\n    {\n      title: 'Read the setup guide',\n      detail:\n        'The documentation covers supported providers, required packages, and a full checklist for your environment.',\n    },\n    {\n      title: 'Add agent settings to your project',\n      detail:\n        'Export `agentConfig` from `cms/octocms.config.ts` using `defineAgentConfig`, alongside your main CMS config.',\n    },\n    {\n      title: 'Connect your model provider',\n      detail:\n        'Configure the provider block (hosted API or local endpoint) and add the credentials or URL your deployment expects. Restart the app after changing secrets.',\n    },\n    {\n      title: 'Index content for search (recommended)',\n      detail: 'Run the embeddings command from the docs so the agent can retrieve entries from your repository.',\n    },\n  ];\n}\n\nfunction noKeySteps(provider: AgentProvider): ChatSetupStep[] {\n  if (provider.type === 'local') {\n    return [\n      {\n        title: 'Confirm the local endpoint',\n        detail:\n          'Ensure your OpenAI-compatible server is running and that `agentConfig` points at the correct base URL for this deployment.',\n      },\n      {\n        title: 'Check optional auth',\n        detail: 'If your server requires an API key, set the env var named in `provider.apiKeyEnv` and restart.',\n      },\n      {\n        title: 'Restart after changes',\n        detail: 'Restart the dev server or redeploy so new environment variables are loaded.',\n      },\n    ];\n  }\n\n  return [\n    {\n      title: 'Add provider credentials',\n      detail:\n        'Set the API key (or custom env var) described in the setup guide for your chosen hosted provider, in local env files and production secrets.',\n    },\n    {\n      title: 'Restart or redeploy',\n      detail: 'Restart the dev server locally. On hosted platforms, redeploy after updating secrets.',\n    },\n    {\n      title: 'Install required packages',\n      detail: 'Install the chat and embedding dependencies listed in the documentation before sending a message.',\n    },\n  ];\n}\n\nfunction budgetExceededSteps(): ChatSetupStep[] {\n  return [\n    {\n      title: 'Raise the deploy cap',\n      detail:\n        'Increase `totalBudgetUSD` in `cms/octocms.config.ts`, or set it to `0` to disable the cap for this deploy.',\n    },\n    {\n      title: 'Or reset the in-memory counter',\n      detail: 'The spend tracker resets on cold start — redeploy or restart the dev server during testing.',\n    },\n    {\n      title: 'Use provider-side alerts',\n      detail: 'For production, also configure spend alerts in your model provider’s dashboard.',\n    },\n  ];\n}\n\nfunction providerCredentialSummary(provider: AgentProvider): string {\n  if (provider.type === 'local') {\n    return provider.baseURL\n      ? 'A local provider is configured, but the server could not reach the endpoint. Confirm the model server is running and accessible from this app.'\n      : 'A local provider needs an endpoint URL in `agentConfig`. See the setup guide for examples.';\n  }\n  const label = provider.type === 'anthropic' ? 'Anthropic' : 'OpenAI';\n  return `${label} is selected in config, but the required credentials are missing or empty. Follow the setup guide to add them and restart.`;\n}\n"],"mappings":";AAAA,SAAS,sBAAsB;AAIxB,MAAM,uBAAuB;AAkB7B,SAAS,iBAAiB,aAAsD;AACrF,MAAI,CAAC,YAAa,QAAO;AACzB,SAAO,eAAe,WAAW,EAAE;AACrC;AAEO,SAAS,mBAAmB,aAA4D;AAC7F,MAAI,CAAC,aAAa;AAChB,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,UAAU;AAAA,MACV,UAAU;AAAA,MACV,SACE;AAAA,MACF,OAAO,cAAc;AAAA,IACvB;AAAA,EACF;AAEA,QAAM,SAAS,eAAe,WAAW;AACzC,MAAI,OAAO,SAAS;AAClB,UAAM,IAAI,MAAM,kDAAkD;AAAA,EACpE;AAEA,MAAI,OAAO,WAAW,mBAAmB;AACvC,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,UAAU;AAAA,MACV,UAAU;AAAA,MACV,SAAS,sDAAsD,OAAO,UAAU,QAAQ,CAAC,CAAC;AAAA,MAC1F,OAAO,oBAAoB;AAAA,IAC7B;AAAA,EACF;AAEA,SAAO;AAAA,IACL,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,UAAU;AAAA,IACV,SAAS,0BAA0B,YAAY,QAAQ;AAAA,IACvD,OAAO,WAAW,YAAY,QAAQ;AAAA,EACxC;AACF;AAEA,SAAS,gBAAiC;AACxC,SAAO;AAAA,IACL;AAAA,MACE,OAAO;AAAA,MACP,QACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,QACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,QACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,QAAQ;AAAA,IACV;AAAA,EACF;AACF;AAEA,SAAS,WAAW,UAA0C;AAC5D,MAAI,SAAS,SAAS,SAAS;AAC7B,WAAO;AAAA,MACL;AAAA,QACE,OAAO;AAAA,QACP,QACE;AAAA,MACJ;AAAA,MACA;AAAA,QACE,OAAO;AAAA,QACP,QAAQ;AAAA,MACV;AAAA,MACA;AAAA,QACE,OAAO;AAAA,QACP,QAAQ;AAAA,MACV;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AAAA,IACL;AAAA,MACE,OAAO;AAAA,MACP,QACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,QAAQ;AAAA,IACV;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,QAAQ;AAAA,IACV;AAAA,EACF;AACF;AAEA,SAAS,sBAAuC;AAC9C,SAAO;AAAA,IACL;AAAA,MACE,OAAO;AAAA,MACP,QACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,QAAQ;AAAA,IACV;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,QAAQ;AAAA,IACV;AAAA,EACF;AACF;AAEA,SAAS,0BAA0B,UAAiC;AAClE,MAAI,SAAS,SAAS,SAAS;AAC7B,WAAO,SAAS,UACZ,mJACA;AAAA,EACN;AACA,QAAM,QAAQ,SAAS,SAAS,cAAc,cAAc;AAC5D,SAAO,GAAG,KAAK;AACjB;","names":[]}

package/dist/agent/featureFlag.d.ts

@@ -7,9 +7,9 @@
  *   2. cumulative spend on this deploy is under `config.totalBudgetUSD`
  *      (cap is bypassed when `totalBudgetUSD <= 0`).
  *
- * When either check fails, the `/cms/chat` route returns 404 and the Header
- * nav link is hidden. Do not call from client components — the result must be
- * passed down as a boolean prop to avoid leaking the key.
+ * When either check fails, `/cms/chat` renders an in-page setup guide and chat
+ * API routes return 404. Do not call from client components to gate UI — the
+ * server page passes setup props instead of leaking the key.
  *
  * Note: this does NOT check whether the SDK packages are installed. They are
  * optional peer deps; their absence surfaces at chat-route invocation time

package/dist/agent/featureFlag.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../agent/featureFlag.ts"],"sourcesContent":["/**\n * Server-side check for whether the RAG chat agent feature is enabled.\n *\n * The agent is enabled when:\n *   1. The provider's API key env var is set (Anthropic / OpenAI), OR the\n *      provider is `'local'` and a `baseURL` is configured (no key required), AND\n *   2. cumulative spend on this deploy is under `config.totalBudgetUSD`\n *      (cap is bypassed when `totalBudgetUSD <= 0`).\n *\n * When either check fails, the `/cms/chat` route returns 404 and the Header\n * nav link is hidden. Do not call from client components — the result must be\n * passed down as a boolean prop to avoid leaking the key.\n *\n * Note: this does NOT check whether the SDK packages are installed. They are\n * optional peer deps; their absence surfaces at chat-route invocation time\n * with a clear error rather than silently disabling the feature.\n */\n\nimport type { AgentConfig, AgentProvider } from './types';\nimport { getUsage, isBudgetExceeded } from './usage';\n\nexport type AgentStatus =\n  | { enabled: true }\n  | { enabled: false; reason: 'no-key' }\n  | { enabled: false; reason: 'budget-exceeded'; spentUSD: number; budgetUSD: number };\n\nconst DEFAULT_API_KEY_ENVS: Record<AgentProvider['type'], string | null> = {\n  anthropic: 'ANTHROPIC_API_KEY',\n  openai: 'OPENAI_API_KEY',\n  local: null,\n};\n\n/** Resolves the env var name a provider reads its API key from. */\nexport function providerApiKeyEnv(provider: AgentProvider): string | null {\n  if (provider.apiKeyEnv) return provider.apiKeyEnv;\n  return DEFAULT_API_KEY_ENVS[provider.type];\n}\n\n/** True iff the provider has the credentials it needs to talk to its model. */\nexport function hasProviderKey(provider: AgentProvider): boolean {\n  if (provider.type === 'local') {\n    if (provider.apiKeyEnv) {\n      const key = process.env[provider.apiKeyEnv];\n      return typeof key === 'string' && key.length > 0;\n    }\n    return Boolean(provider.baseURL);\n  }\n  const envName = providerApiKeyEnv(provider);\n  if (!envName) return false;\n  const key = process.env[envName];\n  return typeof key === 'string' && key.length > 0;\n}\n\nexport function getAgentStatus(config: AgentConfig): AgentStatus {\n  if (!hasProviderKey(config.provider)) return { enabled: false, reason: 'no-key' };\n  const usage = getUsage();\n  if (isBudgetExceeded(config, usage)) {\n    return {\n      enabled: false,\n      reason: 'budget-exceeded',\n      spentUSD: usage.costUSD,\n      budgetUSD: config.totalBudgetUSD,\n    };\n  }\n  return { enabled: true };\n}\n\nexport function isAgentEnabled(config: AgentConfig): boolean {\n  return getAgentStatus(config).enabled;\n}\n"],"mappings":";AAmBA,SAAS,UAAU,wBAAwB;AAO3C,MAAM,uBAAqE;AAAA,EACzE,WAAW;AAAA,EACX,QAAQ;AAAA,EACR,OAAO;AACT;AAGO,SAAS,kBAAkB,UAAwC;AACxE,MAAI,SAAS,UAAW,QAAO,SAAS;AACxC,SAAO,qBAAqB,SAAS,IAAI;AAC3C;AAGO,SAAS,eAAe,UAAkC;AAC/D,MAAI,SAAS,SAAS,SAAS;AAC7B,QAAI,SAAS,WAAW;AACtB,YAAMA,OAAM,QAAQ,IAAI,SAAS,SAAS;AAC1C,aAAO,OAAOA,SAAQ,YAAYA,KAAI,SAAS;AAAA,IACjD;AACA,WAAO,QAAQ,SAAS,OAAO;AAAA,EACjC;AACA,QAAM,UAAU,kBAAkB,QAAQ;AAC1C,MAAI,CAAC,QAAS,QAAO;AACrB,QAAM,MAAM,QAAQ,IAAI,OAAO;AAC/B,SAAO,OAAO,QAAQ,YAAY,IAAI,SAAS;AACjD;AAEO,SAAS,eAAe,QAAkC;AAC/D,MAAI,CAAC,eAAe,OAAO,QAAQ,EAAG,QAAO,EAAE,SAAS,OAAO,QAAQ,SAAS;AAChF,QAAM,QAAQ,SAAS;AACvB,MAAI,iBAAiB,QAAQ,KAAK,GAAG;AACnC,WAAO;AAAA,MACL,SAAS;AAAA,MACT,QAAQ;AAAA,MACR,UAAU,MAAM;AAAA,MAChB,WAAW,OAAO;AAAA,IACpB;AAAA,EACF;AACA,SAAO,EAAE,SAAS,KAAK;AACzB;AAEO,SAAS,eAAe,QAA8B;AAC3D,SAAO,eAAe,MAAM,EAAE;AAChC;","names":["key"]}
+{"version":3,"sources":["../../agent/featureFlag.ts"],"sourcesContent":["/**\n * Server-side check for whether the RAG chat agent feature is enabled.\n *\n * The agent is enabled when:\n *   1. The provider's API key env var is set (Anthropic / OpenAI), OR the\n *      provider is `'local'` and a `baseURL` is configured (no key required), AND\n *   2. cumulative spend on this deploy is under `config.totalBudgetUSD`\n *      (cap is bypassed when `totalBudgetUSD <= 0`).\n *\n * When either check fails, `/cms/chat` renders an in-page setup guide and chat\n * API routes return 404. Do not call from client components to gate UI — the\n * server page passes setup props instead of leaking the key.\n *\n * Note: this does NOT check whether the SDK packages are installed. They are\n * optional peer deps; their absence surfaces at chat-route invocation time\n * with a clear error rather than silently disabling the feature.\n */\n\nimport type { AgentConfig, AgentProvider } from './types';\nimport { getUsage, isBudgetExceeded } from './usage';\n\nexport type AgentStatus =\n  | { enabled: true }\n  | { enabled: false; reason: 'no-key' }\n  | { enabled: false; reason: 'budget-exceeded'; spentUSD: number; budgetUSD: number };\n\nconst DEFAULT_API_KEY_ENVS: Record<AgentProvider['type'], string | null> = {\n  anthropic: 'ANTHROPIC_API_KEY',\n  openai: 'OPENAI_API_KEY',\n  local: null,\n};\n\n/** Resolves the env var name a provider reads its API key from. */\nexport function providerApiKeyEnv(provider: AgentProvider): string | null {\n  if (provider.apiKeyEnv) return provider.apiKeyEnv;\n  return DEFAULT_API_KEY_ENVS[provider.type];\n}\n\n/** True iff the provider has the credentials it needs to talk to its model. */\nexport function hasProviderKey(provider: AgentProvider): boolean {\n  if (provider.type === 'local') {\n    if (provider.apiKeyEnv) {\n      const key = process.env[provider.apiKeyEnv];\n      return typeof key === 'string' && key.length > 0;\n    }\n    return Boolean(provider.baseURL);\n  }\n  const envName = providerApiKeyEnv(provider);\n  if (!envName) return false;\n  const key = process.env[envName];\n  return typeof key === 'string' && key.length > 0;\n}\n\nexport function getAgentStatus(config: AgentConfig): AgentStatus {\n  if (!hasProviderKey(config.provider)) return { enabled: false, reason: 'no-key' };\n  const usage = getUsage();\n  if (isBudgetExceeded(config, usage)) {\n    return {\n      enabled: false,\n      reason: 'budget-exceeded',\n      spentUSD: usage.costUSD,\n      budgetUSD: config.totalBudgetUSD,\n    };\n  }\n  return { enabled: true };\n}\n\nexport function isAgentEnabled(config: AgentConfig): boolean {\n  return getAgentStatus(config).enabled;\n}\n"],"mappings":";AAmBA,SAAS,UAAU,wBAAwB;AAO3C,MAAM,uBAAqE;AAAA,EACzE,WAAW;AAAA,EACX,QAAQ;AAAA,EACR,OAAO;AACT;AAGO,SAAS,kBAAkB,UAAwC;AACxE,MAAI,SAAS,UAAW,QAAO,SAAS;AACxC,SAAO,qBAAqB,SAAS,IAAI;AAC3C;AAGO,SAAS,eAAe,UAAkC;AAC/D,MAAI,SAAS,SAAS,SAAS;AAC7B,QAAI,SAAS,WAAW;AACtB,YAAMA,OAAM,QAAQ,IAAI,SAAS,SAAS;AAC1C,aAAO,OAAOA,SAAQ,YAAYA,KAAI,SAAS;AAAA,IACjD;AACA,WAAO,QAAQ,SAAS,OAAO;AAAA,EACjC;AACA,QAAM,UAAU,kBAAkB,QAAQ;AAC1C,MAAI,CAAC,QAAS,QAAO;AACrB,QAAM,MAAM,QAAQ,IAAI,OAAO;AAC/B,SAAO,OAAO,QAAQ,YAAY,IAAI,SAAS;AACjD;AAEO,SAAS,eAAe,QAAkC;AAC/D,MAAI,CAAC,eAAe,OAAO,QAAQ,EAAG,QAAO,EAAE,SAAS,OAAO,QAAQ,SAAS;AAChF,QAAM,QAAQ,SAAS;AACvB,MAAI,iBAAiB,QAAQ,KAAK,GAAG;AACnC,WAAO;AAAA,MACL,SAAS;AAAA,MACT,QAAQ;AAAA,MACR,UAAU,MAAM;AAAA,MAChB,WAAW,OAAO;AAAA,IACpB;AAAA,EACF;AACA,SAAO,EAAE,SAAS,KAAK;AACzB;AAEO,SAAS,eAAe,QAA8B;AAC3D,SAAO,eAAe,MAAM,EAAE;AAChC;","names":["key"]}