agentflow-core 0.2.2 → 0.3.0

package/dist/index.d.cts

@@ -393,8 +393,72 @@ declare function runTraced(config: RunConfig): Promise<RunResult>;
  *
  * @module
  */
+
 declare function startLive(argv: string[]): void;
 
+/**
+ * AgentFlow Watch — headless alert system for agent infrastructure.
+ *
+ * Polls directories for JSON/JSONL state files, detects status transitions
+ * (ok→error, stale, recovery), and sends alerts via Telegram, webhooks,
+ * shell commands, or stdout.
+ *
+ * @module
+ */
+declare function startWatch(argv: string[]): void;
+
+/**
+ * Type definitions for the `agentflow watch` alert system.
+ * @module
+ */
+/** Alert condition parsed from --alert-on flags. */
+type AlertCondition = {
+    readonly type: 'error';
+} | {
+    readonly type: 'stale';
+    readonly durationMs: number;
+} | {
+    readonly type: 'recovery';
+} | {
+    readonly type: 'consecutive-errors';
+    readonly threshold: number;
+};
+/** Notification channel parsed from --notify flags. */
+type NotifyChannel = {
+    readonly type: 'stdout';
+} | {
+    readonly type: 'telegram';
+    readonly botToken: string;
+    readonly chatId: string;
+} | {
+    readonly type: 'webhook';
+    readonly url: string;
+} | {
+    readonly type: 'command';
+    readonly cmd: string;
+};
+/** Configuration for the watch command. */
+interface WatchConfig {
+    readonly dirs: string[];
+    readonly recursive: boolean;
+    readonly pollIntervalMs: number;
+    readonly alertConditions: AlertCondition[];
+    readonly notifyChannels: NotifyChannel[];
+    readonly stateFilePath: string;
+    readonly cooldownMs: number;
+}
+/** Alert payload passed to notification channels. */
+interface AlertPayload {
+    readonly agentId: string;
+    readonly condition: string;
+    readonly previousStatus: string;
+    readonly currentStatus: string;
+    readonly detail: string;
+    readonly file: string;
+    readonly timestamp: number;
+    readonly dirs: readonly string[];
+}
+
 declare function groupByTraceId(graphs: ExecutionGraph[]): Map<string, ExecutionGraph[]>;
 declare function stitchTrace(graphs: ExecutionGraph[]): DistributedTrace;
 declare function getTraceTree(trace: DistributedTrace): ExecutionGraph[];
@@ -515,4 +579,4 @@ declare function getDepth(graph: ExecutionGraph): number;
  */
 declare function getStats(graph: ExecutionGraph): GraphStats;
 
-export { type Adapter, type AgentFlowConfig, type DistributedTrace, type EdgeType, type ExecutionEdge, type ExecutionGraph, type ExecutionNode, type GraphBuilder, type GraphStats, type GraphStatus, type MutableExecutionNode, type NodeStatus, type NodeType, type RunConfig, type RunResult, type StartNodeOptions, type TraceEvent, type TraceEventType, type Writer, createGraphBuilder, findWaitingOn, getChildren, getCriticalPath, getDepth, getDuration, getFailures, getHungNodes, getNode, getParent, getStats, getSubtree, getTraceTree, graphToJson, groupByTraceId, loadGraph, runTraced, startLive, stitchTrace };
+export { type Adapter, type AgentFlowConfig, type AlertCondition, type AlertPayload, type DistributedTrace, type EdgeType, type ExecutionEdge, type ExecutionGraph, type ExecutionNode, type GraphBuilder, type GraphStats, type GraphStatus, type MutableExecutionNode, type NodeStatus, type NodeType, type NotifyChannel, type RunConfig, type RunResult, type StartNodeOptions, type TraceEvent, type TraceEventType, type WatchConfig, type Writer, createGraphBuilder, findWaitingOn, getChildren, getCriticalPath, getDepth, getDuration, getFailures, getHungNodes, getNode, getParent, getStats, getSubtree, getTraceTree, graphToJson, groupByTraceId, loadGraph, runTraced, startLive, startWatch, stitchTrace };

package/dist/index.d.ts

@@ -393,8 +393,72 @@ declare function runTraced(config: RunConfig): Promise<RunResult>;
  *
  * @module
  */
+
 declare function startLive(argv: string[]): void;
 
