octoflow-core 1.0.0

package/dist/runtime/bridge/brain-plugin-wrapper.js

@@ -0,0 +1,197 @@
+import {
+  assertPolicyAllowed,
+  resolvePolicySubject
+} from "../../policy/index.js";
+import { emitPolicyDecision } from "./policy-events.js";
+function replayScope(input) {
+  if (typeof input === "number" || input == null) {
+    return {};
+  }
+  return { scope: input.scope, scopeId: input.scopeId };
+}
+async function wrapOp(op, before, after, emit) {
+  await before?.();
+  const result = await op();
+  await after?.(result);
+  await emit?.(result);
+  return result;
+}
+function withHooksAndEvents(brain, hooks, emitter, getTaskContext, policy, policySubject, tenant) {
+  const ctx = () => getTaskContext?.() ?? {};
+  const memoryResource = (input) => ({
+    kind: "memory",
+    id: input?.relatedMemoryIds?.[0] ?? input?.memoryIdA ?? input?.scopeId,
+    tenant: input?.scope === "tenant" ? input.scopeId : tenant,
+    attributes: {
+      scope: input?.scope,
+      relatedMemoryIds: input?.relatedMemoryIds,
+      memoryIdA: input?.memoryIdA,
+      memoryIdB: input?.memoryIdB
+    }
+  });
+  const checkMemoryPolicy = (action, input) => assertPolicyAllowed(
+    policy,
+    {
+      action,
+      subject: resolvePolicySubject(policySubject),
+      resource: memoryResource(input),
+      context: ctx()
+    },
+    emitPolicyDecision(emitter?.emit.bind(emitter))
+  );
+  const ev = emitter ? (event, data) => emitter.emit(event, data) : void 0;
+  return {
+    get contractVersion() {
+      return brain.contractVersion;
+    },
+    close: () => brain.close?.() ?? Promise.resolve(),
+    remember: (input) => wrapOp(
+      () => brain.remember(input),
+      async () => {
+        await checkMemoryPolicy("memory.write", input);
+        await hooks.beforeRemember?.(input);
+      },
+      (r) => hooks.afterRemember?.(input, r),
+      ev ? (r) => ev("brain:remember", {
+        ...ctx(),
+        text: input.text,
+        kind: input.kind ?? "observation",
+        scope: input.scope ?? "global",
+        scopeId: input.scopeId,
+        recordId: r.accepted ? r.recordId : void 0,
+        accepted: r.accepted
+      }) : void 0
+    ),
+    recall: (input) => wrapOp(
+      () => brain.recall(input),
+      async () => {
+        await checkMemoryPolicy("memory.read", input);
+        await hooks.beforeRecall?.(input);
+      },
+      (r) => hooks.afterRecall?.(input, r),
+      ev ? (r) => ev("brain:recall", {
+        ...ctx(),
+        query: input.query,
+        scope: input.scope,
+        scopeId: input.scopeId,
+        topK: input.topK,
+        resultCount: r.items.length
+      }) : void 0
+    ),
+    digest: (input) => wrapOp(
+      () => brain.digest(input),
+      async () => {
+        await checkMemoryPolicy("memory.maintain", input);
+        await hooks.beforeDigest?.(input);
+      },
+      (r) => hooks.afterDigest?.(input, r),
+      ev ? (r) => ev("brain:digest", {
+        ...ctx(),
+        scope: input?.scope,
+        scopeId: input?.scopeId,
+        itemsCreated: r.itemsCreated,
+        hunchesUpdated: r.hunchesUpdated
+      }) : void 0
+    ),
+    consolidate: (input) => wrapOp(
+      () => brain.consolidate(input),
+      async () => {
+        await checkMemoryPolicy("memory.maintain", input);
+        await hooks.beforeConsolidate?.(input);
+      },
+      (r) => hooks.afterConsolidate?.(input, r),
+      ev ? (r) => ev("brain:consolidate", {
+        ...ctx(),
+        scope: input?.scope,
+        scopeId: input?.scopeId,
+        promoted: r.promoted,
+        reinforced: r.reinforced,
+        demoted: r.demoted,
+        quarantined: r.quarantined
+      }) : void 0
+    ),
+    feedback: (input) => wrapOp(
+      () => brain.feedback(input),
+      async () => {
+        await checkMemoryPolicy("memory.write", input);
+        await hooks.beforeFeedback?.(input);
+      },
+      (r) => hooks.afterFeedback?.(input, r),
+      ev ? (r) => ev("brain:feedback", {
+        ...ctx(),
+        outcome: input.outcome,
+        linked: r.linked,
+        updated: r.updated
+      }) : void 0
+    ),
+    resolveContradiction: (input) => wrapOp(
+      () => brain.resolveContradiction(input),
+      async () => {
+        await checkMemoryPolicy("memory.write", input);
+        await hooks.beforeContradiction?.(input);
+      },
+      (r) => hooks.afterContradiction?.(input, r),
+      ev ? (r) => ev("brain:contradiction", {
+        ...ctx(),
+        memoryIdA: input.memoryIdA,
+        memoryIdB: input.memoryIdB,
+        resolution: input.resolution,
+        resolved: r.resolved,
+        quarantined: r.quarantined,
+        confidenceDelta: r.confidenceDelta
+      }) : void 0
+    ),
+    audit: (input) => wrapOp(
+      () => brain.audit(input),
+      async () => {
+        await checkMemoryPolicy("memory.read", input);
+        await hooks.beforeAudit?.(input);
+      },
+      (r) => hooks.afterAudit?.(input, r),
+      ev ? (r) => ev("brain:audit", {
+        ...ctx(),
+        scope: input?.scope,
+        scopeId: input?.scopeId,
+        contradictionRate: r.contradictionRate,
+        quarantineCount: r.quarantineCount,
+        poisoningAlerts: r.poisoningAlerts,
+        failRecurrenceRate: r.failRecurrenceRate,
+        staleRate: r.staleRate,
+        totalRecords: r.totalRecords
+      }) : void 0
+    ),
+    replay: (input) => wrapOp(
+      () => brain.replay(input),
+      async () => {
+        await checkMemoryPolicy("memory.maintain", replayScope(input));
+        await hooks.beforeReplay?.(input);
+      },
+      (r) => hooks.afterReplay?.(input, r),
+      ev ? (r) => ev("brain:replay", {
+        ...ctx(),
+        ...replayScope(input),
+        failsReplayed: r.failsReplayed,
+        winsReplayed: r.winsReplayed,
+        explorationReplayed: r.explorationReplayed
+      }) : void 0
+    ),
+    prune: (input) => wrapOp(
+      () => brain.prune(input),
+      async () => {
+        await checkMemoryPolicy("memory.maintain", input);
+        await hooks.beforePrune?.(input);
+      },
+      (r) => hooks.afterPrune?.(input, r),
+      ev ? (r) => ev("brain:prune", {
+        ...ctx(),
+        scope: input?.scope,
+        scopeId: input?.scopeId,
+        pruned: r.pruned
+      }) : void 0
+    )
+  };
+}
+export {
+  withHooksAndEvents
+};
+//# sourceMappingURL=brain-plugin-wrapper.js.map

