@thoughtflow/core 0.1.2

package/dist/libs/conditional-flow.js.map

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

package/dist/libs/context-propagator.d.ts

@@ -0,0 +1,184 @@
+/**
+ * Context propagation layer for multi-agent systems
+ * Tracks caller metadata, manages namespaces, and prevents context leakage
+ */
+/**
+ * Metadata about who called the current agent
+ */
+export interface CallerMetadata {
+    /** ID of the calling agent (parent) */
+    callerId: string;
+    /** Name of the calling agent */
+    callerName: string;
+    /** Namespace of the caller (context path) */
+    callerNamespace: string;
+    /** Additional metadata from caller */
+    callerMetadata?: Record<string, unknown>;
+    /** Timestamp when call was made */
+    callTime: Date;
+    /** Call depth (0 = top-level, 1 = first child, etc.) */
+    depth: number;
+    /** Unique call ID for tracing */
+    callId: string;
+}
+/**
+ * Namespace for context isolation
+ */
+export interface Namespace {
+    /** Unique namespace identifier */
+    namespaceId: string;
+    /** Parent namespace (if this is a child) */
+    parentNamespaceId?: string;
+    /** Namespace path (e.g., "root:agent1:agent2") */
+    path: string;
+    /** All ancestor namespaces in order */
+    ancestors: string[];
+    /** Sibling namespaces (for isolation checking) */
+    siblings: Set<string>;
+    /** Creation timestamp */
+    createdAt: Date;
+    /** Data scoped to this namespace */
+    scopedData: Map<string, unknown>;
+}
+/**
+ * Propagation context for an agent call
+ */
+export interface PropagationContext {
+    /** Root namespace (top-level caller) */
+    rootNamespace: Namespace;
+    /** Current namespace for this call level */
+    currentNamespace: Namespace;
+    /** Caller metadata chain (who called whom) */
+    callerChain: CallerMetadata[];
+    /** Full context path as string */
+    contextPath: string;
+    /** Whether context is isolated from siblings */
+    isIsolated: boolean;
+}
+/**
+ * ContextPropagator manages context flow through multi-agent hierarchies
+ * with caller tracking and namespace isolation
+ *
+ * Usage:
+ *   const propagator = new ContextPropagator("root-agent");
+ *   propagator.updateCaller("child-agent", { depth: 1 });
+ *   const context = propagator.getCurrentContext();
+ */
+export declare class ContextPropagator {
+    private readonly agentId;
+    private readonly agentName;
+    private rootNamespace;
+    private currentNamespace;
+    private callerChain;
+    private maxDepth;
+    private namespaceMap;
+    constructor(agentId: string, agentName?: string, maxDepth?: number);
+    /**
+     * Create a new namespace
+     */
+    private createNamespace;
+    /**
+     * Generate namespace path from ID
+     */
+    private generatePath;
+    /**
+     * Record a caller (agent that called this one)
+     */
+    setCallerMetadata(callerId: string, callerName: string, callerMetadata?: Record<string, unknown>): void;
+    /**
+     * Generate unique call ID for tracing
+     */
+    private generateCallId;
+    /**
+     * Pop caller from chain (unwind call stack)
+     */
+    popCaller(): CallerMetadata | undefined;
+    /**
+     * Get current propagation context
+     */
+    getCurrentContext(): PropagationContext;
+    /**
+     * Get full context path as string
+     */
+    getContextPath(): string;
+    /**
+     * Check if context is isolated from siblings
+     */
+    isContextIsolated(): boolean;
+    /**
+     * Get call depth (how deep in call stack)
+     */
+    getDepth(): number;
+    /**
+     * Get caller at specific depth
+     */
+    getCallerAt(depth: number): CallerMetadata | undefined;
+    /**
+     * Get immediate caller metadata
+     */
+    getImmediateCaller(): CallerMetadata | undefined;
+    /**
+     * Get root caller (top of stack)
+     */
+    getRootCaller(): CallerMetadata | undefined;
+    /**
+     * Store data in current namespace
+     */
+    setScopedData(key: string, value: unknown): void;
+    /**
+     * Get data from current namespace
+     */
+    getScopedData(key: string): unknown;
+    /**
+     * Get scoped data from a specific namespace
+     */
+    getScopedDataFromNamespace(namespaceId: string, key: string): unknown;
+    /**
+     * Clear scoped data from current namespace
+     */
+    clearScopedData(): void;
+    /**
+     * Check if we can access data from an ancestor namespace
+     */
+    canAccessAncestorData(ancestorNamespaceId: string): boolean;
+    /**
+     * Check if we can access data from a sibling namespace (generally no)
+     */
+    canAccessSiblingData(siblingNamespaceId: string): boolean;
+    /**
+     * Get all ancestors in order (root first)
+     */
+    getAncestorNamespaces(): Namespace[];
+    /**
+     * Create child agent context (for setting up child propagator)
+     */
+    createChildContext(childId: string, childName: string): PropagationContext;
+    /**
+     * Get statistics about propagation
+     */
+    getStats(): {
+        agentId: string;
+        agentName: string;
+        depth: number;
+        callChainLength: number;
+        totalNamespaces: number;
+        isIsolated: boolean;
+        contextPath: string;
+    };
+    /**
+     * Reset to root state
+     */
+    reset(): void;
+    /**
+     * Dispose and cleanup
+     */
+    dispose(): void;
+    /**
+     * Create multiple child propagators for parallel execution
+     */
+    static createChildren(parentPropagator: ContextPropagator, childConfigs: Array<{
+        id: string;
+        name: string;
+    }>): ContextPropagator[];
+}
+//# sourceMappingURL=context-propagator.d.ts.map

