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

package/dist/entities.d.ts

@@ -79,6 +79,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)
  */
@@ -120,6 +123,7 @@ declare const baseEntitySchema: z.ZodObject<{
     content: z.ZodString;
     created: z.ZodString;
     updated: z.ZodString;
+    visibility: z.ZodEffects<z.ZodOptional<z.ZodUnion<[z.ZodEnum<["public", "shared", "restricted"]>, z.ZodLiteral<"private">]>>, "public" | "shared" | "restricted", "public" | "shared" | "restricted" | "private" | undefined>;
     metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     contentHash: z.ZodString;
 }, "strip", z.ZodTypeAny, {
@@ -128,6 +132,7 @@ declare const baseEntitySchema: z.ZodObject<{
     content: string;
     created: string;
     updated: string;
+    visibility: "public" | "shared" | "restricted";
     metadata: Record<string, unknown>;
     contentHash: string;
 }, {
@@ -138,6 +143,7 @@ declare const baseEntitySchema: z.ZodObject<{
     updated: string;
     metadata: Record<string, unknown>;
     contentHash: string;
+    visibility?: "public" | "shared" | "restricted" | "private" | undefined;
 }>;
 /**
  * Base entity type - generic to support typed metadata
@@ -149,6 +155,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;
@@ -157,10 +164,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
@@ -231,7 +239,7 @@ type CreateInterceptor = (input: CreateInput, executionContext: CreateExecutionC
  */
 interface EntityAdapter<TEntity extends BaseEntity<TMetadata>, TMetadata = Record<string, unknown>> {
     entityType: string;
-    schema: z.ZodSchema<TEntity>;
+    schema: z.ZodType<TEntity, z.ZodTypeDef, unknown>;
     toMarkdown(entity: TEntity): string;
     fromMarkdown(markdown: string): Partial<TEntity>;
     extractMetadata(entity: TEntity): TMetadata;
@@ -272,6 +280,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;
@@ -288,6 +297,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
@@ -309,6 +319,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 {
@@ -358,7 +373,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;
     }>>;
@@ -397,7 +417,7 @@ interface BodyTemplateProvider {
 }
 interface BaseEntityAdapterConfig<TEntity extends BaseEntity<TMetadata>, TMetadata extends object> {
     entityType: string;
-    schema: z.ZodSchema<TEntity>;
+    schema: z.ZodType<TEntity, z.ZodTypeDef, unknown>;
     frontmatterSchema: z.ZodObject<z.ZodRawShape>;
     isSingleton?: boolean;
     hasBody?: boolean;
@@ -415,7 +435,7 @@ interface BaseEntityAdapterConfig<TEntity extends BaseEntity<TMetadata>, TMetada
  */
 declare abstract class BaseEntityAdapter<TEntity extends BaseEntity<TMetadata>, TMetadata extends object = Record<string, unknown>, TFrontmatter = TMetadata> implements EntityAdapter<TEntity, TMetadata> {
     readonly entityType: string;
-    readonly schema: z.ZodSchema<TEntity>;
+    readonly schema: z.ZodType<TEntity, z.ZodTypeDef, unknown>;
     readonly frontmatterSchema: z.ZodObject<z.ZodRawShape>;
     readonly isSingleton?: boolean;
     readonly hasBody?: boolean;