bikky 0.4.2 → 0.4.3

package/README.md

@@ -101,11 +101,11 @@ bikky supports four common setup shapes. Pick based on where you want Qdrant to
 | ----------------------- | ------------------------------ | ---------------------------------------------------------------------------------------- |
 | **Node.js**             | ≥ 20                           | `nvm install 20` or your package manager                                                 |
 | **Vector store**        | Qdrant                         | Local Docker · [Qdrant Cloud](https://cloud.qdrant.io) · Self-hosted                     |
-| **Embeddings**          | One provider                   | OpenAI · Ollama · Bedrock · Portkey                                                     |
-| **LLM**                 | One provider                   | OpenAI · Ollama · Bedrock · Portkey                                                     |
+| **Embeddings**          | One provider                   | Portkey · OpenAI · Ollama · Bedrock                                                     |
+| **LLM**                 | One provider                   | Portkey · OpenAI · Ollama · Bedrock                                                     |
 | **Docker** *(optional)* | Only if you run Qdrant locally | Docker Desktop, OrbStack, colima, etc.                                                   |
 
-Both `embedding.provider` and `llm.provider` accept the same values: `ollama`, `openai`, `bedrock`, or `portkey`.
+Both `embedding.provider` and `llm.provider` accept the same values: `ollama`, `openai`, `bedrock`, or `portkey`. **Portkey is the easiest cloud option** — one API key, any upstream provider, with built-in routing/fallbacks. Bikky's canonical embedding dimension is **1024**, portable across every modern provider.
 
 > ⚠️ **Qdrant Cloud free tier does not include automatic backups.** Deleted collections cannot be recovered. If your memory data is valuable, use a paid Qdrant Cloud plan (which includes daily backups), run Qdrant locally with your own backup strategy, or periodically export snapshots via the [Qdrant snapshots API](https://qdrant.tech/documentation/concepts/snapshots/).
 
@@ -128,6 +128,8 @@ Pick the setup guide above for the copy-paste config. All setup shapes use the s
 
 Config lives at `~/.bikky/config.json`, or at `BIKKY_HOME/config.json` when `BIKKY_HOME` is set. You can keep credentials out of the file with environment variables such as `QDRANT_URL`, `QDRANT_API_KEY`, and provider API keys.
 
+`bikky setup` also provisions `identity.user_id` / `identity.user_name` when they are missing. New memory writes store canonical `origin` metadata with the configured human user, the acting agent or daemon/UI surface, the interface, and the operation. MCP clients cannot supply or spoof `origin.user`; if config, env, Git, and shell identity detection all fail, bikky falls back to the local hostname.
+
 For hosted models, custom providers, multiple profiles, or advanced tuning, use the full configuration guide.
 
 > 📖 **Full configuration guide:** [docs/configuration.md][configuration-guide]
@@ -196,7 +198,7 @@ bikky-ui              # opens http://localhost:1422
 <p align="center">
   <img src="https://raw.githubusercontent.com/bikky-dev/bikky/main/docs/screenshots/memory.png" alt="Memory browser — search, filter, and browse all stored facts" width="720" />
 </p>
-<p align="center"><i>Memory browser — search, filter by category/kind/source, and browse all stored facts</i></p>
+<p align="center"><i>Memory browser — search, filter by category/kind/origin, and browse all stored facts</i></p>
 
 <p align="center">
   <img src="https://raw.githubusercontent.com/bikky-dev/bikky/main/docs/screenshots/graph.png" alt="Entity graph — interactive visualization of entity relationships" width="720" />

package/dist/config.d.ts

@@ -4,6 +4,12 @@
  * Resolution order: defaults → ~/.bikky/config.json → env vars.
  * Config directory: ~/.bikky/
  */
+export declare function getBikkyDir(): string;
+export declare function getConfigPath(): string;
+export declare function getLogDir(): string;
+export declare function getStateDir(): string;
+export declare function getPidPath(): string;
+export declare function getExtractionHealthPath(): string;
 export declare const BIKKY_DIR: string;
 export declare const CONFIG_PATH: string;
 export declare const LOG_DIR: string;
@@ -63,7 +69,11 @@ export interface QdrantClientConfig {
     retry_base_delay_ms: number;
 }
 export interface IdentityConfig {
+    user_id: string | null;
+    user_name: string | null;
+    /** @deprecated Use origin.user.id instead. */
     actor_id: string | null;
+    /** @deprecated Use origin.user.name / origin.agent.name instead. */
     actor_label: string | null;
 }
 export interface WatcherConfig {
@@ -158,7 +168,7 @@ export interface ConfigFileDiagnostics {
     issues: ConfigIssue[];
 }
 declare const DEFAULTS: BikkyConfig;
-export declare const CONFIG_ENV_KEYS: readonly ["QDRANT_URL", "QDRANT_API_KEY", "BIKKY_COLLECTION", "EMBEDDING_PROVIDER", "EMBEDDING_MODEL", "EMBEDDING_BASE_URL", "EMBEDDING_DIMENSIONS", "OPENAI_API_KEY", "LLM_PROVIDER", "LLM_MODEL", "LLM_BASE_URL", "LLM_FALLBACK_PROVIDER", "AWS_PROFILE", "AWS_BEDROCK_REGION", "AWS_REGION", "QDRANT_TIMEOUT_MS", "QDRANT_RETRIES", "QDRANT_RETRY_BASE_DELAY_MS", "BIKKY_EMBEDDING_TIMEOUT_MS", "BIKKY_EMBEDDING_RETRIES", "BIKKY_EMBEDDING_RETRY_BASE_DELAY_MS", "BIKKY_LLM_TIMEOUT_MS", "BIKKY_LLM_RETRIES", "BIKKY_LLM_RETRY_BASE_DELAY_MS", "BIKKY_DAEMON_RELATION_INFERENCE_ENABLED", "BIKKY_DAEMON_RELATION_INFERENCE_INTERVAL_SEC", "BIKKY_DAEMON_RELATION_INFERENCE_MAX_PAIRS_PER_RUN", "BIKKY_DAEMON_ENTITY_TYPING_ENABLED", "BIKKY_DAEMON_ENTITY_TYPING_INTERVAL_SEC", "BIKKY_DAEMON_ENTITY_TYPING_MAX_ENTITIES_PER_RUN", "BIKKY_ACTOR_ID", "BIKKY_ACTOR_LABEL"];
+export declare const CONFIG_ENV_KEYS: readonly ["QDRANT_URL", "QDRANT_API_KEY", "BIKKY_COLLECTION", "EMBEDDING_PROVIDER", "EMBEDDING_MODEL", "EMBEDDING_BASE_URL", "EMBEDDING_DIMENSIONS", "OPENAI_API_KEY", "PORTKEY_API_KEY", "LLM_PROVIDER", "LLM_MODEL", "LLM_BASE_URL", "LLM_FALLBACK_PROVIDER", "AWS_PROFILE", "AWS_BEDROCK_REGION", "AWS_REGION", "QDRANT_TIMEOUT_MS", "QDRANT_RETRIES", "QDRANT_RETRY_BASE_DELAY_MS", "BIKKY_EMBEDDING_TIMEOUT_MS", "BIKKY_EMBEDDING_RETRIES", "BIKKY_EMBEDDING_RETRY_BASE_DELAY_MS", "BIKKY_LLM_TIMEOUT_MS", "BIKKY_LLM_RETRIES", "BIKKY_LLM_RETRY_BASE_DELAY_MS", "BIKKY_DAEMON_RELATION_INFERENCE_ENABLED", "BIKKY_DAEMON_RELATION_INFERENCE_INTERVAL_SEC", "BIKKY_DAEMON_RELATION_INFERENCE_MAX_PAIRS_PER_RUN", "BIKKY_DAEMON_ENTITY_TYPING_ENABLED", "BIKKY_DAEMON_ENTITY_TYPING_INTERVAL_SEC", "BIKKY_DAEMON_ENTITY_TYPING_MAX_ENTITIES_PER_RUN", "BIKKY_USER_ID", "BIKKY_USER_NAME", "BIKKY_AGENT_ID", "BIKKY_AGENT_NAME", "BIKKY_ACTOR_ID", "BIKKY_ACTOR_LABEL"];
 export declare function validateConfigObject(raw: unknown): ConfigIssue[];
 export declare function inspectConfigFile(configPath?: string): ConfigFileDiagnostics;
 export declare function getActiveConfigEnvOverrides(env?: NodeJS.ProcessEnv): string[];

package/dist/config.js

@@ -12,15 +12,41 @@ import { z } from "zod";
 // Paths
 // ---------------------------------------------------------------------------
 // BIKKY_HOME env var lets tests (and advanced users) override the config dir
-// without touching the real ~/.bikky/. Tests MUST set this to an isolated
-// tempdir before importing this module — otherwise saveConfig() will write to
-// the user's real config file.
-export const BIKKY_DIR = process.env.BIKKY_HOME ?? path.join(os.homedir(), ".bikky");
-export const CONFIG_PATH = path.join(BIKKY_DIR, "config.json");
-export const LOG_DIR = path.join(BIKKY_DIR, "logs");
-export const STATE_DIR = path.join(BIKKY_DIR, "state");
-export const PID_PATH = path.join(STATE_DIR, "daemon.pid");
-export const EXTRACTION_HEALTH_PATH = path.join(STATE_DIR, "extraction-health.json");
+// without touching the real ~/.bikky/. The getter functions below re-read the
+// env var on every call, so changing BIKKY_HOME at runtime (e.g. in a test
+// setup hook) takes effect for all subsequent saveConfig()/loadConfig() calls.
+//
+// The legacy `BIKKY_DIR` / `CONFIG_PATH` / etc. exports are kept for
+// backward-compatibility, but they capture the env state at module load
+// time and should NOT be relied on for safe writes. Internal callers — and
+// any test that wants sandboxing — should call the getter functions instead.
+export function getBikkyDir() {
+    return process.env.BIKKY_HOME ?? path.join(os.homedir(), ".bikky");
+}
+export function getConfigPath() {
+    return path.join(getBikkyDir(), "config.json");
+}
+export function getLogDir() {
+    return path.join(getBikkyDir(), "logs");
+}
+export function getStateDir() {
+    return path.join(getBikkyDir(), "state");
+}
+export function getPidPath() {
+    return path.join(getStateDir(), "daemon.pid");
+}
+export function getExtractionHealthPath() {
+    return path.join(getStateDir(), "extraction-health.json");
+}
+// Legacy constant exports — captured at module load. Prefer the getter
+// functions above when you need fresh values (e.g. inside tests, or after
+// mutating BIKKY_HOME at runtime).
+export const BIKKY_DIR = getBikkyDir();
+export const CONFIG_PATH = getConfigPath();
+export const LOG_DIR = getLogDir();
+export const STATE_DIR = getStateDir();
+export const PID_PATH = getPidPath();
+export const EXTRACTION_HEALTH_PATH = getExtractionHealthPath();
 // ---------------------------------------------------------------------------
 // Defaults
 // ---------------------------------------------------------------------------
@@ -69,6 +95,8 @@ const DEFAULTS = {
         staleness_threshold_days: 30,
     },
     identity: {
+        user_id: null,
+        user_name: null,
         actor_id: null,
         actor_label: null,
     },
@@ -91,6 +119,7 @@ export const CONFIG_ENV_KEYS = [
     "EMBEDDING_BASE_URL",
     "EMBEDDING_DIMENSIONS",
     "OPENAI_API_KEY",
+    "PORTKEY_API_KEY",
     "LLM_PROVIDER",
     "LLM_MODEL",
     "LLM_BASE_URL",
@@ -113,6 +142,10 @@ export const CONFIG_ENV_KEYS = [
     "BIKKY_DAEMON_ENTITY_TYPING_ENABLED",
     "BIKKY_DAEMON_ENTITY_TYPING_INTERVAL_SEC",
     "BIKKY_DAEMON_ENTITY_TYPING_MAX_ENTITIES_PER_RUN",
+    "BIKKY_USER_ID",
+    "BIKKY_USER_NAME",
+    "BIKKY_AGENT_ID",
+    "BIKKY_AGENT_NAME",
     "BIKKY_ACTOR_ID",
     "BIKKY_ACTOR_LABEL",
 ];
@@ -122,7 +155,7 @@ const CONFIG_ENV_PREFIXES = [
 ];
 const nonNegativeInt = z.number().int().nonnegative();
 const positiveInt = z.number().int().positive();
-const stringRecord = z.record(z.string());
+const stringRecord = z.record(z.string(), z.string());
 const embeddingConfigFileSchema = z.object({
     provider: z.string().optional(),
     model: z.string().optional(),
@@ -175,6 +208,8 @@ const qdrantClientConfigFileSchema = z.object({
     retry_base_delay_ms: nonNegativeInt.optional(),
 }).passthrough();
 const identityConfigFileSchema = z.object({
+    user_id: z.string().nullable().optional(),
+    user_name: z.string().nullable().optional(),
     actor_id: z.string().nullable().optional(),
     actor_label: z.string().nullable().optional(),
 }).passthrough();
@@ -183,7 +218,7 @@ const destinationMatchSchema = z.object({
     cwd: regexArrayField,
     entity: regexArrayField,
     content: regexArrayField,
-    metadata: z.record(z.array(z.string())).optional(),
+    metadata: z.record(z.string(), z.array(z.string())).optional(),
 }).passthrough();
 const destinationFileSchema = z.object({
     name: z.string().min(1),
@@ -442,7 +477,7 @@ export function validateConfigObject(raw) {
         validateUrlLike(llm.base_url, "llm.base_url", issues);
     return issues;
 }
-export function inspectConfigFile(configPath = CONFIG_PATH) {
+export function inspectConfigFile(configPath = getConfigPath()) {
     if (!fs.existsSync(configPath)) {
         return { path: configPath, exists: false, parse_error: null, issues: [] };
     }
@@ -490,21 +525,41 @@ export function loadConfig() {
     if (_config)
         return _config;
     // Ensure dirs exist
-    fs.mkdirSync(BIKKY_DIR, { recursive: true });
-    fs.mkdirSync(LOG_DIR, { recursive: true });
-    fs.mkdirSync(STATE_DIR, { recursive: true });
+    fs.mkdirSync(getBikkyDir(), { recursive: true });
+    fs.mkdirSync(getLogDir(), { recursive: true });
+    fs.mkdirSync(getStateDir(), { recursive: true });
     // Start from defaults
     let config = structuredClone(DEFAULTS);
     // Merge config file
-    if (fs.existsSync(CONFIG_PATH)) {
+    const configPath = getConfigPath();
+    let fileConfig = {};
+    if (fs.existsSync(configPath)) {
         try {
-            const fileConfig = JSON.parse(fs.readFileSync(CONFIG_PATH, "utf-8"));
+            fileConfig = JSON.parse(fs.readFileSync(configPath, "utf-8"));
             config = deepMerge(config, fileConfig);
         }
         catch (e) {
-            console.error(`bikky: failed to parse ${CONFIG_PATH}: ${e instanceof Error ? e.message : String(e)}`);
+            console.error(`bikky: failed to parse ${configPath}: ${e instanceof Error ? e.message : String(e)}`);
         }
     }
+    // Provider/base_url consistency (issue #131): the DEFAULTS.embedding.base_url
+    // is the ollama localhost URL, baked in for the default ollama provider. If
+    // the user picks a different provider (portkey/openai/bedrock) but doesn't
+    // set an explicit base_url, drop the inherited ollama URL so initEmbedding()
+    // can apply the provider's own default — otherwise we'd POST every embedding
+    // request to localhost:11434 and Ollama would reject the foreign model name.
+    const fileEmbedding = (fileConfig.embedding ?? {});
+    if (config.embedding.provider !== DEFAULTS.embedding.provider
+        && typeof fileEmbedding.base_url !== "string"
+        && !process.env.EMBEDDING_BASE_URL) {
+        config.embedding.base_url = "";
+    }
+    const fileLlm = (fileConfig.llm ?? {});
+    if (config.llm.provider !== DEFAULTS.llm.provider
+        && typeof fileLlm.base_url !== "string"
+        && !process.env.LLM_BASE_URL) {
+        config.llm.base_url = "";
+    }
     // Env var overrides (highest priority)
     if (process.env.QDRANT_URL)
         config.qdrant_url = process.env.QDRANT_URL;
@@ -526,6 +581,12 @@ export function loadConfig() {
     }
     if (process.env.OPENAI_API_KEY)
         config.embedding.api_key = process.env.OPENAI_API_KEY;
+    // Portkey users can supply their gateway key via PORTKEY_API_KEY without
+    // needing to repurpose OPENAI_API_KEY. Only applied when the embedding
+    // provider is Portkey, so non-Portkey setups remain untouched.
+    if (process.env.PORTKEY_API_KEY && config.embedding.provider === "portkey") {
+        config.embedding.api_key = process.env.PORTKEY_API_KEY;
+    }
     // Generic provider-extras: BIKKY_EMBEDDING_EXTRA_<KEY>=value
     config.embedding.extra = config.embedding.extra ?? {};
     for (const [k, v] of Object.entries(process.env)) {
@@ -542,6 +603,9 @@ export function loadConfig() {
         config.llm.base_url = process.env.LLM_BASE_URL;
     if (process.env.OPENAI_API_KEY && !config.llm.api_key)
         config.llm.api_key = process.env.OPENAI_API_KEY;
+    if (process.env.PORTKEY_API_KEY && config.llm.provider === "portkey" && !config.llm.api_key) {
+        config.llm.api_key = process.env.PORTKEY_API_KEY;
+    }
     if (process.env.LLM_FALLBACK_PROVIDER)
         config.llm.fallback_provider = process.env.LLM_FALLBACK_PROVIDER;
     if (process.env.AWS_PROFILE)
@@ -632,6 +696,10 @@ export function loadConfig() {
     const entityTypingMax = positiveInt(process.env.BIKKY_DAEMON_ENTITY_TYPING_MAX_ENTITIES_PER_RUN);
     if (entityTypingMax !== null)
         config.daemon.entity_typing_max_entities_per_run = entityTypingMax;
+    if (process.env.BIKKY_USER_ID)
+        config.identity.user_id = process.env.BIKKY_USER_ID;
+    if (process.env.BIKKY_USER_NAME)
+        config.identity.user_name = process.env.BIKKY_USER_NAME;
     if (process.env.BIKKY_ACTOR_ID)
         config.identity.actor_id = process.env.BIKKY_ACTOR_ID;
     if (process.env.BIKKY_ACTOR_LABEL)
@@ -679,8 +747,8 @@ export function getEffectiveDestinations(config = loadConfig()) {
 }
 /** Save config to disk (used by setup command). */
 export function saveConfig(config) {
-    fs.mkdirSync(BIKKY_DIR, { recursive: true });
-    fs.writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2) + "\n");
+    fs.mkdirSync(getBikkyDir(), { recursive: true });
+    fs.writeFileSync(getConfigPath(), JSON.stringify(config, null, 2) + "\n");
     _config = config;
 }
 /** Reset cached config (for testing). */

package/dist/daemon/capture-policy.d.ts

@@ -86,7 +86,6 @@ export declare const CAPTURE_KIND_SUBTYPES: {
 export declare const FACT_CATEGORY_TO_SUBTYPE: Record<Category, MemorySubtype>;
 export declare const DEFAULT_CAPTURE_CONTEXT: {
     readonly domain: "software_engineering" | "product_strategy" | "business_operations" | "research" | "personal_productivity";
-    readonly source: "system";
     readonly reviewStatus: "candidate";
     readonly volatility: "evolving";
 };

package/dist/daemon/capture-policy.js

@@ -110,7 +110,6 @@ export const FACT_CATEGORY_TO_SUBTYPE = {
 };
 export const DEFAULT_CAPTURE_CONTEXT = {
     domain: DEFAULT_DOMAIN,
-    source: "system",
     reviewStatus: "candidate",
     // Default fallback volatility when the LLM does not self-judge. Storage path
     // overrides this with the LLM's value (or the volatility verifier's

package/dist/daemon/consolidation.d.ts

@@ -51,6 +51,7 @@ declare const detectContradiction: (fact: {
 }, _config: BikkyConfig, telemetry?: {
     sessionId?: string;
     workstreamKey?: string;
+    destination?: string;
 }) => Promise<ContradictionResult>;
 /**
  * Main consolidation tick — called from daemon tick loop.
@@ -58,6 +59,6 @@ declare const detectContradiction: (fact: {
  */
 declare const tick: (config: BikkyConfig, opts?: ConsolidationTickOptions) => Promise<void>;
 /** Reset state (for testing). */
-declare const _reset: () => void;
+declare const _reset: (tickCount?: number) => void;
 export { detectContradiction, tick, setLogger, _reset, };
 //# sourceMappingURL=consolidation.d.ts.map

package/dist/daemon/consolidation.js

@@ -13,6 +13,7 @@ import { mkdirSync, writeFileSync } from "node:fs";
 import { join, dirname } from "node:path";
 import { createHash } from "node:crypto";
 import * as qdrant from "./qdrant.js";
+import { buildOperationOrigin } from "../provenance/origin.js";
 import { chatCompletion } from "../llm/index.js";
 import { categoryValues, normalizeCategory, normalizeDomain } from "../mcp/taxonomy.js";
 import { distillPrompt, DISTILL_PROMPT_DESCRIPTOR, contradictionPrompt, briefPrompt, BRIEF_PROMPT_DESCRIPTOR, safeParseJson, } from "../prompts/index.js";
@@ -33,6 +34,8 @@ const autoDistill = async (_config, { minSummaries = 5 } = {}) => {
     if (!qdrant.isReady())
         return { distilled: false };
     try {
+        const destination = qdrant.resolveDestination({}).name;
+        const collection = qdrant.collectionForDestination(destination);
         // Find undistilled session summaries (support both legacy and new taxonomy)
         const legacyFilter = {
             must: [
@@ -47,12 +50,12 @@ const autoDistill = async (_config, { minSummaries = 5 } = {}) => {
             ],
         };
         const [legacyRes, newRes] = await Promise.all([
-            qdrant.qdrantRequest("POST", `/collections/${qdrant.collection}/points/scroll`, {
+            qdrant.qdrantRequest("POST", `/collections/${collection}/points/scroll`, {
                 filter: legacyFilter, limit: 50, with_payload: true,
-            }),
-            qdrant.qdrantRequest("POST", `/collections/${qdrant.collection}/points/scroll`, {
+            }, destination),
+            qdrant.qdrantRequest("POST", `/collections/${collection}/points/scroll`, {
                 filter: newFilter, limit: 50, with_payload: true,
-            }),
+            }, destination),
         ]);
         // Deduplicate by ID
         const seen = new Set();
@@ -107,7 +110,6 @@ const autoDistill = async (_config, { minSummaries = 5 } = {}) => {
                 domain: normalizeDomain(pattern.domain ?? "software_engineering"),
                 kind: "distilled",
                 entities: Array.isArray(pattern.entities) ? pattern.entities.map(e => String(e).toLowerCase()) : [],
-                source: "system",
                 confidence: 0.85,
                 importance: pattern.importance || 0.7,
                 content_hash: hash,
@@ -116,11 +118,25 @@ const autoDistill = async (_config, { minSummaries = 5 } = {}) => {
                     distilled_at: new Date().toISOString(),
                     distilled_by_prompt: promptStamp,
                 },
-            });
+                origin: buildOperationOrigin({
+                    interface: "daemon",
+                    action: "create",
+                    subsystem: "consolidation",
+                    metadata: {
+                        distilled_from_count: batch.length,
+                        prompt: promptStamp,
+                    },
+                }),
+            }, { destination });
         }
         // Supersede the source summaries
         for (const pt of batch) {
-            await qdrant.supersedeFact(pt.id, `distilled:${new Date().toISOString()}`);
+            await qdrant.supersedeFact(pt.id, `distilled:${new Date().toISOString()}`, destination, buildOperationOrigin({
+                interface: "daemon",
+                action: "supersede",
+                subsystem: "consolidation",
+                metadata: { prompt: promptStamp },
+            }));
         }
         logFn("INFO", `Auto-distill: consolidated ${batch.length} summaries into ${patterns.length} patterns`);
         return { distilled: true, count: patterns.length };
@@ -143,12 +159,13 @@ const detectContradiction = async (fact, _config, telemetry) => {
     try {
         const vector = await qdrant.embed(fact.content);
         // Search across all categories because contradictions can cross category lines.
-        const results = await qdrant.qdrantRequest("POST", `/collections/${qdrant.collection}/points/search`, {
+        const collection = qdrant.collectionForDestination(telemetry?.destination);
+        const results = await qdrant.qdrantRequest("POST", `/collections/${collection}/points/search`, {
             vector,
             filter: { must: [{ is_null: { key: "superseded_by" } }] },
             limit: 5,
             with_payload: true,
-        });
+        }, telemetry?.destination);
         const candidates = (results.result || [])
             .filter(r => r.score >= 0.75 && r.score < 0.92);
         if (candidates.length === 0)
@@ -448,8 +465,8 @@ const tick = async (config, opts = {}) => {
     }
 };
 /** Reset state (for testing). */
-const _reset = () => {
-    consolidationTickCount = 0;
+const _reset = (tickCount = 0) => {
+    consolidationTickCount = tickCount;
 };
 export { detectContradiction, tick, setLogger, _reset, };
 //# sourceMappingURL=consolidation.js.map

package/dist/daemon/entity-typing.js

@@ -11,6 +11,7 @@ import { entityTypingPrompt, ENTITY_TYPING_PROMPT_DESCRIPTOR, safeParseJson } fr
 import * as qdrant from "./qdrant.js";
 import { isAttemptBackedOff, pruneRecentAttempts, readMaintenanceState, recordMaintenanceRun, shouldRunMaintenance, } from "./maintenance-state.js";
 import { isGenericEntity } from "./relations-vocab.js";
+import { buildOperationOrigin } from "../provenance/origin.js";
 const FACTS_SCAN_LIMIT = 200;
 const FACTS_PER_ENTITY = 5;
 const DEFAULT_LOOKBACK_MS = 7 * 24 * 60 * 60 * 1000;
@@ -171,6 +172,15 @@ const upsertEntityTypePoint = async (candidate, classification, source) => {
                     classified_at: now,
                     updated_at: now,
                     created_at: now,
+                    origin: buildOperationOrigin({
+                        interface: "daemon",
+                        action: "create",
+                        subsystem: "entity_typing",
+                        metadata: {
+                            entity_name: candidate.name,
+                            classification_source: source,
+                        },
+                    }),
                     source_fact_ids: candidate.factIds,
                     ...(candidate.workstreamKeys.length > 0 ? { workstream_key: candidate.workstreamKeys[0] } : {}),
                     metadata: {

package/dist/daemon/episode-summary.d.ts

@@ -2,6 +2,7 @@ import type { BikkyConfig } from "../config.js";
 import type { QdrantPayload } from "./qdrant.js";
 import { type RedactionSummary } from "../privacy/redaction.js";
 import { type WorkstreamRegistry } from "./workstream-resolver.js";
+import { type OperationOrigin } from "../provenance/origin.js";
 export { buildEpisodeSummaryMessages } from "../prompts/index.js";
 export interface WorkspaceScope {
     workspaceId?: string;
@@ -33,6 +34,7 @@ export interface EpisodeSummaryWriteResult {
     action: "stored" | "updated" | "skipped";
     factId?: string;
     episodeId?: string;
+    destination?: string;
     workstreamKey?: string | null;
     reason?: string;
 }
@@ -57,6 +59,8 @@ export declare const buildEpisodeSummaryPayload: (input: {
         enabled: boolean;
         redactPii: boolean;
     };
+    config?: BikkyConfig;
+    origin?: OperationOrigin;
 }) => EpisodeSummaryPayloadResult;
 export declare const updateEpisodeSummary: (input: {
     segment: EpisodeSegment;

package/dist/daemon/episode-summary.js

@@ -13,6 +13,7 @@ import { CAPTURE_POLICY_VERSION, CAPTURE_TRIGGERS, DEFAULT_CAPTURE_CONTEXT, PROM
 import * as qdrant from "./qdrant.js";
 import { combineRedactions, redactStorageText, } from "../privacy/redaction.js";
 import { resolveWorkstreamKey, } from "./workstream-resolver.js";
+import { buildOperationOrigin } from "../provenance/origin.js";
 export { buildEpisodeSummaryMessages } from "../prompts/index.js";
 const DEFAULT_EPISODE_IMPORTANCE = 0.75;
 const contentHash = (text) => createHash("sha256").update(`episode:${text}`).digest("hex");
@@ -120,6 +121,17 @@ export const buildEpisodeSummaryPayload = (input) => {
     ]);
     const existingPayload = input.existing?.payload ?? {};
     const workstreamKey = input.draft.workstream_key ?? input.segment.workstream_key ?? null;
+    const operationOrigin = input.origin ?? buildOperationOrigin({
+        interface: "daemon",
+        action: input.existing ? "update" : "create",
+        subsystem: "episode_summary",
+        config: input.config,
+        metadata: {
+            session_id: input.sessionId,
+            episode_id: input.segment.episode_id,
+            event_count: input.segment.event_count,
+        },
+    });
     const payload = {
         ...existingPayload,
         content: redactedContent.text,
@@ -129,9 +141,9 @@ export const buildEpisodeSummaryPayload = (input) => {
         memory_subtype: "episode",
         layer: "episode",
         ...(input.scope.workspaceId ? { workspace_id: input.scope.workspaceId } : {}),
-        ...(input.scope.actorId ? { actor_id: input.scope.actorId } : {}),
+        origin: existingPayload.origin ?? operationOrigin,
+        ...(input.existing ? { last_operation_origin: operationOrigin } : {}),
         entities: redactedEntities.map((entity) => entity.text.toLowerCase()),
-        source: "system",
         confidence: 1.0,
         importance: input.draft.importance,
         content_hash: contentHash(redactedContent.text),
@@ -184,19 +196,36 @@ const summarizeEpisodeTranscript = async (input) => {
         throw new Error("Episode summary LLM returned null");
     return parseEpisodeSummaryDraft(result);
 };
-const findExistingEpisodeSummary = async (episodeId, scope) => {
-    const result = await qdrant.qdrantRequest("POST", `/collections/${qdrant.collection}/points/scroll`, {
+const findExistingEpisodeSummary = async (episodeId, scope, destination) => {
+    const collection = qdrant.collectionForDestination(destination);
+    const result = await qdrant.qdrantRequest("POST", `/collections/${collection}/points/scroll`, {
         filter: buildEpisodeSummaryFilter(episodeId, scope),
         limit: 1,
         with_payload: true,
-    });
+    }, destination);
     return result.result?.points?.[0] ?? null;
 };
 export const updateEpisodeSummary = async (input) => {
     if (!input.segment.transcript.trim()) {
         return { action: "skipped", reason: "empty_transcript", episodeId: input.segment.episode_id };
     }
-    const existing = await findExistingEpisodeSummary(input.segment.episode_id, input.scope);
+    const destination = qdrant.resolveDestination({
+        content: input.segment.transcript,
+        entities: [
+            input.sessionId,
+            ...(input.segment.workstream_key ? [input.segment.workstream_key] : []),
+        ],
+        metadata: {
+            session_id: input.sessionId,
+            episode_id: input.segment.episode_id,
+            ...(input.segment.workstream_key ? { workstream_key: input.segment.workstream_key } : {}),
+            memory_subtype: "episode",
+            kind: "summary",
+            origin_interface: "daemon",
+            origin_agent_type: "daemon",
+        },
+    });
+    const existing = await findExistingEpisodeSummary(input.segment.episode_id, input.scope, destination.name);
     const draft = await summarizeEpisodeTranscript({
         transcript: input.segment.transcript,
         sessionId: input.sessionId,
@@ -222,6 +251,7 @@ export const updateEpisodeSummary = async (input) => {
         scope: input.scope,
         now,
         existing,
+        config: input.config,
         redactionOptions: {
             enabled: true,
             redactPii: false,
@@ -229,13 +259,14 @@ export const updateEpisodeSummary = async (input) => {
     });
     const vector = await qdrant.embed(String(payload.content));
     const factId = existing?.id ?? randomUUID();
-    await qdrant.qdrantRequest("PUT", `/collections/${qdrant.collection}/points`, {
+    await qdrant.qdrantRequest("PUT", `/collections/${destination.collection}/points`, {
         points: [{ id: factId, vector, payload }],
-    });
+    }, destination.name);
     return {
         action: existing ? "updated" : "stored",
         factId,
         episodeId: input.segment.episode_id,
+        destination: destination.name,
         workstreamKey: resolved.key,
     };
 };

package/dist/daemon/extraction.d.ts

@@ -1,6 +1,6 @@
 /**
  * Events-based memory extraction — reads supported coding-agent transcripts,
- * extracts facts via LLM, and stores them in Qdrant with source: "system".
+ * extracts facts via LLM, and stores them in Qdrant with daemon origin metadata.
  *
  * Uses a JSON file for extraction state (high-water byte offsets) instead of SQLite.
  * Copilot session detection uses lock files. Claude Code detection uses