@inneranimalmedia/agentsam-sdk 2.6.4 → 2.6.7

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

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+/** Re-export shim — canonical CLI entry is agentsam-cms.js (npm-publish safe). */
+import './agentsam-cms.js';

package/apps/client-cms-editor/frontend/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>AgentSam CMS Studio</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

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

@@ -0,0 +1,42 @@
+{
+  "name": "@inneranimalmedia/agentsam-cms-frontend",
+  "version": "2.6.7",
+  "description": "Internal CMS frontend (bundled into @inneranimalmedia/client-cms-editor — not published separately).",
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts",
+    "./styles/studio.css": "./src/styles/studio.css"
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "preview": "vite preview",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run --passWithNoTests"
+  },
+  "dependencies": {
+    "@inneranimalmedia/agentsam-cms-backend": "2.6.7",
+    "@inneranimalmedia/agentsam-cms-shared": "2.6.7",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.0",
+    "@types/react-dom": "^19.2.0",
+    "@vitejs/plugin-react": "^5.0.4",
+    "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

@@ -0,0 +1,156 @@
+import { useEffect, useRef, useState } from 'react';
+import './styles/agentsam-drawer.css';
+
+export type AgentSamDrawerProps = {
+  open: boolean;
+  onClose: () => void;
+  projectId: string;
+  conversationId: string;
+  route?: string;
+  pageId?: string | null;
+  sectionId?: string | null;
+  blockId?: string | null;
+  selectionLabel?: string | null;
+  pendingPrompt?: string | null;
+  onPendingPromptConsumed?: () => void;
+  /** Host-provided live AgentSam panel; when omitted, demo shell is shown. */
+  children?: React.ReactNode;
+};
+
+/**
+ * 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,
+  selectionLabel,
+  pendingPrompt,
+  onPendingPromptConsumed,
+  children,
+}: AgentSamDrawerProps) {
+  const status = selectionLabel
+    ? `Editing “${selectionLabel}”`
+    : 'Context-aware admin chat';
+
+  return (
+    <aside
+      className={`agentsam-dock${open ? ' is-open' : ''}`}
+      id="agentsam-dock"
+      aria-hidden={open ? 'false' : 'true'}
+      data-annotation-control=""
+    >
+      <div className="agentsam-drawer drawer-mounted" aria-label="AgentSam Side Assistant">
+        <header className="agentsam-head">
+          <div className="agentsam-brand">
+            <div className="agentsam-mark" aria-hidden="true">
+              <svg width="18" height="18" viewBox="0 0 24 24" fill="none">
+                <path d="M12 3l1.6 4.4L18 9l-4.4 1.6L12 15l-1.6-4.4L6 9l4.4-1.6z" stroke="currentColor" strokeWidth="1.5" strokeLinejoin="round" />
+              </svg>
+            </div>
+            <div>
+              <strong>AgentSam Side Assistant</strong>
+              <span>{status}</span>
+            </div>
+          </div>
+          <button type="button" className="agentsam-close" onClick={onClose} aria-label="Close AgentSam Side Assistant">
+            <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round">
+              <path d="M18 6 6 18" />
+              <path d="m6 6 12 12" />
+            </svg>
+          </button>
+        </header>
+
+        {children || (
+          <DemoDrawerChat
+            selectionLabel={selectionLabel}
+            pendingPrompt={pendingPrompt}
+            onPendingPromptConsumed={onPendingPromptConsumed}
+          />
+        )}
+      </div>
+    </aside>
+  );
+}
+
+function DemoDrawerChat({
+  selectionLabel,
+  pendingPrompt,
+  onPendingPromptConsumed,
+}: {
+  selectionLabel?: string | null;
+  pendingPrompt?: string | null;
+  onPendingPromptConsumed?: () => void;
+}) {
+  const [messages, setMessages] = useState<{ role: 'user' | 'assistant'; text: string }[]>([
+    {
+      role: 'assistant',
+      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('');
+  const [busy, setBusy] = useState(false);
+  const logRef = useRef<HTMLDivElement>(null);
+
+  useEffect(() => {
+    if (!pendingPrompt?.trim()) return;
+    void send(pendingPrompt);
+    onPendingPromptConsumed?.();
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [pendingPrompt]);
+
+  useEffect(() => {
+    logRef.current?.scrollTo({ top: logRef.current.scrollHeight });
+  }, [messages, busy]);
+
+  async function send(raw: string) {
+    const text = raw.trim();
+    if (!text || busy) return;
+    setBusy(true);
+    setValue('');
+    setMessages((prev) => [...prev, { role: 'user', text }]);
+    await new Promise((r) => setTimeout(r, 420));
+    const scope = selectionLabel ? ` for “${selectionLabel}”` : '';
+    setMessages((prev) => [
+      ...prev,
+      {
+        role: 'assistant',
+        text: `Got it${scope}. No AgentSam host is attached — provide CmsAgentHost.renderDrawer from the consumer to enable live tools.`,
+      },
+    ]);
+    setBusy(false);
+  }
+
+  return (
+    <>
+      <div className="agentsam-messages" ref={logRef} role="log" aria-live="polite">
+        {messages.map((msg, i) => (
+          <div key={`${msg.role}-${i}`} className={`agentsam-msg agentsam-msg--${msg.role}`}>
+            {msg.text}
+          </div>
+        ))}
+        {busy && <div className="agentsam-msg agentsam-msg--assistant agentsam-msg--typing">Thinking…</div>}
+      </div>
+      <form
+        className="agentsam-compose"
+        onSubmit={(event) => {
+          event.preventDefault();
+          void send(value);
+        }}
+      >
+        <textarea
+          rows={2}
+          placeholder="Ask anything…"
+          value={value}
+          onChange={(event) => setValue(event.target.value)}
+          disabled={busy}
+        />
+        <button type="submit" className="agentsam-send" disabled={busy || !value.trim()} aria-label="Send">
+          <svg width="16" height="16" viewBox="0 0 24 24" fill="none">
+            <path d="M5 12h13M12 5l7 7-7 7" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" />
+          </svg>
+        </button>
+      </form>
+    </>
+  );
+}

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

@@ -0,0 +1,36 @@
+import type { ReactNode } from 'react';
+
+export type CmsAgentSurfaceProps = {
+  projectId: string;
+  conversationId: string;
+  className?: string;
+  children?: ReactNode;
+  /**
+   * Host-provided agent / contextual composer surface.
+   * Core CMS never imports a workbench package; attach via CmsAgentHost in the consumer.
+   */
+  hostSurface?: ReactNode;
+};
+
+/**
+ * Optional agent surface slot. Without a host surface, renders a clear empty state.
+ */
+export function CmsAgentSurface({
+  className,
+  children,
+  hostSurface,
+}: CmsAgentSurfaceProps) {
+  if (hostSurface) {
+    return <div className={className} data-cms-agent-host="">{hostSurface}</div>;
+  }
+  return (
+    <div className={className} data-cms-agent-empty="">
+      {children || (
+        <p>
+          No agent host attached. Pass a host surface from the embedding application —
+          this package does not bundle an agent workbench.
+        </p>
+      )}
+    </div>
+  );
+}

