octoflow-core 1.0.0

package/dist/runtime/bridge/brain-config.d.ts

@@ -0,0 +1,248 @@
+import type { MemoryKind, MemorySource, MemoryStatus } from 'octoflow-protocols';
+import type { MemoryScope } from '../../domain/memory-scope.js';
+/**
+ * File-safe brain store preset. `memory` is always ephemeral; `sqlite` is
+ * durable at `~/.octoflow/db/brain.sqlite` unless overridden.
+ * Vector/FTS tuning is intentionally omitted in phase 1 — configuring those
+ * without an explicit runtime embedder is an easy foot-gun.
+ */
+export type BrainStoreConfig = {
+    type: 'memory';
+} | {
+    type?: 'sqlite';
+    path?: string;
+    enableFTS?: boolean;
+    enableVec?: boolean;
+    vecDimensions?: number;
+};
+export type BrainPresetName = 'local' | 'hybrid' | 'quality' | 'production';
+export interface SerializableMmrLayerOptions {
+    topK?: number;
+    lambda?: number;
+}
+export type SerializableProductionSafetyPiiMode = 'redact' | 'reject' | 'off';
+export interface SerializableProductionSafetyLayerOptions {
+    pii?: SerializableProductionSafetyPiiMode;
+    requireScopeIdFor?: readonly Exclude<MemoryScope, 'global'>[];
+    rejectPromptInjection?: boolean;
+    minExternalEvidence?: number;
+    maxExternalConfidenceWithoutEvidence?: number;
+}
+export interface SerializableBrainLayerConfig {
+    lexical?: boolean;
+    vector?: boolean;
+    contextualChunking?: false | {
+        context: string;
+    };
+    mmr?: false | true | SerializableMmrLayerOptions;
+    productionSafety?: false | true | SerializableProductionSafetyLayerOptions;
+}
+/**
+ * Subset of `MemoryBrainOptions` that is safe to round-trip through JSON.
+ * Function-valued options (`embedder`) live on `RuntimeBrainConfig` only.
+ */
+export interface SerializableBrainOptions {
+    bloomBitsPerItem?: number;
+    bloomHashCount?: number;
+    brotliQuality?: number;
+    promoteThreshold?: number;
+    hunchThreshold?: number;
+    replayBudget?: {
+        fails: number;
+        wins: number;
+        exploration: number;
+    };
+    weights?: {
+        importance: number;
+        novelty: number;
+        reuse: number;
+        outcome: number;
+        confidence: number;
+    };
+}
+/**
+ * Optional pre-turn recall that injects relevant memories into the next task's
+ * system prompt before the backend is called. `true` uses conservative
+ * defaults; an object tunes scope and result count.
+ */
+export interface BrainAutoRecallOptions {
+    enabled?: boolean;
+    /** Override the recall scope. Defaults to `defaultScope`. */
+    scope?: MemoryScope;
+    /** Fixed scope id for recall. Otherwise derived from scopeIdSource. */
+    scopeId?: string;
+    /** Number of recalled memories to inject. Defaults to 5. */
+    topK?: number;
+    /** Drop recalled items below this score before injection. */
+    minScore?: number;
+}
+export type BrainAutoRecallConfig = boolean | BrainAutoRecallOptions;
+/**
+ * Optional post-turn memory capture. `true` stores successful task output
+ * after duplicate recall checks; an object tunes scope, kind, source, and caps.
+ */
+export interface BrainAutoRememberOptions {
+    enabled?: boolean;
+    /** Override the write scope. Defaults to `defaultScope`. */
+    scope?: MemoryScope;
+    /** Fixed scope id for writes. Otherwise derived from the task/context. */
+    scopeId?: string;
+    /** Minimum text length worth storing. Defaults to 24. */
+    minChars?: number;
+    /** Maximum stored text length. Defaults to 1200. */
+    maxChars?: number;
+    /** Similarity score at or above which a write is skipped. Defaults to 0.85. */
+    duplicateThreshold?: number;
+    /** Memory kind for automatic writes. Defaults to `observation`. */
+    kind?: MemoryKind;
+    /** Memory source for automatic writes. Defaults to `tool`. */
+    source?: MemorySource;
+    /** Confidence for automatic writes. Defaults to 0.65. */
+    confidence?: number;
+}
+export type BrainAutoRememberConfig = boolean | BrainAutoRememberOptions;
+/**
+ * File-safe HTTP adapter config for a shared remote brain service. Secrets stay
+ * in the environment; use `authTokenEnv` rather than writing tokens to config.
+ */
+export interface SerializableRemoteBrainConfig {
+    enabled?: boolean;
+    baseUrl?: string;
+    headers?: Record<string, string>;
+    authTokenEnv?: string;
+    timeoutMs?: number;
+    retries?: number;
+    retryDelayMs?: number;
+    idempotencyKey?: string;
+    contractVersion?: number;
+    closeEndpoint?: boolean | string;
+}
+/**
+ * Maintenance cycle configuration. `false` disables; an object enables the
+ * shipped `BrainScheduler.runCycle()` on the chosen cadence plus optional
+ * pruning and `task:completed` hook.
+ */
+export interface BrainMaintenanceConfig {
+    /** Optional scope for interval maintenance. Omit for task-context maintenance. */
+    scope?: MemoryScope;
+    /** Optional scope id for interval maintenance or a fixed maintenance target. */
+    scopeId?: string;
+    /** Interval in ms between `runCycle()` invocations. Omit to disable interval maintenance. */
+    intervalMs?: number;
+    /** Per-cycle `consolidate.budgetMs` passed to the scheduler. */
+    budgetMs?: number;
+    /** Replay budget per cycle. Forwarded to `BrainScheduler.runCycle`. */
+    maxReplayItems?: number;
+    /** Run one cycle on every `task:completed` event. */
+    onTaskCompleted?: boolean;
+    /** Prune after each cycle (omit to skip pruning). */
+    prune?: {
+        maxAgeMs?: number;
+        statuses?: MemoryStatus[];
+    };
+}
+/**
+ * How the scope-default adapter should source `scopeId` when callers omit it.
+ *
+ * - `'context'` / `'tenant'` — fail closed on direct `bridge.brain.*` calls
+ *   that need a scopeId; the caller must supply one. Auto-population is
+ *   expected to be wired in phase 2+ via bridge-owned call sites.
+ * - `'none'` — never require a scopeId. Suitable when `defaultScope` is
+ *   `'global'` or callers always set scopeId explicitly.
+ */
+export type BrainScopeIdSource = 'context' | 'tenant' | 'none';
+/**
+ * File-serializable brain config. Ships in `octoflow.config.json` under
+ * the top-level `brain` key.
+ */
+export interface BrainConfig {
+    enabled?: boolean;
+    store?: BrainStoreConfig;
+    remoteBrain?: SerializableRemoteBrainConfig;
+    options?: SerializableBrainOptions;
+    preset?: BrainPresetName;
+    layers?: SerializableBrainLayerConfig;
+    defaultScope?: MemoryScope;
+    scopeIdSource?: BrainScopeIdSource;
+    maintenance?: false | BrainMaintenanceConfig;
+    /**
+     * Pre-turn recall. When enabled, the bridge recalls memories for each
+     * `sendMessage()` and injects them into the system prompt before backend
+     * execution.
+     */
+    autoRecall?: false | BrainAutoRecallConfig;
+    /**
+     * Post-turn memory capture. When enabled, successful task output is deduped
+     * and stored through the policy-wrapped bridge brain.
+     */
+    autoRemember?: false | BrainAutoRememberConfig;
+    /**
+     * Emit `brain:advisory` once on first task activity if no brain consumer
+     * (tools, bootstrap middleware, or direct `bridge.brain.*` call) has been
+     * observed. Default `true` — never escalates beyond a single event.
+     */
+    advise?: boolean;
+}
+/**
+ * Runtime form. Accepts the file surface plus function-valued extras that
+ * cannot be serialised (e.g. an embedder instance).
+ */
+/** Runtime-only structural mirror of `TextEmbedder` from
+ *  `octoflow-brain`. Declared here so `octoflow-core` does not need a
+ *  runtime import of the optional peer. Callers passing a real `TextEmbedder`
+ *  are structurally compatible. */
+type BrainEmbeddingVectorLike = Float32Array | Float64Array | readonly number[];
+interface BrainTextEmbedderLike {
+    readonly dimensions: number;
+    readonly model?: string;
+    readonly provider?: string;
+    embed(text: string): Promise<BrainEmbeddingVectorLike>;
+    embedDocument?(text: string): Promise<BrainEmbeddingVectorLike>;
+    embedQuery?(query: string): Promise<BrainEmbeddingVectorLike>;
+    embedMany?(texts: readonly string[]): Promise<BrainEmbeddingVectorLike[]>;
+    embedDocuments?(texts: readonly string[]): Promise<BrainEmbeddingVectorLike[]>;
+    embedQueries?(queries: readonly string[]): Promise<BrainEmbeddingVectorLike[]>;
+}
+export interface RuntimeBrainConfig extends BrainConfig {
+    options?: SerializableBrainOptions & {
+        embedder?: BrainTextEmbedderLike;
+    };
+}
+/**
+ * Effective (post-merge) brain config after file + runtime are combined.
+ * Leaves are always resolved; `undefined` means "inherit shipped default".
+ */
+export interface ResolvedBrainConfig {
+    enabled: boolean;
+    store: BrainStoreConfig;
+    remoteBrain?: SerializableRemoteBrainConfig;
+    options: NonNullable<RuntimeBrainConfig['options']>;
+    preset?: BrainPresetName;
+    layers?: SerializableBrainLayerConfig;
+    defaultScope: MemoryScope;
+    scopeIdSource: BrainScopeIdSource;
+    maintenance: false | BrainMaintenanceConfig;
+    autoRecall: false | true | BrainAutoRecallOptions;
+    autoRemember: false | true | BrainAutoRememberOptions;
+    advise: boolean;
+}
+/**
+ * Merge file config with runtime overrides. Runtime wins per leaf; nested
+ * objects (`store`, `options`, `maintenance`) merge per field. `enabled` at
+ * runtime always wins, so callers can disable a file-enabled brain.
+ */
+export declare function mergeBrainConfig(fileConfig: BrainConfig | undefined, runtimeConfig: RuntimeBrainConfig | undefined): RuntimeBrainConfig | undefined;
+/**
+ * Resolve shipped defaults against the merged config. Shape the output so
+ * call sites never need to re-check `undefined` on the leaves we care about
+ * (`enabled`, `store.type`, `defaultScope`, `scopeIdSource`, `advise`).
+ *
+ * `storage` is the bridge-wide `BridgeOptions.storage` toggle — when
+ * `storage === true` and the caller did not set `store`, we default the
+ * brain store to `sqlite`. Otherwise the runtime stays ephemeral by default.
+ */
+export declare function resolveBrainConfig(merged: RuntimeBrainConfig | undefined, opts: {
+    storage?: boolean;
+}): ResolvedBrainConfig | undefined;
+export {};
+//# sourceMappingURL=brain-config.d.ts.map

