agentflow-core 0.8.0 → 0.8.1

package/dist/index.d.ts

@@ -50,6 +50,25 @@ interface TraceEvent {
     readonly nodeId: string;
     readonly data: Readonly<Record<string, unknown>>;
 }
+/**
+ * Optional typed data for `decision` trace events.
+ * Frameworks can emit these to provide richer decision data than graph inference.
+ * SOMA will use these fields if present, falling back to graph-structure inference.
+ */
+interface DecisionTraceData {
+    /** What was selected */
+    readonly choice: string;
+    /** Other options available */
+    readonly alternatives?: readonly string[];
+    /** Why this choice was made */
+    readonly rationale?: string;
+    /** Confidence in the decision (0.0-1.0) */
+    readonly confidence?: number;
+    /** Arbitrary context */
+    readonly context?: Readonly<Record<string, unknown>>;
+    /** Decision outcome */
+    readonly outcome?: string;
+}
 /** The complete execution graph for one agent run. */
 interface ExecutionGraph {
     readonly id: string;
@@ -71,6 +90,8 @@ interface ExecutionGraph {
     readonly spanId?: string;
     /** Parent span ID, or null if this is the root span. */
     readonly parentSpanId?: string | null;
+    /** Arbitrary metadata preserved from the trace file. */
+    readonly metadata?: Record<string, unknown>;
 }
 /**
  * Configuration for AgentFlow.
@@ -307,14 +328,135 @@ interface ConformanceReport {
     /** List of specific deviations found. */
     readonly deviations: readonly Deviation[];
 }
+/** Explanation attached to every guard violation for transparency. */
+interface GuardExplanation {
+    /** The guard rule name (e.g., 'max-depth', 'timeout'). */
+    readonly rule: string;
+    /** The configured threshold that was exceeded. */
+    readonly threshold: number | string;
+    /** The actual observed value. */
+    readonly actual: number | string;
+    /** Where the threshold came from. */
+    readonly source: 'static' | 'soma-policy' | 'adaptive' | 'assertion';
+    /** Optional historical evidence supporting the threshold. */
+    readonly evidence?: string;
+}
+/** Outcome assertion for post-action verification. */
+interface OutcomeAssertion {
+    /** Human-readable label for this assertion. */
+    readonly name: string;
+    /** Verification function — returns true if the expected outcome occurred. */
+    readonly verify: () => Promise<boolean> | boolean;
+    /** Timeout in milliseconds (default: 5000). */
+    readonly timeout?: number;
+}
 /**
  * A detected guard violation.
  */
 interface GuardViolation {
-    readonly type: 'timeout' | 'reasoning-loop' | 'spawn-explosion' | 'high-failure-rate' | 'conformance-drift' | 'known-bottleneck';
+    readonly type: 'timeout' | 'reasoning-loop' | 'spawn-explosion' | 'high-failure-rate' | 'conformance-drift' | 'known-bottleneck' | 'outcome_mismatch';
     readonly nodeId: string;
     readonly message: string;
     readonly timestamp: number;
+    readonly explanation: GuardExplanation;
+}
+/** Per-node cost attribution. */
+interface NodeCost {
+    readonly nodeId: string;
+    readonly name: string;
+    readonly type: NodeType;
+    readonly tokenCost: number | null;
+    readonly durationMs: number | null;
+}
+/** Wasteful pattern detection flag. */
+interface EfficiencyFlag {
+    readonly pattern: 'wasteful_retry' | 'context_bloat';
+    readonly nodeName: string;
+    readonly retryCount?: number;
+    readonly tokenCost: number;
+    readonly message: string;
+}
+/** Per-run efficiency summary. */
+interface RunEfficiency {
+    readonly graphId: string;
+    readonly agentId: string;
+    readonly totalTokenCost: number;
+    readonly completedNodes: number;
+    readonly costPerNode: number;
+}
+/** Aggregate efficiency report across runs. */
+interface EfficiencyReport {
+    readonly runs: readonly RunEfficiency[];
+    readonly aggregate: {
+        mean: number;
+        median: number;
+        p95: number;
+    };
+    readonly flags: readonly EfficiencyFlag[];
+    readonly nodeCosts: readonly NodeCost[];
+    readonly dataCoverage: number;
+}
+/** Per-step summary in a run receipt. */
+interface StepSummary {
+    readonly nodeId: string;
+    readonly name: string;
+    readonly type: NodeType;
+    readonly status: NodeStatus;
+    readonly durationMs: number | null;
+    readonly tokenCost: number | null;
+    readonly error: string | null;
+}
+/** Structured run summary. */
+interface RunReceipt {
+    readonly runId: string;
+    readonly agentId: string;
+    readonly status: GraphStatus;
+    readonly startTime: number;
+    readonly endTime: number | null;
+    readonly totalDurationMs: number | null;
+    readonly totalTokenCost: number | null;
+    readonly steps: readonly StepSummary[];
+    readonly summary: {
+        readonly attempted: number;
+        readonly succeeded: number;
+        readonly failed: number;
+        readonly skipped: number;
+    };
+}
+/** A single conformance history entry. */
+interface ConformanceHistoryEntry {
+    readonly agentId: string;
+    readonly timestamp: number;
+    readonly score: number;
+    readonly runId: string;
+}
+/** Conformance score history for an agent. */
+type ConformanceHistory = ConformanceHistoryEntry[];
+/** Options for drift detection. */
+interface DriftOptions {
+    /** Sliding window size (number of runs). Default: 50. */
+    readonly windowSize?: number;
+}
+/** Drift detection report. */
+interface DriftReport {
+    readonly status: 'stable' | 'degrading' | 'improving' | 'insufficient_data';
+    readonly slope: number;
+    readonly r2: number;
+    readonly windowSize: number;
+    readonly dataPoints: number;
+    readonly alert?: {
+        readonly type: 'conformance_trend_degradation';
+        readonly agentId: string;
+        readonly currentScore: number;
+        readonly trendSlope: number;
+        readonly windowSize: number;
+        readonly message: string;
+    };
+}
+/** Options for variant analysis. */
+interface VariantOptions {
+    /** Dimensions to include in variant signature. Default: ['path']. */
+    readonly dimensions?: readonly ('path' | 'modelId' | 'status')[];
 }
 /** Event type discriminator for AgentFlow events. */
 type AgentFlowEventType = 'execution.completed' | 'execution.failed' | 'pattern.discovered' | 'pattern.updated';
