@osolmaz/pi-workflows 0.16.0 → 0.16.2

package/dist/channels/protocol.js

@@ -0,0 +1,219 @@
+import { createHash } from "node:crypto";
+export const CHANNEL_ADAPTER_PROTOCOL_SCHEMA = "pi-workflows.channel-adapter.v1";
+export function encodeChannelLine(value) {
+    return Buffer.from(`${JSON.stringify(value)}\n`, "utf8");
+}
+export function parseChannelAdapterMessage(frame) {
+    const value = parseObject(frame, "channel adapter message");
+    requireBase(value);
+    const kind = value.kind;
+    if (kind === "channel.ready" || kind === "channel.exiting") {
+        requireNonNegativeInteger(value.cursor, "channel cursor");
+    }
+    else if (kind === "channel.present") {
+        requireText(value.decisionId, "decisionId");
+        requireText(value.requestDigest, "requestDigest");
+        requireText(value.attemptId, "attemptId");
+        requireOneOf(value.state, ["confirmed", "failed", "unknown"], "presentation state");
+        if (!Array.isArray(value.messages))
+            throw new Error("Channel message references are invalid");
+        value.messages.forEach(validateMessageReference);
+        requireOptionalText(value.errorCode, "errorCode");
+    }
+    else if (kind === "channel.answer") {
+        requireText(value.decisionId, "decisionId");
+        requireText(value.requestDigest, "requestDigest");
+        validateDecisionResponse(value.response);
+        requireText(value.actorId, "actorId");
+        requireText(value.chatId, "chatId");
+        requireText(value.eventId, "eventId");
+        requireText(value.idempotencyKey, "idempotencyKey");
+        requireNonNegativeInteger(value.cursor, "channel cursor");
+    }
+    else if (kind === "channel.settle") {
+        requireText(value.decisionId, "decisionId");
+        requireText(value.requestDigest, "requestDigest");
+        requireText(value.attemptId, "attemptId");
+        requireOneOf(value.state, ["confirmed", "failed", "unknown"], "settlement state");
+        requireOptionalText(value.errorCode, "errorCode");
+    }
+    else {
+        throw new Error("Channel adapter message kind is invalid");
+    }
+    return value;
+}
+export function parseChannelAdapterResponse(frame) {
+    const value = parseObject(frame, "channel adapter response");
+    if (value.schema !== CHANNEL_ADAPTER_PROTOCOL_SCHEMA ||
+        value.type !== "response" ||
+        !Number.isSafeInteger(value.sequence) ||
+        (value.outcome !== "accepted" && value.outcome !== "rejected") ||
+        !Number.isSafeInteger(value.revision)) {
+        throw new Error("Channel adapter response is invalid");
+    }
+    requirePositiveInteger(value.sequence, "channel response sequence");
+    requireNonNegativeInteger(value.revision, "channel response revision");
+    requireOptionalText(value.error, "channel response error");
+    validateCommand(value.command);
+    return value;
+}
+export function parseChannelAdapterLaunch(value) {
+    const launch = requireObject(value, "channel adapter launch envelope");
+    if (launch.schema !== "pi-workflows.channel-adapter-launch.v1") {
+        throw new Error("Channel adapter launch envelope is invalid");
+    }
+    requireText(launch.adapterEpoch, "adapterEpoch");
+    requireText(launch.profile, "profile");
+    requireText(launch.token, "token");
+    requireStringArray(launch.allowedUserIds, "allowedUserIds");
+    requireStringArray(launch.allowedChatIds, "allowedChatIds");
+    requireOptionalText(launch.apiBase, "apiBase");
+    return launch;
+}
+export function channelResponse(message, outcome, revision, command, error) {
+    return {
+        schema: CHANNEL_ADAPTER_PROTOCOL_SCHEMA,
+        type: "response",
+        sequence: message.sequence,
+        outcome,
+        revision,
+        command,
+        ...(error === undefined ? {} : { error }),
+    };
+}
+export function channelStableMessageId(parts) {
+    return `channel-${createHash("sha256").update(parts.join("\0")).digest("hex")}`;
+}
+function requireBase(value) {
+    if (value.schema !== CHANNEL_ADAPTER_PROTOCOL_SCHEMA) {
+        throw new Error("Channel adapter message is invalid");
+    }
+    requireText(value.adapterEpoch, "adapterEpoch");
+    requireText(value.profile, "profile");
+    requirePositiveInteger(value.sequence, "channel sequence");
+    requireNonNegativeInteger(value.expectedRevision, "channel expected revision");
+    requireText(value.stableMessageId, "stableMessageId");
+}
+function validateCommand(value) {
+    if (value === null)
+        return;
+    const command = requireObject(value, "channel command");
+    if (command.kind === "channel.stop")
+        return;
+    if (command.kind === "channel.present") {
+        requireText(command.stableMessageId, "stableMessageId");
+        requireText(command.attemptId, "attemptId");
+        validateChannelRequest(command.request);
+        return;
+    }
+    if (command.kind === "channel.settle") {
+        requireText(command.stableMessageId, "stableMessageId");
+        requireText(command.attemptId, "attemptId");
+        validateChannelRequest(command.request);
+        requireOneOf(command.outcome, ["accepted", "cancelled", "expired"], "settlement outcome");
+        if (command.response !== undefined)
+            validateDecisionResponse(command.response);
+        if (!Array.isArray(command.messages))
+            throw new Error("Channel message references are invalid");
+        command.messages.forEach(validateMessageReference);
+        return;
+    }
+    if (command.kind === "channel.poll") {
+        requireNonNegativeInteger(command.cursor, "channel cursor");
+        if (!Array.isArray(command.requests))
+            throw new Error("Channel poll requests are invalid");
+        command.requests.forEach(validateChannelRequest);
+        return;
+    }
+    throw new Error("Channel adapter command kind is invalid");
+}
+function validateChannelRequest(value) {
+    const request = requireObject(value, "human decision channel request");
+    if (request.schema !== "pi-workflows.human-decision-channel-request.v1" ||
+        request.sourceSchema !== "pi-workflows.human-decision-request.v1" ||
+        Object.hasOwn(request, "subject")) {
+        throw new Error("Human decision channel request is invalid");
+    }
+    for (const field of [
+        "decisionId",
+        "requestDigest",
+        "runId",
+        "workflowName",
+        "nodeId",
+        "attemptId",
+        "audience",
+        "title",
+        "presentationDigest",
+        "createdAt",
+    ]) {
+        requireText(request[field], field);
+    }
+    requireNonNegativeInteger(request.revision, "decision revision");
+    requireObject(request.presentation, "decision presentation");
+    requireObject(request.choices, "decision choices");
+    requireOptionalText(request.expiresAt, "decision expiry");
+    if (request.defaultResponse !== undefined)
+        validateDecisionResponse(request.defaultResponse);
+}
+function validateDecisionResponse(value) {
+    const response = requireObject(value, "human decision response");
+    requireText(response.choice, "decision choice");
+    if (response.input === undefined)
+        return;
+    const input = requireObject(response.input, "decision input");
+    if (Object.values(input).some((item) => typeof item !== "string")) {
+        throw new Error("Decision input values must be strings");
+    }
+}
+function validateMessageReference(value) {
+    const reference = requireObject(value, "Telegram message reference");
+    requireText(reference.chatId, "Telegram chat ID");
+    requireText(reference.messageId, "Telegram message ID");
+    requireNonNegativeInteger(reference.recipientIndex, "Telegram recipient index");
+    requireNonNegativeInteger(reference.partIndex, "Telegram part index");
+    requireText(reference.contentDigest, "Telegram content digest");
+}
+function requireObject(value, label) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error(`${label} must be an object`);
+    }
+    return value;
+}
+function requireText(value, label) {
+    if (typeof value !== "string" || value.length === 0)
+        throw new Error(`${label} is invalid`);
+}
+function requireOptionalText(value, label) {
+    if (value !== undefined)
+        requireText(value, label);
+}
+function requirePositiveInteger(value, label) {
+    if (!Number.isSafeInteger(value) || value <= 0)
+        throw new Error(`${label} is invalid`);
+}
+function requireNonNegativeInteger(value, label) {
+    if (!Number.isSafeInteger(value) || value < 0)
+        throw new Error(`${label} is invalid`);
+}
+function requireStringArray(value, label) {
+    if (!Array.isArray(value) ||
+        value.length === 0 ||
+        value.some((item) => typeof item !== "string" || item.length === 0)) {
+        throw new Error(`${label} is invalid`);
+    }
+}
+function requireOneOf(value, allowed, label) {
+    if (typeof value !== "string" || !allowed.includes(value))
+        throw new Error(`${label} is invalid`);
+}
+function parseObject(frame, label) {
+    let value;
+    try {
+        value = JSON.parse(frame.toString("utf8"));
+    }
+    catch {
+        throw new Error(`${label} is not valid JSON`);
+    }
+    return requireObject(value, label);
+}
+//# sourceMappingURL=protocol.js.map

