@osolmaz/pi-workflows 0.15.3 → 0.16.1

package/dist/client/resolver.d.ts

@@ -0,0 +1,23 @@
+import type { JsonValue } from "../state/json.js";
+export type ResolvedWorkflowLaunch = {
+    schema: "pi-workflows.resolved-launch.v1";
+    workflowName: string;
+    workflowSourceRef: string;
+    workflowSource: JsonValue;
+    definitionDigest: string;
+    definitionSnapshot: JsonValue;
+};
+export type ResolvedControllerInitialization = {
+    schema: "pi-workflows.resolved-controller-initialization.v1";
+    controllerName: string;
+    controllerPath: string;
+    sourceHash: string;
+    initialStatus: JsonValue;
+};
+export type ResolvedSettingsChange = {
+    schema: "pi-workflows.resolved-settings-change.v1";
+    definitionDigest: string;
+    patch: JsonValue;
+    settings: JsonValue;
+    paths: JsonValue;
+};

package/dist/client/resolver.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=resolver.js.map

package/dist/client/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../src/client/resolver.ts"],"names":[],"mappings":""}

package/dist/client/view.d.ts

@@ -0,0 +1,144 @@
+import type { JsonValue } from "../state/json.js";
+import type { WorkflowMessage, WorkflowTurn } from "../state/workflow-messages.js";
+export declare const RUN_VIEW_SCHEMA: "pi-workflows.run-view.v1";
+export declare const SESSION_VIEW_SCHEMA: "pi-workflows.session-view.v1";
+export type WorkflowDisplayStatus = "queued" | "running" | "waiting" | "paused" | "completed" | "failed" | "timed_out" | "cancelled" | "ambiguous";
+export type WorkflowDisplay = {
+    status: WorkflowDisplayStatus;
+    activity: "supervised_worker" | "origin_turn" | null;
+    controls: Array<"pause" | "resume" | "cancel" | "answer" | "review">;
+    reason: string | null;
+    reasonContent?: JsonValue;
+};
+export type WorkflowRunQueueView = {
+    runId: string;
+    workflowName: string;
+    workflowSourceRef: string;
+    initialized: boolean;
+    definitionDigest: string;
+    status: "queued" | "starting" | "running" | "parked" | "done" | "failed" | "cancelled";
+    originSessionId: string | null;
+    executionMode: "interactive" | "headless";
+    parentRunId: string | null;
+    rootRunId: string;
+    lineageKind: "continuation" | "restart" | null;
+    restartNumber: number;
+    parentTerminalFingerprint: string | null;
+    errorCode: string | null;
+    createdAt: string;
+    updatedAt: string;
+    startedAt: string | null;
+    finishedAt: string | null;
+};
+export type WorkflowRunView = {
+    schema: typeof RUN_VIEW_SCHEMA;
+    runId: string;
+    revision: number;
+    display: WorkflowDisplay;
+    manifest: JsonValue;
+    state: JsonValue;
+    workflow: JsonValue;
+    queue: WorkflowRunQueueView;
+    updates: JsonValue[];
+    graphSteps: JsonValue[];
+    graphStepStart: number;
+    graphStepTotal: number;
+    takenTransitions: string[];
+    graphHistory: JsonValue;
+    takenTransitionStart: number;
+    takenTransitionTotal: number;
+    graphCursor: number;
+    stepStart: number;
+    stepTotal: number;
+    tracePage: JsonValue;
+    session: JsonValue;
+    settingsScopes: JsonValue[];
+    settingsStart: number;
+    settingsTotal: number;
+    followUpQueue: JsonValue;
+    followUpStart: number;
+    followUpTotal: number;
+    updateStart: number;
+    updateTotal: number;
+    live: boolean;
+    possiblyInterrupted: boolean;
+};
+export type WorkflowRunListPage = {
+    schema: "pi-workflows.run-list-page.v1";
+    revision: string;
+    start: number;
+    total: number;
+    items: WorkflowRunSummary[];
+};
+export type WorkflowRunSummary = {
+    runId: string;
+    workflowName: string;
+    originSessionId: string | null;
+    createdAt: string;
+    updatedAt: string;
+    display: WorkflowDisplay;
+    manifest: JsonValue;
+    live: boolean;
+    possiblyInterrupted: boolean;
+};
+export type ClientInteractiveRequest = {
+    requestId: string;
+    runId: string;
+    attemptId: string;
+    targetSessionId: string;
+    kind: "agent" | "assistant" | "decision";
+    contract: JsonValue;
+    revision: number;
+    status: "pending" | "settled" | "cancelled";
+    unproductiveTurnEnds: number;
+    acceptedSubmissionId: string | null;
+    createdAt: string;
+    updatedAt: string;
+    settledAt: string | null;
+    consumedAt: string | null;
+};
+export type WorkflowSessionView = {
+    schema: typeof SESSION_VIEW_SCHEMA;
+    sessionId: string;
+    run: WorkflowRunView | null;
+    pendingInteractions: JsonValue[];
+    pendingInteractionStart: number;
+    pendingInteractionTotal: number;
+    workflowMessages: WorkflowMessage[];
+    workflowMessageStart: number;
+    workflowMessageTotal: number;
+    workflowMessageWindowComplete: boolean;
+    nextWorkflowMessageId: string | null;
+    openWorkflowMessageId: string | null;
+    openWorkflowTurn: WorkflowTurn | null;
+    coordinatorEpoch: string | null;
+    coordinatorActive: boolean;
+    branchReportRequired: boolean;
+};
+export type WorkflowBranchReport = {
+    targetSessionId: string;
+    coordinatorEpoch: string;
+    entries: Array<{
+        workflowMessageId: string;
+        piSessionEntryId: string;
+    }>;
+    isIdle: boolean;
+    hasPendingMessages: boolean;
+};
+export type WorkflowTurnReport = {
+    state: "started";
+    workflowMessageId: string;
+    workflowTurnId: string;
+    runId: string;
+    targetSessionId: string;
+    coordinatorEpoch: string;
+} | {
+    state: "ended";
+    workflowMessageId: string;
+    workflowTurnId: string;
+    runId: string;
+    targetSessionId: string;
+    coordinatorEpoch: string;
+    stopReason: "completed" | "aborted" | "error" | "lost";
+    responseSessionEntryId: string | null;
+};