@@ -646,35 +788,6 @@ declare function createEventEmitter(config?: EventEmitterConfig): EventEmitter;
  */
 declare function createGraphBuilder(config?: AgentFlowConfig): GraphBuilder;
 
-/**
- * LLM-powered semantic analysis engine for agent execution data.
- *
- * The insight engine reads from the knowledge store, constructs prompts via
- * pure prompt builder functions, delegates to a user-provided AnalysisFn,
- * and caches results as InsightEvents in the store.
- *
- * @module
- */
-
-/**
- * Create an LLM-powered semantic analysis engine.
- *
- * @param store - The knowledge store to read data from and cache insights to.
- * @param analysisFn - User-provided LLM function (prompt → response).
- * @param config - Optional configuration (cache TTL).
- * @returns An InsightEngine for semantic analysis of agent execution data.
- *
- * @example
- * ```ts
- * const engine = createInsightEngine(store, async (prompt) => {
- *   return await myLlm.complete(prompt);
- * });
- * const result = await engine.explainFailures('my-agent');
- * console.log(result.content);
- * ```
- */
-declare function createInsightEngine(store: KnowledgeStore, analysisFn: AnalysisFn, config?: InsightEngineConfig): InsightEngine;
-
 /**
  * Pure query functions for interrogating a built `ExecutionGraph`.
  * Every function takes a frozen graph and returns derived data without mutation.
@@ -870,6 +983,35 @@ declare function checkGuards(graph: ExecutionGraph, config?: GuardConfig): reado
  */
 declare function withGuards(builder: GraphBuilder, config?: GuardConfig): GraphBuilder;
 
+/**
+ * LLM-powered semantic analysis engine for agent execution data.
+ *
+ * The insight engine reads from the knowledge store, constructs prompts via
+ * pure prompt builder functions, delegates to a user-provided AnalysisFn,
+ * and caches results as InsightEvents in the store.
+ *
+ * @module
+ */
+
+/**
+ * Create an LLM-powered semantic analysis engine.
+ *
+ * @param store - The knowledge store to read data from and cache insights to.
+ * @param analysisFn - User-provided LLM function (prompt → response).
+ * @param config - Optional configuration (cache TTL).
+ * @returns An InsightEngine for semantic analysis of agent execution data.
+ *
+ * @example
+ * ```ts
+ * const engine = createInsightEngine(store, async (prompt) => {
+ *   return await myLlm.complete(prompt);
+ * });
+ * const result = await engine.explainFailures('my-agent');
+ * console.log(result.content);
+ * ```
+ */
+declare function createInsightEngine(store: KnowledgeStore, analysisFn: AnalysisFn, config?: InsightEngineConfig): InsightEngine;
+
 /**
  * JSON file-based event writer for AgentFlow.
  *
@@ -941,68 +1083,6 @@ declare function createJsonEventWriter(config: JsonEventWriterConfig): EventWrit
  */
 declare function createKnowledgeStore(config?: KnowledgeStoreConfig): KnowledgeStore;
 