package/dist/runtime/bridge/brain-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-config.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/brain-config.ts"],"names":[],"mappings":"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"}

package/dist/runtime/bridge/brain-config.js

@@ -0,0 +1,71 @@
+const DEFAULT_STORE = { type: "memory" };
+function mergeBrainConfig(fileConfig, runtimeConfig) {
+  if (!fileConfig && !runtimeConfig) return void 0;
+  const file = fileConfig ?? {};
+  const runtime = runtimeConfig ?? {};
+  const maintenance = mergeMaintenance(file.maintenance, runtime.maintenance);
+  return {
+    enabled: runtime.enabled ?? file.enabled,
+    store: mergeStore(file.store, runtime.store),
+    remoteBrain: mergeRemoteBrain(file.remoteBrain, runtime.remoteBrain),
+    options: { ...file.options ?? {}, ...runtime.options ?? {} },
+    preset: runtime.preset ?? file.preset,
+    layers: mergeLayers(file.layers, runtime.layers),
+    defaultScope: runtime.defaultScope ?? file.defaultScope,
+    scopeIdSource: runtime.scopeIdSource ?? file.scopeIdSource,
+    maintenance,
+    autoRecall: runtime.autoRecall ?? file.autoRecall,
+    autoRemember: runtime.autoRemember ?? file.autoRemember,
+    advise: runtime.advise ?? file.advise
+  };
+}
+function mergeRemoteBrain(file, runtime) {
+  if (!file && !runtime) return void 0;
+  return { ...file ?? {}, ...runtime ?? {} };
+}
+function mergeLayers(file, runtime) {
+  if (!file && !runtime) return void 0;
+  return { ...file ?? {}, ...runtime ?? {} };
+}
+function mergeStore(file, runtime) {
+  if (!file && !runtime) return void 0;
+  if (!file) return runtime;
+  if (!runtime) return file;
+  if (storeKind(runtime) !== storeKind(file)) {
+    return runtime;
+  }
+  return { ...file, ...runtime };
+}
+function storeKind(store) {
+  return store.type === "memory" ? "memory" : "sqlite";
+}
+function mergeMaintenance(file, runtime) {
+  if (runtime === false) return false;
+  if (file === false) return runtime ?? false;
+  if (!file && !runtime) return false;
+  return { ...file ?? {}, ...runtime ?? {} };
+}
+function resolveBrainConfig(merged, opts) {
+  if (!merged || !merged.enabled) return void 0;
+  const durable = opts.storage === true;
+  const store = merged.store ?? (durable ? { type: "sqlite" } : DEFAULT_STORE);
+  return {
+    enabled: true,
+    store,
+    remoteBrain: merged.remoteBrain,
+    options: merged.options ?? {},
+    preset: merged.preset,
+    layers: merged.layers,
+    defaultScope: merged.defaultScope ?? "context",
+    scopeIdSource: merged.scopeIdSource ?? "context",
+    maintenance: merged.maintenance ?? false,
+    autoRecall: merged.autoRecall ?? true,
+    autoRemember: merged.autoRemember ?? true,
+    advise: merged.advise ?? true
+  };
+}
+export {
+  mergeBrainConfig,
+  resolveBrainConfig
+};
+//# sourceMappingURL=brain-config.js.map

