@backendkit-labs/orchestrator-agent 0.1.1

package/dist/static-flow.js

@@ -0,0 +1,82 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as yaml from 'yaml';
+import { z } from 'zod';
+// ── Schema ────────────────────────────────────────────────────────────────────
+const FlowStepSchema = z.object({
+    id: z.string(),
+    agent: z.string(),
+    task: z.string(),
+    depends_on: z.array(z.string()).default([]),
+    gate: z.boolean().optional(),
+    gate_criteria: z.array(z.string()).optional(),
+});
+const StaticFlowSchema = z.object({
+    version: z.number().default(1),
+    id: z.string(),
+    name: z.string(),
+    description: z.string().optional(),
+    steps: z.array(FlowStepSchema).min(1),
+});
+// ── Flow config entry (in orchestrator.yaml) ──────────────────────────────────
+export const FlowEntrySchema = z.object({
+    id: z.string(),
+    file: z.string(), // path relative to orchestrator.yaml
+    trigger: z.string().optional(), // regex to match task descriptions
+});
+// ── Loader ────────────────────────────────────────────────────────────────────
+export function loadFlow(flowPath) {
+    const resolved = path.resolve(flowPath);
+    if (!fs.existsSync(resolved)) {
+        throw new Error(`Flow file not found: ${resolved}`);
+    }
+    const raw = yaml.parse(fs.readFileSync(resolved, 'utf-8'));
+    const result = StaticFlowSchema.safeParse(raw);
+    if (!result.success) {
+        const issues = result.error.issues.map(i => `  ${i.path.join('.')}: ${i.message}`).join('\n');
+        throw new Error(`Invalid flow file ${path.basename(flowPath)}:\n${issues}`);
+    }
+    return result.data;
+}
+// ── Router ────────────────────────────────────────────────────────────────────
+/**
+ * Find the first flow whose trigger regex matches the task description.
+ * Returns null if no flow matches → fall back to TaskPlanner.
+ */
+export function matchFlow(entries, configDir, task) {
+    for (const entry of entries) {
+        if (!entry.trigger)
+            continue;
+        const regex = new RegExp(entry.trigger, 'i');
+        if (regex.test(task)) {
+            const flowPath = path.resolve(configDir, entry.file);
+            const flow = loadFlow(flowPath);
+            return { entry, flow };
+        }
+    }
+    return null;
+}
+// ── Converter ─────────────────────────────────────────────────────────────────
+/**
+ * Convert a static flow definition to a TaskPlan, interpolating
+ * {{payload.key}} placeholders with values from the provided payload.
+ */
+export function flowToTaskPlan(flow, payload = {}) {
+    const subtasks = flow.steps.map(step => ({
+        id: step.id,
+        agent_id: step.agent,
+        task: interpolate(step.task, payload),
+        depends_on: step.depends_on,
+        gate: step.gate,
+        gate_criteria: step.gate_criteria?.map(c => interpolate(c, payload)),
+    }));
+    return {
+        summary: interpolate(flow.name, payload),
+        subtasks,
+    };
+}
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function interpolate(template, payload) {
+    return template.replace(/\{\{payload\.(\w+)\}\}/g, (_, key) => payload[key] ?? `{{payload.${key}}}`);
+}
+//# sourceMappingURL=static-flow.js.map

package/dist/static-flow.js.map

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

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@backendkit-labs/orchestrator-agent",
+  "version": "0.1.1",
+  "description": "Config-driven orchestration agent — decomposes tasks and coordinates specialist agents via shared vault and configurable LLM providers.",
+  "type": "module",
+  "main": "dist/server.js",
+  "bin": {
+    "orchestrator-agent": "./dist/server.js"
+  },
+  "files": [
+    "dist/",
+    "AGENT.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BackendKit-labs/backendkit-agents.git",
+    "directory": "packages/orchestrator-agent"
+  },
+  "publishConfig": { "access": "public" },
+  "license": "MIT",
+  "engines": { "node": ">=20.0.0" },
+  "scripts": {
+    "build": "tsc --noCheck",
+    "start": "node dist/server.js",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@backendkit-labs/agent-core": "^0.22.2",
+    "@backendkit-labs/agent-enterprise": "^0.3.6",
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "openai": "^4.0.0",
+    "yaml": "^2.4.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.12",
+    "typescript": "^5.7.3"
+  }
+}