@llblab/pi-kit 0.27.5 → 0.28.0

package/node_modules/@llblab/pi-telegram/dist/lib/bus.js

@@ -11,9 +11,10 @@ import { createConnection, createServer, } from "node:net";
 import { createRequire } from "node:module";
 import { platform as getPlatform, tmpdir } from "node:os";
 import { basename, dirname, join } from "node:path";
-import { classifyTelegramBusTransportError, createTelegramBusTransportTimeoutError, delayTelegramBusTransportRetry, getTelegramBusEndpointDiagnostics, getTelegramBusFollowerEndpoint, getTelegramBusLeaderEndpoint, getTelegramBusPipePath, getTelegramBusTransportRetryPolicy, isTelegramBusPipePath, isRetryableTelegramBusTransportError, probeTelegramBusEndpoint, } from "./bus-transport.js";
-import { TELEGRAM_QUEUE_HANDOFF_MAX_RECEIPTS, TELEGRAM_QUEUE_HANDOFF_PAYLOAD_MAX_BYTES, } from "./queue.js";
+import { classifyTelegramBusTransportError, createTelegramBusTransportTimeoutError, delayTelegramBusTransportRetry, getTelegramBusEndpointDiagnostics, getTelegramBusFollowerEndpoint, getTelegramBusLeaderEndpoint, getTelegramBusPipePath, getTelegramBusTransportRetryPolicy, TELEGRAM_BUS_MAX_DIRECT_UNIX_ENDPOINT_BYTES, isTelegramBusPipePath, isRetryableTelegramBusTransportError, probeTelegramBusEndpoint, } from "./bus-transport.js";
+import { parseTelegramQueueHandoffPayload, TELEGRAM_QUEUE_HANDOFF_PAYLOAD_MAX_BYTES, } from "./queue.js";
 import { isProcessAlive } from "./locks.js";
+import { isWireRecord as isRecord } from "./wire.js";
 import { resolveAgentDir } from "./paths.js";
 import { normalizeTelegramSessionReplacementIntent, } from "./threads.js";
 function readDarwinProcessStart(pid) {
@@ -22,7 +23,7 @@ function readDarwinProcessStart(pid) {
         stdio: ["ignore", "pipe", "ignore"],
     }).trim();
 }
