@machina.ai/cell-cli-core 1.38.1-rc2 → 1.40.1-rc2

package/dist/src/context/graph/types.d.ts

@@ -0,0 +1,139 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Part } from '@google/genai';
+export type NodeType = 'USER_PROMPT' | 'SYSTEM_EVENT' | 'AGENT_THOUGHT' | 'TOOL_EXECUTION' | 'AGENT_YIELD' | 'SNAPSHOT' | 'ROLLING_SUMMARY' | 'MASKED_TOOL' | 'TASK' | 'EPISODE';
+/** Base interface for all nodes in the Episodic Context Graph */
+export interface Node {
+    readonly id: string;
+    readonly type: NodeType;
+}
+/**
+ * Concrete Nodes: The atomic, renderable pieces of data.
+ * These are the actual "planks" of the Nodes of Theseus.
+ */
+export interface BaseConcreteNode extends Node {
+    readonly timestamp: number;
+    /** The ID of the Logical Node (e.g., Episode) that structurally owns this node */
+    readonly logicalParentId?: string;
+    /** If this node replaced a single node 1:1 (e.g., masking), this points to the original */
+    readonly replacesId?: string;
+    /** If this node is a synthetic summary of N nodes, this points to the original IDs */
+    readonly abstractsIds?: readonly string[];
+}
+/**
+ * Semantic Parts for User Prompts
+ */
+export interface SemanticTextPart {
+    readonly type: 'text';
+    readonly text: string;
+}
+export interface SemanticInlineDataPart {
+    readonly type: 'inline_data';
+    readonly mimeType: string;
+    readonly data: string;
+}
+export interface SemanticFileDataPart {
+    readonly type: 'file_data';
+    readonly mimeType: string;
+    readonly fileUri: string;
+}
+export interface SemanticRawPart {
+    readonly type: 'raw_part';
+    readonly part: Part;
+}
+export type SemanticPart = SemanticTextPart | SemanticInlineDataPart | SemanticFileDataPart | SemanticRawPart;
+/**
+ * Trigger Nodes
+ * Events that wake the agent up and initiate an Episode.
+ */
+export interface UserPrompt extends BaseConcreteNode {
+    readonly type: 'USER_PROMPT';
+    readonly semanticParts: readonly SemanticPart[];
+}
+export interface SystemEvent extends BaseConcreteNode {
+    readonly type: 'SYSTEM_EVENT';
+    readonly name: string;
+    readonly payload: Record<string, unknown>;
+}
+export type EpisodeTrigger = UserPrompt | SystemEvent;
+/**
+ * Step Nodes
+ * The internal autonomous actions taken by the agent during its loop.
+ */
+export interface AgentThought extends BaseConcreteNode {
+    readonly type: 'AGENT_THOUGHT';
+    readonly text: string;
+}
+export interface ToolExecution extends BaseConcreteNode {
+    readonly type: 'TOOL_EXECUTION';
+    readonly toolName: string;
+    readonly intent: Record<string, unknown>;
+    readonly observation: string | Record<string, unknown>;
+    readonly tokens: {
+        readonly intent: number;
+        readonly observation: number;
+    };
+}
+export interface MaskedTool extends BaseConcreteNode {
+    readonly type: 'MASKED_TOOL';
+    readonly toolName: string;
+    readonly intent?: Record<string, unknown>;
+    readonly observation?: string | Record<string, unknown>;
+    readonly tokens: {
+        readonly intent: number;
+        readonly observation: number;
+    };
+}
+export type EpisodeStep = AgentThought | ToolExecution | MaskedTool;
+/**
+ * Resolution Node
+ * The final message where the agent yields control back to the user.
+ */
+export interface AgentYield extends BaseConcreteNode {
+    readonly type: 'AGENT_YIELD';
+    readonly text: string;
+}
+/**
+ * Synthetic Leaf Interfaces
+ * Processors that generate summaries emit explicit synthetic nodes.
+ */
+export interface Snapshot extends BaseConcreteNode {
+    readonly type: 'SNAPSHOT';
+    readonly text: string;
+}
+export interface RollingSummary extends BaseConcreteNode {
+    readonly type: 'ROLLING_SUMMARY';
+    readonly text: string;
+}
+export type SyntheticLeaf = Snapshot | RollingSummary;
+export type ConcreteNode = UserPrompt | SystemEvent | AgentThought | ToolExecution | MaskedTool | AgentYield | Snapshot | RollingSummary;
+/**
+ * Logical Nodes
+ * These define hierarchy and grouping. They do not directly render to Gemini.
+ */
+export interface Episode extends Node {
+    readonly type: 'EPISODE';
+    /** References to the Concrete Node IDs that conceptually belong to this Episode. */
+    concreteNodes: readonly ConcreteNode[];
+}
+export interface Task extends Node {
+    readonly type: 'TASK';
+    readonly goal: string;
+    readonly status: 'active' | 'completed' | 'failed';
+    /** References to the Episode IDs that belong to this task */
+    readonly episodeIds: readonly string[];
+}
+export type LogicalNode = Task | Episode;
+export declare function isEpisode(node: Node): node is Episode;
+export declare function isTask(node: Node): node is Task;
+export declare function isAgentThought(node: Node): node is AgentThought;
+export declare function isAgentYield(node: Node): node is AgentYield;
+export declare function isToolExecution(node: Node): node is ToolExecution;
+export declare function isMaskedTool(node: Node): node is MaskedTool;
+export declare function isUserPrompt(node: Node): node is UserPrompt;
+export declare function isSystemEvent(node: Node): node is SystemEvent;
+export declare function isSnapshot(node: Node): node is Snapshot;
+export declare function isRollingSummary(node: Node): node is RollingSummary;

