@fayz-ai/core 0.8.0 → 0.8.2

package/dist/index.js

@@ -1,12 +1,12 @@
 export { withAfterHooks } from './chunk-BBDNC3FP.js';
 export { PluginContractError, assertConnectorContract, assertPluginManifestContract } from './chunk-X5THHG6T.js';
-import { getSupabaseClientOptional } from './chunk-ZBIWYDAR.js';
-export { FAYZ_CLOUD_PUBLISHABLE_KEY, FAYZ_CLOUD_URL, clearGlobalCache, createArchetypeProvider, createCacheStore, createFayzApiProvider, createMockProvider, createSupabaseProvider, getActiveTenantId, getFayzCloudClient, getSupabaseClientOptional, globalCache, resolveDataProvider, setActiveTenantId, setGlobalSupabaseClient, stableKey, withCache } from './chunk-ZBIWYDAR.js';
-export { clearEntityRegistry, deriveEntityKey, getAllEntities, getEntityByKey, registerEntity } from './chunk-WKZVSKEU.js';
-import { getBlock, getScaffold } from './chunk-CHGX6UYR.js';
-export { PLUGIN_API_VERSION, PluginRuntimeProvider, Registry, blockRegistry, componentRegistry, definePlugin, getBlock, getComponent, getDashboardWidgets, getMetric, getPage, getPlugin, getPluginFactory, getScaffold, getWidgetsForZone, isCustomId, listBlocks, listMetrics, listPluginFactories, listPlugins, metricRegistry, pageRegistry, pluginFactoryRegistry, pluginRegistry, registerBlock, registerComponent, registerMetric, registerPage, registerPlugin, registerPluginFactory, registerScaffold, resolvePluginComponent, resolvePluginRuntime, scaffoldRegistry, useConnectorsForPlugin, usePluginRuntime, usePluginRuntimeOptional } from './chunk-CHGX6UYR.js';
-import { getCurrentLocale } from './chunk-KNIVT6XZ.js';
-export { I18nProvider, coreTranslations, getCurrentLocale, mergeTranslations, registerTranslations, setCurrentLocale, setLocaleStore, useI18nConfig, useTranslation } from './chunk-KNIVT6XZ.js';
+import { getSupabaseClientOptional } from './chunk-XJKW2JRW.js';
+export { FAYZ_CLOUD_PUBLISHABLE_KEY, FAYZ_CLOUD_URL, clearGlobalCache, countByTenant, createArchetypeProvider, createCacheStore, createFayzApiProvider, createMockProvider, createSupabaseProvider, getActiveTenantId, getFayzCloudClient, getSupabaseClientOptional, globalCache, invalidateCount, resolveDataProvider, setActiveTenantId, setGlobalSupabaseClient, stableKey, withCache } from './chunk-XJKW2JRW.js';
+export { clearEntityRegistry, deriveEntityKey, getAllEntities, getEntityByKey, registerEntity } from './chunk-CU64QI4A.js';
+import { getBlock, getScaffold } from './chunk-YH25Y4FW.js';
+export { PLUGIN_API_VERSION, PluginRuntimeProvider, Registry, blockRegistry, componentRegistry, definePlugin, getBlock, getComponent, getDashboardWidgets, getMetric, getPage, getPlugin, getPluginFactory, getScaffold, getWidgetsForZone, isCustomId, listBlocks, listMetrics, listPluginFactories, listPlugins, metricRegistry, pageRegistry, pluginFactoryRegistry, pluginRegistry, registerBlock, registerComponent, registerMetric, registerPage, registerPlugin, registerPluginFactory, registerScaffold, resolvePluginComponent, resolvePluginRuntime, scaffoldRegistry, useConnectorsForPlugin, usePluginRuntime, usePluginRuntimeOptional } from './chunk-YH25Y4FW.js';
+import { getCurrentLocale } from './chunk-JHGXROKV.js';
+export { I18nProvider, coreTranslations, getCurrentLocale, mergeTranslations, registerTranslations, setCurrentLocale, setLocaleStore, useI18nConfig, useTranslation } from './chunk-JHGXROKV.js';
 export { hashRouterAdapter, windowRouterAdapter } from './chunk-Y2C2FBQP.js';
 export { FayzRuntimeError, createFayzRuntimeClient } from './chunk-7RTUHSKY.js';
 import * as React2 from 'react';
