@ai-matrx/alchemy 0.5.1 → 0.6.0

package/dist/declare.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/declare.ts","../src/declare/keys.ts","../src/declare/hash.ts","../src/declare/validate.ts","../src/declare/registry.ts"],"sourcesContent":["/**\n * `@ai-matrx/alchemy/declare` — what a screen holds (Matrx Alchemy CONTRACT §2.1).\n * Framework-neutral: zero React, zero `@ai-matrx/agents`. Agent fields are\n * extension slots registered by their owner.\n */\nexport type {\n  ApplyPolicy,\n  Classification,\n  ConfigNamespaceDeclaration,\n  DeclarationExtension,\n  DeclarationIssue,\n  DeclaredValue,\n  EvidenceSourceDeclaration,\n  ExecutionMode,\n  ExtensionRow,\n  ItemType,\n  Json,\n  LiveSlot,\n  LiveValues,\n  OnDemandSection,\n  QualifiedValueKey,\n  Readiness,\n  RecentRequest,\n  ResolvedItem,\n  ResolvedSurfaceDeclaration,\n  ResolvedValue,\n  Sensitivity,\n  StreamOp,\n  SurfaceDeclaration,\n  ValidationContext,\n  ValueGroup,\n  ValueProvenance,\n  ValueType,\n  WriteMode,\n  WriteTarget,\n} from \"./declare/types\";\nexport {\n  DECLARATION_NAME_RE,\n  QUALIFIED_VALUE_KEY_RE,\n  SURFACE_NAME_RE,\n  parseQualifiedValueKey,\n  qualifyValueKey,\n  surfaceClientOf,\n  type ParsedValueKey,\n} from \"./declare/keys\";\nexport { canonicalJson, declarationHash, sha256Hex } from \"./declare/hash\";\nexport {\n  BASELINE_GROUP_ORDER,\n  DEFAULT_MAX_INHERITANCE_DEPTH,\n  DEFAULT_SENSITIVITY,\n  GENERAL_GROUP_ORDER,\n  INHERITED_GROUP_ORDER_BASE,\n  RESERVED_GROUP_KEYS,\n  createDeclarationRegistry,\n  resolveSensitivity,\n  type DeclarationRegistry,\n  type DeclarationRegistryOptions,\n  type Resolved,\n} from \"./declare/registry\";\nexport {\n  APPLY_POLICIES,\n  CLASSIFICATIONS,\n  EXECUTION_MODES,\n  LIVE_SLOTS,\n  READINESS,\n  STREAM_OPS,\n  VALUE_TYPES,\n  WRITE_MODES,\n  findOrphanRows,\n  validateDeclarations,\n  validateLoadedValues,\n  type ValidateOptions,\n} from \"./declare/validate\";\n","import type { QualifiedValueKey } from \"./types\";\n\n/** Every value, write-target, item-type and group name (the DB CHECK rule). */\nexport const DECLARATION_NAME_RE = /^[a-z][a-z0-9_]*$/;\n\n/** \"<client>/<local>\" — the surface naming convention. */\nexport const SURFACE_NAME_RE = /^[a-z][a-z0-9-]*\\/[a-z0-9-/]+$/;\n\n/** A bare screen value (`status`) or an item value (`table_row.status`). */\nexport const QUALIFIED_VALUE_KEY_RE = /^[a-z][a-z0-9_]*(\\.[a-z][a-z0-9_]*)?$/;\n\nexport interface ParsedValueKey {\n  /** \"\" for a screen-level value. */\n  itemType: string;\n  name: string;\n}\n\n/** Split a qualified key; null when it is not a valid bare or qualified key. */\nexport function parseQualifiedValueKey(key: string): ParsedValueKey | null {\n  if (!QUALIFIED_VALUE_KEY_RE.test(key)) return null;\n  const dot = key.indexOf(\".\");\n  if (dot === -1) return { itemType: \"\", name: key };\n  return { itemType: key.slice(0, dot), name: key.slice(dot + 1) };\n}\n\nexport function qualifyValueKey(itemType: string, name: string): QualifiedValueKey {\n  return itemType ? `${itemType}.${name}` : name;\n}\n\n/** The client that owns a surface: its name prefix. */\nexport function surfaceClientOf(surfaceName: string): string {\n  return surfaceName.split(\"/\")[0] ?? \"\";\n}\n","import type { SurfaceDeclaration } from \"./types\";\n\n/** Canonical JSON: keys sorted, undefined dropped, arrays in order. */\nexport function canonicalJson(value: unknown): string {\n  if (value === undefined) return \"null\";\n  if (value === null || typeof value !== \"object\") return JSON.stringify(value);\n  if (Array.isArray(value)) return `[${value.map((entry) => canonicalJson(entry)).join(\",\")}]`;\n  const record = value as Record<string, unknown>;\n  return `{${Object.keys(record)\n    .filter((key) => record[key] !== undefined)\n    .sort()\n    .map((key) => `${JSON.stringify(key)}:${canonicalJson(record[key])}`)\n    .join(\",\")}}`;\n}\n\nconst K = new Uint32Array([\n  0x428a2f98, 0x71374491, 0xb5c0fbcf, 0xe9b5dba5, 0x3956c25b, 0x59f111f1, 0x923f82a4, 0xab1c5ed5,\n  0xd807aa98, 0x12835b01, 0x243185be, 0x550c7dc3, 0x72be5d74, 0x80deb1fe, 0x9bdc06a7, 0xc19bf174,\n  0xe49b69c1, 0xefbe4786, 0x0fc19dc6, 0x240ca1cc, 0x2de92c6f, 0x4a7484aa, 0x5cb0a9dc, 0x76f988da,\n  0x983e5152, 0xa831c66d, 0xb00327c8, 0xbf597fc7, 0xc6e00bf3, 0xd5a79147, 0x06ca6351, 0x14292967,\n  0x27b70a85, 0x2e1b2138, 0x4d2c6dfc, 0x53380d13, 0x650a7354, 0x766a0abb, 0x81c2c92e, 0x92722c85,\n  0xa2bfe8a1, 0xa81a664b, 0xc24b8b70, 0xc76c51a3, 0xd192e819, 0xd6990624, 0xf40e3585, 0x106aa070,\n  0x19a4c116, 0x1e376c08, 0x2748774c, 0x34b0bcb5, 0x391c0cb3, 0x4ed8aa4a, 0x5b9cca4f, 0x682e6ff3,\n  0x748f82ee, 0x78a5636f, 0x84c87814, 0x8cc70208, 0x90befffa, 0xa4506ceb, 0xbef9a3f7, 0xc67178f2,\n]);\n\n/** SHA-256 hex of a UTF-8 string. Pure, synchronous, runs anywhere (no crypto API needed). */\nexport function sha256Hex(input: string): string {\n  const bytes = new TextEncoder().encode(input);\n  const bitLength = bytes.length * 8;\n  const padded = new Uint8Array(((bytes.length + 9 + 63) >> 6) << 6);\n  padded.set(bytes);\n  padded[bytes.length] = 0x80;\n  const view = new DataView(padded.buffer);\n  view.setUint32(padded.length - 8, Math.floor(bitLength / 0x100000000));\n  view.setUint32(padded.length - 4, bitLength >>> 0);\n  const h = new Uint32Array([\n    0x6a09e667, 0xbb67ae85, 0x3c6ef372, 0xa54ff53a, 0x510e527f, 0x9b05688c, 0x1f83d9ab, 0x5be0cd19,\n  ]);\n  const w = new Uint32Array(64);\n  for (let offset = 0; offset < padded.length; offset += 64) {\n    for (let i = 0; i < 16; i += 1) w[i] = view.getUint32(offset + i * 4);\n    for (let i = 16; i < 64; i += 1) {\n      const a = w[i - 15]!;\n      const b = w[i - 2]!;\n      const s0 = ((a >>> 7) | (a << 25)) ^ ((a >>> 18) | (a << 14)) ^ (a >>> 3);\n      const s1 = ((b >>> 17) | (b << 15)) ^ ((b >>> 19) | (b << 13)) ^ (b >>> 10);\n      w[i] = (w[i - 16]! + s0 + w[i - 7]! + s1) >>> 0;\n    }\n    let a = h[0]!, b = h[1]!, c = h[2]!, d = h[3]!, e = h[4]!, f = h[5]!, g = h[6]!, hh = h[7]!;\n    for (let i = 0; i < 64; i += 1) {\n      const S1 = ((e >>> 6) | (e << 26)) ^ ((e >>> 11) | (e << 21)) ^ ((e >>> 25) | (e << 7));\n      const ch = (e & f) ^ (~e & g);\n      const t1 = (hh + S1 + ch + K[i]! + w[i]!) >>> 0;\n      const S0 = ((a >>> 2) | (a << 30)) ^ ((a >>> 13) | (a << 19)) ^ ((a >>> 22) | (a << 10));\n      const maj = (a & b) ^ (a & c) ^ (b & c);\n      const t2 = (S0 + maj) >>> 0;\n      hh = g; g = f; f = e; e = (d + t1) >>> 0; d = c; c = b; b = a; a = (t1 + t2) >>> 0;\n    }\n    h[0] = (h[0]! + a) >>> 0; h[1] = (h[1]! + b) >>> 0; h[2] = (h[2]! + c) >>> 0; h[3] = (h[3]! + d) >>> 0;\n    h[4] = (h[4]! + e) >>> 0; h[5] = (h[5]! + f) >>> 0; h[6] = (h[6]! + g) >>> 0; h[7] = (h[7]! + hh) >>> 0;\n  }\n  return Array.from(h, (word) => word.toString(16).padStart(8, \"0\")).join(\"\");\n}\n\n/**\n * Drift between clients. Computed, never authored: SHA-256 of the canonical JSON\n * of the declaration as authored (keys sorted, extension fields included).\n * Persisted as `ui_surface.content_hash` once that column exists.\n */\nexport function declarationHash(declaration: SurfaceDeclaration): string {\n  return sha256Hex(canonicalJson(declaration));\n}\n","/**\n * Declaration validation — the ONE set of surface checks (CONTRACT §3 D5).\n * Ported from matrx-frontend `scripts/check-surface-drift.ts`; the app's own\n * check now runs this. Agent-owned slots (roles, client tools) validate through\n * their `DeclarationExtension`, never here.\n */\nimport { DECLARATION_NAME_RE, SURFACE_NAME_RE, surfaceClientOf } from \"./keys\";\nimport type {\n  DeclarationExtension,\n  DeclarationIssue,\n  ResolvedSurfaceDeclaration,\n  SurfaceDeclaration,\n} from \"./types\";\n\nexport const VALUE_TYPES = [\"string\", \"number\", \"boolean\", \"object\", \"array\", \"document\"] as const;\nexport const WRITE_MODES = [\"draft\", \"entity\", \"ui\", \"stream\"] as const;\nexport const APPLY_POLICIES = [\"manual\", \"ask\", \"auto\", \"queued\"] as const;\nexport const STREAM_OPS = [\"replace\", \"insert_before\", \"insert_after\", \"prepend\", \"append\", \"patch\"] as const;\nexport const EXECUTION_MODES = [\"python-stream\", \"nextjs-stream\", \"browser-realtime\", \"local-runtime\"] as const;\nexport const READINESS = [\"verified\", \"partial\", \"stub\"] as const;\nexport const LIVE_SLOTS = [\"selection\", \"on-demand\", \"errors\", \"requests\"] as const;\nexport const CLASSIFICATIONS = [\"ordinary\", \"secret\", \"credential\"] as const;\n\nconst STRUCTURED = new Set([\"object\", \"array\"]);\n\nexport interface ValidateOptions {\n  /** Registered config namespaces; omitted = not checked. */\n  knownNamespaces?: ReadonlySet<string>;\n  /** Registered content-ir kind slugs; omitted = not checked. */\n  isKnownKind?: (slug: string) => boolean;\n  /** Names every declaration must expose unless `skipBaselineValues`. */\n  baselineNames?: readonly string[];\n  extensions?: readonly DeclarationExtension[];\n}\n\nfunction has<T extends string>(list: readonly T[], value: unknown): value is T {\n  return typeof value === \"string\" && (list as readonly string[]).includes(value);\n}\n\nexport function validateDeclarations(\n  declarations: readonly ResolvedSurfaceDeclaration[],\n  options: ValidateOptions = {},\n): DeclarationIssue[] {\n  const issues: DeclarationIssue[] = [];\n  const seenSurfaces = new Set<string>();\n  const labelsByClient = new Map<string, Map<string, string>>();\n\n  for (const d of declarations) {\n    const s = d.surfaceName;\n    const push = (path: string, sentence: string, remedy: string, severity?: \"advisory\") =>\n      issues.push({ surfaceName: s, path, sentence, remedy, ...(severity ? { severity } : {}) });\n\n    if (seenSurfaces.has(s)) {\n      push(\"surfaceName\", `Duplicate manifest surfaceName: \"${s}\" appears more than once.`, \"Keep one declaration per surface.\");\n    }\n    seenSurfaces.add(s);\n    if (!SURFACE_NAME_RE.test(s)) {\n      push(\"surfaceName\", `Surface \"${s}\" doesn't match the \"<client>/<local>\" convention.`, \"Rename it to <client>/<local>.\");\n    }\n\n    const prefix = surfaceClientOf(s);\n    if (d.client !== prefix) {\n      push(\"client\", `Surface \"${s}\" declares client \"${String(d.client)}\" but its name prefix is \"${prefix}\" — they must match.`, `Set client: \"${prefix}\".`);\n    }\n    if (!has(EXECUTION_MODES, d.executionMode)) {\n      push(\"executionMode\", `Surface \"${s}\" has invalid executionMode \"${String(d.executionMode)}\".`, `Use one of ${EXECUTION_MODES.join(\" | \")}.`);\n    }\n    if (typeof d.description !== \"string\") {\n      push(\"description\", `Surface \"${s}\" has no description.`, \"Add one sentence on what the surface is (\\\"\\\" only where the live row is empty).\");\n    }\n\n    const label = d.label?.trim();\n    if (!label) {\n      push(\"label\", `Surface \"${s}\" has no canonical label — label is required.`, \"Add the ONE canonical human display name.\");\n    } else {\n      const clientLabels = labelsByClient.get(prefix) ?? new Map<string, string>();\n      const clash = clientLabels.get(label.toLowerCase());\n      if (clash && clash !== s) {\n        push(\"label\", `Canonical label \"${label}\" is used by both \"${clash}\" and \"${s}\" — labels must be unique per client.`, \"Give one of them a distinct label.\");\n      }\n      clientLabels.set(label.toLowerCase(), s);\n      labelsByClient.set(prefix, clientLabels);\n    }\n\n    if (!has(READINESS, d.readiness)) {\n      push(\"readiness\", `Surface \"${s}\" has invalid readiness \"${String(d.readiness)}\" (expected verified | partial | stub).`, \"Set a valid readiness.\");\n    } else if (d.readiness !== \"verified\" && !d.readinessNote?.trim()) {\n      push(\"readinessNote\", `Surface \"${s}\" is readiness \"${d.readiness}\" but has no readinessNote — say what's missing.`, \"Add a one-line readinessNote.\");\n    }\n\n    const groupKeys = new Set<string>();\n    for (const g of d.groups ?? []) {\n      groupKeys.add(g.key);\n      const reserved = g.key === \"general\" || g.key === \"baseline\" || g.key.startsWith(\"inherited:\");\n      if (reserved) continue;\n      if (!DECLARATION_NAME_RE.test(g.key)) push(`groups/${g.key}`, `Surface \"${s}\" group \"${g.key}\" doesn't match /^[a-z][a-z0-9_]*$/.`, \"Rename the group key to lower_snake_case.\");\n      if (g.sortOrder < 0 || g.sortOrder > 899) push(`groups/${g.key}/sortOrder`, `Surface \"${s}\" group \"${g.key}\" sortOrder ${g.sortOrder} is outside the curated band 0–899.`, \"Use a sortOrder between 0 and 899.\");\n      if (!g.label?.trim()) push(`groups/${g.key}/label`, `Surface \"${s}\" group \"${g.key}\" has no canonical label.`, \"Add a label.\");\n    }\n\n    const seenNamespaces = new Set<string>();\n    for (const ns of d.configNamespaces ?? []) {\n      if (seenNamespaces.has(ns.namespace)) push(`configNamespaces/${ns.namespace}`, `Surface \"${s}\" declares duplicate config namespace \"${ns.namespace}\".`, \"Remove the duplicate.\");\n      seenNamespaces.add(ns.namespace);\n      if (options.knownNamespaces && !options.knownNamespaces.has(ns.namespace)) {\n        push(`configNamespaces/${ns.namespace}`, `Surface \"${s}\" references config namespace \"${ns.namespace}\" which is not registered.`, \"Register the namespace first, or remove the reference.\");\n      }\n    }\n\n    if (d.values.length === 0) {\n      push(\"values\", `Surface \"${s}\" declares no values.`, \"Declare at least one value.\");\n      continue;\n    }\n\n    const seenValues = new Set<string>();\n    for (const v of d.values) {\n      const at = `values/${v.name}`;\n      if (seenValues.has(v.name)) push(at, `Surface \"${s}\" declares duplicate value \"${v.name}\".`, \"Remove the duplicate.\");\n      seenValues.add(v.name);\n      if (!DECLARATION_NAME_RE.test(v.name)) push(at, `Surface \"${s}\" value \"${v.name}\" doesn't match /^[a-z][a-z0-9_]*$/ — the DB CHECK constraint will reject this.`, \"Rename it to lower_snake_case.\");\n      if (!has(VALUE_TYPES, v.valueType)) push(`${at}/valueType`, `Surface \"${s}\" value \"${v.name}\" has invalid valueType \"${String(v.valueType)}\".`, `Use one of ${VALUE_TYPES.join(\" | \")}.`);\n      if (typeof v.typicalCharCount !== \"number\" || v.typicalCharCount < 0) push(`${at}/typicalCharCount`, `Surface \"${s}\" value \"${v.name}\" has invalid typicalCharCount.`, \"Use a non-negative number.\");\n      if (v.sortOrder !== undefined && (typeof v.sortOrder !== \"number\" || v.sortOrder < 0)) push(`${at}/sortOrder`, `Surface \"${s}\" value \"${v.name}\" has invalid sortOrder.`, \"Use a non-negative number.\");\n      if (v.groupKey && !groupKeys.has(v.groupKey)) push(`${at}/group`, `Surface \"${s}\" value \"${v.name}\" resolved to groupKey \"${v.groupKey}\" which is missing from the resolved groups list — registry group synthesis is broken.`, \"Fix the registry resolution.\");\n      if (v.liveSlot !== undefined && !has(LIVE_SLOTS, v.liveSlot)) push(`${at}/liveSlot`, `Surface \"${s}\" value \"${v.name}\" has invalid liveSlot \"${String(v.liveSlot)}\".`, `Use one of ${LIVE_SLOTS.join(\" | \")}.`);\n      if (v.role !== undefined && v.role !== \"data\" && v.role !== \"request\") push(`${at}/role`, `Surface \"${s}\" value \"${v.name}\" has invalid role \"${String(v.role)}\".`, \"Use data | request.\");\n      if (v.sensitivity?.classification !== undefined && !has(CLASSIFICATIONS, v.sensitivity.classification)) push(`${at}/sensitivity/classification`, `Surface \"${s}\" value \"${v.name}\" has invalid classification \"${String(v.sensitivity.classification)}\".`, `Use one of ${CLASSIFICATIONS.join(\" | \")}.`);\n    }\n\n    for (const slot of d.liveSlots ?? []) {\n      if (!has(LIVE_SLOTS, slot)) push(\"liveSlots\", `Surface \"${s}\" declares unknown live slot \"${String(slot)}\".`, `Use one of ${LIVE_SLOTS.join(\" | \")}.`);\n    }\n\n    const itemTypeNames = new Set<string>();\n    for (const item of d.itemTypes ?? []) {\n      const at = `itemTypes/${item.name}`;\n      if (itemTypeNames.has(item.name)) push(at, `Surface \"${s}\" declares duplicate item type \"${item.name}\".`, \"Remove the duplicate.\");\n      itemTypeNames.add(item.name);\n      if (!DECLARATION_NAME_RE.test(item.name)) push(at, `Surface \"${s}\" item type \"${item.name}\" doesn't match /^[a-z][a-z0-9_]*$/.`, \"Rename it to lower_snake_case.\");\n      if (!item.label?.trim() || !item.description?.trim()) push(at, `Surface \"${s}\" item type \"${item.name}\" needs a label and a description.`, \"Add both.\");\n      const itemValues = new Set(item.values.map((v) => v.name));\n      if (item.identity.length === 0) push(`${at}/identity`, `Surface \"${s}\" item type \"${item.name}\" has an empty identity.`, \"Name the value(s) that identify one item.\");\n      for (const key of item.identity) {\n        if (!itemValues.has(key)) push(`${at}/identity`, `Surface \"${s}\" item type \"${item.name}\" identity names \"${key}\", which is not one of its values.`, \"Declare it as an item value.\");\n      }\n      for (const t of item.writeTargets ?? []) {\n        if (t.updatesValue && !itemValues.has(t.updatesValue)) push(`${at}/writeTargets/${t.name}`, `Surface \"${s}\" item type \"${item.name}\" write target \"${t.name}\" updatesValue \"${t.updatesValue}\" which is not an item value.`, \"Point it at a declared item value.\");\n      }\n    }\n\n    const seenTargets = new Set<string>();\n    const structuredWithoutKind: string[] = [];\n    for (const w of d.writeTargets ?? []) {\n      const at = `writeTargets/${w.name}`;\n      if (seenTargets.has(w.name)) push(at, `Surface \"${s}\" declares duplicate write target \"${w.name}\".`, \"Remove the duplicate.\");\n      seenTargets.add(w.name);\n      if (!DECLARATION_NAME_RE.test(w.name)) push(at, `Surface \"${s}\" write target \"${w.name}\" doesn't match /^[a-z][a-z0-9_]*$/.`, \"Rename it to lower_snake_case.\");\n      if (!w.label?.trim() || !w.description?.trim()) push(at, `Surface \"${s}\" write target \"${w.name}\" needs a label and a description.`, \"Add both.\");\n      if (!has(VALUE_TYPES, w.valueType)) push(`${at}/valueType`, `Surface \"${s}\" write target \"${w.name}\" has invalid valueType \"${String(w.valueType)}\".`, `Use one of ${VALUE_TYPES.join(\" | \")}.`);\n      if (!has(WRITE_MODES, w.mode)) push(`${at}/mode`, `Surface \"${s}\" write target \"${w.name}\" has invalid mode \"${String(w.mode)}\".`, `Use one of ${WRITE_MODES.join(\" | \")}.`);\n      if (w.applyPolicy !== undefined && !has(APPLY_POLICIES, w.applyPolicy)) push(`${at}/applyPolicy`, `Surface \"${s}\" write target \"${w.name}\" has invalid applyPolicy \"${String(w.applyPolicy)}\".`, `Use one of ${APPLY_POLICIES.join(\" | \")}.`);\n      if (w.itemType !== undefined && !itemTypeNames.has(w.itemType)) push(`${at}/itemType`, `Surface \"${s}\" write target \"${w.name}\" names item type \"${w.itemType}\", which the surface does not declare.`, \"Declare the item type or drop itemType.\");\n      const readTwinDeclared = w.updatesValue ? seenValues.has(w.updatesValue) : false;\n      if (w.updatesValue && !w.itemType && !readTwinDeclared) push(`${at}/updatesValue`, `Surface \"${s}\" write target \"${w.name}\" updatesValue \"${w.updatesValue}\" which is not a declared value.`, \"Point updatesValue at a declared value.\");\n      if (w.patchable && !w.updatesValue) push(`${at}/patchable`, `Surface \"${s}\" write target \"${w.name}\" is patchable but declares no updatesValue — an anchored edit has nothing to read.`, \"Declare the read twin in updatesValue.\");\n      if (w.patchable && w.valueType !== \"string\" && w.valueType !== \"document\") push(`${at}/patchable`, `Surface \"${s}\" write target \"${w.name}\" is patchable but valueType is \"${w.valueType}\" (patching is for \"string\" | \"document\").`, \"Drop patchable or change the value type.\");\n      if (w.mode === \"stream\") {\n        if (!w.streamOps || w.streamOps.length === 0) push(`${at}/streamOps`, `Surface \"${s}\" write target \"${w.name}\" is a stream target with no streamOps.`, \"List the ops it services.\");\n        if (!w.updatesValue) push(`${at}/updatesValue`, `Surface \"${s}\" write target \"${w.name}\" is a stream target with no read twin.`, \"Declare updatesValue.\");\n      } else if (w.streamOps !== undefined) {\n        push(`${at}/streamOps`, `Surface \"${s}\" write target \"${w.name}\" lists streamOps but its mode is \"${w.mode}\".`, \"streamOps belong only to mode \\\"stream\\\".\");\n      }\n      for (const op of w.streamOps ?? []) {\n        if (!has(STREAM_OPS, op)) push(`${at}/streamOps`, `Surface \"${s}\" write target \"${w.name}\" lists unknown stream op \"${String(op)}\".`, `Use ${STREAM_OPS.join(\" | \")}.`);\n      }\n      if (w.group && !groupKeys.has(w.group)) push(`${at}/group`, `Surface \"${s}\" write target \"${w.name}\" references undeclared group \"${w.group}\".`, \"Declare the group or drop it.\");\n      if (w.valueKind !== undefined) {\n        if (typeof w.valueKind !== \"string\" || !w.valueKind.trim()) {\n          push(`${at}/valueKind`, `Surface \"${s}\" write target \"${w.name}\" has an empty valueKind.`, \"Name a registered kind slug or omit the field.\");\n        } else if (options.isKnownKind && !options.isKnownKind(w.valueKind)) {\n          push(`${at}/valueKind`, `Surface \"${s}\" write target \"${w.name}\" declares valueKind \"${w.valueKind}\", which is not a registered active kind.`, \"Name a registered kind slug, or register the kind first; never inline a JSON schema.\");\n        }\n      } else if (STRUCTURED.has(w.valueType)) {\n        structuredWithoutKind.push(w.name);\n      }\n    }\n    for (const name of structuredWithoutKind) {\n      push(`writeTargets/${name}/valueKind`, `Surface \"${s}\" structured write target \"${name}\" declares no valueKind.`, \"Name a registered kind slug (the value contract ratchet).\", \"advisory\");\n    }\n\n    if (!d.skipBaselineValues && options.baselineNames) {\n      const missing = options.baselineNames.filter((name) => !seenValues.has(name));\n      if (missing.length > 0) {\n        push(\"values\", `Surface \"${s}\" is missing baseline value(s): ${missing.join(\", \")}.`, \"The registry injects baselines automatically; opt out only with skipBaselineValues.\");\n      }\n    }\n  }\n\n  for (const extension of options.extensions ?? []) {\n    if (!extension.validate) continue;\n    for (const d of declarations) issues.push(...extension.validate(d as SurfaceDeclaration & ResolvedSurfaceDeclaration, { all: declarations }));\n  }\n  return issues;\n}\n\n/**\n * The runtime half: a loaded scope may carry only declared values. Returns one\n * issue per undeclared key (and per `__item` value its item type does not declare).\n */\nexport function validateLoadedValues(\n  declaration: Pick<ResolvedSurfaceDeclaration, \"surfaceName\" | \"values\" | \"itemTypes\">,\n  loaded: Record<string, unknown>,\n  options: { ignore?: readonly string[] } = {},\n): DeclarationIssue[] {\n  const declared = new Set(declaration.values.map((v) => v.name));\n  const ignore = new Set(options.ignore ?? []);\n  const issues: DeclarationIssue[] = [];\n  for (const key of Object.keys(loaded)) {\n    if (key === \"__item\" || declared.has(key) || ignore.has(key)) continue;\n    issues.push({\n      surfaceName: declaration.surfaceName,\n      path: `values/${key}`,\n      sentence: `Surface \"${declaration.surfaceName}\" loaded a value \"${key}\" it never declared.`,\n      remedy: `Declare \"${key}\" in the surface's values, or stop emitting it.`,\n    });\n  }\n  const item = loaded.__item as { itemType?: unknown; values?: unknown } | undefined;\n  if (item && typeof item === \"object\") {\n    const type = declaration.itemTypes?.find((t) => t.name === item.itemType);\n    if (!type) {\n      issues.push({\n        surfaceName: declaration.surfaceName,\n        path: \"__item/itemType\",\n        sentence: `Surface \"${declaration.surfaceName}\" loaded an item of type \"${String(item.itemType)}\" it never declared.`,\n        remedy: \"Declare the item type, or stop emitting the item.\",\n      });\n    } else if (item.values && typeof item.values === \"object\") {\n      const itemDeclared = new Set(type.values.map((v) => v.name));\n      for (const key of Object.keys(item.values)) {\n        if (itemDeclared.has(key)) continue;\n        issues.push({\n          surfaceName: declaration.surfaceName,\n          path: `__item/${type.name}.${key}`,\n          sentence: `Surface \"${declaration.surfaceName}\" loaded item value \"${type.name}.${key}\" it never declared.`,\n          remedy: `Declare \"${key}\" on item type \"${type.name}\".`,\n        });\n      }\n    }\n  }\n  return issues;\n}\n\n/**\n * Ownership: no `ui.ui_surface` row may exist without a declaring owner\n * (CONTRACT §2.1a). `retired` rows (archived, not deleted) are exempt.\n */\nexport function findOrphanRows(\n  rowNames: readonly string[],\n  declaredNames: Iterable<string>,\n  retired: Iterable<string> = [],\n): string[] {\n  const owned = new Set(declaredNames);\n  const archived = new Set(retired);\n  return rowNames.filter((name) => !owned.has(name) && !archived.has(name)).sort();\n}\n","/**\n * The declaration registry: inheritance, baseline injection, provenance and\n * group synthesis (CONTRACT §2.1 `DeclarationRegistry`). Ported verbatim in\n * behaviour from matrx-frontend `features/surfaces/manifests/registry.ts`\n * (ALC-14); the app now supplies its declarations and baselines.\n *\n * Guards are LOUD by design: an unknown parent, a cycle, a chain deeper than\n * the limit, a reserved or duplicate group key, a value naming an undeclared\n * group, or a reserved platform name throws on resolution — a build fails\n * instead of silently dropping values.\n */\nimport { declarationHash } from \"./hash\";\nimport type {\n  DeclarationExtension,\n  DeclarationIssue,\n  DeclaredValue,\n  ResolvedSurfaceDeclaration,\n  ResolvedValue,\n  Sensitivity,\n  SurfaceDeclaration,\n  ValueGroup,\n  ValueProvenance,\n} from \"./types\";\nimport { validateDeclarations, type ValidateOptions } from \"./validate\";\n\nexport const RESERVED_GROUP_KEYS = {\n  general: \"general\",\n  baseline: \"baseline\",\n  inheritedPrefix: \"inherited:\",\n} as const;\n\n/** Group sortOrder bands. Curated groups author 0–899; the rest is reserved. */\nexport const GENERAL_GROUP_ORDER = 850;\nexport const INHERITED_GROUP_ORDER_BASE = 9000;\nexport const BASELINE_GROUP_ORDER = 9900;\nexport const DEFAULT_MAX_INHERITANCE_DEPTH = 3;\n\nexport const DEFAULT_SENSITIVITY: Sensitivity = Object.freeze({\n  exportable: true,\n  classification: \"ordinary\",\n  includedByDefault: true,\n});\n\nexport function resolveSensitivity(value: Pick<DeclaredValue, \"sensitivity\">): Sensitivity {\n  return {\n    exportable: value.sensitivity?.exportable ?? DEFAULT_SENSITIVITY.exportable,\n    classification: value.sensitivity?.classification ?? DEFAULT_SENSITIVITY.classification,\n    includedByDefault: value.sensitivity?.includedByDefault ?? DEFAULT_SENSITIVITY.includedByDefault,\n  };\n}\n\nexport type Resolved<D extends SurfaceDeclaration> = Omit<D, \"values\" | \"groups\"> & {\n  values: readonly (D[\"values\"][number] & ResolvedValue)[];\n  groups: readonly ValueGroup[];\n  contentHash: string;\n};\n\nexport interface DeclarationRegistryOptions {\n  /** Generic values injected into every declaration unless `skipBaselineValues`. */\n  baselineValues?: readonly DeclaredValue[];\n  /** Value names only the platform writes; a declaration claiming one is refused. */\n  reservedValueNames?: readonly string[];\n  /** Write-target names only the platform writes. */\n  reservedWriteTargetNames?: readonly string[];\n  maxInheritanceDepth?: number;\n}\n\nexport interface DeclarationRegistry<D extends SurfaceDeclaration> {\n  /** Refuses a second declaration of the same surfaceName. */\n  register(declaration: D): void;\n  registerExtension(extension: DeclarationExtension<D>): void;\n  extensions(): readonly DeclarationExtension<D>[];\n  /** Declarations exactly as authored (inheritance unresolved, no baselines). */\n  raw(): readonly D[];\n  getRaw(surfaceName: string): D | undefined;\n  /** Parent chain, ROOT FIRST. Unknown surfaces return []. */\n  ancestry(surfaceName: string): string[];\n  /** Direct children (declarations naming it in `inheritsFrom`), in declaration order. */\n  children(surfaceName: string): string[];\n  /** Inheritance + baseline + groups resolved; provenance kept. */\n  all(): readonly Resolved<D>[];\n  get(surfaceName: string): Resolved<D> | undefined;\n  validate(options?: ValidateOptions): readonly DeclarationIssue[];\n}\n\nexport function createDeclarationRegistry<D extends SurfaceDeclaration>(\n  options: DeclarationRegistryOptions = {},\n): DeclarationRegistry<D> {\n  const baselineValues = options.baselineValues ?? [];\n  const baselineNames = new Set(baselineValues.map((v) => v.name));\n  const reservedValues = new Set(options.reservedValueNames ?? []);\n  const reservedTargets = new Set(options.reservedWriteTargetNames ?? []);\n  const maxDepth = options.maxInheritanceDepth ?? DEFAULT_MAX_INHERITANCE_DEPTH;\n  const declarations: D[] = [];\n  const index = new Map<string, D>();\n  const extensionList: DeclarationExtension<D>[] = [];\n  let resolvedCache: Resolved<D>[] | null = null;\n  let resolvedIndex = new Map<string, Resolved<D>>();\n\n  function ancestry(surfaceName: string): string[] {\n    const chain: string[] = [];\n    const seen = new Set<string>([surfaceName]);\n    let current = index.get(surfaceName)?.inheritsFrom;\n    while (current) {\n      if (seen.has(current)) {\n        throw new Error(\n          `[surfaces] inheritsFrom CYCLE detected at \"${current}\" (from \"${surfaceName}\"). ` +\n            `Fix the manifest chain: ${[...seen].join(\" → \")} → ${current}`,\n        );\n      }\n      const parent = index.get(current);\n      if (!parent) {\n        throw new Error(\n          `[surfaces] \"${surfaceName}\" inheritsFrom unknown surface \"${current}\" — ` +\n            `the parent must be a registered declaration`,\n        );\n      }\n      seen.add(current);\n      chain.unshift(current);\n      if (chain.length > maxDepth) {\n        throw new Error(\n          `[surfaces] inheritance chain for \"${surfaceName}\" exceeds depth ${maxDepth}: ` + chain.join(\" → \"),\n        );\n      }\n      current = parent.inheritsFrom;\n    }\n    return chain;\n  }\n\n  function groupKeyFor(value: DeclaredValue, provenance: ValueProvenance): string {\n    if (provenance.kind === \"own\" && value.group) return value.group;\n    if (baselineNames.has(value.name)) return RESERVED_GROUP_KEYS.baseline;\n    if (provenance.kind === \"inherited\") return `${RESERVED_GROUP_KEYS.inheritedPrefix}${provenance.from}`;\n    if (provenance.kind === \"baseline\") return RESERVED_GROUP_KEYS.baseline;\n    return RESERVED_GROUP_KEYS.general;\n  }\n\n  function resolve(declaration: D): Resolved<D> {\n    const chain = ancestry(declaration.surfaceName);\n    const lineage: { layer: D; from: string | null }[] = [\n      ...chain.map((name) => {\n        const layer = index.get(name);\n        if (!layer) throw new Error(`[surfaces] missing inherited declaration \"${name}\"`);\n        return { layer, from: name };\n      }),\n      { layer: declaration, from: null },\n    ];\n\n    const curatedKeys = new Set<string>();\n    for (const group of declaration.groups ?? []) {\n      if (\n        group.key === RESERVED_GROUP_KEYS.general ||\n        group.key === RESERVED_GROUP_KEYS.baseline ||\n        group.key.startsWith(RESERVED_GROUP_KEYS.inheritedPrefix)\n      ) {\n        throw new Error(\n          `[surfaces] \"${declaration.surfaceName}\" declares reserved group key \"${group.key}\" — ` +\n            `general/baseline/inherited:* are synthesized by the registry`,\n        );\n      }\n      if (curatedKeys.has(group.key)) {\n        throw new Error(`[surfaces] \"${declaration.surfaceName}\" declares duplicate group key \"${group.key}\"`);\n      }\n      curatedKeys.add(group.key);\n    }\n    for (const value of declaration.values) {\n      if (reservedValues.has(value.name)) {\n        throw new Error(\n          `[surfaces] \"${declaration.surfaceName}\" declares value \"${value.name}\" — that name is written by the platform; choose another name`,\n        );\n      }\n      if (value.group && !curatedKeys.has(value.group)) {\n        throw new Error(\n          `[surfaces] \"${declaration.surfaceName}\" value \"${value.name}\" references undeclared ` +\n            `group \"${value.group}\" — declare it in the manifest's \\`groups\\``,\n        );\n      }\n    }\n    for (const target of declaration.writeTargets ?? []) {\n      if (reservedTargets.has(target.name)) {\n        throw new Error(\n          `[surfaces] \"${declaration.surfaceName}\" declares write target \"${target.name}\" — that name is written by the platform; choose another name`,\n        );\n      }\n    }\n\n    const valuesByName = new Map<string, D[\"values\"][number] & ResolvedValue>();\n    const inheritedLists = new Map<string, Map<string, unknown>>();\n    const coreLists: { field: string; identity(entry: unknown): string }[] = [\n      { field: \"configNamespaces\", identity: (entry) => (entry as { namespace: string }).namespace },\n      {\n        field: \"evidenceSources\",\n        identity: (entry) => `${(entry as { kind: string }).kind}:${(entry as { idValue: string }).idValue}`,\n      },\n    ];\n    const lists = [...coreLists, ...extensionList.flatMap((extension) => extension.inheritedLists ?? [])];\n    for (const { layer, from } of lineage) {\n      for (const value of layer.values) {\n        const provenance: ValueProvenance = from ? { kind: \"inherited\", from } : { kind: \"own\" };\n        valuesByName.set(value.name, {\n          ...value,\n          provenance,\n          groupKey: groupKeyFor(value, provenance),\n          resolvedSensitivity: resolveSensitivity(value),\n        });\n      }\n      for (const list of lists) {\n        const entries = (layer as unknown as Record<string, unknown>)[list.field];\n        if (!Array.isArray(entries)) continue;\n        const byIdentity = inheritedLists.get(list.field) ?? new Map<string, unknown>();\n        for (const entry of entries) byIdentity.set(list.identity(entry), entry);\n        inheritedLists.set(list.field, byIdentity);\n      }\n    }\n\n    if (!declaration.skipBaselineValues) {\n      for (const baseline of baselineValues) {\n        if (valuesByName.has(baseline.name)) continue;\n        valuesByName.set(baseline.name, {\n          ...baseline,\n          provenance: { kind: \"baseline\" },\n          groupKey: RESERVED_GROUP_KEYS.baseline,\n          resolvedSensitivity: resolveSensitivity(baseline),\n        } as D[\"values\"][number] & ResolvedValue);\n      }\n    }\n\n    const usedGroupKeys = new Set(Array.from(valuesByName.values(), (value) => value.groupKey));\n    const groups: ValueGroup[] = [...(declaration.groups ?? [])];\n    if (usedGroupKeys.has(RESERVED_GROUP_KEYS.general)) {\n      groups.push({ key: RESERVED_GROUP_KEYS.general, label: \"General\", sortOrder: GENERAL_GROUP_ORDER });\n    }\n    for (let i = chain.length - 1, distance = 0; i >= 0; i -= 1, distance += 1) {\n      const parentName = chain[i]!;\n      const key = `${RESERVED_GROUP_KEYS.inheritedPrefix}${parentName}`;\n      if (!usedGroupKeys.has(key)) continue;\n      const parentLabel = index.get(parentName)?.label ?? parentName;\n      groups.push({\n        key,\n        label: `Inherited from ${parentLabel}`,\n        sortOrder: INHERITED_GROUP_ORDER_BASE + distance * 10,\n      });\n    }\n    if (usedGroupKeys.has(RESERVED_GROUP_KEYS.baseline)) {\n      groups.push({ key: RESERVED_GROUP_KEYS.baseline, label: \"Generic baselines\", sortOrder: BASELINE_GROUP_ORDER });\n    }\n    groups.sort((a, b) => a.sortOrder - b.sortOrder);\n\n    const groupOrder = new Map(groups.map((group) => [group.key, group.sortOrder] as const));\n    const values = Array.from(valuesByName.values()).sort((a, b) => {\n      const ga = groupOrder.get(a.groupKey) ?? GENERAL_GROUP_ORDER;\n      const gb = groupOrder.get(b.groupKey) ?? GENERAL_GROUP_ORDER;\n      if (ga !== gb) return ga - gb;\n      return (a.sortOrder ?? 1000) - (b.sortOrder ?? 1000);\n    });\n\n    const merged: Record<string, unknown> = {};\n    for (const [field, byIdentity] of inheritedLists) {\n      if (byIdentity.size > 0) merged[field] = Array.from(byIdentity.values());\n    }\n    return {\n      ...declaration,\n      values,\n      groups,\n      ...merged,\n      contentHash: declarationHash(declaration),\n    } as Resolved<D>;\n  }\n\n  function resolvedAll(): Resolved<D>[] {\n    if (!resolvedCache) {\n      resolvedCache = declarations.map(resolve);\n      resolvedIndex = new Map(resolvedCache.map((entry) => [entry.surfaceName, entry] as const));\n    }\n    return resolvedCache;\n  }\n\n  const registry: DeclarationRegistry<D> = {\n    register(declaration) {\n      if (index.has(declaration.surfaceName)) {\n        throw new Error(`[surfaces] \"${declaration.surfaceName}\" is declared twice — one surface, one declaration`);\n      }\n      declarations.push(declaration);\n      index.set(declaration.surfaceName, declaration);\n      resolvedCache = null;\n    },\n    registerExtension(extension) {\n      if (extensionList.some((existing) => existing.key === extension.key)) {\n        throw new Error(`[surfaces] declaration extension \"${extension.key}\" is registered twice`);\n      }\n      extensionList.push(extension);\n      resolvedCache = null;\n    },\n    extensions: () => extensionList,\n    raw: () => declarations,\n    getRaw: (surfaceName) => index.get(surfaceName),\n    ancestry,\n    children: (surfaceName) =>\n      declarations.filter((d) => d.inheritsFrom === surfaceName).map((d) => d.surfaceName),\n    all: () => resolvedAll(),\n    get(surfaceName) {\n      resolvedAll();\n      return resolvedIndex.get(surfaceName);\n    },\n    validate: (validateOptions) =>\n      validateDeclarations(resolvedAll() as unknown as readonly ResolvedSurfaceDeclaration[], {\n        ...validateOptions,\n        extensions: [...(validateOptions?.extensions ?? []), ...(extensionList as DeclarationExtension[])],\n        baselineNames: validateOptions?.baselineNames ?? [...baselineNames],\n      }),\n  };\n  return registry;\n}\n"],"mappings":"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","names":["a","b"]}