package/dist/src/context/graph/types.js

@@ -0,0 +1,36 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export function isEpisode(node) {
+    return node.type === 'EPISODE';
+}
+export function isTask(node) {
+    return node.type === 'TASK';
+}
+export function isAgentThought(node) {
+    return node.type === 'AGENT_THOUGHT';
+}
+export function isAgentYield(node) {
+    return node.type === 'AGENT_YIELD';
+}
+export function isToolExecution(node) {
+    return node.type === 'TOOL_EXECUTION';
+}
+export function isMaskedTool(node) {
+    return node.type === 'MASKED_TOOL';
+}
+export function isUserPrompt(node) {
+    return node.type === 'USER_PROMPT';
+}
+export function isSystemEvent(node) {
+    return node.type === 'SYSTEM_EVENT';
+}
+export function isSnapshot(node) {
+    return node.type === 'SNAPSHOT';
+}
+export function isRollingSummary(node) {
+    return node.type === 'ROLLING_SUMMARY';
+}
+//# sourceMappingURL=types.js.map

package/dist/src/context/graph/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/context/graph/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmLH,MAAM,UAAU,SAAS,CAAC,IAAU;IAClC,OAAO,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,IAAU;IAC/B,OAAO,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAU;IACvC,OAAO,IAAI,CAAC,IAAI,KAAK,eAAe,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAU;IACrC,OAAO,IAAI,CAAC,IAAI,KAAK,aAAa,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAU;IACxC,OAAO,IAAI,CAAC,IAAI,KAAK,gBAAgB,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAU;IACrC,OAAO,IAAI,CAAC,IAAI,KAAK,aAAa,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAU;IACrC,OAAO,IAAI,CAAC,IAAI,KAAK,aAAa,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAU;IACtC,OAAO,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAU;IACnC,OAAO,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAU;IACzC,OAAO,IAAI,CAAC,IAAI,KAAK,iBAAiB,CAAC;AACzC,CAAC"}

package/dist/src/context/historyObserver.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { AgentChatHistory } from '../core/agentChatHistory.js';
+import type { ContextGraphMapper } from './graph/mapper.js';
+import type { ContextTokenCalculator } from './utils/contextTokenCalculator.js';
+import type { ContextEventBus } from './eventBus.js';
+import type { ContextTracer } from './tracer.js';
+/**
+ * Connects the raw AgentChatHistory to the ContextManager.
+ * It maps raw messages into Episodic Intermediate Representation (Context Graph)
+ * and evaluates background triggers whenever history changes.
+ */
+export declare class HistoryObserver {
+    private readonly chatHistory;
+    private readonly eventBus;
+    private readonly tracer;
+    private readonly tokenCalculator;
+    private readonly graphMapper;
+    private unsubscribeHistory?;
+    private readonly seenNodeIds;
+    constructor(chatHistory: AgentChatHistory, eventBus: ContextEventBus, tracer: ContextTracer, tokenCalculator: ContextTokenCalculator, graphMapper: ContextGraphMapper);
+    start(): void;
+    stop(): void;
+}

