@osolmaz/pi-workflows 0.9.1 → 0.11.0

package/dist/builtins/plan-approval.workflow.js

@@ -0,0 +1,148 @@
+import { compute, defineWorkflow } from "../workflows/definition.js";
+import { choice, defineHumanChoices, humanDecision, humanDecisionEdge, textInput, } from "../workflows/human-decision.js";
+import { presentPlan } from "./plan-presentation.js";
+const planChoices = defineHumanChoices({
+    continue: choice({ label: "Yes, continue" }),
+    stop: choice({ label: "No, stop" }),
+    replan: choice({
+        label: "Replan",
+        input: textInput({
+            name: "instructions",
+            prompt: "What should change?",
+            minLength: 1,
+            maxLength: 4_000,
+        }),
+    }),
+});
+function requireRecord(value, label) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error(`${label} must be an object`);
+    }
+    return value;
+}
+function requireString(value, label) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new Error(`${label} must be a non-empty string`);
+    }
+    return value.trim();
+}
+function parseInput(value) {
+    const input = requireRecord(value, "plan approval input");
+    const revision = input.revision;
+    if (revision !== undefined && (!Number.isInteger(revision) || revision < 1)) {
+        throw new Error("plan approval revision must be a positive integer");
+    }
+    if (input.plan === undefined)
+        throw new Error("plan approval requires a plan");
+    return {
+        task: requireString(input.task, "plan approval task"),
+        plan: input.plan,
+        planDigest: requireString(input.planDigest, "plan approval digest"),
+        audience: requireString(input.audience, "plan approval audience"),
+        ...(revision !== undefined ? { revision: revision } : {}),
+    };
+}
+function acceptedDecision(value) {
+    if (value === undefined)
+        throw new Error("plan approval continuation is missing its accepted decision");
+    return value;
+}
+function gateResponse(value) {
+    return requireRecord(value, "plan approval response");
+}
+export const planApprovalWorkflow = defineWorkflow({
+    source: import.meta.url,
+    contractId: "pi-workflows.plan-approval.v1",
+    name: "plan-approval",
+    input: parseInput,
+    title: ({ input }) => `plan approval: ${input.task.slice(0, 60)}`,
+    startAt: "approve",
+    maxSteps: 8,
+    exits: {
+        continue: {
+            from: "continued",
+            validate: (value) => value,
+        },
+        stop: {
+            from: "stopped",
+            validate: (value) => value,
+        },
+        replan: {
+            from: "replan",
+            validate: (value) => value,
+        },
+    },
+    nodes: {
+        approve: humanDecision({
+            audience: ({ input }) => input.audience,
+            choices: planChoices,
+            request: ({ input }) => {
+                const request = input;
+                const revision = request.revision ?? 1;
+                return {
+                    title: "Approve the implementation plan",
+                    subject: {
+                        task: request.task,
+                        plan: request.plan,
+                        planDigest: request.planDigest,
+                        revision,
+                    },
+                    presentation: presentPlan({
+                        task: request.task,
+                        plan: request.plan,
+                        planDigest: request.planDigest,
+                        revision,
+                    }),
+                    revision,
+                };
+            },
+        }),
+        continued: compute({
+            run: ({ input, state }) => {
+                const request = input;
+                return {
+                    status: "continue",
+                    plan: request.plan,
+                    planDigest: request.planDigest,
+                    decision: acceptedDecision(state.humanDecision),
+                };
+            },
+        }),
+        stopped: compute({
+            run: ({ input, state }) => {
+                const request = input;
+                return {
+                    status: "stop",
+                    planDigest: request.planDigest,
+                    decision: acceptedDecision(state.humanDecision),
+                };
+            },
+        }),
+        replan: compute({
+            run: ({ input, outputs, state }) => {
+                const request = input;
+                const response = gateResponse(outputs.approve);
+                const instructions = response.input?.instructions;
+                if (typeof instructions !== "string" || instructions.length === 0) {
+                    throw new Error("replan answer is missing exact instructions");
+                }
+                return {
+                    status: "replan",
+                    plan: request.plan,
+                    planDigest: request.planDigest,
+                    instructions,
+                    decision: acceptedDecision(state.humanDecision),
+                };
+            },
+        }),
+    },
+    edges: [
+        humanDecisionEdge({
+            from: "approve",
+            choices: planChoices,
+            cases: { continue: "continued", stop: "stopped", replan: "replan" },
+        }),
+    ],
+});
+export default planApprovalWorkflow;
+//# sourceMappingURL=plan-approval.workflow.js.map