package/dist/libs/context-propagator.d.ts.map

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

package/dist/libs/context-propagator.js

@@ -0,0 +1,295 @@
+"use strict";
+/**
+ * Context propagation layer for multi-agent systems
+ * Tracks caller metadata, manages namespaces, and prevents context leakage
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextPropagator = void 0;
+/**
+ * ContextPropagator manages context flow through multi-agent hierarchies
+ * with caller tracking and namespace isolation
+ *
+ * Usage:
+ *   const propagator = new ContextPropagator("root-agent");
+ *   propagator.updateCaller("child-agent", { depth: 1 });
+ *   const context = propagator.getCurrentContext();
+ */
+class ContextPropagator {
+    agentId;
+    agentName;
+    rootNamespace;
+    currentNamespace;
+    callerChain = [];
+    maxDepth = 10; // Prevent infinite recursion
+    namespaceMap = new Map();
+    constructor(agentId, agentName = "default", maxDepth) {
+        if (!agentId) {
+            throw new Error("ContextPropagator: agentId is required");
+        }
+        this.agentId = agentId;
+        this.agentName = agentName;
+        if (maxDepth) {
+            this.maxDepth = maxDepth;
+        }
+        // Initialize root namespace
+        this.rootNamespace = this.createNamespace(`${agentId}:root`, undefined, `${agentName}`);
+        this.currentNamespace = this.rootNamespace;
+        this.namespaceMap.set(this.rootNamespace.namespaceId, this.rootNamespace);
+    }
+    /**
+     * Create a new namespace
+     */
+    createNamespace(namespaceId, parentId, path) {
+        const parent = parentId ? this.namespaceMap.get(parentId) : undefined;
+        const ancestors = parent ? [...parent.ancestors, parentId] : [];
+        const namespace = {
+            namespaceId,
+            parentNamespaceId: parentId,
+            path: path || this.generatePath(namespaceId),
+            ancestors: ancestors.filter((id) => id !== undefined),
+            siblings: new Set(),
+            createdAt: new Date(),
+            scopedData: new Map(),
+        };
+        return namespace;
+    }
+    /**
+     * Generate namespace path from ID
+     */
+    generatePath(namespaceId) {
+        const pathDepth = this.callerChain.length;
+        const pathParts = [this.agentName, ...this.callerChain.map((c) => c.callerName)];
+        return pathParts.join(":");
+    }
+    /**
+     * Record a caller (agent that called this one)
+     */
+    setCallerMetadata(callerId, callerName, callerMetadata) {
+        // Check depth limit
+        if (this.callerChain.length >= this.maxDepth) {
+            throw new Error(`ContextPropagator: Maximum call depth (${this.maxDepth}) exceeded`);
+        }
+        const callId = this.generateCallId();
+        const depth = this.callerChain.length;
+        const callerNamespace = this.currentNamespace.namespaceId;
+        const caller = {
+            callerId,
+            callerName,
+            callerNamespace,
+            callerMetadata,
+            callTime: new Date(),
+            depth,
+            callId,
+        };
+        this.callerChain.push(caller);
+        // Create new namespace for the child
+        const childNamespaceId = `${callerName}:${callId}`;
+        const childPath = [...this.callerChain.map((c) => c.callerName)].join(":");
+        const childNamespace = this.createNamespace(childNamespaceId, this.currentNamespace.namespaceId, childPath);
+        // Register sibling for isolation
+        this.currentNamespace.siblings.add(childNamespaceId);
+        this.namespaceMap.set(childNamespaceId, childNamespace);
+        this.currentNamespace = childNamespace;
+    }
+    /**
+     * Generate unique call ID for tracing
+     */
+    generateCallId() {
+        return `call_${Date.now()}_${Math.random().toString(36).slice(2, 9)}`;
+    }
+    /**
+     * Pop caller from chain (unwind call stack)
+     */
+    popCaller() {
+        if (this.callerChain.length === 0) {
+            return undefined;
+        }
+        const caller = this.callerChain.pop();
+        // Move back to parent namespace
+        if (this.currentNamespace.parentNamespaceId) {
+            const parent = this.namespaceMap.get(this.currentNamespace.parentNamespaceId);
+            if (parent) {
+                this.currentNamespace = parent;
+            }
+        }
+        return caller;
+    }
+    /**
+     * Get current propagation context
+     */
+    getCurrentContext() {
+        return {
+            rootNamespace: this.rootNamespace,
+            currentNamespace: this.currentNamespace,
+            callerChain: [...this.callerChain],
+            contextPath: this.getContextPath(),
+            isIsolated: this.isContextIsolated(),
+        };
+    }
+    /**
+     * Get full context path as string
+     */
+    getContextPath() {
+        const parts = [this.agentName];
+        for (const caller of this.callerChain) {
+            parts.push(caller.callerName);
+        }
+        return parts.join(" -> ");
+    }
+    /**
+     * Check if context is isolated from siblings
+     */
+    isContextIsolated() {
+        // Context is isolated if each caller only has this one child
+        for (const caller of this.callerChain) {
+            const namespace = this.namespaceMap.get(caller.callerNamespace);
+            if (namespace && namespace.siblings.size > 1) {
+                return false; // Siblings exist, not fully isolated
+            }
+        }
+        return true;
+    }
+    /**
+     * Get call depth (how deep in call stack)
+     */
+    getDepth() {
+        return this.callerChain.length;
+    }
+    /**
+     * Get caller at specific depth
+     */
+    getCallerAt(depth) {
+        return this.callerChain[depth];
+    }
+    /**
+     * Get immediate caller metadata
+     */
+    getImmediateCaller() {
+        if (this.callerChain.length === 0) {
+            return undefined;
+        }
+        return this.callerChain[this.callerChain.length - 1];
+    }
+    /**
+     * Get root caller (top of stack)
+     */
+    getRootCaller() {
+        return this.callerChain[0];
+    }
+    /**
+     * Store data in current namespace
+     */
+    setScopedData(key, value) {
+        this.currentNamespace.scopedData.set(key, value);
+    }
+    /**
+     * Get data from current namespace
+     */
+    getScopedData(key) {
+        return this.currentNamespace.scopedData.get(key);
+    }
+    /**
+     * Get scoped data from a specific namespace
+     */
+    getScopedDataFromNamespace(namespaceId, key) {
+        const namespace = this.namespaceMap.get(namespaceId);
+        return namespace?.scopedData.get(key);
+    }
+    /**
+     * Clear scoped data from current namespace
+     */
+    clearScopedData() {
+        this.currentNamespace.scopedData.clear();
+    }
+    /**
+     * Check if we can access data from an ancestor namespace
+     */
+    canAccessAncestorData(ancestorNamespaceId) {
+        // Can access if ancestor is in our lineage
+        return this.currentNamespace.ancestors.includes(ancestorNamespaceId);
+    }
+    /**
+     * Check if we can access data from a sibling namespace (generally no)
+     */
+    canAccessSiblingData(siblingNamespaceId) {
+        // Cannot access sibling data (strict isolation)
+        return false;
+    }
+    /**
+     * Get all ancestors in order (root first)
+     */
+    getAncestorNamespaces() {
+        return this.currentNamespace.ancestors
+            .map((id) => this.namespaceMap.get(id))
+            .filter((ns) => ns !== undefined);
+    }
+    /**
+     * Create child agent context (for setting up child propagator)
+     */
+    createChildContext(childId, childName) {
+        const caller = {
+            callerId: this.agentId,
+            callerName: this.agentName,
+            callerNamespace: this.currentNamespace.namespaceId,
+            callTime: new Date(),
+            depth: this.callerChain.length,
+            callId: this.generateCallId(),
+        };
+        return {
+            rootNamespace: this.rootNamespace,
+            currentNamespace: this.currentNamespace,
+            callerChain: [...this.callerChain, caller],
+            contextPath: `${this.getContextPath()} -> ${childName}`,
+            isIsolated: this.isContextIsolated(),
+        };
+    }
+    /**
+     * Get statistics about propagation
+     */
+    getStats() {
+        return {
+            agentId: this.agentId,
+            agentName: this.agentName,
+            depth: this.getDepth(),
+            callChainLength: this.callerChain.length,
+            totalNamespaces: this.namespaceMap.size,
+            isIsolated: this.isContextIsolated(),
+            contextPath: this.getContextPath(),
+        };
+    }
+    /**
+     * Reset to root state
+     */
+    reset() {
+        this.callerChain = [];
+        this.currentNamespace = this.rootNamespace;
+    }
+    /**
+     * Dispose and cleanup
+     */
+    dispose() {
+        this.callerChain = [];
+        this.namespaceMap.forEach((ns) => ns.scopedData.clear());
+        this.namespaceMap.clear();
+    }
+    /**
+     * Create multiple child propagators for parallel execution
+     */
+    static createChildren(parentPropagator, childConfigs) {
+        const children = [];
+        const parentContext = parentPropagator.createChildContext("temp", "temp");
+        for (const child of childConfigs) {
+            const propagator = new ContextPropagator(child.id, child.name);
+            // Set up caller chain from parent context
+            for (const caller of parentContext.callerChain) {
+                propagator.setCallerMetadata(caller.callerId, caller.callerName, caller.callerMetadata);
+            }
+            // Set current caller as parent
+            propagator.setCallerMetadata(parentPropagator["agentId"], parentPropagator["agentName"]);
+            children.push(propagator);
+        }
+        return children;
+    }
+}
+exports.ContextPropagator = ContextPropagator;
+//# sourceMappingURL=context-propagator.js.map

