@llblab/pi-kit 0.29.1 → 0.30.0

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

@@ -8,7 +8,8 @@ const DEFAULT_FRESH_CREATION_GRACE_MS = 30_000;
 function targetKey(target) {
     return `${target.chatId}:${target.threadId}`;
 }
-function isCurrentRecord(record) {
+/** A Thread record still claims its slot/target while active, starting or pending. */
+export function isCurrentThreadRecord(record) {
     return (record.status === "active" ||
         record.status === "starting" ||
         record.status === "pending");
@@ -50,13 +51,12 @@ function isCleanupAction(action) {
         action.kind === "close-stale-replaced-topic" ||
         action.kind === "close-delete-replaced-follower-topic" ||
         action.kind === "close-delete-previous-leader-topic" ||
-        action.kind === "close-delete-disconnected-instance-topic" ||
         action.kind === "close-delete-graceful-shutdown-topic" ||
         action.kind === "cancel-superseded-graceful-shutdown-cleanup" ||
         action.kind === "close-delete-expired-pending-provision-topic");
 }
 function isSyncAction(action) {
-    return action.kind === "mark-topic-active" || action.kind === "mark-topic-stale";
+    return (action.kind === "mark-topic-active" || action.kind === "mark-topic-stale");
 }
 function createThreadReconciliationMachineState(input, actions) {
     const pendingProvisionCount = (input.pendingProvisions ?? []).filter((provision) => isPendingProvisionAlive(provision, input.nowMs, input.currentLeaderEpoch)).length;
@@ -101,26 +101,34 @@ function createThreadReconciliationTransition(previous, current) {
 function getActionLeaderEpoch(action) {
     return "leaderEpoch" in action ? action.leaderEpoch : undefined;
 }
+/** Pure Bot API vocabulary for a deleted/missing Thread; callers own their HTTP-status policy. */
+export function isTelegramTopicDeletedErrorMessage(message) {
+    const text = message.toLowerCase();
+    return [
+        "topic_id_invalid",
+        "message thread not found",
+        "thread not found",
+        "topic not found",
+        "topic deleted",
+    ].some((fragment) => text.includes(fragment));
+}
+/** Pure Bot API vocabulary for a closed Thread; closure is not deletion evidence. */
+export function isTelegramTopicClosedErrorMessage(message) {
+    const text = message.toLowerCase();
+    return [
+        "topic closed",
+        "thread closed",
+        "forum topic closed",
+        "message thread closed",
+    ].some((fragment) => text.includes(fragment));
+}
 function isTelegramTopicTargetDeletedOrMissingError(error) {
-    if (!(error instanceof Error))
-        return false;
-    const message = error.message.toLowerCase();
-    return (message.includes("topic_id_invalid") ||
-        message.includes("message thread not found") ||
-        message.includes("thread not found") ||
-        message.includes("topic not found") ||
-        message.includes("topic deleted"));
+    return (error instanceof Error && isTelegramTopicDeletedErrorMessage(error.message));
 }
 function isTelegramTopicTargetGoneError(error) {
-    if (isTelegramTopicTargetDeletedOrMissingError(error))
-        return true;
-    if (!(error instanceof Error))
-        return false;
-    const message = error.message.toLowerCase();
-    return (message.includes("topic closed") ||
-        message.includes("thread closed") ||
-        message.includes("forum topic closed") ||
-        message.includes("message thread closed"));
+    return (error instanceof Error &&
+        (isTelegramTopicDeletedErrorMessage(error.message) ||
+            isTelegramTopicClosedErrorMessage(error.message)));
 }
 function shouldSkipForStaleLeaderEpoch(action, ports) {
     const actionLeaderEpoch = getActionLeaderEpoch(action);
@@ -178,21 +186,58 @@ export function createThreadReconciliationRuntime(deps) {
         },
     };
 }
-export function planDisconnectedInstanceThreadCleanup(input) {
+export function prepareLiveRebindThreadCleanup(input) {
+    const { operationId, oldTarget, recipientTarget, leaderEpoch, work } = input;
+    const validTarget = (target) => Number.isSafeInteger(target?.chatId) &&
+        target.chatId !== 0 &&
+        Number.isSafeInteger(target.threadId) &&
+        target.threadId > 0;
+    if (!operationId?.trim() ||
+        !leaderEpoch?.trim() ||
+        !validTarget(oldTarget) ||
+        !validTarget(recipientTarget) ||
+        oldTarget.chatId !== recipientTarget.chatId ||
+        oldTarget.threadId === recipientTarget.threadId ||
+        input.targetProtected !== false ||
+        work?.sessionBusy !== false ||
+        work.targetWork !== false ||
+        work.deliveryPending !== false ||
+        work.unknown !== false)
+        return undefined;
     return {
-        actions: [
-            {
-                kind: "close-delete-disconnected-instance-topic",
-                target: input.target,
-                reason: "manual-disconnect",
-                instanceId: input.instanceId,
-                ...(input.leaderEpoch !== undefined
-                    ? { leaderEpoch: input.leaderEpoch }
-                    : {}),
-            },
-        ],
+        status: "prepared",
+        operationId,
+        target: { ...oldTarget },
+        recipientTarget: { ...recipientTarget },
+        leaderEpoch,
     };
 }
+/**
+ * One unretried deletion for an already issued live-rebind cleanup grant. Success or confirmed absence is `confirmed`;
+ * protection or authority loss before the request and a definite request rejection are `failed`; every other outcome is
+ * `unknown`. The caller owns the durable issue marker and terminal record; this never repeats or rolls back.
+ */
+export async function issueLiveRebindThreadCleanup(prepared, ports) {
+    const target = { ...prepared.target };
+    try {
+        ports.assertCurrent();
+    }
+    catch {
+        return "failed";
+    }
+    try {
+        await ports.deleteTopic(target);
+    }
+    catch (error) {
+        const failure = ports.classifyFailure(error);
+        return failure === "absent"
+            ? "confirmed"
+            : failure === "rejected"
+                ? "failed"
+                : "unknown";
+    }
+    return "confirmed";
+}
 export async function applyThreadReconciliationPlan(plan, ports) {
     let shouldPersist = false;
     const persistFences = [];
@@ -276,7 +321,6 @@ export async function applyThreadReconciliationPlan(plan, ports) {
             action.kind === "close-delete-reserved-topic" ||
             action.kind === "close-delete-replaced-follower-topic" ||
             action.kind === "close-delete-previous-leader-topic" ||
-            action.kind === "close-delete-disconnected-instance-topic" ||
             action.kind === "close-delete-graceful-shutdown-topic" ||
             action.kind === "close-delete-expired-pending-provision-topic") {
             if (shouldSkipForStaleLeaderEpoch(action, ports)) {
@@ -295,7 +339,9 @@ export async function applyThreadReconciliationPlan(plan, ports) {
             }
             let deleteConfirmed = false;
             let superseded = false;
-            for (const method of ports.skipCloseBeforeDelete ? ["deleteForumTopic"] : ["closeForumTopic", "deleteForumTopic"]) {
+            for (const method of ports.skipCloseBeforeDelete
+                ? ["deleteForumTopic"]
+                : ["closeForumTopic", "deleteForumTopic"]) {
                 if (ports.isCleanupTargetProtected?.(action.target, action)) {
                     superseded = true;
                     break;
@@ -331,7 +377,8 @@ export async function applyThreadReconciliationPlan(plan, ports) {
                 incompleteActions.push(action);
                 continue;
             }
-            if (superseded || ports.isCleanupTargetProtected?.(action.target, action)) {
+            if (superseded ||
+                ports.isCleanupTargetProtected?.(action.target, action)) {
                 ports.recordRuntimeEvent?.("telegram", "Cancelled cleanup of a protected Telegram target", {
                     phase: "thread-reconciler-cleanup-target-reused",
                     action: action.kind,
@@ -356,7 +403,6 @@ export async function applyThreadReconciliationPlan(plan, ports) {
                 continue;
             if (action.kind !== "close-delete-previous-leader-topic" &&
                 action.kind !== "close-delete-replaced-follower-topic" &&
-                action.kind !== "close-delete-disconnected-instance-topic" &&
                 action.kind !== "close-delete-expired-pending-provision-topic") {
                 const changed = ports.markStaleByTarget?.(action.target, "deleted") ?? false;
                 if (changed)
@@ -371,11 +417,9 @@ export async function applyThreadReconciliationPlan(plan, ports) {
                         ? "Replaced follower Telegram topic deleted"
                         : action.kind === "close-delete-previous-leader-topic"
                             ? "Previous leader Telegram topic deleted"
-                            : action.kind === "close-delete-disconnected-instance-topic"
-                                ? "Disconnected instance Telegram topic deleted"
-                                : action.kind === "close-delete-graceful-shutdown-topic"
-                                    ? "Graceful shutdown Telegram topic deleted"
-                                    : "Expired pending provision Telegram topic deleted", {
+                            : action.kind === "close-delete-graceful-shutdown-topic"
+                                ? "Graceful shutdown Telegram topic deleted"
+                                : "Expired pending provision Telegram topic deleted", {
                 phase: action.kind === "close-delete-unbound-topic"
                     ? "thread-reconciler-unbound-topic-delete"
                     : action.kind === "close-delete-reserved-topic"
@@ -384,13 +428,9 @@ export async function applyThreadReconciliationPlan(plan, ports) {
                             ? "thread-reconciler-replaced-follower-topic-delete"
                             : action.kind === "close-delete-previous-leader-topic"
                                 ? "thread-reconciler-previous-leader-topic-delete"
-                                : action.kind ===
-                                    "close-delete-disconnected-instance-topic"
-                                    ? "thread-reconciler-disconnected-instance-topic-delete"
-                                    : action.kind ===
-                                        "close-delete-graceful-shutdown-topic"
-                                        ? "thread-reconciler-graceful-shutdown-topic-delete"
-                                        : "thread-reconciler-expired-pending-provision-topic-delete",
+                                : action.kind === "close-delete-graceful-shutdown-topic"
+                                    ? "thread-reconciler-graceful-shutdown-topic-delete"
+                                    : "thread-reconciler-expired-pending-provision-topic-delete",
                 chatId: action.target.chatId,
                 threadId: action.target.threadId,
                 ...("messageId" in action ? { messageId: action.messageId } : {}),
@@ -436,7 +476,7 @@ export function planThreadReconciliation(input) {
     const graceMs = input.freshCreationGraceMs ?? DEFAULT_FRESH_CREATION_GRACE_MS;
     const knownTargets = new Set(input.records.map((record) => targetKey(record.target)));
     const currentTargets = new Set(input.records
-        .filter(isCurrentRecord)
+        .filter(isCurrentThreadRecord)
         .map((record) => targetKey(record.target)));
     const reservedTargets = new Set((input.reservations ?? [])
         .filter((reservation) => isReservationAlive(reservation, input.nowMs))
@@ -449,7 +489,7 @@ export function planThreadReconciliation(input) {
         .map((observation) => targetKey(observation.target)));
     const actions = [];
     for (const cleanup of input.pendingCleanups ?? []) {
-        const superseded = input.records.some((record) => isCurrentRecord(record) &&
+        const superseded = input.records.some((record) => isCurrentThreadRecord(record) &&
             targetKey(record.target) === targetKey(cleanup.target) &&
             record.instanceId !== cleanup.instanceId);
         const common = {

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

@@ -3,15 +3,13 @@
  * Zones: multi-instance bus, Telegram UI threads, durable Workspace state
  * Owns live mappings, Workspace bindings and guarded Restore transitions; routing and transport effects stay outside.
  */
-import { type TelegramApiCallOptions } from "./telegram-api.ts";
 import { type TelegramTarget } from "./target.ts";
-export { chooseTelegramThreadName, createTelegramThreadName, getTelegramManualThreadDisplayNameValidationError, getTelegramTopicIdentityName, getTelegramTopicThreadNameValidationError, getTelegramTopicTitleForThreadName, isTelegramTopicThreadNameValidForSlot, type TelegramThreadNameInput, } from "./thread-naming.ts";
-export declare const getTelegramTopicName: (request: TelegramTopicTargetProvisionRequest, template?: string, slot?: string) => string;
-import { type TelegramWorkspaceBindingIdentity } from "./workspace-identity.ts";
-export { createTelegramWorkspaceBindingIdentity, createTelegramWorkspaceDirectoryKey, normalizeTelegramSessionId, normalizeTelegramWorkspacePath, type TelegramWorkspaceBindingIdentity, } from "./workspace-identity.ts";
-import { type TelegramLockRuntime, type TelegramLockContext, type TelegramRuntimeStateMutation, type TelegramOwnedStatePublicationOptions, type TelegramOwnedStatePublicationResult } from "./locks.ts";
+import { type TelegramApiCallOptions } from "./telegram-api.ts";
+import { type TelegramLockContext, type TelegramLockRuntime, type TelegramOwnedStatePublicationOptions, type TelegramOwnedStatePublicationResult, type TelegramRuntimeStateMutation } from "./locks.ts";
 import * as ThreadReconciler from "./thread-reconciler.ts";
+import { type TelegramWorkspaceBindingIdentity } from "./workspace-identity.ts";
 import { type TelegramWorkspaceSlotOccupancy } from "./workspace-slots.ts";
+export { createTelegramWorkspaceBindingIdentity, createTelegramWorkspaceDirectoryKey, normalizeTelegramSessionId, normalizeTelegramWorkspacePath, type TelegramWorkspaceBindingIdentity, } from "./workspace-identity.ts";
 export type TelegramTopicTargetStatus = "active" | "offline" | "stale" | "pending" | "starting" | "probe-required" | "failed";
 export type TelegramTopicSyncStatus = "open" | "closed" | "deleted" | "unknown";
 export type TelegramThreadOwner = {
@@ -247,12 +245,26 @@ export interface TelegramWorkspaceRestoreIntent {
         cleanup?: "issued" | "completed" | "not-issued";
     };
 }
+/** Live same-session metadata, never a legacy scoped ACK or permission to dispatch/delete. */
+export type TelegramWorkspaceLiveRebindIntent = Pick<TelegramWorkspaceRestoreIntent, "request" | "operatorUserId" | "executor" | "revision" | "createdAtMs" | "updatedAtMs"> & {
+    kind: "live-rebind";
+    recipient: TelegramWorkspaceRestoreRecipient;
+} & ({
+    phase: "rebound";
+    cleanup?: never;
+} | {
+    phase: "released";
+    cleanup?: "issued";
+} | {
+    phase: "finished";
+    cleanup: "confirmed" | "failed" | "unknown" | "not-issued";
+});
 /** Immutable source membership, not readiness, cancellation, or proof of complete Thread coverage. */
 export interface TelegramTemporaryThreadInput {
     journalBindingKey: string;
     updateIds: number[];
 }
-/** A strict journal observation of committed cancellation plus matching private retention. */
+/** Journal-owned donor discard evidence: retained manual cancellation or body-free chooser expiry, never recipient cancellation. */
 export interface TelegramTemporaryThreadCancellationEvidence {
     journalBindingKey: string;
     updateId: number;
@@ -266,7 +278,7 @@ export interface TelegramTemporaryThreadEntry {
     };
     /** Append-only known source groups. Missing legacy metadata never proves that the creation source was alone. */
     inputs?: TelegramTemporaryThreadInput[];
-    /** Whole known groups with positively observed cancellation; never proof that deletion may be issued. */
+    /** Whole known groups with positively observed donor cancellation or expiry; never recipient cancellation or deletion authority. */
     cancelledInputs?: TelegramTemporaryThreadInput[];
     /** Whole known groups whose Forward was positively completed by the journal owner; never deletion authority alone. */
     completedInputs?: TelegramTemporaryThreadInput[];
@@ -304,11 +316,19 @@ interface TelegramWorkspaceRestoreSnapshot {
     tokenSha256: string;
     revision: number;
     operations: TelegramWorkspaceRestoreIntent[];
+    liveRebindings?: TelegramWorkspaceLiveRebindIntent[];
     temporaryThreads?: TelegramTemporaryThreadEntry[];
 }
 /** Scope-bound Workspace operations; raw snapshot mutation is private to the store. */
 export interface TelegramWorkspaceRestore {
     list(): TelegramWorkspaceRestoreIntent[];
+    listLiveRebindings(): TelegramWorkspaceLiveRebindIntent[];
+    /** Caller has saved and held the selected input; this publishes the binding, not dispatch readiness. */
+    commitLiveRebind(request: TelegramWorkspaceRestoreRequest, recipient: TelegramWorkspaceRestoreRecipient, authority: TelegramWorkspaceRestoreAuthority): Promise<TelegramWorkspaceLiveRebindIntent | undefined>;
+    /** Caller proves local apply for release or current live clearance for cleanup; unknown issuance never repeats. */
+    advanceLiveRebind(expected: TelegramWorkspaceLiveRebindIntent, step: "release" | "issue-cleanup" | Extract<TelegramWorkspaceLiveRebindIntent, {
+        phase: "finished";
+    }>["cleanup"], authority: TelegramWorkspaceRestoreAuthority): TelegramWorkspaceLiveRebindIntent | undefined;
     commit(request: TelegramWorkspaceRestoreRequest, authority: TelegramWorkspaceRestoreAuthority): Promise<TelegramWorkspaceRestoreIntent | undefined>;
     adopt(expected: TelegramWorkspaceRestoreIntent, authority: TelegramWorkspaceRestoreAuthority): TelegramWorkspaceRestoreIntent | undefined;
     issueRecipient(expected: TelegramWorkspaceRestoreIntent, recipient: TelegramWorkspaceRestoreRecipient, authority: TelegramWorkspaceRestoreAuthority): {
@@ -361,6 +381,8 @@ export interface TelegramWorkspaceRestore {
     recordTemporaryThreadForwardIssued(expected: TelegramTemporaryThreadEntry, input: TelegramTemporaryThreadInput, authority: TelegramWorkspaceRestoreAuthority): TelegramTemporaryThreadEntry | undefined;
     recordTemporaryThreadInputCompletion(expected: TelegramTemporaryThreadEntry, input: TelegramTemporaryThreadInput, authority: TelegramWorkspaceRestoreAuthority): TelegramTemporaryThreadEntry | undefined;
     recordTemporaryThreadInputCancellation(expected: TelegramTemporaryThreadEntry, input: TelegramTemporaryThreadInput, authority: TelegramWorkspaceRestoreAuthority, inspect: (updateId: number) => TelegramTemporaryThreadCancellationEvidence | undefined): TelegramTemporaryThreadEntry | undefined;
+    /** Body-free chooser expiry may terminate an uncertain donor Forward/Restore, never accepted recipient work or a bound target. */
+    recordTemporaryThreadInputExpiry(expected: TelegramTemporaryThreadEntry, input: TelegramTemporaryThreadInput, authority: TelegramWorkspaceRestoreAuthority, inspect: (updateId: number) => TelegramTemporaryThreadCancellationEvidence | undefined): TelegramTemporaryThreadEntry | undefined;
     /** Caller holds profile admission and proves fresh source/protection clearance; publication grants one attempt, never retry. */
     issueTemporaryThreadCleanup(expected: TelegramTemporaryThreadEntry, authority: TelegramWorkspaceRestoreAuthority): {
         issued: true;
@@ -370,10 +392,11 @@ export interface TelegramWorkspaceRestore {
     /** `completed` names one newly completed group; every other known group must already be cancelled or completed. */
     retireTemporaryThread(expected: TelegramTemporaryThreadEntry, authority: TelegramWorkspaceRestoreAuthority, completed?: TelegramTemporaryThreadInput): TelegramTemporaryThreadEntry | undefined;
     /** New-world restart: atomically forgets this operator's Restore intents and temporary entries from previous runtime instances.
-     * Committed bindings stay; nothing is rolled back, replayed or deleted here. */
-    forgetPreviousWorld(authority: TelegramWorkspaceRestoreAuthority): {
+     * Caller may preserve exact unbound temporary tokens for clock-bearing sources. Committed bindings stay; nothing is rolled back, replayed or deleted here. */
+    forgetPreviousWorld(authority: TelegramWorkspaceRestoreAuthority, preserveTemporaryTokens?: readonly string[]): {
         operations: TelegramWorkspaceRestoreIntent[];
         temporaryThreads: TelegramTemporaryThreadEntry[];
+        liveRebindings?: TelegramWorkspaceLiveRebindIntent[];
     } | undefined;
 }
 export interface TelegramWorkspaceRestoreOptions {
@@ -424,7 +447,8 @@ export interface TelegramTopicTargetStore {
     load: () => Promise<void>;
     /** Discard process-local projections and reload owner-published state. */
     refresh?: () => Promise<void>;
-    persist: () => Promise<void>;
+    /** Optional caller fence supplements, never replaces, captured publication authority. */
+    persist: (isCurrent?: () => boolean) => Promise<void>;
     invalidateTarget: (target: TelegramTarget, isCurrent: () => boolean, lastSyncError: string) => Promise<boolean>;
     /** Caller proves owner detachment; this does not assert Telegram Thread absence. */
     detachTargetOwner: (expected: TelegramTopicTargetRecord, isCurrent: () => boolean) => Promise<boolean>;
@@ -439,7 +463,18 @@ export interface TelegramTopicTargetStore {
     /** Runs synchronous live publication under the same evidence transaction; caller retains authentication/admission. */
     commitWorkspaceRestoreRegistration: (candidate: Parameters<TelegramTopicTargetStore["assertWorkspaceRestoreRegistration"]>[0], publish: () => void) => void;
     /** Read-only canonical observation; the callback must finish synchronously under the snapshot transaction. */
-    withWorkspaceRestoreSnapshot: (expected: TelegramWorkspaceRestoreIntent, observe: (snapshot: Readonly<Pick<TelegramTopicTargetFile, "threads" | "workspaceBindings">>) => undefined) => void;
+    withWorkspaceRestoreSnapshot: (expected: TelegramWorkspaceRestoreIntent | TelegramWorkspaceLiveRebindIntent, observe: (snapshot: Readonly<Pick<TelegramTopicTargetFile, "threads" | "workspaceBindings">>) => undefined) => void;
+    /** Exact synchronous live-operation snapshot, including a current publication frame; no mutation, lock or authority grant. */
+    withWorkspaceLiveRebindSnapshot: (expected: TelegramWorkspaceLiveRebindIntent, observe: (snapshot: Readonly<Pick<TelegramTopicTargetFile, "threads" | "workspaceBindings">>) => undefined) => void;
+    /** Current live-origin ownership veto; effect callers still require Workspace admission. False is not work/recipient/deletion authority. */
+    isWorkspaceLiveRebindCleanupTargetProtected: (expected: TelegramWorkspaceLiveRebindIntent) => boolean;
+    /** Read-only captured identity with an optional exact manual-name result fence; no transport/session/admission grant or lock. */
+    captureWorkspaceThreadRenameObservation: (binding: TelegramWorkspaceThreadBinding, owner: TelegramTopicTargetRecord) => (expectedManualThreadName?: string) => boolean;
+    /** Captured read-only identity and exact absent-manual-name/automatic-title result fences; no authority grant or lock. */
+    captureWorkspaceThreadResetObservation: (binding: TelegramWorkspaceThreadBinding, owner: TelegramTopicTargetRecord) => {
+        isCurrent: () => boolean;
+        isResultCurrent: (automaticTitle: string) => boolean;
+    };
     /** Fresh strict disk read of acknowledged temporary-tab targets; throws rather than guessing absence. */
     listTemporaryThreadTargets: () => TelegramTarget[];
     list: () => TelegramTopicTargetRecord[];
@@ -524,14 +559,19 @@ export interface TelegramTopicTargetStore {
     renameByTarget: (target: TelegramTarget, threadName: string, options?: {
         updateDisplayTitle: boolean;
     }) => TelegramTopicTargetRecord | undefined;
+    /** Publish a manual-name candidate without first retaining it in the dirty local projection. */
+    renameByTargetAndPersist: (target: TelegramTarget, threadName: string, options: {
+        updateDisplayTitle: boolean;
+    }, isCurrent: () => boolean) => Promise<TelegramTopicTargetRecord | undefined>;
     clearManualNameByTarget: (target: TelegramTarget, automaticTitle: string) => TelegramTopicTargetRecord | undefined;
+    /** Stage exact manual-name removal and automatic display metadata in the existing publication candidate. */
+    clearManualNameByTargetAndPersist: (target: TelegramTarget, automaticTitle: string, isCurrent: () => boolean) => Promise<TelegramTopicTargetRecord | undefined>;
     allocateSlot: (profileKey: string, preferredSlot?: string, workspaceBindingKey?: string, options?: {
         excludeCurrentRecord?: boolean;
     }) => string | undefined;
     /** Claim the first reusable inactive thread for an instance, linking it to instanceId. */
     claimReusableTarget: (instanceId: string, threadName?: string) => TelegramTopicTargetRecord | undefined;
 }
-export declare function reconcileTelegramFreshAllocationCursor(store: Pick<TelegramTopicTargetStore, "getBotState" | "list" | "setBotState">, nowMs?: number): boolean;
 export declare function createTelegramCleanupTargetProtection(store: Pick<TelegramTopicTargetStore, "list"> & Partial<Pick<TelegramTopicTargetStore, "listReservations" | "listPendingProvisions" | "listPendingCleanups" | "listTemporaryThreadTargets">>, departingRecord?: TelegramTopicTargetRecord): NonNullable<ThreadReconciler.ThreadReconciliationApplyPorts["isCleanupTargetProtected"]>;
 export interface TelegramTopicTargetStoreOptions {
     path: string | (() => string);
@@ -554,8 +594,10 @@ export interface TelegramTopicTargetProvisionerDeps {
     claimPendingTargets?: boolean;
 }
 export interface TelegramTopicTargetRenamerDeps {
-    store: Pick<TelegramTopicTargetStore, "renameByTarget" | "list" | "listWorkspaceBindings" | "listPendingProvisions">;
-    callApi: <TResponse>(method: string, body: Record<string, unknown>) => Promise<TResponse>;
+    store: Pick<TelegramTopicTargetStore, "list" | "listWorkspaceBindings" | "listPendingProvisions"> & {
+        renameByTarget: (...args: Parameters<TelegramTopicTargetStore["renameByTarget"]>) => ReturnType<TelegramTopicTargetStore["renameByTarget"]> | Promise<ReturnType<TelegramTopicTargetStore["renameByTarget"]>>;
+    };
+    callApi: <TResponse>(method: string, body: Record<string, unknown>, options?: TelegramApiCallOptions) => Promise<TResponse>;
     assertAuthority?: () => void;
     shouldRenameDisplayedTitle?: () => boolean;
     topicNameTemplate?: string;
@@ -595,8 +637,6 @@ export interface TelegramTopicTargetProvisionResult {
     record: TelegramTopicTargetRecord;
     displayTitle?: string;
 }
-export declare function getTelegramStatePath(agentDir?: string, profileName?: string): string;
-export declare function getTelegramTopicTargetsPath(agentDir?: string, profileName?: string): string;
 export declare const TELEGRAM_LEADER_SESSION_HANDOFF_TTL_MS = 30000;
 export interface TelegramLeaderSessionHandoff {
     pid: number;
@@ -703,6 +743,37 @@ export declare function resolveTelegramInstanceThreadIdentity(options: {
     leader?: TelegramInstanceThreadIdentityCandidate;
     record?: TelegramTopicTargetRecord;
 }): TelegramInstanceThreadIdentityCandidate;
+export interface TelegramWorkspaceThreadRenameAuthority {
+    context: unknown;
+    sessionId?: string;
+    sessionGeneration: number;
+    cwd?: string;
+    profileName?: string;
+    botToken?: string;
+    operatorUserId?: number;
+    leaderEpoch?: string | number;
+    ownsDirectDelivery: boolean;
+    followerRegistered: boolean;
+    localTarget?: TelegramTarget;
+    localSlot?: string;
+}
+interface TelegramWorkspaceThreadNameRecipientDeps {
+    store: TelegramTopicTargetStore;
+    instanceId: string;
+    target: TelegramTarget;
+    assertAuthority: () => void;
+    getAuthority: () => TelegramWorkspaceThreadRenameAuthority;
+}
+/** Prepared recipient identity/result fences; callers retain Workspace admission and transport effects. */
+export declare function createTelegramWorkspaceThreadRenameRecipient(deps: TelegramWorkspaceThreadNameRecipientDeps): {
+    assertAuthority: () => void;
+    assertResult: (result: TelegramTopicTargetRecord) => void;
+};
+/** Exact automatic-title/absent-name result fences, separate from recipient identity and issued effects. */
+export declare function createTelegramWorkspaceThreadResetRecipient(deps: TelegramWorkspaceThreadNameRecipientDeps): {
+    assertAuthority: () => void;
+    assertResult: (automaticTitle: string) => void;
+};
 export interface TelegramLeaderThreadStateRuntime {
     getTarget(): TelegramTarget | undefined;
     getIdentity(): TelegramInstanceThreadIdentityCandidate | undefined;
@@ -733,13 +804,6 @@ export declare function findCurrentTelegramInstanceThreadRecord(options: {
     instanceId: string;
     preferredTarget?: TelegramTarget;
 }): TelegramTopicTargetRecord | undefined;
-export declare function resolveTelegramInstanceThreadTarget(options: {
-    followerTarget?: TelegramTarget;
-    leaderTarget?: TelegramTarget;
-    currentRecord?: TelegramTopicTargetRecord;
-}): (TelegramTarget & {
-    threadId: number;
-}) | undefined;
 export interface TelegramThreadStatusProjectionRuntime {
     getBusRole(): "leader" | "follower" | undefined;
     getBusFollowers(): ReturnType<typeof listTelegramThreadStatusFollowers>;