package/dist/builtins/plan-approval.workflow.js.map

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

package/dist/builtins/plan-presentation.d.ts

@@ -0,0 +1,7 @@
+import type { DecisionPresentation } from "../workflows/types.js";
+export declare function presentPlan(input: {
+    task: string;
+    plan: unknown;
+    planDigest: string;
+    revision: number;
+}): DecisionPresentation;

package/dist/builtins/plan-presentation.js

@@ -0,0 +1,44 @@
+import { legacyDecisionPresentation, normalizeDecisionPresentation, } from "../workflows/decision-presentation.js";
+export function presentPlan(input) {
+    const plan = legacyDecisionPresentation(input.plan);
+    const summary = readableSummary(planSummary(input.plan)) ??
+        readableSummary(`Review the implementation plan for ${input.task}.`);
+    return normalizeDecisionPresentation({
+        schema: "pi-workflows.decision-presentation.v1",
+        summary,
+        blocks: [
+            { kind: "section", title: "Task" },
+            { kind: "paragraph", text: input.task },
+            { kind: "section", title: "Plan" },
+            ...plan.blocks.filter((block, index) => !(index === 0 && block.kind === "section" && block.title === "Decision details")),
+            { kind: "section", title: "Plan identity" },
+            {
+                kind: "fields",
+                items: [
+                    { label: "Revision", value: String(input.revision) },
+                    { label: "Digest", value: input.planDigest },
+                ],
+            },
+        ],
+    });
+}
+function readableSummary(value) {
+    if (value === undefined)
+        return undefined;
+    const text = [...value]
+        .map((character) => {
+        const code = character.codePointAt(0) ?? 0;
+        return code <= 31 || code === 127 ? " " : character;
+    })
+        .join("")
+        .replaceAll(/\s+/gu, " ")
+        .trim();
+    return text.length === 0 ? undefined : text;
+}
+function planSummary(plan) {
+    if (plan === null || typeof plan !== "object" || Array.isArray(plan))
+        return undefined;
+    const summary = plan.summary;
+    return typeof summary === "string" && summary.trim().length > 0 ? summary : undefined;
+}
+//# sourceMappingURL=plan-presentation.js.map

package/dist/builtins/plan-presentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-presentation.js","sourceRoot":"","sources":["../../src/builtins/plan-presentation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,6BAA6B,GAC9B,MAAM,uCAAuC,CAAC;AAG/C,MAAM,UAAU,WAAW,CAAC,KAK3B;IACC,MAAM,IAAI,GAAG,0BAA0B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACpD,MAAM,OAAO,GACX,eAAe,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxC,eAAe,CAAC,sCAAsC,KAAK,CAAC,IAAI,GAAG,CAAE,CAAC;IACxE,OAAO,6BAA6B,CAAC;QACnC,MAAM,EAAE,uCAAuC;QAC/C,OAAO;QACP,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE;YAClC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE;YACvC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE;YAClC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CACnB,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CACf,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,KAAK,kBAAkB,CAAC,CACnF;YACD,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE;YAC3C;gBACE,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE;oBACL,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE;oBACpD,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,UAAU,EAAE;iBAC7C;aACF;SACF;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CAAC,KAAyB;IAChD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC;SACpB,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE;QACjB,MAAM,IAAI,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC3C,OAAO,IAAI,IAAI,EAAE,IAAI,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IACtD,CAAC,CAAC;SACD,IAAI,CAAC,EAAE,CAAC;SACR,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC;SACxB,IAAI,EAAE,CAAC;IACV,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9C,CAAC;AAED,SAAS,WAAW,CAAC,IAAa;IAChC,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACvF,MAAM,OAAO,GAAI,IAAgC,CAAC,OAAO,CAAC;IAC1D,OAAO,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AACxF,CAAC"}

package/dist/extension/decision-channels.d.ts

