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

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=environment.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../../../src/context/pipeline/environment.ts"],"names":[],"mappings":""}

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

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

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

@@ -0,0 +1,40 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ContextTokenCalculator } from '../utils/contextTokenCalculator.js';
+import { LiveInbox } from './inbox.js';
+import { NodeBehaviorRegistry } from '../graph/behaviorRegistry.js';
+import { registerBuiltInBehaviors } from '../graph/builtinBehaviors.js';
+import { ContextGraphMapper } from '../graph/mapper.js';
+export class ContextEnvironmentImpl {
+    llmClient;
+    sessionId;
+    promptId;
+    traceDir;
+    projectTempDir;
+    tracer;
+    charsPerToken;
+    eventBus;
+    tokenCalculator;
+    inbox;
+    behaviorRegistry;
+    graphMapper;
+    constructor(llmClient, sessionId, promptId, traceDir, projectTempDir, tracer, charsPerToken, eventBus) {
+        this.llmClient = llmClient;
+        this.sessionId = sessionId;
+        this.promptId = promptId;
+        this.traceDir = traceDir;
+        this.projectTempDir = projectTempDir;
+        this.tracer = tracer;
+        this.charsPerToken = charsPerToken;
+        this.eventBus = eventBus;
+        this.behaviorRegistry = new NodeBehaviorRegistry();
+        registerBuiltInBehaviors(this.behaviorRegistry);
+        this.tokenCalculator = new ContextTokenCalculator(this.charsPerToken, this.behaviorRegistry);
+        this.inbox = new LiveInbox();
+        this.graphMapper = new ContextGraphMapper(this.behaviorRegistry);
+    }
+}
+//# sourceMappingURL=environmentImpl.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"environmentImpl.js","sourceRoot":"","sources":["../../../../src/context/pipeline/environmentImpl.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,OAAO,sBAAsB;IAOtB;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IAbF,eAAe,CAAyB;IACxC,KAAK,CAAY;IACjB,gBAAgB,CAAuB;IACvC,WAAW,CAAqB;IAEzC,YACW,SAAwB,EACxB,SAAiB,EACjB,QAAgB,EAChB,QAAgB,EAChB,cAAsB,EACtB,MAAqB,EACrB,aAAqB,EACrB,QAAyB;QAPzB,cAAS,GAAT,SAAS,CAAe;QACxB,cAAS,GAAT,SAAS,CAAQ;QACjB,aAAQ,GAAR,QAAQ,CAAQ;QAChB,aAAQ,GAAR,QAAQ,CAAQ;QAChB,mBAAc,GAAd,cAAc,CAAQ;QACtB,WAAM,GAAN,MAAM,CAAe;QACrB,kBAAa,GAAb,aAAa,CAAQ;QACrB,aAAQ,GAAR,QAAQ,CAAiB;QAElC,IAAI,CAAC,gBAAgB,GAAG,IAAI,oBAAoB,EAAE,CAAC;QACnD,wBAAwB,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAChD,IAAI,CAAC,eAAe,GAAG,IAAI,sBAAsB,CAC/C,IAAI,CAAC,aAAa,EAClB,IAAI,CAAC,gBAAgB,CACtB,CAAC;QACF,IAAI,CAAC,KAAK,GAAG,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,CAAC,WAAW,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACnE,CAAC;CACF"}

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,32 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect } from 'vitest';
+import { ContextEnvironmentImpl } from './environmentImpl.js';
+import { ContextTracer } from '../tracer.js';
+import { ContextEventBus } from '../eventBus.js';
+import { createMockLlmClient } from '../testing/contextTestUtils.js';
+describe('ContextEnvironmentImpl', () => {
+    it('should initialize with defaults correctly', () => {
+        const tracer = new ContextTracer({ targetDir: '/tmp', sessionId: 'mock' });
+        const eventBus = new ContextEventBus();
+        const mockLlmClient = createMockLlmClient();
+        const env = new ContextEnvironmentImpl(mockLlmClient, 'mock-session', 'mock-prompt', '/tmp/trace', '/tmp/temp', tracer, 4, eventBus);
+        expect(env.llmClient).toBe(mockLlmClient);
+        expect(env.sessionId).toBe('mock-session');
+        expect(env.promptId).toBe('mock-prompt');
+        expect(env.traceDir).toBe('/tmp/trace');
+        expect(env.projectTempDir).toBe('/tmp/temp');
+        expect(env.tracer).toBe(tracer);
+        expect(env.charsPerToken).toBe(4);
+        expect(env.eventBus).toBe(eventBus);
+        // Default internals
+        expect(env.behaviorRegistry).toBeDefined();
+        expect(env.tokenCalculator).toBeDefined();
+        expect(env.inbox).toBeDefined();
+        expect(env.graphMapper).toBeDefined();
+    });
+});
+//# sourceMappingURL=environmentImpl.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"environmentImpl.test.js","sourceRoot":"","sources":["../../../../src/context/pipeline/environmentImpl.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAErE,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QAC3E,MAAM,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;QACvC,MAAM,aAAa,GAAG,mBAAmB,EAAE,CAAC;QAE5C,MAAM,GAAG,GAAG,IAAI,sBAAsB,CACpC,aAAa,EACb,cAAc,EACd,aAAa,EACb,YAAY,EACZ,WAAW,EACX,MAAM,EACN,CAAC,EACD,QAAQ,CACT,CAAC;QAEF,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC1C,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC3C,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACzC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACxC,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC7C,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEpC,oBAAoB;QACpB,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,WAAW,EAAE,CAAC;QAC1C,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QAChC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,15 @@
+import type { InboxMessage, InboxSnapshot } from '../pipeline.js';
+export declare class LiveInbox {
+    private messages;
+    publish<T>(topic: string, payload: T): void;
+    getMessages(): readonly InboxMessage[];
+    drainConsumed(consumedIds: Set<string>): void;
+}
+export declare class InboxSnapshotImpl implements InboxSnapshot {
+    private messages;
+    private consumedIds;
+    constructor(messages: readonly InboxMessage[]);
+    getMessages<T = unknown>(topic: string): ReadonlyArray<InboxMessage<T>>;
+    consume(messageId: string): void;
+    getConsumedIds(): Set<string>;
+}

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

