@inneranimalmedia/agentsam-sdk 2.6.5 → 2.6.8

package/apps/client-cms-editor/bin/agentsam-cms.js

@@ -0,0 +1,262 @@
+#!/usr/bin/env node
+/**
+ * AgentSam CMS CLI — scaffold / import theme / local multipage runtime.
+ * Bin entry must remain a plain relative .js path so npm publish keeps it.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+
+const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const sdkRoot = path.resolve(packageRoot, '../..');
+const manifestPath = path.join(packageRoot, 'agentsam.app.json');
+const PERSISTENCE = new Set(['sqlite', 'd1']);
+const STARTERS = new Set(['heuristic', 'blank', 'iasf', 'import']);
+
+function usage() {
+  console.log(`
+AgentSam website + CMS kit
+
+  agentsam-cms --help
+  agentsam-cms info
+  agentsam-cms doctor
+  agentsam-cms create <directory> --starter heuristic|blank|iasf|import [--theme <path>] [--persistence sqlite|d1]
+  agentsam-cms import-theme <sourceDirOrZip> --out <theme-pack-dir>
+  agentsam-cms dev [--db <sqlitePath>] [--site <siteId>] [--port 4317]
+  agentsam-cms scaffold <directory> [--persistence sqlite|d1]   (legacy alias of create --starter heuristic)
+  agentsam-cms preview
+
+Local-first:
+  create → SQLite + starter/theme → agentsam-cms dev
+  → http://localhost:4317/        public multipage site
+  → http://localhost:4317/cms     protected CMS surface
+`.trim());
+}
+
+function info() {
+  console.log(JSON.stringify(JSON.parse(fs.readFileSync(manifestPath, 'utf8')), null, 2));
+}
+
+function doctor() {
+  const required = ['frontend', 'backend', 'shared', 'bin', 'package.json', 'agentsam.app.json', 'dist'];
+  const missing = required.filter((rel) => !fs.existsSync(path.join(packageRoot, rel)));
+  if (missing.length) {
+    console.error('doctor failed; missing:', missing.join(', '));
+    process.exit(1);
+  }
+  for (const rel of ['dist/index.js', 'dist/sqlite-adapter.js', 'dist/import/index.js', 'dist/local/index.js']) {
+    if (!fs.existsSync(path.join(packageRoot, rel))) {
+      console.error(`doctor failed; run npm run build (missing ${rel})`);
+      process.exit(1);
+    }
+  }
+  console.log('✓ client-cms-editor layout ok');
+}
+
+async function loadDist(rel) {
+  return import(pathToFileURL(path.join(packageRoot, rel)).href);
+}
+
+function parseArgs(args) {
+  const out = { _: [] };
+  for (let i = 0; i < args.length; i += 1) {
+    const a = args[i];
+    if (a.startsWith('--')) {
+      const key = a.slice(2);
+      const val = args[i + 1] && !args[i + 1].startsWith('--') ? args[++i] : true;
+      out[key] = val;
+    } else {
+      out._.push(a);
+    }
+  }
+  return out;
+}
+
+async function importThemeCmd(args) {
+  const parsed = parseArgs(args);
+  const source = parsed._[0];
+  const outDir = parsed.out;
+  if (!source || !outDir) throw new Error('usage: agentsam-cms import-theme <source> --out <dir>');
+  const { importThemeFromSource } = await loadDist('dist/import/index.js');
+  const pack = importThemeFromSource(path.resolve(source), {
+    outDir: path.resolve(outDir),
+    packId: typeof parsed['pack-id'] === 'string' ? parsed['pack-id'] : undefined,
+  });
+  console.log(`✓ imported theme → ${path.resolve(outDir)}`);
+  console.log(`  pages: ${pack.manifest.pages.join(', ')}`);
+  console.log(`  assets: ${pack.manifest.assetCount} · donor candidates: ${pack.donorCandidates.length}`);
+}
+
+async function createCmd(args) {
+  const parsed = parseArgs(args);
+  const target = parsed._[0];
+  if (!target) throw new Error('create requires a target directory');
+  const starter = String(parsed.starter || 'heuristic');
+  if (!STARTERS.has(starter)) throw new Error(`unsupported starter "${starter}"; choose heuristic|blank|iasf|import`);
+  const persistence = String(parsed.persistence || 'sqlite');
+  if (!PERSISTENCE.has(persistence)) {
+    throw new Error(`unsupported persistence "${persistence}"; choose sqlite or d1`);
+  }
+  if (starter === 'import' && !parsed.theme) {
+    throw new Error('create --starter import requires --theme <directory-or-zip>');
+  }
+
+  const targetRoot = path.resolve(process.cwd(), target);
+  if (fs.existsSync(targetRoot) && fs.readdirSync(targetRoot).length) {
+    throw new Error(`target directory is not empty: ${targetRoot}`);
+  }
+  fs.mkdirSync(targetRoot, { recursive: true });
+  fs.mkdirSync(path.join(targetRoot, '.agentsam', 'assets'), { recursive: true });
+  fs.mkdirSync(path.join(targetRoot, 'public'), { recursive: true });
+
+  const cfg = {
+    schema: 'agentsam.cms.project.v1',
+    starter,
+    persistence,
+    siteId: starter === 'import' ? 'imported' : starter,
+    dbPath: '.agentsam/cms.sqlite',
+    assetsDir: '.agentsam/assets',
+    port: 4317,
+    cmsBase: '/cms',
+    auth: { mode: 'local-dev-principal' },
+  };
+  fs.writeFileSync(path.join(targetRoot, 'cms.config.json'), `${JSON.stringify(cfg, null, 2)}\n`);
+  fs.writeFileSync(
+    path.join(targetRoot, 'agentsam.app.json'),
+    `${JSON.stringify(
+      {
+        schema: 'agentsam.app.v1',
+        id: path.basename(targetRoot),
+        product_id: 'cms',
+        name: path.basename(targetRoot),
+        kind: 'customer-site',
+        package: '@inneranimalmedia/client-cms-editor',
+      },
+      null,
+      2,
+    )}\n`,
+  );
+
+  if (persistence !== 'sqlite') {
+    console.log(`✓ created project shell at ${targetRoot} (persistence=${persistence})`);
+    console.log('  connect a CmsEditorAdapter before dev; local SQLite path skipped');
+    return;
+  }
+
+  const { SqliteCmsAdapter } = await loadDist('dist/sqlite-adapter.js');
+  const rootMod = await loadDist('dist/index.js');
+  const { installStarterPack } = rootMod;
+  const dbPath = path.join(targetRoot, cfg.dbPath);
+  const adapter = new SqliteCmsAdapter(dbPath);
+  try {
+    let pack;
+    if (starter === 'heuristic') {
+      pack = rootMod.heuristicStarterPack;
+    } else if (starter === 'blank') {
+      pack = rootMod.blankStarterPack;
+    } else if (starter === 'iasf') {
+      pack = rootMod.iasfStarterPack;
+      if (!pack) throw new Error('iasfStarterPack export missing — rebuild client-cms-editor');
+    } else {
+      const { importThemeFromSource } = await loadDist('dist/import/index.js');
+      const themeOut = path.join(targetRoot, 'starter', 'imported-theme-pack');
+      const themePack = importThemeFromSource(path.resolve(String(parsed.theme)), {
+        outDir: themeOut,
+        packId: 'imported',
+      });
+      pack = themePack.starterPack;
+      cfg.themePack = 'starter/imported-theme-pack';
+      fs.writeFileSync(path.join(targetRoot, 'cms.config.json'), `${JSON.stringify(cfg, null, 2)}\n`);
+    }
+
+    const installed = await installStarterPack(adapter, pack, { siteId: cfg.siteId });
+    for (const pageId of installed.pageIds) {
+      await adapter.publish(pageId);
+    }
+    console.log(`✓ created ${starter} project at ${targetRoot}`);
+    console.log(`  sqlite: ${cfg.dbPath}`);
+    console.log(`  pages published: ${installed.pageIds.length}`);
+    console.log(`  next: cd ${target} && npx agentsam-cms dev`);
+  } finally {
+    adapter.close();
+  }
+}
+
+async function devCmd(args) {
+  const parsed = parseArgs(args);
+  const cwd = process.cwd();
+  const cfgPath = path.join(cwd, 'cms.config.json');
+  const cfg = fs.existsSync(cfgPath) ? JSON.parse(fs.readFileSync(cfgPath, 'utf8')) : {};
+  const dbPath = path.resolve(cwd, String(parsed.db || cfg.dbPath || '.agentsam/cms.sqlite'));
+  const siteId = String(parsed.site || cfg.siteId || 'heuristic');
+  const port = Number(parsed.port || cfg.port || 4317);
+
+  if (!fs.existsSync(dbPath)) {
+    throw new Error(`sqlite db missing at ${dbPath} — run agentsam-cms create first`);
+  }
+
+  const { SqliteCmsAdapter } = await loadDist('dist/sqlite-adapter.js');
+  const { startLocalCmsRuntime } = await loadDist('dist/local/index.js');
+  const adapter = new SqliteCmsAdapter(dbPath);
+  const runtime = await startLocalCmsRuntime({
+    adapter,
+    siteId,
+    port,
+    cmsBase: cfg.cmsBase || '/cms',
+  });
+  console.log(`✓ local CMS runtime`);
+  console.log(`  public  ${runtime.origin}/`);
+  console.log(`  cms     ${runtime.origin}/cms`);
+  console.log(`  sqlite  ${dbPath}`);
+  console.log('  Ctrl+C to stop');
+
+  const shutdown = async () => {
+    await runtime.close();
+    adapter.close();
+    process.exit(0);
+  };
+  process.on('SIGINT', shutdown);
+  process.on('SIGTERM', shutdown);
+}
+
+function preview(args) {
+  const pkg = JSON.parse(fs.readFileSync(path.join(packageRoot, 'package.json'), 'utf8'));
+  const script = pkg.scripts?.preview ? 'preview' : pkg.scripts?.dev ? 'dev' : null;
+  if (!script) {
+    console.error('no preview/dev script in package.json');
+    process.exit(1);
+  }
+  const npmCmd = process.platform === 'win32' ? 'npm.cmd' : 'npm';
+  const result = spawnSync(npmCmd, ['run', script, '--', ...args], {
+    cwd: packageRoot,
+    stdio: 'inherit',
+    shell: process.platform === 'win32',
+  });
+  process.exit(result.status ?? 1);
+}
+
+function scaffoldLegacy(args) {
+  const parsed = parseArgs(args);
+  return createCmd([parsed._[0], '--starter', 'heuristic', '--persistence', parsed.persistence || 'sqlite'].filter(Boolean));
+}
+
+const [cmd = 'help', ...rest] = process.argv.slice(2);
+try {
+  if (cmd === '--help' || cmd === '-h' || cmd === 'help') usage();
+  else if (cmd === 'info') info();
+  else if (cmd === 'doctor') doctor();
+  else if (cmd === 'create') await createCmd(rest);
+  else if (cmd === 'import-theme') await importThemeCmd(rest);
+  else if (cmd === 'dev') await devCmd(rest);
+  else if (cmd === 'scaffold') await scaffoldLegacy(rest);
+  else if (cmd === 'preview') preview(rest);
+  else {
+    console.error(`unknown command: ${cmd}`);
+    usage();
+    process.exit(1);
+  }
+} catch (err) {
+  console.error(String(err?.message || err));
+  process.exit(1);
+}

package/apps/client-cms-editor/bin/agentsam-cms.mjs

@@ -1,229 +1,3 @@
 #!/usr/bin/env node
-import fs from 'node:fs';
-import path from 'node:path';
-import { spawnSync } from 'node:child_process';
-import { fileURLToPath } from 'node:url';
-
-const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
-const sdkRoot = path.resolve(packageRoot, '../..');
-const manifestPath = path.join(packageRoot, 'agentsam.app.json');
-const PERSISTENCE = new Set(['sqlite', 'd1', 'localStorage']);
-
-function usage() {
-  console.log(`
-AgentSam CMS Editor
-
-  agentsam-cms [preview]
-  agentsam-cms info
-  agentsam-cms doctor
-  agentsam-cms scaffold <directory> [--persistence sqlite|d1|localStorage]
-
-preview
-  Run the app preview script when present.
-
-info
-  Print the AgentSam app manifest.
-
-doctor
-  Verify frontend/backend/shared layout.
-
-scaffold
-  Copy editable source into a new directory.
-  sqlite       local authority for desktop/offline use
-  d1           cloud authority through the CMS API
-  localStorage browser draft cache only; never authoritative
-`.trim());
-}
-
-function info() {
-  console.log(JSON.stringify(JSON.parse(fs.readFileSync(manifestPath, 'utf8')), null, 2));
-}
-
-function doctor() {
-  const required = ['frontend', 'backend', 'shared', 'bin', 'package.json', 'agentsam.app.json'];
-  const missing = required.filter((rel) => !fs.existsSync(path.join(packageRoot, rel)));
-  if (missing.length) {
-    console.error('doctor failed; missing:', missing.join(', '));
-    process.exit(1);
-  }
-  console.log('✓ client-cms-editor layout ok');
-}
-
-function parseScaffoldArgs(args) {
-  const target = args[0];
-  let persistence = 'sqlite';
-  for (let i = 1; i < args.length; i += 1) {
-    if (args[i] === '--persistence') {
-      persistence = String(args[i + 1] || '').trim();
-      i += 1;
-    }
-  }
-  if (!PERSISTENCE.has(persistence)) {
-    throw new Error(`unsupported persistence "${persistence}"; choose sqlite, d1, or localStorage`);
-  }
-  return { target, persistence };
-}
-
-const COPY_SKIP = new Set(['node_modules', 'dist', 'coverage', '.git', '.wrangler', '.agentsam']);
-
-function copySource(source, target) {
-  fs.cpSync(source, target, {
-    recursive: true,
-    filter(candidate) {
-      if (candidate === source) return true;
-      return !candidate
-        .split(path.sep)
-        .some((part) => COPY_SKIP.has(part));
-    },
-  });
-}
-
-function readJson(file) {
-  return JSON.parse(fs.readFileSync(file, 'utf8'));
-}
-
-function writeJson(file, value) {
-  fs.writeFileSync(file, `${JSON.stringify(value, null, 2)}
-`);
-}
-
-function makeStandaloneWorkspace(targetRoot) {
-  const rootPackage = path.join(targetRoot, 'package.json');
-  const rootPkg = readJson(rootPackage);
-  rootPkg.workspaces = [...new Set([...(rootPkg.workspaces || []), 'packages/*'])];
-  writeJson(rootPackage, rootPkg);
-
-  const packageFiles = [
-    path.join(targetRoot, 'frontend/package.json'),
-    path.join(targetRoot, 'shared/cms/package.json'),
-  ];
-  for (const file of packageFiles) {
-    if (!fs.existsSync(file)) continue;
-    const pkg = readJson(file);
-    for (const section of ['dependencies', 'devDependencies']) {
-      if (!pkg[section]) continue;
-      for (const name of [
-        '@inneranimalmedia/agentsam-contracts',
-        '@inneranimalmedia/agentsam-workbench',
-      ]) {
-        if (pkg[section][name]?.startsWith?.('file:')) pkg[section][name] = '0.1.0';
-      }
-    }
-    writeJson(file, pkg);
-  }
-}
-
-function runtimeConfig(persistence) {
-  if (persistence === 'sqlite') {
-    return {
-      schema: 'agentsam.cms.runtime.v1',
-      app_id: 'client-cms-editor',
-      run_target: 'local',
-      authority: 'sqlite',
-      cache: 'localStorage',
-      cache_only: false,
-    };
-  }
-  if (persistence === 'd1') {
-    return {
-      schema: 'agentsam.cms.runtime.v1',
-      app_id: 'client-cms-editor',
-      run_target: 'cloudflare',
-      authority: 'd1',
-      cache: 'localStorage',
-      cache_only: false,
-    };
-  }
-  return {
-    schema: 'agentsam.cms.runtime.v1',
-    app_id: 'client-cms-editor',
-    run_target: 'browser',
-    authority: null,
-    cache: 'localStorage',
-    cache_only: true,
-    note: 'localStorage is a draft/offline cache only; configure SQLite or D1 before authoritative publish.',
-  };
-}
-
-function scaffold(targetArg, { persistence = 'sqlite' } = {}) {
-  if (!targetArg) throw new Error('scaffold requires a target directory');
-  const targetRoot = path.resolve(process.cwd(), targetArg);
-  if (fs.existsSync(targetRoot) && fs.readdirSync(targetRoot).length) {
-    throw new Error(`target directory is not empty: ${targetRoot}`);
-  }
-  fs.mkdirSync(targetRoot, { recursive: true });
-
-  for (const relative of [
-    'frontend',
-    'backend',
-    'shared',
-    'bin',
-    '.gitignore',
-    'package.json',
-    'README.md',
-    'agentsam.app.json',
-    'IMPORT_PROVENANCE.json',
-  ]) {
-    const source = path.join(packageRoot, relative);
-    if (!fs.existsSync(source)) continue;
-    copySource(source, path.join(targetRoot, relative));
-  }
-
-  const portablePackages = [
-    'agentsam-contracts',
-    'agentsam-workbench',
-  ];
-  for (const name of portablePackages) {
-    const source = path.join(sdkRoot, 'packages', name);
-    if (!fs.existsSync(source)) {
-      throw new Error(`required scaffold package missing: packages/${name}`);
-    }
-    copySource(source, path.join(targetRoot, 'packages', name));
-  }
-  makeStandaloneWorkspace(targetRoot);
-
-  const stateDir = path.join(targetRoot, '.agentsam');
-  fs.mkdirSync(stateDir, { recursive: true });
-  fs.writeFileSync(
-    path.join(stateDir, 'cms-runtime.json'),
-    `${JSON.stringify(runtimeConfig(persistence), null, 2)}\n`,
-  );
-
-  console.log(`✓ scaffolded CMS editor into ${targetRoot}`);
-  console.log(`  persistence: ${persistence}${persistence === 'localStorage' ? ' (cache only)' : ''}`);
-}
-
-function preview(args) {
-  const pkg = JSON.parse(fs.readFileSync(path.join(packageRoot, 'package.json'), 'utf8'));
-  const script = pkg.scripts?.preview ? 'preview' : pkg.scripts?.dev ? 'dev' : null;
-  if (!script) {
-    console.error('no preview/dev script in package.json');
-    process.exit(1);
-  }
-  const npmCmd = process.platform === 'win32' ? 'npm.cmd' : 'npm';
-  const result = spawnSync(npmCmd, ['run', script, '--', ...args], {
-    cwd: packageRoot,
-    stdio: 'inherit',
-    shell: process.platform === 'win32',
-  });
-  process.exit(result.status ?? 1);
-}
-
-const [cmd = 'preview', ...rest] = process.argv.slice(2);
-try {
-  if (cmd === '--help' || cmd === '-h' || cmd === 'help') usage();
-  else if (cmd === 'info') info();
-  else if (cmd === 'doctor') doctor();
-  else if (cmd === 'scaffold') {
-    const { target, persistence } = parseScaffoldArgs(rest);
-    scaffold(target, { persistence });
-  } else if (cmd === 'preview') preview(rest);
-  else {
-    console.error(`unknown command: ${cmd}`);
-    usage();
-    process.exit(1);
-  }
-} catch (err) {
-  console.error(String(err?.message || err));
-  process.exit(1);
-}
+/** Re-export shim — canonical CLI entry is agentsam-cms.js (npm-publish safe). */
+import './agentsam-cms.js';

