@osolmaz/pi-workflows 0.13.4 → 0.15.0

package/dist/extension/deferred-turn-coordinator.js

@@ -1,143 +0,0 @@
-import { randomUUID } from "node:crypto";
-import { deferredTurnMessageId } from "./deferred-turn.js";
-export class DeferredTurnCoordinator {
-    store;
-    branchResolution;
-    leaseMs;
-    deferredNatural = new Map();
-    constructor(options) {
-        this.store = options.store;
-        this.branchResolution = options.branchResolution;
-        this.leaseMs = options.leaseMs;
-    }
-    sendNatural(delivery, idle) {
-        const store = this.store();
-        const intent = store?.findPendingWorkflowTurnIntent({
-            runId: delivery.runId,
-            targetSessionId: delivery.targetSessionId,
-        });
-        if (store === null || store === undefined || intent === undefined) {
-            delivery.send();
-            return "sent";
-        }
-        if (!idle) {
-            this.deferredNatural.set(intent.intentId, delivery);
-            return "deferred";
-        }
-        const result = this.deliverNatural(intent.intentId, delivery);
-        if (result === "deferred")
-            this.deferredNatural.set(intent.intentId, delivery);
-        return result;
-    }
-    flushNatural(idle) {
-        if (!idle)
-            return 0;
-        let sent = 0;
-        for (const [intentId, delivery] of this.deferredNatural) {
-            const result = this.deliverNatural(intentId, delivery);
-            if (result !== "deferred") {
-                this.deferredNatural.delete(intentId);
-            }
-            if (result === "sent")
-                sent += 1;
-        }
-        return sent;
-    }
-    deliverFallbacks(delivery, idle) {
-        const store = this.store();
-        if (!idle || store === null)
-            return 0;
-        const claimToken = randomUUID();
-        const intents = store.claimEligibleWorkflowTurnIntents({
-            targetSessionId: delivery.targetSessionId,
-            claimToken,
-            leaseMs: this.leaseMs,
-        });
-        let sent = 0;
-        for (const [index, intent] of intents.entries()) {
-            const branch = this.branchResolution(intent.intentId);
-            if (branch !== null) {
-                store.resolveWorkflowTurnIntent({
-                    intentId: intent.intentId,
-                    targetSessionId: delivery.targetSessionId,
-                    claimToken,
-                    resolution: branch.resolution,
-                    messageId: branch.messageId,
-                });
-                continue;
-            }
-            try {
-                delivery.send(intent);
-                store.resolveWorkflowTurnIntent({
-                    intentId: intent.intentId,
-                    targetSessionId: delivery.targetSessionId,
-                    claimToken,
-                    resolution: "fallback",
-                    messageId: deferredTurnMessageId(intent.intentId, "fallback"),
-                });
-                sent += 1;
-            }
-            catch (error) {
-                for (const pending of intents.slice(index)) {
-                    store.releaseWorkflowTurnIntentClaim({
-                        intentId: pending.intentId,
-                        targetSessionId: delivery.targetSessionId,
-                        claimToken,
-                    });
-                }
-                throw error;
-            }
-        }
-        return sent;
-    }
-    clearDeferred() {
-        this.deferredNatural.clear();
-    }
-    deliverNatural(intentId, delivery) {
-        const store = this.store();
-        if (store === null)
-            return "deferred";
-        const claimToken = randomUUID();
-        const intent = store.claimWorkflowTurnIntent({
-            intentId,
-            targetSessionId: delivery.targetSessionId,
-            claimToken,
-            leaseMs: this.leaseMs,
-        });
-        if (intent === undefined) {
-            const current = store.getWorkflowTurnIntent(intentId);
-            return current?.resolvedAt === null ? "deferred" : "suppressed";
-        }
-        const branch = this.branchResolution(intent.intentId);
-        if (branch !== null) {
-            store.resolveWorkflowTurnIntent({
-                intentId: intent.intentId,
-                targetSessionId: delivery.targetSessionId,
-                claimToken,
-                resolution: branch.resolution,
-                messageId: branch.messageId,
-            });
-            return "suppressed";
-        }
-        try {
-            delivery.send(intent.intentId);
-            store.resolveWorkflowTurnIntent({
-                intentId: intent.intentId,
-                targetSessionId: delivery.targetSessionId,
-                claimToken,
-                resolution: delivery.resolution,
-                messageId: deferredTurnMessageId(intent.intentId, delivery.resolution),
-            });
-            return "sent";
-        }
-        catch (error) {
-            store.releaseWorkflowTurnIntentClaim({
-                intentId: intent.intentId,
-                targetSessionId: delivery.targetSessionId,
-                claimToken,
-            });
-            throw error;
-        }
-    }
-}
-//# sourceMappingURL=deferred-turn-coordinator.js.map