package/dist/channels/protocol.js.map

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

package/dist/channels/telegram.d.ts

@@ -0,0 +1,46 @@
+import type { HumanDecisionChannelRequest, HumanDecisionResponse } from "../workflows/types.js";
+import type { TelegramFetch } from "./config.js";
+import type { TelegramMessageReference } from "./protocol.js";
+export type TelegramVerifiedAnswer = {
+    request: HumanDecisionChannelRequest;
+    response: HumanDecisionResponse;
+    actorId: string;
+    chatId: string;
+    eventId: string;
+    cursor: number;
+};
+export declare class TelegramAdapter {
+    private readonly options;
+    private requests;
+    private readonly allowedUsers;
+    private readonly allowedChats;
+    private readonly request;
+    constructor(options: {
+        profile: string;
+        token: string;
+        allowedUserIds: readonly string[];
+        allowedChatIds: readonly string[];
+        fetchFn?: TelegramFetch;
+        apiBase?: string;
+    });
+    setRequests(requests: readonly HumanDecisionChannelRequest[]): void;
+    present(request: HumanDecisionChannelRequest): Promise<TelegramMessageReference[]>;
+    poll(cursor: number): Promise<{
+        cursor: number;
+        answers: TelegramVerifiedAnswer[];
+    }>;
+    settle(outcome: "accepted" | "cancelled" | "expired", response: HumanDecisionResponse | undefined, messages: readonly TelegramMessageReference[]): Promise<void>;
+    private handleUpdate;
+    private handleCallback;
+    private handleReply;
+    private keyboard;
+    private callbackBinding;
+    private replyBinding;
+    private callbackToken;
+    private replyToken;
+    private token;
+    private answerCallback;
+    private call;
+}
+export declare function renderDecisionText(request: HumanDecisionChannelRequest): string;
+export declare function renderTelegramParts(request: HumanDecisionChannelRequest): string[];