package/dist/runtime/bridge/brain-plugin-wrapper.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/bridge/brain-plugin-wrapper.ts"],
+  "sourcesContent": ["import type { ReplayInput as BrainReplayInput } from 'octoflow-protocols';\n\nimport type { BridgePolicy, PolicySubject } from '../../policy/index.js';\nimport {\n  assertPolicyAllowed,\n  resolvePolicySubject,\n} from '../../policy/index.js';\nimport type {\n  BrainPluginHooks,\n  CognitiveMemoryLike,\n} from './brain-contract.js';\nimport type { BridgeEventMap } from './events.js';\nimport { emitPolicyDecision } from './policy-events.js';\n\ninterface BrainEventEmitter {\n  emit: <K extends keyof BridgeEventMap>(\n    event: K,\n    data: BridgeEventMap[K]\n  ) => Promise<void>;\n}\n\ntype TaskContextGetter = () => { taskId?: string; contextId?: string };\n\ninterface MemoryPolicyInput {\n  scope?: string;\n  scopeId?: string;\n  relatedMemoryIds?: readonly string[];\n  memoryIdA?: string;\n  memoryIdB?: string;\n}\n\nfunction replayScope(input: number | BrainReplayInput | undefined): {\n  scope?: BrainReplayInput['scope'];\n  scopeId?: string;\n} {\n  if (typeof input === 'number' || input == null) {\n    return {};\n  }\n  return { scope: input.scope, scopeId: input.scopeId };\n}\n\n// Generic operation wrapper \u2014 enforces consistent hook\u2192call\u2192hook\u2192emit pattern\n\nasync function wrapOp<R>(\n  op: () => Promise<R>,\n  before?: () => void | Promise<void>,\n  after?: (result: R) => void | Promise<void>,\n  emit?: (result: R) => Promise<void>\n): Promise<R> {\n  await before?.();\n  const result = await op();\n  await after?.(result);\n  await emit?.(result);\n  return result;\n}\n\nfunction withHooksAndEvents(\n  brain: CognitiveMemoryLike,\n  hooks: BrainPluginHooks,\n  emitter?: BrainEventEmitter,\n  getTaskContext?: TaskContextGetter,\n  policy?: BridgePolicy,\n  policySubject?: PolicySubject,\n  tenant?: string\n): CognitiveMemoryLike {\n  const ctx = () => getTaskContext?.() ?? {};\n  const memoryResource = (input?: MemoryPolicyInput) => ({\n    kind: 'memory' as const,\n    id: input?.relatedMemoryIds?.[0] ?? input?.memoryIdA ?? input?.scopeId,\n    tenant: input?.scope === 'tenant' ? input.scopeId : tenant,\n    attributes: {\n      scope: input?.scope,\n      relatedMemoryIds: input?.relatedMemoryIds,\n      memoryIdA: input?.memoryIdA,\n      memoryIdB: input?.memoryIdB,\n    },\n  });\n  const checkMemoryPolicy = (\n    action: 'memory.read' | 'memory.write' | 'memory.maintain',\n    input?: MemoryPolicyInput\n  ) =>\n    assertPolicyAllowed(\n      policy,\n      {\n        action,\n        subject: resolvePolicySubject(policySubject),\n        resource: memoryResource(input),\n        context: ctx(),\n      },\n      emitPolicyDecision(emitter?.emit.bind(emitter))\n    );\n\n  const ev = emitter\n    ? <K extends keyof BridgeEventMap>(event: K, data: BridgeEventMap[K]) =>\n        emitter.emit(event, data)\n    : undefined;\n\n  return {\n    get contractVersion() {\n      return brain.contractVersion;\n    },\n\n    close: () => brain.close?.() ?? Promise.resolve(),\n\n    remember: (input) =>\n      wrapOp(\n        () => brain.remember(input),\n        async () => {\n          await checkMemoryPolicy('memory.write', input);\n          await hooks.beforeRemember?.(input);\n        },\n        (r) => hooks.afterRemember?.(input, r),\n        ev\n          ? (r) =>\n              ev('brain:remember', {\n                ...ctx(),\n                text: input.text,\n                kind: input.kind ?? 'observation',\n                scope: input.scope ?? 'global',\n                scopeId: input.scopeId,\n                recordId: r.accepted ? r.recordId : undefined,\n                accepted: r.accepted,\n              })\n          : undefined\n      ),\n\n    recall: (input) =>\n      wrapOp(\n        () => brain.recall(input),\n        async () => {\n          await checkMemoryPolicy('memory.read', input);\n          await hooks.beforeRecall?.(input);\n        },\n        (r) => hooks.afterRecall?.(input, r),\n        ev\n          ? (r) =>\n              ev('brain:recall', {\n                ...ctx(),\n                query: input.query,\n                scope: input.scope,\n                scopeId: input.scopeId,\n                topK: input.topK,\n                resultCount: r.items.length,\n              })\n          : undefined\n      ),\n\n    digest: (input) =>\n      wrapOp(\n        () => brain.digest(input),\n        async () => {\n          await checkMemoryPolicy('memory.maintain', input);\n          await hooks.beforeDigest?.(input);\n        },\n        (r) => hooks.afterDigest?.(input, r),\n        ev\n          ? (r) =>\n              ev('brain:digest', {\n                ...ctx(),\n                scope: input?.scope,\n                scopeId: input?.scopeId,\n                itemsCreated: r.itemsCreated,\n                hunchesUpdated: r.hunchesUpdated,\n              })\n          : undefined\n      ),\n\n    consolidate: (input) =>\n      wrapOp(\n        () => brain.consolidate(input),\n        async () => {\n          await checkMemoryPolicy('memory.maintain', input);\n          await hooks.beforeConsolidate?.(input);\n        },\n        (r) => hooks.afterConsolidate?.(input, r),\n        ev\n          ? (r) =>\n              ev('brain:consolidate', {\n                ...ctx(),\n                scope: input?.scope,\n                scopeId: input?.scopeId,\n                promoted: r.promoted,\n                reinforced: r.reinforced,\n                demoted: r.demoted,\n                quarantined: r.quarantined,\n              })\n          : undefined\n      ),\n\n    feedback: (input) =>\n      wrapOp(\n        () => brain.feedback(input),\n        async () => {\n          await checkMemoryPolicy('memory.write', input);\n          await hooks.beforeFeedback?.(input);\n        },\n        (r) => hooks.afterFeedback?.(input, r),\n        ev\n          ? (r) =>\n              ev('brain:feedback', {\n                ...ctx(),\n                outcome: input.outcome,\n                linked: r.linked,\n                updated: r.updated,\n              })\n          : undefined\n      ),\n\n    resolveContradiction: (input) =>\n      wrapOp(\n        () => brain.resolveContradiction(input),\n        async () => {\n          await checkMemoryPolicy('memory.write', input);\n          await hooks.beforeContradiction?.(input);\n        },\n        (r) => hooks.afterContradiction?.(input, r),\n        ev\n          ? (r) =>\n              ev('brain:contradiction', {\n                ...ctx(),\n                memoryIdA: input.memoryIdA,\n                memoryIdB: input.memoryIdB,\n                resolution: input.resolution,\n                resolved: r.resolved,\n                quarantined: r.quarantined,\n                confidenceDelta: r.confidenceDelta,\n              })\n          : undefined\n      ),\n\n    audit: (input) =>\n      wrapOp(\n        () => brain.audit(input),\n        async () => {\n          await checkMemoryPolicy('memory.read', input);\n          await hooks.beforeAudit?.(input);\n        },\n        (r) => hooks.afterAudit?.(input, r),\n        ev\n          ? (r) =>\n              ev('brain:audit', {\n                ...ctx(),\n                scope: input?.scope,\n                scopeId: input?.scopeId,\n                contradictionRate: r.contradictionRate,\n                quarantineCount: r.quarantineCount,\n                poisoningAlerts: r.poisoningAlerts,\n                failRecurrenceRate: r.failRecurrenceRate,\n                staleRate: r.staleRate,\n                totalRecords: r.totalRecords,\n              })\n          : undefined\n      ),\n\n    replay: (input) =>\n      wrapOp(\n        () => brain.replay(input),\n        async () => {\n          await checkMemoryPolicy('memory.maintain', replayScope(input));\n          await hooks.beforeReplay?.(input);\n        },\n        (r) => hooks.afterReplay?.(input, r),\n        ev\n          ? (r) =>\n              ev('brain:replay', {\n                ...ctx(),\n                ...replayScope(input),\n                failsReplayed: r.failsReplayed,\n                winsReplayed: r.winsReplayed,\n                explorationReplayed: r.explorationReplayed,\n              })\n          : undefined\n      ),\n\n    prune: (input) =>\n      wrapOp(\n        () => brain.prune(input),\n        async () => {\n          await checkMemoryPolicy('memory.maintain', input);\n          await hooks.beforePrune?.(input);\n        },\n        (r) => hooks.afterPrune?.(input, r),\n        ev\n          ? (r) =>\n              ev('brain:prune', {\n                ...ctx(),\n                scope: input?.scope,\n                scopeId: input?.scopeId,\n                pruned: r.pruned,\n              })\n          : undefined\n      ),\n  };\n}\n\nexport { withHooksAndEvents };\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,62 @@
+import type { ActionDefinition } from '../../actions/types.js';
+import { OctoFlowError } from '../../domain/errors/base.js';
+import type { BridgePolicy, PolicySubject } from '../../policy/index.js';
+import type { BrainPluginHooks, CognitiveMemoryLike, MemoryCoreLike } from './brain-contract.js';
+import type { BridgePlugin } from './plugins.js';
+export type { BrainPluginHooks, BridgeWithBrain, CognitiveMemoryLike, MemoryCoreLike, } from './brain-contract.js';
+export type { AuditInput, AuditResult, ConsolidateInput, ConsolidateResult, ContradictionResolution, DigestInput, DigestResult, FeedbackInput, FeedbackResult, MemoryKind, MemorySource, MemoryStatus, MemoryTier, PruneInput, PruneResult, RecallInput, RecallItem, RecallResult, RememberInput, RememberResult, ReplayCycleResult, ReplayInput, ResolveContradictionInput, ResolveContradictionResult, } from 'octoflow-protocols';
+export interface BrainPluginOptions {
+    enabled?: boolean;
+    /**
+     * The `CognitiveMemoryLike` implementation to install on the bridge.
+     *
+     * **Required** unless `enabled: false`. Omitting `brain` while `enabled`
+     * is not `false` throws `BrainMissingError` at bridge-creation time so the
+     * misconfiguration surfaces immediately rather than at the first tool call.
+     */
+    brain?: CognitiveMemoryLike;
+    emitEvents?: boolean;
+    hooks?: BrainPluginHooks;
+    /** Optional getter for task correlation. Returns taskId/contextId when available. */
+    getTaskContext?: () => {
+        taskId?: string;
+        contextId?: string;
+    };
+    /** Optional memory RBAC policy. Falls back to bridge.policy when available. */
+    policy?: BridgePolicy;
+    policySubject?: PolicySubject;
+    tenant?: string;
+    /**
+     * Pre-built memory tool actions to register on the bridge.
+     * Pass `createCognitiveMemoryTool()` from `octoflow-tools` so the tool is only
+     * available when `brainPlugin` is wired — reads from `bridge.brain`, so events
+     * and policy enforcement are automatic.
+     * @example
+     * ```ts
+     * brainPlugin({ brain, memoryTool: createCognitiveMemoryTool() })
+     * ```
+     */
+    memoryTool?: ActionDefinition[];
+}
+/** Thrown at bridge-creation time when `brainPlugin` has no `brain` and `enabled !== false`. */
+export declare class BrainMissingError extends OctoFlowError {
+    constructor();
+}
+/** Thrown by `brainPlugin` when the brain's `contractVersion` does not match
+ *  `COGNITIVE_MEMORY_CONTRACT_VERSION`. */
+export declare class BrainContractMismatchError extends OctoFlowError {
+    readonly expected: number;
+    readonly found: number;
+    constructor(expected: number, found: number);
+}
+export declare class MemoryCoreUnsupportedOperationError extends OctoFlowError {
+    constructor(operation: string);
+}
+export interface MemoryCorePluginOptions extends Omit<BrainPluginOptions, 'brain'> {
+    /** Minimal memory implementation with only remember() and recall(). */
+    memory: MemoryCoreLike;
+}
+export declare function cognitiveMemoryFromCore(memory: MemoryCoreLike): CognitiveMemoryLike;
+export declare function memoryCorePlugin(options: MemoryCorePluginOptions): BridgePlugin;
+export declare function brainPlugin(options?: BrainPluginOptions): BridgePlugin;
+//# sourceMappingURL=brain-plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"brain-plugin.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/brain-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACf,MAAM,qBAAqB,CAAC;AAI7B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,cAAc,GACf,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,EACvB,WAAW,EACX,YAAY,EACZ,aAAa,EACb,cAAc,EACd,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,UAAU,EACV,YAAY,EACZ,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,qFAAqF;IACrF,cAAc,CAAC,EAAE,MAAM;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/D,+EAA+E;IAC/E,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACjC;AACD,gGAAgG;AAChG,qBAAa,iBAAkB,SAAQ,aAAa;;CASnD;AAED;2CAC2C;AAC3C,qBAAa,0BAA2B,SAAQ,aAAa;IAC3D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBACX,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAW5C;AAGD,qBAAa,mCAAoC,SAAQ,aAAa;gBACxD,SAAS,EAAE,MAAM;CAQ9B;AAED,MAAM,WAAW,uBACf,SAAQ,IAAI,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACzC,uEAAuE;IACvE,MAAM,EAAE,cAAc,CAAC;CACxB;AAMD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,cAAc,GACrB,mBAAmB,CAiBrB;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,uBAAuB,GAC/B,YAAY,CAMd;AAED,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,YAAY,CA+E1E"}

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

@@ -0,0 +1,128 @@
+import { OctoFlowError } from "../../domain/errors/base.js";
+import { COGNITIVE_MEMORY_CONTRACT_VERSION } from "./brain-contract.js";
+import { withHooksAndEvents } from "./brain-plugin-wrapper.js";
+class BrainMissingError extends OctoFlowError {
+  constructor() {
+    super(
+      "BRAIN_MISSING",
+      "brainPlugin: no brain provided. Pass { brain: <CognitiveMemoryLike> } or set { enabled: false } to opt out.",
+      {}
+    );
+    this.name = "BrainMissingError";
+  }
+}
+class BrainContractMismatchError extends OctoFlowError {
+  expected;
+  found;
+  constructor(expected, found) {
+    super(
+      "BRAIN_CONTRACT_MISMATCH",
+      `cognitive-memory contract mismatch \u2014 core expects v${expected}, brain reports v${found}. Upgrade the mismatched package.`,
+      { expected, found }
+    );
+    this.name = "BrainContractMismatchError";
+    this.expected = expected;
+    this.found = found;
+  }
+}
+class MemoryCoreUnsupportedOperationError extends OctoFlowError {
+  constructor(operation) {
+    super(
+      "MEMORY_CORE_UNSUPPORTED_OPERATION",
+      `memoryCorePlugin only supports remember() and recall(); ${operation} requires a full CognitiveMemoryLike implementation.`,
+      { operation }
+    );
+    this.name = "MemoryCoreUnsupportedOperationError";
+  }
+}
+function unsupported(operation) {
+  return Promise.reject(new MemoryCoreUnsupportedOperationError(operation));
+}
+function cognitiveMemoryFromCore(memory) {
+  const closable = memory;
+  return {
+    contractVersion: COGNITIVE_MEMORY_CONTRACT_VERSION,
+    remember: (input) => memory.remember(input),
+    recall: (input) => memory.recall(input),
+    ...closable.close ? { close: () => closable.close?.() } : {},
+    digest: () => unsupported("digest"),
+    consolidate: () => unsupported("consolidate"),
+    feedback: () => unsupported("feedback"),
+    resolveContradiction: () => unsupported("resolveContradiction"),
+    audit: () => unsupported("audit"),
+    replay: () => unsupported("replay"),
+    prune: () => unsupported("prune")
+  };
+}
+function memoryCorePlugin(options) {
+  const { memory, ...brainOptions } = options;
+  return brainPlugin({
+    ...brainOptions,
+    brain: cognitiveMemoryFromCore(memory)
+  });
+}
+function brainPlugin(options = {}) {
+  let exposedBrain;
+  return {
+    name: "brain",
+    version: "0.1.0",
+    priority: 80,
+    setup(ctx) {
+      if (options.enabled === false) return;
+      if (!options.brain) throw new BrainMissingError();
+      const emitEvents = options.emitEvents !== false;
+      const brainVersion = options.brain.contractVersion;
+      if (brainVersion != null && brainVersion !== COGNITIVE_MEMORY_CONTRACT_VERSION) {
+        return Promise.reject(
+          new BrainContractMismatchError(
+            COGNITIVE_MEMORY_CONTRACT_VERSION,
+            brainVersion
+          )
+        );
+      }
+      const bridgePolicy = ctx.bridge.policy;
+      const bridgePolicySubject = ctx.bridge.policySubject;
+      const effectivePolicy = options.policy ?? bridgePolicy;
+      const wrapped = options.hooks || emitEvents || effectivePolicy ? withHooksAndEvents(
+        options.brain,
+        options.hooks ?? {},
+        emitEvents ? { emit: ctx.bridge.events.emit.bind(ctx.bridge.events) } : void 0,
+        options.getTaskContext,
+        effectivePolicy,
+        options.policySubject ?? bridgePolicySubject,
+        options.tenant
+      ) : options.brain;
+      exposedBrain = wrapped;
+      Object.defineProperty(ctx.bridge, "brain", {
+        value: exposedBrain,
+        configurable: true,
+        enumerable: false,
+        writable: false
+      });
+      if (options.memoryTool) {
+        for (const action of options.memoryTool) {
+          ctx.registerAction(action);
+        }
+      }
+      return;
+    },
+    async teardown(ctx) {
+      const b = ctx.bridge;
+      const closing = exposedBrain;
+      if (b.brain === exposedBrain) {
+        delete b.brain;
+      }
+      exposedBrain = void 0;
+      await closing?.close?.();
+    }
+  };
+}
+export {
+  BrainContractMismatchError,
+  BrainMissingError,
+  MemoryCoreUnsupportedOperationError,
+  brainPlugin,
+  cognitiveMemoryFromCore,
+  memoryCorePlugin
+};
+//# sourceMappingURL=brain-plugin.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/bridge/brain-plugin.ts"],
+  "sourcesContent": ["import type { ActionDefinition } from '../../actions/types.js';\nimport { OctoFlowError } from '../../domain/errors/base.js';\nimport type { BridgePolicy, PolicySubject } from '../../policy/index.js';\nimport type {\n  BrainPluginHooks,\n  CognitiveMemoryLike,\n  MemoryCoreLike,\n} from './brain-contract.js';\nimport { COGNITIVE_MEMORY_CONTRACT_VERSION } from './brain-contract.js';\nimport { withHooksAndEvents } from './brain-plugin-wrapper.js';\nimport type { Bridge } from './bridge.js';\nimport type { BridgePlugin } from './plugins.js';\n\nexport type {\n  BrainPluginHooks,\n  BridgeWithBrain,\n  CognitiveMemoryLike,\n  MemoryCoreLike,\n} from './brain-contract.js';\nexport type {\n  AuditInput,\n  AuditResult,\n  ConsolidateInput,\n  ConsolidateResult,\n  ContradictionResolution,\n  DigestInput,\n  DigestResult,\n  FeedbackInput,\n  FeedbackResult,\n  MemoryKind,\n  MemorySource,\n  MemoryStatus,\n  MemoryTier,\n  PruneInput,\n  PruneResult,\n  RecallInput,\n  RecallItem,\n  RecallResult,\n  RememberInput,\n  RememberResult,\n  ReplayCycleResult,\n  ReplayInput,\n  ResolveContradictionInput,\n  ResolveContradictionResult,\n} from 'octoflow-protocols';\n\nexport interface BrainPluginOptions {\n  enabled?: boolean;\n  /**\n   * The `CognitiveMemoryLike` implementation to install on the bridge.\n   *\n   * **Required** unless `enabled: false`. Omitting `brain` while `enabled`\n   * is not `false` throws `BrainMissingError` at bridge-creation time so the\n   * misconfiguration surfaces immediately rather than at the first tool call.\n   */\n  brain?: CognitiveMemoryLike;\n  emitEvents?: boolean;\n  hooks?: BrainPluginHooks;\n  /** Optional getter for task correlation. Returns taskId/contextId when available. */\n  getTaskContext?: () => { taskId?: string; contextId?: string };\n  /** Optional memory RBAC policy. Falls back to bridge.policy when available. */\n  policy?: BridgePolicy;\n  policySubject?: PolicySubject;\n  tenant?: string;\n  /**\n   * Pre-built memory tool actions to register on the bridge.\n   * Pass `createCognitiveMemoryTool()` from `octoflow-tools` so the tool is only\n   * available when `brainPlugin` is wired \u2014 reads from `bridge.brain`, so events\n   * and policy enforcement are automatic.\n   * @example\n   * ```ts\n   * brainPlugin({ brain, memoryTool: createCognitiveMemoryTool() })\n   * ```\n   */\n  memoryTool?: ActionDefinition[];\n}\n/** Thrown at bridge-creation time when `brainPlugin` has no `brain` and `enabled !== false`. */\nexport class BrainMissingError extends OctoFlowError {\n  constructor() {\n    super(\n      'BRAIN_MISSING',\n      'brainPlugin: no brain provided. Pass { brain: <CognitiveMemoryLike> } or set { enabled: false } to opt out.',\n      {}\n    );\n    this.name = 'BrainMissingError';\n  }\n}\n\n/** Thrown by `brainPlugin` when the brain's `contractVersion` does not match\n *  `COGNITIVE_MEMORY_CONTRACT_VERSION`. */\nexport class BrainContractMismatchError extends OctoFlowError {\n  readonly expected: number;\n  readonly found: number;\n  constructor(expected: number, found: number) {\n    super(\n      'BRAIN_CONTRACT_MISMATCH',\n      `cognitive-memory contract mismatch \u2014 core expects v${expected}, brain reports v${found}. ` +\n        `Upgrade the mismatched package.`,\n      { expected, found }\n    );\n    this.name = 'BrainContractMismatchError';\n    this.expected = expected;\n    this.found = found;\n  }\n}\n\n\nexport class MemoryCoreUnsupportedOperationError extends OctoFlowError {\n  constructor(operation: string) {\n    super(\n      'MEMORY_CORE_UNSUPPORTED_OPERATION',\n      `memoryCorePlugin only supports remember() and recall(); ${operation} requires a full CognitiveMemoryLike implementation.`,\n      { operation }\n    );\n    this.name = 'MemoryCoreUnsupportedOperationError';\n  }\n}\n\nexport interface MemoryCorePluginOptions\n  extends Omit<BrainPluginOptions, 'brain'> {\n  /** Minimal memory implementation with only remember() and recall(). */\n  memory: MemoryCoreLike;\n}\n\nfunction unsupported<T>(operation: string): Promise<T> {\n  return Promise.reject(new MemoryCoreUnsupportedOperationError(operation));\n}\n\nexport function cognitiveMemoryFromCore(\n  memory: MemoryCoreLike\n): CognitiveMemoryLike {\n  const closable = memory as MemoryCoreLike & {\n    close?: () => void | Promise<void>;\n  };\n  return {\n    contractVersion: COGNITIVE_MEMORY_CONTRACT_VERSION,\n    remember: (input) => memory.remember(input),\n    recall: (input) => memory.recall(input),\n    ...(closable.close ? { close: () => closable.close?.() } : {}),\n    digest: () => unsupported('digest'),\n    consolidate: () => unsupported('consolidate'),\n    feedback: () => unsupported('feedback'),\n    resolveContradiction: () => unsupported('resolveContradiction'),\n    audit: () => unsupported('audit'),\n    replay: () => unsupported('replay'),\n    prune: () => unsupported('prune'),\n  };\n}\n\nexport function memoryCorePlugin(\n  options: MemoryCorePluginOptions\n): BridgePlugin {\n  const { memory, ...brainOptions } = options;\n  return brainPlugin({\n    ...brainOptions,\n    brain: cognitiveMemoryFromCore(memory),\n  });\n}\n\nexport function brainPlugin(options: BrainPluginOptions = {}): BridgePlugin {\n  let exposedBrain: CognitiveMemoryLike | undefined;\n\n  return {\n    name: 'brain',\n    version: '0.1.0',\n    priority: 80,\n    setup(ctx) {\n      if (options.enabled === false) return;\n\n      if (!options.brain) throw new BrainMissingError();\n\n      const emitEvents = options.emitEvents !== false;\n\n      const brainVersion = options.brain.contractVersion;\n      if (\n        brainVersion != null &&\n        brainVersion !== COGNITIVE_MEMORY_CONTRACT_VERSION\n      ) {\n        return Promise.reject(\n          new BrainContractMismatchError(\n            COGNITIVE_MEMORY_CONTRACT_VERSION,\n            brainVersion\n          )\n        );\n      }\n      const bridgePolicy = (\n        ctx.bridge as Bridge & {\n          policy?: BridgePolicy;\n          policySubject?: PolicySubject;\n        }\n      ).policy;\n      const bridgePolicySubject = (\n        ctx.bridge as Bridge & {\n          policy?: BridgePolicy;\n          policySubject?: PolicySubject;\n        }\n      ).policySubject;\n      const effectivePolicy = options.policy ?? bridgePolicy;\n      const wrapped =\n        options.hooks || emitEvents || effectivePolicy\n          ? withHooksAndEvents(\n              options.brain,\n              options.hooks ?? {},\n              emitEvents\n                ? { emit: ctx.bridge.events.emit.bind(ctx.bridge.events) }\n                : undefined,\n              options.getTaskContext,\n              effectivePolicy,\n              options.policySubject ?? bridgePolicySubject,\n              options.tenant\n            )\n          : options.brain;\n\n      exposedBrain = wrapped;\n      Object.defineProperty(ctx.bridge, 'brain', {\n        value: exposedBrain,\n        configurable: true,\n        enumerable: false,\n        writable: false,\n      });\n\n      if (options.memoryTool) {\n        for (const action of options.memoryTool) {\n          ctx.registerAction(action);\n        }\n      }\n      return;\n    },\n    async teardown(ctx) {\n      const b = ctx.bridge as Bridge & { brain?: CognitiveMemoryLike };\n      const closing = exposedBrain;\n      if (b.brain === exposedBrain) {\n        delete b.brain;\n      }\n      exposedBrain = undefined;\n      await closing?.close?.();\n    },\n  };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,67 @@
+import type { BrainLayerLike } from 'octoflow-protocols';
+import { OctoFlowError } from '../../domain/errors/base.js';
+import type { MemoryScope } from '../../domain/memory-scope.js';
+import type { ResolvedBrainConfig } from './brain-config.js';
+import type { CognitiveMemoryLike } from './brain-contract.js';
+import type { BridgePlugin } from './plugins.js';
+/**
+ * Minimum brain-package surface we consume. Typed structurally so the
+ * bridge core stays free of a runtime import of `octoflow-brain`;
+ * DTO references are type-only and erased from emitted JavaScript.
+ */
+interface BrainPackageShape {
+    createMemoryBrain: (opts: Record<string, unknown>) => CognitiveMemoryLike;
+    brainPreset: (name: NonNullable<ResolvedBrainConfig['preset']>, opts?: Record<string, unknown>) => Record<string, unknown> & {
+        layers?: BrainLayerLike[];
+    };
+    InMemoryBrainStore: new () => unknown;
+    SQLiteBrainStore: new (opts: {
+        path: string;
+        enableFTS?: boolean;
+        enableVec?: boolean;
+        vecDimensions?: number;
+    }) => {
+        close?: () => void | Promise<void>;
+    };
+    contextualChunkingLayer: (opts: {
+        context: string;
+    }) => BrainLayerLike;
+    lexicalLayer: () => BrainLayerLike;
+    mmrLayer: (opts?: unknown) => BrainLayerLike;
+    productionSafetyLayer: (opts?: unknown) => BrainLayerLike;
+    vectorLayer: (opts: {
+        embedder: unknown;
+    }) => BrainLayerLike;
+    BrainScheduler: new (brain: unknown) => {
+        runCycle: (opts: Record<string, unknown>) => Promise<unknown>;
+    };
+}
+export declare class BrainPackageMissingError extends OctoFlowError {
+    constructor(cause?: unknown);
+}
+export declare class BrainScopeIdRequiredError extends OctoFlowError {
+    constructor(scope: MemoryScope, scopeIdSource: string);
+}
+export interface ResolvedBrain {
+    brain: CognitiveMemoryLike;
+    /** Package-shape for plugins that need scheduler access. */
+    pkg: BrainPackageShape;
+}
+export declare function resolveBrain(resolved: ResolvedBrainConfig, workspace: string): Promise<ResolvedBrain>;
+/**
+ * Internal plugin: drives `BrainScheduler` on an interval, optional
+ * `task:completed` hook, optional post-cycle pruning. Timers are torn down
+ * via the plugin lifecycle.
+ */
+export declare function brainMaintenancePlugin(opts: {
+    pkg: BrainPackageShape;
+    resolved: ResolvedBrainConfig;
+}): BridgePlugin;
+/**
+ * Internal plugin: emits a single `brain:advisory` event on the first task
+ * activity if no brain consumer (remember/recall/digest/etc.) has been
+ * observed. Observable-only — never escalates to a warning or log.
+ */
+export declare function brainAdvisoryPlugin(): BridgePlugin;
+export {};
+//# sourceMappingURL=brain-resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"brain-resolver.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/brain-resolver.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,cAAc,EAOf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD;;;;GAIG;AACH,UAAU,iBAAiB;IACzB,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,mBAAmB,CAAC;IAC1E,WAAW,EAAE,CACX,IAAI,EAAE,WAAW,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,EAChD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;QAAE,MAAM,CAAC,EAAE,cAAc,EAAE,CAAA;KAAE,CAAC;IAC7D,kBAAkB,EAAE,UAAU,OAAO,CAAC;IACtC,gBAAgB,EAAE,KAAK,IAAI,EAAE;QAC3B,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,KAAK;QACJ,KAAK,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACpC,CAAC;IACF,uBAAuB,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,cAAc,CAAC;IACvE,YAAY,EAAE,MAAM,cAAc,CAAC;IACnC,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,KAAK,cAAc,CAAC;IAC7C,qBAAqB,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,KAAK,cAAc,CAAC;IAC1D,WAAW,EAAE,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,KAAK,cAAc,CAAC;IAC7D,cAAc,EAAE,KAAK,KAAK,EAAE,OAAO,KAAK;QACtC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;KAC/D,CAAC;CACH;AAED,qBAAa,wBAAyB,SAAQ,aAAa;gBAC7C,KAAK,CAAC,EAAE,OAAO;CAS5B;AAED,qBAAa,yBAA0B,SAAQ,aAAa;gBAC9C,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM;CAUtD;AAyND,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,mBAAmB,CAAC;IAC3B,4DAA4D;IAC5D,GAAG,EAAE,iBAAiB,CAAC;CACxB;AAED,wBAAsB,YAAY,CAChC,QAAQ,EAAE,mBAAmB,EAC7B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,CAAC,CAQxB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,GAAG,EAAE,iBAAiB,CAAC;IACvB,QAAQ,EAAE,mBAAmB,CAAC;CAC/B,GAAG,YAAY,CA0Ef;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,YAAY,CAsDlD"}