package/dist/extension/deferred-turn-coordinator.js.map

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

package/dist/extension/deferred-turn.d.ts

@@ -1,44 +0,0 @@
-import type { WorkflowTurnIntentCause, WorkflowTurnIntentFacts, WorkflowTurnIntentRecord, WorkflowTurnIntentResolution } from "../controllers/sqlite.js";
-export declare const DEFERRED_TURN_MESSAGE_TYPE = "pi-workflows-deferred-turn";
-export declare const DEFERRED_TURN_MESSAGE_SCHEMA = "pi-workflows.deferred-turn-message.v1";
-export type DeferredTurnSource = {
-    runId: string;
-    workflowName: string;
-    targetSessionId: string;
-    cause: WorkflowTurnIntentCause;
-    sourceEventId: string;
-    observedState: string;
-    nodeId?: string | null;
-    attemptId?: string | null;
-    reason?: string | null;
-    handoff?: boolean;
-};
-export type DeferredTurnDescriptor = {
-    intentId: string;
-    sourceEventId: string;
-    runId: string;
-    workflowRef: string;
-    targetSessionId: string;
-    cause: WorkflowTurnIntentCause;
-    nodeId: string | null;
-    attemptId: string | null;
-    fallbackFacts: WorkflowTurnIntentFacts;
-};
-export type DeferredTurnMessageDetails = {
-    schema: typeof DEFERRED_TURN_MESSAGE_SCHEMA;
-    turnIntentId: string;
-    runId: string;
-    cause: WorkflowTurnIntentCause;
-};
-export declare function deferredTurnSourceEventId(options: {
-    runId: string;
-    cause: WorkflowTurnIntentCause;
-    nodeId?: string | null;
-    attemptId?: string | null;
-    source?: string;
-}): string;
-export declare function createDeferredTurnDescriptor(source: DeferredTurnSource): DeferredTurnDescriptor;
-export declare function createDeferredTurnFacts(source: DeferredTurnSource): WorkflowTurnIntentFacts;
-export declare function deferredTurnMessageId(intentId: string, resolution: WorkflowTurnIntentResolution): string;
-export declare function deferredTurnMessageDetails(intent: WorkflowTurnIntentRecord): DeferredTurnMessageDetails;
-export declare function buildDeferredTurnContent(intent: WorkflowTurnIntentRecord): string;

package/dist/extension/deferred-turn.js