-/**
- * PolicySource: read-only interface over the knowledge store for adaptive guards.
- *
- * Bridges accumulated execution knowledge to guard decisions without
- * coupling guards to storage internals.
- *
- * @module
- */
-
-/**
- * Create a PolicySource backed by a knowledge store.
- *
- * All methods delegate to the store's profile data. The PolicySource is a
- * pure read interface — it never writes to the store.
- *
- * @param store - The knowledge store to query.
- * @returns A PolicySource for use with adaptive guards.
- *
- * @example
- * ```ts
- * const store = createKnowledgeStore({ baseDir: '.agentflow/knowledge' });
- * const policy = createPolicySource(store);
- * const rate = policy.recentFailureRate('my-agent'); // 0.0–1.0
- * ```
- */
-declare function createPolicySource(store: KnowledgeStore): PolicySource;
-
-/**
- * Soma-compatible event writer for AgentFlow.
- *
- * Converts AgentFlow events (ExecutionEvent, PatternEvent) into Markdown files
- * with YAML frontmatter that Soma's Curator can ingest from its inbox directory.
- *
- * @module
- */
-
-/**
- * Configuration for the Soma event writer.
- */
-interface SomaEventWriterConfig {
-    /** Directory to write event files to (Soma's inbox). Created if it does not exist. */
-    readonly inboxDir: string;
-}
-/**
- * Create a Soma event writer that persists events as Curator-compatible Markdown files.
- *
- * Each event is written to `{type}-{agentId}-{compact-ISO-timestamp}.md` in the
- * configured inbox directory. The Curator picks up these files on its 60-second cycle.
- *
- * @param config - Writer configuration with inbox directory path.
- * @returns An EventWriter that writes Markdown files to the Soma inbox.
- *
- * @example
- * ```ts
- * const writer = createSomaEventWriter({ inboxDir: '~/.openclaw/workspace/inbox' });
- * const emitter = createEventEmitter({ writers: [writer] });
- * await emitter.emit(createExecutionEvent(graph));
- * // Creates: ~/.openclaw/workspace/inbox/execution-alfred-20260314T083502.md
- * ```
- */
-declare function createSomaEventWriter(config: SomaEventWriterConfig): EventWriter;
-
 /**
  * AgentFlow Live Monitor — real-time terminal dashboard for any agent system.
  *
@@ -1074,6 +1154,33 @@ declare function loadGraph(input: string | Record<string, unknown>): ExecutionGr
  */
 declare function graphToJson(graph: ExecutionGraph): Record<string, unknown>;
 
+/**
+ * PolicySource: read-only interface over the knowledge store for adaptive guards.
+ *
+ * Bridges accumulated execution knowledge to guard decisions without
+ * coupling guards to storage internals.
+ *
+ * @module
+ */
+
+/**
+ * Create a PolicySource backed by a knowledge store.
+ *
+ * All methods delegate to the store's profile data. The PolicySource is a
+ * pure read interface — it never writes to the store.
+ *
+ * @param store - The knowledge store to query.
+ * @returns A PolicySource for use with adaptive guards.
+ *
+ * @example
+ * ```ts
+ * const store = createKnowledgeStore({ baseDir: '.agentflow/knowledge' });
+ * const policy = createPolicySource(store);
+ * const rate = policy.recentFailureRate('my-agent'); // 0.0–1.0
+ * ```
+ */
+declare function createPolicySource(store: KnowledgeStore): PolicySource;
+
 /**
  * AgentFlow Process Audit — OS-level process health checks for agent systems.
  *
@@ -1161,6 +1268,22 @@ interface ProcessAuditConfig {
  * ```
  */
 declare function discoverProcessConfig(dirs: string[]): ProcessAuditConfig | null;