@@ -0,0 +1,52 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { randomUUID } from 'node:crypto';
+export class LiveInbox {
+    messages = [];
+    publish(topic, payload) {
+        this.messages.push({
+            id: randomUUID(),
+            topic,
+            payload,
+            timestamp: Date.now(),
+        });
+    }
+    getMessages() {
+        return [...this.messages];
+    }
+    drainConsumed(consumedIds) {
+        this.messages = this.messages.filter((m) => !consumedIds.has(m.id));
+    }
+}
+export class InboxSnapshotImpl {
+    messages;
+    consumedIds = new Set();
+    constructor(messages) {
+        this.messages = messages;
+    }
+    getMessages(topic) {
+        const raw = this.messages.filter((m) => m.topic === topic);
+        /*
+         * Architectural Justification for Unchecked Cast:
+         * The Inbox is a heterogeneous event bus designed to support arbitrary, declarative
+         * routing via configuration files (where topics are just strings). Because TypeScript
+         * completely erases generic type information (<T>) at runtime, the central array
+         * can only hold `unknown` payloads. To enforce strict type safety without a central
+         * registry (which would break decoupling) or heavy runtime validation (Zod schemas),
+         * we must assert the type boundary here. The contract relies on the async pipeline and Processor
+         * agreeing on the payload structure associated with the configured topic string.
+         */
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+        return raw;
+    }
+    consume(messageId) {
+        this.consumedIds.add(messageId);
+    }
+    getConsumedIds() {
+        return this.consumedIds;
+    }
+}
+//# sourceMappingURL=inbox.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inbox.js","sourceRoot":"","sources":["../../../../src/context/pipeline/inbox.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,MAAM,OAAO,SAAS;IACZ,QAAQ,GAAmB,EAAE,CAAC;IAEtC,OAAO,CAAI,KAAa,EAAE,OAAU;QAClC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YACjB,EAAE,EAAE,UAAU,EAAE;YAChB,KAAK;YACL,OAAO;YACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;IACL,CAAC;IAED,WAAW;QACT,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;IAED,aAAa,CAAC,WAAwB;QACpC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACtE,CAAC;CACF;AAED,MAAM,OAAO,iBAAiB;IACpB,QAAQ,CAA0B;IAClC,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IAExC,YAAY,QAAiC;QAC3C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,WAAW,CAAc,KAAa;QACpC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;QAC3D;;;;;;;;;WASG;QACH,uEAAuE;QACvE,OAAO,GAAqC,CAAC;IAC/C,CAAC;IAED,OAAO,CAAC,SAAiB;QACvB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;CACF"}

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,36 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect } from 'vitest';
+import { LiveInbox, InboxSnapshotImpl } from './inbox.js';
+describe('Inbox', () => {
+    it('should publish messages and provide snapshots', () => {
+        const inbox = new LiveInbox();
+        inbox.publish('test-topic', { data: 'hello' });
+        inbox.publish('other-topic', { data: 'world' });
+        const messages = inbox.getMessages();
+        expect(messages.length).toBe(2);
+        expect(messages[0].topic).toBe('test-topic');
+        expect(messages[0].payload).toEqual({ data: 'hello' });
+    });
+    it('should drain consumed messages from the snapshot', () => {
+        const inbox = new LiveInbox();
+        inbox.publish('test-topic', { data: 'hello' });
+        inbox.publish('other-topic', { data: 'world' });
+        const messages = inbox.getMessages();
+        const snapshot = new InboxSnapshotImpl(messages);
+        const filtered = snapshot.getMessages('test-topic');
+        expect(filtered.length).toBe(1);
+        expect(filtered[0].payload.data).toBe('hello');
+        // Consume the message
+        snapshot.consume(filtered[0].id);
+        // Provide the consumed IDs to the real inbox to drain them
+        inbox.drainConsumed(snapshot.getConsumedIds());
+        const finalMessages = inbox.getMessages();
+        expect(finalMessages.length).toBe(1);
+        expect(finalMessages[0].topic).toBe('other-topic');
+    });
+});
+//# sourceMappingURL=inbox.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inbox.test.js","sourceRoot":"","sources":["../../../../src/context/pipeline/inbox.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE1D,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE;IACrB,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,KAAK,GAAG,IAAI,SAAS,EAAE,CAAC;QAE9B,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/C,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAEhD,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC7C,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,KAAK,GAAG,IAAI,SAAS,EAAE,CAAC;QAE9B,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/C,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAEhD,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,IAAI,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAEjD,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAmB,YAAY,CAAC,CAAC;QACtE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAE/C,sBAAsB;QACtB,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAEjC,2DAA2D;QAC3D,KAAK,CAAC,aAAa,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAC;QAE/C,MAAM,aAAa,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QAC1C,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ConcreteNode } from '../graph/types.js';
+import type { AsyncPipelineDef, PipelineDef, PipelineTrigger } from '../config/types.js';
+import type { ContextEnvironment, ContextEventBus, ContextTracer } from './environment.js';
+export declare class PipelineOrchestrator {
+    private readonly pipelines;
+    private readonly asyncPipelines;
+    private readonly env;
+    private readonly eventBus;
+    private readonly tracer;
+    private activeTimers;
+    constructor(pipelines: PipelineDef[], asyncPipelines: AsyncPipelineDef[], env: ContextEnvironment, eventBus: ContextEventBus, tracer: ContextTracer);
+    private isNodeAllowed;
+    private setupTriggers;
+    shutdown(): void;
+    executeTriggerSync(trigger: PipelineTrigger, nodes: readonly ConcreteNode[], triggerTargets: ReadonlySet<string>, protectedLogicalIds?: ReadonlySet<string>): Promise<readonly ConcreteNode[]>;
+    private executePipelineAsync;
+}

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

