@weavelogic/knowledge-graph-agent 0.2.0 → 0.3.0

package/dist/workflows/types.d.ts

@@ -0,0 +1,322 @@
+/**
+ * Workflow Types
+ *
+ * Type definitions for the workflow registry and execution system.
+ *
+ * @module workflows/types
+ */
+/**
+ * Workflow execution status
+ */
+export declare enum WorkflowStatus {
+    /** Workflow has not started */
+    Pending = "pending",
+    /** Workflow is currently running */
+    Running = "running",
+    /** Workflow completed successfully */
+    Completed = "completed",
+    /** Workflow failed with error */
+    Failed = "failed",
+    /** Workflow was cancelled */
+    Cancelled = "cancelled",
+    /** Workflow is paused */
+    Paused = "paused",
+    /** Workflow is waiting for dependencies */
+    Waiting = "waiting",
+    /** Workflow is rolling back due to failure */
+    RollingBack = "rolling-back",
+    /** Workflow rollback completed */
+    RolledBack = "rolled-back"
+}
+/**
+ * Step execution context passed to step handlers
+ */
+export interface StepContext {
+    /** Workflow ID */
+    workflowId: string;
+    /** Current step ID */
+    stepId: string;
+    /** Results from previous steps */
+    previousResults: Map<string, unknown>;
+    /** Shared workflow state */
+    state: Record<string, unknown>;
+    /** Logger function */
+    log: (message: string, data?: Record<string, unknown>) => void;
+    /** Abort signal for cancellation */
+    signal?: AbortSignal;
+}
+/**
+ * Step handler function type
+ */
+export type StepHandler<TInput = unknown, TOutput = unknown> = (input: TInput, context: StepContext) => Promise<TOutput>;
+/**
+ * Rollback handler function type
+ */
+export type RollbackHandler<TOutput = unknown> = (result: TOutput, context: StepContext) => Promise<void>;
+/**
+ * Workflow step definition
+ */
+export interface WorkflowStep<TInput = unknown, TOutput = unknown> {
+    /** Unique step identifier */
+    id: string;
+    /** Human-readable step name */
+    name: string;
+    /** Step description */
+    description?: string;
+    /** Step execution handler */
+    handler: StepHandler<TInput, TOutput>;
+    /** Rollback handler for failure recovery */
+    rollback?: RollbackHandler<TOutput>;
+    /** IDs of steps this step depends on */
+    dependencies?: string[];
+    /** Timeout in milliseconds */
+    timeout?: number;
+    /** Number of retry attempts */
+    retries?: number;
+    /** Retry delay in milliseconds */
+    retryDelay?: number;
+    /** Whether step can run in parallel with siblings */
+    parallel?: boolean;
+    /** Whether step is optional (failure won't stop workflow) */
+    optional?: boolean;
+    /** Condition function to determine if step should run */
+    condition?: (context: StepContext) => boolean | Promise<boolean>;
+    /** Input transformer */
+    transformInput?: (previousResults: Map<string, unknown>) => TInput;
+    /** Metadata for the step */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Workflow definition
+ */
+export interface WorkflowDefinition<TInput = unknown, TOutput = unknown> {
+    /** Unique workflow identifier */
+    id: string;
+    /** Workflow name */
+    name: string;
+    /** Workflow description */
+    description?: string;
+    /** Workflow version */
+    version: string;
+    /** Workflow steps */
+    steps: WorkflowStep[];
+    /** Default input for the workflow */
+    defaultInput?: TInput;
+    /** Initial state for the workflow */
+    initialState?: Record<string, unknown>;
+    /** Global timeout for entire workflow */
+    timeout?: number;
+    /** Whether to enable rollback on failure */
+    enableRollback?: boolean;
+    /** Handler called before workflow starts */
+    onStart?: (input: TInput, context: StepContext) => Promise<void>;
+    /** Handler called after workflow completes */
+    onComplete?: (result: TOutput, context: StepContext) => Promise<void>;
+    /** Handler called on workflow failure */
+    onError?: (error: Error, context: StepContext) => Promise<void>;
+    /** Output transformer */
+    transformOutput?: (results: Map<string, unknown>) => TOutput;
+    /** Workflow metadata */
+    metadata?: Record<string, unknown>;
+    /** Tags for categorization */
+    tags?: string[];
+}
+/**
+ * Step execution record
+ */
+export interface StepExecution {
+    /** Step ID */
+    stepId: string;
+    /** Step status */
+    status: WorkflowStatus;
+    /** Step result */
+    result?: unknown;
+    /** Error if failed */
+    error?: string;
+    /** Error stack trace */
+    errorStack?: string;
+    /** Start timestamp */
+    startedAt?: Date;
+    /** End timestamp */
+    completedAt?: Date;
+    /** Duration in milliseconds */
+    durationMs?: number;
+    /** Number of attempts */
+    attempts: number;
+    /** Whether step was skipped */
+    skipped?: boolean;
+    /** Skip reason */
+    skipReason?: string;
+}
+/**
+ * Workflow execution record
+ */
+export interface WorkflowExecution<TInput = unknown, TOutput = unknown> {
+    /** Unique execution ID */
+    id: string;
+    /** Workflow definition ID */
+    workflowId: string;
+    /** Execution status */
+    status: WorkflowStatus;
+    /** Input provided to workflow */
+    input: TInput;
+    /** Final output (if completed) */
+    output?: TOutput;
+    /** Shared workflow state */
+    state: Record<string, unknown>;
+    /** Step execution records */
+    steps: Map<string, StepExecution>;
+    /** Overall error (if failed) */
+    error?: string;
+    /** Error stack trace */
+    errorStack?: string;
+    /** Created timestamp */
+    createdAt: Date;
+    /** Started timestamp */
+    startedAt?: Date;
+    /** Completed timestamp */
+    completedAt?: Date;
+    /** Total duration in milliseconds */
+    durationMs?: number;
+    /** Execution metadata */
+    metadata?: Record<string, unknown>;
+    /** Progress percentage (0-100) */
+    progress: number;
+    /** Current step being executed */
+    currentStep?: string;
+    /** Whether rollback was performed */
+    rolledBack?: boolean;
+}
+/**
+ * Workflow execution result
+ */
+export interface WorkflowResult<TOutput = unknown> {
+    /** Whether workflow completed successfully */
+    success: boolean;
+    /** Execution ID */
+    executionId: string;
+    /** Workflow ID */
+    workflowId: string;
+    /** Final status */
+    status: WorkflowStatus;
+    /** Output result (if successful) */
+    output?: TOutput;
+    /** Error message (if failed) */
+    error?: string;
+    /** Error stack trace */
+    errorStack?: string;
+    /** Total duration in milliseconds */
+    durationMs: number;
+    /** Step results */
+    stepResults: Map<string, unknown>;
+    /** Step errors */
+    stepErrors: Map<string, string>;
+    /** Whether rollback was performed */
+    rolledBack: boolean;
+    /** Execution statistics */
+    stats: WorkflowExecutionStats;
+}
+/**
+ * Workflow execution statistics
+ */
+export interface WorkflowExecutionStats {
+    /** Total steps */
+    totalSteps: number;
+    /** Completed steps */
+    completedSteps: number;
+    /** Failed steps */
+    failedSteps: number;
+    /** Skipped steps */
+    skippedSteps: number;
+    /** Total retry attempts across all steps */
+    totalRetries: number;
+    /** Start time */
+    startTime: Date;
+    /** End time */
+    endTime: Date;
+    /** Total duration in milliseconds */
+    totalDurationMs: number;
+    /** Average step duration in milliseconds */
+    avgStepDurationMs: number;
+}
+/**
+ * Workflow registry options
+ */
+export interface WorkflowRegistryOptions {
+    /** Maximum concurrent workflow executions */
+    maxConcurrentExecutions?: number;
+    /** Default step timeout in milliseconds */
+    defaultStepTimeout?: number;
+    /** Default retry count */
+    defaultRetries?: number;
+    /** Default retry delay in milliseconds */
+    defaultRetryDelay?: number;
+    /** Whether to persist execution history */
+    persistHistory?: boolean;
+    /** Maximum history entries to keep */
+    maxHistoryEntries?: number;
+    /** Logger function */
+    logger?: (level: string, message: string, data?: Record<string, unknown>) => void;
+}
+/**
+ * Workflow list filter options
+ */
+export interface WorkflowListOptions {
+    /** Filter by tags */
+    tags?: string[];
+    /** Filter by version pattern */
+    version?: string;
+    /** Include only workflows matching name pattern */
+    namePattern?: string;
+    /** Limit results */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+}
+/**
+ * Execution history query options
+ */
+export interface ExecutionHistoryOptions {
+    /** Filter by workflow ID */
+    workflowId?: string;
+    /** Filter by status */
+    status?: WorkflowStatus;
+    /** Filter by start date (after) */
+    after?: Date;
+    /** Filter by start date (before) */
+    before?: Date;
+    /** Limit results */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+    /** Sort order */
+    sortOrder?: 'asc' | 'desc';
+}
+/**
+ * Workflow event types
+ */
+export type WorkflowEventType = 'workflow:started' | 'workflow:completed' | 'workflow:failed' | 'workflow:cancelled' | 'workflow:paused' | 'workflow:resumed' | 'step:started' | 'step:completed' | 'step:failed' | 'step:skipped' | 'step:retrying' | 'rollback:started' | 'rollback:completed' | 'rollback:failed';
+/**
+ * Workflow event
+ */
+export interface WorkflowEvent {
+    /** Event type */
+    type: WorkflowEventType;
+    /** Execution ID */
+    executionId: string;
+    /** Workflow ID */
+    workflowId: string;
+    /** Step ID (if step event) */
+    stepId?: string;
+    /** Event timestamp */
+    timestamp: Date;
+    /** Event data */
+    data?: Record<string, unknown>;
+    /** Error (if applicable) */
+    error?: string;
+}
+/**
+ * Workflow event listener
+ */
+export type WorkflowEventListener = (event: WorkflowEvent) => void | Promise<void>;
+//# sourceMappingURL=types.d.ts.map

package/dist/workflows/types.d.ts.map

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

package/dist/workflows/types.js

@@ -0,0 +1,16 @@
+var WorkflowStatus = /* @__PURE__ */ ((WorkflowStatus2) => {
+  WorkflowStatus2["Pending"] = "pending";
+  WorkflowStatus2["Running"] = "running";
+  WorkflowStatus2["Completed"] = "completed";
+  WorkflowStatus2["Failed"] = "failed";
+  WorkflowStatus2["Cancelled"] = "cancelled";
+  WorkflowStatus2["Paused"] = "paused";
+  WorkflowStatus2["Waiting"] = "waiting";
+  WorkflowStatus2["RollingBack"] = "rolling-back";
+  WorkflowStatus2["RolledBack"] = "rolled-back";
+  return WorkflowStatus2;
+})(WorkflowStatus || {});
+export {
+  WorkflowStatus
+};
+//# sourceMappingURL=types.js.map

package/dist/workflows/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sources":["../../src/workflows/types.ts"],"sourcesContent":["/**\n * Workflow Types\n *\n * Type definitions for the workflow registry and execution system.\n *\n * @module workflows/types\n */\n\n/**\n * Workflow execution status\n */\nexport enum WorkflowStatus {\n  /** Workflow has not started */\n  Pending = 'pending',\n  /** Workflow is currently running */\n  Running = 'running',\n  /** Workflow completed successfully */\n  Completed = 'completed',\n  /** Workflow failed with error */\n  Failed = 'failed',\n  /** Workflow was cancelled */\n  Cancelled = 'cancelled',\n  /** Workflow is paused */\n  Paused = 'paused',\n  /** Workflow is waiting for dependencies */\n  Waiting = 'waiting',\n  /** Workflow is rolling back due to failure */\n  RollingBack = 'rolling-back',\n  /** Workflow rollback completed */\n  RolledBack = 'rolled-back',\n}\n\n/**\n * Step execution context passed to step handlers\n */\nexport interface StepContext {\n  /** Workflow ID */\n  workflowId: string;\n  /** Current step ID */\n  stepId: string;\n  /** Results from previous steps */\n  previousResults: Map<string, unknown>;\n  /** Shared workflow state */\n  state: Record<string, unknown>;\n  /** Logger function */\n  log: (message: string, data?: Record<string, unknown>) => void;\n  /** Abort signal for cancellation */\n  signal?: AbortSignal;\n}\n\n/**\n * Step handler function type\n */\nexport type StepHandler<TInput = unknown, TOutput = unknown> = (\n  input: TInput,\n  context: StepContext\n) => Promise<TOutput>;\n\n/**\n * Rollback handler function type\n */\nexport type RollbackHandler<TOutput = unknown> = (\n  result: TOutput,\n  context: StepContext\n) => Promise<void>;\n\n/**\n * Workflow step definition\n */\nexport interface WorkflowStep<TInput = unknown, TOutput = unknown> {\n  /** Unique step identifier */\n  id: string;\n  /** Human-readable step name */\n  name: string;\n  /** Step description */\n  description?: string;\n  /** Step execution handler */\n  handler: StepHandler<TInput, TOutput>;\n  /** Rollback handler for failure recovery */\n  rollback?: RollbackHandler<TOutput>;\n  /** IDs of steps this step depends on */\n  dependencies?: string[];\n  /** Timeout in milliseconds */\n  timeout?: number;\n  /** Number of retry attempts */\n  retries?: number;\n  /** Retry delay in milliseconds */\n  retryDelay?: number;\n  /** Whether step can run in parallel with siblings */\n  parallel?: boolean;\n  /** Whether step is optional (failure won't stop workflow) */\n  optional?: boolean;\n  /** Condition function to determine if step should run */\n  condition?: (context: StepContext) => boolean | Promise<boolean>;\n  /** Input transformer */\n  transformInput?: (previousResults: Map<string, unknown>) => TInput;\n  /** Metadata for the step */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Workflow definition\n */\nexport interface WorkflowDefinition<TInput = unknown, TOutput = unknown> {\n  /** Unique workflow identifier */\n  id: string;\n  /** Workflow name */\n  name: string;\n  /** Workflow description */\n  description?: string;\n  /** Workflow version */\n  version: string;\n  /** Workflow steps */\n  steps: WorkflowStep[];\n  /** Default input for the workflow */\n  defaultInput?: TInput;\n  /** Initial state for the workflow */\n  initialState?: Record<string, unknown>;\n  /** Global timeout for entire workflow */\n  timeout?: number;\n  /** Whether to enable rollback on failure */\n  enableRollback?: boolean;\n  /** Handler called before workflow starts */\n  onStart?: (input: TInput, context: StepContext) => Promise<void>;\n  /** Handler called after workflow completes */\n  onComplete?: (result: TOutput, context: StepContext) => Promise<void>;\n  /** Handler called on workflow failure */\n  onError?: (error: Error, context: StepContext) => Promise<void>;\n  /** Output transformer */\n  transformOutput?: (results: Map<string, unknown>) => TOutput;\n  /** Workflow metadata */\n  metadata?: Record<string, unknown>;\n  /** Tags for categorization */\n  tags?: string[];\n}\n\n/**\n * Step execution record\n */\nexport interface StepExecution {\n  /** Step ID */\n  stepId: string;\n  /** Step status */\n  status: WorkflowStatus;\n  /** Step result */\n  result?: unknown;\n  /** Error if failed */\n  error?: string;\n  /** Error stack trace */\n  errorStack?: string;\n  /** Start timestamp */\n  startedAt?: Date;\n  /** End timestamp */\n  completedAt?: Date;\n  /** Duration in milliseconds */\n  durationMs?: number;\n  /** Number of attempts */\n  attempts: number;\n  /** Whether step was skipped */\n  skipped?: boolean;\n  /** Skip reason */\n  skipReason?: string;\n}\n\n/**\n * Workflow execution record\n */\nexport interface WorkflowExecution<TInput = unknown, TOutput = unknown> {\n  /** Unique execution ID */\n  id: string;\n  /** Workflow definition ID */\n  workflowId: string;\n  /** Execution status */\n  status: WorkflowStatus;\n  /** Input provided to workflow */\n  input: TInput;\n  /** Final output (if completed) */\n  output?: TOutput;\n  /** Shared workflow state */\n  state: Record<string, unknown>;\n  /** Step execution records */\n  steps: Map<string, StepExecution>;\n  /** Overall error (if failed) */\n  error?: string;\n  /** Error stack trace */\n  errorStack?: string;\n  /** Created timestamp */\n  createdAt: Date;\n  /** Started timestamp */\n  startedAt?: Date;\n  /** Completed timestamp */\n  completedAt?: Date;\n  /** Total duration in milliseconds */\n  durationMs?: number;\n  /** Execution metadata */\n  metadata?: Record<string, unknown>;\n  /** Progress percentage (0-100) */\n  progress: number;\n  /** Current step being executed */\n  currentStep?: string;\n  /** Whether rollback was performed */\n  rolledBack?: boolean;\n}\n\n/**\n * Workflow execution result\n */\nexport interface WorkflowResult<TOutput = unknown> {\n  /** Whether workflow completed successfully */\n  success: boolean;\n  /** Execution ID */\n  executionId: string;\n  /** Workflow ID */\n  workflowId: string;\n  /** Final status */\n  status: WorkflowStatus;\n  /** Output result (if successful) */\n  output?: TOutput;\n  /** Error message (if failed) */\n  error?: string;\n  /** Error stack trace */\n  errorStack?: string;\n  /** Total duration in milliseconds */\n  durationMs: number;\n  /** Step results */\n  stepResults: Map<string, unknown>;\n  /** Step errors */\n  stepErrors: Map<string, string>;\n  /** Whether rollback was performed */\n  rolledBack: boolean;\n  /** Execution statistics */\n  stats: WorkflowExecutionStats;\n}\n\n/**\n * Workflow execution statistics\n */\nexport interface WorkflowExecutionStats {\n  /** Total steps */\n  totalSteps: number;\n  /** Completed steps */\n  completedSteps: number;\n  /** Failed steps */\n  failedSteps: number;\n  /** Skipped steps */\n  skippedSteps: number;\n  /** Total retry attempts across all steps */\n  totalRetries: number;\n  /** Start time */\n  startTime: Date;\n  /** End time */\n  endTime: Date;\n  /** Total duration in milliseconds */\n  totalDurationMs: number;\n  /** Average step duration in milliseconds */\n  avgStepDurationMs: number;\n}\n\n/**\n * Workflow registry options\n */\nexport interface WorkflowRegistryOptions {\n  /** Maximum concurrent workflow executions */\n  maxConcurrentExecutions?: number;\n  /** Default step timeout in milliseconds */\n  defaultStepTimeout?: number;\n  /** Default retry count */\n  defaultRetries?: number;\n  /** Default retry delay in milliseconds */\n  defaultRetryDelay?: number;\n  /** Whether to persist execution history */\n  persistHistory?: boolean;\n  /** Maximum history entries to keep */\n  maxHistoryEntries?: number;\n  /** Logger function */\n  logger?: (level: string, message: string, data?: Record<string, unknown>) => void;\n}\n\n/**\n * Workflow list filter options\n */\nexport interface WorkflowListOptions {\n  /** Filter by tags */\n  tags?: string[];\n  /** Filter by version pattern */\n  version?: string;\n  /** Include only workflows matching name pattern */\n  namePattern?: string;\n  /** Limit results */\n  limit?: number;\n  /** Offset for pagination */\n  offset?: number;\n}\n\n/**\n * Execution history query options\n */\nexport interface ExecutionHistoryOptions {\n  /** Filter by workflow ID */\n  workflowId?: string;\n  /** Filter by status */\n  status?: WorkflowStatus;\n  /** Filter by start date (after) */\n  after?: Date;\n  /** Filter by start date (before) */\n  before?: Date;\n  /** Limit results */\n  limit?: number;\n  /** Offset for pagination */\n  offset?: number;\n  /** Sort order */\n  sortOrder?: 'asc' | 'desc';\n}\n\n/**\n * Workflow event types\n */\nexport type WorkflowEventType =\n  | 'workflow:started'\n  | 'workflow:completed'\n  | 'workflow:failed'\n  | 'workflow:cancelled'\n  | 'workflow:paused'\n  | 'workflow:resumed'\n  | 'step:started'\n  | 'step:completed'\n  | 'step:failed'\n  | 'step:skipped'\n  | 'step:retrying'\n  | 'rollback:started'\n  | 'rollback:completed'\n  | 'rollback:failed';\n\n/**\n * Workflow event\n */\nexport interface WorkflowEvent {\n  /** Event type */\n  type: WorkflowEventType;\n  /** Execution ID */\n  executionId: string;\n  /** Workflow ID */\n  workflowId: string;\n  /** Step ID (if step event) */\n  stepId?: string;\n  /** Event timestamp */\n  timestamp: Date;\n  /** Event data */\n  data?: Record<string, unknown>;\n  /** Error (if applicable) */\n  error?: string;\n}\n\n/**\n * Workflow event listener\n */\nexport type WorkflowEventListener = (event: WorkflowEvent) => void | Promise<void>;\n"],"names":["WorkflowStatus"],"mappings":"AAWO,IAAK,mCAAAA,oBAAL;AAELA,kBAAA,SAAA,IAAU;AAEVA,kBAAA,SAAA,IAAU;AAEVA,kBAAA,WAAA,IAAY;AAEZA,kBAAA,QAAA,IAAS;AAETA,kBAAA,WAAA,IAAY;AAEZA,kBAAA,QAAA,IAAS;AAETA,kBAAA,SAAA,IAAU;AAEVA,kBAAA,aAAA,IAAc;AAEdA,kBAAA,YAAA,IAAa;AAlBH,SAAAA;AAAA,GAAA,kBAAA,CAAA,CAAA;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weavelogic/knowledge-graph-agent",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Knowledge graph agent for Claude Code - generates knowledge graphs, initializes docs, and integrates with claude-flow",
   "type": "module",
   "main": "dist/index.js",