@sidebutton/core

Core workflow automation engine for AI agents — agentic workflows in YAML

Source

npm

Version: 1.5.6

Version published: 2 weeks ago

Weekly downloads: 85

Maintainers: 2

Weekly downloads

Created: 8 months ago

Source

@sidebutton/core

Core workflow engine for SideButton - YAML-based browser and shell automation.

Installation

npm install @sidebutton/core

Overview

This package provides the core workflow engine used by SideButton:

Workflow Types - TypeScript definitions for workflows, steps, and execution context
YAML Parser - Load and validate workflow definitions from YAML files
Step Executors - Execute 20+ step types (browser, shell, LLM, control flow)
Variable Interpolation - {{variable}} syntax for dynamic values

Usage

import { parseWorkflow, executeWorkflow } from '@sidebutton/core';

// Parse a workflow from YAML
const workflow = parseWorkflow(`
  id: hello_world
  title: Hello World
  steps:
    - type: shell.run
      cmd: echo "Hello from SideButton!"
`);

// Execute the workflow
const result = await executeWorkflow(workflow, context);

Step Types

Category	Steps
Browser	`navigate`, `click`, `type`, `scroll`, `hover`, `wait`, `extract`, `extractAll`, `exists`, `key`
Shell	`shell.run`, `terminal.open`, `terminal.run`
LLM	`llm.classify`, `llm.generate`
Control	`control.if`, `control.retry`, `control.stop`, `workflow.call`
Data	`data.first`