package/apps/client-cms-editor/frontend/src/adapters/heuristic.ts

@@ -0,0 +1,29 @@
+import { MemoryCmsAdapter } from './memory';
+import { installStarterPack } from '../../../shared/cms/src/starter-pack';
+import {
+  HEURISTIC_STARTER_PACK_ID,
+  heuristicStarterPack,
+} from '../../../starter-packs/heuristic';
+
+/**
+ * Preview helper: install Heuristic into an in-memory adapter.
+ * The pack is a real starter; the adapter choice is what makes this temporary.
+ * Prefer installStarterPack(sqliteOrHttpAdapter, heuristicStarterPack) for durable first-run.
+ */
+export async function previewHeuristicStarter(siteId = HEURISTIC_STARTER_PACK_ID) {
+  const adapter = MemoryCmsAdapter.createEmpty();
+  const installed = await installStarterPack(adapter, heuristicStarterPack, { siteId });
+  return {
+    adapter,
+    siteId: installed.siteId,
+    pageId: installed.pageIds[0] || null,
+    pack: heuristicStarterPack,
+    /** Adapter is temporary — pack provenance remains builtin_starter. */
+    adapterTemporary: true as const,
+  };
+}
+
+/** @deprecated Use previewHeuristicStarter / installStarterPack(heuristicStarterPack). */
+export async function createHeuristicThemeMemoryAdapter(siteId = HEURISTIC_STARTER_PACK_ID) {
+  return previewHeuristicStarter(siteId);
+}