package/dist/runtime/bridge/brain-config.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/bridge/brain-config.ts"],
+  "sourcesContent": ["import type {\n  MemoryKind,\n  MemorySource,\n  MemoryStatus,\n} from 'octoflow-protocols';\n\nimport type { MemoryScope } from '../../domain/memory-scope.js';\n\n/**\n * File-safe brain store preset. `memory` is always ephemeral; `sqlite` is\n * durable at `~/.octoflow/db/brain.sqlite` unless overridden.\n * Vector/FTS tuning is intentionally omitted in phase 1 \u2014 configuring those\n * without an explicit runtime embedder is an easy foot-gun.\n */\nexport type BrainStoreConfig =\n  | { type: 'memory' }\n  | {\n      type?: 'sqlite';\n      path?: string;\n      enableFTS?: boolean;\n      enableVec?: boolean;\n      vecDimensions?: number;\n    };\n\nexport type BrainPresetName = 'local' | 'hybrid' | 'quality' | 'production';\n\nexport interface SerializableMmrLayerOptions {\n  topK?: number;\n  lambda?: number;\n}\n\nexport type SerializableProductionSafetyPiiMode = 'redact' | 'reject' | 'off';\n\nexport interface SerializableProductionSafetyLayerOptions {\n  pii?: SerializableProductionSafetyPiiMode;\n  requireScopeIdFor?: readonly Exclude<MemoryScope, 'global'>[];\n  rejectPromptInjection?: boolean;\n  minExternalEvidence?: number;\n  maxExternalConfidenceWithoutEvidence?: number;\n}\n\nexport interface SerializableBrainLayerConfig {\n  lexical?: boolean;\n  vector?: boolean;\n  contextualChunking?: false | { context: string };\n  mmr?: false | true | SerializableMmrLayerOptions;\n  productionSafety?: false | true | SerializableProductionSafetyLayerOptions;\n}\n\n/**\n * Subset of `MemoryBrainOptions` that is safe to round-trip through JSON.\n * Function-valued options (`embedder`) live on `RuntimeBrainConfig` only.\n */\nexport interface SerializableBrainOptions {\n  bloomBitsPerItem?: number;\n  bloomHashCount?: number;\n  brotliQuality?: number;\n  promoteThreshold?: number;\n  hunchThreshold?: number;\n  replayBudget?: { fails: number; wins: number; exploration: number };\n  weights?: {\n    importance: number;\n    novelty: number;\n    reuse: number;\n    outcome: number;\n    confidence: number;\n  };\n}\n\n/**\n * Optional pre-turn recall that injects relevant memories into the next task's\n * system prompt before the backend is called. `true` uses conservative\n * defaults; an object tunes scope and result count.\n */\nexport interface BrainAutoRecallOptions {\n  enabled?: boolean;\n  /** Override the recall scope. Defaults to `defaultScope`. */\n  scope?: MemoryScope;\n  /** Fixed scope id for recall. Otherwise derived from scopeIdSource. */\n  scopeId?: string;\n  /** Number of recalled memories to inject. Defaults to 5. */\n  topK?: number;\n  /** Drop recalled items below this score before injection. */\n  minScore?: number;\n}\n\nexport type BrainAutoRecallConfig = boolean | BrainAutoRecallOptions;\n\n/**\n * Optional post-turn memory capture. `true` stores successful task output\n * after duplicate recall checks; an object tunes scope, kind, source, and caps.\n */\nexport interface BrainAutoRememberOptions {\n  enabled?: boolean;\n  /** Override the write scope. Defaults to `defaultScope`. */\n  scope?: MemoryScope;\n  /** Fixed scope id for writes. Otherwise derived from the task/context. */\n  scopeId?: string;\n  /** Minimum text length worth storing. Defaults to 24. */\n  minChars?: number;\n  /** Maximum stored text length. Defaults to 1200. */\n  maxChars?: number;\n  /** Similarity score at or above which a write is skipped. Defaults to 0.85. */\n  duplicateThreshold?: number;\n  /** Memory kind for automatic writes. Defaults to `observation`. */\n  kind?: MemoryKind;\n  /** Memory source for automatic writes. Defaults to `tool`. */\n  source?: MemorySource;\n  /** Confidence for automatic writes. Defaults to 0.65. */\n  confidence?: number;\n}\n\nexport type BrainAutoRememberConfig = boolean | BrainAutoRememberOptions;\n\n/**\n * File-safe HTTP adapter config for a shared remote brain service. Secrets stay\n * in the environment; use `authTokenEnv` rather than writing tokens to config.\n */\nexport interface SerializableRemoteBrainConfig {\n  enabled?: boolean;\n  baseUrl?: string;\n  headers?: Record<string, string>;\n  authTokenEnv?: string;\n  timeoutMs?: number;\n  retries?: number;\n  retryDelayMs?: number;\n  idempotencyKey?: string;\n  contractVersion?: number;\n  closeEndpoint?: boolean | string;\n}\n\n/**\n * Maintenance cycle configuration. `false` disables; an object enables the\n * shipped `BrainScheduler.runCycle()` on the chosen cadence plus optional\n * pruning and `task:completed` hook.\n */\nexport interface BrainMaintenanceConfig {\n  /** Optional scope for interval maintenance. Omit for task-context maintenance. */\n  scope?: MemoryScope;\n  /** Optional scope id for interval maintenance or a fixed maintenance target. */\n  scopeId?: string;\n  /** Interval in ms between `runCycle()` invocations. Omit to disable interval maintenance. */\n  intervalMs?: number;\n  /** Per-cycle `consolidate.budgetMs` passed to the scheduler. */\n  budgetMs?: number;\n  /** Replay budget per cycle. Forwarded to `BrainScheduler.runCycle`. */\n  maxReplayItems?: number;\n  /** Run one cycle on every `task:completed` event. */\n  onTaskCompleted?: boolean;\n  /** Prune after each cycle (omit to skip pruning). */\n  prune?: { maxAgeMs?: number; statuses?: MemoryStatus[] };\n}\n\n/**\n * How the scope-default adapter should source `scopeId` when callers omit it.\n *\n * - `'context'` / `'tenant'` \u2014 fail closed on direct `bridge.brain.*` calls\n *   that need a scopeId; the caller must supply one. Auto-population is\n *   expected to be wired in phase 2+ via bridge-owned call sites.\n * - `'none'` \u2014 never require a scopeId. Suitable when `defaultScope` is\n *   `'global'` or callers always set scopeId explicitly.\n */\nexport type BrainScopeIdSource = 'context' | 'tenant' | 'none';\n\n/**\n * File-serializable brain config. Ships in `octoflow.config.json` under\n * the top-level `brain` key.\n */\nexport interface BrainConfig {\n  enabled?: boolean;\n  store?: BrainStoreConfig;\n  remoteBrain?: SerializableRemoteBrainConfig;\n  options?: SerializableBrainOptions;\n  preset?: BrainPresetName;\n  layers?: SerializableBrainLayerConfig;\n  defaultScope?: MemoryScope;\n  scopeIdSource?: BrainScopeIdSource;\n  maintenance?: false | BrainMaintenanceConfig;\n  /**\n   * Pre-turn recall. When enabled, the bridge recalls memories for each\n   * `sendMessage()` and injects them into the system prompt before backend\n   * execution.\n   */\n  autoRecall?: false | BrainAutoRecallConfig;\n  /**\n   * Post-turn memory capture. When enabled, successful task output is deduped\n   * and stored through the policy-wrapped bridge brain.\n   */\n  autoRemember?: false | BrainAutoRememberConfig;\n  /**\n   * Emit `brain:advisory` once on first task activity if no brain consumer\n   * (tools, bootstrap middleware, or direct `bridge.brain.*` call) has been\n   * observed. Default `true` \u2014 never escalates beyond a single event.\n   */\n  advise?: boolean;\n}\n\n/**\n * Runtime form. Accepts the file surface plus function-valued extras that\n * cannot be serialised (e.g. an embedder instance).\n */\n/** Runtime-only structural mirror of `TextEmbedder` from\n *  `octoflow-brain`. Declared here so `octoflow-core` does not need a\n *  runtime import of the optional peer. Callers passing a real `TextEmbedder`\n *  are structurally compatible. */\ntype BrainEmbeddingVectorLike = Float32Array | Float64Array | readonly number[];\n\ninterface BrainTextEmbedderLike {\n  readonly dimensions: number;\n  readonly model?: string;\n  readonly provider?: string;\n  embed(text: string): Promise<BrainEmbeddingVectorLike>;\n  embedDocument?(text: string): Promise<BrainEmbeddingVectorLike>;\n  embedQuery?(query: string): Promise<BrainEmbeddingVectorLike>;\n  embedMany?(texts: readonly string[]): Promise<BrainEmbeddingVectorLike[]>;\n  embedDocuments?(\n    texts: readonly string[]\n  ): Promise<BrainEmbeddingVectorLike[]>;\n  embedQueries?(\n    queries: readonly string[]\n  ): Promise<BrainEmbeddingVectorLike[]>;\n}\n\nexport interface RuntimeBrainConfig extends BrainConfig {\n  options?: SerializableBrainOptions & {\n    embedder?: BrainTextEmbedderLike;\n  };\n}\n\n/**\n * Effective (post-merge) brain config after file + runtime are combined.\n * Leaves are always resolved; `undefined` means \"inherit shipped default\".\n */\nexport interface ResolvedBrainConfig {\n  enabled: boolean;\n  store: BrainStoreConfig;\n  remoteBrain?: SerializableRemoteBrainConfig;\n  options: NonNullable<RuntimeBrainConfig['options']>;\n  preset?: BrainPresetName;\n  layers?: SerializableBrainLayerConfig;\n  defaultScope: MemoryScope;\n  scopeIdSource: BrainScopeIdSource;\n  maintenance: false | BrainMaintenanceConfig;\n  autoRecall: false | true | BrainAutoRecallOptions;\n  autoRemember: false | true | BrainAutoRememberOptions;\n  advise: boolean;\n}\n\nconst DEFAULT_STORE: BrainStoreConfig = { type: 'memory' };\n\n/**\n * Merge file config with runtime overrides. Runtime wins per leaf; nested\n * objects (`store`, `options`, `maintenance`) merge per field. `enabled` at\n * runtime always wins, so callers can disable a file-enabled brain.\n */\nexport function mergeBrainConfig(\n  fileConfig: BrainConfig | undefined,\n  runtimeConfig: RuntimeBrainConfig | undefined\n): RuntimeBrainConfig | undefined {\n  if (!fileConfig && !runtimeConfig) return undefined;\n\n  const file = fileConfig ?? {};\n  const runtime = runtimeConfig ?? {};\n\n  const maintenance = mergeMaintenance(file.maintenance, runtime.maintenance);\n\n  return {\n    enabled: runtime.enabled ?? file.enabled,\n    store: mergeStore(file.store, runtime.store),\n    remoteBrain: mergeRemoteBrain(file.remoteBrain, runtime.remoteBrain),\n    options: { ...(file.options ?? {}), ...(runtime.options ?? {}) },\n    preset: runtime.preset ?? file.preset,\n    layers: mergeLayers(file.layers, runtime.layers),\n    defaultScope: runtime.defaultScope ?? file.defaultScope,\n    scopeIdSource: runtime.scopeIdSource ?? file.scopeIdSource,\n    maintenance,\n    autoRecall: runtime.autoRecall ?? file.autoRecall,\n    autoRemember: runtime.autoRemember ?? file.autoRemember,\n    advise: runtime.advise ?? file.advise,\n  };\n}\n\nfunction mergeRemoteBrain(\n  file: BrainConfig['remoteBrain'],\n  runtime: RuntimeBrainConfig['remoteBrain']\n): SerializableRemoteBrainConfig | undefined {\n  if (!file && !runtime) return undefined;\n  return { ...(file ?? {}), ...(runtime ?? {}) };\n}\n\nfunction mergeLayers(\n  file: BrainConfig['layers'],\n  runtime: RuntimeBrainConfig['layers']\n): SerializableBrainLayerConfig | undefined {\n  if (!file && !runtime) return undefined;\n  return { ...(file ?? {}), ...(runtime ?? {}) };\n}\n\nfunction mergeStore(\n  file: BrainStoreConfig | undefined,\n  runtime: BrainStoreConfig | undefined\n): BrainStoreConfig | undefined {\n  if (!file && !runtime) return undefined;\n  if (!file) return runtime;\n  if (!runtime) return file;\n\n  if (storeKind(runtime) !== storeKind(file)) {\n    return runtime;\n  }\n  return { ...file, ...runtime };\n}\n\nfunction storeKind(store: BrainStoreConfig): 'memory' | 'sqlite' {\n  return store.type === 'memory' ? 'memory' : 'sqlite';\n}\n\nfunction mergeMaintenance(\n  file: BrainConfig['maintenance'],\n  runtime: RuntimeBrainConfig['maintenance']\n): ResolvedBrainConfig['maintenance'] {\n  if (runtime === false) return false;\n  if (file === false) return runtime ?? false;\n  if (!file && !runtime) return false;\n  return { ...(file ?? {}), ...(runtime ?? {}) };\n}\n\n/**\n * Resolve shipped defaults against the merged config. Shape the output so\n * call sites never need to re-check `undefined` on the leaves we care about\n * (`enabled`, `store.type`, `defaultScope`, `scopeIdSource`, `advise`).\n *\n * `storage` is the bridge-wide `BridgeOptions.storage` toggle \u2014 when\n * `storage === true` and the caller did not set `store`, we default the\n * brain store to `sqlite`. Otherwise the runtime stays ephemeral by default.\n */\nexport function resolveBrainConfig(\n  merged: RuntimeBrainConfig | undefined,\n  opts: { storage?: boolean }\n): ResolvedBrainConfig | undefined {\n  if (!merged || !merged.enabled) return undefined;\n\n  const durable = opts.storage === true;\n  const store: BrainStoreConfig =\n    merged.store ?? (durable ? { type: 'sqlite' } : DEFAULT_STORE);\n\n  return {\n    enabled: true,\n    store,\n    remoteBrain: merged.remoteBrain,\n    options: merged.options ?? {},\n    preset: merged.preset,\n    layers: merged.layers,\n    defaultScope: merged.defaultScope ?? 'context',\n    scopeIdSource: merged.scopeIdSource ?? 'context',\n    maintenance: merged.maintenance ?? false,\n    autoRecall: merged.autoRecall ?? true,\n    autoRemember: merged.autoRemember ?? true,\n    advise: merged.advise ?? true,\n  };\n}\n"],
+  "mappings": "AAwPA,MAAM,gBAAkC,EAAE,MAAM,SAAS;AAOlD,SAAS,iBACd,YACA,eACgC;AAChC,MAAI,CAAC,cAAc,CAAC,cAAe,QAAO;AAE1C,QAAM,OAAO,cAAc,CAAC;AAC5B,QAAM,UAAU,iBAAiB,CAAC;AAElC,QAAM,cAAc,iBAAiB,KAAK,aAAa,QAAQ,WAAW;AAE1E,SAAO;AAAA,IACL,SAAS,QAAQ,WAAW,KAAK;AAAA,IACjC,OAAO,WAAW,KAAK,OAAO,QAAQ,KAAK;AAAA,IAC3C,aAAa,iBAAiB,KAAK,aAAa,QAAQ,WAAW;AAAA,IACnE,SAAS,EAAE,GAAI,KAAK,WAAW,CAAC,GAAI,GAAI,QAAQ,WAAW,CAAC,EAAG;AAAA,IAC/D,QAAQ,QAAQ,UAAU,KAAK;AAAA,IAC/B,QAAQ,YAAY,KAAK,QAAQ,QAAQ,MAAM;AAAA,IAC/C,cAAc,QAAQ,gBAAgB,KAAK;AAAA,IAC3C,eAAe,QAAQ,iBAAiB,KAAK;AAAA,IAC7C;AAAA,IACA,YAAY,QAAQ,cAAc,KAAK;AAAA,IACvC,cAAc,QAAQ,gBAAgB,KAAK;AAAA,IAC3C,QAAQ,QAAQ,UAAU,KAAK;AAAA,EACjC;AACF;AAEA,SAAS,iBACP,MACA,SAC2C;AAC3C,MAAI,CAAC,QAAQ,CAAC,QAAS,QAAO;AAC9B,SAAO,EAAE,GAAI,QAAQ,CAAC,GAAI,GAAI,WAAW,CAAC,EAAG;AAC/C;AAEA,SAAS,YACP,MACA,SAC0C;AAC1C,MAAI,CAAC,QAAQ,CAAC,QAAS,QAAO;AAC9B,SAAO,EAAE,GAAI,QAAQ,CAAC,GAAI,GAAI,WAAW,CAAC,EAAG;AAC/C;AAEA,SAAS,WACP,MACA,SAC8B;AAC9B,MAAI,CAAC,QAAQ,CAAC,QAAS,QAAO;AAC9B,MAAI,CAAC,KAAM,QAAO;AAClB,MAAI,CAAC,QAAS,QAAO;AAErB,MAAI,UAAU,OAAO,MAAM,UAAU,IAAI,GAAG;AAC1C,WAAO;AAAA,EACT;AACA,SAAO,EAAE,GAAG,MAAM,GAAG,QAAQ;AAC/B;AAEA,SAAS,UAAU,OAA8C;AAC/D,SAAO,MAAM,SAAS,WAAW,WAAW;AAC9C;AAEA,SAAS,iBACP,MACA,SACoC;AACpC,MAAI,YAAY,MAAO,QAAO;AAC9B,MAAI,SAAS,MAAO,QAAO,WAAW;AACtC,MAAI,CAAC,QAAQ,CAAC,QAAS,QAAO;AAC9B,SAAO,EAAE,GAAI,QAAQ,CAAC,GAAI,GAAI,WAAW,CAAC,EAAG;AAC/C;AAWO,SAAS,mBACd,QACA,MACiC;AACjC,MAAI,CAAC,UAAU,CAAC,OAAO,QAAS,QAAO;AAEvC,QAAM,UAAU,KAAK,YAAY;AACjC,QAAM,QACJ,OAAO,UAAU,UAAU,EAAE,MAAM,SAAS,IAAI;AAElD,SAAO;AAAA,IACL,SAAS;AAAA,IACT;AAAA,IACA,aAAa,OAAO;AAAA,IACpB,SAAS,OAAO,WAAW,CAAC;AAAA,IAC5B,QAAQ,OAAO;AAAA,IACf,QAAQ,OAAO;AAAA,IACf,cAAc,OAAO,gBAAgB;AAAA,IACrC,eAAe,OAAO,iBAAiB;AAAA,IACvC,aAAa,OAAO,eAAe;AAAA,IACnC,YAAY,OAAO,cAAc;AAAA,IACjC,cAAc,OAAO,gBAAgB;AAAA,IACrC,QAAQ,OAAO,UAAU;AAAA,EAC3B;AACF;",
+  "names": []
+}