-export function getTelegramProcessBirthProof(pid, options = {}) {
+function getTelegramProcessBirthProof(pid, options = {}) {
     if (pid <= 0)
         return { status: "unverifiable" };
     const platform = options.platform ?? getPlatform();
@@ -95,12 +96,14 @@ export function getTelegramProcessBirthIdentityLiveness(processBirthId, options
 export function createCurrentTelegramBusProcessRuntime(input) {
     return createTelegramBusProcessRuntime({
         getActiveProfileName: input.getActiveProfileName,
+        endpointLayout: input.endpointLayout,
         pid: input.pid ?? process.pid,
         parentPid: input.parentPid ?? process.ppid,
         createdAtMs: input.createdAtMs ?? Date.now(),
     });
 }
 export function createTelegramBusProcessRuntime(input) {
+    const getActiveProfileName = input.getActiveProfileName, endpointLayout = input.endpointLayout;
     const instanceId = `${input.pid}:${input.createdAtMs}`;
     const ownerPid = input.parentPid || input.pid;
     const manualFollowerOwnerId = input.parentProcessIdentity ??
@@ -110,14 +113,14 @@ export function createTelegramBusProcessRuntime(input) {
         processId: input.pid,
         processBirthId: getTelegramProcessBirthIdentity(input.pid, instanceId),
         manualFollowerOwnerId,
-        getLeaderSocketPath: () => getTelegramBusSocketPath(undefined, undefined, input.getActiveProfileName()),
-        getFollowerSocketPath: () => getTelegramBusFollowerSocketPath(instanceId, undefined, undefined, input.getActiveProfileName()),
+        getLeaderSocketPath: () => getTelegramBusSocketPath(undefined, undefined, getActiveProfileName(), endpointLayout),
+        getFollowerSocketPath: () => getTelegramBusFollowerSocketPath(instanceId, undefined, undefined, getActiveProfileName(), endpointLayout),
     };
 }
 export function createTelegramBusAuthSecret() {
     return randomBytes(32).toString("base64url");
 }
-export const TELEGRAM_BUS_PROTOCOL_VERSION = 2;
+const TELEGRAM_BUS_PROTOCOL_VERSION = 2;
 export const TELEGRAM_BUS_CAPABILITY_DURABLE_FOLLOWER_ADMISSION = "durable-follower-admission-v1";
 export const TELEGRAM_BUS_CAPABILITY_QUEUE_HANDOFF = "queue-handoff-v1";
 export const TELEGRAM_BUS_CAPABILITY_INPUT_CUSTODY_REFERENCE = "input-custody-reference-v1";
@@ -126,6 +129,7 @@ export const TELEGRAM_BUS_CAPABILITY_THREAD_DISPLAY_MODE = "thread-display-mode-
 export const TELEGRAM_BUS_CAPABILITY_DIRECTORY_DISPLAY_FORMAT = "directory-display-format-v1";
 export const TELEGRAM_BUS_CAPABILITY_WORKSPACE_FOLLOWER_AUTO_CONNECT = "workspace-follower-auto-connect-v1";
 export const TELEGRAM_BUS_CAPABILITY_SESSION_REPLACEMENT_INTENT = "session-replacement-intent-v1";
+export const TELEGRAM_BUS_CAPABILITY_WORKSPACE_RESTORE = "workspace-restore-v1";
 export function createTelegramBusProtocolIdentity(input) {
     const runtimeBuild = input.runtimeBuild.trim();
     if (!runtimeBuild || runtimeBuild.length > 128) {
@@ -191,15 +195,16 @@ export function getTelegramBusProtocolCompatibility(input) {
         }
         : { compatible: true, missingCapabilities: [] };
 }
-export function getTelegramBusSocketPath(agentDir = resolveAgentDir(), platform = getPlatform(), profileName) {
-    return getTelegramBusLeaderEndpoint({ agentDir, platform, profileName });
+export function getTelegramBusSocketPath(agentDir = resolveAgentDir(), platform = getPlatform(), profileName, layout) {
+    return getTelegramBusLeaderEndpoint({ agentDir, platform, profileName, layout });
 }
-export function getTelegramBusFollowerSocketPath(instanceId, agentDir = resolveAgentDir(), platform = getPlatform(), profileName) {
+export function getTelegramBusFollowerSocketPath(instanceId, agentDir = resolveAgentDir(), platform = getPlatform(), profileName, layout) {
     return getTelegramBusFollowerEndpoint({
         agentDir,
         platform,
         instanceId,
         profileName,
+        layout,
     });
 }
 export function getTelegramFollowerTargetOwnership(input) {
@@ -229,7 +234,7 @@ export function markTelegramBusAggregateDelivery(body) {
         [TELEGRAM_BUS_AGGREGATE_DELIVERY_FIELD]: true,
     };
 }
-export function isTelegramBusAggregateDelivery(body) {
+function isTelegramBusAggregateDelivery(body) {
     return Boolean(body &&
         typeof body === "object" &&
         !Array.isArray(body) &&
@@ -242,7 +247,7 @@ export function markTelegramBusCrossTargetDelivery(body) {
         [TELEGRAM_BUS_CROSS_TARGET_DELIVERY_FIELD]: true,
     };
 }
-export function isTelegramBusCrossTargetDelivery(body) {
+function isTelegramBusCrossTargetDelivery(body) {
     return Boolean(body &&
         typeof body === "object" &&
         !Array.isArray(body) &&
@@ -542,8 +547,16 @@ export function parseTelegramBusEnvelope(line) {
         case "leader.forwardEditedMessage":
             envelope = parseForwardMessageEnvelope(value, requestId, "leader.forwardEditedMessage");
             break;
-        case "leader.replaceFollowerTarget":
-            envelope = parseReplaceFollowerTargetEnvelope(value, requestId);
+        case "leader.workspaceRestore":
+            if (typeof value.recipientInstanceId === "string" && value.recipientInstanceId &&
+                typeof value.recipientRegistrationGeneration === "string" && value.recipientRegistrationGeneration &&
+                typeof value.operationId === "string" && value.operationId.length > 0 && value.operationId.length <= 128 &&
+                (value.mode === "apply" || value.mode === "inspect") &&
+                typeof value.sentAtMs === "number" && Number.isFinite(value.sentAtMs)) {
+                envelope = { kind: "leader.workspaceRestore", requestId, recipientInstanceId: value.recipientInstanceId,
+                    recipientRegistrationGeneration: value.recipientRegistrationGeneration, operationId: value.operationId,
+                    mode: value.mode, sentAtMs: value.sentAtMs };
+            }
             break;
         case "leader.offerQueueHandoff":
             envelope = parseQueueHandoffEnvelope(value, requestId, "leader.offerQueueHandoff");
@@ -576,7 +589,6 @@ function getActiveTelegramBusLocalServers() {
     const root = globalThis;
     return (root[TELEGRAM_ACTIVE_LOCAL_SERVERS] ??= new Map());
 }
-const TELEGRAM_BUS_MAX_DIRECT_UNIX_ENDPOINT_BYTES = 80;
 export function resolveTelegramBusSocketPath(source, platform = getPlatform()) {
     const endpoint = typeof source === "function" ? source() : source;
     if (platform === "win32") {
@@ -892,67 +904,56 @@ export function listTelegramBusLiveThreadTargets(input) {
     }
     return targets;
 }
-export function createTelegramBusFollowerTargetController(deps) {
-    const getNowMs = deps.getNowMs ?? Date.now;
-    return {
-        async replaceTarget({ follower, target, oldTarget, reason }) {
-            if (!follower.busSocketPath || !follower.registrationGeneration) {
+/** Caller owns the durable one-shot apply grant. Inspections never grant another apply. */
+export function createTelegramBusWorkspaceRestoreController(deps) {
+    return async (input) => {
+        const isCurrent = input.isCurrent.bind(input);
+        if (!isCurrent())
+            return undefined;
+        const follower = deps.getFollower(input.instanceId);
+        const secret = deps.getAuthSecret();
+        if (!secret || !follower?.registrationGeneration || !follower.busSocketPath ||
+            follower.sessionId !== input.sessionId || follower.slot !== input.slot ||
+            !hasTelegramBusCapability(deps.localProtocolIdentity, TELEGRAM_BUS_CAPABILITY_WORKSPACE_RESTORE) ||
+            !hasTelegramBusCapability(follower.protocol, TELEGRAM_BUS_CAPABILITY_WORKSPACE_RESTORE) ||
+            !getTelegramBusProtocolCompatibility({ local: deps.localProtocolIdentity, remote: follower.protocol }).compatible)
+            return undefined;
+        const captured = structuredClone(follower);
+        const expected = { operationId: input.operationId, sessionId: input.sessionId, slot: input.slot,
+            target: { ...input.target }, oldTarget: { ...input.oldTarget }, mode: input.mode };
+        const current = () => {
+            if (!isCurrent() || deps.getAuthSecret() !== secret ||
+                !hasTelegramBusCapability(deps.localProtocolIdentity, TELEGRAM_BUS_CAPABILITY_WORKSPACE_RESTORE))
                 return false;
-            }
-            const envelope = {
-                kind: "leader.replaceFollowerTarget",
-                requestId: deps.createRequestId(),
-                recipientInstanceId: follower.instanceId,
-                recipientRegistrationGeneration: follower.registrationGeneration,
-                target,
-                ...(oldTarget ? { oldTarget } : {}),
-                reason,
-                sentAtMs: getNowMs(),
-            };
-            if (deps.getAuthSecret)
-                envelope.auth = deps.getAuthSecret();
-            const response = await sendTelegramBusLocalEnvelope({
-                socketPath: follower.busSocketPath,
-                envelope,
-                timeoutMs: deps.timeoutMs,
-                retry: getTelegramBusTransportRetryPolicy({
-                    endpoint: follower.busSocketPath,
-                    operation: "operation",
-                }),
-            });
-            return response?.kind === "bus.ack" && response.ok;
-        },
-    };
-}
-export function createTelegramBusFollowerThreadRestoreHandler(deps) {
-    return async ({ record, target, oldTarget }) => {
-        if (!record.instanceId)
-            return false;
-        const follower = deps.followerRegistry.get(record.instanceId);
-        if (!follower?.registrationGeneration || !oldTarget ||
-            follower.target?.chatId !== oldTarget.chatId ||
-            follower.target.threadId !== oldTarget.threadId ||
-            target.chatId !== oldTarget.chatId || target.threadId === oldTarget.threadId)
-            return false;
-        const replaced = await deps.followerTargetController.replaceTarget({
-            follower,
-            target,
-            oldTarget,
-            reason: "thread-restore",
-        });
-        const current = deps.followerRegistry.get(record.instanceId);
-        if (!replaced || !current ||
-            current.registrationGeneration !== follower.registrationGeneration ||
-            current.target?.chatId !== oldTarget.chatId ||
-            current.target.threadId !== oldTarget.threadId)
-            return false;
-        deps.followerRegistry.register({
-            ...current,
-            target,
-            connectedAtMs: current.connectedAtMs,
-        });
-        deps.onRestored?.();
-        return true;
+            const live = deps.getFollower(captured.instanceId);
+            return !!live && live.registrationGeneration === captured.registrationGeneration &&
+                live.sessionId === captured.sessionId && live.cwd === captured.cwd && live.slot === captured.slot &&
+                live.busSocketPath === captured.busSocketPath && live.target?.chatId === captured.target?.chatId &&
+                live.target?.threadId === captured.target?.threadId &&
+                hasTelegramBusCapability(live.protocol, TELEGRAM_BUS_CAPABILITY_WORKSPACE_RESTORE) &&
+                getTelegramBusProtocolCompatibility({ local: deps.localProtocolIdentity, remote: live.protocol }).compatible;
+        };
+        if (!current())
+            return undefined;
+        const requestId = deps.createRequestId();
+        const response = await sendTelegramBusLocalEnvelope({ socketPath: captured.busSocketPath, timeoutMs: deps.timeoutMs,
+            retry: { attempts: 1, delayMs: 0 }, envelope: { kind: "leader.workspaceRestore", requestId,
+                recipientInstanceId: captured.instanceId, recipientRegistrationGeneration: captured.registrationGeneration,
+                operationId: expected.operationId, mode: expected.mode, auth: secret, sentAtMs: Date.now() } });
+        if (!current() || response?.kind !== "bus.ack" || response.requestId !== requestId || response.ok !== true ||
+            !response.result || typeof response.result !== "object")
+            return undefined;
+        const result = response.result;
+        const recipient = result.recipient;
+        const target = parseThreadTarget(result.target);
+        const wanted = result.ready === true ? expected.target : expected.oldTarget;
+        if (result.operationId !== expected.operationId || typeof result.ready !== "boolean" || result.slot !== expected.slot ||
+            !target || target.chatId !== wanted.chatId || target.threadId !== wanted.threadId ||
+            recipient?.kind !== "follower" || recipient.instanceId !== captured.instanceId ||
+            recipient.sessionId !== expected.sessionId || recipient.generation !== captured.registrationGeneration)
+            return undefined;
+        return { operationId: expected.operationId, recipient: { kind: "follower", instanceId: captured.instanceId,
+                sessionId: expected.sessionId, generation: captured.registrationGeneration }, target, slot: expected.slot, ready: result.ready };
     };
 }
 export function isTelegramBusEnvelopeAuthorized(envelope, secret) {
@@ -1021,11 +1022,8 @@ export function createTelegramBusLocalServer(deps) {
             result: Promise.resolve().then(() => deps.handleEnvelope(envelope)),
         };
         requestLedger.set(key, entry);
-        void entry.result.then(() => {
-            entry.settled = true;
-        }, () => {
-            entry.settled = true;
-        });
+        const settled = () => { entry.settled = true; };
+        void entry.result.then(settled, settled);
         return entry.result;
     };
     let server;
@@ -1652,169 +1650,6 @@ function parseWakeInputCustodyEnvelope(value, requestId) {
             delivery, sentAtMs: value.sentAtMs }
         : undefined;
 }
-function parseReplaceFollowerTargetEnvelope(value, requestId) {
-    const target = parseThreadTarget(value.target);
-    const oldTarget = parseThreadTarget(value.oldTarget);
-    if (typeof value.recipientInstanceId !== "string" ||
-        !target ||
-        (value.oldTarget !== undefined && !oldTarget) ||
-        value.reason !== "thread-restore" ||
-        typeof value.sentAtMs !== "number") {
-        return undefined;
-    }
-    return {
-        kind: "leader.replaceFollowerTarget",
-        requestId,
-        recipientInstanceId: value.recipientInstanceId,
-        ...(typeof value.recipientRegistrationGeneration === "string"
-            ? {
-                recipientRegistrationGeneration: value.recipientRegistrationGeneration,
-            }
-            : {}),
-        target,
-        ...(oldTarget ? { oldTarget } : {}),
-        reason: value.reason,
-        sentAtMs: value.sentAtMs,
-    };
-}
-function parseQueueAdmissionReceipt(value, queueKind) {
-    if (!isRecord(value) || value.queueKind !== queueKind)
-        return undefined;
-    const sourceUpdateIds = Array.isArray(value.sourceUpdateIds)
-        ? value.sourceUpdateIds
-        : undefined;
-    if (typeof value.receiptId !== "string" ||
-        !value.receiptId ||
-        (value.journalBindingKey !== undefined &&
-            (typeof value.journalBindingKey !== "string" ||
-                !value.journalBindingKey.trim())) ||
-        !sourceUpdateIds ||
-        sourceUpdateIds.length === 0 ||
-        sourceUpdateIds.some((updateId, index) => !Number.isSafeInteger(updateId) ||
-            updateId < 0 ||
-            (index > 0 &&
-                updateId <=
-                    sourceUpdateIds[index - 1]))) {
-        return undefined;
-    }
-    return {
-        queueKind,
-        receiptId: value.receiptId,
-        sourceUpdateIds: sourceUpdateIds,
-        ...(typeof value.journalBindingKey === "string"
-            ? { journalBindingKey: value.journalBindingKey }
-            : {}),
-    };
-}
-function parseQueueHandoffPayload(value) {
-    if (!isRecord(value) || (value.kind !== "prompt" && value.kind !== "control")) {
-        return undefined;
-    }
-    const queueKind = value.kind;
-    const target = parseTarget(value.target);
-    const transportStamp = isRecord(value.transportStamp) &&
-        typeof value.transportStamp.profile === "string" &&
-        typeof value.transportStamp.generation === "string"
-        ? {
-            profile: value.transportStamp.profile,
-            generation: value.transportStamp.generation,
-        }
-        : undefined;
-    if (!Number.isSafeInteger(value.chatId) ||
-        (value.target !== undefined && !target) ||
-        (value.transportStamp !== undefined && !transportStamp) ||
-        !Number.isSafeInteger(value.replyToMessageId) ||
-        (value.guestQueryId !== undefined &&
-            typeof value.guestQueryId !== "string") ||
-        (value.guestInlineMessageId !== undefined &&
-            typeof value.guestInlineMessageId !== "string") ||
-        !Number.isSafeInteger(value.queueOrder) ||
-        (value.queueLane !== "control" &&
-            value.queueLane !== "priority" &&
-            value.queueLane !== "default") ||
-        !Number.isSafeInteger(value.laneOrder) ||
-        typeof value.statusSummary !== "string" ||
-        !Array.isArray(value.admissionReceipts)) {
-        return undefined;
-    }
-    const admissionReceipts = value.admissionReceipts.map((receipt) => parseQueueAdmissionReceipt(receipt, queueKind));
-    if (admissionReceipts.length === 0 ||
-        admissionReceipts.length > TELEGRAM_QUEUE_HANDOFF_MAX_RECEIPTS ||
-        admissionReceipts.some((receipt) => receipt === undefined)) {
-        return undefined;
-    }
-    const queueLane = value.queueLane;
-    const base = {
-        chatId: value.chatId,
-        ...(target ? { target } : {}),
-        ...(transportStamp ? { transportStamp } : {}),
-        replyToMessageId: value.replyToMessageId,
-        ...(typeof value.guestQueryId === "string"
-            ? { guestQueryId: value.guestQueryId }
-            : {}),
-        ...(typeof value.guestInlineMessageId === "string"
-            ? { guestInlineMessageId: value.guestInlineMessageId }
-            : {}),
-        queueOrder: value.queueOrder,
-        queueLane,
-        laneOrder: value.laneOrder,
-        statusSummary: value.statusSummary,
-        admissionReceipts: admissionReceipts,
-    };
-    if (queueKind === "control") {
-        if (value.queueLane !== "control" ||
-            (value.controlType !== "status" && value.controlType !== "model")) {
-            return undefined;
-        }
-        return { kind: "control", controlType: value.controlType, ...base };
-    }
-    if (value.queueLane === "control" ||
-        !Array.isArray(value.sourceMessageIds) ||
-        value.sourceMessageIds.some((id) => !Number.isSafeInteger(id)) ||
-        !Array.isArray(value.queuedAttachments) ||
-        value.queuedAttachments.some((attachment) => !isRecord(attachment) ||
-            typeof attachment.path !== "string" ||
-            typeof attachment.fileName !== "string") ||
-        !Array.isArray(value.content) ||
-        value.content.some((content) => !isRecord(content) ||
-            (content.type === "text"
-                ? typeof content.text !== "string"
-                : content.type === "image"
-                    ? typeof content.data !== "string" ||
-                        typeof content.mimeType !== "string"
-                    : true)) ||
-        typeof value.historyText !== "string" ||
-        (value.priorityEmoji !== undefined &&
-            typeof value.priorityEmoji !== "string") ||
-        (value.reactionSuppressionEmoji !== undefined &&
-            typeof value.reactionSuppressionEmoji !== "string") ||
-        (value.voiceReplyPreferred !== undefined &&
-            typeof value.voiceReplyPreferred !== "boolean") ||
-        (value.voiceReplyRequired !== undefined &&
-            typeof value.voiceReplyRequired !== "boolean")) {
-        return undefined;
-    }
-    return {
-        kind: "prompt",
-        ...base,
-        sourceMessageIds: value.sourceMessageIds,
-        queuedAttachments: value.queuedAttachments,
-        content: value.content,
-        historyText: value.historyText,
-        ...(typeof value.priorityEmoji === "string"
-            ? { priorityEmoji: value.priorityEmoji }
-            : {}),
-        ...(typeof value.reactionSuppressionEmoji === "string"
-            ? { reactionSuppressionEmoji: value.reactionSuppressionEmoji }
-            : {}),
-        ...(typeof value.voiceReplyPreferred === "boolean"
-            ? { voiceReplyPreferred: value.voiceReplyPreferred }
-            : {}),
-        ...(typeof value.voiceReplyRequired === "boolean"
-            ? { voiceReplyRequired: value.voiceReplyRequired }
-            : {}),
-    };
-}
 function parseQueueHandoffEnvelope(value, requestId, kind) {
     let serializedPayloadBytes;
     try {
@@ -1826,7 +1661,7 @@ function parseQueueHandoffEnvelope(value, requestId, kind) {
     if (serializedPayloadBytes > TELEGRAM_QUEUE_HANDOFF_PAYLOAD_MAX_BYTES) {
         return undefined;
     }
-    const payload = parseQueueHandoffPayload(value.payload);
+    const payload = parseTelegramQueueHandoffPayload(value.payload);
     if (!payload ||
         typeof value.recipientInstanceId !== "string" ||
         typeof value.recipientRegistrationGeneration !== "string" ||
@@ -2096,6 +1931,3 @@ function parseThreadTarget(value) {
         ? { chatId: target.chatId, threadId: target.threadId }
         : undefined;
 }
-function isRecord(value) {
-    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
-}

package/node_modules/@llblab/pi-telegram/dist/lib/channel-posts.d.ts

@@ -11,9 +11,6 @@ export interface TelegramChannelPostMediaIntent {
     sizeBytes: number;
     sha256: string;
 }
-export declare const TELEGRAM_CHANNEL_POST_MEDIA_MAX_BYTES: Record<TelegramChannelPostMediaKind, number>;
-export declare const TELEGRAM_CHANNEL_POST_CAPTION_MAX_LENGTH = 1024;
-export declare const TELEGRAM_CHANNEL_POST_MEDIA_FILE_NAME_MAX_LENGTH = 255;
 /** Safe, content-free local validation failure for channel media publication intent. */
 export declare class TelegramChannelPostValidationError extends Error {
     constructor(message: string);
@@ -70,6 +67,7 @@ export type TelegramChannelPostRecord = TelegramChannelPostRecordBase & ({
 } & TelegramPublishedChannelPostIdentity));
 export interface TelegramChannelPostJournalStoreOptions {
     path: string;
+    runtimeDir?: string;
     profileName: string;
     tokenSha256: string;
     maxRecords?: number;

package/node_modules/@llblab/pi-telegram/dist/lib/channel-posts.js

@@ -6,21 +6,23 @@
 import { chmodSync, closeSync, constants, createReadStream, fstatSync, lstatSync, mkdirSync, openSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
 import { lstat } from "node:fs/promises";
 import { basename, dirname } from "node:path";
+import { getTelegramJournalPublicationPaths } from "./paths.js";
 import { createHash, randomUUID } from "node:crypto";
 import { Type } from "@sinclair/typebox";
 import { renameTelegramPathWithRetry, withTelegramFileTransaction } from "./locks.js";
+import { isWireRecord as isRecord, hasOnlyWireKeys as hasOnlyKeys, isNonNegativeWireInteger as isSafeTime, } from "./wire.js";
 const CHANNEL_POST_JOURNAL_VERSION = 1;
 const DEFAULT_MAX_RECORDS = 256;
 const DEFAULT_MAX_BYTES = 4 * 1024 * 1024;
 const MAX_ID_LENGTH = 256;
 const MAX_MARKDOWN_LENGTH = 100_000;
 const MAX_CHANNEL_TITLE_LENGTH = 255;
-export const TELEGRAM_CHANNEL_POST_MEDIA_MAX_BYTES = {
+const TELEGRAM_CHANNEL_POST_MEDIA_MAX_BYTES = {
     photo: 10 * 1024 * 1024,
     video: 50 * 1024 * 1024,
 };
-export const TELEGRAM_CHANNEL_POST_CAPTION_MAX_LENGTH = 1024;
-export const TELEGRAM_CHANNEL_POST_MEDIA_FILE_NAME_MAX_LENGTH = 255;
+const TELEGRAM_CHANNEL_POST_CAPTION_MAX_LENGTH = 1024;
+const TELEGRAM_CHANNEL_POST_MEDIA_FILE_NAME_MAX_LENGTH = 255;
 /** Safe, content-free local validation failure for channel media publication intent. */
 export class TelegramChannelPostValidationError extends Error {
     constructor(message) {
@@ -195,16 +197,6 @@ export function registerTelegramChannelPostListTool(pi, deps) {
         },
     });
 }
-function isRecord(value) {
-    return !!value && typeof value === "object" && !Array.isArray(value);
-}
-function hasOnlyKeys(value, keys) {
-    const allowed = new Set(keys);
-    return Object.keys(value).every(key => allowed.has(key));
-}
-function isSafeTime(value) {
-    return Number.isSafeInteger(value) && value >= 0;
-}
 function normalizeChannel(value) {
     if (Number.isSafeInteger(value) && value < 0)
         return value;
@@ -312,7 +304,21 @@ function validateRecord(value) {
     }
     throw new TelegramChannelPostJournalError("invalid", "Telegram channel post journal contains an invalid state.");
 }
+function parseTelegramChannelPostJournalFile(value, profileName, tokenSha256) {
+    if (!isRecord(value) || !hasOnlyKeys(value, ["version", "profile", "tokenSha256", "records"]) ||
+        value.version !== CHANNEL_POST_JOURNAL_VERSION || value.profile !== profileName ||
+        value.tokenSha256 !== tokenSha256 || !Array.isArray(value.records)) {
+        throw new TelegramChannelPostJournalError("conflict", "Telegram channel post journal identity or schema does not match.");
+    }
+    const records = value.records.map(validateRecord);
+    if (new Set(records.map(record => record.operationId)).size !== records.length) {
+        throw new TelegramChannelPostJournalError("invalid", "Telegram channel post journal contains duplicate operation IDs.");
+    }
+    return { version: CHANNEL_POST_JOURNAL_VERSION, profile: profileName, tokenSha256, records };
+}
 export function createTelegramChannelPostJournalStore(options) {
+    options = { ...options };
+    const publicationPaths = getTelegramJournalPublicationPaths(options.path, options.runtimeDir);
     const maxRecords = options.maxRecords ?? DEFAULT_MAX_RECORDS;
     const maxBytes = options.maxBytes ?? DEFAULT_MAX_BYTES;
     const now = options.getNowMs ?? Date.now;
@@ -348,17 +354,7 @@ export function createTelegramChannelPostJournalStore(options) {
                 throw new TelegramChannelPostJournalError("conflict", "Telegram channel post journal changed during inspection.");
             }
             const value = JSON.parse(readFileSync(fd, "utf8"));
-            if (!isRecord(value) || !hasOnlyKeys(value, ["version", "profile", "tokenSha256", "records"]) ||
-                value.version !== CHANNEL_POST_JOURNAL_VERSION || value.profile !== options.profileName ||
-                value.tokenSha256 !== options.tokenSha256 || !Array.isArray(value.records)) {
-                throw new TelegramChannelPostJournalError("conflict", "Telegram channel post journal identity or schema does not match.");
-            }
-            const records = value.records.map(validateRecord);
-            if (new Set(records.map(record => record.operationId)).size !== records.length) {
-                throw new TelegramChannelPostJournalError("invalid", "Telegram channel post journal contains duplicate operation IDs.");
-            }
-            return { version: CHANNEL_POST_JOURNAL_VERSION, profile: options.profileName,
-                tokenSha256: options.tokenSha256, records };
+            return parseTelegramChannelPostJournalFile(value, options.profileName, options.tokenSha256);
         }
         catch (error) {
             if (error instanceof TelegramChannelPostJournalError)
@@ -378,8 +374,9 @@ export function createTelegramChannelPostJournalStore(options) {
         if (Buffer.byteLength(serialized) > maxBytes) {
             throw new TelegramChannelPostJournalError("capacity", "Telegram channel post journal byte limit reached.");
         }
-        const temporaryPath = `${options.path}.${process.pid}.${randomUUID()}.tmp`;
+        const temporaryPath = `${publicationPaths.temporaryBasePath}.${process.pid}.${randomUUID()}.tmp`;
         mkdirSync(dirname(options.path), { recursive: true, mode: 0o700 });
+        mkdirSync(dirname(temporaryPath), { recursive: true, mode: 0o700 });
         try {
             writeFileSync(temporaryPath, serialized, { encoding: "utf8", mode: 0o600 });
             chmodSync(temporaryPath, 0o600);
@@ -397,7 +394,7 @@ export function createTelegramChannelPostJournalStore(options) {
     };
     const mutate = (operation) => {
         try {
-            return withTelegramFileTransaction(`${options.path}.transaction`, () => operation(read()));
+            return withTelegramFileTransaction(publicationPaths.transactionPath, () => operation(read()));
         }
         catch (error) {
             if (error instanceof TelegramChannelPostJournalError)

package/node_modules/@llblab/pi-telegram/dist/lib/command-templates.d.ts

@@ -52,15 +52,10 @@ export interface CommandTemplateExecResult {
 }
 export type CommandTemplateRiskLabel = "risk.shell" | "risk.eval" | "risk.broad_fs_write" | "risk.destructive_fs" | "risk.network" | "risk.external_side_effect" | "risk.long_running" | "risk.platform_specific" | "risk.secret_touching";
 export declare function normalizeCommandTemplateConfig(config: CommandTemplateConfig): CommandTemplateObjectConfig;
-export declare function resolveInheritedDefaultReferences(ownDefaults: Record<string, unknown> | undefined, inheritedDefaults: Record<string, unknown> | undefined, runtimeValues?: Record<string, unknown>): Record<string, unknown> | undefined;
-export declare function resolveCommandTemplateRepeat(value: number | string | undefined, values?: Record<string, unknown>): number | undefined;
-export declare function getCommandTemplateRepeatDefaults(index: number, repeat: number): Record<string, string>;
 export declare function expandCommandTemplateConfigs(config: CommandTemplateConfig, inherited?: Pick<CommandTemplateObjectConfig, "args" | "defaults">): CommandTemplateLeafConfig[];
 export declare function getCommandTemplateWarnings(config: CommandTemplateConfig): string[];
 export declare function getCommandTemplateRiskLabels(config: CommandTemplateConfig): CommandTemplateRiskLabel[];
-export declare function getCommandTemplateDefaults(config: CommandTemplateConfig | undefined): Record<string, string>;
 export declare function splitCommandTemplate(input: string): string[];
-export declare function expandCommandTemplateExecutable(command: string, cwd: string): string;
 export declare function shouldRunCommandTemplateNode(value: boolean | string | undefined, values: Record<string, unknown>): boolean;
 export declare function substituteCommandTemplateToken(token: string, values: Record<string, unknown>, missingLabel?: string, depth?: number): string;
 export declare function execCommandTemplate(command: string, args: string[], options?: CommandTemplateExecOptions): Promise<CommandTemplateExecResult>;

package/node_modules/@llblab/pi-telegram/dist/lib/command-templates.js

@@ -43,7 +43,7 @@ function normalizeCommandTemplateDefaults(defaults) {
     }
     return normalized;
 }
-export function resolveInheritedDefaultReferences(ownDefaults, inheritedDefaults, runtimeValues = {}) {
+function resolveInheritedDefaultReferences(ownDefaults, inheritedDefaults, runtimeValues = {}) {
     if (!ownDefaults || !inheritedDefaults)
         return ownDefaults;
     const resolved = { ...ownDefaults };
@@ -59,7 +59,7 @@ export function resolveInheritedDefaultReferences(ownDefaults, inheritedDefaults
     }
     return resolved;
 }
-export function resolveCommandTemplateRepeat(value, values = {}) {
+function resolveCommandTemplateRepeat(value, values = {}) {
     if (value === undefined)
         return undefined;
     if (typeof value === "number") {
@@ -228,7 +228,7 @@ function getLeafCommandTemplateWarnings(config) {
 function pad(value, width) {
     return String(value).padStart(width, "0");
 }
-export function getCommandTemplateRepeatDefaults(index, repeat) {
+function getCommandTemplateRepeatDefaults(index, repeat) {
     const prev = (index - 1 + repeat) % repeat;
     const next = (index + 1) % repeat;
     const values = {
@@ -329,7 +329,7 @@ function parseCommandTemplatePlaceholderContent(content) {
         ...(match[2] !== undefined ? { inlineDefault: match[2] } : {}),
     };
 }
-export function getCommandTemplateDefaults(config) {
+function getCommandTemplateDefaults(config) {
     const normalizedConfig = config
         ? normalizeCommandTemplateConfig(config)
         : undefined;
@@ -406,7 +406,7 @@ export function splitCommandTemplate(input) {
         words.push(current);
     return words;
 }
-export function expandCommandTemplateExecutable(command, cwd) {
+function expandCommandTemplateExecutable(command, cwd) {
     if (command === "~")
         return homedir();
     if (command.startsWith("~/"))