stageflow 0.23.0 → 0.25.0

package/dist/runtime/runManager.js

@@ -1,4 +1,5 @@
 import { randomUUID } from "node:crypto";
+import { RunSubmissionExistsError } from "../runstore/submission.js";
 import { readFile, realpath } from "node:fs/promises";
 import path from "node:path";
 import { findProjectRoot } from "../project/findProjectRoot.js";
@@ -22,6 +23,12 @@ import { resumeSessionFilePath } from "./stageAttemptContext.js";
 import { resolveStartTaskInput } from "./taskInput.js";
 import { failStageAsInterrupted, syncRunStatusFromStages, } from "./stageRecovery.js";
 import { blocksGenericRetry, manualRecoveryEligibility, readManualRecoveryState, } from "./manualRecoveryState.js";
+function existingSubmissionResult(existing, request) {
+    if (existing.requestHash !== request.requestHash) {
+        return { ok: false, status: 409, reason: "Submission key was already used for different input" };
+    }
+    return { ok: true, runId: existing.runId, reused: true };
+}
 const DEFAULT_MAX_CONCURRENT = 3;
 const STARTUP_RECONCILE_REASON = "process_interrupted: no active worker (server restart)";
 const OPERATOR_ABANDON_REASON = "process_interrupted: operator abandoned stage";
@@ -45,6 +52,7 @@ async function toCheckoutLeaseKey(absPath) {
 }
 export class RunManager {
     options;
+    submissionsInFlight = new Map();
     active = new Map();
     checkoutLeases = new Map();
     provisionalIds = new Set();
@@ -348,7 +356,42 @@ export class RunManager {
         }
         return { ok: true, runId, stageId };
     }
-    async startRun(input) {
+    async startRunOnce(input, submission) {
+        if (!submission.key.trim() || submission.key.length > 256 || !/^[a-f0-9]{64}$/.test(submission.requestHash)) {
+            return { ok: false, status: 400, reason: "Submission requires a key and SHA-256 request hash" };
+        }
+        const pending = this.submissionsInFlight.get(submission.key);
+        if (pending) {
+            if (pending.requestHash !== submission.requestHash) {
+                return { ok: false, status: 409, reason: "Submission key was already used for different input" };
+            }
+            const result = await pending.result;
+            return result.ok ? { ...result, reused: true } : result;
+        }
+        const result = this.startSubmittedRun(input, submission);
+        this.submissionsInFlight.set(submission.key, { requestHash: submission.requestHash, result });
+        try {
+            return await result;
+        }
+        finally {
+            this.submissionsInFlight.delete(submission.key);
+        }
+    }
+    async startSubmittedRun(input, submission) {
+        const existing = await this.options.store.getRunBySubmission(submission.key);
+        if (existing)
+            return existingSubmissionResult(existing, submission);
+        try {
+            const result = await this.startRun(input, submission);
+            return result.ok ? { ok: true, runId: result.runId, reused: false, done: result.done } : result;
+        }
+        catch (error) {
+            if (error instanceof RunSubmissionExistsError)
+                return existingSubmissionResult(error.submission, submission);
+            throw error;
+        }
+    }
+    async startRun(input, submission) {
         const cwd = this.options.cwd ?? process.cwd();
         // An inline pipeline has no filesystem anchor to derive a project root from.
         const derivedProjectRoot = typeof input.pipeline === "string"
@@ -389,7 +432,7 @@ export class RunManager {
             gitSha: input.gitSha,
             ciPrUrl: input.ciPrUrl,
             ciJobUrl: input.ciJobUrl,
-        }, derivedProjectRoot, resolved.kind === "path" ? resolved.taskPath : undefined);
+        }, derivedProjectRoot, resolved.kind === "path" ? resolved.taskPath : undefined, submission);
     }
     async rerun(runId) {
         const cwd = this.options.cwd ?? process.cwd();
@@ -1156,7 +1199,7 @@ export class RunManager {
             this.attachedWaiting.delete(`${runId}\0${stageId}`);
         }
     }
