@martinloop/mcp 0.7.1 → 0.8.1

package/dist/vendor/core/swarm/candidates.d.ts

@@ -0,0 +1,78 @@
+import { type ReceiptIntegritySummary, type SwarmCandidate, type SwarmPatchAdmission, type SwarmRunRecord } from "../../contracts/index.js";
+import type { SwarmWorkspaceRuntimeHandle } from "./workspaces.js";
+export interface SwarmCandidateGitCommand {
+    readonly cwd: string;
+    readonly args: readonly string[];
+}
+export interface SwarmCandidateGitResult {
+    readonly stdout: Buffer;
+    readonly stderr: Buffer;
+}
+export type SwarmCandidateGitRunner = (command: SwarmCandidateGitCommand) => Promise<SwarmCandidateGitResult>;
+export interface PersistedSwarmCandidateArtifact {
+    readonly candidate: SwarmCandidate;
+    readonly attemptId: string;
+    readonly proposalId: string;
+    readonly identitySha256: string;
+    readonly candidateTreeHash: string;
+    readonly patch: Buffer;
+    readonly manifest: Buffer;
+    readonly manifestSha256: string;
+    readonly receiptIntegrity: ReceiptIntegritySummary;
+}
+export interface SwarmProcessClosureEvidence {
+    readonly swarmId: string;
+    readonly workspaceId: string;
+    readonly childRunId: string;
+    readonly agentId: string;
+    readonly state: "closed";
+    readonly completedAt: string;
+}
+/**
+ * Implementations must durably and atomically reject duplicate candidate IDs.
+ * The caller does not receive cleanup authority until both operations resolve.
+ */
+export interface SwarmCandidateArtifactWriter {
+    loadProcessClosure(childRunId: string): Promise<SwarmProcessClosureEvidence | undefined>;
+    persistCandidate(artifact: PersistedSwarmCandidateArtifact): Promise<void>;
+    persistDecision(decision: SwarmPatchAdmission): Promise<void>;
+}
+export interface CaptureSwarmCandidateInput {
+    readonly swarmRecord: SwarmRunRecord;
+    readonly canonicalRoot: string;
+    readonly swarmId: string;
+    readonly candidateId: string;
+    readonly admissionId: string;
+    readonly attemptId: string;
+    readonly proposalId: string;
+    readonly childRunId: string;
+    readonly agentId: string;
+    readonly taskIds: readonly string[];
+    readonly expectedBaselineCommit: string;
+    readonly workspace: SwarmWorkspaceRuntimeHandle;
+    readonly childState: "verified" | "stopped" | "needs_review" | "running" | "queued";
+    readonly declaredPaths: readonly string[];
+    readonly childAllowedPaths: readonly string[];
+    readonly inheritedDeniedPaths: readonly string[];
+    readonly taskWriteScope: readonly string[];
+    readonly runsRoot: string;
+    readonly loopRecordPath: string;
+    readonly ledgerPath: string;
+    readonly artifactWriter: SwarmCandidateArtifactWriter;
+    readonly gitRunner?: SwarmCandidateGitRunner;
+    readonly now?: () => string;
+    /** Test-only race seam executed after validation and before staging. */
+    readonly beforeStage?: () => void | Promise<void>;
+}
+export interface CaptureSwarmCandidateResult {
+    readonly admission: SwarmPatchAdmission;
+    readonly artifact?: PersistedSwarmCandidateArtifact;
+    readonly cleanupAuthorized: boolean;
+}
+/**
+ * Internal live-runtime bridge to the candidate module's single NUL-safe Git
+ * inventory parser. Policy enforcement remains in captureAndAdmitSwarmCandidate.
+ */
+export declare function inventorySwarmCandidatePaths(workspacePath: string, gitRunner?: SwarmCandidateGitRunner): Promise<string[]>;
+export declare function captureAndAdmitSwarmCandidate(input: CaptureSwarmCandidateInput): Promise<CaptureSwarmCandidateResult>;
+export declare function verifyPersistedSwarmCandidateArtifact(artifact: PersistedSwarmCandidateArtifact): boolean;