@sweny-ai/engine

Workflow engine for SWEny -- orchestrates Learn -> Act -> Report pipelines with pluggable providers.

Install

npm install @sweny-ai/engine @sweny-ai/providers

Quick Example

import { runWorkflow, createProviderRegistry } from "@sweny-ai/engine";
import { datadog } from "@sweny-ai/providers/observability";
import { linear } from "@sweny-ai/providers/issue-tracking";
import { github } from "@sweny-ai/providers/source-control";
import { slackWebhook } from "@sweny-ai/providers/notification";
import { claudeCode } from "@sweny-ai/providers/coding-agent";

// 1. Register providers
const providers = createProviderRegistry();
providers.set("observability", datadog({ apiKey, appKey }));
providers.set("issueTracker", linear({ apiKey }));
providers.set("sourceControl", github({ token, owner, repo }));
providers.set("notification", slackWebhook({ webhookUrl }));
providers.set("codingAgent", claudeCode({}));

// 2. Run a recipe
import { triageWorkflow } from "@sweny-ai/engine";

const result = await runWorkflow(triageWorkflow, triageConfig, providers);
console.log(result.status); // "completed" | "failed" | "partial"

Concepts

Workflow -- A pipeline of steps organized into three phases: Learn, Act, Report.

Step -- A single unit of work (e.g., "query logs", "create issue", "send notification").

Recipe -- A pre-built workflow. SWEny Triage is the first recipe.

ProviderRegistry -- A type-safe container for pluggable service integrations.

Built-in Recipes

| Recipe | Description | |--------|-------------| | Triage | Monitor observability logs -> investigate with AI -> create tickets -> open fix PRs -> notify |

Creating a Custom Workflow

import type { Workflow } from "@sweny-ai/engine";

const myWorkflow: Workflow<MyConfig> = {
  name: "my-workflow",
  phases: {
    learn: [
      { name: "fetch-data", phase: "learn", run: fetchData },
    ],
    act: [
      { name: "process", phase: "act", run: processData },
    ],
    report: [
      { name: "notify", phase: "report", run: sendReport },
    ],
  },
};

License

MIT