-    async reserveAndStartPipeline(taskYaml, pipeline, taskLabel, cwd, checkoutOverride, skipGates, ciIdentity, projectRoot, taskPath) {
+    async reserveAndStartPipeline(taskYaml, pipeline, taskLabel, cwd, checkoutOverride, skipGates, ciIdentity, projectRoot, taskPath, submission) {
         let checkoutKey;
         try {
             const task = loadTaskFromYaml(taskYaml, taskLabel);
@@ -1178,6 +1221,7 @@ export class RunManager {
             return reserved.failure;
         try {
             const started = await startPipeline({
+                submission,
                 agent: this.options.agent,
                 store: this.options.store,
                 taskYaml,
@@ -1201,7 +1245,7 @@ export class RunManager {
         }
         catch (err) {
             this.clearReservation(reserved.provisionalId);
-            if (err instanceof PipelineValidationError) {
+            if (err instanceof PipelineValidationError || err instanceof RunSubmissionExistsError) {
                 throw err;
             }
             return {

package/dist/server/bootstrap.d.ts

@@ -1,3 +1,4 @@
+import { type A2aHost } from "../a2a/server.js";
 import type { AgentPort } from "../agent/port.js";
 import type { ProviderAuthContext } from "../agent/providerAuth.js";
 import { type RunStoreKind } from "../runstore/createStore.js";
@@ -18,6 +19,7 @@ export type StageflowHostOptions = {
     runChangeBus?: RunChangeBus;
 };
 export type StageflowHostBootstrap = {
+    a2a?: A2aHost;
     cwd: string;
     agentDir: string;
     rootDir: string;

package/dist/server/bootstrap.js

@@ -1,5 +1,7 @@
 import { getAgentDir } from "@earendil-works/pi-coding-agent";
-import { createRunStore } from "../runstore/createStore.js";
+import { createA2aHost } from "../a2a/server.js";
+import { createRunStoreWithConnection } from "../runstore/createStore.js";
+import { resolveA2aConfigPath } from "../a2a/configDiscovery.js";
 import { resolveStageflowContext } from "../project/resolveStageflowContext.js";
 import { findProjectRoot } from "../project/findProjectRoot.js";
 import { RunManager } from "../runtime/runManager.js";
@@ -14,8 +16,16 @@ export async function bootstrapStageflowHost(options) {
     const isGitProject = options.rootDir !== undefined
         ? findProjectRoot(rootDir) !== null
         : ctx.isGitProject;
-    const rawStore = options.store ??
-        createRunStore({ rootDir: ctx.globalHome, kind: options.storeKind });
+    let rawStore;
+    let sqliteConnection;
+    if (options.store) {
+        rawStore = options.store;
+    }
+    else {
+        const created = createRunStoreWithConnection({ rootDir: ctx.globalHome, kind: options.storeKind });
+        rawStore = created.store;
+        sqliteConnection = created.connection;
+    }
     const boundBus = isRunStoreWrapped(rawStore)
         ? getRunChangeBusFromWrappedStore(rawStore)
         : undefined;
@@ -50,6 +60,7 @@ export async function bootstrapStageflowHost(options) {
         projectRoot: rootDir,
     }, { mcpStateless });
     return {
+        a2a: await createA2aHost({ manager, runStore: store, rootDir, connection: sqliteConnection }, resolveA2aConfigPath(rootDir)),
         cwd,
         agentDir,
         rootDir,

package/dist/server/createHttpHost.js

@@ -17,6 +17,12 @@ export async function createHttpHost(options) {
         const method = req.method ?? "GET";
         const url = new URL(req.url ?? "/", `http://${host}:${port}`);
         const pathname = url.pathname;
+        if (pathname === "/api/a2a/status" && method === "GET") {
+            json(res, 200, boot.a2a?.status ?? { state: "disabled" });
+            return;
+        }
+        if (await boot.a2a?.handle(req, res, pathname))
+            return;
         if (pathname === "/mcp") {
             if (!validateMcpHost(req, res) || !validateMcpOrigin(req, res)) {
                 return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stageflow",
-  "version": "0.23.0",
+  "version": "0.25.0",
   "description": "Stageflow — CLI pipeline runtime for configurable stages on Pi",
   "type": "module",
   "bin": {
@@ -61,6 +61,7 @@
     "vitest": "^4.1.10"
   },
   "dependencies": {
+    "@a2a-js/sdk": "1.1.0",
     "@anthropic-ai/claude-agent-sdk": "^0.3.263",
     "@earendil-works/pi-ai": "^0.84.1",
     "@earendil-works/pi-coding-agent": "^0.84.1",