+/**
+ * AgentFlow Watch — headless alert system for agent infrastructure.
+ *
+ * Polls directories for JSON/JSONL state files, detects status transitions
+ * (ok→error, stale, recovery), and sends alerts via Telegram, webhooks,
+ * shell commands, or stdout.
+ *
+ * @module
+ */
+declare function startWatch(argv: string[]): void;
+
+/**
+ * Type definitions for the `agentflow watch` alert system.
+ * @module
+ */
+/** Alert condition parsed from --alert-on flags. */
+type AlertCondition = {
+    readonly type: 'error';
+} | {
+    readonly type: 'stale';
+    readonly durationMs: number;
+} | {
+    readonly type: 'recovery';
+} | {
+    readonly type: 'consecutive-errors';
+    readonly threshold: number;
+};
+/** Notification channel parsed from --notify flags. */
+type NotifyChannel = {
+    readonly type: 'stdout';
+} | {
+    readonly type: 'telegram';
+    readonly botToken: string;
+    readonly chatId: string;
+} | {
+    readonly type: 'webhook';
+    readonly url: string;
+} | {
+    readonly type: 'command';
+    readonly cmd: string;
+};
+/** Configuration for the watch command. */
+interface WatchConfig {
+    readonly dirs: string[];
+    readonly recursive: boolean;
+    readonly pollIntervalMs: number;
+    readonly alertConditions: AlertCondition[];
+    readonly notifyChannels: NotifyChannel[];
+    readonly stateFilePath: string;
+    readonly cooldownMs: number;
+}
+/** Alert payload passed to notification channels. */
+interface AlertPayload {
+    readonly agentId: string;
+    readonly condition: string;
+    readonly previousStatus: string;
+    readonly currentStatus: string;
+    readonly detail: string;
+    readonly file: string;
+    readonly timestamp: number;
+    readonly dirs: readonly string[];
+}
+
 declare function groupByTraceId(graphs: ExecutionGraph[]): Map<string, ExecutionGraph[]>;
 declare function stitchTrace(graphs: ExecutionGraph[]): DistributedTrace;
 declare function getTraceTree(trace: DistributedTrace): ExecutionGraph[];
@@ -515,4 +579,4 @@ declare function getDepth(graph: ExecutionGraph): number;
  */
 declare function getStats(graph: ExecutionGraph): GraphStats;
 
-export { type Adapter, type AgentFlowConfig, type DistributedTrace, type EdgeType, type ExecutionEdge, type ExecutionGraph, type ExecutionNode, type GraphBuilder, type GraphStats, type GraphStatus, type MutableExecutionNode, type NodeStatus, type NodeType, type RunConfig, type RunResult, type StartNodeOptions, type TraceEvent, type TraceEventType, type Writer, createGraphBuilder, findWaitingOn, getChildren, getCriticalPath, getDepth, getDuration, getFailures, getHungNodes, getNode, getParent, getStats, getSubtree, getTraceTree, graphToJson, groupByTraceId, loadGraph, runTraced, startLive, stitchTrace };
+export { type Adapter, type AgentFlowConfig, type AlertCondition, type AlertPayload, type DistributedTrace, type EdgeType, type ExecutionEdge, type ExecutionGraph, type ExecutionNode, type GraphBuilder, type GraphStats, type GraphStatus, type MutableExecutionNode, type NodeStatus, type NodeType, type NotifyChannel, type RunConfig, type RunResult, type StartNodeOptions, type TraceEvent, type TraceEventType, type WatchConfig, type Writer, createGraphBuilder, findWaitingOn, getChildren, getCriticalPath, getDepth, getDuration, getFailures, getHungNodes, getNode, getParent, getStats, getSubtree, getTraceTree, graphToJson, groupByTraceId, loadGraph, runTraced, startLive, startWatch, stitchTrace };

package/dist/index.js

@@ -17,8 +17,9 @@ import {
   loadGraph,
   runTraced,
   startLive,
+  startWatch,
   stitchTrace
-} from "./chunk-WOJEID7V.js";
+} from "./chunk-NPH34CAL.js";
 export {
   createGraphBuilder,
   findWaitingOn,
@@ -38,5 +39,6 @@ export {
   loadGraph,
   runTraced,
   startLive,
+  startWatch,
   stitchTrace
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentflow-core",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "Universal execution tracing for AI agent systems",
   "type": "module",
   "main": "./dist/index.cjs",