@llblab/pi-telegram 0.45.11 → 0.47.0

package/lib/threads.ts

@@ -52,6 +52,10 @@ export interface TelegramThreadNameInput {
 export interface TelegramWorkspaceBindingIdentity {
   cwd: string;
   workspaceKey: string;
+  /** Exact durable Pi session identity; absent only on legacy cwd-only bindings. */
+  sessionId?: string;
+  /** Full SHA-256 index component for session-qualified bindings. */
+  sessionKey?: string;
   /** Immutable legacy binding-key component, not the displayed global letter. */
   instanceSlot: string;
   bindingKey: string;
@@ -60,6 +64,27 @@ export interface TelegramWorkspaceBindingIdentity {
 }
 
 const TELEGRAM_WORKSPACE_KEY_MAX_LENGTH = 180;
+const TELEGRAM_SESSION_ID_MAX_LENGTH = 256;
+
+export function normalizeTelegramSessionId(
+  sessionId: string,
+): string | undefined {
+  if (typeof sessionId !== "string") return undefined;
+  const normalized = sessionId.trim();
+  return normalized && Buffer.byteLength(normalized, "utf8") <=
+      TELEGRAM_SESSION_ID_MAX_LENGTH
+    ? normalized
+    : undefined;
+}
+
+export function createTelegramSessionKey(
+  sessionId: string,
+): string | undefined {
+  const normalized = normalizeTelegramSessionId(sessionId);
+  return normalized
+    ? createHash("sha256").update(normalized).digest("hex")
+    : undefined;
+}
 
 export function normalizeTelegramWorkspacePath(
   cwd: string,
@@ -116,21 +141,39 @@ function createTelegramWorkspaceBindingIdentityWithKey(
   cwd: string,
   workspaceKey: string,
   ordinal: number,
+  sessionId?: string,
 ): TelegramWorkspaceBindingIdentity | undefined {
   const instanceSlot = createTelegramWorkspaceInstanceSlot(ordinal);
   if (!instanceSlot) return undefined;
+  const normalizedSessionId = sessionId === undefined
+    ? undefined
+    : normalizeTelegramSessionId(sessionId);
+  const sessionKey = normalizedSessionId
+    ? createTelegramSessionKey(normalizedSessionId)
+    : undefined;
+  if (sessionId !== undefined && (!normalizedSessionId || !sessionKey)) {
+    return undefined;
+  }
+  const legacyBindingKey = instanceSlot === "a"
+    ? workspaceKey
+    : `${workspaceKey}${instanceSlot}`;
   return {
     cwd,
     workspaceKey,
+    ...(normalizedSessionId && sessionKey
+      ? { sessionId: normalizedSessionId, sessionKey }
+      : {}),
     instanceSlot,
-    bindingKey:
-      instanceSlot === "a" ? workspaceKey : `${workspaceKey}${instanceSlot}`,
+    bindingKey: sessionKey
+      ? `${legacyBindingKey}-s-${sessionKey}`
+      : legacyBindingKey,
   };
 }
 
 export function createTelegramWorkspaceBindingIdentity(
   cwd: string,
   ordinal = 0,
+  sessionId?: string,
 ): TelegramWorkspaceBindingIdentity | undefined {
   const normalized = normalizeTelegramWorkspacePath(cwd);
   const workspaceKey = normalized
@@ -141,6 +184,7 @@ export function createTelegramWorkspaceBindingIdentity(
     normalized,
     workspaceKey,
     ordinal,
+    sessionId,
   );
 }
 
@@ -249,6 +293,10 @@ export interface TelegramThreadIdentityRecord {
 export interface TelegramWorkspaceThreadBinding {
   cwd: string;
   workspaceKey: string;
+  /** Exact durable Pi session identity; absent only on legacy cwd-only bindings. */
+  sessionId?: string;
+  /** Full SHA-256 index component for session-qualified bindings. */
+  sessionKey?: string;
   instanceSlot: string;
   bindingKey: string;
   target: TelegramTarget & { threadId: number };
@@ -453,7 +501,8 @@ export interface TelegramTopicTargetStore {
   ) => Promise<boolean>;
   commitInactiveWorkspaceCleanup: (
     expected: TelegramWorkspaceThreadBinding | {
-      cwd: string; workspaceKey: string; instanceSlot: string; slot: string; bindingKey: string;
+      cwd: string; workspaceKey: string; sessionId?: string; sessionKey?: string;
+      instanceSlot: string; slot: string; bindingKey: string;
       target: { chatId: number; threadId: number }; inactiveSinceMs: number; bindingUpdatedAtMs: number;
     },
     isCurrent: () => boolean,
@@ -465,7 +514,7 @@ export interface TelegramTopicTargetStore {
     ) => TelegramWorkspaceExternalProtectionEvidence,
     options?: { expectedRetirement?: TelegramWorkspaceRetirementIntent },
   ) => TelegramWorkspaceSlotOccupancySnapshot;
-  hasWorkspaceBinding: (cwd: string) => boolean;
+  hasWorkspaceBinding: (cwd: string, sessionId?: string) => boolean;
   setWorkspaceDisplayTitle: (
     expected: TelegramWorkspaceThreadBinding,
     title: string,
@@ -478,6 +527,7 @@ export interface TelegramTopicTargetStore {
   getWorkspaceBinding: (
     cwd: string,
     instanceSlot?: string,
+    sessionId?: string,
   ) => TelegramWorkspaceThreadBinding | undefined;
   claimWorkspaceIdentity: (
     cwd: string,
@@ -485,6 +535,7 @@ export interface TelegramTopicTargetStore {
     previousInstanceId?: string,
     options?: {
       existingBindingOnly?: boolean;
+      sessionId?: string;
       onCapacityUnavailable?: () => void;
     },
   ) => TelegramWorkspaceBindingIdentity | undefined;
@@ -1124,9 +1175,12 @@ function cloneIdentityRecord(
 }
 
 function getWorkspaceBindingMapKey(
-  binding: Pick<TelegramWorkspaceThreadBinding, "cwd" | "instanceSlot">,
+  binding: Pick<
+    TelegramWorkspaceThreadBinding,
+    "cwd" | "instanceSlot" | "sessionId"
+  >,
 ): string {
-  return `${binding.cwd}\u0000${binding.instanceSlot}`;
+  return `${binding.cwd}\u0000${binding.sessionId ?? ""}\u0000${binding.instanceSlot}`;
 }
 
 function normalizeWorkspaceBindingRecord(
@@ -1145,15 +1199,30 @@ function normalizeWorkspaceBindingRecord(
     return undefined;
   }
   const cwd = normalizeTelegramWorkspacePath(record.cwd);
+  const sessionId = typeof record.sessionId === "string"
+    ? normalizeTelegramSessionId(record.sessionId)
+    : undefined;
+  const sessionKey = typeof record.sessionKey === "string"
+    ? record.sessionKey
+    : undefined;
+  const hasSessionFields = record.sessionId !== undefined ||
+    record.sessionKey !== undefined;
+  const expectedSessionKey = sessionId
+    ? createTelegramSessionKey(sessionId)
+    : undefined;
+  const legacyBindingKey = record.instanceSlot === "a"
+    ? record.workspaceKey
+    : `${record.workspaceKey}${record.instanceSlot}`;
+  const expectedBindingKey = expectedSessionKey
+    ? `${legacyBindingKey}-s-${expectedSessionKey}`
+    : legacyBindingKey;
   if (
     !cwd ||
     cwd !== record.cwd ||
     !record.workspaceKey ||
     !/^[a-z]+$/u.test(record.instanceSlot) ||
-    record.bindingKey !==
-      (record.instanceSlot === "a"
-        ? record.workspaceKey
-        : `${record.workspaceKey}${record.instanceSlot}`)
+    (hasSessionFields && (!sessionId || sessionKey !== expectedSessionKey)) ||
+    record.bindingKey !== expectedBindingKey
   ) {
     return undefined;
   }
@@ -1191,6 +1260,7 @@ function normalizeWorkspaceBindingRecord(
   return {
     cwd,
     workspaceKey: record.workspaceKey,
+    ...(sessionId && sessionKey ? { sessionId, sessionKey } : {}),
     instanceSlot: record.instanceSlot,
     bindingKey: record.bindingKey,
     ...(record.showSlotSuffix === true ? { showSlotSuffix: true } : {}),
@@ -1684,7 +1754,10 @@ export function createTelegramTopicTargetStore(
   );
   let workspaceClaims = new Map<
     string,
-    { identity: TelegramWorkspaceBindingIdentity; instanceId: string }
+    {
+      identity: TelegramWorkspaceBindingIdentity;
+      instanceId: string;
+    }
   >();
   let reservations: TelegramThreadReservation[] = [];
   let pendingProvisions: TelegramThreadPendingProvision[] = [];
@@ -2404,8 +2477,16 @@ export function createTelegramTopicTargetStore(
       if (workspaceRetirementCommitInFlight || !isCurrent()) return false;
       const cleanupSnapshot = "bindingUpdatedAtMs" in expected ? expected : undefined;
       const normalized = cleanupSnapshot ? undefined : normalizeWorkspaceBindingRecord(expected);
+      const cleanupSessionId = cleanupSnapshot?.sessionId === undefined
+        ? undefined
+        : normalizeTelegramSessionId(cleanupSnapshot.sessionId);
+      const cleanupSessionKey = cleanupSessionId
+        ? createTelegramSessionKey(cleanupSessionId)
+        : undefined;
       if (cleanupSnapshot && (!cleanupSnapshot.cwd || !cleanupSnapshot.workspaceKey ||
           !cleanupSnapshot.instanceSlot || !cleanupSnapshot.slot || !cleanupSnapshot.bindingKey ||
+          ((cleanupSnapshot.sessionId !== undefined || cleanupSnapshot.sessionKey !== undefined) &&
+            (!cleanupSessionId || cleanupSnapshot.sessionKey !== cleanupSessionKey)) ||
           !Number.isSafeInteger(cleanupSnapshot.inactiveSinceMs) ||
           !Number.isSafeInteger(cleanupSnapshot.bindingUpdatedAtMs) ||
           !Number.isSafeInteger(cleanupSnapshot.target.chatId) ||
@@ -2416,6 +2497,7 @@ export function createTelegramTopicTargetStore(
       if (!binding) return isCurrent();
       const exact = cleanupSnapshot ? binding.cwd === cleanupSnapshot.cwd &&
         binding.workspaceKey === cleanupSnapshot.workspaceKey &&
+        binding.sessionId === cleanupSessionId && binding.sessionKey === cleanupSessionKey &&
         binding.instanceSlot === cleanupSnapshot.instanceSlot && binding.slot === cleanupSnapshot.slot &&
         binding.bindingKey === cleanupSnapshot.bindingKey && targetMatches(binding.target, cleanupSnapshot.target) &&
         binding.inactiveSinceMs === cleanupSnapshot.inactiveSinceMs &&
@@ -2612,10 +2694,17 @@ export function createTelegramTopicTargetStore(
         : [...localReservedSlots, "invalid"];
       return { bindings, reservedSlots };
     },
-    hasWorkspaceBinding(cwd) {
+    hasWorkspaceBinding(cwd, sessionId) {
       const normalizedCwd = normalizeTelegramWorkspacePath(cwd);
-      return !!normalizedCwd && Array.from(workspaceBindings.values()).some(
-        (binding) => binding.cwd === normalizedCwd,
+      const normalizedSessionId = sessionId === undefined
+        ? undefined
+        : normalizeTelegramSessionId(sessionId);
+      if (!normalizedCwd || (sessionId !== undefined && !normalizedSessionId)) {
+        return false;
+      }
+      return Array.from(workspaceBindings.values()).some(
+        (binding) => binding.cwd === normalizedCwd &&
+          binding.sessionId === normalizedSessionId,
       );
     },
     setWorkspaceDisplayTitle(expected, title) {
@@ -2651,18 +2740,29 @@ export function createTelegramTopicTargetStore(
       }
       return false;
     },
-    getWorkspaceBinding(cwd, instanceSlot = "a") {
+    getWorkspaceBinding(cwd, instanceSlot = "a", sessionId) {
       const normalizedCwd = normalizeTelegramWorkspacePath(cwd);
-      if (!normalizedCwd || !/^[a-z]+$/u.test(instanceSlot)) return undefined;
-      const binding = workspaceBindings.get(
-        getWorkspaceBindingMapKey({ cwd: normalizedCwd, instanceSlot }),
-      );
+      const normalizedSessionId = sessionId === undefined
+        ? undefined
+        : normalizeTelegramSessionId(sessionId);
+      if (!normalizedCwd || !/^[a-z]+$/u.test(instanceSlot) ||
+          (sessionId !== undefined && !normalizedSessionId)) return undefined;
+      const mapKey = getWorkspaceBindingMapKey({
+        cwd: normalizedCwd,
+        instanceSlot,
+        ...(normalizedSessionId ? { sessionId: normalizedSessionId } : {}),
+      });
+      const binding = workspaceBindings.get(mapKey);
       return binding ? cloneWorkspaceBinding(binding) : undefined;
     },
     claimWorkspaceIdentity(cwd, instanceId, previousInstanceId, options) {
       if (workspaceRetirementCommitInFlight) return undefined;
       const normalizedCwd = normalizeTelegramWorkspacePath(cwd);
+      const normalizedSessionId = options?.sessionId === undefined
+        ? undefined
+        : normalizeTelegramSessionId(options.sessionId);
       if (!normalizedCwd || !instanceId ||
+          (options?.sessionId !== undefined && !normalizedSessionId) ||
           hasWorkspaceRetirementConflict({ cwd: normalizedCwd })) return undefined;
       const externalReservedSlots = captureExternalReservedSlots();
       if (!externalReservedSlots) {
@@ -2674,7 +2774,9 @@ export function createTelegramTopicTargetStore(
       );
       for (const claim of workspaceClaims.values()) {
         if (claim.instanceId !== instanceId) continue;
-        if (claim.identity.cwd !== normalizedCwd || !claim.identity.slot ||
+        if (claim.identity.cwd !== normalizedCwd ||
+            claim.identity.sessionId !== normalizedSessionId ||
+            !claim.identity.slot ||
             externalReservedSlotKeys.includes(claim.identity.slot.toLowerCase())) {
           return undefined;
         }
@@ -2686,11 +2788,13 @@ export function createTelegramTopicTargetStore(
       }
       const workspaceKey = resolveWorkspaceKey(normalizedCwd);
       if (!workspaceKey) return undefined;
-      let legacyRecord = findLegacyWorkspaceMigrationRecord(
-        normalizedCwd,
-        instanceId,
-        previousInstanceId,
-      );
+      let legacyRecord = normalizedSessionId
+        ? undefined
+        : findLegacyWorkspaceMigrationRecord(
+            normalizedCwd,
+            instanceId,
+            previousInstanceId,
+          );
       const legacyTarget = legacyRecord?.target;
       const targetBinding = legacyTarget
         ? Array.from(workspaceBindings.values()).find(
@@ -2772,12 +2876,16 @@ export function createTelegramTopicTargetStore(
         }
         if (!slot || !/^[A-Z]$/u.test(slot)) return undefined;
         const claimedIdentity = { ...identity, slot };
-        workspaceClaims.set(mapKey, { identity: claimedIdentity, instanceId });
+        workspaceClaims.set(mapKey, {
+          identity: claimedIdentity,
+          instanceId,
+        });
         return { ...claimedIdentity };
       };
       if (options?.existingBindingOnly) {
         const candidates = Array.from(workspaceBindings.values())
-          .filter((binding) => binding.cwd === normalizedCwd)
+          .filter((binding) => binding.cwd === normalizedCwd &&
+            binding.sessionId === normalizedSessionId)
           .sort((left, right) =>
             left.instanceSlot.length - right.instanceSlot.length ||
             left.instanceSlot.localeCompare(right.instanceSlot),
@@ -2786,6 +2894,9 @@ export function createTelegramTopicTargetStore(
           const claimed = claimIdentity({
             cwd: binding.cwd,
             workspaceKey: binding.workspaceKey,
+            ...(binding.sessionId && binding.sessionKey
+              ? { sessionId: binding.sessionId, sessionKey: binding.sessionKey }
+              : {}),
             instanceSlot: binding.instanceSlot,
             bindingKey: binding.bindingKey,
           });
@@ -2811,6 +2922,7 @@ export function createTelegramTopicTargetStore(
           normalizedCwd,
           workspaceKey,
           ordinal,
+          normalizedSessionId,
         );
         if (!identity) return undefined;
         const mapKey = getWorkspaceBindingMapKey(identity);
@@ -2850,6 +2962,8 @@ export function createTelegramTopicTargetStore(
       const next = normalizeWorkspaceBindingRecord(binding);
       if (next && hasWorkspaceRetirementConflict(next)) return undefined;
       if (!next) return undefined;
+      const nextMapKey = getWorkspaceBindingMapKey(next);
+      const claim = workspaceClaims.get(nextMapKey);
       if (next.slot && Array.from(workspaceBindings.values()).some((existing) =>
         existing.bindingKey !== next.bindingKey && existing.slot === next.slot,
       )) return undefined;
@@ -2861,9 +2975,11 @@ export function createTelegramTopicTargetStore(
           return undefined;
         }
       }
-      const nextMapKey = getWorkspaceBindingMapKey(next);
       const previous = workspaceBindings.get(nextMapKey);
       if (previous?.showSlotSuffix) next.showSlotSuffix = true;
+      if (previous?.threadName && !next.threadName) {
+        next.threadName = previous.threadName;
+      }
       if (previous?.manualThreadName && !next.manualThreadName) {
         next.manualThreadName = previous.manualThreadName;
       }
@@ -2884,7 +3000,6 @@ export function createTelegramTopicTargetStore(
         if (previous.displayTitle) next.displayTitle = previous.displayTitle;
         if (previous.inactiveSinceMs !== undefined) next.inactiveSinceMs = previous.inactiveSinceMs;
       }
-      const claim = workspaceClaims.get(nextMapKey);
       if (claimInstanceId) {
         if (claim?.instanceId !== claimInstanceId) return undefined;
         if (next.slot !== undefined && claim.identity.slot !== next.slot) return undefined;
@@ -3460,6 +3575,7 @@ export interface TelegramPromoteFollowerBindingToLeaderDeps {
   store: TelegramTopicTargetStore;
   instanceId: string;
   cwd?: string;
+  sessionId?: string;
   telegramProfile?: string;
   target?: TelegramTarget;
   slot?: string;
@@ -3483,11 +3599,15 @@ export async function promoteTelegramFollowerBindingToLeader(
     );
   const workspaceIdentity = deps.cwd
     ? deps.store.claimWorkspaceIdentity(deps.cwd, deps.instanceId,
-        existing?.instanceId, { existingBindingOnly: true })
+        existing?.instanceId, {
+          existingBindingOnly: true,
+          sessionId: deps.sessionId,
+        })
     : undefined;
   const workspaceBinding = workspaceIdentity
     ? deps.store.getWorkspaceBinding(
         workspaceIdentity.cwd, workspaceIdentity.instanceSlot,
+        workspaceIdentity.sessionId,
       )
     : undefined;
   const exactWorkspaceBinding = workspaceBinding &&

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llblab/pi-telegram",
-  "version": "0.45.11",
+  "version": "0.47.0",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -30,15 +30,19 @@
     "test": "node --experimental-strip-types --test --test-concurrency=4 --test-reporter=dot tests/*.test.ts",
     "test:verbose": "node --experimental-strip-types --test --test-reporter=spec tests/*.test.ts",
     "typecheck": "tsc --noEmit",
+    "build": "node scripts/build-dist.mjs",
+    "prepack": "npm run build",
+    "check": "node -e \"await import('./dist/pi-telegram/index.js'); console.log('pi-telegram: extension import ok')\"",
     "audit": "npm audit --omit=peer",
     "audit:host": "npm audit",
     "pack:check": "npm pack --dry-run",
-    "validate": "npm run typecheck && npm test && npm run audit && npm run pack:check"
+    "validate": "npm run build && npm run typecheck && npm test && npm run audit && npm run check && npm run pack:check"
   },
   "files": [
     "index.ts",
     "api/",
     "lib/",
+    "dist/",
     "README.md",
     "AGENTS.md",
     "BACKLOG.md",
@@ -49,23 +53,62 @@
     "screenshot.png"
   ],
   "exports": {
-    ".": "./index.ts",
-    "./inbound": "./api/inbound.ts",
-    "./outbound": "./api/outbound.ts",
-    "./delivery": "./api/delivery.ts",
-    "./activity": "./api/activity.ts",
-    "./updates": "./api/updates.ts",
-    "./commands": "./api/commands.ts",
-    "./sections": "./api/sections.ts",
-    "./status": "./api/status.ts",
-    "./voice": "./api/voice.ts",
-    "./keyboard": "./api/keyboard.ts"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./inbound": {
+      "types": "./dist/api/inbound.d.ts",
+      "default": "./dist/api/inbound.js"
+    },
+    "./outbound": {
+      "types": "./dist/api/outbound.d.ts",
+      "default": "./dist/api/outbound.js"
+    },
+    "./delivery": {
+      "types": "./dist/api/delivery.d.ts",
+      "default": "./dist/api/delivery.js"
+    },
+    "./activity": {
+      "types": "./dist/api/activity.d.ts",
+      "default": "./dist/api/activity.js"
+    },
+    "./updates": {
+      "types": "./dist/api/updates.d.ts",
+      "default": "./dist/api/updates.js"
+    },
+    "./commands": {
+      "types": "./dist/api/commands.d.ts",
+      "default": "./dist/api/commands.js"
+    },
+    "./sections": {
+      "types": "./dist/api/sections.d.ts",
+      "default": "./dist/api/sections.js"
+    },
+    "./status": {
+      "types": "./dist/api/status.d.ts",
+      "default": "./dist/api/status.js"
+    },
+    "./voice": {
+      "types": "./dist/api/voice.d.ts",
+      "default": "./dist/api/voice.js"
+    },
+    "./keyboard": {
+      "types": "./dist/api/keyboard.d.ts",
+      "default": "./dist/api/keyboard.js"
+    }
   },
   "pi": {
     "extensions": [
+      "./dist/pi-telegram/index.js"
+    ],
+    "sourceExtensions": [
       "./index.ts"
     ],
     "skills": [
+      "./dist/skills"
+    ],
+    "sourceSkills": [
       "./skills"
     ],
     "image": "https://raw.githubusercontent.com/llblab/pi-telegram/main/screenshot.png"

package/scripts/build-dist.mjs

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+
+/**
+ * Builds the distributive JavaScript, declarations, Pi entrypoint, and Skills.
+ * Usage: node scripts/build-dist.mjs
+ *
+ * The build replaces `dist`, compiles with `tsconfig.build.json`, then copies
+ * package-owned runtime assets. It does not publish, pack, or modify sources.
+ */
+
+import { spawnSync } from "node:child_process";
+import { cpSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+
+function run(command, args) {
+  const result = spawnSync(command, args, { stdio: "inherit" });
+  if (result.error) throw result.error;
+  if (result.status !== 0) process.exit(result.status ?? 1);
+}
+
+rmSync("dist", { recursive: true, force: true });
+mkdirSync("dist", { recursive: true });
+
+run(process.execPath, [
+  join("node_modules", "typescript", "bin", "tsc"),
+  "-p",
+  "tsconfig.build.json",
+]);
+
+mkdirSync(join("dist", "pi-telegram"), { recursive: true });
+writeFileSync(
+  join("dist", "pi-telegram", "index.js"),
+  'export { default } from "../index.js";\n',
+  "utf8",
+);
+
+cpSync("skills", join("dist", "skills"), { recursive: true });
+cpSync("package.json", join("dist", "package.json"));
+cpSync(
+  join("lib", "generative-app-worker.mjs"),
+  join("dist", "lib", "generative-app-worker.mjs"),
+);
+
+run(process.execPath, ["--check", join("dist", "pi-telegram", "index.js")]);

package/scripts/measure-bus.mjs

@@ -1,4 +1,11 @@
-// Counts isolated registry work without sockets, configured profiles, or Telegram calls.
+/**
+ * Counts isolated synchronous bus-registry work at representative sizes.
+ * Usage: node --experimental-strip-types scripts/measure-bus.mjs
+ *
+ * This assertion-backed fixture instruments Map operations only. It does not
+ * open sockets, read configured profiles, call Telegram, or measure latency.
+ */
+
 import assert from "node:assert/strict";
 import { createTelegramBusFollowerRegistry, createTelegramBusProtocolIdentity } from "../lib/bus.ts";
 

package/scripts/measure-workspace.mjs

@@ -1,4 +1,11 @@
-// Measures isolated Thread-store work; never reads configured profiles or calls Telegram.
+/**
+ * Measures isolated Thread-store filesystem work at representative sizes.
+ * Usage: node --experimental-strip-types scripts/measure-workspace.mjs
+ *
+ * This assertion-backed fixture uses and removes its own temporary directory.
+ * It never reads configured profiles, calls Telegram, or measures latency.
+ */
+
 import assert from "node:assert/strict";
 import fs from "node:fs/promises";
 import { syncBuiltinESMExports } from "node:module";

package/skills/generative-apps/SKILL.md

@@ -97,7 +97,7 @@ ordinary prompt          → model-mediated interpretation or explanation
 - Keep credentials and unrelated private state out of source, state, output, and diagnostics.
 - Route consequences requiring contextual judgment through an ordinary model prompt.
 - Fail closed on unavailable owners, stale actions, malformed state, absent methods, process failures, or uncertain effects.
-- Do not claim automatic refresh, removal, voice output, or other behavior still marked incomplete in the runtime document.
+- Treat `refreshAfterMs` validation, output-only `refresh`, scheduling after a successful hinted explicit `telegram_bind` delivery, same-handle rescheduling after a current-surface bound action, Delivery edit-failure classification, known unavailable-message invalidation with bounded classified diagnostics, session/runtime live-surface cancellation, and exact direct classic/leader/authenticated-follower target retention as implemented. The Bot API has no ordinary private-message deletion update; `deleted_business_messages` is limited to connected business accounts. Do not claim removal, voice output, proactive deletion-update invalidation, or other behavior still marked incomplete in the runtime document.
 
 ## Validation
 

package/skills/show-me/SKILL.md

@@ -10,7 +10,7 @@ Help the user understand the current topic. Skip the preamble and keep prose bri
 - Infer the subject from the conversation and honor an explicitly requested format. With plain `show me`, choose the form that best explains the subject.
 - Markdown in the reply is a complete output format for both chat and terminal surfaces. Use headings, emphasis, lists, and focused code blocks to explain outcomes, comparisons, and reasoning; add a diagram when relationships need one.
 - `Show me markdown` requests a rendered Markdown reply. Create a Markdown file only when the user asks for a saved document or file artifact.
-- `Show me html` requests a focused HTML file. Save file artifacts in the project or filesystem as appropriate and deliver them through the active environment's file-delivery mechanism; open locally when that is the requested surface.
+- `Show me html` requests a focused HTML file. Prefer an accessible, art-directed interactive infographic when timelines, comparisons, layers, or progressive disclosure clarify the subject; otherwise stay static. Preserve truthful labels and reduced motion. Save and deliver the artifact through the active environment; open it locally when requested.
 
 ### Surface Routing
 

package/skills/telegram-bridge/SKILL.md

@@ -60,7 +60,7 @@ Every enabled button has a self-contained prompt and an optional selection style
 - `{label|prompt}` separates visible label from queued prompt.
 - `{label|prompt|selected_style}` and `{|prompt|selected_style}` accept `primary`, `success`, or `danger`.
 - Fourth-position `1`/`true` disables, `0`/`false` enables; omission means enabled. JSON uses boolean `disabled`. `{|Next||1}` omits label/style; `{Next|||1}` omits prompt/style; `{|||1}` is blank (Telegram receives a non-breaking space). Prefer meaningful labels and retain a useful enabled action. Enabled CML requires a prompt. Disabled controls stay visible but have no callback, queued prompt, or bound-method invocation.
-- Top-level cells form vertical rows; one nested row groups horizontal peers.
+- Top-level cells form vertical rows; inside a fenced block, adjacent top-level JSON/CML objects may omit the outer array and commas. One nested row groups horizontal peers.
 - Prefer one matrix per related group. Fenced blocks stay in place in Rich mode; HTML compatibility moves them to the footer. Native rows allow eight buttons. Malformed/oversized/unclosed blocks activate nothing; drafts hide them. Outer code fences and quoted/indented examples remain literal.
 - Both placements share prompt/app routing. In-body clicks acknowledge without recoloring; selected-style highlighting remains footer-only.