@burdenoff/microfe-vibecontrols 2026.915.1 → 2026.915.3

package/dist/components/assistant/AIAssistantPanel.js

@@ -1,40 +1,30 @@
-import { ASSISTANT_MODES as e } from "../../types/assistant.js";
-import { PRODUCT as t, reportAssistantTokenUsage as n } from "../../services/assistantApi.js";
-import { useWorkspaceWriteAccess as r } from "../../hooks/useWorkspaceWriteAccess.js";
-import { describeCurrentPage as i, gatherPageContext as a } from "../../utils/pageContext.js";
-import { buildPromptForMode as o } from "../../utils/assistantPrompt.js";
-import { AiCreditsMeter as s } from "./AiCreditsMeter.js";
-import { jsx as c, jsxs as l } from "react/jsx-runtime";
-import { AIAssistantPanel as u } from "@burdenoff/fe-libs/shared/assistant/ui/AIAssistantPanel";
-import { AssistantProductProvider as d } from "@burdenoff/fe-libs/shared/assistant/product";
-import { getActorId as f, getWorkspaceId as p } from "@burdenoff/fe-libs/shared/assistant/context";
+import { useWorkspaceWriteAccess as e } from "../../hooks/useWorkspaceWriteAccess.js";
+import { useOfferedAssistantMode as t } from "../../hooks/useOfferedAssistantMode.js";
+import { AiCreditsMeter as n } from "./AiCreditsMeter.js";
+import { VIBECONTROLS_ASSISTANT_PRODUCT as r } from "./assistantProduct.js";
+import { jsx as i, jsxs as a } from "react/jsx-runtime";
+import { AIAssistantPanel as o } from "@burdenoff/fe-libs/shared/assistant/ui/AIAssistantPanel";
+import { AssistantProductProvider as s } from "@burdenoff/fe-libs/shared/assistant/product";
+import { getActorId as c, getWorkspaceId as l } from "@burdenoff/fe-libs/shared/assistant/context";
 //#region src/components/assistant/AIAssistantPanel.tsx