package/dist/client/view.js

@@ -0,0 +1,3 @@
+export const RUN_VIEW_SCHEMA = "pi-workflows.run-view.v1";
+export const SESSION_VIEW_SCHEMA = "pi-workflows.session-view.v1";
+//# sourceMappingURL=view.js.map

package/dist/client/view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.js","sourceRoot":"","sources":["../../src/client/view.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,eAAe,GAAG,0BAAmC,CAAC;AACnE,MAAM,CAAC,MAAM,mBAAmB,GAAG,8BAAuC,CAAC"}

package/dist/controllers/index.d.ts

@@ -5,7 +5,7 @@ export { ControllerEffectService } from "./effects.js";
 export { canonicalJson, jsonFingerprint } from "./json.js";
 export { ControllerManager, type ControllerManagerOptions } from "./manager.js";
 export { createResultHelpers, requeue, requeueAfter, settled } from "./results.js";
-export { SqliteControllerStore, type RunEventRecord, type WorkflowNotificationRecord, type WorkflowRunClaimOptions, type WorkflowRunPreparationResult, type WorkflowRunQueueRecord, type WorkflowRunReservationOptions, } from "./sqlite.js";
+export { SqliteControllerStore, type RunEventRecord, type WorkflowRunClaimOptions, type WorkflowRunPreparationResult, type WorkflowRunQueueRecord, type WorkflowRunReservationOptions, } from "./sqlite.js";
 export { type ControllerStore, type EffectReservation, type QueueItem, type QueueRequeueOptions, type WorkflowRecordUpdate, type WorkflowReservation, } from "./store.js";
 export { controllerFileStem, controllerSearchDirs, discoverControllers, loadControllerFile, loadDiscoveredControllers, type DiscoveredController, } from "./loader.js";
 export { ControllerWorkflowCoordinator, type ControllerWorkflowControlRequest, type ControllerWorkflowScheduler, type WorkflowSchedulerRequest, type WorkflowSchedulerResult, } from "./workflows.js";