package/dist/runtime/bridge/brain-contract.d.ts

@@ -0,0 +1,63 @@
+import type { AuditInput, AuditResult, ConsolidateInput, ConsolidateResult, DigestInput, DigestResult, FeedbackInput, FeedbackResult, MemoryCoreLike as ProtocolMemoryCoreLike, PruneInput, PruneResult, RecallInput, RecallResult, RememberInput, RememberResult, ReplayCycleResult, ReplayInput, ResolveContradictionInput, ResolveContradictionResult } from 'octoflow-protocols';
+import type { Bridge } from './bridge.js';
+/**
+ * Minimal memory surface required by the unified `memory` tool.
+ * Implementations that only target `createCognitiveMemoryTool` only need
+ * `remember` and `recall`. The full {@link CognitiveMemoryLike} adds 7 more.
+ */
+export type MemoryCoreLike = ProtocolMemoryCoreLike;
+/**
+ * Symbol used to signal across packages that the `memory` tool was used
+ * during a task. Checked by `brainAdvisoryPlugin` to suppress false-positive
+ * "no memory consumer detected" warnings.
+ *
+ * @internal
+ */
+export declare const MEMORY_CONSUMED_SYM: unique symbol;
+/**
+ * Structural contract matching `CognitiveMemory` from `octoflow-brain`.
+ * Defined structurally so the brain package stays an optional peer.
+ *
+ * Implementations should expose `contractVersion` to opt into
+ * `brainPlugin`'s drift detection. Missing the field skips the check.
+ *
+ * If you only need the unified `memory` tool (recall / remember / advisory),
+ * implement {@link MemoryCoreLike} instead — it only requires `remember` and `recall`.
+ */
+export interface CognitiveMemoryLike extends MemoryCoreLike {
+    /** Optional. Major version of the contract this implementation targets. */
+    readonly contractVersion?: number;
+    close?(): void | Promise<void>;
+    digest(input?: DigestInput): Promise<DigestResult>;
+    consolidate(input?: ConsolidateInput): Promise<ConsolidateResult>;
+    feedback(input: FeedbackInput): Promise<FeedbackResult>;
+    resolveContradiction(input: ResolveContradictionInput): Promise<ResolveContradictionResult>;
+    audit(input?: AuditInput): Promise<AuditResult>;
+    replay(input?: number | ReplayInput): Promise<ReplayCycleResult>;
+    prune(input?: PruneInput): Promise<PruneResult>;
+}
+export type BridgeWithBrain = Bridge & {
+    brain: CognitiveMemoryLike;
+};
+export interface BrainPluginHooks {
+    beforeRemember?: (input: RememberInput) => void | Promise<void>;
+    afterRemember?: (input: RememberInput, result: RememberResult) => void | Promise<void>;
+    beforeRecall?: (input: RecallInput) => void | Promise<void>;
+    afterRecall?: (input: RecallInput, result: RecallResult) => void | Promise<void>;
+    beforeDigest?: (input?: DigestInput) => void | Promise<void>;
+    afterDigest?: (input: DigestInput | undefined, result: DigestResult) => void | Promise<void>;
+    beforeConsolidate?: (input?: ConsolidateInput) => void | Promise<void>;
+    afterConsolidate?: (input: ConsolidateInput | undefined, result: ConsolidateResult) => void | Promise<void>;
+    beforeFeedback?: (input: FeedbackInput) => void | Promise<void>;
+    afterFeedback?: (input: FeedbackInput, result: FeedbackResult) => void | Promise<void>;
+    beforeContradiction?: (input: ResolveContradictionInput) => void | Promise<void>;
+    afterContradiction?: (input: ResolveContradictionInput, result: ResolveContradictionResult) => void | Promise<void>;
+    beforeAudit?: (input?: AuditInput) => void | Promise<void>;
+    afterAudit?: (input: AuditInput | undefined, result: AuditResult) => void | Promise<void>;
+    beforeReplay?: (input?: number | ReplayInput) => void | Promise<void>;
+    afterReplay?: (input: number | ReplayInput | undefined, result: ReplayCycleResult) => void | Promise<void>;
+    beforePrune?: (input?: PruneInput) => void | Promise<void>;
+    afterPrune?: (input: PruneInput | undefined, result: PruneResult) => void | Promise<void>;
+}
+export { COGNITIVE_MEMORY_CONTRACT_VERSION } from 'octoflow-protocols';
+//# sourceMappingURL=brain-contract.d.ts.map

