@kernel.chat/kbot 2.22.3 → 2.23.0

package/dist/workflows.d.ts

@@ -0,0 +1,92 @@
+import { type AgentOptions } from './agent.js';
+export interface WorkflowNode {
+    id: string;
+    type: 'agent' | 'tool' | 'condition' | 'parallel' | 'human';
+    agent?: string;
+    tool?: string;
+    prompt?: string;
+    condition?: string;
+    children?: string[];
+    retryOnFail?: boolean;
+    maxRetries?: number;
+}
+export interface WorkflowEdge {
+    from: string;
+    to: string;
+    label?: string;
+}
+export interface Workflow {
+    id: string;
+    name: string;
+    description: string;
+    version: string;
+    author: string;
+    nodes: WorkflowNode[];
+    edges: WorkflowEdge[];
+    variables: Record<string, string>;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface WorkflowRun {
+    workflowId: string;
+    status: 'running' | 'completed' | 'failed' | 'paused';
+    currentNode: string;
+    results: Record<string, string>;
+    startedAt: string;
+    completedAt?: string;
+}
+/**
+ * Create an empty workflow with the given name and description.
+ */
+export declare function createWorkflow(name: string, description: string): Workflow;
+/**
+ * Add a node to a workflow. Returns the mutated workflow.
+ */
+export declare function addNode(workflow: Workflow, node: WorkflowNode): Workflow;
+/**
+ * Connect two nodes with a directed edge. Returns the mutated workflow.
+ */
+export declare function addEdge(workflow: Workflow, from: string, to: string, label?: string): Workflow;
+/**
+ * Save a workflow to ~/.kbot/workflows/<id>.json
+ */
+export declare function saveWorkflow(workflow: Workflow): Promise<string>;
+/**
+ * Load a workflow from disk by ID.
+ */
+export declare function loadWorkflow(id: string): Promise<Workflow>;
+/**
+ * List all saved workflows.
+ */
+export declare function listWorkflows(): Promise<Array<{
+    id: string;
+    name: string;
+    description: string;
+    updatedAt: string;
+}>>;
+/**
+ * Export a workflow as shareable JSON string.
+ */
+export declare function exportWorkflow(workflow: Workflow): string;
+/**
+ * Execute a complete workflow through kbot's agent system.
+ *
+ * Walks the topologically-sorted node list. Parallel nodes execute their
+ * children concurrently. Condition nodes branch based on expression evaluation.
+ * Human nodes pause for user input.
+ */
+export declare function executeWorkflow(workflow: Workflow, agentOpts: AgentOptions, variables?: Record<string, string>): Promise<WorkflowRun>;
+/**
+ * Convert kbot planner output (array of step descriptions) into a workflow graph.
+ * Creates a linear chain of agent nodes with edges between sequential steps.
+ */
+export declare function planToWorkflow(planSteps: string[], name?: string): Workflow;
+/**
+ * Export a workflow as a Mermaid diagram syntax for visualization.
+ */
+export declare function toMermaid(workflow: Workflow): string;
+/**
+ * Register workflow management tools for agent access.
+ */
+export declare function registerWorkflowTools(): void;
+//# sourceMappingURL=workflows.d.ts.map

package/dist/workflows.d.ts.map

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