@llblab/pi-kit 0.25.0 → 0.27.0

package/node_modules/@llblab/pi-telegram/lib/status.ts

@@ -1,9 +1,38 @@
 /**
  * Telegram status rendering helpers
  * Zones: telegram ui, pi agent diagnostics, tui
- * Builds usage, cost, and context summaries for the interactive Telegram status view
+ * Owns status summaries, redacted runtime diagnostics, and compact connection-failure copy
  */
 
+/** UI copy is allowlisted; raw exception text belongs only in redacted diagnostics. */
+export function formatTelegramConnectionFailure(error: unknown): string {
+  const message = error instanceof Error ? error.message : typeof error === "string" ? error : "";
+  const status = error && typeof error === "object" && "status" in error ? error.status : undefined;
+  const code = error && typeof error === "object" && "code" in error ? error.code : undefined;
+  if (status === 401) return "Telegram token rejected. Run /telegram-setup.";
+  if (status === 403) return "Telegram access denied. Check /telegram-status --debug.";
+  if ((typeof code === "string" && ["ECONNREFUSED", "ETIMEDOUT", "ENOTFOUND", "ECONNRESET"].includes(code)) ||
+      /network unavailable|fetch failed/i.test(message)) {
+    return "Telegram network unavailable. Retry /telegram-connect.";
+  }
+  if (/Workspace slots?.*(?:unavailable|exhausted)|no free.*slot/i.test(message)) {
+    return "No Telegram slot available. Check /telegram-status --debug.";
+  }
+  if (code === "incompatible-protocol" || /protocol.*(?:incompatible|mismatch)|incompatible.*protocol/i.test(message)) {
+    return "Telegram instances are incompatible. Update them together.";
+  }
+  if (/unsupported.*(?:journal|version)|(?:journal|version).*unsupported/i.test(message)) {
+    return "Telegram state version unsupported. Use a compatible runtime.";
+  }
+  if (/follower registration failed|active in another Pi instance/i.test(message)) {
+    return "Telegram leader is active but unavailable. Check /telegram-status --debug.";
+  }
+  if (/unfinished Thread creation does not match/i.test(message)) {
+    return "Telegram Thread creation is unresolved. Check /telegram-status --debug.";
+  }
+  return "Telegram connection failed. Check /telegram-status --debug.";
+}
+
 const TELEGRAM_STATUS_DEFAULT_PROFILE_NAME = "default";
 
 export type TelegramStatusQueueLane = "control" | "priority" | "default";

package/node_modules/@llblab/pi-telegram/lib/sync.ts

@@ -773,6 +773,7 @@ export async function ensureTelegramLeaderThreadBinding(
     : undefined;
   const legacyWorkspaceBinding =
     workspaceIdentity?.instanceSlot === "a" &&
+    deps.sessionId === undefined &&
     !persistedWorkspaceBinding &&
     typeof legacyLeaderRecord?.target.threadId === "number"
       ? {
@@ -885,10 +886,9 @@ export async function ensureTelegramLeaderThreadBinding(
       (record.status === "active" || record.status === "starting")
     );
   });