+/**
+ * Discover all process configurations from the given directories and systemd.
+ *
+ * Unlike `discoverProcessConfig` which returns only the first match, this
+ * scans all PID files and also discovers systemd user services to return
+ * a complete list of auditable processes.
+ *
+ * @example
+ * ```ts
+ * const configs = discoverAllProcessConfigs(['./data', '/var/run']);
+ * for (const config of configs) {
+ *   console.log(formatAuditReport(auditProcesses(config)));
+ * }
+ * ```
+ */
+declare function discoverAllProcessConfigs(dirs: string[]): ProcessAuditConfig[];
 /**
  * Run a full process health audit.
  *
@@ -1188,50 +1311,6 @@ declare function auditProcesses(config: ProcessAuditConfig): ProcessAuditResult;
  */
 declare function formatAuditReport(result: ProcessAuditResult): string;
 
-/**
- * Pure prompt construction functions for LLM-powered semantic analysis.
- *
- * Each function takes knowledge store data and returns a structured prompt string.
- * No side effects, no filesystem access, no external calls.
- *
- * @module
- */
-
-/**
- * Build a structured prompt for LLM analysis of agent failures.
- *
- * @param events - Recent failed execution events for the agent.
- * @param profile - The agent's derived profile.
- * @returns A structured prompt string.
- */
-declare function buildFailureAnalysisPrompt(events: ExecutionEvent[], profile: AgentProfile): string;
-/**
- * Build a structured prompt for explaining why an execution was anomalous.
- *
- * @param event - The specific execution event flagged as anomalous.
- * @param profile - The agent's derived profile for baseline context.
- * @returns A structured prompt string.
- */
-declare function buildAnomalyExplanationPrompt(event: ExecutionEvent, profile: AgentProfile): string;
-/**
- * Build a structured prompt for generating an agent health summary.
- *
- * @param profile - The agent's derived profile.
- * @param recentEvents - Recent execution events.
- * @param patterns - Recent pattern discovery events.
- * @returns A structured prompt string.
- */
-declare function buildAgentSummaryPrompt(profile: AgentProfile, recentEvents: ExecutionEvent[], patterns: PatternEvent[]): string;
-/**
- * Build a structured prompt for generating actionable fix recommendations.
- *
- * @param events - Recent failed execution events.
- * @param profile - The agent's derived profile.
- * @param patterns - Recent pattern discovery events.
- * @returns A structured prompt string.
- */
-declare function buildFixSuggestionPrompt(events: ExecutionEvent[], profile: AgentProfile, patterns: PatternEvent[]): string;
-
 /**
  * Process mining primitives for cross-run analysis of execution graphs.
  *
@@ -1333,6 +1412,99 @@ declare function getBottlenecks(graphs: ExecutionGraph[]): Bottleneck[];
  */
 declare function checkConformance(graph: ExecutionGraph, model: ProcessModel): ConformanceReport;
 
