@ai-matrx/associations 0.11.4 → 0.13.0

package/dist/core/index.d.cts

@@ -278,8 +278,6 @@ interface CandidateRecord {
 }
 interface ListCandidatesArgs {
     token: EntityTypeToken;
-    /** Scope to this owner's rows when the entity declares an owner column. */
-    ownerId?: string | null;
     /** Case-insensitive title filter. */
     search?: string;
     limit?: number;
@@ -298,12 +296,25 @@ interface SearchAcrossTokensArgs {
     /** Tokens to search. Defaults to every curated token in the registry. */
     tokens?: EntityTypeToken[];
     search: string;
-    ownerId?: string | null;
     /** Cap per token — a universal search shows a few of everything. */
     perTokenLimit?: number;
     /** Max in-flight token queries. */
     concurrency?: number;
 }
+/** One token whose candidate read failed during a cross-token search. */
+interface TokenSearchFailure {
+    token: EntityTypeToken;
+    error: string;
+}
+/**
+ * A cross-token search's honest answer: what could be read, AND what could
+ * not. An empty `results` with non-empty `failures` is "we couldn't look",
+ * never "there is nothing".
+ */
+interface SearchAcrossTokensResult {
+    results: UniversalCandidate[];
+    failures: TokenSearchFailure[];
+}
 interface ReferenceSearchCandidatesFn {
     (args: {
         p_token: string;
@@ -333,10 +344,12 @@ interface CandidatesServiceApi {
     /**
      * ONE search over EVERY listable entity type — the "attach anything from
      * anywhere" primitive. Registry-driven client fan-out, capped and
-     * concurrency-limited. Per-token failures are screamed and skipped — one
-     * broken table never blanks the search.
+     * concurrency-limited. One broken table never blanks the search: a failed
+     * token is screamed (errorSink) AND reported in `failures` (registry
+     * order), so a face can say what it could not search instead of showing
+     * "no results".
      */
-    searchCandidatesAcrossTokens(args: SearchAcrossTokensArgs): Promise<UniversalCandidate[]>;
+    searchCandidatesAcrossTokens(args: SearchAcrossTokensArgs): Promise<SearchAcrossTokensResult>;
 }
 declare function createCandidatesService(deps: CoreDeps): CandidatesServiceApi;
 
@@ -725,4 +738,4 @@ declare function buildCategoryHierarchy(categories: PlatformCategory[]): Categor
  */
 declare function createDefaultErrorSink(): ErrorSink;
 
-export { type AddAssociationArgs, type AddCommentArgs, type AssociationGuards, type AssociationHelpersApi, type AssociationWriteResult, type AssociationsServiceApi, type AssociationsStore, type CandidateRecord, type CandidatesResult, type CandidatesServiceApi, type CategoriesServiceApi, type CategoryHierarchy, type CategoryHierarchyItem, type CategoryMutationResult, type CommentMutationResult, type CommentsServiceApi, type ContainerRef, type ContentRole, type ConversationFileLink, type CoreDeps, type CreateEntityRowArgs, DEFAULT_ORG_COLUMN, DEFAULT_OWNER_COLUMN, type EdgeAttrs, type EdgeSpec, type EntityInfo, type EntityRef, type EntityRegistry, type EntityRowResult, type EntityRowsServiceApi, type FavoritesServiceApi, type ListCandidatesArgs, NON_CONTENT_SOURCE_TYPES, type PgErrorMapper, type RpcResultHelpers, type SearchAcrossTokensArgs, type TitlesServiceApi, type UniversalCandidate, associationsKey, buildCategoryHierarchy, createAssociationGuards, createAssociationHelpers, createAssociationsService, createAssociationsStore, createCandidatesService, createCategoriesService, createCommentsService, createDefaultErrorSink, createEntityRegistry, createEntityRowsService, createFavoritesService, createRpcResultHelpers, createTitlesService, entityTitleCacheKey, err, firstError, isContentRole, isContentSourceEdge, isMembershipMetadata, isTransportFailure, ok, resolveEntityToken };
+export { type AddAssociationArgs, type AddCommentArgs, type AssociationGuards, type AssociationHelpersApi, type AssociationWriteResult, type AssociationsServiceApi, type AssociationsStore, type CandidateRecord, type CandidatesResult, type CandidatesServiceApi, type CategoriesServiceApi, type CategoryHierarchy, type CategoryHierarchyItem, type CategoryMutationResult, type CommentMutationResult, type CommentsServiceApi, type ContainerRef, type ContentRole, type ConversationFileLink, type CoreDeps, type CreateEntityRowArgs, DEFAULT_ORG_COLUMN, DEFAULT_OWNER_COLUMN, type EdgeAttrs, type EdgeSpec, type EntityInfo, type EntityRef, type EntityRegistry, type EntityRowResult, type EntityRowsServiceApi, type FavoritesServiceApi, type ListCandidatesArgs, NON_CONTENT_SOURCE_TYPES, type PgErrorMapper, type RpcResultHelpers, type SearchAcrossTokensArgs, type SearchAcrossTokensResult, type TitlesServiceApi, type TokenSearchFailure, type UniversalCandidate, associationsKey, buildCategoryHierarchy, createAssociationGuards, createAssociationHelpers, createAssociationsService, createAssociationsStore, createCandidatesService, createCategoriesService, createCommentsService, createDefaultErrorSink, createEntityRegistry, createEntityRowsService, createFavoritesService, createRpcResultHelpers, createTitlesService, entityTitleCacheKey, err, firstError, isContentRole, isContentSourceEdge, isMembershipMetadata, isTransportFailure, ok, resolveEntityToken };

package/dist/core/index.d.ts

@@ -278,8 +278,6 @@ interface CandidateRecord {
 }
 interface ListCandidatesArgs {
     token: EntityTypeToken;
-    /** Scope to this owner's rows when the entity declares an owner column. */
-    ownerId?: string | null;
     /** Case-insensitive title filter. */
     search?: string;
     limit?: number;
@@ -298,12 +296,25 @@ interface SearchAcrossTokensArgs {
     /** Tokens to search. Defaults to every curated token in the registry. */
     tokens?: EntityTypeToken[];
     search: string;
-    ownerId?: string | null;
     /** Cap per token — a universal search shows a few of everything. */
     perTokenLimit?: number;
     /** Max in-flight token queries. */
     concurrency?: number;
 }
+/** One token whose candidate read failed during a cross-token search. */
+interface TokenSearchFailure {
+    token: EntityTypeToken;
+    error: string;
+}
+/**
+ * A cross-token search's honest answer: what could be read, AND what could
+ * not. An empty `results` with non-empty `failures` is "we couldn't look",
+ * never "there is nothing".
+ */
+interface SearchAcrossTokensResult {
+    results: UniversalCandidate[];
+    failures: TokenSearchFailure[];
+}
 interface ReferenceSearchCandidatesFn {
     (args: {
         p_token: string;
@@ -333,10 +344,12 @@ interface CandidatesServiceApi {
     /**
      * ONE search over EVERY listable entity type — the "attach anything from
      * anywhere" primitive. Registry-driven client fan-out, capped and
-     * concurrency-limited. Per-token failures are screamed and skipped — one
-     * broken table never blanks the search.
+     * concurrency-limited. One broken table never blanks the search: a failed
+     * token is screamed (errorSink) AND reported in `failures` (registry
+     * order), so a face can say what it could not search instead of showing
+     * "no results".
      */
-    searchCandidatesAcrossTokens(args: SearchAcrossTokensArgs): Promise<UniversalCandidate[]>;
+    searchCandidatesAcrossTokens(args: SearchAcrossTokensArgs): Promise<SearchAcrossTokensResult>;
 }
 declare function createCandidatesService(deps: CoreDeps): CandidatesServiceApi;
 
@@ -725,4 +738,4 @@ declare function buildCategoryHierarchy(categories: PlatformCategory[]): Categor
  */
 declare function createDefaultErrorSink(): ErrorSink;
 
-export { type AddAssociationArgs, type AddCommentArgs, type AssociationGuards, type AssociationHelpersApi, type AssociationWriteResult, type AssociationsServiceApi, type AssociationsStore, type CandidateRecord, type CandidatesResult, type CandidatesServiceApi, type CategoriesServiceApi, type CategoryHierarchy, type CategoryHierarchyItem, type CategoryMutationResult, type CommentMutationResult, type CommentsServiceApi, type ContainerRef, type ContentRole, type ConversationFileLink, type CoreDeps, type CreateEntityRowArgs, DEFAULT_ORG_COLUMN, DEFAULT_OWNER_COLUMN, type EdgeAttrs, type EdgeSpec, type EntityInfo, type EntityRef, type EntityRegistry, type EntityRowResult, type EntityRowsServiceApi, type FavoritesServiceApi, type ListCandidatesArgs, NON_CONTENT_SOURCE_TYPES, type PgErrorMapper, type RpcResultHelpers, type SearchAcrossTokensArgs, type TitlesServiceApi, type UniversalCandidate, associationsKey, buildCategoryHierarchy, createAssociationGuards, createAssociationHelpers, createAssociationsService, createAssociationsStore, createCandidatesService, createCategoriesService, createCommentsService, createDefaultErrorSink, createEntityRegistry, createEntityRowsService, createFavoritesService, createRpcResultHelpers, createTitlesService, entityTitleCacheKey, err, firstError, isContentRole, isContentSourceEdge, isMembershipMetadata, isTransportFailure, ok, resolveEntityToken };
+export { type AddAssociationArgs, type AddCommentArgs, type AssociationGuards, type AssociationHelpersApi, type AssociationWriteResult, type AssociationsServiceApi, type AssociationsStore, type CandidateRecord, type CandidatesResult, type CandidatesServiceApi, type CategoriesServiceApi, type CategoryHierarchy, type CategoryHierarchyItem, type CategoryMutationResult, type CommentMutationResult, type CommentsServiceApi, type ContainerRef, type ContentRole, type ConversationFileLink, type CoreDeps, type CreateEntityRowArgs, DEFAULT_ORG_COLUMN, DEFAULT_OWNER_COLUMN, type EdgeAttrs, type EdgeSpec, type EntityInfo, type EntityRef, type EntityRegistry, type EntityRowResult, type EntityRowsServiceApi, type FavoritesServiceApi, type ListCandidatesArgs, NON_CONTENT_SOURCE_TYPES, type PgErrorMapper, type RpcResultHelpers, type SearchAcrossTokensArgs, type SearchAcrossTokensResult, type TitlesServiceApi, type TokenSearchFailure, type UniversalCandidate, associationsKey, buildCategoryHierarchy, createAssociationGuards, createAssociationHelpers, createAssociationsService, createAssociationsStore, createCandidatesService, createCategoriesService, createCommentsService, createDefaultErrorSink, createEntityRegistry, createEntityRowsService, createFavoritesService, createRpcResultHelpers, createTitlesService, entityTitleCacheKey, err, firstError, isContentRole, isContentSourceEdge, isMembershipMetadata, isTransportFailure, ok, resolveEntityToken };

package/dist/core/index.js

@@ -3060,10 +3060,11 @@ function createCandidatesService(deps) {
     };
   }
   async function searchCandidatesAcrossTokens(args) {
-    const { tokens, search, ownerId, perTokenLimit = 5, concurrency = 6 } = args;
+    const { tokens, search, perTokenLimit = 5, concurrency = 6 } = args;
     const list = tokens ?? registry.listableTokens();
-    if (list.length === 0) return [];
+    if (list.length === 0) return { results: [], failures: [] };
     const out = [];
+    const failures = [];
     let cursor = 0;
     async function worker() {
       while (cursor < list.length) {
@@ -3072,12 +3073,13 @@ function createCandidatesService(deps) {
         if (!token) continue;
         const res = await listAssociationCandidates({
           token,
-          ownerId: ownerId ?? null,
           search,
           limit: perTokenLimit
         });
         if (res.ok) {
           for (const c of res.data) out.push({ ...c, token });
+        } else {
+          failures.push({ token, error: res.error });
         }
       }
     }
@@ -3091,7 +3093,10 @@ function createCandidatesService(deps) {
       if (ta !== tb) return ta - tb;
       return a.title.localeCompare(b.title);
     });
-    return out;
+    failures.sort(
+      (a, b) => (tokenOrder.get(a.token) ?? 0) - (tokenOrder.get(b.token) ?? 0)
+    );
+    return { results: out, failures };
   }
   return {
     callReferenceSearchCandidates,