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

package/dist/migrations/entity-service/0001_sleepy_mandroid.sql

@@ -0,0 +1 @@
+ALTER TABLE `entities` ADD `visibility` text DEFAULT 'public' NOT NULL CHECK (`visibility` IN ('public', 'shared', 'restricted'));

package/dist/migrations/entity-service/meta/0001_snapshot.json

@@ -0,0 +1,139 @@
+{
+  "version": "6",
+  "dialect": "sqlite",
+  "id": "3614c8be-8121-4f23-bfab-2d863ca03c28",
+  "prevId": "99d7ed2f-bc45-4bec-ab00-657cc53cd21c",
+  "tables": {
+    "entities": {
+      "name": "entities",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "entityType": {
+          "name": "entityType",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "content": {
+          "name": "content",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "contentHash": {
+          "name": "contentHash",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "visibility": {
+          "name": "visibility",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'public'"
+        },
+        "metadata": {
+          "name": "metadata",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'{}'"
+        },
+        "created": {
+          "name": "created",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "updated": {
+          "name": "updated",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {},
+      "compositePrimaryKeys": {
+        "entities_id_entityType_pk": {
+          "columns": ["id", "entityType"],
+          "name": "entities_id_entityType_pk"
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraints": {
+        "entities_visibility_check": {
+          "name": "entities_visibility_check",
+          "value": "\"entities\".\"visibility\" IN ('public', 'shared', 'restricted')"
+        }
+      }
+    },
+    "embeddings": {
+      "name": "embeddings",
+      "columns": {
+        "entity_id": {
+          "name": "entity_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "entity_type": {
+          "name": "entity_type",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "embedding": {
+          "name": "embedding",
+          "type": "F32_BLOB(1536)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "content_hash": {
+          "name": "content_hash",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {},
+      "compositePrimaryKeys": {
+        "embeddings_entity_id_entity_type_pk": {
+          "columns": ["entity_id", "entity_type"],
+          "name": "embeddings_entity_id_entity_type_pk"
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    }
+  },
+  "views": {},
+  "enums": {},
+  "_meta": {
+    "schemas": {},
+    "tables": {},
+    "columns": {}
+  },
+  "internal": {
+    "indexes": {}
+  }
+}

package/dist/migrations/entity-service/meta/_journal.json

@@ -8,6 +8,13 @@
       "when": 1768021816795,
       "tag": "0000_lucky_yellowjacket",
       "breakpoints": true
+    },
+    {
+      "idx": 1,
+      "version": "6",
+      "when": 1779171174140,
+      "tag": "0001_sleepy_mandroid",
+      "breakpoints": true
     }
   ]
 }

package/dist/plugins.d.ts

@@ -65,6 +65,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)
  */
@@ -107,6 +110,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;
@@ -115,10 +119,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
@@ -189,7 +194,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;
@@ -230,6 +235,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;
@@ -246,6 +252,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
@@ -267,6 +274,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 {
@@ -316,7 +328,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;
     }>>;
@@ -330,7 +347,7 @@ interface ICoreEntityService {
  */
 interface IEntitiesNamespace {
     /** Register a new entity type with schema and adapter */
-    register<TEntity extends BaseEntity>(entityType: string, schema: z.ZodSchema<TEntity>, adapter: EntityAdapter<TEntity>, config?: EntityTypeConfig): void;
+    register<TEntity extends BaseEntity>(entityType: string, schema: z.ZodType<TEntity, z.ZodTypeDef, unknown>, adapter: EntityAdapter<TEntity>, config?: EntityTypeConfig): void;
     /** Get the adapter for an entity type */
     getAdapter<TEntity extends BaseEntity>(entityType: string): EntityAdapter<TEntity> | undefined;
     /** Extend an adapter's frontmatterSchema with additional fields */
@@ -1175,7 +1192,7 @@ interface IMessagingNamespace {
     subscribe<T = unknown, R = unknown>(channel: string | Channel<T, R>, handler: (message: MessageWithPayload<T>) => Promise<MessageResponse<R>>): () => void;
 }
 type EvalHandler<TInput = unknown, TOutput = unknown> = (input: TInput) => Promise<TOutput>;
-type InsightHandler = (entityService: IEntityService) => Promise<Record<string, unknown>>;
+type InsightHandler = (entityService: IEntityService, visibilityScope: ContentVisibility) => Promise<Record<string, unknown>>;
 interface IEvalNamespace {
     registerHandler(handlerId: string, handler: EvalHandler): void;
 }