package/dist/controllers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/controllers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,+BAA+B,EAC/B,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAiC,MAAM,cAAc,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EACL,qBAAqB,GAOtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAON,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,yBAAyB,GAE1B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,6BAA6B,GAK9B,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/controllers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,+BAA+B,EAC/B,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAiC,MAAM,cAAc,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EACL,qBAAqB,GAMtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAON,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,yBAAyB,GAE1B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,6BAA6B,GAK9B,MAAM,gBAAgB,CAAC"}

package/dist/controllers/sqlite.d.ts

@@ -1,7 +1,6 @@
 import { StateDatabase } from "../state/database.js";
 import type { ControllerStore, EffectReservation, QueueItem, QueueRequeueOptions, WorkflowRecordUpdate, WorkflowReservation } from "./store.js";
 import type { ChildWorkflowRecord, ControllerEvent, ControllerQueueClaim, ControllerResource, ControllerResourceRef, ControllerResourceStatus, EffectRecord, JsonObject } from "./types.js";
-declare const TURN_INTENT_FACTS_SCHEMA = "pi-workflows.deferred-turn-facts.v1";
 export type WorkflowRunLaunchStatus = "queued" | "starting" | "running" | "parked" | "done" | "failed" | "cancelled";
 export type WorkflowRunReservationOptions = {
     runId: string;
@@ -16,12 +15,39 @@ export type WorkflowRunReservationOptions = {
     originSessionId: string;
     executionMode?: "interactive" | "headless";
     parentRunId?: string;
+    lineageKind?: "continuation" | "restart";
+    restartNumber?: number;
+    parentTerminalFingerprint?: string;
     now?: string;
 };
 export type WorkflowRunClaimOptions = WorkflowRunReservationOptions & {
     claimToken: string;
     leaseMs: number;
 };
+export type WorkflowRunQueueViewRecord = {
+    runId: string;
+    workflowName: string;
+    workflowSourceRef: string;
+    workflowSource: unknown;
+    initialized: boolean;
+    definitionDigest: string;
+    runStateStatus: string;
+    paused: boolean;
+    status: WorkflowRunLaunchStatus;
+    originSessionId: string | null;
+    executionMode: "interactive" | "headless";
+    parentRunId: string | null;
+    rootRunId: string;
+    lineageKind: "continuation" | "restart" | null;
+    restartNumber: number;
+    parentTerminalFingerprint: string | null;
+    errorCode: string | null;
+    errorMessage: string | null;
+    createdAt: string;
+    updatedAt: string;
+    startedAt: string | null;
+    finishedAt: string | null;
+};
 export type WorkflowRunQueueRecord = {
     runId: string;
     workflowName: string;
@@ -40,6 +66,10 @@ export type WorkflowRunQueueRecord = {
     originSessionId: string | null;
     executionMode: "interactive" | "headless";
     parentRunId: string | null;
+    rootRunId: string;
+    lineageKind: "continuation" | "restart" | null;
+    restartNumber: number;
+    parentTerminalFingerprint: string | null;
     errorCode: string | null;
     errorMessage: string | null;
     createdAt: string;
@@ -56,49 +86,6 @@ export type WorkflowRunPreparationResult = {
     state: "adopted";
     run: WorkflowRunQueueRecord;
 };
-export type WorkflowNotificationRecord = {
-    notificationId: string;
-    runId: string;
-    nodeId: string;
-    attemptId: string;
-    notificationIndex: number;
-    targetSessionId: string;
-    kind: "progress" | "final";
-    content: string;
-    createdAt: string;
-    deliveryClaimExpiresAt: string | null;
-    deliveredAt: string | null;
-};
-export type WorkflowTurnIntentCause = "agentCancelled" | "timedOut" | "failed" | "launchFailed" | "controllerInterrupted" | "claimLost" | "terminal" | "cancelled";
-export type WorkflowTurnIntentResolution = "workflowPrompt" | "presentation" | "fallback";
-export type WorkflowTurnIntentFacts = JsonObject & {
-    schema: typeof TURN_INTENT_FACTS_SCHEMA;
-    workflowName: string;
-    runId: string;
-    observedState: string;
-    cause: WorkflowTurnIntentCause;
-    nodeId: string | null;
-    attemptId: string | null;
-    reason: string | null;
-    handoff: boolean;
-};
-export type WorkflowTurnIntentRecord = {
-    intentId: string;
-    sourceEventId: string;
-    runId: string;
-    workflowRef: string;
-    targetSessionId: string;
-    cause: WorkflowTurnIntentCause;
-    nodeId: string | null;
-    attemptId: string | null;
-    fallbackFacts: WorkflowTurnIntentFacts;
-    requestedAt: string;
-    eligibleAt: string | null;
-    resolvedAt: string | null;
-    resolution: WorkflowTurnIntentResolution | null;
-    resolutionMessageId: string | null;
-    deliveryClaimExpiresAt: string | null;
-};
 export type RunEventRecord = {
     seq: number;
     recordedAt: string;
@@ -212,6 +199,19 @@ export declare class SqliteControllerStore implements ControllerStore {
     prepareOrAdoptWorkflowRun(options: WorkflowRunClaimOptions): WorkflowRunPreparationResult;
     enqueueWorkflowRun(options: WorkflowRunClaimOptions): WorkflowRunQueueRecord;
     getWorkflowRun(runId: string): WorkflowRunQueueRecord | undefined;
+    getWorkflowRunView(runId: string): WorkflowRunQueueViewRecord | undefined;
+    workflowRunListRevision(): {
+        total: number;
+        revision: string;
+    };
+    listWorkflowRunViews(options: {
+        offset: number;
+        limit: number;
+    }): {
+        total: number;
+        revision: string;
+        runs: WorkflowRunQueueViewRecord[];
+    };
     workflowRunProjectPath(runId: string): string | undefined;
     listWorkflowRuns(options?: {
         statuses?: WorkflowRunLaunchStatus[];
@@ -219,6 +219,7 @@ export declare class SqliteControllerStore implements ControllerStore {
         limit?: number;
     }): WorkflowRunQueueRecord[];
     findSessionReservation(sessionId: string): WorkflowRunQueueRecord | undefined;
+    findSessionReservationView(sessionId: string): WorkflowRunQueueViewRecord | undefined;
     claimWorkflowRun(options: {
         runId: string;
         runnerId: string;
@@ -244,6 +245,7 @@ export declare class SqliteControllerStore implements ControllerStore {
     }): WorkflowRunQueueRecord | undefined;
     beginWorkflowRunInteractionTimeout(options: {
         runId: string;
+        targetSessionId: string;
         claimToken: string;
         now?: string;
     }): boolean;
@@ -348,102 +350,6 @@ export declare class SqliteControllerStore implements ControllerStore {
     listRunEventsAfter(seq: number, options?: {
         limit?: number;
     }): RunEventRecord[];
-    ensureWorkflowTurnIntent(options: {
-        intentId: string;
-        sourceEventId: string;
-        runId: string;
-        workflowRef: string;
-        targetSessionId: string;
-        cause: WorkflowTurnIntentCause;
-        nodeId?: string | null;
-        attemptId?: string | null;
-        fallbackFacts: WorkflowTurnIntentFacts;
-        eligible: boolean;
-        requestedAt?: string;
-    }): WorkflowTurnIntentRecord;
-    getWorkflowTurnIntent(intentId: string): WorkflowTurnIntentRecord | undefined;
-    findPendingWorkflowTurnIntent(options: {
-        runId: string;
-        targetSessionId: string;
-    }): WorkflowTurnIntentRecord | undefined;
-    isWorkflowTurnIntentClaimLive(options: {
-        intentId: string;
-        targetSessionId: string;
-        claimToken: string;
-        now?: string;
-    }): boolean;
-    claimWorkflowTurnIntent(options: {
-        intentId: string;
-        targetSessionId: string;
-        claimToken: string;
-        leaseMs: number;
-        now?: string;
-    }): WorkflowTurnIntentRecord | undefined;
-    claimEligibleWorkflowTurnIntents(options: {
-        targetSessionId: string;
-        claimToken: string;
-        leaseMs: number;
-        now?: string;
-        limit?: number;
-    }): WorkflowTurnIntentRecord[];
-    makeWorkflowTurnIntentEligible(options: {
-        intentId: string;
-        fallbackFacts: WorkflowTurnIntentFacts;
-        eligibleAt?: string;
-        now?: string;
-    }): boolean;
-    resolveWorkflowTurnIntent(options: {
-        intentId: string;
-        targetSessionId: string;
-        claimToken: string;
-        resolution: WorkflowTurnIntentResolution;
-        messageId?: string;
-        now?: string;
-    }): boolean;
-    releaseWorkflowTurnIntentClaim(options: {
-        intentId: string;
-        targetSessionId: string;
-        claimToken: string;
-    }): boolean;
-    listWorkflowTurnIntents(options?: {
-        runId?: string;
-        targetSessionId?: string;
-        unresolvedOnly?: boolean;
-        limit?: number;
-    }): WorkflowTurnIntentRecord[];
-    enqueueWorkflowNotification(options: {
-        runId: string;
-        nodeId: string;
-        attemptId: string;
-        notificationIndex: number;
-        targetSessionId: string;
-        kind: "progress" | "final";
-        content: string;
-        now?: string;
-    }): WorkflowNotificationRecord;
-    listPendingWorkflowNotifications(options: {
-        targetSessionId: string;
-        limit?: number;
-    }): WorkflowNotificationRecord[];
-    claimPendingWorkflowNotifications(options: {
-        targetSessionId: string;
-        claimToken: string;
-        leaseMs: number;
-        now?: string;
-        limit?: number;
-    }): WorkflowNotificationRecord[];
-    isWorkflowNotificationClaimLive(options: {
-        notificationId: string;
-        targetSessionId: string;
-        claimToken: string;
-        now?: string;
-    }): boolean;
-    markWorkflowNotificationDelivered(options: {
-        notificationId: string;
-        targetSessionId: string;
-        claimToken: string;
-        now?: string;
-    }): boolean;
     settleRunEffect(runId: string, effectType: "run.park_queue" | "run.settle_queue"): void;
     setWorkflowRunOriginSession(runId: string, originSessionId: string): boolean;
     private ensureProject;
@@ -478,6 +384,7 @@ export declare class SqliteControllerStore implements ControllerStore {
     private requireWorkflowRunRow;
     private requireWorkflowRun;
     private assertWorkflowRunPreparationCompatible;
+    private workflowRunViewRows;
     private mapWorkflowRun;
     private claimRun;
     private claimRunInTransaction;
@@ -485,22 +392,5 @@ export declare class SqliteControllerStore implements ControllerStore {
     private releaseRunClaim;
     private terminalRun;
     private cancelWorkflowRunDependents;
-    private turnIntent;
-    private requireTurnIntent;
-    private turnIntentRow;
-    private turnIntentBySource;
-    private mapTurnIntent;
-    private claimEffectForTurn;
-    private claimEffect;
-    private verifyEffectToken;
-    private releaseEffectLease;
-    private completeEffect;
-    private insertEffectResource;
-    private notification;
-    private requireNotification;
-    private notificationRows;
-    private notificationRowById;
-    private mapNotification;
     private assertWritable;
 }
-export {};