@inneranimalmedia/agentsam-sdk 2.6.5 → 2.6.8

package/apps/client-cms-editor/shared/cms/src/host.ts

@@ -0,0 +1,82 @@
+/**
+ * Optional capabilities supplied by the embedding host.
+ * The CMS remains independent of host navigation,
+ * identity authority, runtime, and deployment topology.
+ */
+
+/** Minimal authenticated identity the CMS needs for context metadata. */
+export type CmsHostPrincipal = {
+  /** Host-stable subject identifier (consumer maps its own user id here). */
+  subjectId: string;
+  accountId?: string;
+  displayName?: string;
+  email?: string;
+  metadata?: Record<string, unknown>;
+};
+
+export type CmsAgentSurfaceKind = 'cms' | string;
+
+/** Explicit CMS selection context passed to an optional agent host. */
+export type CmsAgentContext = {
+  surface: CmsAgentSurfaceKind;
+  accountId?: string;
+  subjectId?: string;
+  projectId?: string;
+  metadata?: {
+    route?: string | null;
+    pageId?: string | null;
+    sectionId?: string | null;
+    blockId?: string | null;
+    publicationRevision?: number | null;
+    [key: string]: unknown;
+  };
+};
+
+export type CmsAgentContextProvider = {
+  getContext(): CmsAgentContext | Promise<CmsAgentContext>;
+};
+
+/** Opaque annotation payload from a host mini-agent. */
+export type CmsAnnotationSelection = {
+  id?: string;
+  label?: string;
+  [key: string]: unknown;
+};
+
+export type CmsAgentDrawerSlotProps = {
+  open: boolean;
+  onClose: () => void;
+  projectId: string;
+  conversationId: string;
+  contextProvider: CmsAgentContextProvider;
+  route?: string;
+  pageId?: string | null;
+  sectionId?: string | null;
+  blockId?: string | null;
+  selectionLabel?: string | null;
+  pendingPrompt?: string | null;
+  onPendingPromptConsumed?: () => void;
+};
+
+export type CmsAgentMiniSlotProps = {
+  projectId: string;
+  conversationId: string;
+  contextProvider: CmsAgentContextProvider;
+  annotateSelecting?: boolean;
+  onAnnotateToggle?: () => void;
+  onAnnotateSubmit?: (
+    prompt: string,
+    annotation: CmsAnnotationSelection,
+  ) => void | Promise<void>;
+};
+
+/**
+ * Host/deployment capabilities supplied by the embedding application.
+ * Consumers implement these — the CMS package does not hardcode navigation or identity.
+ */
+export type CmsEditorHost = {
+  principal?: CmsHostPrincipal | null;
+  navigate?: (path: string) => void;
+  openExternal?: (url: string) => void;
+  labelTemporaryAdapter?: (message: string) => void;
+};

package/apps/client-cms-editor/shared/cms/src/index.ts

@@ -2,4 +2,8 @@ export * from './editor-types';
 export * from './publication';
 export * from './cloudflare-bindings';
 export * from './agent-context';
+export * from './host';
 export * from './routes';
+export * from './adapter';
+export * from './map';
+export * from './starter-pack';

package/apps/client-cms-editor/shared/cms/src/map.ts

