@x12i/catalox 3.3.0 → 3.4.5

package/dist/src/catalox/catalox.d.ts

@@ -1,4 +1,4 @@
-import type { AppCatalogBootstrap, AppCatalogEntry, CatalogDescriptor, CatalogItemReference, CatalogItemValidationReport, CatalogGetItemResult, CatalogListResult, CatalogNativeItemOptions, CatalogQueryOptions, MoveNativeCatalogItemScopeInput, CatalogValidationReport, CreateCatalogInput, ExportInventoryData, ExportInventoryInput, InventoryReportData, InventoryReportInput, ItemId, StoreId, StoreAppBindingRecord, ListAppCatalogsInput, UnifiedCatalogItem, UpdateCatalogInput } from "../contracts/index.js";
+import type { AppCatalogBootstrap, AppCatalogEntry, IdentityCatalogEntry, CatalogDescriptor, CatalogItemReference, CatalogItemValidationReport, CatalogGetItemResult, CatalogListResult, CatalogListResultWithOutcome, CatalogGetItemResultWithOutcome, CatalogNativeItemOptions, CatalogQueryOptions, MoveNativeCatalogItemScopeInput, CatalogValidationReport, CreateCatalogInput, ExportInventoryData, ExportInventoryInput, InventoryReportData, InventoryReportInput, ItemId, StoreId, StoreAppBindingRecord, ListAppCatalogsInput, ListCatalogsForIdentityInput, UnifiedCatalogItem, UpdateCatalogInput, StoreCatalogBootstrap, ListAllCatalogsInput, FindCatalogsInput, FindCatalogsByAiInput, CatalogSummary, AiCatalogMatchResult, SearchCatalogItemsInput, FindCatalogItemsByAiInput, AiCatalogItemMatchResult, CreateCatalogItemByAiInput, CreateCatalogItemByAiResult, ModifyCatalogItemByAiInput, ModifyCatalogItemByAiResult } from "../contracts/index.js";
 import type { AppId, CatalogId } from "../contracts/ids.js";
 import { ApiCatalogAdapter } from "../adapters/api/api-adapter.js";
 import { MongoCatalogAdapter } from "../adapters/mongo/mongo-adapter.js";
@@ -19,6 +19,7 @@ import { ReferenceStore } from "../firebase/reference-store.js";
 import { RendererSnippetStore } from "../firebase/renderer-snippet-store.js";
 import { SnapshotStore } from "../firebase/snapshot-store.js";
 import { StoreAppBindingStore } from "../firebase/store-app-binding-store.js";
+import { IdentityBindingStore } from "../firebase/identity-binding-store.js";
 import type { BackupDataInput, BackupDataResult } from "../contracts/backup.js";
 import type { ExportAllFirestoreCollectionsToGcsInput, ExportAllFirestoreCollectionsToGcsResult, ExportFirestoreCollectionToGcsInput, ExportFirestoreCollectionToGcsResult, RestoreAllFirestoreCollectionsFromGcsInput, RestoreAllFirestoreCollectionsFromGcsResult, RestoreFirestoreCollectionFromGcsInput, RestoreFirestoreCollectionFromGcsResult } from "../contracts/gcs-firestore-transfer.js";
 import type { CompareAllFirestoreCollectionsWithGcsManifestInput, CompareAllFirestoreCollectionsWithGcsResult, CompareFirestoreCollectionWithGcsInput, CompareFirestoreCollectionWithGcsResult } from "../contracts/gcs-firestore-compare.js";