package/apps/client-cms-editor/frontend/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@inneranimalmedia/agentsam-cms-frontend",
-  "version": "0.1.0",
-  "private": true,
+  "version": "2.6.7",
+  "description": "Internal CMS frontend (bundled into @inneranimalmedia/client-cms-editor — not published separately).",
   "type": "module",
   "exports": {
     ".": "./src/index.ts",
@@ -15,10 +15,8 @@
     "test": "vitest run --passWithNoTests"
   },
   "dependencies": {
-    "@inneranimalmedia/agentsam-cms-backend": "0.1.0",
-    "@inneranimalmedia/agentsam-cms-shared": "0.1.0",
-    "@inneranimalmedia/agentsam-contracts": "file:../../../packages/agentsam-contracts",
-    "@inneranimalmedia/agentsam-workbench": "file:../../../packages/agentsam-workbench",
+    "@inneranimalmedia/agentsam-cms-backend": "2.6.7",
+    "@inneranimalmedia/agentsam-cms-shared": "2.6.7",
     "react": "^19.2.0",
     "react-dom": "^19.2.0"
   },
@@ -29,5 +27,16 @@
     "typescript": "^5.9.3",
     "vite": "^6.4.3",
     "vitest": "^4.1.11"
-  }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SamPrimeaux/agentsam-sdk.git",
+    "directory": "apps/client-cms-editor/frontend"
+  },
+  "files": [
+    "src"
+  ]
 }