@@ -0,0 +1,115 @@
+import type { CmsEditorBlock, CmsEditorPage, CmsEditorSection, CmsEditorSelection, CmsEditorSite } from './editor-types';
+
+type Json = Record<string, any>;
+
+export function parseCmsEditorObject(value: unknown): Record<string, any> {
+  if (!value) return {};
+  if (typeof value === 'object') return value as Record<string, any>;
+  try { return JSON.parse(String(value)); } catch { return {}; }
+}
+
+export function cmsEditorInitials(name: string) {
+  return name.split(/\s+/).filter(Boolean).slice(0, 2).map((part) => part[0]).join('').toUpperCase() || 'CMS';
+}
+
+function zoneFor(row: Json): CmsEditorSection['zone'] {
+  const fields = parseCmsEditorObject(row.section_data ?? row.data ?? row.fields);
+  const explicit = String(row.zone || fields.zone || '').toUpperCase();
+  if (explicit === 'HEADER' || explicit === 'FOOTER' || explicit === 'TEMPLATE') return explicit;
+  const type = String(row.section_type || row.type || '').toLowerCase();
+  if (type.includes('nav') || type.includes('header')) return 'HEADER';
+  if (type.includes('footer')) return 'FOOTER';
+  return 'BODY';
+}
+
+export function mapCmsEditorBlock(row: Json, sectionId = ''): CmsEditorBlock {
+  const data = parseCmsEditorObject(row.block_data ?? row.component_data ?? row.data);
+  return {
+    id: String(row.id || ''),
+    sectionId: String(row.section_id || row.sectionId || sectionId || ''),
+    type: String(row.block_type || row.component_type || row.type || 'block'),
+    visible: row.is_visible === undefined ? row.visible !== false : Boolean(Number(row.is_visible)),
+    data,
+    sortOrder: Number(row.sort_order || 0),
+  };
+}
+
+export function mapCmsEditorSection(row: Json, blocks: CmsEditorBlock[] = []): CmsEditorSection {
+  const fields = parseCmsEditorObject(row.section_data ?? row.data ?? row.fields);
+  return {
+    id: String(row.id || ''),
+    name: String(row.section_name || row.name || row.section_type || row.type || 'Section'),
+    type: String(row.section_type || row.type || fields.section_type || 'section'),
+    zone: zoneFor({ ...row, section_data: fields }),
+    visible: row.is_visible === undefined ? row.visible !== false : Boolean(Number(row.is_visible)),
+    color: String(fields.bg_color || fields.background_color || row.color || '#111115'),
+    fields,
+    css: parseCmsEditorObject(fields.css_override || row.css),
+    blocks,
+  };
+}
+
+export function mapCmsEditorPage(row: Json, sections: CmsEditorSection[] = []): CmsEditorPage {
+  const route = String(row.route_path || row.slug || '/');
+  return {
+    id: String(row.id || ''),
+    title: String(row.title || row.slug || 'Untitled'),
+    slug: route.startsWith('/') ? route : `/${route}`,
+    status: row.status === 'published' || row.is_published ? 'live' : row.status === 'new' ? 'new' : 'draft',
+    type: String(row.page_type || row.type || (route === '/' ? 'Home' : 'Interior')),
+    parent: row.parent_id || undefined,
+    sections,
+    metaTitle: String(row.seo_title || row.meta_title || row.title || ''),
+    metaDescription: String(row.meta_description || ''),
+  };
+}
+
+export function mapCmsEditorBootstrap(raw: Json, projectSlug: string) {
+  const sectionsByPage = raw.sections_by_page || {};
+  const blocksBySection = raw.blocks_by_section || raw.components_by_section || {};
+  const pages = (raw.pages || []).map((page: Json) => {
+    const sections = (sectionsByPage[page.id] || []).map((section: Json) => {
+      const blocks = (blocksBySection[section.id] || []).map((row: Json) => mapCmsEditorBlock(row, section.id));
+      return mapCmsEditorSection(section, blocks);
+    });
+    return mapCmsEditorPage(page, sections);
+  });
+  const tenant = raw.tenant || {};
+  const name = String(tenant.name || raw.workspace_label || projectSlug || 'CMS Site');
+  const themeVars = parseCmsEditorObject(raw.active_theme?.css_vars || raw.active_theme?.css_vars_json);
+  const site: CmsEditorSite = {
+    id: projectSlug,
+    name,
+    initials: cmsEditorInitials(name),
+    domain: String(raw.public_domain || tenant.domain || ''),
+    edited: 'Just now',
+    color: String(themeVars['--brand-primary'] || tenant.primary_color || '#6358ff'),
+    pages,
+  };
+  return {
+    site,
+    themeVars,
+    templates: raw.component_templates || [],
+    imports: raw.liquid_imports || [],
+    homePageId: raw.home_page?.id || pages[0]?.id || null,
+    schemas: {
+      protocol_version: Number(raw.protocol_version || raw.schemas?.protocol_version || 1),
+      sections: Array.isArray(raw.schemas?.sections) ? raw.schemas.sections : [],
+      blocks: Array.isArray(raw.schemas?.blocks) ? raw.schemas.blocks : [],
+      fields: Array.isArray(raw.schemas?.fields) ? raw.schemas.fields : [],
+    },
+  };
+}
+
+export function selectCmsEditorTarget(input: Partial<CmsEditorSelection> & { kind?: CmsEditorSelection['kind'] }): CmsEditorSelection {
+  const sectionId = String(input.sectionId || '').trim() || null;
+  const blockId = String(input.blockId || '').trim() || null;
+  const pageId = String(input.pageId || '').trim() || null;
+  return {
+    kind: input.kind || (blockId ? 'block' : sectionId ? 'section' : 'page'),
+    pageId,
+    sectionId,
+    blockId,
+    fieldPath: String(input.fieldPath || '').trim() || null,
+  };
+}

package/apps/client-cms-editor/shared/cms/src/starter-pack.ts