package/dist/src/context/historyObserver.js

@@ -0,0 +1,64 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Connects the raw AgentChatHistory to the ContextManager.
+ * It maps raw messages into Episodic Intermediate Representation (Context Graph)
+ * and evaluates background triggers whenever history changes.
+ */
+export class HistoryObserver {
+    chatHistory;
+    eventBus;
+    tracer;
+    tokenCalculator;
+    graphMapper;
+    unsubscribeHistory;
+    seenNodeIds = new Set();
+    constructor(chatHistory, eventBus, tracer, tokenCalculator, graphMapper) {
+        this.chatHistory = chatHistory;
+        this.eventBus = eventBus;
+        this.tracer = tracer;
+        this.tokenCalculator = tokenCalculator;
+        this.graphMapper = graphMapper;
+    }
+    start() {
+        if (this.unsubscribeHistory) {
+            this.unsubscribeHistory();
+        }
+        this.unsubscribeHistory = this.chatHistory.subscribe((_event) => {
+            // Rebuild the pristine Context Graph graph from the full source history on every change.
+            // Wait, toGraph still returns an Episode[].
+            // We actually need to map the Episode[] to a flat ConcreteNode[] here to form the 'nodes'.
+            const pristineEpisodes = this.graphMapper.toGraph(this.chatHistory.get(), this.tokenCalculator);
+            const nodes = [];
+            for (const ep of pristineEpisodes) {
+                if (ep.concreteNodes) {
+                    for (const child of ep.concreteNodes) {
+                        nodes.push(child);
+                    }
+                }
+            }
+            const newNodes = new Set();
+            for (const node of nodes) {
+                if (!this.seenNodeIds.has(node.id)) {
+                    newNodes.add(node.id);
+                    this.seenNodeIds.add(node.id);
+                }
+            }
+            this.tracer.logEvent('HistoryObserver', 'Rebuilt pristine graph from chat history update', { nodesSize: nodes.length, newNodesCount: newNodes.size });
+            this.eventBus.emitPristineHistoryUpdated({
+                nodes,
+                newNodes,
+            });
+        });
+    }
+    stop() {
+        if (this.unsubscribeHistory) {
+            this.unsubscribeHistory();
+            this.unsubscribeHistory = undefined;
+        }
+    }
+}
+//# sourceMappingURL=historyObserver.js.map

package/dist/src/context/historyObserver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"historyObserver.js","sourceRoot":"","sources":["../../../src/context/historyObserver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH;;;;GAIG;AACH,MAAM,OAAO,eAAe;IAMP;IACA;IACA;IACA;IACA;IATX,kBAAkB,CAAc;IAEvB,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IAEjD,YACmB,WAA6B,EAC7B,QAAyB,EACzB,MAAqB,EACrB,eAAuC,EACvC,WAA+B;QAJ/B,gBAAW,GAAX,WAAW,CAAkB;QAC7B,aAAQ,GAAR,QAAQ,CAAiB;QACzB,WAAM,GAAN,MAAM,CAAe;QACrB,oBAAe,GAAf,eAAe,CAAwB;QACvC,gBAAW,GAAX,WAAW,CAAoB;IAC/C,CAAC;IAEJ,KAAK;QACH,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC5B,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC5B,CAAC;QAED,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,CAClD,CAAC,MAAoB,EAAE,EAAE;YACvB,yFAAyF;YACzF,4CAA4C;YAC5C,2FAA2F;YAC3F,MAAM,gBAAgB,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAC/C,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,EACtB,IAAI,CAAC,eAAe,CACrB,CAAC;YAEF,MAAM,KAAK,GAAmB,EAAE,CAAC;YACjC,KAAK,MAAM,EAAE,IAAI,gBAAgB,EAAE,CAAC;gBAClC,IAAI,EAAE,CAAC,aAAa,EAAE,CAAC;oBACrB,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,aAAa,EAAE,CAAC;wBACrC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBACpB,CAAC;gBACH,CAAC;YACH,CAAC;YAED,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;YACnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;oBACnC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBACtB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAChC,CAAC;YACH,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,QAAQ,CAClB,iBAAiB,EACjB,iDAAiD,EACjD,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,CAAC,IAAI,EAAE,CAC1D,CAAC;YAEF,IAAI,CAAC,QAAQ,CAAC,0BAA0B,CAAC;gBACvC,KAAK;gBACL,QAAQ;aACT,CAAC,CAAC;QACL,CAAC,CACF,CAAC;IACJ,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC5B,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC1B,IAAI,CAAC,kBAAkB,GAAG,SAAS,CAAC;QACtC,CAAC;IACH,CAAC;CACF"}