package/dist/libs/context-propagator.js.map

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

package/dist/libs/context-window.class.d.ts

@@ -0,0 +1,86 @@
+import { ConversationMessage } from "../contracts";
+/**
+ * Rough token estimator: 1 token ≈ 4 characters (same heuristic as opencode Token.estimate).
+ * Good enough for trimming decisions without a real tokenizer.
+ */
+export declare function estimateTokens(text: string): number;
+/**
+ * Strategy for trimming message history before it is sent to the LLM.
+ *
+ * - `sliding-window`:  keep the system message + the last `maxMessages` non-system messages.
+ *                      Oldest non-system messages are dropped.
+ * - `keep-last-N`:     alias for sliding-window (same semantics, explicit name).
+ * - `summarize`:       same as sliding-window for now; full LLM-based summarization is
+ *                      a separate step that marks old messages `compressed: true` in storage.
+ *                      (Compression itself is triggered externally; this strategy just trims.)
+ */
+export type ContextWindowStrategy = "sliding-window" | "keep-last-N" | "summarize";
+export interface ContextWindowConfig {
+    strategy: ContextWindowStrategy;
+    /** Maximum number of NON-system messages to keep in the window sent to the LLM. */
+    maxMessages: number;
+    /**
+     * Token-budget limit for the context window (approximate, chars/4).
+     * When set, the trimmer uses token estimates instead of raw message counts.
+     * System messages are always preserved and not counted against this budget.
+     */
+    maxTokens?: number;
+    /**
+     * For `summarize` strategy: number of most recent non-system messages kept verbatim.
+     * Remaining older messages are condensed into one synthetic summary message.
+     *
+     * When omitted, defaults to `maxMessages - 1` to reserve one slot for the summary.
+     */
+    keepRecentMessages?: number;
+    /** Prefix used for synthetic summary message content in `summarize` strategy. */
+    summaryPrefix?: string;
+    /** Character cap for synthetic summary content. */
+    maxSummaryChars?: number;
+}
+/**
+ * ContextWindowManager
+ *
+ * Receives the raw message history snapshot and returns a trimmed
+ * subset safe to send to the LLM. The system message is ALWAYS
+ * preserved (it is never counted against `maxMessages`).
+ *
+ * Only deterministic trimming — no LLM calls inside.
+ */
+export declare class ContextWindowManager {
+    private readonly config;
+    constructor(config: ContextWindowConfig);
+    /**
+     * Apply the configured strategy and return a trimmed message array.
+     * When `config.maxTokens` is set, trims by estimated token count instead of message count.
+     * @param messages Full snapshot from MessageHistory.
+     */
+    trim(messages: ConversationMessage[]): ConversationMessage[];
+    /**
+     * Return true if the message list exceeds the configured window.
+     * Useful for triggering proactive compression before sending.
+     */
+    needsTrimming(messages: ConversationMessage[]): boolean;
+    private trimByTokens;
+    private trimWithSummary;
+    private resolveKeepRecentMessages;
+    private buildSummaryContent;
+    private normalizeWhitespace;
+    private normalizeNonNegativeInt;
+}
+/**
+ * Surgical tool-output pruning (opencode-inspired).
+ *
+ * Instead of removing whole messages, this function zero-fills the `content`
+ * of old `role:"tool"` messages that fall outside the recent token budget.
+ * Message structure is preserved so the LLM still sees that a tool was called
+ * and returned something.
+ *
+ * Already-pruned messages (`metadata.pruned === true`) are skipped.
+ *
+ * @param messages          Full message array (in conversation order).
+ * @param keepRecentTokens  Token budget for the "protected recent" window.
+ *                          Tool outputs inside this window are NOT pruned.
+ * @returns A new message array with old tool outputs replaced by a stub.
+ */
+export declare function pruneToolOutputs(messages: ConversationMessage[], keepRecentTokens: number): ConversationMessage[];
+//# sourceMappingURL=context-window.class.d.ts.map

package/dist/libs/context-window.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-window.class.d.ts","sourceRoot":"","sources":["../../src/libs/context-window.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,qBAAqB,GAAG,gBAAgB,GAAG,aAAa,GAAG,WAAW,CAAC;AAEnF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,qBAAqB,CAAC;IAChC,mFAAmF;IACnF,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;GAQG;AACH,qBAAa,oBAAoB;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,mBAAmB;IAExD;;;;OAIG;IACH,IAAI,CAAC,QAAQ,EAAE,mBAAmB,EAAE,GAAG,mBAAmB,EAAE;IAkC5D;;;OAGG;IACH,aAAa,CAAC,QAAQ,EAAE,mBAAmB,EAAE,GAAG,OAAO;IAYvD,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,eAAe;IAqCvB,OAAO,CAAC,yBAAyB;IAOjC,OAAO,CAAC,mBAAmB;IAe3B,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,uBAAuB;CAOhC;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,mBAAmB,EAAE,EAC/B,gBAAgB,EAAE,MAAM,GACvB,mBAAmB,EAAE,CA8BvB"}