bikky 0.4.1 → 0.4.3

package/dist/mcp/helpers.d.ts

@@ -4,6 +4,7 @@
  * Every function here is pure (or depends only on its inputs + Date.now()).
  */
 import type { FactPayload, FilterParams, QdrantFilter, QdrantPoint } from "./types.js";
+import { type OperationOrigin } from "../provenance/origin.js";
 export interface StructuredFact {
     id: string;
     content: string;
@@ -11,7 +12,11 @@ export interface StructuredFact {
     domain?: string;
     kind?: string;
     memory_subtype?: string | null;
+    origin?: OperationOrigin;
+    last_operation_origin?: OperationOrigin;
+    /** @deprecated Origin is canonical for new writes. */
     actor_id?: string;
+    /** @deprecated Origin is canonical for new writes. */
     source?: string;
     entities: string[];
     confidence?: number;

package/dist/mcp/helpers.js

@@ -5,6 +5,7 @@
  */
 import crypto from "node:crypto";
 import { DEFAULT_DOMAIN, getDecayHalfLife, STALENESS_DAYS } from "./taxonomy.js";
+import { isOperationOrigin } from "../provenance/origin.js";
 // ---------------------------------------------------------------------------
 // Hashing
 // ---------------------------------------------------------------------------
@@ -97,7 +98,7 @@ export function isStale(payload) {
 export const MEMORY_RECALL_EXCLUDED_KINDS = ["telemetry"];
 /** Build a Qdrant filter object from optional params. */
 export function buildFilter(params = {}) {
-    const { category, domain, kind, memory_subtype, actor_id, entity, session_id, episode_id, workstream_key, task_key, repo, branch, review_status, since, until, excludeSuperseded = true, excludeKinds = [], metadata, } = params;
+    const { category, domain, kind, memory_subtype, origin_user_id, origin_agent_id, origin_interface, actor_id, entity, session_id, episode_id, workstream_key, task_key, repo, branch, review_status, since, until, excludeSuperseded = true, excludeKinds = [], metadata, } = params;
     const must = [];
     const must_not = [];
     if (excludeSuperseded) {
@@ -115,8 +116,23 @@ export function buildFilter(params = {}) {
     if (memory_subtype) {
         must.push({ key: "memory_subtype", match: { value: memory_subtype } });
     }
+    if (origin_user_id) {
+        must.push({ key: "origin.user.id", match: { value: origin_user_id } });
+    }
+    if (origin_agent_id) {
+        must.push({ key: "origin.agent.id", match: { value: origin_agent_id } });
+    }
+    if (origin_interface) {
+        must.push({ key: "origin.interface", match: { value: origin_interface } });
+    }
     if (actor_id) {
-        must.push({ key: "actor_id", match: { value: actor_id } });
+        must.push({
+            should: [
+                { key: "origin.user.id", match: { value: actor_id } },
+                { key: "origin.agent.id", match: { value: actor_id } },
+                { key: "actor_id", match: { value: actor_id } },
+            ],
+        });
     }
     if (entity) {
         must.push({ key: "entities", match: { value: entity.toLowerCase() } });
@@ -173,8 +189,14 @@ export function formatFact(point) {
         parts.push(`kind: ${p.kind}`);
     if (p.memory_subtype)
         parts.push(`subtype: ${p.memory_subtype}`);
-    if (p.actor_id)
+    if (isOperationOrigin(p.origin)) {
+        const user = p.origin.user?.name ?? p.origin.user?.id;
+        const agent = p.origin.agent.name ?? p.origin.agent.id ?? p.origin.agent.type;
+        parts.push(`origin: ${user ? `${user} via ` : ""}${agent} (${p.origin.interface}/${p.origin.operation.action})`);
+    }
+    else if (p.actor_id) {
         parts.push(`actor: ${p.actor_id}`);
+    }
     if (p.workstream_key)
         parts.push(`workstream: ${p.workstream_key}`);
     if (p.episode_id)
@@ -234,6 +256,8 @@ export function structuredFact(point) {
         ...(p.domain ? { domain: p.domain } : {}),
         ...(p.kind ? { kind: p.kind } : {}),
         ...(p.memory_subtype ? { memory_subtype: p.memory_subtype } : {}),
+        ...(isOperationOrigin(p.origin) ? { origin: p.origin } : {}),
+        ...(isOperationOrigin(p.last_operation_origin) ? { last_operation_origin: p.last_operation_origin } : {}),
         ...(p.actor_id ? { actor_id: p.actor_id } : {}),
         ...(p.source ? { source: p.source } : {}),
         entities: p.entities ?? [],

package/dist/mcp/taxonomy.js

@@ -291,11 +291,22 @@ export const QDRANT_INDEXES = [
     { field_name: "domain", field_schema: "keyword" },
     { field_name: "kind", field_schema: "keyword" },
     { field_name: "memory_subtype", field_schema: "keyword" },
-    { field_name: "source", field_schema: "keyword" },
     { field_name: "content_hash", field_schema: "keyword" },
     { field_name: "entities", field_schema: "keyword" },
     { field_name: "workspace_id", field_schema: "keyword" },
+    // Deprecated legacy provenance fields remain indexed for fresh collections
+    // that still need to browse/filter records written before origin metadata.
+    { field_name: "source", field_schema: "keyword" },
     { field_name: "actor_id", field_schema: "keyword" },
+    { field_name: "origin.user.id", field_schema: "keyword" },
+    { field_name: "origin.user.source", field_schema: "keyword" },
+    { field_name: "origin.agent.id", field_schema: "keyword" },
+    { field_name: "origin.agent.type", field_schema: "keyword" },
+    { field_name: "origin.agent.source", field_schema: "keyword" },
+    { field_name: "origin.interface", field_schema: "keyword" },
+    { field_name: "origin.operation.action", field_schema: "keyword" },
+    { field_name: "last_operation_origin.agent.id", field_schema: "keyword" },
+    { field_name: "last_operation_origin.operation.action", field_schema: "keyword" },
     { field_name: "entity_name", field_schema: "keyword" },
     { field_name: "from_entity", field_schema: "keyword" },
     { field_name: "to_entity", field_schema: "keyword" },