package/dist/src/context/pipeline/contextWorkingBuffer.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ContextWorkingBuffer, GraphMutation } from '../pipeline.js';
+import type { ConcreteNode } from '../graph/types.js';
+export declare class ContextWorkingBufferImpl implements ContextWorkingBuffer {
+    readonly nodes: readonly ConcreteNode[];
+    private readonly provenanceMap;
+    private readonly pristineNodesMap;
+    private readonly history;
+    private constructor();
+    /**
+     * Initializes a brand new ContextWorkingBuffer from a pristine graph.
+     * Every node's provenance points to itself.
+     */
+    static initialize(pristineNodes: readonly ConcreteNode[]): ContextWorkingBufferImpl;
+    /**
+     * Appends newly observed pristine nodes (e.g. from a user message) to the working buffer.
+     * Ensures they are tracked in the pristine map and point to themselves in provenance.
+     */
+    appendPristineNodes(newNodes: readonly ConcreteNode[]): ContextWorkingBufferImpl;
+    /**
+     * Generates an entirely new buffer instance by calculating the delta between the processor's input and output.
+     */
+    applyProcessorResult(processorId: string, inputTargets: readonly ConcreteNode[], outputNodes: readonly ConcreteNode[]): ContextWorkingBufferImpl;
+    /** Removes nodes from the working buffer that were completely dropped from the upstream pristine history */
+    prunePristineNodes(retainedIds: ReadonlySet<string>): ContextWorkingBufferImpl;
+    getPristineNodes(id: string): readonly ConcreteNode[];
+    getAuditLog(): readonly GraphMutation[];
+    getLineage(id: string): readonly ConcreteNode[];
+}

package/dist/src/context/pipeline/contextWorkingBuffer.js

