@mingchuno/agent-workflows 0.1.0

package/examples/config.ts

@@ -0,0 +1,57 @@
+import { configSchema } from "@mingchuno/agent-workflows";
+
+/** Replace paths, repository, identity and model IDs with locally available values. */
+export const configuration = configSchema.parse({
+  id: "local",
+  stateDirectory: "/absolute/path/outside-the-checkout/agent-workflows-state",
+  projects: [
+    {
+      id: "application",
+      checkout: "/absolute/path/to/existing-checkout",
+      hosting: {
+        provider: "gitlab",
+        origin: "https://git.example.com/gitlab",
+        repository: "group/application",
+        tokenEnv: "GITLAB_TOKEN",
+      },
+      labels: ["ready-for-agent"],
+      baseBranch: "main",
+      branchTemplate: "agent/{issue}-{attempt}",
+      gitIdentity: { name: "Workflow Agent", email: "agent@example.com" },
+      agent: { provider: "codex" },
+      stages: {
+        implementation: {
+          prompt: "Implement the issue and follow repository guidance.",
+        },
+        writing: {
+          profile: { provider: "copilot" },
+          prompt:
+            "Write concise publication text from the diff and validation evidence.",
+        },
+        review: {
+          profile: { provider: "codex" },
+          prompt: "Review correctness and requirements independently.",
+        },
+      },
+      validation: [{ command: "pnpm", args: ["test"], timeoutMs: 300_000 }],
+    },
+  ],
+});
+
+// Explicit model selection is checked against provider capabilities before invocation.
+export const modelOverrides = {
+  implementation: {
+    provider: "codex" as const,
+    model: "YOUR_CODEX_MODEL",
+    reasoningEffort: "high",
+  },
+  writing: {
+    provider: "copilot" as const,
+    model: "YOUR_COPILOT_MODEL",
+    reasoningEffort: "low",
+    context: {
+      backgroundCompactionThreshold: 0.8,
+      bufferExhaustionThreshold: 0.95,
+    },
+  },
+};

package/examples/custom-workflow.ts

@@ -0,0 +1,32 @@
+import type { Operations } from "@mingchuno/agent-workflows";
+
+/** Ordinary TypeScript composition; provider adapters remain unchanged. */
+export async function reportingWorkflow(operations: Operations): Promise<void> {
+  if (!(await operations.eligible())) {
+    await operations.step("ineligible", async (run) => {
+      await operations.dependencies.store.patchRun(run.id, {
+        outcome: "ineligible",
+      });
+    });
+    return;
+  }
+  await operations.prepare();
+  await operations.implement();
+  if (!(await operations.validate())) {
+    await operations.complete("no-change");
+    return;
+  }
+  await operations.step("validation-report", async (run) => {
+    await operations.dependencies.store.emit(run.id, "validation-report", {
+      checks: run.validation ?? [],
+      changedPaths: run.snapshot?.paths ?? [],
+    });
+  });
+  await operations.writePublication();
+  await operations.commit();
+  await operations.push();
+  await operations.publish();
+  await operations.review();
+  await operations.publishReview();
+  await operations.complete();
+}

package/examples/observe.ts

@@ -0,0 +1,18 @@
+import { Store } from "@mingchuno/agent-workflows";
+
+export async function inspectRun(
+  databaseUrl: string,
+  runnerId: string,
+  runId: string,
+) {
+  const store = new Store(databaseUrl, runnerId);
+  try {
+    return {
+      run: await store.run(runId),
+      invocations: await store.invocations(runId),
+      events: (await store.events()).filter((event) => event.runId === runId),
+    };
+  } finally {
+    await store.close();
+  }
+}

package/examples/run.ts

@@ -0,0 +1,31 @@
+import { readFile } from "node:fs/promises";
+import {
+  configSchema,
+  createAgents,
+  createHosting,
+  Runner,
+} from "@mingchuno/agent-workflows";
+import { reportingWorkflow } from "./custom-workflow.js";
+
+const config = configSchema.parse(
+  JSON.parse(await readFile(process.argv[2] ?? "agent-workflows.json", "utf8")),
+);
+const databaseUrl = process.env[config.databaseUrlEnv];
+if (!databaseUrl) throw new Error(`Set ${config.databaseUrlEnv}`);
+const runner = new Runner({
+  config,
+  databaseUrl,
+  hosting: createHosting,
+  agents: createAgents(),
+  workflow: reportingWorkflow,
+  workflowVersion: "reporting-v1",
+});
+try {
+  await runner.start();
+  await new Promise<void>((resolve) => {
+    process.once("SIGINT", resolve);
+    process.once("SIGTERM", resolve);
+  });
+} finally {
+  await runner.shutdown();
+}

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@mingchuno/agent-workflows",
+  "version": "0.1.0",
+  "description": "Local durable coding workflows on DBOS",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mingchuno/agent-workflows.git"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "files": [
+    "dist/src",
+    "dist/drizzle",
+    "README.md",
+    "LICENCE",
+    "docs/*.md",
+    "examples"
+  ],
+  "engines": {
+    "node": ">=22.12"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    }
+  },
+  "bin": {
+    "agent-workflows": "./dist/src/cli.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && node scripts/copy-migrations.mjs",
+    "check": "tsc --noEmit",
+    "test": "pnpm build && node --test scripts/*.test.mjs && node scripts/test.mjs",
+    "verify": "pnpm check && pnpm lint && pnpm test",
+    "pack:smoke": "pnpm build && node scripts/test.mjs --pack-smoke",
+    "release:publish": "node scripts/publish.mjs",
+    "lint:pr": "node scripts/lint-pr-title.mjs",
+    "start": "tsx src/cli.ts",
+    "format": "biome format --write .",
+    "format:check": "biome format .",
+    "lint": "biome check .",
+    "db:generate": "drizzle-kit generate",
+    "db:migrate": "tsx src/db/migrate.ts"
+  },
+  "dependencies": {
+    "@dbos-inc/dbos-sdk": "^5.0.2",
+    "@gitbeaker/rest": "^43.8.0",
+    "@github/copilot-sdk": "^1.0.14",
+    "@octokit/rest": "^22.0.1",
+    "@openai/codex-sdk": "^0.155.1",
+    "@types/pg": "^8.23.1",
+    "commander": "^15.0.0",
+    "drizzle-orm": "0.45.2",
+    "ink": "^7.1.1",
+    "pg": "^8.23.0",
+    "pino": "^10.3.1",
+    "react": "^19.3.0",
+    "zod": "^4.6.5"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.5.14",
+    "@commitlint/cli": "21.2.2",
+    "@commitlint/config-conventional": "21.2.2",
+    "@types/node": "^26.6.2",
+    "@types/react": "^19.3.0",
+    "drizzle-kit": "0.31.10",
+    "ink-testing-library": "^4.0.0",
+    "npm": "12.0.2",
+    "tsx": "^4.23.13",
+    "typescript": "^7.0.2"
+  },
+  "packageManager": "pnpm@12.4.2"
+}