@@ -1,110 +0,0 @@
-import { createHash } from "node:crypto";
-export const DEFERRED_TURN_MESSAGE_TYPE = "pi-workflows-deferred-turn";
-export const DEFERRED_TURN_MESSAGE_SCHEMA = "pi-workflows.deferred-turn-message.v1";
-const FACTS_SCHEMA = "pi-workflows.deferred-turn-facts.v1";
-const MAX_REASON_CHARS = 8_192;
-export function deferredTurnSourceEventId(options) {
-    const parts = [
-        options.runId,
-        options.source ?? "run",
-        options.nodeId ?? "$run",
-        options.attemptId ?? "$none",
-        options.cause,
-    ];
-    return `turn-source:${digest(parts)}`;
-}
-export function createDeferredTurnDescriptor(source) {
-    const nodeId = source.nodeId ?? null;
-    const attemptId = source.attemptId ?? null;
-    const fallbackFacts = createDeferredTurnFacts(source);
-    return {
-        intentId: `deferred-turn:${digest([
-            source.targetSessionId,
-            source.runId,
-            source.sourceEventId,
-            nodeId ?? "$run",
-            attemptId ?? "$none",
-            source.cause,
-        ])}`,
-        sourceEventId: source.sourceEventId,
-        runId: source.runId,
-        workflowRef: source.workflowName,
-        targetSessionId: source.targetSessionId,
-        cause: source.cause,
-        nodeId,
-        attemptId,
-        fallbackFacts,
-    };
-}
-export function createDeferredTurnFacts(source) {
-    return {
-        schema: FACTS_SCHEMA,
-        workflowName: source.workflowName,
-        runId: source.runId,
-        observedState: source.observedState,
-        cause: source.cause,
-        nodeId: source.nodeId ?? null,
-        attemptId: source.attemptId ?? null,
-        reason: boundedReason(source.reason),
-        handoff: source.handoff ?? false,
-    };
-}
-export function deferredTurnMessageId(intentId, resolution) {
-    return `turn-message:${digest([intentId, resolution])}`;
-}
-export function deferredTurnMessageDetails(intent) {
-    return {
-        schema: DEFERRED_TURN_MESSAGE_SCHEMA,
-        turnIntentId: intent.intentId,
-        runId: intent.runId,
-        cause: intent.cause,
-    };
-}
-export function buildDeferredTurnContent(intent) {
-    const facts = intent.fallbackFacts;
-    const source = [
-        facts.nodeId === null ? null : `node ${facts.nodeId}`,
-        facts.attemptId === null ? null : `attempt ${facts.attemptId}`,
-    ]
-        .filter((part) => part !== null)
-        .join(", ");
-    const reason = facts.reason === null
-        ? ""
-        : ` Reason: ${facts.reason}${/[.!?]$/.test(facts.reason) ? "" : "."}`;
-    const sourceText = source.length === 0 ? "" : ` Source: ${source}.`;
-    if (facts.cause === "launchFailed") {
-        return [
-            `Workflow ${facts.workflowName} failed to start (run ${facts.runId}).`,
-            `${sourceText}${reason}`.trim(),
-            "Inspect the durable workflow state before you explain the outcome or start a corrected workflow.",
-        ]
-            .filter((part) => part.length > 0)
-            .join(" ");
-    }
-    if (facts.handoff) {
-        return [
-            `Workflow ${facts.workflowName} was handed to another runner (run ${facts.runId}).`,
-            `Observed state: ${facts.observedState}.${sourceText}${reason}`,
-            "Inspect the durable workflow state before you explain the outcome or take any authorized corrective action.",
-        ].join(" ");
-    }
-    return [
-        `Workflow ${facts.workflowName} ended with state ${facts.observedState} (run ${facts.runId}).`,
-        `${sourceText}${reason}`.trim(),
-        "Inspect the durable workflow state before you explain the outcome or take any authorized corrective action.",
-    ]
-        .filter((part) => part.length > 0)
-        .join(" ");
-}
-function boundedReason(value) {
-    if (value === null || value === undefined)
-        return null;
-    const trimmed = value.trim();
-    if (trimmed.length === 0)
-        return null;
-    return trimmed.length <= MAX_REASON_CHARS ? trimmed : trimmed.slice(0, MAX_REASON_CHARS);
-}
-function digest(parts) {
-    return createHash("sha256").update(JSON.stringify(parts)).digest("hex");
-}
-//# sourceMappingURL=deferred-turn.js.map

package/dist/extension/deferred-turn.js.map

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