@@ -0,0 +1,197 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export class ContextWorkingBufferImpl {
+    // The current active graph
+    nodes;
+    // The AOT pre-calculated provenance index (Current ID -> Pristine IDs)
+    provenanceMap;
+    // The original immutable pristine nodes mapping
+    pristineNodesMap;
+    // The historical linked list of changes
+    history;
+    constructor(nodes, pristineNodesMap, provenanceMap, history) {
+        this.nodes = nodes;
+        this.pristineNodesMap = pristineNodesMap;
+        this.provenanceMap = provenanceMap;
+        this.history = history;
+    }
+    /**
+     * Initializes a brand new ContextWorkingBuffer from a pristine graph.
+     * Every node's provenance points to itself.
+     */
+    static initialize(pristineNodes) {
+        const pristineMap = new Map();
+        const initialProvenance = new Map();
+        for (const node of pristineNodes) {
+            pristineMap.set(node.id, node);
+            initialProvenance.set(node.id, new Set([node.id]));
+        }
+        return new ContextWorkingBufferImpl(pristineNodes, pristineMap, initialProvenance, []);
+    }
+    /**
+     * Appends newly observed pristine nodes (e.g. from a user message) to the working buffer.
+     * Ensures they are tracked in the pristine map and point to themselves in provenance.
+     */
+    appendPristineNodes(newNodes) {
+        if (newNodes.length === 0)
+            return this;
+        const newPristineMap = new Map(this.pristineNodesMap);
+        const newProvenanceMap = new Map(this.provenanceMap);
+        for (const node of newNodes) {
+            newPristineMap.set(node.id, node);
+            newProvenanceMap.set(node.id, new Set([node.id]));
+        }
+        return new ContextWorkingBufferImpl([...this.nodes, ...newNodes], newPristineMap, newProvenanceMap, [...this.history]);
+    }
+    /**
+     * Generates an entirely new buffer instance by calculating the delta between the processor's input and output.
+     */
+    applyProcessorResult(processorId, inputTargets, outputNodes) {
+        const outputIds = new Set(outputNodes.map((n) => n.id));
+        const inputIds = new Set(inputTargets.map((n) => n.id));
+        // Calculate diffs
+        const removedIds = inputTargets
+            .filter((n) => !outputIds.has(n.id))
+            .map((n) => n.id);
+        const addedNodes = outputNodes.filter((n) => !inputIds.has(n.id));
+        // Create mutation record
+        const mutation = {
+            processorId,
+            timestamp: Date.now(),
+            removedIds,
+            addedNodes,
+        };
+        // Calculate new node array
+        const removedSet = new Set(removedIds);
+        const retainedNodes = this.nodes.filter((n) => !removedSet.has(n.id));
+        const newGraph = [...retainedNodes];
+        // We append the output nodes in the same general position if possible,
+        // but in a complex graph we just ensure they exist. V2 graph uses timestamps for order.
+        // For simplicity, we just push added nodes to the end of the retained array
+        newGraph.push(...addedNodes);
+        // Calculate new provenance map
+        const newProvenanceMap = new Map(this.provenanceMap);
+        let finalPristineMap = this.pristineNodesMap;
+        // Map the new synthetic nodes back to their pristine roots
+        for (const added of addedNodes) {
+            const roots = new Set();
+            // 1:1 Replacement (e.g. Masked Node)
+            if (added.replacesId) {
+                const inheritedRoots = this.provenanceMap.get(added.replacesId);
+                if (inheritedRoots) {
+                    for (const rootId of inheritedRoots)
+                        roots.add(rootId);
+                }
+            }
+            // N:1 Abstraction (e.g. Rolling Summary)
+            if (added.abstractsIds) {
+                for (const abstractId of added.abstractsIds) {
+                    const inheritedRoots = this.provenanceMap.get(abstractId);
+                    if (inheritedRoots) {
+                        for (const rootId of inheritedRoots)
+                            roots.add(rootId);
+                    }
+                }
+            }
+            // If it has no links back to the original graph, it is its own root
+            // (e.g., a system-injected instruction)
+            if (roots.size === 0) {
+                roots.add(added.id);
+                // It acts as a net-new pristine root.
+                if (!finalPristineMap.has(added.id)) {
+                    const mutableMap = new Map(finalPristineMap);
+                    mutableMap.set(added.id, added);
+                    finalPristineMap = mutableMap;
+                }
+            }
+            newProvenanceMap.set(added.id, roots);
+        }
+        // GC the Caches
+        // We only want to keep provenance and pristine entries that are reachable
+        // from the nodes in 'newGraph'.
+        const reachablePristineIds = new Set();
+        const reachableCurrentIds = new Set();
+        for (const node of newGraph) {
+            reachableCurrentIds.add(node.id);
+            const roots = newProvenanceMap.get(node.id);
+            if (roots) {
+                for (const root of roots) {
+                    reachablePristineIds.add(root);
+                }
+            }
+        }
+        // Prune Provenance Map
+        for (const [id] of newProvenanceMap) {
+            if (!reachableCurrentIds.has(id)) {
+                newProvenanceMap.delete(id);
+            }
+        }
+        // Prune Pristine Map
+        const prunedPristineMap = new Map();
+        for (const id of reachablePristineIds) {
+            const node = finalPristineMap.get(id);
+            if (node)
+                prunedPristineMap.set(id, node);
+        }
+        finalPristineMap = prunedPristineMap;
+        return new ContextWorkingBufferImpl(newGraph, finalPristineMap, newProvenanceMap, [...this.history, mutation]);
+    }
+    /** Removes nodes from the working buffer that were completely dropped from the upstream pristine history */
+    prunePristineNodes(retainedIds) {
+        const newGraph = this.nodes.filter((n) => retainedIds.has(n.id) || !this.pristineNodesMap.has(n.id));
+        const newProvenanceMap = new Map(this.provenanceMap);
+        const reachablePristineIds = new Set();
+        const reachableCurrentIds = new Set();
+        for (const node of newGraph) {
+            reachableCurrentIds.add(node.id);
+            const roots = newProvenanceMap.get(node.id);
+            if (roots) {
+                for (const root of roots) {
+                    if (retainedIds.has(root) || !this.pristineNodesMap.has(root)) {
+                        reachablePristineIds.add(root);
+                    }
+                }
+            }
+        }
+        for (const [id] of newProvenanceMap) {
+            if (!reachableCurrentIds.has(id)) {
+                newProvenanceMap.delete(id);
+            }
+        }
+        const prunedPristineMap = new Map();
+        for (const id of reachablePristineIds) {
+            const node = this.pristineNodesMap.get(id);
+            if (node)
+                prunedPristineMap.set(id, node);
+        }
+        return new ContextWorkingBufferImpl(newGraph, prunedPristineMap, newProvenanceMap, [...this.history]);
+    }
+    getPristineNodes(id) {
+        const pristineIds = this.provenanceMap.get(id);
+        if (!pristineIds)
+            return [];
+        return Array.from(pristineIds).map((pid) => this.pristineNodesMap.get(pid));
+    }
+    getAuditLog() {
+        return this.history;
+    }
+    getLineage(id) {
+        const lineage = [];
+        const currentNodesMap = new Map(this.nodes.map((n) => [n.id, n]));
+        let current = currentNodesMap.get(id);
+        while (current) {
+            lineage.push(current);
+            if (current.logicalParentId && current.logicalParentId !== current.id) {
+                current = currentNodesMap.get(current.logicalParentId);
+            }
+            else {
+                break;
+            }
+        }
+        return lineage;
+    }
+}
+//# sourceMappingURL=contextWorkingBuffer.js.map

