@devflow-tools/delivery-line 0.18.8

package/dist/subagents/orchestrator.js

@@ -0,0 +1,85 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { DeliveryLineError } from '../domain/types.js';
+import { validateAgentHandoff } from './handoff-validator.js';
+const defaultRoles = [
+    'clarifier', 'designer', 'planner', 'implementer', 'verifier', 'reviewer', 'release-preparer',
+].map(role => ({ role, agentId: `delivery-${role}`, agentVersion: 'v1', permissions: { readArtifacts: true } }));
+export class SubAgentOrchestrator {
+    port;
+    store;
+    roles = new Map(defaultRoles.map(role => [role.role, role]));
+    sessions = new Map();
+    handoffPayloads = new Map();
+    constructor(port, store) {
+        this.port = port;
+        this.store = store;
+    }
+    registerRole(definition) { this.roles.set(definition.role, { ...definition, permissions: structuredClone(definition.permissions) }); }
+    getRole(role) { const definition = this.roles.get(role); if (!definition)
+        throw new DeliveryLineError('UNAUTHORIZED_ROLE', `unknown agent role: ${role}`); return structuredClone(definition); }
+    async startSession(input) {
+        const role = this.getRole(input.role);
+        const session = { sessionId: input.sessionId ?? randomUUID(), caseId: input.caseId, role: role.role, agentId: role.agentId, agentVersion: role.agentVersion, permissionSnapshot: role.permissions, status: 'starting', processedUserEventIds: [], lastUserTurn: 0, budget: { ...input.budget, toolCalls: 0 }, createdAt: Date.now() };
+        if (this.sessions.has(session.sessionId))
+            return structuredClone(this.sessions.get(session.sessionId));
+        this.sessions.set(session.sessionId, session);
+        await this.port.start({ caseId: input.caseId, role: role.role, agentId: role.agentId, agentVersion: role.agentVersion, sessionId: session.sessionId, permissions: role.permissions, budget: session.budget });
+        session.status = 'running';
+        await this.store?.saveSubAgentSession?.(session);
+        return structuredClone(session);
+    }
+    async handoff(input, expected) {
+        validateAgentHandoff(input, expected);
+        const source = this.getRole(input.from.role);
+        const target = this.getRole(input.to.role);
+        if (source.agentId !== input.from.agentId || target.agentId !== input.to.agentId || (expected.agentVersions && (expected.agentVersions[input.from.role] !== input.from.version || expected.agentVersions[input.to.role] !== input.to.version)))
+            throw new DeliveryLineError('MISSING_PREREQUISITE', 'agent version is not registered');
+        const payloadHash = createHash('sha256').update(JSON.stringify(input)).digest('hex');
+        const prior = this.handoffPayloads.get(input.idempotencyKey);
+        if (prior && prior !== payloadHash)
+            throw new DeliveryLineError('IDEMPOTENCY_CONFLICT', input.idempotencyKey);
+        if (prior)
+            return { status: 'duplicate', idempotencyKey: input.idempotencyKey };
+        this.handoffPayloads.set(input.idempotencyKey, payloadHash);
+        return this.port.send(input);
+    }
+    async recoverSession(sessionId) {
+        const existing = this.sessions.get(sessionId) ?? (this.store?.getSubAgentSession ? await this.store.getSubAgentSession(sessionId).catch(() => undefined) : undefined);
+        const session = existing ?? await this.port.recover({ sessionId });
+        if (!session)
+            throw new DeliveryLineError('MISSING_PREREQUISITE', `session not found: ${sessionId}`);
+        if (!this.sessions.has(sessionId))
+            this.sessions.set(sessionId, structuredClone(session));
+        if (existing)
+            await this.port.recover({ sessionId, agentId: session.agentId, agentVersion: session.agentVersion, lastEventId: session.lastEventId, processedUserEventIds: session.processedUserEventIds });
+        return structuredClone(session);
+    }
+    async interrupt(sessionId) { const session = this.sessions.get(sessionId); if (session)
+        session.status = 'interrupted'; await this.port.interrupt({ sessionId }); }
+    recordEvent(sessionId, event) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            throw new DeliveryLineError('MISSING_PREREQUISITE', `session not found: ${sessionId}`);
+        session.lastEventId = event.id;
+        if (event.userEventId && !session.processedUserEventIds.includes(event.userEventId))
+            session.processedUserEventIds.push(event.userEventId);
+        if (event.toolCall)
+            session.budget.toolCalls += 1;
+        if (event.status)
+            session.status = event.status;
+        void this.store?.saveSubAgentSession?.(session);
+        return structuredClone(session);
+    }
+    recordUserEvent(sessionId, input) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            throw new DeliveryLineError('MISSING_PREREQUISITE', `session not found: ${sessionId}`);
+        if (session.processedUserEventIds.includes(input.eventId) || input.turn <= session.lastUserTurn)
+            throw new DeliveryLineError('STALE_INTERACTION_TURN', 'user event has already been processed');
+        session.processedUserEventIds.push(input.eventId);
+        session.lastUserTurn = input.turn;
+        void this.store?.saveSubAgentSession?.(session);
+        return structuredClone(session);
+    }
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/subagents/orchestrator.js.map

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

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@devflow-tools/delivery-line",
+  "version": "0.18.8",
+  "description": "Auditable, host-neutral delivery orchestration from requirements to verified integration artifacts.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shilongfeicool/dev-flow.git"
+  },
+  "homepage": "https://github.com/shilongfeicool/dev-flow#readme",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "test": "node ../../node_modules/.bin/vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo"
+  },
+  "devDependencies": {
+    "@types/node": "^26.0.1",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "dependencies": {
+    "@devflow-tools/sdk": "0.18.8",
+    "@devflow-tools/workflow-engine": "0.18.8"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "gitHead": "f0e905a514dd601c9cdcd759e23e568df3e21fef"
+}