@rizom/brain 0.2.0-alpha.80 → 0.2.0-alpha.82

package/dist/services.d.ts

@@ -154,6 +154,9 @@ interface EntityJobOptions {
     priority?: number;
     maxRetries?: number;
 }
+declare const canonicalContentVisibilitySchema: z.ZodEnum<["public", "shared", "restricted"]>;
+type ContentVisibility = z.infer<typeof canonicalContentVisibilitySchema>;
+type RawContentVisibility = ContentVisibility | "private";
 /**
  * Options for entity creation (extends EntityJobOptions with deduplication)
  */
@@ -196,6 +199,7 @@ interface BaseEntity<TMetadata = Record<string, unknown>> {
     content: string;
     created: string;
     updated: string;
+    visibility: ContentVisibility;
     metadata: TMetadata;
     /** SHA256 hash of content for change detection */
     contentHash: string;
@@ -204,10 +208,11 @@ interface BaseEntity<TMetadata = Record<string, unknown>> {
  * Entity input type for creation - allows partial entities with optional system fields
  * contentHash is excluded because it's computed automatically by the entity service
  */
-type EntityInput<T extends BaseEntity> = Omit<T, "id" | "created" | "updated" | "contentHash"> & {
+type EntityInput<T extends BaseEntity> = Omit<T, "id" | "created" | "updated" | "contentHash" | "visibility"> & {
     id?: string;
     created?: string;
     updated?: string;
+    visibility?: RawContentVisibility;
 };
 /**
  * Search result type
@@ -239,6 +244,7 @@ interface ListOptions<TMetadata = Record<string, unknown>> {
     sortFields?: SortField[];
     filter?: {
         metadata?: Partial<TMetadata>;
+        visibilityScope?: ContentVisibility;
     };
     /** Filter to only entities with metadata.status = "published" */
     publishedOnly?: boolean;
@@ -255,6 +261,7 @@ interface SearchOptions {
     sortDirection?: "asc" | "desc";
     /** Score multipliers per entity type - applied after initial search */
     weight?: Record<string, number>;
+    visibilityScope?: ContentVisibility;
 }
 /**
  * Configuration for entity type registration
@@ -276,6 +283,11 @@ interface EntityTypeConfig {
 interface GetEntityRequest {
     entityType: string;
     id: string;
+    /**
+     * Optional visibility scope. Undefined fails closed to "public" — callers
+     * with elevated access must opt up explicitly.
+     */
+    visibilityScope?: ContentVisibility;
 }
 type GetEntityRawRequest = GetEntityRequest;
 interface ListEntitiesRequest {
@@ -325,7 +337,12 @@ interface ICoreEntityService {
     getEntityTypes(): string[];
     hasEntityType(type: string): boolean;
     countEntities(request: CountEntitiesRequest): Promise<number>;
-    getEntityCounts(): Promise<Array<{
+    /**
+     * Group counts by entity type. Fails closed: undefined visibilityScope
+     * filters to public-only counts so aggregate insights cannot reveal
+     * non-public entity existence.
+     */
+    getEntityCounts(visibilityScope?: ContentVisibility): Promise<Array<{
         entityType: string;
         count: number;
     }>>;