package/dist/src/context/pipeline/contextWorkingBuffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextWorkingBuffer.js","sourceRoot":"","sources":["../../../../src/context/pipeline/contextWorkingBuffer.ts"],"names":[],"mappings":"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"}

package/dist/src/context/pipeline/contextWorkingBuffer.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/context/pipeline/contextWorkingBuffer.test.js

@@ -0,0 +1,89 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect } from 'vitest';
+import { ContextWorkingBufferImpl } from './contextWorkingBuffer.js';
+import { createDummyNode } from '../testing/contextTestUtils.js';
+describe('ContextWorkingBufferImpl', () => {
+    it('should initialize with a pristine graph correctly', () => {
+        const pristine1 = createDummyNode('ep1', 'USER_PROMPT', 10, undefined, 'p1');
+        const pristine2 = createDummyNode('ep1', 'AGENT_THOUGHT', 10, undefined, 'p2');
+        const buffer = ContextWorkingBufferImpl.initialize([pristine1, pristine2]);
+        expect(buffer.nodes).toHaveLength(2);
+        expect(buffer.getAuditLog()).toHaveLength(0);
+        // Pristine nodes should point to themselves
+        expect(buffer.getPristineNodes('p1')).toEqual([pristine1]);
+        expect(buffer.getPristineNodes('p2')).toEqual([pristine2]);
+    });
+    it('should track 1:1 replacements (e.g., masking) and append to audit log', () => {
+        const pristine1 = createDummyNode('ep1', 'USER_PROMPT', 10, undefined, 'p1');
+        let buffer = ContextWorkingBufferImpl.initialize([pristine1]);
+        const maskedNode = createDummyNode('ep1', 'USER_PROMPT', 5, undefined, 'm1');
+        // Simulate what a processor does
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        maskedNode.replacesId = 'p1';
+        buffer = buffer.applyProcessorResult('ToolMasking', [pristine1], [maskedNode]);
+        expect(buffer.nodes).toHaveLength(1);
+        expect(buffer.nodes[0].id).toBe('m1');
+        const log = buffer.getAuditLog();
+        expect(log).toHaveLength(1);
+        expect(log[0].processorId).toBe('ToolMasking');
+        expect(log[0].removedIds).toEqual(['p1']);
+        expect(log[0].addedNodes[0].id).toBe('m1');
+        // Provenance lookup: the masked node should resolve back to the pristine root
+        expect(buffer.getPristineNodes('m1')).toEqual([pristine1]);
+    });
+    it('should track N:1 abstractions (e.g., rolling summaries)', () => {
+        const p1 = createDummyNode('ep1', 'USER_PROMPT', 10, undefined, 'p1');
+        const p2 = createDummyNode('ep1', 'AGENT_THOUGHT', 10, undefined, 'p2');
+        const p3 = createDummyNode('ep1', 'USER_PROMPT', 10, undefined, 'p3');
+        let buffer = ContextWorkingBufferImpl.initialize([p1, p2, p3]);
+        const summaryNode = createDummyNode('ep1', 'ROLLING_SUMMARY', 15, undefined, 's1');
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        summaryNode.abstractsIds = ['p1', 'p2'];
+        buffer = buffer.applyProcessorResult('Summarizer', [p1, p2], [summaryNode]);
+        // p1 and p2 are removed, p3 remains, s1 is added
+        expect(buffer.nodes.map((n) => n.id)).toEqual(['p3', 's1']);
+        // Provenance lookup: The summary node should resolve to both p1 and p2!
+        const roots = buffer.getPristineNodes('s1');
+        expect(roots).toHaveLength(2);
+        expect(roots).toContain(p1);
+        expect(roots).toContain(p2);
+    });
+    it('should track multi-generation provenance correctly', () => {
+        const p1 = createDummyNode('ep1', 'USER_PROMPT', 10, undefined, 'p1');
+        let buffer = ContextWorkingBufferImpl.initialize([p1]);
+        // Gen 1: Masked
+        const gen1 = createDummyNode('ep1', 'USER_PROMPT', 8, undefined, 'gen1');
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        gen1.replacesId = 'p1';
+        buffer = buffer.applyProcessorResult('Masking', [p1], [gen1]);
+        // Gen 2: Summarized
+        const gen2 = createDummyNode('ep1', 'ROLLING_SUMMARY', 5, undefined, 'gen2');
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        gen2.abstractsIds = ['gen1'];
+        buffer = buffer.applyProcessorResult('Summarizer', [gen1], [gen2]);
+        expect(buffer.nodes).toHaveLength(1);
+        expect(buffer.nodes[0].id).toBe('gen2');
+        // Audit log should show sequence
+        const log = buffer.getAuditLog();
+        expect(log).toHaveLength(2);
+        expect(log[0].processorId).toBe('Masking');
+        expect(log[1].processorId).toBe('Summarizer');
+        // Multi-gen Provenance lookup: gen2 -> gen1 -> p1
+        expect(buffer.getPristineNodes('gen2')).toEqual([p1]);
+    });
+    it('should handle net-new injected nodes without throwing', () => {
+        const p1 = createDummyNode('ep1', 'USER_PROMPT', 10, undefined, 'p1');
+        let buffer = ContextWorkingBufferImpl.initialize([p1]);
+        const injected = createDummyNode('ep1', 'SYSTEM_EVENT', 5, undefined, 'injected1');
+        // No replacesId or abstractsIds
+        buffer = buffer.applyProcessorResult('Injector', [], [injected]);
+        expect(buffer.nodes.map((n) => n.id)).toEqual(['p1', 'injected1']);
+        // It should root to itself
+        expect(buffer.getPristineNodes('injected1')).toEqual([injected]);
+    });
+});
+//# sourceMappingURL=contextWorkingBuffer.test.js.map