@@ -0,0 +1,126 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { debugLogger } from '../../utils/debugLogger.js';
+import { InboxSnapshotImpl } from './inbox.js';
+import { ContextWorkingBufferImpl } from './contextWorkingBuffer.js';
+export class PipelineOrchestrator {
+    pipelines;
+    asyncPipelines;
+    env;
+    eventBus;
+    tracer;
+    activeTimers = [];
+    constructor(pipelines, asyncPipelines, env, eventBus, tracer) {
+        this.pipelines = pipelines;
+        this.asyncPipelines = asyncPipelines;
+        this.env = env;
+        this.eventBus = eventBus;
+        this.tracer = tracer;
+        this.setupTriggers();
+    }
+    isNodeAllowed(node, triggerTargets, protectedLogicalIds = new Set()) {
+        return (triggerTargets.has(node.id) &&
+            !protectedLogicalIds.has(node.id) &&
+            (!node.logicalParentId || !protectedLogicalIds.has(node.logicalParentId)));
+    }
+    setupTriggers() {
+        const bindTriggers = (pipelines, executeFn) => {
+            for (const pipeline of pipelines) {
+                for (const trigger of pipeline.triggers) {
+                    if (typeof trigger === 'object' && trigger.type === 'timer') {
+                        const timer = setInterval(() => {
+                            // Background timers not fully implemented in V1 yet
+                        }, trigger.intervalMs);
+                        this.activeTimers.push(timer);
+                    }
+                    else if (trigger === 'retained_exceeded' ||
+                        trigger === 'nodes_aged_out') {
+                        this.eventBus.onConsolidationNeeded((event) => {
+                            executeFn(pipeline, event.nodes, event.targetNodeIds, new Set());
+                        });
+                    }
+                    else if (trigger === 'new_message' || trigger === 'nodes_added') {
+                        this.eventBus.onChunkReceived((event) => {
+                            executeFn(pipeline, event.nodes, event.targetNodeIds, new Set());
+                        });
+                    }
+                }
+            }
+        };
+        bindTriggers(this.pipelines, (pipeline, nodes, targets, protectedIds) => {
+            void this.executePipelineAsync(pipeline, nodes, new Set(targets), new Set(protectedIds));
+        });
+        bindTriggers(this.asyncPipelines, (pipeline, nodes, targetIds) => {
+            const inboxSnapshot = new InboxSnapshotImpl(this.env.inbox.getMessages() || []);
+            const targets = nodes.filter((n) => targetIds.has(n.id));
+            for (const processor of pipeline.processors) {
+                processor
+                    .process({
+                    targets,
+                    inbox: inboxSnapshot,
+                    buffer: ContextWorkingBufferImpl.initialize(nodes),
+                })
+                    .catch((e) => debugLogger.error(`AsyncProcessor ${processor.name} failed:`, e));
+            }
+        });
+    }
+    shutdown() {
+        for (const timer of this.activeTimers) {
+            clearInterval(timer);
+        }
+    }
+    async executeTriggerSync(trigger, nodes, triggerTargets, protectedLogicalIds = new Set()) {
+        let currentBuffer = ContextWorkingBufferImpl.initialize(nodes);
+        const triggerPipelines = this.pipelines.filter((p) => p.triggers.includes(trigger));
+        // Freeze the inbox for this pipeline run
+        const inboxSnapshot = new InboxSnapshotImpl(this.env.inbox.getMessages() || []);
+        for (const pipeline of triggerPipelines) {
+            for (const processor of pipeline.processors) {
+                try {
+                    this.tracer.logEvent('Orchestrator', `Executing processor synchronously: ${processor.id}`);
+                    const allowedTargets = currentBuffer.nodes.filter((n) => this.isNodeAllowed(n, triggerTargets, protectedLogicalIds));
+                    const returnedNodes = await processor.process({
+                        buffer: currentBuffer,
+                        targets: allowedTargets,
+                        inbox: inboxSnapshot,
+                    });
+                    currentBuffer = currentBuffer.applyProcessorResult(processor.id, allowedTargets, returnedNodes);
+                }
+                catch (error) {
+                    debugLogger.error(`Synchronous processor ${processor.id} failed:`, error);
+                }
+            }
+        }
+        // Success! Drain consumed messages
+        this.env.inbox.drainConsumed(inboxSnapshot.getConsumedIds());
+        return currentBuffer.nodes;
+    }
+    async executePipelineAsync(pipeline, nodes, triggerTargets, protectedLogicalIds = new Set()) {
+        this.tracer.logEvent('Orchestrator', `Triggering async pipeline: ${pipeline.name}`);
+        if (!nodes || nodes.length === 0)
+            return;
+        let currentBuffer = ContextWorkingBufferImpl.initialize(nodes);
+        const inboxSnapshot = new InboxSnapshotImpl(this.env.inbox.getMessages() || []);
+        for (const processor of pipeline.processors) {
+            try {
+                this.tracer.logEvent('Orchestrator', `Executing processor: ${processor.id} (async)`);
+                const allowedTargets = currentBuffer.nodes.filter((n) => this.isNodeAllowed(n, triggerTargets, protectedLogicalIds));
+                const returnedNodes = await processor.process({
+                    buffer: currentBuffer,
+                    targets: allowedTargets,
+                    inbox: inboxSnapshot,
+                });
+                currentBuffer = currentBuffer.applyProcessorResult(processor.id, allowedTargets, returnedNodes);
+            }
+            catch (error) {
+                debugLogger.error(`Pipeline ${pipeline.name} failed async at ${processor.id}:`, error);
+                return;
+            }
+        }
+        this.env.inbox.drainConsumed(inboxSnapshot.getConsumedIds());
+    }
+}
+//# sourceMappingURL=orchestrator.js.map

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

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

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

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

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