package/dist/declare.d.cts

@@ -0,0 +1,334 @@
+/**
+ * Matrx Alchemy — Declare types (CONTRACT §2.1).
+ *
+ * A declaration is plain JSON data (chair ruling N2): no functions, no classes,
+ * no React. Runtime behaviour lives in `MountedSurface` (`/declare/host`) and in
+ * handler registrations, never here. Zero React, zero `@ai-matrx/agents`.
+ */
+type Json = null | boolean | number | string | Json[] | {
+    [key: string]: Json;
+};
+/** Unchanged from `ui_surface_value_type_chk`. */
+type ValueType = "string" | "number" | "boolean" | "object" | "array" | "document";
+type Classification = "ordinary" | "secret" | "credential";
+/** Persisted (CONTRACT §2.7). Projection enforces it before any value leaves. */
+interface Sensitivity {
+    /** false = never leaves through Operate. Default true. */
+    exportable: boolean;
+    /** secret/credential are always excluded; no caller can relax this. Default "ordinary". */
+    classification: Classification;
+    /** Pre-checked in the preparation workspace. Default true. */
+    includedByDefault: boolean;
+}
+interface ValueGroup {
+    key: string;
+    label: string;
+    sortOrder: number;
+    description?: string;
+}
+/** The four runtime slots a capture fills (absorbs page-capture). */
+type LiveSlot = "selection" | "on-demand" | "errors" | "requests";
+interface DeclaredValue {
+    name: string;
+    label: string;
+    description: string;
+    valueType: ValueType;
+    /** Registered content-ir kind key (DB: kind_key). */
+    valueKind?: string;
+    alwaysAvailable: boolean;
+    typicalCharCount: number;
+    autoContext?: boolean;
+    group?: string;
+    sortOrder?: number;
+    sensitivity?: Partial<Sensitivity>;
+    /** Filled at capture time from a live slot instead of the scope. */
+    liveSlot?: LiveSlot;
+    /** "request" values drop out of "Only the data". Default "data". */
+    role?: "data" | "request";
+}
+/** Where a write lands. "stream" = applied live, op by op, into an editable text. */
+type WriteMode = "draft" | "entity" | "ui" | "stream";
+/** Who may apply WITHOUT a click. "queued" = filed for an organization's review. */
+type ApplyPolicy = "manual" | "ask" | "auto" | "queued";
+/** The WidgetHandle text op set, unchanged in meaning. */
+type StreamOp = "replace" | "insert_before" | "insert_after" | "prepend" | "append" | "patch";
+interface WriteTarget {
+    name: string;
+    label: string;
+    description: string;
+    valueType: ValueType;
+    valueKind?: string;
+    /** Read twin (evidence loop). Required when patchable or mode === "stream". */
+    updatesValue?: string;
+    patchable?: boolean;
+    approvalComparison?: "text-replacement";
+    mode: WriteMode;
+    /** Required iff mode === "stream". */
+    streamOps?: readonly StreamOp[];
+    /** Default "manual". Binding overrides may only tighten. */
+    applyPolicy?: ApplyPolicy;
+    destination?: boolean;
+    /** Present when the target writes into an item rather than the screen. */
+    itemType?: string;
+    group?: string;
+    sortOrder?: number;
+}
+/** One kind of thing inside a screen (a row, a message, a code block, a card). */
+interface ItemType {
+    name: string;
+    label: string;
+    description: string;
+    /** Value names that together identify one item. */
+    identity: readonly string[];
+    levels?: readonly string[];
+    entityType?: string;
+    values: readonly DeclaredValue[];
+    writeTargets?: readonly WriteTarget[];
+}
+type Readiness = "verified" | "partial" | "stub";
+/** `ui_surface_execution_mode_check`, unchanged. */
+type ExecutionMode = "python-stream" | "nextjs-stream" | "browser-realtime" | "local-runtime";
+interface ConfigNamespaceDeclaration {
+    namespace: string;
+    label: string;
+    description: string;
+}
+interface EvidenceSourceDeclaration {
+    kind: "processed_document";
+    idValue: string;
+    fileIdValue?: string;
+    labelValue?: string;
+    representation?: "clean" | "raw";
+}
+/**
+ * One screen's declaration. Owning packages add fields (agent roles, client
+ * tools) as EXTENSION SLOTS — by interface extension or declaration merging —
+ * and register a `DeclarationExtension` so validation and the sync cover them.
+ */
+interface SurfaceDeclaration {
+    surfaceName: string;
+    /** REQUIRED. `ui_surface.client_name`; must equal the surfaceName prefix. */
+    client: string;
+    /** REQUIRED. `ui_surface.execution_mode`. */
+    executionMode: ExecutionMode;
+    /** REQUIRED. `ui_surface.description` ("" only where the live row is empty). */
+    description: string;
+    label: string;
+    readiness: Readiness;
+    readinessNote?: string;
+    urlPattern?: string;
+    inheritsFrom?: string;
+    intro?: string;
+    overlayId?: string;
+    values: readonly DeclaredValue[];
+    groups?: readonly ValueGroup[];
+    writeTargets?: readonly WriteTarget[];
+    itemTypes?: readonly ItemType[];
+    liveSlots?: readonly LiveSlot[];
+    configNamespaces?: readonly ConfigNamespaceDeclaration[];
+    evidenceSources?: readonly EvidenceSourceDeclaration[];
+    skipBaselineValues?: boolean;
+}
+interface DeclarationIssue {
+    surfaceName: string;
+    /** "writeTargets/body/updatesValue" */
+    path: string;
+    sentence: string;
+    remedy: string;
+    /** Advisory issues are reported, never fatal (the ratchets). Default "error". */
+    severity?: "error" | "advisory";
+}
+/** A row the sync writes for an extension slot (e.g. agent roles, client tools). */
+interface ExtensionRow {
+    table: string;
+    /** The row's key columns within its table (e.g. ["surface_name", "name"]). */
+    conflict: readonly string[];
+    row: Record<string, Json>;
+}
+interface DeclarationExtension<D extends SurfaceDeclaration = SurfaceDeclaration> {
+    key: string;
+    /** Package or app that owns the slot, shown in check failures. */
+    owner: string;
+    /**
+     * Lists this slot contributes to inheritance: a child inherits its parent's
+     * entries and overrides per identity (child wins).
+     */
+    inheritedLists?: readonly {
+        field: string;
+        identity(entry: unknown): string;
+    }[];
+    validate?(declaration: D, context: ValidationContext): readonly DeclarationIssue[];
+    toRows?(declaration: D): readonly ExtensionRow[];
+}
+interface ValidationContext {
+    /** Every registered declaration, resolved. */
+    all: readonly ResolvedSurfaceDeclaration[];
+}
+type ValueProvenance = {
+    kind: "own";
+} | {
+    kind: "inherited";
+    from: string;
+} | {
+    kind: "baseline";
+};
+type ResolvedValue = DeclaredValue & {
+    provenance: ValueProvenance;
+    groupKey: string;
+    /** Defaults filled. */
+    resolvedSensitivity: Sensitivity;
+};
+interface ResolvedSurfaceDeclaration extends SurfaceDeclaration {
+    contentHash: string;
+    values: readonly ResolvedValue[];
+    groups: readonly ValueGroup[];
+}
+/**
+ * ITEM KEYS. A value or write target is identified by (surfaceName, itemType ?? "", name).
+ * The qualified key "<itemType>.<name>" names an item value; a bare name is a screen value.
+ */
+type QualifiedValueKey = string;
+/** Live slot payloads (page-capture's shapes, kept). */
+interface LiveValues {
+    selection?: {
+        choices: Record<string, Json>;
+        text: string | null;
+    };
+    "on-demand"?: readonly OnDemandSection[];
+    errors?: readonly string[];
+    requests?: readonly RecentRequest[];
+}
+interface OnDemandSection {
+    id: string;
+    title: string;
+    description?: string;
+    role: "data" | "request";
+    brief?: Json;
+    load(signal: AbortSignal): Promise<Json>;
+}
+interface RecentRequest {
+    method: string;
+    path: string;
+    status: string;
+    httpStatus?: number;
+    durationMs?: number;
+    requestId?: string;
+    client?: string;
+    requestBody?: Json;
+    requestBodyNote?: string;
+    errorSentence?: string;
+    timestamp: number;
+}
+/** RAW-FREE. What leaves the package about a clicked item. */
+interface ResolvedItem {
+    itemType: string;
+    identity: Record<string, string>;
+    level?: string;
+    readOnly: boolean;
+}
+
+/** Every value, write-target, item-type and group name (the DB CHECK rule). */
+declare const DECLARATION_NAME_RE: RegExp;
+/** "<client>/<local>" — the surface naming convention. */
+declare const SURFACE_NAME_RE: RegExp;
+/** A bare screen value (`status`) or an item value (`table_row.status`). */
+declare const QUALIFIED_VALUE_KEY_RE: RegExp;
+interface ParsedValueKey {
+    /** "" for a screen-level value. */
+    itemType: string;
+    name: string;
+}
+/** Split a qualified key; null when it is not a valid bare or qualified key. */
+declare function parseQualifiedValueKey(key: string): ParsedValueKey | null;
+declare function qualifyValueKey(itemType: string, name: string): QualifiedValueKey;
+/** The client that owns a surface: its name prefix. */
+declare function surfaceClientOf(surfaceName: string): string;
+
+/** Canonical JSON: keys sorted, undefined dropped, arrays in order. */
+declare function canonicalJson(value: unknown): string;
+/** SHA-256 hex of a UTF-8 string. Pure, synchronous, runs anywhere (no crypto API needed). */
+declare function sha256Hex(input: string): string;
+/**
+ * Drift between clients. Computed, never authored: SHA-256 of the canonical JSON
+ * of the declaration as authored (keys sorted, extension fields included).
+ * Persisted as `ui_surface.content_hash` once that column exists.
+ */
+declare function declarationHash(declaration: SurfaceDeclaration): string;
+
+declare const VALUE_TYPES: readonly ["string", "number", "boolean", "object", "array", "document"];
+declare const WRITE_MODES: readonly ["draft", "entity", "ui", "stream"];
+declare const APPLY_POLICIES: readonly ["manual", "ask", "auto", "queued"];
+declare const STREAM_OPS: readonly ["replace", "insert_before", "insert_after", "prepend", "append", "patch"];
+declare const EXECUTION_MODES: readonly ["python-stream", "nextjs-stream", "browser-realtime", "local-runtime"];
+declare const READINESS: readonly ["verified", "partial", "stub"];
+declare const LIVE_SLOTS: readonly ["selection", "on-demand", "errors", "requests"];
+declare const CLASSIFICATIONS: readonly ["ordinary", "secret", "credential"];
+interface ValidateOptions {
+    /** Registered config namespaces; omitted = not checked. */
+    knownNamespaces?: ReadonlySet<string>;
+    /** Registered content-ir kind slugs; omitted = not checked. */
+    isKnownKind?: (slug: string) => boolean;
+    /** Names every declaration must expose unless `skipBaselineValues`. */
+    baselineNames?: readonly string[];
+    extensions?: readonly DeclarationExtension[];
+}
+declare function validateDeclarations(declarations: readonly ResolvedSurfaceDeclaration[], options?: ValidateOptions): DeclarationIssue[];
+/**
+ * The runtime half: a loaded scope may carry only declared values. Returns one
+ * issue per undeclared key (and per `__item` value its item type does not declare).
+ */
+declare function validateLoadedValues(declaration: Pick<ResolvedSurfaceDeclaration, "surfaceName" | "values" | "itemTypes">, loaded: Record<string, unknown>, options?: {
+    ignore?: readonly string[];
+}): DeclarationIssue[];
+/**
+ * Ownership: no `ui.ui_surface` row may exist without a declaring owner
+ * (CONTRACT §2.1a). `retired` rows (archived, not deleted) are exempt.
+ */
+declare function findOrphanRows(rowNames: readonly string[], declaredNames: Iterable<string>, retired?: Iterable<string>): string[];
+
+declare const RESERVED_GROUP_KEYS: {
+    readonly general: "general";
+    readonly baseline: "baseline";
+    readonly inheritedPrefix: "inherited:";
+};
+/** Group sortOrder bands. Curated groups author 0–899; the rest is reserved. */
+declare const GENERAL_GROUP_ORDER = 850;
+declare const INHERITED_GROUP_ORDER_BASE = 9000;
+declare const BASELINE_GROUP_ORDER = 9900;
+declare const DEFAULT_MAX_INHERITANCE_DEPTH = 3;
+declare const DEFAULT_SENSITIVITY: Sensitivity;
+declare function resolveSensitivity(value: Pick<DeclaredValue, "sensitivity">): Sensitivity;
+type Resolved<D extends SurfaceDeclaration> = Omit<D, "values" | "groups"> & {
+    values: readonly (D["values"][number] & ResolvedValue)[];
+    groups: readonly ValueGroup[];
+    contentHash: string;
+};
+interface DeclarationRegistryOptions {
+    /** Generic values injected into every declaration unless `skipBaselineValues`. */
+    baselineValues?: readonly DeclaredValue[];
+    /** Value names only the platform writes; a declaration claiming one is refused. */
+    reservedValueNames?: readonly string[];
+    /** Write-target names only the platform writes. */
+    reservedWriteTargetNames?: readonly string[];
+    maxInheritanceDepth?: number;
+}
+interface DeclarationRegistry<D extends SurfaceDeclaration> {
+    /** Refuses a second declaration of the same surfaceName. */
+    register(declaration: D): void;
+    registerExtension(extension: DeclarationExtension<D>): void;
+    extensions(): readonly DeclarationExtension<D>[];
+    /** Declarations exactly as authored (inheritance unresolved, no baselines). */
+    raw(): readonly D[];
+    getRaw(surfaceName: string): D | undefined;
+    /** Parent chain, ROOT FIRST. Unknown surfaces return []. */
+    ancestry(surfaceName: string): string[];
+    /** Direct children (declarations naming it in `inheritsFrom`), in declaration order. */
+    children(surfaceName: string): string[];
+    /** Inheritance + baseline + groups resolved; provenance kept. */
+    all(): readonly Resolved<D>[];
+    get(surfaceName: string): Resolved<D> | undefined;
+    validate(options?: ValidateOptions): readonly DeclarationIssue[];
+}
+declare function createDeclarationRegistry<D extends SurfaceDeclaration>(options?: DeclarationRegistryOptions): DeclarationRegistry<D>;
+
+export { APPLY_POLICIES, type ApplyPolicy, BASELINE_GROUP_ORDER, CLASSIFICATIONS, type Classification, type ConfigNamespaceDeclaration, DECLARATION_NAME_RE, DEFAULT_MAX_INHERITANCE_DEPTH, DEFAULT_SENSITIVITY, type DeclarationExtension, type DeclarationIssue, type DeclarationRegistry, type DeclarationRegistryOptions, type DeclaredValue, EXECUTION_MODES, type EvidenceSourceDeclaration, type ExecutionMode, type ExtensionRow, GENERAL_GROUP_ORDER, INHERITED_GROUP_ORDER_BASE, type ItemType, type Json, LIVE_SLOTS, type LiveSlot, type LiveValues, type OnDemandSection, type ParsedValueKey, QUALIFIED_VALUE_KEY_RE, type QualifiedValueKey, READINESS, RESERVED_GROUP_KEYS, type Readiness, type RecentRequest, type Resolved, type ResolvedItem, type ResolvedSurfaceDeclaration, type ResolvedValue, STREAM_OPS, SURFACE_NAME_RE, type Sensitivity, type StreamOp, type SurfaceDeclaration, VALUE_TYPES, type ValidateOptions, type ValidationContext, type ValueGroup, type ValueProvenance, type ValueType, WRITE_MODES, type WriteMode, type WriteTarget, canonicalJson, createDeclarationRegistry, declarationHash, findOrphanRows, parseQualifiedValueKey, qualifyValueKey, resolveSensitivity, sha256Hex, surfaceClientOf, validateDeclarations, validateLoadedValues };