@inneranimalmedia/agentsam-sdk 2.6.5 → 2.6.8

package/apps/client-cms-editor/reference/harvest/plans/local-cms-harvest-schema.sql

@@ -0,0 +1,328 @@
+PRAGMA foreign_keys = ON;
+
+-- Account -> site ownership only. No tenant_id or workspace_id.
+
+CREATE TABLE IF NOT EXISTS cms_sites (
+  account_id TEXT NOT NULL,
+  id TEXT NOT NULL,
+  slug TEXT NOT NULL,
+  name TEXT NOT NULL,
+  domain TEXT,
+  status TEXT NOT NULL DEFAULT 'harvest',
+  source_repo TEXT,
+  source_ref TEXT,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  PRIMARY KEY (account_id, id),
+  UNIQUE (account_id, slug)
+);
+
+CREATE TABLE IF NOT EXISTS cms_brand_profiles (
+  account_id TEXT NOT NULL,
+  id TEXT NOT NULL,
+  site_id TEXT NOT NULL,
+  profile_key TEXT NOT NULL,
+  name TEXT NOT NULL,
+  role TEXT NOT NULL,
+  source_file TEXT,
+  status TEXT NOT NULL DEFAULT 'candidate',
+  PRIMARY KEY (account_id, id),
+  UNIQUE (account_id, site_id, profile_key),
+  FOREIGN KEY (account_id, site_id) REFERENCES cms_sites(account_id, id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS cms_brand_tokens (
+  account_id TEXT NOT NULL,
+  id TEXT NOT NULL,
+  site_id TEXT NOT NULL,
+  profile_id TEXT NOT NULL,
+  token_key TEXT NOT NULL,
+  category TEXT NOT NULL,
+  value_text TEXT NOT NULL,
+  confidence REAL NOT NULL DEFAULT 1.0,
+  status TEXT NOT NULL DEFAULT 'observed',
+  source_file TEXT,
+  source_line INTEGER,
+  PRIMARY KEY (account_id, id),
+  FOREIGN KEY (account_id, site_id) REFERENCES cms_sites(account_id, id) ON DELETE CASCADE,
+  FOREIGN KEY (account_id, profile_id) REFERENCES cms_brand_profiles(account_id, id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS cms_routes (
+  account_id TEXT NOT NULL,
+  id TEXT NOT NULL,
+  site_id TEXT NOT NULL,
+  path TEXT NOT NULL,
+  route_kind TEXT NOT NULL,
+  title TEXT,
+  source_file TEXT,
+  source_symbol TEXT,
+  status TEXT NOT NULL DEFAULT 'candidate',
+  PRIMARY KEY (account_id, id),
+  UNIQUE (account_id, site_id, path),
+  FOREIGN KEY (account_id, site_id) REFERENCES cms_sites(account_id, id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS cms_layouts (
+  account_id TEXT NOT NULL,
+  id TEXT NOT NULL,
+  site_id TEXT NOT NULL,
+  route_id TEXT,
+  layout_key TEXT NOT NULL,
+  name TEXT NOT NULL,
+  source_file TEXT,
+  source_symbol TEXT,
+  status TEXT NOT NULL DEFAULT 'candidate',
+  structure_json TEXT NOT NULL DEFAULT '{}',
+  PRIMARY KEY (account_id, id),
+  UNIQUE (account_id, site_id, layout_key),
+  FOREIGN KEY (account_id, site_id) REFERENCES cms_sites(account_id, id) ON DELETE CASCADE,
+  FOREIGN KEY (account_id, route_id) REFERENCES cms_routes(account_id, id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS cms_sections (
+  account_id TEXT NOT NULL,
+  id TEXT NOT NULL,
+  site_id TEXT NOT NULL,
+  route_id TEXT,
+  layout_id TEXT,
+  section_key TEXT NOT NULL,
+  name TEXT NOT NULL,
+  section_type TEXT NOT NULL,
+  zone TEXT,
+  position INTEGER NOT NULL DEFAULT 0,
+  authority TEXT NOT NULL DEFAULT 'harvest',
+  status TEXT NOT NULL DEFAULT 'candidate',
+  source_file TEXT,
+  source_line INTEGER,
+  source_symbol TEXT,
+  props_json TEXT NOT NULL DEFAULT '{}',
+  PRIMARY KEY (account_id, id),
+  FOREIGN KEY (account_id, site_id) REFERENCES cms_sites(account_id, id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS cms_navigation (
+  account_id TEXT NOT NULL,
+  id TEXT NOT NULL,
+  site_id TEXT NOT NULL,
+  nav_key TEXT NOT NULL,
+  name TEXT NOT NULL,
+  location TEXT NOT NULL,
+  source_file TEXT,
+  source_symbol TEXT,
+  status TEXT NOT NULL DEFAULT 'candidate',
+  PRIMARY KEY (account_id, id),
+  UNIQUE (account_id, site_id, nav_key),
+  FOREIGN KEY (account_id, site_id) REFERENCES cms_sites(account_id, id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS cms_navigation_items (
+  account_id TEXT NOT NULL,
+  id TEXT NOT NULL,
+  site_id TEXT NOT NULL,
+  navigation_id TEXT NOT NULL,
+  position INTEGER NOT NULL,
+  label TEXT NOT NULL,
+  href TEXT NOT NULL,
+  item_kind TEXT NOT NULL DEFAULT 'internal',
+  source_file TEXT,
+  source_line INTEGER,
+  status TEXT NOT NULL DEFAULT 'candidate',
+  PRIMARY KEY (account_id, id),
+  FOREIGN KEY (account_id, navigation_id) REFERENCES cms_navigation(account_id, id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS cms_content_items (
+  account_id TEXT NOT NULL,
+  id TEXT NOT NULL,
+  site_id TEXT NOT NULL,
+  collection_key TEXT NOT NULL,
+  item_key TEXT NOT NULL,
+  item_type TEXT NOT NULL,
+  title TEXT,
+  slug TEXT,
+  authority TEXT NOT NULL DEFAULT 'sample',
+  status TEXT NOT NULL DEFAULT 'sample',
+  source_file TEXT,
+  source_line INTEGER,
+  data_json TEXT NOT NULL DEFAULT '{}',
+  PRIMARY KEY (account_id, id),
+  UNIQUE (account_id, site_id, collection_key, item_key),
+  FOREIGN KEY (account_id, site_id) REFERENCES cms_sites(account_id, id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS cms_assets (
+  account_id TEXT NOT NULL,
+  id TEXT NOT NULL,
+  site_id TEXT NOT NULL,
+  asset_key TEXT NOT NULL,
+  asset_kind TEXT NOT NULL,
+  uri TEXT,
+  local_path TEXT,
+  authority TEXT NOT NULL DEFAULT 'reference',
+  status TEXT NOT NULL DEFAULT 'candidate',
+  source_file TEXT,
+  source_line INTEGER,
+  PRIMARY KEY (account_id, id),
+  FOREIGN KEY (account_id, site_id) REFERENCES cms_sites(account_id, id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS cms_drafts (
+  account_id TEXT NOT NULL,
+  id TEXT NOT NULL,
+  site_id TEXT NOT NULL,
+  route_id TEXT,
+  name TEXT NOT NULL,
+  status TEXT NOT NULL DEFAULT 'working',
+  snapshot_json TEXT NOT NULL DEFAULT '{}',
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  PRIMARY KEY (account_id, id),
+  FOREIGN KEY (account_id, site_id) REFERENCES cms_sites(account_id, id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS cms_change_sets (
+  account_id TEXT NOT NULL,
+  id TEXT NOT NULL,
+  site_id TEXT NOT NULL,
+  draft_id TEXT NOT NULL,
+  sequence INTEGER NOT NULL,
+  source_kind TEXT NOT NULL DEFAULT 'human',
+  patch_json TEXT NOT NULL,
+  status TEXT NOT NULL DEFAULT 'accepted',
+  created_at TEXT NOT NULL,
+  PRIMARY KEY (account_id, id),
+  UNIQUE (account_id, draft_id, sequence),
+  FOREIGN KEY (account_id, draft_id) REFERENCES cms_drafts(account_id, id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS cms_publications (
+  account_id TEXT NOT NULL,
+  id TEXT NOT NULL,
+  site_id TEXT NOT NULL,
+  revision INTEGER NOT NULL,
+  snapshot_json TEXT NOT NULL,
+  status TEXT NOT NULL DEFAULT 'published',
+  created_at TEXT NOT NULL,
+  published_at TEXT,
+  PRIMARY KEY (account_id, id),
+  UNIQUE (account_id, site_id, revision),
+  FOREIGN KEY (account_id, site_id) REFERENCES cms_sites(account_id, id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS harvest_runs (
+  id TEXT PRIMARY KEY,
+  account_id TEXT NOT NULL,
+  site_id TEXT NOT NULL,
+  source_repo TEXT NOT NULL,
+  source_ref TEXT NOT NULL,
+  source_commit TEXT NOT NULL,
+  created_at TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS harvest_sources (
+  id TEXT PRIMARY KEY,
+  run_id TEXT NOT NULL,
+  lane TEXT NOT NULL,
+  path TEXT NOT NULL,
+  sha256 TEXT NOT NULL,
+  bytes INTEGER NOT NULL,
+  source_commit TEXT NOT NULL,
+  FOREIGN KEY (run_id) REFERENCES harvest_runs(id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS harvest_findings (
+  id TEXT PRIMARY KEY,
+  run_id TEXT NOT NULL,
+  account_id TEXT NOT NULL,
+  site_id TEXT NOT NULL,
+  category TEXT NOT NULL,
+  severity TEXT NOT NULL,
+  signal TEXT NOT NULL,
+  message TEXT NOT NULL,
+  source_file TEXT,
+  source_line INTEGER,
+  status TEXT NOT NULL DEFAULT 'review',
+  FOREIGN KEY (run_id) REFERENCES harvest_runs(id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS harvest_candidates (
+  id TEXT PRIMARY KEY,
+  run_id TEXT NOT NULL,
+  account_id TEXT NOT NULL,
+  site_id TEXT NOT NULL,
+  candidate_kind TEXT NOT NULL,
+  candidate_key TEXT NOT NULL,
+  value_text TEXT,
+  confidence REAL NOT NULL DEFAULT 0.5,
+  source_file TEXT,
+  source_line INTEGER,
+  status TEXT NOT NULL DEFAULT 'review',
+  metadata_json TEXT NOT NULL DEFAULT '{}',
+  FOREIGN KEY (run_id) REFERENCES harvest_runs(id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS tooling_probe_runs (
+  id TEXT PRIMARY KEY,
+  account_id TEXT NOT NULL,
+  site_id TEXT NOT NULL,
+  profile TEXT NOT NULL,
+  sdk_root TEXT,
+  fixture_root TEXT,
+  started_at TEXT NOT NULL,
+  finished_at TEXT,
+  ok INTEGER
+);
+
+CREATE TABLE IF NOT EXISTS tooling_probe_steps (
+  id TEXT PRIMARY KEY,
+  probe_run_id TEXT NOT NULL,
+  step_key TEXT NOT NULL,
+  category TEXT NOT NULL,
+  command_json TEXT NOT NULL,
+  cwd TEXT NOT NULL,
+  mutability TEXT NOT NULL,
+  network_mode TEXT NOT NULL,
+  started_at TEXT NOT NULL,
+  finished_at TEXT,
+  exit_code INTEGER,
+  ok INTEGER,
+  stdout_text TEXT,
+  stderr_text TEXT,
+  FOREIGN KEY (probe_run_id) REFERENCES tooling_probe_runs(id) ON DELETE CASCADE
+);
+
+
+-- Historical archive/theme intake provenance.
+CREATE TABLE IF NOT EXISTS archive_ingests (
+  id TEXT PRIMARY KEY,
+  account_id TEXT NOT NULL,
+  site_id TEXT NOT NULL,
+  source_path TEXT NOT NULL,
+  source_kind TEXT NOT NULL,
+  source_sha256 TEXT,
+  quarantine_path TEXT NOT NULL,
+  classification TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  manifest_json TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS archive_files (
+  id TEXT PRIMARY KEY,
+  ingest_id TEXT NOT NULL,
+  relative_path TEXT NOT NULL,
+  bytes INTEGER NOT NULL,
+  sha256 TEXT NOT NULL,
+  category TEXT NOT NULL,
+  FOREIGN KEY (ingest_id) REFERENCES archive_ingests(id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS archive_outputs (
+  id TEXT PRIMARY KEY,
+  ingest_id TEXT NOT NULL,
+  output_kind TEXT NOT NULL,
+  path TEXT NOT NULL,
+  bytes INTEGER NOT NULL,
+  sha256 TEXT NOT NULL,
+  FOREIGN KEY (ingest_id) REFERENCES archive_ingests(id) ON DELETE CASCADE
+);

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

@@ -1,21 +1,31 @@
 {
   "name": "@inneranimalmedia/agentsam-cms-shared",
-  "version": "0.1.0",
-  "private": true,
+  "version": "2.6.7",
+  "description": "Internal CMS shared contracts (bundled into @inneranimalmedia/client-cms-editor — not published separately).",
   "type": "module",
   "exports": {
     ".": "./src/index.ts",
     "./publication": "./src/publication.ts",
     "./bindings": "./src/cloudflare-bindings.ts",
-    "./context": "./src/agent-context.ts"
+    "./context": "./src/agent-context.ts",
+    "./adapter": "./src/adapter.ts",
+    "./host": "./src/host.ts"
   },
   "scripts": {
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
-  "dependencies": {
-    "@inneranimalmedia/agentsam-contracts": "file:../../../../packages/agentsam-contracts"
-  },
   "devDependencies": {
     "typescript": "^5.9.3"
-  }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SamPrimeaux/agentsam-sdk.git",
+    "directory": "apps/client-cms-editor/shared/cms"
+  },
+  "files": [
+    "src"
+  ]
 }

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

@@ -0,0 +1,204 @@
+/**
+ * Portable CMS persistence/transport contract.
+ *
+ * The editor depends on this interface — not on any host's private CMS routes
+ * or invented Worker binding product sources. Hosts implement adapters:
+ *   - SQLite (desktop / offline authority)
+ *   - Cloudflare D1 + R2 (cloud authority via OAuth-proven resources)
+ *   - custom HTTP backend
+ *   - embedding application backends (one consumer implementation each)
+ *
+ * localStorage is never an adapter. It may cache UI chrome only.
+ *
+ * Required methods are authoring CRUD. Adapters that cannot support a method
+ * must throw a typed capability error — never silently drop editor actions.
+ */
+
+import type {
+  CmsEditorBlock,
+  CmsEditorPage,
+  CmsEditorSection,
+  CmsEditorSite,
+  CmsSiteCreateInput,
+  CmsSiteRecord,
+  CmsSiteUpdatePatch,
+} from './editor-types';
+import type { CmsPublicationSnapshot } from './publication';
+
+export type { CmsPublicationSnapshot } from './publication';
+
+export type CmsRevision = {
+  id: string;
+  pageId: string;
+  kind: 'draft' | 'publication';
+  createdAt: string;
+  label?: string;
+  snapshot?: unknown;
+};
+
+export type CmsAsset = {
+  id: string;
+  name: string;
+  mimeType?: string;
+  size?: number;
+  url?: string;
+  key?: string;
+  createdAt?: string;
+  metadata?: Record<string, unknown>;
+};
+
+export type CmsCapabilityErrorCode =
+  | 'cms_capability_unsupported'
+  | 'cms_adapter_not_configured'
+  | 'cms_source_not_found'
+  | 'cms_permission_denied';
+
+export class CmsCapabilityError extends Error {
+  readonly code: CmsCapabilityErrorCode;
+  readonly capability: string;
+
+  constructor(capability: string, message?: string, code: CmsCapabilityErrorCode = 'cms_capability_unsupported') {
+    super(message || `CMS adapter does not support ${capability}`);
+    this.name = 'CmsCapabilityError';
+    this.code = code;
+    this.capability = capability;
+  }
+}
+
+/**
+ * Required content-authoring contract for a real CMS editor.
+ * Optional methods must not be used as a way to dilute CRUD.
+ */
+export type CmsEditorAdapter = {
+  // Site lifecycle
+  listSites(): Promise<CmsSiteRecord[]>;
+  getSite(siteId: string): Promise<CmsSiteRecord>;
+  createSite(input: CmsSiteCreateInput): Promise<CmsSiteRecord>;
+  updateSite(siteId: string, patch: CmsSiteUpdatePatch): Promise<CmsSiteRecord>;
+  deleteSite(siteId: string): Promise<void>;
+  /** Hydrated aggregate (site metadata + page tree). */
+  loadSite(siteId: string): Promise<CmsEditorSite>;
+
+  // Pages
+  listPages(siteId: string): Promise<CmsEditorPage[]>;
+  getPage(pageId: string): Promise<CmsEditorPage>;
+  createPage(
+    siteId: string,
+    input: Partial<CmsEditorPage> & { title: string; slug: string },
+  ): Promise<CmsEditorPage>;
+  updatePage(pageId: string, patch: Partial<CmsEditorPage>): Promise<CmsEditorPage>;
+  deletePage(pageId: string): Promise<void>;
+
+  // Sections
+  listSections(pageId: string): Promise<CmsEditorSection[]>;
+  getSection(sectionId: string): Promise<CmsEditorSection>;
+  createSection(
+    pageId: string,
+    input: Partial<CmsEditorSection> & { name: string },
+  ): Promise<CmsEditorSection>;
+  updateSection(
+    sectionId: string,
+    patch: Partial<CmsEditorSection>,
+  ): Promise<CmsEditorSection>;
+  deleteSection(sectionId: string): Promise<void>;
+  reorderSections(pageId: string, sectionIds: string[]): Promise<void>;
+  setSectionVisibility(sectionId: string, visible: boolean): Promise<void>;
+
+  // Blocks
+  listBlocks(sectionId: string): Promise<CmsEditorBlock[]>;
+  getBlock(blockId: string): Promise<CmsEditorBlock>;
+  createBlock(
+    sectionId: string,
+    input: Partial<CmsEditorBlock> & { type: string },
+  ): Promise<CmsEditorBlock>;
+  updateBlock(
+    blockId: string,
+    patch: Partial<CmsEditorBlock>,
+  ): Promise<CmsEditorBlock>;
+  deleteBlock(blockId: string): Promise<void>;
+  reorderBlocks?(sectionId: string, blockIds: string[]): Promise<void>;
+
+  // Draft / revisions
+  saveDraft(pageId: string, payload: unknown): Promise<CmsRevision>;
+  getRevision(revisionId: string): Promise<CmsRevision>;
+  listRevisions(pageId: string): Promise<CmsRevision[]>;
+  restoreRevision(pageId: string, revisionId: string): Promise<CmsEditorPage>;
+
+  // Publication
+  previewDraft(pageId: string): Promise<{ previewUrl?: string; snapshot: unknown }>;
+  publish(pageId: string, options?: { revisionId?: string }): Promise<CmsPublicationSnapshot>;
+  getPublishedRevision(pageId: string): Promise<CmsPublicationSnapshot | null>;
+
+  // Assets
+  listAssets(siteId: string): Promise<CmsAsset[]>;
+  getAsset(assetId: string): Promise<CmsAsset>;
+  uploadAsset(
+    siteId: string,
+    file: Blob,
+    meta?: { name?: string; metadata?: Record<string, unknown> },
+  ): Promise<CmsAsset>;
+  updateAsset(
+    assetId: string,
+    patch: Partial<Pick<CmsAsset, 'name' | 'metadata' | 'url' | 'key'>>,
+  ): Promise<CmsAsset>;
+  deleteAsset(assetId: string): Promise<void>;
+};
+
+/** Capability ids used when reporting honest unsupported operations. */
+export const CMS_ADAPTER_CAPABILITIES = Object.freeze([
+  'listSites',
+  'getSite',
+  'createSite',
+  'updateSite',
+  'deleteSite',
+  'loadSite',
+  'listPages',
+  'getPage',
+  'createPage',
+  'updatePage',
+  'deletePage',
+  'listSections',
+  'getSection',
+  'createSection',
+  'updateSection',
+  'deleteSection',
+  'reorderSections',
+  'setSectionVisibility',
+  'listBlocks',
+  'getBlock',
+  'createBlock',
+  'updateBlock',
+  'deleteBlock',
+  'reorderBlocks',
+  'saveDraft',
+  'getRevision',
+  'listRevisions',
+  'restoreRevision',
+  'previewDraft',
+  'publish',
+  'getPublishedRevision',
+  'listAssets',
+  'getAsset',
+  'uploadAsset',
+  'updateAsset',
+  'deleteAsset',
+] as const);
+
+export type CmsAdapterCapability = (typeof CMS_ADAPTER_CAPABILITIES)[number];
+
+export type CmsAdapterKind = 'sqlite' | 'd1_r2' | 'http' | 'custom';
+
+export type CmsAdapterDescriptor = {
+  kind: CmsAdapterKind;
+  label: string;
+  /** Provenance of the backing store — never invented product resources. */
+  provenance: {
+    kind: 'native_runtime' | 'oauth_discovery' | 'user_configured' | 'http_endpoint';
+    runtimeId?: string;
+    connectionId?: string;
+    resourceId?: string;
+    endpoint?: string;
+  };
+  /** Explicit list of supported capabilities; omit only when fully implementing CmsEditorAdapter. */
+  capabilities?: CmsAdapterCapability[];
+};

package/apps/client-cms-editor/shared/cms/src/agent-context.ts

@@ -1,7 +1,7 @@
-import type { AgentContext, AgentContextProvider, AgentPrincipal } from '@inneranimalmedia/agentsam-contracts';
+import type { CmsAgentContext, CmsAgentContextProvider, CmsHostPrincipal } from './host';
 
 export type CmsAgentContextInput = {
-  principal: AgentPrincipal;
+  principal: CmsHostPrincipal;
   projectId: string;
   route?: string;
   pageId?: string | null;
@@ -10,11 +10,11 @@ export type CmsAgentContextInput = {
   publicationRevision?: number | null;
 };
 
-export function createCmsAgentContext(input: CmsAgentContextInput): AgentContext {
+export function createCmsAgentContext(input: CmsAgentContextInput): CmsAgentContext {
   return {
     surface: 'cms',
     accountId: input.principal.accountId,
-    authUserId: input.principal.authUserId,
+    subjectId: input.principal.subjectId,
     projectId: input.projectId,
     metadata: {
       route: input.route ?? null,
@@ -26,7 +26,9 @@ export function createCmsAgentContext(input: CmsAgentContextInput): AgentContext
   };
 }
 
-export function createCmsAgentContextProvider(getInput: () => CmsAgentContextInput | Promise<CmsAgentContextInput>): AgentContextProvider {
+export function createCmsAgentContextProvider(
+  getInput: () => CmsAgentContextInput | Promise<CmsAgentContextInput>,
+): CmsAgentContextProvider {
   return {
     async getContext() {
       return createCmsAgentContext(await getInput());

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

@@ -35,6 +35,17 @@ export type CmsEditorPage = {
   metaDescription: string;
 };
 
+export type CmsEditorSiteTheme = {
+  cssVars: Record<string, string>;
+};
+
+export type CmsEditorSiteSchemas = {
+  protocol_version: number;
+  sections: unknown[];
+  blocks: unknown[];
+  fields?: unknown[];
+};
+
 export type CmsEditorSite = {
   id: string;
   name: string;
@@ -43,8 +54,29 @@ export type CmsEditorSite = {
   edited: string;
   color: string;
   pages: CmsEditorPage[];
+  /** Site-level theme authority (starter pack + editor). */
+  theme?: CmsEditorSiteTheme;
+  /** Site-level schema registry (starter pack + editor). */
+  schemas?: CmsEditorSiteSchemas;
 };
 
+/** Site metadata without hydrated page trees (aggregate reads use loadSite). */
+export type CmsSiteRecord = Omit<CmsEditorSite, 'pages'>;
+
+export type CmsSiteCreateInput = {
+  id?: string;
+  name: string;
+  domain?: string;
+  initials?: string;
+  color?: string;
+  theme?: CmsEditorSiteTheme;
+  schemas?: CmsEditorSiteSchemas;
+};
+
+export type CmsSiteUpdatePatch = Partial<
+  Pick<CmsEditorSite, 'name' | 'initials' | 'domain' | 'edited' | 'color' | 'theme' | 'schemas'>
+>;
+
 export type CmsEditorSelection = {
   kind: CmsEditorTargetKind;
   pageId: string | null;