@@ -0,0 +1,154 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import assert from 'node:assert';
+import { describe, it, expect, beforeEach, vi, afterEach } from 'vitest';
+import { PipelineOrchestrator } from './orchestrator.js';
+import { createMockEnvironment, createDummyNode, } from '../testing/contextTestUtils.js';
+// A realistic mock processor that modifies the text of the first target node
+function createModifyingProcessor(id) {
+    return {
+        id,
+        name: 'ModifyingProcessor',
+        process: async (args) => {
+            const newTargets = [...args.targets];
+            if (newTargets.length > 0 && newTargets[0].type === 'USER_PROMPT') {
+                const prompt = newTargets[0];
+                const newParts = [...prompt.semanticParts];
+                if (newParts.length > 0 && newParts[0].type === 'text') {
+                    newParts[0] = {
+                        ...newParts[0],
+                        text: newParts[0].text + ' [modified]',
+                    };
+                }
+                newTargets[0] = {
+                    ...prompt,
+                    id: prompt.id + '-modified',
+                    replacesId: prompt.id,
+                    semanticParts: newParts,
+                };
+            }
+            return newTargets;
+        },
+    };
+}
+// A processor that just throws an error
+function createThrowingProcessor(id) {
+    return {
+        id,
+        name: 'Throwing',
+        process: async () => {
+            throw new Error('Processor failed intentionally');
+        },
+    };
+}
+// A mock async processor that signals it ran
+function createMockAsyncProcessor(id, executeSpy) {
+    return {
+        id,
+        name: 'MockAsyncProcessor',
+        process: async (args) => {
+            executeSpy(args);
+        },
+    };
+}
+describe('PipelineOrchestrator (Component)', () => {
+    let env;
+    let eventBus;
+    beforeEach(() => {
+        env = createMockEnvironment();
+        eventBus = env.eventBus;
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    const setupOrchestrator = (pipelines, asyncPipelines = []) => {
+        const orchestrator = new PipelineOrchestrator(pipelines, asyncPipelines, env, eventBus, env.tracer);
+        return orchestrator;
+    };
+    describe('Synchronous Pipeline Execution', () => {
+        it('applies processors in sequence on matching trigger', async () => {
+            const pipelines = [
+                {
+                    name: 'TestPipeline',
+                    triggers: ['new_message'],
+                    processors: [createModifyingProcessor('Mod')],
+                },
+            ];
+            const orchestrator = setupOrchestrator(pipelines);
+            const originalNode = createDummyNode('ep1', 'USER_PROMPT', 50, {
+                semanticParts: [{ type: 'text', text: 'Original' }],
+            });
+            const processed = await orchestrator.executeTriggerSync('new_message', [originalNode], new Set([originalNode.id]), new Set());
+            expect(processed.length).toBe(1);
+            const resultingNode = processed[0];
+            assert(resultingNode.semanticParts[0].type === 'text');
+            expect(resultingNode.semanticParts[0].text).toBe('Original [modified]');
+            expect(resultingNode.replacesId).toBe(originalNode.id);
+        });
+        it('bypasses pipelines that do not match the trigger', async () => {
+            const pipelines = [
+                {
+                    name: 'TestPipeline',
+                    triggers: ['gc_backstop'], // Different trigger
+                    processors: [createModifyingProcessor('Mod')],
+                },
+            ];
+            const orchestrator = setupOrchestrator(pipelines);
+            const originalNode = createDummyNode('ep1', 'USER_PROMPT', 50, {
+                semanticParts: [{ type: 'text', text: 'Original' }],
+            });
+            const processed = await orchestrator.executeTriggerSync('new_message', [originalNode], new Set([originalNode.id]), new Set());
+            expect(processed).toEqual([originalNode]); // Untouched
+        });
+        it('gracefully handles a failing processor without crashing the pipeline', async () => {
+            const pipelines = [
+                {
+                    name: 'FailingPipeline',
+                    triggers: ['new_message'],
+                    processors: [
+                        createThrowingProcessor('Thrower'),
+                        createModifyingProcessor('Mod'),
+                    ],
+                },
+            ];
+            const orchestrator = setupOrchestrator(pipelines);
+            const originalNode = createDummyNode('ep1', 'USER_PROMPT', 50, {
+                semanticParts: [{ type: 'text', text: 'Original' }],
+            });
+            // The throwing processor should be caught and logged, allowing Mod to still run.
+            const processed = await orchestrator.executeTriggerSync('new_message', [originalNode], new Set([originalNode.id]), new Set());
+            expect(processed.length).toBe(1);
+            const resultingNode = processed[0];
+            assert(resultingNode.semanticParts[0].type === 'text');
+            expect(resultingNode.semanticParts[0].text).toBe('Original [modified]');
+        });
+    });
+    describe('Asynchronous async pipeline Events', () => {
+        it('routes emitChunkReceived to async pipelines with nodes_added trigger', async () => {
+            const executeSpy = vi.fn();
+            const asyncProcessor = createMockAsyncProcessor('MyAsyncProcessor', executeSpy);
+            setupOrchestrator([], [
+                {
+                    name: 'TestAsync',
+                    triggers: ['nodes_added'],
+                    processors: [asyncProcessor],
+                },
+            ]);
+            const node1 = createDummyNode('ep1', 'USER_PROMPT', 10);
+            const node2 = createDummyNode('ep1', 'AGENT_THOUGHT', 20);
+            eventBus.emitChunkReceived({
+                nodes: [node1, node2],
+                targetNodeIds: new Set([node2.id]),
+            });
+            // Yield event loop
+            await new Promise((resolve) => setTimeout(resolve, 0));
+            expect(executeSpy).toHaveBeenCalledTimes(1);
+            const callArgs = executeSpy.mock.calls[0][0];
+            expect(callArgs.targets).toEqual([node2]); // AsyncProcessors only get the target nodes
+        });
+    });
+});
+//# sourceMappingURL=orchestrator.test.js.map

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

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

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

@@ -0,0 +1,52 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ConcreteNode } from './graph/types.js';
+export interface InboxMessage<T = unknown> {
+    id: string;
+    topic: string;
+    payload: T;
+    timestamp: number;
+}
+export interface InboxSnapshot {
+    getMessages<T = unknown>(topic: string): ReadonlyArray<InboxMessage<T>>;
+    consume(messageId: string): void;
+}
+export interface GraphMutation {
+    readonly processorId: string;
+    readonly timestamp: number;
+    readonly removedIds: readonly string[];
+    readonly addedNodes: readonly ConcreteNode[];
+}
+export interface ContextWorkingBuffer {
+    readonly nodes: readonly ConcreteNode[];
+    getPristineNodes(id: string): readonly ConcreteNode[];
+    getLineage(id: string): readonly ConcreteNode[];
+    getAuditLog(): readonly GraphMutation[];
+}
+export interface ProcessArgs {
+    readonly buffer: ContextWorkingBuffer;
+    readonly targets: readonly ConcreteNode[];
+    readonly inbox: InboxSnapshot;
+}
+/**
+ * A ContextProcessor is a pure, closure-based object that returns a modified subset of nodes
+ * (or the original targets if no changes are needed).
+ * The Orchestrator will use this to generate a new graph delta.
+ */
+export interface ContextProcessor {
+    readonly id: string;
+    readonly name: string;
+    process(args: ProcessArgs): Promise<readonly ConcreteNode[]>;
+}
+export interface AsyncContextProcessor {
+    readonly id: string;
+    readonly name: string;
+    process(args: ProcessArgs): Promise<void>;
+}
+export interface BackstopTargetOptions {
+    target?: 'incremental' | 'freeNTokens' | 'max';
+    freeTokensTarget?: number;
+}

package/dist/src/context/pipeline.js

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};
+//# sourceMappingURL=pipeline.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../../src/context/pipeline.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}