package/dist/runtime/bridge/brain-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-contract.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/brain-contract.ts"],"names":[],"mappings":"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"}

package/dist/runtime/bridge/brain-contract.js

@@ -0,0 +1,7 @@
+const MEMORY_CONSUMED_SYM = /* @__PURE__ */ Symbol("octoflow.memoryConsumed");
+import { COGNITIVE_MEMORY_CONTRACT_VERSION } from "octoflow-protocols";
+export {
+  COGNITIVE_MEMORY_CONTRACT_VERSION,
+  MEMORY_CONSUMED_SYM
+};
+//# sourceMappingURL=brain-contract.js.map

package/dist/runtime/bridge/brain-contract.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/bridge/brain-contract.ts"],
+  "sourcesContent": ["import type {\n  AuditInput,\n  AuditResult,\n  ConsolidateInput,\n  ConsolidateResult,\n  DigestInput,\n  DigestResult,\n  FeedbackInput,\n  FeedbackResult,\n  MemoryCoreLike as ProtocolMemoryCoreLike,\n  PruneInput,\n  PruneResult,\n  RecallInput,\n  RecallResult,\n  RememberInput,\n  RememberResult,\n  ReplayCycleResult,\n  ReplayInput,\n  ResolveContradictionInput,\n  ResolveContradictionResult,\n} from 'octoflow-protocols';\n\nimport type { Bridge } from './bridge.js';\n\n/*\n * Brain contracts \u2014 `octoflow-protocols` is the source of truth for memory I/O\n * shapes; `brainPlugin` re-exports those types for the public bridge surface.\n *\n * This module exposes `COGNITIVE_MEMORY_CONTRACT_VERSION` plus bridge-owned\n * helpers (`CognitiveMemoryLike`, `BridgeWithBrain`, `BrainPluginHooks`).\n * The brain package stays an optional peer at runtime; protocol types use\n * `import type` only so they carry zero runtime cost here.\n */\n\n/**\n * Minimal memory surface required by the unified `memory` tool.\n * Implementations that only target `createCognitiveMemoryTool` only need\n * `remember` and `recall`. The full {@link CognitiveMemoryLike} adds 7 more.\n */\nexport type MemoryCoreLike = ProtocolMemoryCoreLike;\n\n/**\n * Symbol used to signal across packages that the `memory` tool was used\n * during a task. Checked by `brainAdvisoryPlugin` to suppress false-positive\n * \"no memory consumer detected\" warnings.\n *\n * @internal\n */\nexport const MEMORY_CONSUMED_SYM = Symbol('octoflow.memoryConsumed');\n\n/**\n * Structural contract matching `CognitiveMemory` from `octoflow-brain`.\n * Defined structurally so the brain package stays an optional peer.\n *\n * Implementations should expose `contractVersion` to opt into\n * `brainPlugin`'s drift detection. Missing the field skips the check.\n *\n * If you only need the unified `memory` tool (recall / remember / advisory),\n * implement {@link MemoryCoreLike} instead \u2014 it only requires `remember` and `recall`.\n */\nexport interface CognitiveMemoryLike extends MemoryCoreLike {\n  /** Optional. Major version of the contract this implementation targets. */\n  readonly contractVersion?: number;\n  close?(): void | Promise<void>;\n  digest(input?: DigestInput): Promise<DigestResult>;\n  consolidate(input?: ConsolidateInput): Promise<ConsolidateResult>;\n  feedback(input: FeedbackInput): Promise<FeedbackResult>;\n  resolveContradiction(\n    input: ResolveContradictionInput\n  ): Promise<ResolveContradictionResult>;\n  audit(input?: AuditInput): Promise<AuditResult>;\n  replay(input?: number | ReplayInput): Promise<ReplayCycleResult>;\n  prune(input?: PruneInput): Promise<PruneResult>;\n}\n\nexport type BridgeWithBrain = Bridge & { brain: CognitiveMemoryLike };\n\nexport interface BrainPluginHooks {\n  beforeRemember?: (input: RememberInput) => void | Promise<void>;\n  afterRemember?: (\n    input: RememberInput,\n    result: RememberResult\n  ) => void | Promise<void>;\n  beforeRecall?: (input: RecallInput) => void | Promise<void>;\n  afterRecall?: (\n    input: RecallInput,\n    result: RecallResult\n  ) => void | Promise<void>;\n  beforeDigest?: (input?: DigestInput) => void | Promise<void>;\n  afterDigest?: (\n    input: DigestInput | undefined,\n    result: DigestResult\n  ) => void | Promise<void>;\n  beforeConsolidate?: (input?: ConsolidateInput) => void | Promise<void>;\n  afterConsolidate?: (\n    input: ConsolidateInput | undefined,\n    result: ConsolidateResult\n  ) => void | Promise<void>;\n  beforeFeedback?: (input: FeedbackInput) => void | Promise<void>;\n  afterFeedback?: (\n    input: FeedbackInput,\n    result: FeedbackResult\n  ) => void | Promise<void>;\n  beforeContradiction?: (\n    input: ResolveContradictionInput\n  ) => void | Promise<void>;\n  afterContradiction?: (\n    input: ResolveContradictionInput,\n    result: ResolveContradictionResult\n  ) => void | Promise<void>;\n  beforeAudit?: (input?: AuditInput) => void | Promise<void>;\n  afterAudit?: (\n    input: AuditInput | undefined,\n    result: AuditResult\n  ) => void | Promise<void>;\n  beforeReplay?: (input?: number | ReplayInput) => void | Promise<void>;\n  afterReplay?: (\n    input: number | ReplayInput | undefined,\n    result: ReplayCycleResult\n  ) => void | Promise<void>;\n  beforePrune?: (input?: PruneInput) => void | Promise<void>;\n  afterPrune?: (\n    input: PruneInput | undefined,\n    result: PruneResult\n  ) => void | Promise<void>;\n}\n\nexport { COGNITIVE_MEMORY_CONTRACT_VERSION } from 'octoflow-protocols';\n"],
+  "mappings": "AAgDO,MAAM,sBAAsB,uBAAO,yBAAyB;AA+EnE,SAAS,yCAAyC;",
+  "names": []
+}