+/**
+ * Pure prompt construction functions for LLM-powered semantic analysis.
+ *
+ * Each function takes knowledge store data and returns a structured prompt string.
+ * No side effects, no filesystem access, no external calls.
+ *
+ * @module
+ */
+
+/**
+ * Build a structured prompt for LLM analysis of agent failures.
+ *
+ * @param events - Recent failed execution events for the agent.
+ * @param profile - The agent's derived profile.
+ * @returns A structured prompt string.
+ */
+declare function buildFailureAnalysisPrompt(events: ExecutionEvent[], profile: AgentProfile): string;
+/**
+ * Build a structured prompt for explaining why an execution was anomalous.
+ *
+ * @param event - The specific execution event flagged as anomalous.
+ * @param profile - The agent's derived profile for baseline context.
+ * @returns A structured prompt string.
+ */
+declare function buildAnomalyExplanationPrompt(event: ExecutionEvent, profile: AgentProfile): string;
+/**
+ * Build a structured prompt for generating an agent health summary.
+ *
+ * @param profile - The agent's derived profile.
+ * @param recentEvents - Recent execution events.
+ * @param patterns - Recent pattern discovery events.
+ * @returns A structured prompt string.
+ */
+declare function buildAgentSummaryPrompt(profile: AgentProfile, recentEvents: ExecutionEvent[], patterns: PatternEvent[]): string;
+/**
+ * Build a structured prompt for generating actionable fix recommendations.
+ *
+ * @param events - Recent failed execution events.
+ * @param profile - The agent's derived profile.
+ * @param patterns - Recent pattern discovery events.
+ * @returns A structured prompt string.
+ */
+declare function buildFixSuggestionPrompt(events: ExecutionEvent[], profile: AgentProfile, patterns: PatternEvent[]): string;
+
+/**
+ * Pure functions for building and formatting run receipts from execution graphs.
+ *
+ * A receipt is a structured summary of a completed (or running) agent execution,
+ * including per-step details, cost attribution, and aggregate counts.
+ * @module
+ */
+
+/**
+ * Walk an execution graph and produce a structured {@link RunReceipt}.
+ *
+ * Steps are sorted by `startTime`. Summary counts classify each node as
+ * succeeded (`completed`), failed (`failed | hung | timeout`), or skipped
+ * (none currently — reserved for future use). `attempted` equals the total
+ * node count.
+ *
+ * @param graph - A built (or snapshot) execution graph.
+ * @returns A frozen run receipt.
+ */
+declare function toReceipt(graph: ExecutionGraph): RunReceipt;
+/**
+ * Format a {@link RunReceipt} into a human-readable text block.
+ *
+ * Layout:
+ * ```
+ * === Run Receipt ===
+ * Run:      <runId>
+ * Agent:    <agentId>
+ * Status:   <status>
+ * Duration: <totalDurationMs>ms
+ *
+ * Summary: <attempted> attempted, <succeeded> succeeded, <failed> failed, <skipped> skipped
+ *
+ *  # | Step             | Type    | Status    | Duration | Tokens
+ * ---|------------------|---------|-----------|----------|-------
+ *  1 | fetch-data       | tool    | completed | 120ms    | 450
+ *  ...
+ *
+ * Total token cost: 1 250
+ * ```
+ *
+ * Shows `'---'` for missing duration and `'---'` for missing cost data per step.
+ * Shows `'no cost data'` for the totals line when no cost information is available.
+ *
+ * @param receipt - A run receipt produced by {@link toReceipt}.
+ * @returns Multi-line formatted string.
+ */
+declare function formatReceipt(receipt: RunReceipt): string;
+
 /**
  * CLI runner that wraps any command with automatic AgentFlow tracing.
  *
@@ -1382,6 +1554,41 @@ interface RunResult {
  */
 declare function runTraced(config: RunConfig): Promise<RunResult>;
 