@@ -0,0 +1,158 @@
+import type { CmsEditorAdapter } from './adapter';
+import type { CmsEditorZone } from './editor-types';
+
+/**
+ * Built-in or harvested starter content. Not ephemeral, not demo-mode.
+ * Preview vs install are separate operations — the pack itself is durable product content.
+ */
+export type CmsStarterPackProvenance = {
+  kind: 'builtin_starter' | 'harvested' | 'imported';
+  packId: string;
+  packVersion: number;
+};
+
+export type CmsStarterBlockSeed = {
+  type: string;
+  data?: Record<string, unknown>;
+};
+
+export type CmsStarterSectionSeed = {
+  name: string;
+  type: string;
+  zone?: CmsEditorZone;
+  fields?: Record<string, unknown>;
+  blocks?: CmsStarterBlockSeed[];
+};
+
+export type CmsStarterPageSeed = {
+  title: string;
+  slug: string;
+  type?: string;
+  metaTitle?: string;
+  metaDescription?: string;
+  sections: CmsStarterSectionSeed[];
+};
+
+export type CmsStarterSiteSeed = {
+  name?: string;
+  domain?: string;
+  initials?: string;
+  color?: string;
+};
+
+export type CmsStarterPack = {
+  id: string;
+  name: string;
+  version: number;
+  description?: string;
+  provenance: CmsStarterPackProvenance;
+  /** Initial site shell when installing into an empty adapter (no public domain invented). */
+  site?: CmsStarterSiteSeed;
+  theme: {
+    cssVars: Record<string, string>;
+  };
+  schemas: {
+    protocol_version: number;
+    sections: unknown[];
+    blocks: unknown[];
+    fields?: unknown[];
+  };
+  templates?: Array<{
+    id: string;
+    name: string;
+    type: string;
+    category?: string;
+  }>;
+  pages: CmsStarterPageSeed[];
+};
+
+export type InstallStarterPackResult = {
+  siteId: string;
+  pageIds: string[];
+  packId: string;
+  packVersion: number;
+};
+
+/**
+ * Install a starter pack into a real CmsEditorAdapter (durable path).
+ * Uses adapter CRUD + saveDraft — never fabricates success outside the adapter.
+ */
+function siteInitials(name: string) {
+  return (
+    name
+      .split(/\s+/)
+      .filter(Boolean)
+      .slice(0, 2)
+      .map((part) => part[0])
+      .join('')
+      .toUpperCase() || 'CMS'
+  );
+}
+
+export async function installStarterPack(
+  adapter: CmsEditorAdapter,
+  pack: CmsStarterPack,
+  options?: { siteId?: string },
+): Promise<InstallStarterPackResult> {
+  const siteId = String(options?.siteId || pack.id).trim();
+  if (!siteId) throw new Error('starter_pack_site_id_required');
+
+  const sites = await adapter.listSites();
+  const siteExists = sites.some((site) => site.id === siteId);
+  if (!siteExists) {
+    const siteName = pack.site?.name?.trim() || pack.name;
+    await adapter.createSite({
+      id: siteId,
+      name: siteName,
+      domain: pack.site?.domain ?? '',
+      initials: pack.site?.initials ?? siteInitials(siteName),
+      color: pack.site?.color ?? pack.theme.cssVars['--brand-primary'] ?? '#1e6a6f',
+      theme: pack.theme,
+      schemas: pack.schemas,
+    });
+  } else {
+    await adapter.updateSite(siteId, {
+      theme: pack.theme,
+      schemas: pack.schemas,
+      name: pack.site?.name?.trim() || undefined,
+    });
+  }
+
+  const pageIds: string[] = [];
+  for (const pageSeed of pack.pages) {
+    const page = await adapter.createPage(siteId, {
+      title: pageSeed.title,
+      slug: pageSeed.slug,
+      type: pageSeed.type || 'Interior',
+      metaTitle: pageSeed.metaTitle || pageSeed.title,
+      metaDescription: pageSeed.metaDescription || '',
+    });
+    pageIds.push(page.id);
+
+    for (const sectionSeed of pageSeed.sections) {
+      const section = await adapter.createSection(page.id, {
+        name: sectionSeed.name,
+        type: sectionSeed.type,
+        zone: sectionSeed.zone || 'BODY',
+        fields: { ...(sectionSeed.fields || {}) },
+        blocks: [],
+      });
+      for (const blockSeed of sectionSeed.blocks || []) {
+        await adapter.createBlock(section.id, {
+          type: blockSeed.type,
+          data: { ...(blockSeed.data || {}) },
+        });
+      }
+    }
+
+    const hydrated = await adapter.getPage(page.id);
+    await adapter.saveDraft(page.id, { sections: hydrated.sections, theme: pack.theme, schemas: pack.schemas });
+  }
+
+  return {
+    siteId,
+    pageIds,
+    packId: pack.provenance.packId,
+    packVersion: pack.provenance.packVersion,
+  };
+}