package/dist/channels/telegram.js

@@ -0,0 +1,285 @@
+import { createHmac } from "node:crypto";
+import { decisionDocumentSegments, digestCanonical } from "../workflows/decision-presentation.js";
+const DEFAULT_API_BASE = "https://api.telegram.org";
+const TELEGRAM_TEXT_LIMIT = 4_096;
+const CALLBACK_PREFIX = "pw:";
+const REPLY_TOKEN_PREFIX = "Reply token: ";
+export class TelegramAdapter {
+    options;
+    requests = [];
+    allowedUsers;
+    allowedChats;
+    request;
+    constructor(options) {
+        this.options = options;
+        this.allowedUsers = new Set(options.allowedUserIds);
+        this.allowedChats = new Set(options.allowedChatIds);
+        this.request = options.fetchFn ?? fetch;
+    }
+    setRequests(requests) {
+        this.requests = [...requests];
+    }
+    async present(request) {
+        const parts = renderTelegramParts(request);
+        const references = [];
+        const keyboard = this.keyboard(request);
+        for (const [recipientIndex, chatId] of [...this.allowedChats].entries()) {
+            for (const [partIndex, text] of parts.entries()) {
+                const result = await this.call("sendMessage", {
+                    chat_id: chatId,
+                    text,
+                    ...(partIndex === parts.length - 1
+                        ? { reply_markup: { inline_keyboard: keyboard } }
+                        : {}),
+                });
+                const messageId = integerField(result, "message_id", "Telegram sendMessage result");
+                references.push({
+                    chatId,
+                    messageId: String(messageId),
+                    recipientIndex,
+                    partIndex,
+                    contentDigest: digestCanonical(text),
+                });
+            }
+        }
+        return references;
+    }
+    async poll(cursor) {
+        const result = await this.call("getUpdates", {
+            offset: cursor,
+            timeout: 1,
+            allowed_updates: ["callback_query", "message"],
+        });
+        if (!Array.isArray(result))
+            throw new Error("Telegram getUpdates result must be an array");
+        let nextCursor = cursor;
+        const answers = [];
+        for (const raw of result) {
+            const update = asRecord(raw);
+            if (update === null || !Number.isSafeInteger(update.update_id))
+                continue;
+            const updateId = update.update_id;
+            nextCursor = Math.max(nextCursor, updateId + 1);
+            const answer = await this.handleUpdate(update, updateId + 1);
+            if (answer !== undefined)
+                answers.push(answer);
+        }
+        return { cursor: nextCursor, answers };
+    }
+    async settle(outcome, response, messages) {
+        const seenChats = new Set();
+        for (const message of messages) {
+            await this.call("editMessageReplyMarkup", {
+                chat_id: message.chatId,
+                message_id: Number.parseInt(message.messageId, 10),
+                reply_markup: { inline_keyboard: [] },
+            });
+            if (seenChats.has(message.chatId))
+                continue;
+            seenChats.add(message.chatId);
+            const selection = response?.choice === undefined ? "" : ` (${response.choice})`;
+            await this.call("sendMessage", {
+                chat_id: message.chatId,
+                text: `Decision ${outcome}${selection}.`,
+            });
+        }
+    }
+    async handleUpdate(update, cursor) {
+        const callback = asRecord(update.callback_query);
+        if (callback !== null)
+            return await this.handleCallback(callback, cursor);
+        const message = asRecord(update.message);
+        if (message !== null)
+            return await this.handleReply(message, cursor);
+        return undefined;
+    }
+    async handleCallback(callback, cursor) {
+        const callbackId = stringField(callback, "id");
+        const actor = asRecord(callback.from);
+        const message = asRecord(callback.message);
+        const chat = asRecord(message?.chat);
+        const actorId = numericText(actor?.id);
+        const chatId = numericText(chat?.id);
+        const data = typeof callback.data === "string" ? callback.data : "";
+        if (callbackId === undefined ||
+            actorId === undefined ||
+            chatId === undefined ||
+            !this.allowedUsers.has(actorId) ||
+            !this.allowedChats.has(chatId)) {
+            if (callbackId !== undefined) {
+                await this.answerCallback(callbackId, "This decision answer is not authorized.");
+            }
+            return undefined;
+        }
+        const binding = this.callbackBinding(data);
+        if (binding === undefined) {
+            await this.answerCallback(callbackId, "This decision choice is no longer active.");
+            return undefined;
+        }
+        const choice = binding.request.choices[binding.choice];
+        if (choice === undefined)
+            return undefined;
+        if (choice.input !== undefined) {
+            const token = this.replyToken(binding.request, binding.choice);
+            await this.call("sendMessage", {
+                chat_id: chatId,
+                text: `${choice.input.prompt}\n${REPLY_TOKEN_PREFIX}${token}`,
+                reply_markup: { force_reply: true, selective: true },
+            });
+            await this.answerCallback(callbackId, "Reply to the new prompt.");
+            return undefined;
+        }
+        await this.answerCallback(callbackId, "Answer received.");
+        return {
+            request: binding.request,
+            response: { choice: binding.choice },
+            actorId,
+            chatId,
+            eventId: callbackId,
+            cursor,
+        };
+    }
+    async handleReply(message, cursor) {
+        const actorId = numericText(asRecord(message.from)?.id);
+        const chatId = numericText(asRecord(message.chat)?.id);
+        const text = typeof message.text === "string" ? message.text.trim() : "";
+        const replyText = asRecord(message.reply_to_message)?.text;
+        const eventId = numericText(message.message_id);
+        if (actorId === undefined ||
+            chatId === undefined ||
+            eventId === undefined ||
+            text.length === 0 ||
+            typeof replyText !== "string" ||
+            !this.allowedUsers.has(actorId) ||
+            !this.allowedChats.has(chatId)) {
+            return undefined;
+        }
+        const marker = replyText.lastIndexOf(REPLY_TOKEN_PREFIX);
+        if (marker < 0)
+            return undefined;
+        const token = replyText
+            .slice(marker + REPLY_TOKEN_PREFIX.length)
+            .trim()
+            .split(/\s/u)[0];
+        if (token === undefined)
+            return undefined;
+        const binding = this.replyBinding(token);
+        if (binding === undefined)
+            return undefined;
+        const choice = binding.request.choices[binding.choice];
+        if (choice?.input === undefined)
+            return undefined;
+        return {
+            request: binding.request,
+            response: { choice: binding.choice, input: { [choice.input.name]: text } },
+            actorId,
+            chatId,
+            eventId,
+            cursor,
+        };
+    }
+    keyboard(request) {
+        return Object.entries(request.choices).map(([choice, definition]) => [
+            {
+                text: definition.label,
+                callback_data: `${CALLBACK_PREFIX}${this.callbackToken(request, choice)}`,
+            },
+        ]);
+    }
+    callbackBinding(data) {
+        if (!data.startsWith(CALLBACK_PREFIX))
+            return undefined;
+        const token = data.slice(CALLBACK_PREFIX.length);
+        for (const request of this.requests) {
+            for (const choice of Object.keys(request.choices)) {
+                if (this.callbackToken(request, choice) === token)
+                    return { request, choice };
+            }
+        }
+        return undefined;
+    }
+    replyBinding(token) {
+        for (const request of this.requests) {
+            for (const [choice, definition] of Object.entries(request.choices)) {
+                if (definition.input !== undefined && this.replyToken(request, choice) === token) {
+                    return { request, choice };
+                }
+            }
+        }
+        return undefined;
+    }
+    callbackToken(request, choice) {
+        return this.token("callback", request, choice);
+    }
+    replyToken(request, choice) {
+        return this.token("reply", request, choice);
+    }
+    token(purpose, request, choice) {
+        return createHmac("sha256", this.options.token)
+            .update(`${purpose}\0${this.options.profile}\0${request.requestDigest}\0${choice}`)
+            .digest("base64url")
+            .slice(0, 32);
+    }
+    async answerCallback(callbackQueryId, text) {
+        await this.call("answerCallbackQuery", { callback_query_id: callbackQueryId, text });
+    }
+    async call(method, payload) {
+        const apiBase = this.options.apiBase ?? DEFAULT_API_BASE;
+        const response = await this.request(`${apiBase}/bot${encodeURIComponent(this.options.token)}/${method}`, {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify(payload),
+        });
+        if (!response.ok)
+            throw new Error(`Telegram ${method} failed with HTTP ${response.status}`);
+        const body = asRecord(await response.json());
+        if (body?.ok !== true)
+            throw new Error(`Telegram ${method} was rejected`);
+        return body.result;
+    }
+}
+export function renderDecisionText(request) {
+    return decisionDocumentSegments(request)
+        .map((segment) => segment.text)
+        .join("\n\n");
+}
+export function renderTelegramParts(request) {
+    const text = renderDecisionText(request);
+    if (text.length <= TELEGRAM_TEXT_LIMIT)
+        return [text];
+    const parts = [];
+    let remaining = text;
+    while (remaining.length > TELEGRAM_TEXT_LIMIT) {
+        const window = remaining.slice(0, TELEGRAM_TEXT_LIMIT);
+        const boundary = Math.max(window.lastIndexOf("\n\n"), window.lastIndexOf("\n"));
+        const cut = boundary > TELEGRAM_TEXT_LIMIT / 2 ? boundary : TELEGRAM_TEXT_LIMIT;
+        parts.push(remaining.slice(0, cut));
+        remaining = remaining.slice(cut).replace(/^\n+/u, "");
+    }
+    if (remaining.length > 0)
+        parts.push(remaining);
+    return parts;
+}
+function integerField(value, field, label) {
+    const record = asRecord(value);
+    const result = record?.[field];
+    if (!Number.isSafeInteger(result))
+        throw new Error(`${label} ${field} must be an integer`);
+    return result;
+}
+function stringField(value, field) {
+    return typeof value[field] === "string" ? value[field] : undefined;
+}
+function numericText(value) {
+    if (typeof value === "number" && Number.isSafeInteger(value))
+        return String(value);
+    if (typeof value === "string" && /^-?[0-9]+$/u.test(value))
+        return value;
+    return undefined;
+}
+function asRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : null;
+}
+//# sourceMappingURL=telegram.js.map

package/dist/channels/telegram.js.map

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

package/dist/client/client.d.ts

@@ -57,6 +57,7 @@ export declare class WorkflowClient {
     }): Promise<() => Promise<void>>;
     watchSession(sessionId: string, listener: (event: ClientEvent) => void, options?: {
         subscriptionId?: string;
+        coordinator?: boolean;
     }): Promise<() => Promise<void>>;
     ensureAvailable(): Promise<ClientHello>;
     ensureRunning(): Promise<ClientResponse>;

package/dist/client/client.js

@@ -99,7 +99,11 @@ export class WorkflowClient {
         }, listener);
     }
     async watchSession(sessionId, listener, options = {}) {
-        return await this.subscribe("view.session.watch", undefined, { subscriptionId: options.subscriptionId ?? randomUUID(), sessionId }, listener);
+        return await this.subscribe("view.session.watch", undefined, {
+            subscriptionId: options.subscriptionId ?? randomUUID(),
+            sessionId,
+            ...(options.coordinator === undefined ? {} : { coordinator: options.coordinator }),
+        }, listener);
     }
     async ensureAvailable() {
         try {