package/apps/client-cms-editor/frontend/src/AgentSamDrawer.tsx

@@ -1,14 +1,9 @@
-import { useEffect, useMemo, useRef, useState } from 'react';
-import type { AgentPrincipal, AgentWorkbenchAdapter } from '@inneranimalmedia/agentsam-contracts';
-import { ConnectedAgentPanel } from '@inneranimalmedia/agentsam-workbench/agent';
-import { createCmsAgentContextProvider } from '@inneranimalmedia/agentsam-cms-shared';
+import { useEffect, useRef, useState } from 'react';
 import './styles/agentsam-drawer.css';
 
 export type AgentSamDrawerProps = {
   open: boolean;
   onClose: () => void;
-  adapter?: AgentWorkbenchAdapter | null;
-  principal?: AgentPrincipal | null;
   projectId: string;
   conversationId: string;
   route?: string;
@@ -18,40 +13,22 @@ export type AgentSamDrawerProps = {
   selectionLabel?: string | null;
   pendingPrompt?: string | null;
   onPendingPromptConsumed?: () => void;
+  /** Host-provided live AgentSam panel; when omitted, demo shell is shown. */
+  children?: React.ReactNode;
 };
 
 /**
- * FnF-style AgentSam Side Assistant — docked slide-in chat.
- * Ports fuelnfreetime admin agentsam drawer UX into the CMS editor shell.
+ * CMS side-assistant chrome. Live AgentSam UI is injected by the host via children.
+ * Core package never imports agentsam-workbench.
  */
 export function AgentSamDrawer({
   open,
   onClose,
-  adapter,
-  principal,
-  projectId,
-  conversationId,
-  route,
-  pageId,
-  sectionId,
-  blockId,
   selectionLabel,
   pendingPrompt,
   onPendingPromptConsumed,
+  children,
 }: AgentSamDrawerProps) {
-  const contextProvider = useMemo(() => createCmsAgentContextProvider(() => ({
-    principal: principal || {
-      accountId: 'demo',
-      authUserId: 'demo',
-      displayName: 'Demo',
-    },
-    projectId,
-    route,
-    pageId,
-    sectionId,
-    blockId,
-  })), [principal, projectId, route, pageId, sectionId, blockId]);
-
   const status = selectionLabel
     ? `Editing “${selectionLabel}”`
     : 'Context-aware admin chat';
@@ -84,16 +61,7 @@ export function AgentSamDrawer({
           </button>
         </header>
 
-        {adapter ? (
-          <ConnectedAgentPanel
-            className="agentsam-connected"
-            adapter={adapter}
-            contextProvider={contextProvider}
-            conversationId={conversationId}
-            header={null}
-            empty={<div className="agentsam-empty">Ask about this page, sections, or publish flow. I’ll use the current CMS selection.</div>}
-          />
-        ) : (
+        {children || (
           <DemoDrawerChat
             selectionLabel={selectionLabel}
             pendingPrompt={pendingPrompt}
@@ -117,7 +85,7 @@ function DemoDrawerChat({
   const [messages, setMessages] = useState<{ role: 'user' | 'assistant'; text: string }[]>([
     {
       role: 'assistant',
-      text: 'Ask about this page, store operations, customers, content, or repository work. I’ll route the request using the current CMS context.',
+      text: 'Ask about this page or content. Bind a host AgentSam panel to run live tools — this shell is chrome only.',
     },
   ]);
   const [value, setValue] = useState('');
@@ -147,7 +115,7 @@ function DemoDrawerChat({
       ...prev,
       {
         role: 'assistant',
-        text: `Got it${scope}. In demo mode this drawer mirrors the FnF Side Assistant — bind an AgentSam adapter to run live tools.`,
+        text: `Got it${scope}. No AgentSam host is attached — provide CmsAgentHost.renderDrawer from the consumer to enable live tools.`,
       },
     ]);
     setBusy(false);