package/dist/src/context/pipeline/contextWorkingBuffer.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextWorkingBuffer.test.js","sourceRoot":"","sources":["../../../../src/context/pipeline/contextWorkingBuffer.test.ts"],"names":[],"mappings":"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"}

package/dist/src/context/pipeline/environment.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { BaseLlmClient } from '../../core/baseLlmClient.js';
+import type { ContextEventBus } from '../eventBus.js';
+import type { ContextTokenCalculator } from '../utils/contextTokenCalculator.js';
+import type { ContextTracer } from '../tracer.js';
+import type { LiveInbox } from './inbox.js';
+import type { NodeBehaviorRegistry } from '../graph/behaviorRegistry.js';
+import type { ContextGraphMapper } from '../graph/mapper.js';
+export type { ContextTracer, ContextEventBus };
+export interface ContextEnvironment {
+    readonly llmClient: BaseLlmClient;
+    readonly promptId: string;
+    readonly sessionId: string;
+    readonly traceDir: string;
+    readonly projectTempDir: string;
+    readonly tracer: ContextTracer;
+    readonly charsPerToken: number;
+    readonly tokenCalculator: ContextTokenCalculator;
+    readonly eventBus: ContextEventBus;
+    readonly inbox: LiveInbox;
+    readonly behaviorRegistry: NodeBehaviorRegistry;
+    readonly graphMapper: ContextGraphMapper;
+}