@martinloop/mcp 0.7.1 → 0.8.1

package/dist/vendor/core/swarm/live-store.d.ts

@@ -0,0 +1,99 @@
+import { SWARM_SCHEMA_VERSION } from "../../contracts/index.js";
+import type { FailureClass, SwarmEventType, SwarmLiveEvent, SwarmLivePlan, SwarmOutcome } from "../../contracts/index.js";
+import { type RunParentSwarmPipelineResult } from "./index.js";
+export interface SwarmLiveStorePaths {
+    directory: string;
+    plan: string;
+    events: string;
+    snapshot: string;
+    startClaim: string;
+    writerLock: string;
+    eventClaims: string;
+}
+export interface CanonicalSwarmLiveEvidenceFile {
+    kind: "plan" | "start_claim" | "event_claim" | "events" | "snapshot";
+    path: string;
+    bytes: Buffer;
+}
+export interface CanonicalSwarmLiveEvidenceBundle {
+    plan: SwarmLivePlan;
+    events: SwarmLiveEvent[];
+    snapshot: SwarmLiveSnapshot;
+    paths: SwarmLiveStorePaths;
+    files: CanonicalSwarmLiveEvidenceFile[];
+}
+export interface SwarmCancellationRequest {
+    requestedAt: string;
+    reason: string;
+    requestedBy?: string;
+}
+export interface SwarmLiveSnapshot {
+    schemaVersion: typeof SWARM_SCHEMA_VERSION;
+    swarmId: string;
+    planHash: string;
+    revision: number;
+    lastSequence: number;
+    eventCount: number;
+    lastEventType?: SwarmEventType;
+    cancellation?: SwarmCancellationRequest;
+    outcome: SwarmOutcome;
+    updatedAt: string;
+}
+export interface SwarmLiveEventInput {
+    idempotencyKey: string;
+    type: SwarmEventType;
+    timestamp: string;
+    taskId?: string;
+    agentId?: string;
+    childRunId?: string;
+    failureClass?: FailureClass;
+    payload: Record<string, unknown>;
+}
+export interface SwarmLiveAppendResult {
+    event: SwarmLiveEvent;
+    snapshot: SwarmLiveSnapshot;
+    duplicate: boolean;
+}
+export interface SwarmLiveAppendOptions {
+    expectedRevision: number;
+}
+export interface CreateSwarmLiveStoreInput {
+    rootDir: string;
+    plan: SwarmLivePlan;
+}
+export interface OpenSwarmLiveStoreInput {
+    rootDir: string;
+    swarmId: string;
+}
+export interface SwarmLiveStore {
+    readonly plan: SwarmLivePlan;
+    claimStart(): Promise<void>;
+    append(input: SwarmLiveEventInput, options: SwarmLiveAppendOptions): Promise<SwarmLiveAppendResult>;
+    persistParentOutcome(result: RunParentSwarmPipelineResult, options: SwarmLiveAppendOptions): Promise<SwarmLiveAppendResult>;
+    requestCancellation(request: SwarmCancellationRequest & {
+        idempotencyKey: string;
+    }, options: SwarmLiveAppendOptions): Promise<SwarmLiveAppendResult>;
+    readSnapshot(): Promise<SwarmLiveSnapshot>;
+    readEvents(): Promise<SwarmLiveEvent[]>;
+    waitForRevision(afterRevision: number, signal?: AbortSignal): Promise<SwarmLiveSnapshot>;
+    paths(): SwarmLiveStorePaths;
+}
+export declare class SwarmLiveStoreError extends Error {
+    readonly code: string;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(code: string, message: string, details?: Record<string, unknown> | undefined);
+}
+export declare function createSwarmLiveStore(input: CreateSwarmLiveStoreInput): Promise<SwarmLiveStore>;
+export declare function openSwarmLiveStore(input: OpenSwarmLiveStoreInput): Promise<SwarmLiveStore>;
+/** Internal canonical-path entrypoint; intentionally not exported from the Core package root. */
+export declare function openSwarmLiveStoreAtDirectory(input: {
+    directory: string;
+    swarmId: string;
+}): Promise<SwarmLiveStore>;
+/** Read-only evidence path. It validates derived files but never heals or rewrites them. */
+export declare function readCanonicalSwarmLiveEvidenceBundle(input: {
+    directory: string;
+    swarmId: string;
+}): Promise<CanonicalSwarmLiveEvidenceBundle>;
+/** Internal replay identity seam; intentionally not exported from the Core root. */
+export declare function isExactPersistedParentResultEvent(event: SwarmLiveEvent, input: SwarmLiveEventInput): boolean;