package/dist/runtime/bridge/brain-plugin-wrapper.d.ts

@@ -0,0 +1,13 @@
+import type { BridgePolicy, PolicySubject } from '../../policy/index.js';
+import type { BrainPluginHooks, CognitiveMemoryLike } from './brain-contract.js';
+import type { BridgeEventMap } from './events.js';
+interface BrainEventEmitter {
+    emit: <K extends keyof BridgeEventMap>(event: K, data: BridgeEventMap[K]) => Promise<void>;
+}
+type TaskContextGetter = () => {
+    taskId?: string;
+    contextId?: string;
+};
+declare function withHooksAndEvents(brain: CognitiveMemoryLike, hooks: BrainPluginHooks, emitter?: BrainEventEmitter, getTaskContext?: TaskContextGetter, policy?: BridgePolicy, policySubject?: PolicySubject, tenant?: string): CognitiveMemoryLike;
+export { withHooksAndEvents };
+//# sourceMappingURL=brain-plugin-wrapper.d.ts.map

package/dist/runtime/bridge/brain-plugin-wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-plugin-wrapper.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/brain-plugin-wrapper.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAKzE,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,UAAU,iBAAiB;IACzB,IAAI,EAAE,CAAC,CAAC,SAAS,MAAM,cAAc,EACnC,KAAK,EAAE,CAAC,EACR,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,KACpB,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAED,KAAK,iBAAiB,GAAG,MAAM;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAmCvE,iBAAS,kBAAkB,CACzB,KAAK,EAAE,mBAAmB,EAC1B,KAAK,EAAE,gBAAgB,EACvB,OAAO,CAAC,EAAE,iBAAiB,EAC3B,cAAc,CAAC,EAAE,iBAAiB,EAClC,MAAM,CAAC,EAAE,YAAY,EACrB,aAAa,CAAC,EAAE,aAAa,EAC7B,MAAM,CAAC,EAAE,MAAM,GACd,mBAAmB,CAqOrB;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}