@@ -0,0 +1,132 @@
+import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
+import { HumanDecisionStore } from "../workflows/human-decision.js";
+import type { AcceptedHumanDecision, HumanDecisionAnswerSource, HumanDecisionCancellationRecord, HumanDecisionChannelRequest, HumanDecisionResponse } from "../workflows/types.js";
+export type HumanDecisionChannelAnswer = {
+    request: HumanDecisionChannelRequest;
+    response: HumanDecisionResponse;
+    source: HumanDecisionAnswerSource;
+    idempotencyKey: string;
+};
+export type HumanDecisionDeliveryResult = {
+    status: "confirmed" | "failed" | "unknown";
+    channel: string;
+    attemptId: string;
+    errorCode?: string;
+};
+export type SettledHumanDecision = AcceptedHumanDecision | HumanDecisionCancellationRecord;
+export interface HumanDecisionChannel {
+    readonly id: string;
+    start(): Promise<void>;
+    deliver(request: HumanDecisionChannelRequest): Promise<HumanDecisionDeliveryResult>;
+    settle(decision: SettledHumanDecision): Promise<void>;
+    stop(): Promise<void>;
+}
+export type DecisionChannelConfig = {
+    schema: "pi-workflows.channels.v1";
+    audiences: Record<string, {
+        channels: string[];
+        accept: "first-valid-answer";
+    }>;
+    telegramProfiles?: Record<string, {
+        credential: string;
+        allowedUserIds: string[];
+        allowedChatIds: string[];
+    }>;
+};
+export type DecisionCredentialConfig = {
+    schema: "pi-workflows.credentials.v1";
+    telegram: Record<string, {
+        tokenFile: string;
+    }>;
+};
+type ResolvedDecisionCredentials = Record<string, string>;
+export type LoadedDecisionChannelConfig = {
+    channels: DecisionChannelConfig;
+    credentials: ResolvedDecisionCredentials;
+    configDir: string;
+};
+export type TelegramFetch = (input: string, init?: RequestInit) => Promise<{
+    ok: boolean;
+    status: number;
+    json(): Promise<unknown>;
+}>;
+export type PiDecisionUi = Pick<ExtensionContext["ui"], "custom" | "input">;
+export declare function decisionConfigDir(env?: NodeJS.ProcessEnv): string;
+export declare function loadDecisionChannelConfig(configDir?: string): Promise<LoadedDecisionChannelConfig | null>;
+export declare function audienceChannels(config: DecisionChannelConfig | null, audience: string): string[];
+export declare class PiDecisionChannel implements HumanDecisionChannel {
+    private readonly options;
+    readonly id = "pi";
+    private promptAbort;
+    private settlementTask;
+    constructor(options: {
+        actorId: string;
+        ui: PiDecisionUi;
+        store: HumanDecisionStore;
+        onAnswer: (answer: HumanDecisionChannelAnswer) => Promise<void>;
+    });
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    deliver(request: HumanDecisionChannelRequest): Promise<HumanDecisionDeliveryResult>;
+    settle(decision: SettledHumanDecision): Promise<void>;
+    private settleOnce;
+}
+export declare class TelegramDecisionChannel implements HumanDecisionChannel {
+    readonly id: string;
+    private readonly profile;
+    private readonly store;
+    private readonly fetchFn;
+    private readonly apiBase;
+    private readonly onAnswer;
+    private readonly projection;
+    private running;
+    private pollAbort;
+    private pollTask;
+    private readonly settlementTasks;
+    constructor(options: {
+        profileName: string;
+        token: string;
+        allowedUserIds: string[];
+        allowedChatIds: string[];
+        store: HumanDecisionStore;
+        configDir?: string;
+        onAnswer: (answer: HumanDecisionChannelAnswer) => Promise<void>;
+        fetchFn?: TelegramFetch;
+        apiBase?: string;
+        ownerId?: string;
+    });
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    deliver(request: HumanDecisionChannelRequest): Promise<HumanDecisionDeliveryResult>;
+    settle(decision: SettledHumanDecision): Promise<void>;
+    private settleOnce;
+    handleUpdate(value: unknown): Promise<void>;
+    private registerCallbacks;
+    private channelPath;
+    private allowed;
+    private isStale;
+    private poll;
+    private call;
+}
+export declare function createTelegramChannels(options: {
+    config: DecisionChannelConfig;
+    credentials: ResolvedDecisionCredentials;
+    store: HumanDecisionStore;
+    configDir?: string;
+    onAnswer: (answer: HumanDecisionChannelAnswer) => Promise<void>;
+    fetchFn?: TelegramFetch;
+    apiBase?: string;
+}): Map<string, TelegramDecisionChannel>;
+export declare function verifyTelegramTokenFile(tokenFile: string, fetchFn?: TelegramFetch, apiBase?: string): Promise<void>;
+export declare function writeDecisionChannelProfile(options: {
+    configDir?: string;
+    audience: string;
+    profile: string;
+    credential: string;
+    tokenFile: string;
+    allowedUserIds: string[];
+    allowedChatIds: string[];
+}): Promise<void>;
+export declare function renderDecisionText(request: HumanDecisionChannelRequest): string;
+export declare function renderTelegramParts(request: HumanDecisionChannelRequest, textLimit?: number): string[];
+export {};