+/**
+ * Soma-compatible event writer for AgentFlow.
+ *
+ * Converts AgentFlow events (ExecutionEvent, PatternEvent) into Markdown files
+ * with YAML frontmatter that Soma's Curator can ingest from its inbox directory.
+ *
+ * @module
+ */
+
+/**
+ * Configuration for the Soma event writer.
+ */
+interface SomaEventWriterConfig {
+    /** Directory to write event files to (Soma's inbox). Created if it does not exist. */
+    readonly inboxDir: string;
+}
+/**
+ * Create a Soma event writer that persists events as Curator-compatible Markdown files.
+ *
+ * Each event is written to `{type}-{agentId}-{compact-ISO-timestamp}.md` in the
+ * configured inbox directory. The Curator picks up these files on its 60-second cycle.
+ *
+ * @param config - Writer configuration with inbox directory path.
+ * @returns An EventWriter that writes Markdown files to the Soma inbox.
+ *
+ * @example
+ * ```ts
+ * const writer = createSomaEventWriter({ inboxDir: '~/.openclaw/workspace/inbox' });
+ * const emitter = createEventEmitter({ writers: [writer] });
+ * await emitter.emit(createExecutionEvent(graph));
+ * // Creates: ~/.openclaw/workspace/inbox/execution-alfred-20260314T083502.md
+ * ```
+ */
+declare function createSomaEventWriter(config: SomaEventWriterConfig): EventWriter;
+
 /**
  * JSON file-based trace storage for ExecutionGraphs.
  *
@@ -1530,4 +1737,4 @@ interface AlertPayload {
     readonly dirs: readonly string[];
 }
 
-export { type Adapter, type AgentFlowConfig, type AgentFlowEventType, type AgentProfile, type AlertCondition, type AlertPayload, type AnalysisFn, type Bottleneck, type ConformanceReport, type Deviation, type DeviationType, type DistributedTrace, type EdgeType, type EventEmitter, type EventEmitterConfig, type EventWriter, type ExecutionEdge, type ExecutionEvent, type ExecutionEventOptions, type ExecutionGraph, type ExecutionNode, type FailurePoint, type GraphBuilder, type GraphStats, type GraphStatus, type GuardConfig, type GuardViolation, type InsightEngine, type InsightEngineConfig, type InsightEvent, type InsightResult, type JsonEventWriterConfig, type KnowledgeStore, type KnowledgeStoreConfig, type MutableExecutionNode, type NodeStatus, type NodeType, type NotifyChannel, type OsProcess, type PatternEvent, type PidFileResult, type PolicySource, type PolicyThresholds, type ProcessAuditConfig, type ProcessAuditResult, type ProcessContext, type ProcessModel, type ProcessTransition, type RunConfig, type RunResult, type SemanticContext, type SomaEventWriterConfig, type StartNodeOptions, type SystemdUnitResult, type TraceEvent, type TraceEventType, type TraceStore, type Variant, type WatchConfig, type WorkerEntry, type WorkersResult, type Writer, auditProcesses, buildAgentSummaryPrompt, buildAnomalyExplanationPrompt, buildFailureAnalysisPrompt, buildFixSuggestionPrompt, checkConformance, checkGuards, createEventEmitter, createExecutionEvent, createGraphBuilder, createInsightEngine, createJsonEventWriter, createKnowledgeStore, createPatternEvent, createPolicySource, createSomaEventWriter, createTraceStore, discoverProcess, discoverProcessConfig, findVariants, findWaitingOn, formatAuditReport, getBottlenecks, getChildren, getCriticalPath, getDepth, getDuration, getFailures, getHungNodes, getNode, getParent, getPathSignature, getStats, getSubtree, getTraceTree, graphToJson, groupByTraceId, loadGraph, runTraced, startLive, startWatch, stitchTrace, toAsciiTree, toTimeline, withGuards };
+export { type Adapter, type AgentFlowConfig, type AgentFlowEventType, type AgentProfile, type AlertCondition, type AlertPayload, type AnalysisFn, type Bottleneck, type ConformanceHistory, type ConformanceHistoryEntry, type ConformanceReport, type DecisionTraceData, type Deviation, type DeviationType, type DistributedTrace, type DriftOptions, type DriftReport, type EdgeType, type EfficiencyFlag, type EfficiencyReport, type EventEmitter, type EventEmitterConfig, type EventWriter, type ExecutionEdge, type ExecutionEvent, type ExecutionEventOptions, type ExecutionGraph, type ExecutionNode, type FailurePoint, type GraphBuilder, type GraphStats, type GraphStatus, type GuardConfig, type GuardExplanation, type GuardViolation, type InsightEngine, type InsightEngineConfig, type InsightEvent, type InsightResult, type JsonEventWriterConfig, type KnowledgeStore, type KnowledgeStoreConfig, type MutableExecutionNode, type NodeCost, type NodeStatus, type NodeType, type NotifyChannel, type OsProcess, type OutcomeAssertion, type PatternEvent, type PidFileResult, type PolicySource, type PolicyThresholds, type ProcessAuditConfig, type ProcessAuditResult, type ProcessContext, type ProcessModel, type ProcessTransition, type RunConfig, type RunEfficiency, type RunReceipt, type RunResult, type SemanticContext, type SomaEventWriterConfig, type StartNodeOptions, type StepSummary, type SystemdUnitResult, type TraceEvent, type TraceEventType, type TraceStore, type Variant, type VariantOptions, type WatchConfig, type WorkerEntry, type WorkersResult, type Writer, auditProcesses, buildAgentSummaryPrompt, buildAnomalyExplanationPrompt, buildFailureAnalysisPrompt, buildFixSuggestionPrompt, checkConformance, checkGuards, createEventEmitter, createExecutionEvent, createGraphBuilder, createInsightEngine, createJsonEventWriter, createKnowledgeStore, createPatternEvent, createPolicySource, createSomaEventWriter, createTraceStore, discoverAllProcessConfigs, discoverProcess, discoverProcessConfig, findVariants, findWaitingOn, formatAuditReport, formatReceipt, getBottlenecks, getChildren, getCriticalPath, getDepth, getDuration, getFailures, getHungNodes, getNode, getParent, getPathSignature, getStats, getSubtree, getTraceTree, graphToJson, groupByTraceId, loadGraph, runTraced, startLive, startWatch, stitchTrace, toAsciiTree, toReceipt, toTimeline, withGuards };