@@ -36,6 +37,7 @@ export type CataloxDependencies = {
     catalogs: CatalogStore;
     bindings: BindingStore;
     storeAppBindings?: StoreAppBindingStore;
+    identityBindings?: IdentityBindingStore;
     definitions: DefinitionStore;
     mappings: MappingStore;
     descriptors: DescriptorStore;
@@ -81,14 +83,36 @@ export declare class Catalox {
     private normalizeListFetchScope;
     private buildAppliedScope;
     private fetchGlobalPhysicalRows;
-    private fetchTenantPhysicalRows;
+    private fetchScopedPhysicalRows;
     private decorateItem;
     listAppCatalogs(context: CataloxContext, input?: ListAppCatalogsInput): Promise<AppCatalogEntry[]>;
+    private identityBindingMatches;
+    /**
+     * vNext: identity-first discovery, backed by `catalogIdentityBindings`.
+     * This does not replace app bindings; host policy may intersect/union them.
+     */
+    listCatalogsForIdentity(context: CataloxContext, input: ListCatalogsForIdentityInput): Promise<IdentityCatalogEntry[]>;
+    /**
+     * App-agnostic discovery: list catalog metadata across all apps.
+     * Visibility default: hide hidden catalogs unless `context.superAdmin`.
+     */
+    listAllCatalogs(context: CataloxContext, input?: ListAllCatalogsInput): Promise<CatalogSummary[]>;
+    findCatalogs(context: CataloxContext, input: FindCatalogsInput): Promise<CatalogSummary[]>;
+    findCatalogsByAi(context: CataloxContext, input: FindCatalogsByAiInput): Promise<AiCatalogMatchResult>;
     getCatalogDescriptor(context: CataloxContext, catalogId: CatalogId): Promise<CatalogDescriptor | null>;
     getCatalogRendererSnippet(context: CataloxContext, catalogId: CatalogId, role: "core" | "list" | "grid" | "item" | "report" | "dashboard", mode?: "readonly" | "editable"): Promise<import("../contracts/renderer-snippets.js").CatalogRendererSnippetRecord | null>;
     getAppCatalogBootstrap(context: CataloxContext, appId?: AppId): Promise<AppCatalogBootstrap>;
+    /** vNext: store-first bootstrap (store -> apps -> catalog descriptors). */
+    getStoreCatalogBootstrap(context: CataloxContext, storeId: StoreId): Promise<StoreCatalogBootstrap>;
     listCatalogItems(context: CataloxContext, catalogId: CatalogId, options?: CatalogQueryOptions): Promise<CatalogListResult>;
+    /**
+     * vNext: same as `listCatalogItems` but returns a semantic outcome wrapper instead of throwing for common cases.
+     * This is intended for embedders/BFFs that need to distinguish empty vs denied vs misconfigured.
+     */
+    listCatalogItemsWithOutcome(context: CataloxContext, catalogId: CatalogId, options?: CatalogQueryOptions): Promise<CatalogListResultWithOutcome>;
     getCatalogItem(context: CataloxContext, catalogId: CatalogId, itemId: ItemId, options?: CatalogNativeItemOptions): Promise<CatalogGetItemResult>;
+    /** vNext: `getCatalogItem` wrapper with `CataloxOutcome` semantics. */
+    getCatalogItemWithOutcome(context: CataloxContext, catalogId: CatalogId, itemId: ItemId, options?: CatalogNativeItemOptions): Promise<CatalogGetItemResultWithOutcome>;
     validateCatalog(_context: CataloxContext, _catalogId: CatalogId): Promise<CatalogValidationReport>;
     validateCatalogItem(_context: CataloxContext, _catalogId: CatalogId, _itemId: ItemId): Promise<CatalogItemValidationReport>;
     getCatalogItemReferences(context: CataloxContext, catalogId: CatalogId, itemId: ItemId): Promise<CatalogItemReference[]>;
@@ -98,6 +122,10 @@ export declare class Catalox {
     updateCatalog(_context: CataloxContext, _catalogId: CatalogId, _patch: UpdateCatalogInput): Promise<import("../contracts/catalogs.js").CatalogRecord>;
     getCatalog(_context: CataloxContext, catalogId: CatalogId): Promise<import("../contracts/catalogs.js").CatalogRecord | null>;
     listCatalogs(_context: CataloxContext, _options?: CatalogQueryOptions): Promise<import("../contracts/catalogs.js").CatalogRecord[]>;
+    searchCatalogItems(context: CataloxContext, catalogId: CatalogId, input: SearchCatalogItemsInput): Promise<CatalogListResult>;
+    findCatalogItemsByAi(context: CataloxContext, catalogId: CatalogId, input: FindCatalogItemsByAiInput): Promise<AiCatalogItemMatchResult>;
+    createCatalogItemByAi(context: CataloxContext, catalogId: CatalogId, input: CreateCatalogItemByAiInput): Promise<CreateCatalogItemByAiResult>;
+    modifyCatalogItemByAi(context: CataloxContext, catalogId: CatalogId, itemId: ItemId, input: ModifyCatalogItemByAiInput): Promise<ModifyCatalogItemByAiResult>;
     bindCatalogToApp(_context: CataloxContext, _input: import("../contracts/bindings.js").BindCatalogInput): Promise<any>;
     unbindCatalogFromApp(_context: CataloxContext, _appId: AppId, _catalogId: CatalogId): Promise<void>;
     bindAppToStore(context: CataloxContext, input: {

package/dist/src/catalox/catalox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalox.d.ts","sourceRoot":"","sources":["../../../src/catalox/catalox.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EAEjB,oBAAoB,EACpB,2BAA2B,EAC3B,oBAAoB,EACpB,iBAAiB,EACjB,wBAAwB,EACxB,mBAAmB,EACnB,+BAA+B,EAG/B,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,MAAM,EACN,OAAO,EACP,qBAAqB,EACrB,oBAAoB,EAEpB,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAM5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAEzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAmB9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAwB,MAAM,4BAA4B,CAAC;AAGnH,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAA+B,MAAM,kCAAkC,CAAC;AAChG,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAE9E,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,KAAK,EACV,uCAAuC,EACvC,wCAAwC,EACxC,mCAAmC,EACnC,oCAAoC,EACpC,0CAA0C,EAC1C,2CAA2C,EAC3C,sCAAsC,EACtC,uCAAuC,EACxC,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,EACV,kDAAkD,EAClD,2CAA2C,EAC3C,sCAAsC,EACtC,uCAAuC,EACxC,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EACV,kCAAkC,EAClC,mCAAmC,EACnC,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,0BAA0B,EAAE,4BAA4B,EAAE,MAAM,wCAAwC,CAAC;AAGvH,OAAO,EAAoC,4BAA4B,EAAE,MAAM,wCAAwC,CAAC;AAExH,OAAO,EAEL,KAAK,+BAA+B,EACpC,KAAK,gCAAgC,EACtC,MAAM,gDAAgD,CAAC;AACxD,OAAO,EAEL,KAAK,gCAAgC,EACtC,MAAM,wCAAwC,CAAC;AAYhD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,qBAAqB,CAAC;AAO7B,OAAO,KAAK,EACV,yBAAyB,EACzB,6BAA6B,EAE7B,2BAA2B,EAC3B,4BAA4B,EAC5B,kCAAkC,EAClC,+BAA+B,EAChC,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,0BAA0B,EAC1B,2BAA2B,EAC5B,MAAM,mCAAmC,CAAC;AAE3C,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,YAAY,CAAC;IACvB,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;IACxC,WAAW,EAAE,eAAe,CAAC;IAC7B,QAAQ,EAAE,YAAY,CAAC;IACvB,WAAW,EAAE,eAAe,CAAC;IAC7B,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;IACxC,UAAU,EAAE,cAAc,CAAC;IAC3B,WAAW,EAAE,eAAe,CAAC;IAC7B,SAAS,EAAE,aAAa,CAAC;IACzB,QAAQ,EAAE,YAAY,CAAC;IACvB,cAAc,EAAE,cAAc,CAAC;IAC/B,gBAAgB,EAAE,qBAAqB,CAAC;IAExC,KAAK,EAAE,oBAAoB,CAAC;IAC5B,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,qFAAqF;IACrF,aAAa,CAAC,EAAE,iBAAiB,CAAC;CACnC,CAAC;AAEF,qBAAa,OAAO;IACN,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,mBAAmB;IAEtD,OAAO,CAAC,oBAAoB;YAiBd,qBAAqB;IAwBnC,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,WAAW;YAIL,sBAAsB;IAcpC,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,uBAAuB;YAiBjB,yBAAyB;IAsDjC,yBAAyB,CAC7B,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,SAAS,EACpB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;KAAE,GAC5H,OAAO,CAAC,oBAAoB,CAAC;IAqD1B,yBAAyB,CAC7B,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,CAAA;KAAE,GACzJ,OAAO,CAAC,oBAAoB,CAAC;IAiEhC,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,wBAAwB;IAchC,OAAO,CAAC,uBAAuB;IAM/B,OAAO,CAAC,iBAAiB;YASX,uBAAuB;YAcvB,uBAAuB;YA0DvB,YAAY;IAuBpB,eAAe,CACnB,OAAO,EAAE,cAAc,EACvB,KAAK,CAAC,EAAE,oBAAoB,GAC3B,OAAO,CAAC,eAAe,EAAE,CAAC;IAuCvB,oBAAoB,CACxB,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAM9B,yBAAyB,CAC7B,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,EAChE,IAAI,CAAC,EAAE,UAAU,GAAG,UAAU;IAS1B,sBAAsB,CAC1B,OAAO,EAAE,cAAc,EACvB,KAAK,CAAC,EAAE,KAAK,GACZ,OAAO,CAAC,mBAAmB,CAAC;IAWzB,gBAAgB,CACpB,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,SAAS,EACpB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,iBAAiB,CAAC;IAsHvB,cAAc,CAClB,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,oBAAoB,CAAC;IAmE1B,eAAe,CACnB,QAAQ,EAAE,cAAc,EACxB,UAAU,EAAE,SAAS,GACpB,OAAO,CAAC,uBAAuB,CAAC;IAI7B,mBAAmB,CACvB,QAAQ,EAAE,cAAc,EACxB,UAAU,EAAE,SAAS,EACrB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,2BAA2B,CAAC;IAIjC,wBAAwB,CAC5B,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAM5B,qBAAqB,CACzB,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAO5B,MAAM,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,KAAK;IAG9C,aAAa,CAAC,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,kBAAkB;IA2GlE,aAAa,CAAC,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,kBAAkB;IAazF,UAAU,CAAC,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS;IAGzD,YAAY,CAAC,QAAQ,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,mBAAmB;IAGrE,gBAAgB,CAAC,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,0BAA0B,EAAE,gBAAgB;IAqBtG,oBAAoB,CAAC,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS;IAUnF,cAAc,CAClB,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAC5E,OAAO,CAAC,qBAAqB,CAAC;IAyB3B,kBAAkB,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB1F,gBAAgB,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAS7F,aAAa,CACjB,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE;QAAE,SAAS,EAAE,SAAS,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAA;KAAE,GACxF,OAAO,CAAC,IAAI,CAAC;IAeV,aAAa,CACjB,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,SAAS,EAAE,SAAS,CAAC;QAAC,MAAM,CAAC,EAAE;YAAE,OAAO,CAAC,EAAE,OAAO,CAAC;YAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;YAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;SAAE,CAAA;KAAE,GACpH,OAAO,CAAC,IAAI,CAAC;IAsBV,uBAAuB,CAAC,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAGxG,uBAAuB,CAC3B,QAAQ,EAAE,cAAc,EACxB,UAAU,EAAE,SAAS,EACrB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,CAAC,EAAE,wBAAwB,GAClC,OAAO,CAAC,kBAAkB,CAAC;IAkExB,uBAAuB,CAC3B,QAAQ,EAAE,cAAc,EACxB,UAAU,EAAE,SAAS,EACrB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,wBAAwB,GAClC,OAAO,CAAC,IAAI,CAAC;IA2BV,0BAA0B,CAC9B,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,+BAA+B,GACrC,OAAO,CAAC,IAAI,CAAC;IAgCV,uBAAuB,CAC3B,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,kBAAkB,CAAC;IAuDxB,6BAA6B,CACjC,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACpC,OAAO,CAAC,IAAI,CAAC;IAuDhB,0BAA0B,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC;IAIxD,wBAAwB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,UAAO,GAAG,MAAM;IAIzD,eAAe,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,GAAE,oBAAyB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA+DxG,qBAAqB,CACzB,OAAO,EAAE,cAAc,EACvB,KAAK,GAAE,oBAAyB,EAChC,MAAM,UAAO,GACZ,OAAO,CAAC,MAAM,CAAC;IAKZ,uBAAuB,CAC3B,OAAO,EAAE,cAAc,EACvB,KAAK,GAAE,oBAAyB,GAC/B,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,mBAAmB,CAAA;KAAE,CAAC;IAqHrD,iBAAiB,CAAC,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS;;;;;;;IA2DjE,UAAU,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAW7F,qHAAqH;IAC/G,oBAAoB,CACxB,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,0BAA0B,CAAC;IActC;;;OAGG;IACG,6BAA6B,CACjC,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,kCAAkC,GACxC,OAAO,CAAC,mCAAmC,CAAC;IAc/C,qHAAqH;IAC/G,kBAAkB,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAIrH,8EAA8E;IACxE,yBAAyB,CAC7B,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,GACjD,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,4BAA4B,CAAC,CAAC,CAAC;IAIpE;;;OAGG;IACH,wCAAwC,CACtC,QAAQ,EAAE,0BAA0B,EACpC,YAAY,EAAE,MAAM,GACnB,4BAA4B;IAI/B;;;OAGG;IACG,oCAAoC,CACxC,QAAQ,EAAE,cAAc,EACxB,KAAK,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GACnD,OAAO,CAAC,gCAAgC,EAAE,CAAC;IAWxC,0BAA0B,CAC9B,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,+BAA+B,GACrC,OAAO,CAAC,gCAAgC,CAAC;IAc5C;;;OAGG;IACG,8BAA8B,CAClC,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,IAAI,CAAC,mCAAmC,EAAE,WAAW,CAAC,GAC5D,OAAO,CAAC,oCAAoC,CAAC;IAOhD,6HAA6H;IACvH,kCAAkC,CACtC,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,IAAI,CAAC,uCAAuC,EAAE,WAAW,CAAC,GAChE,OAAO,CAAC,wCAAwC,CAAC;IAOpD,8FAA8F;IACxF,iCAAiC,CACrC,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,IAAI,CAAC,sCAAsC,EAAE,WAAW,CAAC,GAC/D,OAAO,CAAC,uCAAuC,CAAC;IAOnD,mEAAmE;IAC7D,6CAA6C,CACjD,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,IAAI,CAAC,0CAA0C,EAAE,WAAW,CAAC,GACnE,OAAO,CAAC,2CAA2C,CAAC;IAOvD,8FAA8F;IACxF,uCAAuC,CAC3C,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,IAAI,CAAC,sCAAsC,EAAE,WAAW,CAAC,GAC/D,OAAO,CAAC,uCAAuC,CAAC;IAOnD,2FAA2F;IACrF,6CAA6C,CACjD,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,IAAI,CAAC,kDAAkD,EAAE,WAAW,CAAC,GAC3E,OAAO,CAAC,2CAA2C,CAAC;IAOjD,sBAAsB,CAC1B,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,SAAS,EACpB,KAAK,CAAC,EAAE,2BAA2B,GAClC,OAAO,CAAC,4BAA4B,CAAC;IAOlC,0BAA0B,CAC9B,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;QAAE,KAAK,EAAE,6BAA6B,CAAC;QAAC,OAAO,EAAE,yBAAyB,CAAA;KAAE,GAAG,IAAI,CAAC;IAUzF,6BAA6B,CACjC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,kCAAkC,GACxC,OAAO,CAAC,kBAAkB,CAAC;IAkCxB,0BAA0B,CAC9B,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,+BAA+B,GACrC,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IA+C3C,aAAa,CACjB,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,mBAAmB,CAAC;IAKzB,qBAAqB,CACzB,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,2BAA2B,CAAC;IAejC,aAAa,CACjB,OAAO,EAAE,cAAc,EACvB,aAAa,EAAE,SAAS,EACxB,WAAW,EAAE,SAAS,EACtB,KAAK,GAAE,kBAAuB,GAC7B,OAAO,CAAC,mBAAmB,CAAC;IAK/B;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,YAAY;CAGnD"}
+{"version":3,"file":"catalox.d.ts","sourceRoot":"","sources":["../../../src/catalox/catalox.ts"],"names":[],"mappings":"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"}

package/dist/src/catalox/catalox.js

@@ -26,7 +26,10 @@ import { ReferenceStore } from "../firebase/reference-store.js";
 import { RendererSnippetStore } from "../firebase/renderer-snippet-store.js";
 import { SnapshotStore } from "../firebase/snapshot-store.js";
 import { StoreAppBindingStore } from "../firebase/store-app-binding-store.js";
+import { IdentityBindingStore } from "../firebase/identity-binding-store.js";
 import { nativeItemsCollectionId } from "../firebase/catalog-data-paths.js";
+import { applyCatalogVisibilityFilter, filterCatalogsByText, findCatalogsByAi as findCatalogsByAiHelper, summarizeCatalog, } from "./catalog-discovery.js";
+import { loadAiFunctions } from "./ai-functions-loader.js";
 import { runBackupData, pruneGcsBackupRuns } from "./backup-data.js";
 import { runUndoFirestoreRestore } from "./restore-firestore-backup.js";
 import { runRestoreFirestoreBackupFromGcs, runDeleteCataloxGcsBackupRun } from "./restore-firestore-backup-from-gcs.js";
@@ -313,15 +316,26 @@ export class Catalox {
     normalizeListFetchScope(scope) {
         if (!scope)
             return undefined;
-        if (!scope.accountId && !scope.agentId && !scope.userId && scope.superAdmin !== true)
+        const hasCoords = Boolean(scope.accountId) ||
+            Boolean(scope.groupId) ||
+            Boolean(scope.userId) ||
+            Boolean(scope.channelId) ||
+            Boolean(scope.visitorId) ||
+            Boolean(scope.domainId) ||
+            Boolean(scope.agentId);
+        if (!hasCoords && scope.superAdmin !== true)
             return undefined;
         return scope;
     }
     buildAppliedScope(scope, effectiveSuperList) {
         return {
             ...(scope?.accountId != null ? { accountId: scope.accountId } : {}),
+            ...(scope?.groupId != null ? { groupId: scope.groupId } : {}),
             ...(scope?.agentId != null ? { agentId: scope.agentId } : {}),
+            ...(scope?.domainId != null ? { domainId: scope.domainId } : {}),
             ...(scope?.userId != null ? { userId: scope.userId } : {}),
+            ...(scope?.channelId != null ? { channelId: scope.channelId } : {}),
+            ...(scope?.visitorId != null ? { visitorId: scope.visitorId } : {}),
             superAdmin: effectiveSuperList,
         };
     }
@@ -335,7 +349,7 @@ export class Catalox {
         }
         return recs;
     }
-    async fetchTenantPhysicalRows(catalogId, fetch, listOpts) {
+    async fetchScopedPhysicalRows(catalogId, fetch, listOpts) {
         const userFe = { ...(listOpts.filterEq ?? {}) };
         const cap = { ...listOpts, limit: 500, offset: 0 };
         const seen = new Set();
@@ -350,34 +364,41 @@ export class Catalox {
             }
         };
         take(await this.deps.nativeItems.list(catalogId, { ...cap, filterEq: { ...userFe, scopeLayer: "global" } }));
+        // Legacy v1 scopes (still queried for back-compat)
         if (fetch.accountId) {
-            take(await this.deps.nativeItems.list(catalogId, {
-                ...cap,
-                filterEq: { ...userFe, scopeLayer: "account", scopeAccountId: fetch.accountId },
-            }));
+            take(await this.deps.nativeItems.list(catalogId, { ...cap, filterEq: { ...userFe, scopeLayer: "account", scopeAccountId: fetch.accountId } }));
             if (fetch.agentId) {
-                take(await this.deps.nativeItems.list(catalogId, {
-                    ...cap,
-                    filterEq: {
-                        ...userFe,
-                        scopeLayer: "agent",
-                        scopeAccountId: fetch.accountId,
-                        scopeAgentId: fetch.agentId,
-                    },
-                }));
+                take(await this.deps.nativeItems.list(catalogId, { ...cap, filterEq: { ...userFe, scopeLayer: "agent", scopeAccountId: fetch.accountId, scopeAgentId: fetch.agentId } }));
             }
             if (fetch.userId) {
-                take(await this.deps.nativeItems.list(catalogId, {
-                    ...cap,
-                    filterEq: {
-                        ...userFe,
-                        scopeLayer: "user",
-                        scopeAccountId: fetch.accountId,
-                        scopeUserId: fetch.userId,
-                    },
-                }));
+                take(await this.deps.nativeItems.list(catalogId, { ...cap, filterEq: { ...userFe, scopeLayer: "user", scopeAccountId: fetch.accountId, scopeUserId: fetch.userId } }));
             }
         }
+        // v2 scoped rows: best-effort prefilter by available indexed coordinates.
+        const scopedQueries = [];
+        if (fetch.accountId)
+            scopedQueries.push({ scopeLayer: "scoped", scopeAccountId: fetch.accountId });
+        if (fetch.userId)
+            scopedQueries.push({ scopeLayer: "scoped", scopeUserId: fetch.userId });
+        if (fetch.channelId)
+            scopedQueries.push({ scopeLayer: "scoped", scopeChannelId: fetch.channelId });
+        if (fetch.visitorId)
+            scopedQueries.push({ scopeLayer: "scoped", scopeVisitorId: fetch.visitorId });
+        if (fetch.domainId)
+            scopedQueries.push({ scopeLayer: "scoped", scopeDomainId: fetch.domainId });
+        if (fetch.agentId)
+            scopedQueries.push({ scopeLayer: "scoped", scopeAgentId: fetch.agentId });
+        if (fetch.groupId)
+            scopedQueries.push({ scopeLayer: "scoped", scopeGroupId: fetch.groupId });
+        if (scopedQueries.length) {
+            for (const q of scopedQueries) {
+                take(await this.deps.nativeItems.list(catalogId, { ...cap, filterEq: { ...userFe, ...q } }));
+            }
+        }
+        else {
+            // Fallback: if caller provided coordinates but none mapped to a queryable indexed field, list scoped broadly.
+            take(await this.deps.nativeItems.list(catalogId, { ...cap, filterEq: { ...userFe, scopeLayer: "scoped" } }));
+        }
         return filterPhysicalForTenantFetch(out, fetch);
     }
     async decorateItem(catalogId, item) {
@@ -432,6 +453,99 @@ export class Catalox {
         }
         return out.filter((e) => (input?.includeHidden ? true : e.visibility !== "hidden"));
     }
+    identityBindingMatches(bindingIdentity, query) {
+        const pairs = [
+            ["accountId", "accountId"],
+            ["groupId", "groupId"],
+            ["userId", "userId"],
+            ["channelId", "channelId"],
+            ["visitorId", "visitorId"],
+            ["domainId", "domainId"],
+            ["agentId", "agentId"],
+        ];
+        for (const [bk, qk] of pairs) {
+            const b = bindingIdentity[bk];
+            if (b == null)
+                continue;
+            const q = query[qk];
+            if (q == null)
+                return false;
+            if (String(q) !== String(b))
+                return false;
+        }
+        return true;
+    }
+    /**
+     * vNext: identity-first discovery, backed by `catalogIdentityBindings`.
+     * This does not replace app bindings; host policy may intersect/union them.
+     */
+    async listCatalogsForIdentity(context, input) {
+        if (!this.deps.identityBindings) {
+            throw new Error("identityBindings dependency is not configured");
+        }
+        const bindings = await this.deps.identityBindings.listAll();
+        const catalogs = await this.deps.catalogs.listAll();
+        const byId = new Map(catalogs.map((c) => [c.catalogId, c]));
+        const out = [];
+        for (const b of bindings) {
+            if (b.status !== "active")
+                continue;
+            if (!this.identityBindingMatches(b.identity, input.identity))
+                continue;
+            const cat = byId.get(b.catalogId);
+            if (!cat)
+                continue;
+            if (!input.includeDisabled && cat.status !== "active")
+                continue;
+            const descriptor = await this.deps.descriptors.get(cat.catalogId);
+            const description = descriptor?.descriptor.description ?? cat.description;
+            const itemLabel = descriptor?.descriptor.itemLabel ?? cat.itemLabel;
+            const visibility = descriptor?.descriptor.visibility;
+            const descriptorVersion = descriptor?.descriptorVersion;
+            const metadata = descriptor?.descriptor.metadata ?? cat.metadata;
+            out.push({
+                catalogId: cat.catalogId,
+                label: descriptor?.descriptor.label ?? cat.name,
+                ...(description != null ? { description } : {}),
+                ...(itemLabel != null ? { itemLabel } : {}),
+                sourceMode: cat.sourceMode,
+                ...(cat.mappedSourceType != null ? { mappedSourceType: cat.mappedSourceType } : {}),
+                status: cat.status,
+                ...(visibility != null ? { visibility } : {}),
+                access: b.access,
+                ...(descriptorVersion != null ? { descriptorVersion } : {}),
+                ...(metadata != null ? { metadata } : {}),
+            });
+        }
+        return out.filter((e) => (input.includeHidden ? true : e.visibility !== "hidden"));
+    }
+    /**
+     * App-agnostic discovery: list catalog metadata across all apps.
+     * Visibility default: hide hidden catalogs unless `context.superAdmin`.
+     */
+    async listAllCatalogs(context, input) {
+        const catalogs = await this.deps.catalogs.listAll();
+        const out = [];
+        for (const c of catalogs) {
+            const d = await this.deps.descriptors.get(c.catalogId);
+            out.push(summarizeCatalog(c, d));
+        }
+        return applyCatalogVisibilityFilter(out, context, input);
+    }
+    async findCatalogs(context, input) {
+        const all = await this.listAllCatalogs(context, {
+            ...(input.includeDisabled != null ? { includeDisabled: input.includeDisabled } : {}),
+            ...(input.includeHidden != null ? { includeHidden: input.includeHidden } : {}),
+        });
+        return filterCatalogsByText(all, input);
+    }
+    async findCatalogsByAi(context, input) {
+        const all = await this.listAllCatalogs(context, {
+            ...(input.includeDisabled != null ? { includeDisabled: input.includeDisabled } : {}),
+            ...(input.includeHidden != null ? { includeHidden: input.includeHidden } : {}),
+        });
+        return findCatalogsByAiHelper({ query: input.query, catalogs: all, input });
+    }
     async getCatalogDescriptor(context, catalogId) {
         await this.deps.authz.requireBindingAccess(context, context.appId, catalogId, "read");
         const rec = await this.deps.descriptors.get(catalogId);
@@ -455,6 +569,18 @@ export class Catalox {
         }
         return { appId: resolved, catalogs: descriptors };
     }
+    /** vNext: store-first bootstrap (store -> apps -> catalog descriptors). */
+    async getStoreCatalogBootstrap(context, storeId) {
+        const apps = await this.listAppsForStore(context, storeId);
+        const activeApps = apps.filter((a) => a.status === "active").map((a) => a.appId);
+        const out = { storeId: String(storeId), apps: [] };
+        for (const appId of activeApps) {
+            const appCtx = { ...context, appId };
+            const bootstrap = await this.getAppCatalogBootstrap(appCtx, appId);
+            out.apps.push({ appId, catalogs: bootstrap.catalogs });
+        }
+        return out;
+    }
     async listCatalogItems(context, catalogId, options) {
         await this.deps.authz.requireBindingAccess(context, context.appId, catalogId, "read");
         const catalog = await this.deps.catalogs.get(catalogId);
@@ -487,11 +613,11 @@ export class Catalox {
             if (wantsSuperList) {
                 physical = await this.deps.nativeItems.list(catalogId, baseListOpts);
             }
-            else if (!rawScope?.accountId && !rawScope?.agentId && !rawScope?.userId) {
+            else if (!rawScope || (!rawScope.accountId && !rawScope.groupId && !rawScope.userId && !rawScope.channelId && !rawScope.visitorId && !rawScope.domainId && !rawScope.agentId)) {
                 physical = await this.fetchGlobalPhysicalRows(catalogId, baseListOpts);
             }
             else {
-                physical = await this.fetchTenantPhysicalRows(catalogId, rawScope, baseListOpts);
+                physical = await this.fetchScopedPhysicalRows(catalogId, rawScope, baseListOpts);
             }
             const merged = mergeNativePhysicalRows(physical, descRec.descriptor.identity, String(context.appId), wantsSuperList);
             const off = listQueryOptions?.offset ?? 0;
@@ -547,6 +673,29 @@ export class Catalox {
         }
         throw new CatalogAdapterError({ catalogId, reason: "unknown_adapter_type" });
     }
+    /**
+     * vNext: same as `listCatalogItems` but returns a semantic outcome wrapper instead of throwing for common cases.
+     * This is intended for embedders/BFFs that need to distinguish empty vs denied vs misconfigured.
+     */
+    async listCatalogItemsWithOutcome(context, catalogId, options) {
+        try {
+            const result = await this.listCatalogItems(context, catalogId, options);
+            if (result.listOutcome === "mapping_blocked")
+                return { outcome: "mapping_blocked", result };
+            if (!result.items.length)
+                return { outcome: "empty", result };
+            return { outcome: "ok", result };
+        }
+        catch (e) {
+            if (e instanceof CatalogAccessDeniedError)
+                return { outcome: "denied", error: e };
+            if (e instanceof CatalogNotFoundError)
+                return { outcome: "misconfigured", error: e };
+            if (e instanceof CatalogAdapterError)
+                return { outcome: "misconfigured", error: e };
+            throw e;
+        }
+    }
     async getCatalogItem(context, catalogId, itemId, options) {
         await this.deps.authz.requireBindingAccess(context, context.appId, catalogId, "read");
         const catalog = await this.deps.catalogs.get(catalogId);
@@ -586,7 +735,7 @@ export class Catalox {
             if (!rows.length)
                 return { outcome: "not_found" };
             const scope = options?.scope;
-            const filtered = scope?.accountId || scope?.agentId || scope?.userId
+            const filtered = scope?.accountId || scope?.groupId || scope?.userId || scope?.channelId || scope?.visitorId || scope?.domainId || scope?.agentId
                 ? filterPhysicalForTenantFetch(rows, scope)
                 : rows.filter((r) => isGlobalPhysicalRow(r));
             const merged = mergeNativePhysicalRows(filtered, descRec.descriptor.identity, String(context.appId), false);
@@ -608,6 +757,26 @@ export class Catalox {
             return { outcome: "not_found" };
         return { outcome: "found", item: await this.decorateItem(catalogId, first) };
     }
+    /** vNext: `getCatalogItem` wrapper with `CataloxOutcome` semantics. */
+    async getCatalogItemWithOutcome(context, catalogId, itemId, options) {
+        try {
+            const result = await this.getCatalogItem(context, catalogId, itemId, options);
+            if (result.outcome === "mapping_blocked")
+                return { outcome: "mapping_blocked", result };
+            if (result.outcome === "not_found")
+                return { outcome: "empty", result };
+            return { outcome: "ok", result };
+        }
+        catch (e) {
+            if (e instanceof CatalogAccessDeniedError)
+                return { outcome: "denied", error: e };
+            if (e instanceof CatalogNotFoundError)
+                return { outcome: "misconfigured", error: e };
+            if (e instanceof CatalogAdapterError)
+                return { outcome: "misconfigured", error: e };
+            throw e;
+        }
+    }
     async validateCatalog(_context, _catalogId) {
         return { isValid: true, issues: [] };
     }
@@ -751,6 +920,197 @@ export class Catalox {
     async listCatalogs(_context, _options) {
         return this.deps.catalogs.listAll();
     }
+    async searchCatalogItems(context, catalogId, input) {
+        const poolLimit = input.poolLimit ?? 200;
+        const limit = input.limit ?? 50;
+        const base = await this.listCatalogItems(context, catalogId, {
+            limit: poolLimit,
+            ...(input.scope ? { scope: input.scope } : {}),
+            ...(input.filter ? { filter: input.filter } : {}),
+            ...(input.sort ? { sort: input.sort } : {}),
+        });
+        if (base.listOutcome !== "ok")
+            return base;
+        const q = String(input.text ?? "").toLowerCase().trim();
+        if (!q)
+            return { ...base, items: [] };
+        const textFields = input.textFields ?? [];
+        const filtered = base.items.filter((it) => {
+            const parts = [];
+            if (it.title)
+                parts.push(String(it.title));
+            if (it.subtitle)
+                parts.push(String(it.subtitle));
+            const data = it.data;
+            for (const p of textFields) {
+                const v = this.readPath(data, p);
+                if (v == null)
+                    continue;
+                parts.push(typeof v === "string" || typeof v === "number" ? String(v) : JSON.stringify(v));
+            }
+            return parts.join(" ").toLowerCase().includes(q);
+        });
+        return { ...base, items: filtered.slice(0, limit) };
+    }
+    async findCatalogItemsByAi(context, catalogId, input) {
+        const poolLimit = input.poolLimit ?? 300;
+        const base = await this.listCatalogItems(context, catalogId, {
+            limit: poolLimit,
+            ...(input.scope ? { scope: input.scope } : {}),
+            ...(input.filter ? { filter: input.filter } : {}),
+            ...(input.sort ? { sort: input.sort } : {}),
+        });
+        if (base.listOutcome !== "ok")
+            return { query: input.query, hits: [], noMatch: true };
+        const items = base.items;
+        const candidates = items.map((it) => {
+            const title = it.title ? String(it.title) : "";
+            const subtitle = it.subtitle ? String(it.subtitle) : "";
+            const label = [title, subtitle].filter(Boolean).join(" — ") || String(it.itemId);
+            return {
+                id: String(it.itemId),
+                label,
+                metadata: { catalogId: String(catalogId) },
+            };
+        });
+        const { match } = await loadAiFunctions();
+        const res = await match({
+            query: input.query,
+            candidates,
+            ...(input.guidance ? { guidance: input.guidance } : {}),
+            ...(input.maxResults != null ? { maxResults: input.maxResults } : {}),
+            ...(input.minScore != null ? { minScore: input.minScore } : {}),
+            ...(input.allowNoMatch != null ? { allowNoMatch: input.allowNoMatch } : {}),
+            ...(input.returnReasons != null ? { returnReasons: input.returnReasons } : {}),
+            ...(input.additionalInstructions ? { additionalInstructions: input.additionalInstructions } : {}),
+            ...(input.maxCandidates != null ? { maxCandidates: input.maxCandidates } : {}),
+            ...(input.mode ? { mode: input.mode } : {}),
+            ...(input.client ? { client: input.client } : {}),
+            ...(input.model ? { model: input.model } : {}),
+            ...(input.temperature != null ? { temperature: input.temperature } : {}),
+            ...(input.maxTokens != null ? { maxTokens: input.maxTokens } : {}),
+            ...(input.timeoutMs != null ? { timeoutMs: input.timeoutMs } : {}),
+            ...(input.vendor != null ? { vendor: input.vendor } : {}),
+        });
+        const byId = new Map(items.map((it) => [String(it.itemId), it]));
+        const hits = res.matches
+            .map((m) => {
+            const it = byId.get(String(m.id));
+            if (!it)
+                return null;
+            return { itemId: it.itemId, score: m.score, ...(m.reason ? { reason: m.reason } : {}), item: it };
+        })
+            .filter(Boolean);
+        return { query: input.query, hits, noMatch: Boolean(res.noMatch) };
+    }
+    async createCatalogItemByAi(context, catalogId, input) {
+        await this.deps.authz.requireBindingAccess(context, context.appId, catalogId, "write");
+        const descRec = await this.deps.descriptors.get(catalogId);
+        if (!descRec)
+            throw new CatalogAdapterError({ catalogId, reason: "missing_descriptor" });
+        const rules = descRec.descriptor.creationRules;
+        if (!rules)
+            throw new CatalogAdapterError({ catalogId, reason: "creation_rules_missing" });
+        if (rules.enabled === false)
+            throw new CatalogAdapterError({ catalogId, reason: "creation_rules_disabled" });
+        const catalog = await this.deps.catalogs.get(catalogId);
+        if (!catalog)
+            throw new CatalogNotFoundError({ catalogId });
+        const existingLimit = input.existingItemsSampleLimit ?? 0;
+        const existingItemsSample = existingLimit > 0
+            ? (await this.listCatalogItems(context, catalogId, { limit: existingLimit })).items.map((i) => i.data)
+            : undefined;
+        const { createItem } = await loadAiFunctions();
+        const result = await createItem({
+            ...(descRec.descriptor.itemLabel ? { itemLabel: descRec.descriptor.itemLabel } : {}),
+            creationRules: rules,
+            provided: input.provided,
+            fieldSchema: (descRec.descriptor.queryableFields ?? []),
+            ...(existingItemsSample ? { existingItemsSample } : {}),
+            ...(input.additionalInstructions ? { additionalInstructions: input.additionalInstructions } : {}),
+            ...(input.mode ? { mode: input.mode } : {}),
+            ...(input.model ? { model: input.model } : {}),
+            ...(input.client ? { client: input.client } : {}),
+            ...(input.temperature != null ? { temperature: input.temperature } : {}),
+            ...(input.maxTokens != null ? { maxTokens: input.maxTokens } : {}),
+            ...(input.timeoutMs != null ? { timeoutMs: input.timeoutMs } : {}),
+            ...(input.vendor != null ? { vendor: input.vendor } : {}),
+        }, undefined);
+        const out = {
+            catalogId,
+            proposed: result.item ?? {},
+            issues: (result.issues ?? []),
+            ...(result.missingInputs ? { missingInputs: result.missingInputs } : {}),
+            noCreate: Boolean(result.noCreate),
+            ...(result.reason ? { reason: result.reason } : {}),
+        };
+        const autoPersist = input.autoPersist === true;
+        const hasErrors = (result.issues ?? []).some((i) => i?.severity === "error");
+        if (autoPersist && !out.noCreate && !hasErrors) {
+            if (catalog.sourceMode !== "native") {
+                throw new CatalogAdapterError({ catalogId, reason: "autopersist_mapped_unsupported" });
+            }
+            const writePayload = input.scope != null ? { ...out.proposed, scope: input.scope } : out.proposed;
+            out.item = await this.upsertNativeCatalogItem(context, catalogId, writePayload);
+        }
+        return out;
+    }
+    async modifyCatalogItemByAi(context, catalogId, itemId, input) {
+        await this.deps.authz.requireBindingAccess(context, context.appId, catalogId, "write");
+        const descRec = await this.deps.descriptors.get(catalogId);
+        if (!descRec)
+            throw new CatalogAdapterError({ catalogId, reason: "missing_descriptor" });
+        const rules = descRec.descriptor.modificationRules;
+        if (!rules)
+            throw new CatalogAdapterError({ catalogId, reason: "modification_rules_missing" });
+        if (rules.enabled === false)
+            throw new CatalogAdapterError({ catalogId, reason: "modification_rules_disabled" });
+        const catalog = await this.deps.catalogs.get(catalogId);
+        if (!catalog)
+            throw new CatalogNotFoundError({ catalogId });
+        const got = await this.getCatalogItem(context, catalogId, itemId, input.nativeItemOptions);
+        if (got.outcome === "mapping_blocked") {
+            throw new CatalogAdapterError({ catalogId, reason: "mapping_validation_failed", issues: got.issues });
+        }
+        if (got.outcome === "not_found")
+            throw new CatalogNotFoundError({ catalogId, itemId });
+        const currentItem = (got.item.data ?? {});
+        const { modifyItem } = await loadAiFunctions();
+        const result = await modifyItem({
+            ...(descRec.descriptor.itemLabel ? { itemLabel: descRec.descriptor.itemLabel } : {}),
+            currentItem: currentItem,
+            modificationRules: rules,
+            patch: input.patch,
+            fieldSchema: (descRec.descriptor.queryableFields ?? []),
+            ...(input.additionalInstructions ? { additionalInstructions: input.additionalInstructions } : {}),
+            ...(input.mode ? { mode: input.mode } : {}),
+            ...(input.model ? { model: input.model } : {}),
+            ...(input.client ? { client: input.client } : {}),
+            ...(input.temperature != null ? { temperature: input.temperature } : {}),
+            ...(input.maxTokens != null ? { maxTokens: input.maxTokens } : {}),
+            ...(input.timeoutMs != null ? { timeoutMs: input.timeoutMs } : {}),
+            ...(input.vendor != null ? { vendor: input.vendor } : {}),
+        }, undefined);
+        const out = {
+            catalogId,
+            itemId,
+            proposed: result.item ?? {},
+            diff: (result.diff ?? []),
+            issues: (result.issues ?? []),
+            ...(result.violatedRules ? { violatedRules: result.violatedRules } : {}),
+            noChange: Boolean(result.noChange),
+            ...(result.reason ? { reason: result.reason } : {}),
+        };
+        const autoPersist = input.autoPersist === true;
+        const hasErrors = (result.issues ?? []).some((i) => i?.severity === "error");
+        if (autoPersist && !out.noChange && !hasErrors) {
+            if (catalog.sourceMode !== "native") {
+                throw new CatalogAdapterError({ catalogId, reason: "autopersist_mapped_unsupported" });
+            }
+            out.item = await this.updateNativeCatalogItem(context, catalogId, itemId, out.proposed, input.nativeItemOptions);
+        }
+        return out;
+    }
     async bindCatalogToApp(_context, _input) {
         const existing = await this.deps.bindings.findByAppCatalog(_input.appId, _input.catalogId);
         if (existing)