@@ -84,6 +84,92 @@ function maskDigitCount(mask) {
   for (const ch of mask) if (ch === "#") n++;
   return n;
 }
+
+// src/address/index.ts
+function normalizePostalCode(value) {
+  return (value || "").replace(/\D/g, "");
+}
+function formatPostalCode(value) {
+  const digits = normalizePostalCode(value).slice(0, 8);
+  return digits.length > 5 ? `${digits.slice(0, 5)}-${digits.slice(5)}` : digits;
+}
+function isValidPostalCode(value) {
+  return normalizePostalCode(value).length === 8;
+}
+var CACHE_KEY = "fayz.postal.cache.v1";
+var memoryCache = /* @__PURE__ */ new Map();
+function readCache(code) {
+  const hit = memoryCache.get(code);
+  if (hit) return hit;
+  try {
+    const raw = globalThis.localStorage?.getItem(CACHE_KEY);
+    if (!raw) return void 0;
+    const all = JSON.parse(raw);
+    const stored = all[code];
+    if (stored) memoryCache.set(code, stored);
+    return stored;
+  } catch {
+    return void 0;
+  }
+}
+function writeCache(code, address) {
+  memoryCache.set(code, address);
+  try {
+    const store = globalThis.localStorage;
+    if (!store) return;
+    const raw = store.getItem(CACHE_KEY);
+    const all = raw ? JSON.parse(raw) : {};
+    all[code] = address;
+    store.setItem(CACHE_KEY, JSON.stringify(all));
+  } catch {
+  }
+}
+function clearPostalCache() {
+  memoryCache.clear();
+  try {
+    globalThis.localStorage?.removeItem(CACHE_KEY);
+  } catch {
+  }
+}
+function createViaCepProvider(options) {
+  const fetcher = options?.fetcher ?? globalThis.fetch;
+  return {
+    async lookup(postalCode) {
+      const code = normalizePostalCode(postalCode);
+      if (code.length !== 8) return null;
+      const response = await fetcher(`https://viacep.com.br/ws/${code}/json/`);
+      if (!response.ok) throw new Error(`Consulta de CEP falhou (${response.status})`);
+      const data = await response.json();
+      if (data.erro === true || data.erro === "true" || !data.localidade) return null;
+      return {
+        postalCode: code,
+        street: data.logradouro ?? "",
+        district: data.bairro ?? "",
+        city: data.localidade,
+        state: (data.uf ?? "").toUpperCase(),
+        country: "BR",
+        cityCode: data.ibge || void 0
+      };
+    }
+  };
+}
+var _provider = null;
+function setPostalLookupProvider(provider) {
+  _provider = provider;
+}
+function getPostalLookupProvider() {
+  if (!_provider) _provider = createViaCepProvider();
+  return _provider;
+}
+async function lookupPostalCode(postalCode) {
+  const code = normalizePostalCode(postalCode);
+  if (code.length !== 8) return null;
+  const cached = readCache(code);
+  if (cached) return cached;
+  const address = await getPostalLookupProvider().lookup(code);
+  if (address) writeCache(code, address);
+  return address;
+}
 var MANAGED = "data-fayz-seo";
 function seoOrigin() {
   return typeof window !== "undefined" ? window.location.origin : "";
@@ -329,7 +415,7 @@ function BlockChildren({ node }) {
 }
 
 // src/manifest/index.ts
-var CURRENT_MANIFEST_VERSION = 2;
+var CURRENT_MANIFEST_VERSION = 3;
 var migrations = /* @__PURE__ */ new Map();
 var supportedBackendProviders = ["supabase", "fayz-api", "fayz-shop", "mock", "custom"];
 var supportedPageSections = /* @__PURE__ */ new Set(["main", "secondary", "settings"]);
@@ -343,7 +429,10 @@ var allowedManifestKeys = /* @__PURE__ */ new Set([
   "permissions",
   "billing",
   "entities",
-  "surfaces"
+  "surfaces",
+  "limitDeclarations",
+  "agent",
+  "contractHash"
 ]);
 var allowedBackendKeys = /* @__PURE__ */ new Set(["provider", "projectRef", "url", "adapterId", "options"]);
 var allowedSurfaceKeys = /* @__PURE__ */ new Set(["scaffold", "options", "plugins", "pages"]);
@@ -355,6 +444,7 @@ var manifestIdPattern = /^[a-z0-9][a-z0-9-]*$/;
 function registerManifestMigration(fromVersion, fn) {
   migrations.set(fromVersion, fn);
 }
+registerManifestMigration(2, (m) => m);
 function migrateManifest(input) {
   let m = { ...input };
   let version = typeof m.manifestVersion === "number" ? m.manifestVersion : 1;
@@ -392,6 +482,21 @@ function validateManifest(m) {
   validateLooseObject(manifest.theme, "manifest.theme", problems);
   validateLooseObject(manifest.permissions, "manifest.permissions", problems);
   validateLooseObject(manifest.billing, "manifest.billing", problems);
+  validateLooseObject(manifest.agent, "manifest.agent", problems);
+  if (manifest.contractHash !== void 0 && !isNonEmptyString(manifest.contractHash)) {
+    problems.push("manifest.contractHash must be a non-empty string");
+  }
+  if (manifest.limitDeclarations !== void 0) {
+    if (!Array.isArray(manifest.limitDeclarations)) {
+      problems.push("manifest.limitDeclarations must be an array");
+    } else {
+      manifest.limitDeclarations.forEach((decl, index) => {
+        if (!isRecord(decl) || !isNonEmptyString(decl.key) || !isNonEmptyString(decl.table)) {
+          problems.push(`manifest.limitDeclarations[${index}] must declare key and table`);
+        }
+      });
+    }
+  }
   if (manifest.entities !== void 0) {
     if (!Array.isArray(manifest.entities)) {
       problems.push("manifest.entities must be an array");
@@ -552,7 +657,7 @@ function validateBlockManifest(block, path, problems) {
 function addUnsupportedKeys(value, allowedKeys, path, problems) {
   for (const key of Object.keys(value)) {
     if (!allowedKeys.has(key)) {
-      problems.push(`${path}.${key} is not part of AppManifest v2`);
+      problems.push(`${path}.${key} is not part of AppManifest v${CURRENT_MANIFEST_VERSION}`);
     }
   }
 }
@@ -573,106 +678,710 @@ function isNonEmptyString(value) {
   return typeof value === "string" && value.trim().length > 0;
 }
 
+// src/manifest/serialize.ts
+function sortValue(value) {
+  if (Array.isArray(value)) return value.map(sortValue);
+  if (value !== null && typeof value === "object") {
+    const record = value;
+    const out = {};
+    for (const key of Object.keys(record).sort()) {
+      const v = record[key];
+      if (v !== void 0) out[key] = sortValue(v);
+    }
+    return out;
+  }
+  return value;
+}
+function serializeManifest(manifest) {
+  const { contractHash: _omit, ...rest } = manifest;
+  return `${JSON.stringify(sortValue(rest), null, 2)}
+`;
+}
+async function computeContractHash(manifest) {
+  const bytes = new TextEncoder().encode(serializeManifest(manifest));
+  const digest = await globalThis.crypto.subtle.digest("SHA-256", bytes);
+  return Array.from(new Uint8Array(digest)).map((b) => b.toString(16).padStart(2, "0")).join("");
+}
+async function serializeManifestWithHash(manifest) {
+  const contractHash = await computeContractHash(manifest);
+  const { contractHash: _omit, ...rest } = manifest;
+  return `${JSON.stringify(sortValue({ ...rest, contractHash }), null, 2)}
+`;
+}
+
 // src/manifest/app-manifest.schema.json
 var app_manifest_schema_default = {
   $schema: "https://json-schema.org/draft/2020-12/schema",
-  $id: "https://fayz.ai/schemas/app-manifest/v2.json",
+  $id: "https://fayz.ai/schemas/app-manifest/v3.json",
   title: "Fayz AppManifest",
   description: "The canonical, JSON-serializable definition of a Fayz app. Code is referenced by registry id; never inlined.",
   type: "object",
-  required: ["manifestVersion", "id", "name", "surfaces"],
+  required: [
+    "manifestVersion",
+    "id",
+    "name",
+    "surfaces"
+  ],
   additionalProperties: false,
   properties: {
     manifestVersion: {
       type: "integer",
-      const: 2,
+      const: 3,
       description: "Current AppManifest schema version. Older or newer versions require an explicit SDK migration before validation."
     },
-    id: { type: "string", minLength: 1, pattern: "^[a-z0-9][a-z0-9-]*$" },
-    name: { type: "string", minLength: 1 },
+    id: {
+      type: "string",
+      minLength: 1,
+      pattern: "^[a-z0-9][a-z0-9-]*$"
+    },
+    name: {
+      type: "string",
+      minLength: 1
+    },
     backend: {
       type: "object",
       additionalProperties: false,
-      required: ["provider"],
+      required: [
+        "provider"
+      ],
       properties: {
-        provider: { enum: ["supabase", "fayz-api", "fayz-shop", "mock", "custom"] },
-        projectRef: { type: "string", minLength: 1 },
-        url: { type: "string", minLength: 1 },
-        adapterId: { type: "string", minLength: 1 },
-        options: { type: "object" }
+        provider: {
+          enum: [
+            "supabase",
+            "fayz-api",
+            "fayz-shop",
+            "mock",
+            "custom"
+          ]
+        },
+        projectRef: {
+          type: "string",
+          minLength: 1
+        },
+        url: {
+          type: "string",
+          minLength: 1
+        },
+        adapterId: {
+          type: "string",
+          minLength: 1
+        },
+        options: {
+          type: "object"
+        }
+      }
+    },
+    locale: {
+      type: "object"
+    },
+    theme: {
+      type: "object"
+    },
+    permissions: {
+      type: "object"
+    },
+    billing: {
+      type: "object"
+    },
+    entities: {
+      type: "array",
+      items: {
+        type: "object"
       }
     },
-    locale: { type: "object" },
-    theme: { type: "object" },
-    permissions: { type: "object" },
-    billing: { type: "object" },
-    entities: { type: "array", items: { type: "object" } },
     surfaces: {
       type: "object",
       minProperties: 1,
-      additionalProperties: { $ref: "#/$defs/surface" }
+      additionalProperties: {
+        $ref: "#/$defs/surface"
+      }
+    },
+    limitDeclarations: {
+      type: "array",
+      description: "Resolved 4-layer limit-declaration merge (core < entity-derived < plugin < app) so server runtimes count exactly what the client counts.",
+      items: {
+        type: "object",
+        required: [
+          "key",
+          "table"
+        ],
+        additionalProperties: false,
+        properties: {
+          key: {
+            type: "string",
+            minLength: 1
+          },
+          label: {
+            type: "string"
+          },
+          table: {
+            type: "string",
+            minLength: 1
+          },
+          kindFilter: {
+            type: "string"
+          },
+          period: {
+            enum: [
+              "month",
+              "total"
+            ]
+          }
+        }
+      }
+    },
+    agent: {
+      $ref: "#/$defs/agentContract"
+    },
+    contractHash: {
+      type: "string",
+      minLength: 1,
+      description: "sha256 of the canonical serialization (excluding this field)."
     }
   },
   $defs: {
     surface: {
       type: "object",
-      required: ["scaffold"],
+      required: [
+        "scaffold"
+      ],
       additionalProperties: false,
       properties: {
-        scaffold: { type: "string", minLength: 1 },
-        options: { type: "object" },
-        plugins: { type: "array", items: { $ref: "#/$defs/pluginRef" } },
-        pages: { type: "array", items: { $ref: "#/$defs/page" } }
+        scaffold: {
+          type: "string",
+          minLength: 1
+        },
+        options: {
+          type: "object"
+        },
+        plugins: {
+          type: "array",
+          items: {
+            $ref: "#/$defs/pluginRef"
+          }
+        },
+        pages: {
+          type: "array",
+          items: {
+            $ref: "#/$defs/page"
+          }
+        }
       }
     },
     pluginRef: {
       type: "object",
-      required: ["id"],
+      required: [
+        "id"
+      ],
       additionalProperties: false,
       properties: {
-        id: { type: "string", minLength: 1 },
-        config: { type: "object" },
-        enabled: { type: "boolean" }
+        id: {
+          type: "string",
+          minLength: 1
+        },
+        config: {
+          type: "object"
+        },
+        enabled: {
+          type: "boolean"
+        }
       }
     },
     page: {
       type: "object",
-      required: ["path"],
+      required: [
+        "path"
+      ],
       additionalProperties: false,
       description: "Exactly one of blocks/entity/component must be set.",
       properties: {
-        path: { type: "string", minLength: 1 },
-        label: { type: "string" },
-        icon: { type: "string" },
-        section: { enum: ["main", "secondary", "settings"] },
-        blocks: { type: "array", items: { $ref: "#/$defs/block" } },
-        entity: { type: "string", minLength: 1 },
-        component: { type: "string", minLength: 1 },
+        path: {
+          type: "string",
+          minLength: 1
+        },
+        label: {
+          type: "string"
+        },
+        icon: {
+          type: "string"
+        },
+        section: {
+          enum: [
+            "main",
+            "secondary",
+            "settings"
+          ]
+        },
+        blocks: {
+          type: "array",
+          items: {
+            $ref: "#/$defs/block"
+          }
+        },
+        entity: {
+          type: "string",
+          minLength: 1
+        },
+        component: {
+          type: "string",
+          minLength: 1
+        },
         permission: {
           type: "object",
-          required: ["feature", "action"],
+          required: [
+            "feature",
+            "action"
+          ],
           additionalProperties: false,
           properties: {
-            feature: { type: "string", minLength: 1 },
-            action: { type: "string", minLength: 1 }
+            feature: {
+              type: "string",
+              minLength: 1
+            },
+            action: {
+              type: "string",
+              minLength: 1
+            }
           }
         }
       },
       oneOf: [
-        { required: ["blocks"] },
-        { required: ["entity"] },
-        { required: ["component"] }
+        {
+          required: [
+            "blocks"
+          ]
+        },
+        {
+          required: [
+            "entity"
+          ]
+        },
+        {
+          required: [
+            "component"
+          ]
+        }
       ]
     },
     block: {
       type: "object",
-      required: ["type"],
+      required: [
+        "type"
+      ],
+      additionalProperties: false,
+      properties: {
+        type: {
+          type: "string",
+          minLength: 1
+        },
+        id: {
+          type: "string"
+        },
+        props: {
+          type: "object"
+        },
+        children: {
+          type: "array",
+          items: {
+            $ref: "#/$defs/block"
+          }
+        }
+      }
+    },
+    agentContract: {
+      type: "object",
+      additionalProperties: false,
+      description: "Everything a server-side agent runtime needs to operate the app without a browser. Derived from code at publish; synced to Fayz as the versioned AgentContract.",
+      properties: {
+        persona: {
+          type: "object",
+          additionalProperties: false,
+          properties: {
+            name: {
+              type: "string"
+            },
+            systemPrompt: {
+              type: "string"
+            },
+            icon: {
+              type: "string"
+            }
+          }
+        },
+        executionPlane: {
+          enum: [
+            "client",
+            "server"
+          ]
+        },
+        entities: {
+          type: "array",
+          items: {
+            $ref: "#/$defs/entityContract"
+          }
+        },
+        tools: {
+          type: "array",
+          items: {
+            $ref: "#/$defs/aiToolContract"
+          }
+        },
+        registries: {
+          type: "array",
+          items: {
+            type: "object",
+            required: [
+              "pluginId",
+              "id"
+            ],
+            additionalProperties: false,
+            properties: {
+              pluginId: {
+                type: "string",
+                minLength: 1
+              },
+              id: {
+                type: "string",
+                minLength: 1
+              },
+              entityKey: {
+                type: "string"
+              },
+              readOnly: {
+                type: "boolean"
+              }
+            }
+          }
+        },
+        declaredFeatures: {
+          type: "array",
+          items: {
+            type: "object"
+          }
+        },
+        rpcs: {
+          type: "array",
+          items: {
+            $ref: "#/$defs/rpcContract"
+          }
+        },
+        domainKnowledge: {
+          type: "object",
+          additionalProperties: false,
+          properties: {
+            statuses: {
+              type: "object"
+            },
+            scheduleDefaults: {
+              type: "object"
+            },
+            businessRules: {
+              type: "array",
+              items: {
+                type: "object",
+                required: [
+                  "id",
+                  "description"
+                ],
+                additionalProperties: false,
+                properties: {
+                  id: {
+                    type: "string",
+                    minLength: 1
+                  },
+                  description: {
+                    type: "string",
+                    minLength: 1
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    entityContract: {
+      type: "object",
+      required: [
+        "key",
+        "label",
+        "data",
+        "fields"
+      ],
       additionalProperties: false,
       properties: {
-        type: { type: "string", minLength: 1 },
-        id: { type: "string" },
-        props: { type: "object" },
-        children: { type: "array", items: { $ref: "#/$defs/block" } }
+        key: {
+          type: "string",
+          minLength: 1
+        },
+        label: {
+          type: "string",
+          minLength: 1
+        },
+        labelPlural: {
+          type: "string"
+        },
+        limitKey: {
+          type: "string"
+        },
+        data: {
+          type: "object",
+          required: [
+            "table"
+          ],
+          additionalProperties: false,
+          properties: {
+            table: {
+              type: "string",
+              minLength: 1
+            },
+            schema: {
+              type: "string"
+            },
+            tenantScoped: {
+              type: "boolean"
+            },
+            tenantIdColumn: {
+              type: "string"
+            },
+            searchColumns: {
+              type: "array",
+              items: {
+                type: "string"
+              }
+            },
+            selectColumns: {
+              type: "string"
+            },
+            columnMap: {
+              type: "object"
+            },
+            archetype: {
+              type: "string"
+            },
+            archetypeKind: {
+              type: "string"
+            },
+            filters: {
+              type: "object"
+            }
+          }
+        },
+        fields: {
+          type: "array",
+          items: {
+            type: "object",
+            required: [
+              "key",
+              "label",
+              "type"
+            ],
+            additionalProperties: false,
+            properties: {
+              key: {
+                type: "string",
+                minLength: 1
+              },
+              label: {
+                type: "string"
+              },
+              type: {
+                type: "string",
+                minLength: 1
+              },
+              required: {
+                type: "boolean"
+              },
+              searchable: {
+                type: "boolean"
+              },
+              hint: {
+                type: "string"
+              },
+              options: {
+                type: "array",
+                items: {
+                  type: "string"
+                }
+              },
+              relationTable: {
+                type: "string"
+              }
+            }
+          }
+        },
+        permission: {
+          type: "object",
+          required: [
+            "feature",
+            "action"
+          ],
+          additionalProperties: false,
+          properties: {
+            feature: {
+              type: "string",
+              minLength: 1
+            },
+            action: {
+              type: "string",
+              minLength: 1
+            }
+          }
+        }
+      }
+    },
+    aiToolContract: {
+      type: "object",
+      required: [
+        "id",
+        "name",
+        "description",
+        "mode"
+      ],
+      additionalProperties: false,
+      properties: {
+        id: {
+          type: "string",
+          minLength: 1
+        },
+        name: {
+          type: "string",
+          minLength: 1,
+          pattern: "^[a-zA-Z0-9_-]{1,64}$"
+        },
+        description: {
+          type: "string",
+          minLength: 1
+        },
+        mode: {
+          enum: [
+            "read",
+            "persist"
+          ]
+        },
+        parameters: {
+          type: "object"
+        },
+        permission: {
+          type: "object",
+          required: [
+            "feature",
+            "action"
+          ],
+          additionalProperties: false,
+          properties: {
+            feature: {
+              type: "string",
+              minLength: 1
+            },
+            action: {
+              type: "string",
+              minLength: 1
+            }
+          }
+        },
+        limitKey: {
+          type: "string"
+        },
+        execution: {
+          oneOf: [
+            {
+              type: "object",
+              required: [
+                "plane",
+                "kind",
+                "rpc"
+              ],
+              additionalProperties: false,
+              properties: {
+                plane: {
+                  const: "server"
+                },
+                kind: {
+                  const: "rpc"
+                },
+                rpc: {
+                  type: "string",
+                  minLength: 1
+                }
+              }
+            },
+            {
+              type: "object",
+              required: [
+                "plane",
+                "kind",
+                "entity"
+              ],
+              additionalProperties: false,
+              properties: {
+                plane: {
+                  const: "server"
+                },
+                kind: {
+                  const: "entity_read"
+                },
+                entity: {
+                  type: "string",
+                  minLength: 1
+                }
+              }
+            },
+            {
+              type: "object",
+              required: [
+                "plane"
+              ],
+              additionalProperties: false,
+              properties: {
+                plane: {
+                  const: "client"
+                }
+              }
+            }
+          ]
+        },
+        requiresConfirmation: {
+          type: "boolean"
+        },
+        pluginId: {
+          type: "string"
+        },
+        category: {
+          type: "string"
+        }
+      }
+    },
+    rpcContract: {
+      type: "object",
+      required: [
+        "name",
+        "kind",
+        "description"
+      ],
+      additionalProperties: false,
+      properties: {
+        name: {
+          type: "string",
+          minLength: 1,
+          pattern: "^agent_[a-z0-9_]+$"
+        },
+        kind: {
+          enum: [
+            "read",
+            "write"
+          ]
+        },
+        description: {
+          type: "string",
+          minLength: 1
+        },
+        payloadSchema: {
+          type: "object"
+        },
+        audits: {
+          type: "boolean"
+        }
       }
     }
   }
@@ -757,6 +1466,6 @@ function routeModule(path) {
   return path.replace(/^\/+/, "").split("/")[0] ?? "";
 }
 
-export { BlockChildren, BlockRenderer, COUNTRIES, CURRENT_MANIFEST_VERSION, DEFAULT_COUNTRY, WidgetZone, absoluteUrl, app_manifest_schema_default as appManifestSchema, applySeo, breadcrumbJsonLd, buildCSV, createEventBus, createSafeDataProvider, defineApp, downloadCSV, eventBus, exportCSV, formatCurrency, formatDate, formatDateTime, getActiveLocale, getCountry, getDefaultCurrency, maskDigitCount, maskPhone, migrateManifest, navHistoryBack, organizationJsonLd, recordNavigation, registerManifestMigration, renderApp, renderBlocks, routeModule, seoOrigin, setDefaultCurrency, unmaskPhone, useManifest, useNavHistoryStore, useNavReferrer, useOnEvent, useSeo, validateManifest };
+export { BlockChildren, BlockRenderer, COUNTRIES, CURRENT_MANIFEST_VERSION, DEFAULT_COUNTRY, WidgetZone, absoluteUrl, app_manifest_schema_default as appManifestSchema, applySeo, breadcrumbJsonLd, buildCSV, clearPostalCache, computeContractHash, createEventBus, createSafeDataProvider, createViaCepProvider, defineApp, downloadCSV, eventBus, exportCSV, formatCurrency, formatDate, formatDateTime, formatPostalCode, getActiveLocale, getCountry, getDefaultCurrency, getPostalLookupProvider, isValidPostalCode, lookupPostalCode, maskDigitCount, maskPhone, migrateManifest, navHistoryBack, normalizePostalCode, organizationJsonLd, recordNavigation, registerManifestMigration, renderApp, renderBlocks, routeModule, seoOrigin, serializeManifest, serializeManifestWithHash, setDefaultCurrency, setPostalLookupProvider, unmaskPhone, useManifest, useNavHistoryStore, useNavReferrer, useOnEvent, useSeo, validateManifest };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map