-  // Short-circuit: when the instance already has an active thread and we are not
-  // force-freshing, reuse it without re-provisioning. A thread belongs to the
-  // live instance binding, not to one transient Pi session lifecycle.
-  if (!deps.forceFreshUnnamed && priorTargets.length > 0) {
+  // Legacy callers without session identity may reuse the active instance target.
+  // Session-aware callers must resolve their exact Workspace binding instead.
+  if (deps.sessionId === undefined && !deps.forceFreshUnnamed && priorTargets.length > 0) {
     const record = priorTargets[0];
     deps.recordEvent(
       "telegram",

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

@@ -229,6 +229,7 @@ export interface TelegramThreadPendingProvision {
   owner: "leader" | "manual-follower";
   instanceId: string;
   profileKey?: string;
+  workspaceBindingKey?: string;
   status?: "in-flight" | "ambiguous";
   threadName?: string;
   displayTitle?: string;
@@ -1528,6 +1529,9 @@ function normalizePendingProvision(
     ...(record.status === "in-flight" || record.status === "ambiguous"
       ? { status: record.status }
       : {}),
+    ...(typeof record.workspaceBindingKey === "string"
+      ? { workspaceBindingKey: record.workspaceBindingKey }
+      : {}),
     ...(typeof record.threadName === "string"
       ? { threadName: record.threadName }
       : {}),
@@ -4919,6 +4923,13 @@ export function createTelegramTopicTargetProvisioner(
         pending.profileKey === request.profileKey ||
         pending.instanceId === request.instanceId,
       );
+    const pendingTarget = pendingForRequest?.target;
+    if (pendingForRequest && request.workspaceBindingKey &&
+        pendingForRequest.workspaceBindingKey !== request.workspaceBindingKey &&
+        !(pendingTarget && deps.store.listWorkspaceBindings().some((binding) =>
+          binding.bindingKey === request.workspaceBindingKey && targetMatches(binding.target, pendingTarget)))) {
+      throw new Error("Telegram unfinished Thread creation does not match this session binding.");
+    }
     if (pendingForRequest?.target) {
       const target = pendingForRequest.target;
       const observation = deps.store.listSyncObservations().find((entry) =>
@@ -4933,8 +4944,13 @@ export function createTelegramTopicTargetProvisioner(
         pendingForRequest = undefined;
       }
     }
+    const matchesWorkspace = (target: TelegramTarget): boolean =>
+      !request.workspaceBindingKey ||
+      deps.store.listWorkspaceBindings().some((binding) =>
+        binding.bindingKey === request.workspaceBindingKey && targetMatches(binding.target, target)) ||
+      (!!pendingForRequest?.target && targetMatches(pendingForRequest.target, target));
     const existing = deps.store.getByProfileKey(request.profileKey);
-    if (existing && isCurrentThreadRecord(existing)) {
+    if (existing && isCurrentThreadRecord(existing) && matchesWorkspace(existing.target)) {
       const slot = existing.slot ?? deps.store.allocateSlot(request.profileKey);
       if (!slot) {
         throw new TelegramWorkspaceSlotUnavailableError();
@@ -5017,7 +5033,7 @@ export function createTelegramTopicTargetProvisioner(
     const activeForInstance = deps.store.getActiveByInstanceId(
       request.instanceId,
     );
-    if (activeForInstance) {
+    if (activeForInstance && matchesWorkspace(activeForInstance.target)) {
       if (!activeForInstance.slot) {
         throw new Error("Telegram Workspace slot reservation is unavailable.");
       }
@@ -5055,7 +5071,7 @@ export function createTelegramTopicTargetProvisioner(
       getNextTelegramThreadNamePaletteSlot(deps.store.list(), undefined) ??
       request.preferredSlot;
     const slot =
-      existing?.slot ??
+      (existing && matchesWorkspace(existing.target) ? existing.slot : undefined) ??
       deps.store.allocateSlot(
         request.profileKey,
         isManualFollowerRequest
@@ -5064,6 +5080,7 @@ export function createTelegramTopicTargetProvisioner(
             (candidateThreadName ? undefined : identity?.slot) ??
             preferredNameSlot),
         request.workspaceBindingKey,
+        { excludeCurrentRecord: !!existing && !matchesWorkspace(existing.target) },
       );
     if (!slot) {
       throw new TelegramWorkspaceSlotUnavailableError();
@@ -5107,6 +5124,7 @@ export function createTelegramTopicTargetProvisioner(
       owner: pendingOwner,
       instanceId: request.instanceId,
       profileKey: request.profileKey,
+      ...(request.workspaceBindingKey ? { workspaceBindingKey: request.workspaceBindingKey } : {}),
       threadName: requestThreadName,
       ...(displayTitle ? { displayTitle } : {}),
       slot,

package/node_modules/@llblab/pi-telegram/lib/workspace-retirement.ts

@@ -884,6 +884,7 @@ export async function executeTelegramWorkspaceRetirement(input: {
     | "listWorkspaceRetirementIntents"
     | "commitWorkspaceRetirement"
     | "removeWorkspaceRetirementIntent"
+    | "markStaleByTarget"
     | "persist"
   >;
   admission: Pick<
@@ -971,6 +972,12 @@ export async function executeTelegramWorkspaceRetirement(input: {
       }
       return { kind: "retained", reason: "stale-intent" };
     }
+    if (fence?.phase === "commit-ready") {
+      // Exact confirmed absence retires any same-target routing record that
+      // survived the deletion attempt. The fence prevents replacement target
+      // publication while this stale local projection is removed.
+      input.store.markStaleByTarget(binding.target, "deleted");
+    }
     const eligible = () => input.store.captureWorkspaceSlotOccupancy(
       input.getExternalProtection,
       { expectedRetirement: input.intent },
@@ -1040,6 +1047,9 @@ export async function executeTelegramWorkspaceRetirement(input: {
       fence = input.admission.confirmRetirementAbsence(fence);
     }
     if (!isCurrent()) return { kind: "retained", reason: "authority-changed" };
+    if (fence.phase === "commit-ready") {
+      input.store.markStaleByTarget(binding.target, "deleted");
+    }
     if (!eligible()) return { kind: "retained", reason: "protection-changed" };
     if (!await input.store.commitWorkspaceRetirement(input.intent, isCurrent)) {
       return { kind: "retained", reason: "commit-rejected" };
@@ -1212,7 +1222,7 @@ export type TelegramWorkspaceRetirementLifecycleResult =
 export async function runTelegramWorkspaceRetirementLifecycle(input: {
   store: TelegramWorkspaceRetirementPreparationDeps["store"] & Pick<
     TelegramTopicTargetStore,
-    "replaceWorkspaceRetirementIntent" | "commitWorkspaceRetirement"
+    "replaceWorkspaceRetirementIntent" | "commitWorkspaceRetirement" | "markStaleByTarget"
   >;
   getExternalProtection: (
     binding: TelegramWorkspaceThreadBinding,
@@ -1257,19 +1267,42 @@ export async function runTelegramWorkspaceRetirementLifecycle(input: {
     });
   }
   if (intent) {
-    const adoption = await adoptTelegramWorkspaceRetirementIntent({
-      store: input.store,
-      intent,
-      getExternalProtection: input.getExternalProtection,
-      getLeaderEpoch: input.getLeaderEpoch,
-      getProfileKey: input.getProfileKey,
-      isCurrent: input.isCurrent,
-      runExclusive: input.runExclusive,
-    });
-    if (adoption.kind !== "adopted") {
-      return { kind: "blocked", stage: "adoption", reason: adoption.reason };
+    if (retainedFence && isTelegramWorkspaceRetirementFence(retainedFence) &&
+        retainedFence.phase === "commit-ready" &&
+        matchesTelegramWorkspaceRetirementFence(retainedFence, intent)) {
+      const resumed = await input.runExclusive(async () => {
+        const epoch = input.getLeaderEpoch();
+        const profileKey = input.getProfileKey();
+        const isCurrent = () => epoch !== undefined && input.getLeaderEpoch() === epoch &&
+          input.getProfileKey() === profileKey && input.isCurrent?.() !== false;
+        if (!isCurrent() || intent!.profileKey !== profileKey) return undefined;
+        const intents = input.store.listWorkspaceRetirementIntents();
+        const binding = input.store.listWorkspaceBindings().find(candidate =>
+          candidate.bindingKey === intent!.binding.bindingKey);
+        if (intents.length !== 1 || !isDeepStrictEqual(intents[0], intent) ||
+            !binding || !isDeepStrictEqual(binding, intent.binding)) return undefined;
+        if (intent!.leaderEpoch === epoch) return intent;
+        const replacement = { ...intent!, leaderEpoch: epoch! };
+        return await input.store.replaceWorkspaceRetirementIntent(intent!, replacement, isCurrent)
+          ? replacement : undefined;
+      });
+      if (!resumed) return { kind: "blocked", stage: "adoption", reason: "commit-rejected" };
+      intent = resumed;
+    } else {
+      const adoption = await adoptTelegramWorkspaceRetirementIntent({
+        store: input.store,
+        intent,
+        getExternalProtection: input.getExternalProtection,
+        getLeaderEpoch: input.getLeaderEpoch,
+        getProfileKey: input.getProfileKey,
+        isCurrent: input.isCurrent,
+        runExclusive: input.runExclusive,
+      });
+      if (adoption.kind !== "adopted") {
+        return { kind: "blocked", stage: "adoption", reason: adoption.reason };
+      }
+      intent = adoption.intent;
     }
-    intent = adoption.intent;
   } else {
     const preparation = await prepareTelegramWorkspaceRetirement(
       {

package/node_modules/@llblab/pi-telegram/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llblab/pi-telegram",
-  "version": "0.51.5",
+  "version": "0.51.6",
   "private": false,
   "publishConfig": {
     "access": "public"

package/node_modules/jsonc-parser/CHANGELOG.md

@@ -0,0 +1,76 @@
+3.3.0 2022-06-24
+=================
+- `JSONVisitor.onObjectBegin` and `JSONVisitor.onArrayBegin` can now return `false` to instruct the visitor that no children should be visited.
+
+
+3.2.0 2022-08-30
+=================
+- update the version of the bundled Javascript files to `es2020`.
+- include all `const enum` values in the bundled JavaScript files (`ScanError`, `SyntaxKind`, `ParseErrorCode`).
+
+3.1.0 2022-07-07
+==================
+  * added new API `FormattingOptions.keepLines` : It leaves the initial line positions in the formatting.
+
+3.0.0 2020-11-13
+==================
+  * fixed API spec for `parseTree`. Can return `undefine` for empty input.
+  * added new API `FormattingOptions.insertFinalNewline`.
+
+
+2.3.0 2020-07-03
+==================
+  * new API `ModificationOptions.isArrayInsertion`: If `JSONPath` refers to an index of an array and `isArrayInsertion` is `true`, then `modify` will insert a new item at that location instead of overwriting its contents.
+  * `ModificationOptions.formattingOptions` is now optional. If not set, newly inserted content will not be formatted.
+
+
+2.2.0 2019-10-25
+==================
+  * added `ParseOptions.allowEmptyContent`. Default is `false`.
+  * new API `getNodeType`: Returns the type of a value returned by parse.
+  * `parse`: Fix issue with empty property name
+
+2.1.0 2019-03-29
+==================
+ * `JSONScanner` and `JSONVisitor` return lineNumber / character.
+
+2.0.0 2018-04-12
+==================
+  * renamed `Node.columnOffset` to `Node.colonOffset`
+  * new API `getNodePath`: Gets the JSON path of the given JSON DOM node
+  * new API `findNodeAtOffset`: Finds the most inner node at the given offset. If `includeRightBound` is set, also finds nodes that end at the given offset.
+
+1.0.3 2018-03-07
+==================
+  * provide ems modules
+
+1.0.2 2018-03-05
+==================
+  * added the `visit.onComment` API, reported when comments are allowed.
+  * added the `ParseErrorCode.InvalidCommentToken` enum value, reported when comments are disallowed.
+
+1.0.1
+==================
+  * added the `format` API: computes edits to format a JSON document.
+  * added the `modify` API: computes edits to insert, remove or replace a property or value in a JSON document.
+  * added the `allyEdits` API: applies edits to a document
+
+1.0.0
+==================
+ * remove nls dependency (remove `getParseErrorMessage`)
+
+0.4.2 / 2017-05-05
+==================
+ * added `ParseError.offset` & `ParseError.length`
+
+0.4.1 / 2017-04-02
+==================
+ * added `ParseOptions.allowTrailingComma`
+
+0.4.0 / 2017-02-23
+==================
+  * fix for `getLocation`. Now `getLocation` inside an object will always return a property from inside that property. Can be empty string if the object has no properties or if the offset is before a actual property  `{ "a": { | }} will return location ['a', ' ']`
+
+0.3.0 / 2017-01-17
+==================
+  * Updating to typescript 2.0

package/node_modules/jsonc-parser/LICENSE.md

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) Microsoft
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.