package/dist/extension/executor.d.ts

@@ -1,86 +0,0 @@
-import type { AgentStepExecutor, AgentStepRequest, AgentStepSubmission, ConversationRange } from "../workflows/types.js";
-export type SubmissionResult = {
-    accepted: true;
-    message: string;
-} | {
-    accepted: false;
-    message: string;
-};
-export type PromptDeliveryKind = "step" | "reminder" | "resume";
-export type PromptDelivery = {
-    prompt: string;
-    contract: AgentStepRequest["contract"];
-    presentation?: AgentStepRequest["presentation"];
-    kind: PromptDeliveryKind;
-    /** True when the agent is known to be mid-run, so delivery must be queued. */
-    streaming: boolean;
-};
-/**
- * Bracketing hooks for conversation linkage: a mark is taken when the step
- * prompt is first delivered, and the recorded entry range since that mark is
- * attached to the accepted submission.
- */
-export type ConversationHooks = {
-    beginAttempt?: (contract: AgentStepRequest["contract"]) => void;
-    recoverAssistant?: (contract: AgentStepRequest["contract"]) => AgentStepSubmission | undefined;
-    mark: () => number;
-    rangeSince: (mark: number) => ConversationRange | undefined;
-};
-export type ConversationStepExecutorOptions = {
-    /** Deliver a prompt into the pi conversation. */
-    sendPrompt: (delivery: PromptDelivery) => void;
-    /** Reminders sent when the agent settles without submitting. Default 2. */
-    maxNudges?: number;
-    /** Conversation linkage hooks, wired to the session recorder. */
-    conversation?: ConversationHooks;
-    /** Called when the engine aborts a pending agent step. */
-    onAbort?: (contract: AgentStepRequest["contract"], reason: unknown) => void;
-};
-/**
- * AgentStepExecutor that runs steps inside the current pi conversation. The
- * engine hands it a prompt; it delivers the prompt as a model-facing workflow
- * message and resolves once the model submits an accepted output through the `workflow`
- * tool. If the agent settles without submitting, it nudges the model a
- * bounded number of times before failing the step.
- */
-export declare class ConversationStepExecutor implements AgentStepExecutor {
-    readonly assistantMessageMode: "visible";
-    private readonly sendPrompt;
-    private readonly maxNudges;
-    private readonly conversation;
-    private readonly onAbort;
-    private pending;
-    private streaming;
-    private heldByUser;
-    constructor(options: ConversationStepExecutorOptions);
-    /** Track agent streaming state (wire to agent_start / agent_settled). */
-    setStreaming(streaming: boolean): void;
-    get pendingStepId(): string | null;
-    get pendingCompletion(): "submit" | "assistant" | null;
-    /**
-     * Hold the pending step for the user: no nudges are sent while held, so an
-     * escape-interrupted conversation stays quiet until the user resumes.
-     */
-    hold(): void;
-    get held(): boolean;
-    /**
-     * Release a user hold. When a step is still pending, its prompt is
-     * re-delivered so the model picks the step back up.
-     */
-    release(): void;
-    runAgentStep(request: AgentStepRequest, signal: AbortSignal): Promise<AgentStepSubmission>;
-    /** Called by the `workflow` tool when the model submits a step output. */
-    submit(stepId: string, attemptId: string, output: unknown): Promise<SubmissionResult>;
-    /** Keep the latest finalized assistant message for an assistant-output step. */
-    handleMessageEnd(message: unknown): void;
-    /**
-     * Called when the agent settles. Returns true when a nudge was sent, false
-     * when there was nothing to do. Submitted steps use bounded nudges;
-     * assistant-output steps accept or fail the one visible response.
-     */
-    handleAgentSettled(): boolean;
-    private delivery;
-    private clearPending;
-}
-/** Extract the exact visible text blocks from one finalized assistant message. */
-export declare function visibleAssistantText(message: unknown, maxChars?: number): string;