-var m = {
-	attachments: "/VibeControls/AI Assistant/Attachments",
-	artifacts: "/VibeControls/AI Assistant/Artifacts"
-}, h = (h) => {
-	let g = r(f(), p() || null);
-	return /* @__PURE__ */ c(d, {
-		product: t,
-		modes: e,
-		describeCurrentPage: i,
-		gatherPageContext: a,
-		buildPrompt: o,
-		reportTokenUsage: n,
-		storageFolders: m,
-		children: /* @__PURE__ */ l("div", {
+var u = (u) => {
+	t();
+	let d = e(c(), l() || null);
+	return /* @__PURE__ */ i(s, {
+		...r,
+		children: /* @__PURE__ */ a("div", {
 			className: "flex flex-col h-full w-full min-h-0",
-			children: [/* @__PURE__ */ c(s, {}), /* @__PURE__ */ c("div", {
+			children: [/* @__PURE__ */ i(n, {}), /* @__PURE__ */ i("div", {
 				className: "flex-1 min-h-0",
-				children: /* @__PURE__ */ c(u, {
-					...h,
-					writeAccess: g
+				children: /* @__PURE__ */ i(o, {
+					...u,
+					writeAccess: d
 				})
 			})]
 		})
 	});
 };
 //#endregion
-export { h as AIAssistantPanel };
+export { u as AIAssistantPanel };
 
 //# sourceMappingURL=AIAssistantPanel.js.map

package/dist/components/assistant/AIAssistantPanel.js.map

@@ -1 +1 @@
-{"version":3,"file":"AIAssistantPanel.js","names":[],"sources":["../../../src/components/assistant/AIAssistantPanel.tsx"],"sourcesContent":["/**\n * VibeControls' AI assistant.\n *\n * ★★ Everything below this file is now shared. The panel, the orchestrator, the\n * transport, the voice session, the composer and every component in them live in\n * `fe-libs/shared/assistant` and answer to any product that mounts them. What is\n * left here is the things that are genuinely VibeControls', and nothing else:\n *\n *   modes               which use cases this product offers.\n *   describeCurrentPage what to CALL the page the user is on.\n *   gatherPageContext   the same page, as structured context for the agent.\n *   buildPrompt         the confirm-before-mutate guardrail, the language\n *                       directive and the dictation instructions.\n *   reportTokenUsage    the charge, against VibeControls' OWN reporter.\n *   storageFolders      where this product's attachments and artifacts live.\n *\n * Plus `writeAccess`, which is a PROP rather than a seventh seam field: which\n * resource types prove \"this user can write here\" is a product answer, but the\n * product can simply compute it and hand it down. A capability a product can\n * work out for itself does not belong in an interface every product must\n * satisfy.\n *\n * ★ The provider wraps from OUTSIDE the shared panel rather than sitting inside\n * its tree: the panel calls `useAssistantProduct()` and `useAssistantTr()` in its\n * own body, so a provider nested in its JSX would be below the consumer and read\n * as null — which does not throw, it silently renders English with no modes.\n *\n * ★ `AiCreditsMeter` is composed AROUND the shared panel, not inside it. The\n * shared panel has no slot for it and should not grow one: a credits strip is a\n * VibeControls billing decision, not something every product wants above its\n * assistant. It listens to the `notifyAiCreditsUpdated` event the shared chat\n * area already dispatches, so it keeps working untouched.\n */\n\nimport type { FC } from 'react';\nimport {\n  AIAssistantPanel as SharedAIAssistantPanel,\n  type AIAssistantPanelProps as SharedProps,\n} from '@burdenoff/fe-libs/shared/assistant/ui/AIAssistantPanel';\nimport { AssistantProductProvider } from '@burdenoff/fe-libs/shared/assistant/product';\nimport { getActorId, getWorkspaceId } from '@burdenoff/fe-libs/shared/assistant/context';\nimport { ASSISTANT_MODES } from '@/types/assistant';\nimport { PRODUCT, reportAssistantTokenUsage } from '@/services/assistantApi';\nimport { useWorkspaceWriteAccess } from '@/hooks/useWorkspaceWriteAccess';\nimport { describeCurrentPage, gatherPageContext } from '@/utils/pageContext';\nimport { buildPromptForMode } from '@/utils/assistantPrompt';\nimport { AiCreditsMeter } from './AiCreditsMeter';\n\n/**\n * Where this product's assistant files live.\n *\n * ★★ These strings are LOAD-BEARING once users have saved anything. They are the\n * real folders in the workspace file library holding every attachment and\n * artifact. Changing them does not fail — it starts a second folder beside the\n * first and orphans everything in the original.\n *\n * ★ Note the capitalisation: `/VibeControls/…`, while the product id is\n * `vibecontrols`. That mismatch is exactly why fe-libs cannot derive this and\n * why it is supplied here.\n */\nconst STORAGE_FOLDERS = {\n  attachments: '/VibeControls/AI Assistant/Attachments',\n  artifacts: '/VibeControls/AI Assistant/Artifacts',\n} as const;\n\nexport type AIAssistantPanelProps = Omit<SharedProps, 'writeAccess'>;\n\nexport const AIAssistantPanel: FC<AIAssistantPanelProps> = (props) => {\n  /**\n   * ★ Advisory, never a gate — see `useWorkspaceWriteAccess`. Gating on it\n   * would remove api-calls from the product entirely until RBAC rows are\n   * seeded. It warns before the effort instead of after it, and self-corrects\n   * with no code change the moment those rows exist.\n   */\n  const writeAccess = useWorkspaceWriteAccess(getActorId(), getWorkspaceId() || null);\n\n  return (\n    <AssistantProductProvider\n      product={PRODUCT}\n      modes={ASSISTANT_MODES}\n      describeCurrentPage={describeCurrentPage}\n      gatherPageContext={gatherPageContext}\n      buildPrompt={buildPromptForMode}\n      reportTokenUsage={reportAssistantTokenUsage}\n      storageFolders={STORAGE_FOLDERS}\n    >\n      <div className=\"flex flex-col h-full w-full min-h-0\">\n        <AiCreditsMeter />\n        <div className=\"flex-1 min-h-0\">\n          <SharedAIAssistantPanel {...props} writeAccess={writeAccess} />\n        </div>\n      </div>\n    </AssistantProductProvider>\n  );\n};\n"],"mappings":";;;;;;;;;;;AA4DA,IAAM,IAAkB;CACtB,aAAa;CACb,WAAW;CACZ,EAIY,KAA+C,MAAU;CAOpE,IAAM,IAAc,EAAwB,GAAY,EAAE,GAAgB,IAAI,KAAK;AAEnF,QACE,kBAAC,GAAD;EACE,SAAS;EACT,OAAO;EACc;EACF;EACnB,aAAa;EACb,kBAAkB;EAClB,gBAAgB;YAEhB,kBAAC,OAAD;GAAK,WAAU;aAAf,CACE,kBAAC,GAAD,EAAkB,CAAA,EAClB,kBAAC,OAAD;IAAK,WAAU;cACb,kBAAC,GAAD;KAAwB,GAAI;KAAoB;KAAe,CAAA;IAC3D,CAAA,CACF;;EACmB,CAAA"}
+{"version":3,"file":"AIAssistantPanel.js","names":[],"sources":["../../../src/components/assistant/AIAssistantPanel.tsx"],"sourcesContent":["/**\n * VibeControls' AI assistant.\n *\n * ★★ Everything below this file is now shared. The panel, the orchestrator, the\n * transport, the voice session, the composer and every component in them live in\n * `fe-libs/shared/assistant` and answer to any product that mounts them. What is\n * left here is the things that are genuinely VibeControls', and nothing else:\n *\n *   modes               which use cases this product offers.\n *   describeCurrentPage what to CALL the page the user is on.\n *   gatherPageContext   the same page, as structured context for the agent.\n *   buildPrompt         the confirm-before-mutate guardrail, the language\n *                       directive and the dictation instructions.\n *   reportTokenUsage    the charge, against VibeControls' OWN reporter.\n *   storageFolders      where this product's attachments and artifacts live.\n *\n * All six, plus the product id, are one `Required` value in `assistantProduct.ts`,\n * spread into the provider here, so a missing answer is a type error.\n *\n * Plus `writeAccess`, which is a PROP rather than a seventh seam field: which\n * resource types prove \"this user can write here\" is a product answer, but the\n * product can simply compute it and hand it down. A capability a product can\n * work out for itself does not belong in an interface every product must\n * satisfy.\n *\n * ★ The provider wraps from OUTSIDE the shared panel rather than sitting inside\n * its tree: the panel calls `useAssistantProduct()` and `useAssistantTr()` in its\n * own body, so a provider nested in its JSX would be below the consumer and read\n * as null — which does not throw, it silently renders English with no modes.\n *\n * ★ `AiCreditsMeter` is composed AROUND the shared panel, not inside it. The\n * shared panel has no slot for it and should not grow one: a credits strip is a\n * VibeControls billing decision, not something every product wants above its\n * assistant. It listens to the `notifyAiCreditsUpdated` event the shared chat\n * area already dispatches, so it keeps working untouched.\n */\n\nimport type { FC } from 'react';\nimport {\n  AIAssistantPanel as SharedAIAssistantPanel,\n  type AIAssistantPanelProps as SharedProps,\n} from '@burdenoff/fe-libs/shared/assistant/ui/AIAssistantPanel';\nimport { AssistantProductProvider } from '@burdenoff/fe-libs/shared/assistant/product';\nimport { getActorId, getWorkspaceId } from '@burdenoff/fe-libs/shared/assistant/context';\nimport { useWorkspaceWriteAccess } from '@/hooks/useWorkspaceWriteAccess';\nimport { useOfferedAssistantMode } from '@/hooks/useOfferedAssistantMode';\nimport { AiCreditsMeter } from './AiCreditsMeter';\nimport { VIBECONTROLS_ASSISTANT_PRODUCT } from './assistantProduct';\n\nexport type AIAssistantPanelProps = Omit<SharedProps, 'writeAccess'>;\n\nexport const AIAssistantPanel: FC<AIAssistantPanelProps> = (props) => {\n  /**\n   * ★★ A stored mode VibeControls no longer offers (the retired `general`) lands\n   * on Ask BEFORE the shared panel's mount effects read it; see the hook. Called\n   * here, above the panel, because that ordering is what makes it work.\n   */\n  useOfferedAssistantMode();\n\n  /**\n   * ★ Advisory, never a gate — see `useWorkspaceWriteAccess`. Gating on it\n   * would remove api-calls from the product entirely until RBAC rows are\n   * seeded. It warns before the effort instead of after it, and self-corrects\n   * with no code change the moment those rows exist.\n   */\n  const writeAccess = useWorkspaceWriteAccess(getActorId(), getWorkspaceId() || null);\n\n  return (\n    <AssistantProductProvider {...VIBECONTROLS_ASSISTANT_PRODUCT}>\n      <div className=\"flex flex-col h-full w-full min-h-0\">\n        <AiCreditsMeter />\n        <div className=\"flex-1 min-h-0\">\n          <SharedAIAssistantPanel {...props} writeAccess={writeAccess} />\n        </div>\n      </div>\n    </AssistantProductProvider>\n  );\n};\n"],"mappings":";;;;;;;;;AAmDA,IAAa,KAA+C,MAAU;AAMpE,IAAyB;CAQzB,IAAM,IAAc,EAAwB,GAAY,EAAE,GAAgB,IAAI,KAAK;AAEnF,QACE,kBAAC,GAAD;EAA0B,GAAI;YAC5B,kBAAC,OAAD;GAAK,WAAU;aAAf,CACE,kBAAC,GAAD,EAAkB,CAAA,EAClB,kBAAC,OAAD;IAAK,WAAU;cACb,kBAAC,GAAD;KAAwB,GAAI;KAAoB;KAAe,CAAA;IAC3D,CAAA,CACF;;EACmB,CAAA"}

package/dist/components/assistant/AiCreditsMeter.js.map

@@ -1 +1 @@
-{"version":3,"file":"AiCreditsMeter.js","names":[],"sources":["../../../src/components/assistant/AiCreditsMeter.tsx"],"sourcesContent":["import type { FC } from 'react';\nimport { QuotaMeter } from '@burdenoff/fe-libs/shared/components';\nimport { useAiCreditsQuota } from '@/hooks/useAiCreditsQuota';\nimport { useTr } from '../../shared/hooks/useTr';\n\n/**\n * Thin AI-credits usage strip shown under the assistant panel header. Hidden\n * entirely when there's no quota to show (standalone preview, no billing\n * account, or unlimited plan with nothing meaningful to meter).\n */\nexport const AiCreditsMeter: FC = () => {\n  const tr = useTr();\n  const { data } = useAiCreditsQuota();\n\n  // Nothing to meter — hide rather than render an empty/Unlimited strip.\n  if (!data || data.noLimit) return null;\n\n  return (\n    <div className=\"px-3 py-1.5 border-b border-border-default bg-bg-surface flex-shrink-0\">\n      <QuotaMeter\n        label={tr('vibecontrols.assistant.credits.label', 'AI credits')}\n        used={data.used}\n        limit={data.limit}\n        unit={tr('vibecontrols.assistant.credits.unit', 'tokens')}\n      />\n    </div>\n  );\n};\n"],"mappings":";;;;;AAUA,IAAa,UAA2B;CACtC,IAAM,IAAK,GAAO,EACZ,EAAE,YAAS,GAAmB;AAKpC,QAFI,CAAC,KAAQ,EAAK,UAAgB,OAGhC,kBAAC,OAAD;EAAK,WAAU;YACb,kBAAC,GAAD;GACE,OAAO,EAAG,wCAAwC,aAAa;GAC/D,MAAM,EAAK;GACX,OAAO,EAAK;GACZ,MAAM,EAAG,uCAAuC,SAAS;GACzD,CAAA;EACE,CAAA"}
+{"version":3,"file":"AiCreditsMeter.js","names":[],"sources":["../../../src/components/assistant/AiCreditsMeter.tsx"],"sourcesContent":["import type { FC } from 'react';\nimport { QuotaMeter } from '@burdenoff/fe-libs/shared/components';\nimport { useAiCreditsQuota } from '@/hooks/useAiCreditsQuota';\nimport { useTr } from '../../shared/hooks/useTr';\n\n/**\n * Thin AI-credits usage strip shown under the assistant panel header. Hidden\n * entirely when there's no quota to show (standalone preview, no workspace, a\n * failed ledger read, no `vibecontrols.ai.credits` assignment, or an unlimited\n * plan with nothing meaningful to meter). See `useAiCreditsQuota`.\n */\nexport const AiCreditsMeter: FC = () => {\n  const tr = useTr();\n  const { data } = useAiCreditsQuota();\n\n  // Nothing to meter — hide rather than render an empty/Unlimited strip.\n  if (!data || data.noLimit) return null;\n\n  return (\n    <div className=\"px-3 py-1.5 border-b border-border-default bg-bg-surface flex-shrink-0\">\n      <QuotaMeter\n        label={tr('vibecontrols.assistant.credits.label', 'AI credits')}\n        used={data.used}\n        limit={data.limit}\n        unit={tr('vibecontrols.assistant.credits.unit', 'tokens')}\n      />\n    </div>\n  );\n};\n"],"mappings":";;;;;AAWA,IAAa,UAA2B;CACtC,IAAM,IAAK,GAAO,EACZ,EAAE,YAAS,GAAmB;AAKpC,QAFI,CAAC,KAAQ,EAAK,UAAgB,OAGhC,kBAAC,OAAD;EAAK,WAAU;YACb,kBAAC,GAAD;GACE,OAAO,EAAG,wCAAwC,aAAa;GAC/D,MAAM,EAAK;GACX,OAAO,EAAK;GACZ,MAAM,EAAG,uCAAuC,SAAS;GACzD,CAAA;EACE,CAAA"}

package/dist/components/assistant/assistantProduct.js

@@ -0,0 +1,20 @@
+import { ASSISTANT_MODES as e } from "../../types/assistant.js";
+import { PRODUCT as t, reportAssistantTokenUsage as n } from "../../services/assistantApi.js";
+import { describeCurrentPage as r, gatherPageContext as i } from "../../utils/pageContext.js";
+import { buildPromptForMode as a } from "../../utils/assistantPrompt.js";
+var o = {
+	product: t,
+	modes: e,
+	describeCurrentPage: r,
+	gatherPageContext: i,
+	buildPrompt: a,
+	reportTokenUsage: n,
+	storageFolders: {
+		attachments: "/VibeControls/AI Assistant/Attachments",
+		artifacts: "/VibeControls/AI Assistant/Artifacts"
+	}
+};
+//#endregion
+export { o as VIBECONTROLS_ASSISTANT_PRODUCT };
+
+//# sourceMappingURL=assistantProduct.js.map

package/dist/components/assistant/assistantProduct.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistantProduct.js","names":[],"sources":["../../../src/components/assistant/assistantProduct.ts"],"sourcesContent":["/**\n * VibeControls' answers to the shared assistant's product seam, as one value.\n *\n * ★★ Every field of fe-libs' `AssistantProductProvider` is OPTIONAL, and a\n * missing one does not throw — it silently degrades. No `gatherPageContext`\n * sends every turn with no page context; no `buildPrompt` drops the\n * confirm-before-mutate guardrail and the language directive; no\n * `reportTokenUsage` meters nothing; no `storageFolders` starts a second folder\n * beside the one holding every saved attachment.\n *\n * So the value is typed `Required<…>` over the provider's own props: forgetting\n * a field, or fe-libs adding one, is a type error in this file rather than a\n * quiet regression in production. The wrapper spreads it into the provider, and\n * `assistantProduct.test.tsx` reads it back through fe-libs' real context.\n */\n\nimport type { AssistantProductProviderProps } from '@burdenoff/fe-libs/shared/assistant/product';\nimport { ASSISTANT_MODES } from '@/types/assistant';\nimport { PRODUCT, reportAssistantTokenUsage } from '@/services/assistantApi';\nimport { describeCurrentPage, gatherPageContext } from '@/utils/pageContext';\nimport { buildPromptForMode } from '@/utils/assistantPrompt';\n\n/**\n * Where this product's assistant files live.\n *\n * ★★ These strings are LOAD-BEARING once users have saved anything. They are the\n * real folders in the workspace file library holding every attachment and\n * artifact. Changing them does not fail — it starts a second folder beside the\n * first and orphans everything in the original.\n *\n * ★ Note the capitalisation: `/VibeControls/…`, while the product id is\n * `vibecontrols`. That mismatch is exactly why fe-libs cannot derive this and\n * why it is supplied here.\n */\nexport const STORAGE_FOLDERS = {\n  attachments: '/VibeControls/AI Assistant/Attachments',\n  artifacts: '/VibeControls/AI Assistant/Artifacts',\n} as const;\n\n/** Every seam field, required: the provider's props minus its children. */\nexport type VibeControlsAssistantProduct = Required<\n  Omit<AssistantProductProviderProps, 'children'>\n>;\n\nexport const VIBECONTROLS_ASSISTANT_PRODUCT: VibeControlsAssistantProduct = {\n  product: PRODUCT,\n  modes: ASSISTANT_MODES,\n  describeCurrentPage,\n  gatherPageContext,\n  buildPrompt: buildPromptForMode,\n  reportTokenUsage: reportAssistantTokenUsage,\n  storageFolders: STORAGE_FOLDERS,\n};\n"],"mappings":";;;;AA4CA,IAAa,IAA+D;CAC1E,SAAS;CACT,OAAO;CACP;CACA;CACA,aAAa;CACb,kBAAkB;CAClB,gBAjB6B;EAC7B,aAAa;EACb,WAAW;EACZ;CAeA"}

package/dist/components/assistant/index.js

@@ -1,10 +1,2 @@
 import "./AIAssistantPanel.js";
-import "./AssistantChatInput.js";
 import "./ProductMarkdown.js";
-import "./AssistantMessageItem.js";
-import "./AssistantMessageList.js";
-import "./AssistantModeSelector.js";
-import "./AssistantWelcome.js";
-import "./AssistantChatArea.js";
-import "./AssistantConversationList.js";
-import "./AssistantExportMenu.js";

package/dist/config/assistantUsecases.js

@@ -1,51 +1,48 @@
-//#region src/config/assistantUsecases.ts
 var e = [
 	{
 		id: "assistant",
-		label: "Assistant",
-		description: "Ask questions and run operations on the current screen — answers from the docs and makes API calls for you",
+		label: "Ask",
+		description: "Ask about VibeControls and your workspace. It reads your vibes, sessions and agents, explains what you are looking at and points you to the right page. Read-only.",
 		suggestions: [
 			"What can I do on this screen?",
-			"Create a new vibe called demo",
 			"List my recent sessions",
+			"Where do I manage my agents?",
 			"How do tunnels work?"
 		]
 	},
 	{
 		id: "api-calls",
-		label: "API Calls",
-		description: "Make API calls in context with the active product and your credentials",
+		label: "Take action",
+		description: "Let the assistant make changes for you: create vibes, rename them, stop sessions. It shows you each change and waits for your approval before anything is saved.",
 		suggestions: [
-			"Show me all API endpoints for sessions",
-			"How do I create an agent via the API?",
-			"List vibes using the REST API",
-			"What headers are needed for authentication?"
-		]
+			"Create a new vibe called demo",
+			"Rename one of my vibes",
+			"Stop a session I no longer need",
+			"List my recent sessions"
+		],
+		requiresAdmin: !0,
+		writeCapable: !0
 	},
 	{
 		id: "vibe-plugins",
-		label: "Vibe Plugins",
-		description: "Build and learn about Vibe Plugins for extending VibeControls",
+		label: "Build",
+		description: "Build a Vibe Plugin that extends VibeControls. The assistant scaffolds and compiles it from the platform guides and gives you the files to download.",
 		suggestions: [
 			"How do I create a new Vibe Plugin?",
 			"What is the plugin manifest structure?",
 			"Explain the plugin lifecycle hooks",
 			"Show me a plugin example with frontend UI"
-		]
-	},
-	{
-		id: "general",
-		label: "General",
-		description: "General help with VibeControls concepts and features",
-		suggestions: [
-			"What is a Vibe in VibeControls?",
-			"How do agents connect to the platform?",
-			"Explain the session lifecycle",
-			"What are tunnels used for?"
-		]
+		],
+		requiresAdmin: !0
 	}
-];
+], t = "assistant";
+function n(t) {
+	return e.some((e) => e.id === t);
+}
+function r(e) {
+	return n(e) ? e : t;
+}
 //#endregion
-export { e as ASSISTANT_USECASE_CONFIG };
+export { e as ASSISTANT_USECASE_CONFIG, r as resolveOfferedMode };
 
 //# sourceMappingURL=assistantUsecases.js.map

package/dist/config/assistantUsecases.js.map

@@ -1 +1 @@
-{"version":3,"file":"assistantUsecases.js","names":[],"sources":["../../src/config/assistantUsecases.ts"],"sourcesContent":["export const ASSISTANT_USECASE_CONFIG = [\n  {\n    id: 'assistant',\n    label: 'Assistant',\n    description:\n      'Ask questions and run operations on the current screen — answers from the docs and makes API calls for you',\n    suggestions: [\n      'What can I do on this screen?',\n      'Create a new vibe called demo',\n      'List my recent sessions',\n      'How do tunnels work?',\n    ],\n  },\n  {\n    id: 'api-calls',\n    label: 'API Calls',\n    description: 'Make API calls in context with the active product and your credentials',\n    suggestions: [\n      'Show me all API endpoints for sessions',\n      'How do I create an agent via the API?',\n      'List vibes using the REST API',\n      'What headers are needed for authentication?',\n    ],\n  },\n  {\n    id: 'vibe-plugins',\n    label: 'Vibe Plugins',\n    description: 'Build and learn about Vibe Plugins for extending VibeControls',\n    suggestions: [\n      'How do I create a new Vibe Plugin?',\n      'What is the plugin manifest structure?',\n      'Explain the plugin lifecycle hooks',\n      'Show me a plugin example with frontend UI',\n    ],\n  },\n  {\n    id: 'general',\n    label: 'General',\n    description: 'General help with VibeControls concepts and features',\n    suggestions: [\n      'What is a Vibe in VibeControls?',\n      'How do agents connect to the platform?',\n      'Explain the session lifecycle',\n      'What are tunnels used for?',\n    ],\n  },\n] as const;\n\nexport type AssistantUsecaseId = (typeof ASSISTANT_USECASE_CONFIG)[number]['id'];\n"],"mappings":";AAAA,IAAa,IAA2B;CACtC;EACE,IAAI;EACJ,OAAO;EACP,aACE;EACF,aAAa;GACX;GACA;GACA;GACA;GACD;EACF;CACD;EACE,IAAI;EACJ,OAAO;EACP,aAAa;EACb,aAAa;GACX;GACA;GACA;GACA;GACD;EACF;CACD;EACE,IAAI;EACJ,OAAO;EACP,aAAa;EACb,aAAa;GACX;GACA;GACA;GACA;GACD;EACF;CACD;EACE,IAAI;EACJ,OAAO;EACP,aAAa;EACb,aAAa;GACX;GACA;GACA;GACA;GACD;EACF;CACF"}
+{"version":3,"file":"assistantUsecases.js","names":[],"sources":["../../src/config/assistantUsecases.ts"],"sourcesContent":["/**\n * VibeControls AI assistant modes.\n *\n * ★ These are the modes the shared fe-libs panel OFFERS. The panel filters them\n * again at runtime: a `requiresAdmin` mode is shown only to a confirmed org\n * Owner/Admin (`myRoles`), and the first switch into a `writeCapable` mode opens\n * the one-time consent dialog. Both are enforced in fe-libs\n * (`shared/assistant/ui/AssistantChatArea`); what is decided HERE is which modes\n * carry the flags. Same mechanism as HealthyBowl's `assistantUsecases.ts`.\n *\n *   assistant     \"Ask\". Every member. The sandbox runs with\n *                 AI_ASSISTANT_READONLY, so its GraphQL helper refuses mutations.\n *   api-calls     \"Take action\". Admins only. Writes through the gateway, and\n *                 the sandbox runs with AI_ASSISTANT_CONFIRM_WRITES, so each\n *                 write waits for the user's approval.\n *   vibe-plugins  \"Build\". Admins only. Builds plugin artifacts, but its sandbox\n *                 is NOT read-only; see the note on BUILD below. Not flagged\n *                 `writeCapable` (yet), for the reason given there.\n *\n * ★★ `general` is gone. A stored `general`, or any mode not listed here, lands\n * on Ask; see `resolveOfferedMode` and `useOfferedAssistantMode`.\n *\n * ★ The mode IDs are transport values and must not be renamed: they choose the\n * sandbox image, its environment and the agent's persona. Only labels change.\n */\n\nexport interface AssistantUsecase {\n  id: string;\n  label: string;\n  description: string;\n  suggestions: readonly string[];\n  /** Only offered to a global Owner/Admin (see fe-libs `useAssistantApiAccess`). */\n  requiresAdmin?: boolean;\n  /** Can change live data, so the consent dialog and the composer's write-access warning apply. */\n  writeCapable?: boolean;\n}\n\n/**\n * \"Ask\": read-only, for everyone.\n *\n * ★★ The copy must not promise a write. This mode's sandbox refuses every\n * mutation, so \"Create a new vibe called demo\", the suggestion it used to carry,\n * could only ever end in a refusal after the user had waited for a sandbox.\n * `assistantUsecases.test.ts` fails on write verbs anywhere in this copy.\n */\nconst ASK = {\n  id: 'assistant',\n  label: 'Ask',\n  description:\n    'Ask about VibeControls and your workspace. It reads your vibes, sessions and agents, explains what you are looking at and points you to the right page. Read-only.',\n  suggestions: [\n    'What can I do on this screen?',\n    'List my recent sessions',\n    'Where do I manage my agents?',\n    'How do tunnels work?',\n  ],\n} as const satisfies AssistantUsecase;\n\n/** \"Take action\": the write mode. Admin-only, consent on first switch, approval per write. */\nconst TAKE_ACTION = {\n  // Display label only; the mode ID stays 'api-calls'.\n  id: 'api-calls',\n  label: 'Take action',\n  description:\n    'Let the assistant make changes for you: create vibes, rename them, stop sessions. It shows you each change and waits for your approval before anything is saved.',\n  suggestions: [\n    'Create a new vibe called demo',\n    'Rename one of my vibes',\n    'Stop a session I no longer need',\n    'List my recent sessions',\n  ],\n  requiresAdmin: true,\n  writeCapable: true,\n} as const satisfies AssistantUsecase;\n\n/**\n * \"Build\": Vibe Plugin authoring. Admin-only.\n *\n * ★★ Why admin-only, when its job is producing plugin files: the sandbox is\n * not confined to that job, and can write.\n *   - fe-libs forwards the user's own access and workspace tokens on EVERY proxy\n *     request, whatever the mode (`shared/assistant/api.ts`, `proxyToSandbox`).\n *   - wspace-sandbox-svc passes them into the sandbox for every assistant mode\n *     (`ensureAssistantProxyAccess`, `X-AI-Assistant-Auth-Token`).\n *   - ai-assistant keeps them whenever the sandbox holds no delegated app\n *     credentials, which `vibe-plugins` never does (proxy-token auth), and its\n *     GraphQL helper then authenticates as the user (`api-auth.ts`).\n *   - The mode has `bash`, the gateway URLs are in its environment, and it gets\n *     NEITHER brake: AI_ASSISTANT_READONLY is set only for `assistant`,\n *     AI_ASSISTANT_CONFIRM_WRITES only for `api-calls`.\n * So it can change workspace data within the user's own permissions, and\n * decision D4 makes every such mode admin-only.\n *\n * ★★ Why NOT `writeCapable`, although it can write: in fe-libs (2026.914.3 and\n * earlier) that flag routes the first switch into the mode through\n * `AssistantApiCallsConsentDialog`, whose copy is written for Take action only.\n * It is titled \"Switch to Take action mode?\", its button reads \"Enable Take\n * action\", and it promises the assistant will ask before making a change. For\n * Build all three are false: no AI_ASSISTANT_CONFIRM_WRITES, no confirm\n * preamble. Its one `apiCallsAcknowledged` flag also covers every\n * `writeCapable` mode, so accepting it from Build would skip Take action's real\n * consent. Showing no dialog is more honest than showing that one. The cost:\n * the composer's write-access warning (`writeAccessDenied`) no longer shows in\n * Build. Restore the flag once fe-libs words the dialog, and keeps the\n * acknowledgment, per mode; `assistantUsecases.test.ts` fails when the dialog\n * stops naming Take action, as a reminder.\n *\n * ★ The flags gate the UI; they add no sandbox brake. That is why this copy\n * claims no approval step for the mode: the sandbox does not enforce one.\n */\nconst BUILD = {\n  id: 'vibe-plugins',\n  label: 'Build',\n  description:\n    'Build a Vibe Plugin that extends VibeControls. The assistant scaffolds and compiles it from the platform guides and gives you the files to download.',\n  suggestions: [\n    'How do I create a new Vibe Plugin?',\n    'What is the plugin manifest structure?',\n    'Explain the plugin lifecycle hooks',\n    'Show me a plugin example with frontend UI',\n  ],\n  requiresAdmin: true,\n} as const satisfies AssistantUsecase;\n\nexport const ASSISTANT_USECASE_CONFIG = [ASK, TAKE_ACTION, BUILD] as const;\n\nexport type AssistantUsecaseId = (typeof ASSISTANT_USECASE_CONFIG)[number]['id'];\n\n/**\n * Where a user lands when their mode is not offered.\n *\n * ★ The same literal fe-libs falls back to (`AssistantChatArea` resets to\n * `\"assistant\"` once the role check settles). Typed as a mode ID, so removing\n * Ask from the list above fails the typecheck here.\n */\nexport const DEFAULT_ASSISTANT_MODE: AssistantUsecaseId = 'assistant';\n\nfunction isOfferedMode(mode: unknown): mode is AssistantUsecaseId {\n  return ASSISTANT_USECASE_CONFIG.some((config) => config.id === mode);\n}\n\n/**\n * The mode to use for a stored one: itself when this product offers it, Ask\n * when it does not (a retired `general`, another product's mode, a corrupt\n * value).\n *\n * ★ It answers only \"does this mode EXIST here\". Whether the user may use an\n * admin-only mode is the role check's question and stays with fe-libs: resetting\n * an admin's stored Take action here, before `myRoles` answers, would throw them\n * out of that mode on every reload.\n */\nexport function resolveOfferedMode(mode: unknown): AssistantUsecaseId {\n  return isOfferedMode(mode) ? mode : DEFAULT_ASSISTANT_MODE;\n}\n"],"mappings":"AA4HA,IAAa,IAA2B;CA/E5B;EACV,IAAI;EACJ,OAAO;EACP,aACE;EACF,aAAa;GACX;GACA;GACA;GACA;GACD;EACF;CAGmB;EAElB,IAAI;EACJ,OAAO;EACP,aACE;EACF,aAAa;GACX;GACA;GACA;GACA;GACD;EACD,eAAe;EACf,cAAc;EACf;CAqCa;EACZ,IAAI;EACJ,OAAO;EACP,aACE;EACF,aAAa;GACX;GACA;GACA;GACA;GACD;EACD,eAAe;EAChB;CAEgE,EAWpD,IAA6C;AAE1D,SAAS,EAAc,GAA2C;AAChE,QAAO,EAAyB,MAAM,MAAW,EAAO,OAAO,EAAK;;AAatE,SAAgB,EAAmB,GAAmC;AACpE,QAAO,EAAc,EAAK,GAAG,IAAO"}