@llblab/pi-kit 0.9.1 → 0.10.0

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 All notable changes to `@llblab/pi-kit` are documented here.
 
+## 0.10.0 - 2026-09-11
+
+- `State Flow Telegram Surface`: Advances the exact State Flow pin to `0.9.0`, adding the optional fail-open Telegram status line (`State Flow: on · step #N`) and the inline main-menu section button before Settings with Start, Stop, Refresh, and deferred-start control for the current session branch. The package set, resource inventory, and explicit load order remain unchanged.
+- `Grow Loop Telegram Mirror`: Advances the exact Grow Loop pin to `0.8.0`, mirroring the visible loop rhythm (`Grow Loop: #N · waiting`, `#N · Ns`, `#N · running`) into the Telegram status screen with the same fail-open, no-scheduling-change guarantees. The package set, resource inventory, and explicit load order remain unchanged.
+
 ## 0.9.1 - 2026-09-11
 
 - `Telegram Draft Cadence`: Advances the exact Telegram pin to `0.45.4`, so each preview segment holds its first frame for one full two-second interval from its first visible text; the opening draft is an accumulated passage instead of a single streamed word, later frames keep the trailing cadence, and rollover after tool work reopens the window while sealing or final publication still cancels pending timers. The package set, resource inventory, and explicit load order remain unchanged.

package/README.md

@@ -13,8 +13,8 @@ Package links lead to the owning repositories for usage, documentation, issues,
 | [`@llblab/pi-actors`](https://github.com/llblab/pi-actors) | `0.53.0` | Inspectable local Runs, reusable Recipes, persistent tools, and delegation Skills |
 | [`@llblab/pi-clean-room`](https://github.com/llblab/pi-clean-room) | `0.1.1` | Isolated nested Pi TUI with explicitly selected extensions |
 | [`@llblab/pi-codex-usage`](https://github.com/llblab/pi-codex-usage) | `0.9.4` | Compact Codex/Spark subscription-limit status |
-| [`@llblab/pi-grow-loop`](https://github.com/llblab/pi-grow-loop) | `0.7.5` | Visible continuation scheduling and bounded worker Skills |
-| [`@llblab/pi-state-flow`](https://github.com/llblab/pi-state-flow) | `0.8.1` | Atomic scoped state cohorts with final-eligibility resolution |
+| [`@llblab/pi-grow-loop`](https://github.com/llblab/pi-grow-loop) | `0.8.0` | Visible continuation scheduling and bounded worker Skills |
+| [`@llblab/pi-state-flow`](https://github.com/llblab/pi-state-flow) | `0.9.0` | Atomic scoped state cohorts with final-eligibility resolution |
 | [`@llblab/pi-telegram`](https://github.com/llblab/pi-telegram) | `0.45.4` | Telegram companion, queues, files, voice, controls, and Generative Apps guidance |
 | [`@llblab/skills`](https://github.com/llblab/skills) | `1.15.0` | Portable workflows for engineering, review, design, context maintenance, and other focused tasks |
 

package/node_modules/@llblab/pi-grow-loop/AGENTS.md

@@ -27,6 +27,7 @@
 - There is no slash-command control surface. Any ordinary user prompt exits the active runtime rhythm by clearing pending scheduling and hiding loop status; restart/continuation intent belongs to the agent and Grow Loop skill, not to a runtime latch or regex.
 - No start slash commands, budgets, cycle counts, hidden processes, or background agents.
 - Loop status is dynamic: show warning-colored `grow-loop ∞N` only while the next iteration is deferred until idle, `grow-loop Ns` only during the configured countdown, and dim `grow-loop ∞N` only while a loop-scheduled turn is active. Clear active status only after Pi fully settles without an armed successor; low-level run endings may still lead to retry or compaction recovery. Any user input except the runtime's exact expected continuation prompt clears pending loop scheduling and hides loop status, including operator input injected through another extension.
+- Telegram status mirror: when `pi-telegram` is installed, the optional fail-open status-line adapter mirrors the same visible rhythm (`Grow Loop: #N · waiting|Xs|running`) and hides with it. It reads the same runtime state, registers once per process lifetime, disposes on session shutdown, and a missing or unready transport changes nothing.
 - Grow Loop does not own Escape/abort semantics; Escape remains baseline Pi behavior for active agent turns. The runtime does not block future `grow_loop` tool calls; the skill contract owns whether recent user context means continue, stop, restart, or change direction.
 
 ## Topology

package/node_modules/@llblab/pi-grow-loop/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.8.0: Telegram Status Mirror
+
+- `Telegram Mirror`: With the optional `pi-telegram` extension installed, the Telegram Status screen mirrors the same loop rhythm as the terminal status and hides with it: `Grow Loop: #N · waiting` while the next prompt is armed until idle, `#N · 2.4s` during the configured countdown, and `#N · running` while the loop-scheduled turn is active.
+- `Compatibility`: The mirror is optional and fail-open, reads the same runtime state, registers once, disposes on session shutdown, and changes no scheduling behavior; absence of the transport changes nothing.
+
 ## 0.7.5: Status Identity Hotfix
 
 - `Status Identity`: Labels deferred, countdown, and active runtime status as `grow-loop` instead of the ambiguous `loop`, matching the extension's public identity and the neighboring State Flow status convention.

package/node_modules/@llblab/pi-grow-loop/README.md

@@ -150,6 +150,8 @@ The tool never blocks future calls. Whether to continue belongs to the agent and
 
 `N` is monotonic within the current extension instance and advances only once when a turn arms its deferred successor. Repeated `grow_loop` calls before that turn ends retain `N`, replace the pending delay, and report that the iteration was already scheduled. Active status clears when the scheduled agent run fully settles without arming a successor, so automatic retry or compaction recovery does not produce a false idle state. There is no `grow-loop stopped` or `grow-loop paused` status; absence of Grow Loop status means the runtime rhythm is no longer active.
 
+With the optional `pi-telegram` extension installed, the Telegram Status screen mirrors the same rhythm and stays hidden whenever the terminal status is hidden: `Grow Loop: #N · waiting`, `#N · 2.4s` during the countdown, and `#N · running` while the loop-scheduled turn is active. The mirror reads the same runtime state, fails open without the transport, and changes no scheduling behavior.
+
 ## Interruption Model
 
 Any user prompt except the scheduler's exact expected continuation prompt exits the active runtime rhythm. This includes operator input delivered through Telegram, RPC bridges, or other extensions:

package/node_modules/@llblab/pi-grow-loop/index.ts

@@ -14,16 +14,47 @@ const DEFAULT_FOLLOW_UP_DELAY_MS = 3000;
 const DEFAULT_COUNTDOWN_TICK_MS = 100;
 const MIN_AFTER_SECONDS = 3;
 const MAX_AFTER_SECONDS = 3600;
+const TELEGRAM_STATUS_IMPORT_SPECIFIERS = [
+  "@llblab/pi-telegram/status",
+  new URL("../pi-telegram/api/status.ts", import.meta.url).href,
+];
 
 type Timer = ReturnType<typeof setTimeout> & { unref?: () => void };
 type PendingIteration = {
   interval: Timer;
   timeout?: Timer;
+  countdownStartedAt?: number;
+  countdownDelayMs?: number;
 };
 
+export interface GrowLoopTelegramProgress {
+  iteration: number;
+  state: "waiting" | "countdown" | "running";
+  remainingSeconds?: number;
+}
+
+export interface GrowLoopTelegramStatusLine {
+  label: string;
+  value: string;
+}
+
+export type GrowLoopTelegramStatusProvider = () => GrowLoopTelegramStatusLine | undefined;
+export type GrowLoopTelegramStatusRegistrar = (
+  provider: GrowLoopTelegramStatusProvider,
+) => (() => void) | undefined;
+
+interface TelegramStatusLineModule {
+  registerTelegramStatusLineProvider?: (
+    provider: GrowLoopTelegramStatusProvider,
+    options: { id: string },
+  ) => () => void;
+}
+
 type GrowLoopOptions = {
   followUpDelayMs?: number;
   countdownTickMs?: number;
+  /** Injection seam for the optional pi-telegram status line; defaults to the public pi-telegram membrane. */
+  registerTelegramStatusLine?: GrowLoopTelegramStatusRegistrar;
 };
 
 export function buildGrowLoopPrompt(): string {
@@ -39,6 +70,28 @@ export function getExistingExtensionSkillPaths(extensionUrl: string): string[] {
   return existsSync(skillsDir) ? [skillsDir] : [];
 }
 
+export function formatGrowLoopTelegramValue(progress: GrowLoopTelegramProgress): string {
+  if (progress.state === "countdown") return `#${progress.iteration} · ${(progress.remainingSeconds ?? 0).toFixed(1)}s`;
+  if (progress.state === "running") return `#${progress.iteration} · running`;
+  return `#${progress.iteration} · waiting`;
+}
+
+async function registerGrowLoopTelegramStatus(
+  provider: GrowLoopTelegramStatusProvider,
+): Promise<(() => void) | undefined> {
+  for (const specifier of TELEGRAM_STATUS_IMPORT_SPECIFIERS) {
+    try {
+      const imported = (await import(specifier)) as TelegramStatusLineModule;
+      if (typeof imported.registerTelegramStatusLineProvider === "function") {
+        return imported.registerTelegramStatusLineProvider(provider, { id: "@llblab/pi-grow-loop" });
+      }
+    } catch {
+      // pi-telegram is optional; its absence only disables the Telegram status line.
+    }
+  }
+  return undefined;
+}
+
 function statusCountdown(ctx: ExtensionContext, seconds: number) {
   const theme = ctx.ui.theme;
   ctx.ui.setStatus(
@@ -82,20 +135,21 @@ function scheduleIteration(
   iteration: number,
   clearPending: () => void,
   expectOwnPrompt: () => void,
-  options: Required<GrowLoopOptions>,
+  options: Required<Pick<GrowLoopOptions, "followUpDelayMs" | "countdownTickMs">>,
 ): PendingIteration {
-  let countdownStartedAt: number | undefined;
   statusDeferred(ctx, iteration);
   const pending = {} as PendingIteration;
   pending.interval = setInterval(() => {
-    if (!countdownStartedAt) {
+    if (pending.countdownStartedAt === undefined) {
       if (!ctx.isIdle() || ctx.hasPendingMessages()) return;
-      countdownStartedAt = Date.now();
+      pending.countdownStartedAt = Date.now();
+      pending.countdownDelayMs = options.followUpDelayMs;
       statusCountdown(ctx, options.followUpDelayMs / 1000);
       pending.timeout = setTimeout(() => {
         pending.timeout = undefined;
         if (!ctx.isIdle() || ctx.hasPendingMessages()) {
-          countdownStartedAt = undefined;
+          pending.countdownStartedAt = undefined;
+          pending.countdownDelayMs = undefined;
           statusDeferred(ctx, iteration);
           return;
         }
@@ -105,7 +159,7 @@ function scheduleIteration(
       pending.timeout.unref?.();
       return;
     }
-    const elapsed = Date.now() - countdownStartedAt;
+    const elapsed = Date.now() - pending.countdownStartedAt;
     const remainingMs = Math.max(options.followUpDelayMs - elapsed, 0);
     if (remainingMs > 0) statusCountdown(ctx, remainingMs / 1000);
   }, options.countdownTickMs) as Timer;
@@ -122,23 +176,63 @@ export default function growLoopExtension(
       partialOptions.followUpDelayMs ?? DEFAULT_FOLLOW_UP_DELAY_MS,
     countdownTickMs:
       partialOptions.countdownTickMs ?? DEFAULT_COUNTDOWN_TICK_MS,
+    registerTelegramStatusLine: partialOptions.registerTelegramStatusLine,
   };
   let iteration = 0;
   let lastCtx: ExtensionContext | undefined;
   let pendingIteration: PendingIteration | undefined;
   let ownPromptPending = false;
   let scheduledThisTurn = false;
+  let runningIteration: number | undefined;
+  let unregisterTelegramStatus: (() => void) | undefined;
+  let telegramRegistration: Promise<void> | undefined;
+  let telegramGeneration = 0;
   const clearPending = () => {
     if (!pendingIteration) return;
     if (pendingIteration.timeout) clearTimeout(pendingIteration.timeout);
     clearInterval(pendingIteration.interval);
     pendingIteration = undefined;
   };
+  const telegramStatusProvider = (): GrowLoopTelegramStatusLine | undefined => {
+    if (pendingIteration) {
+      if (pendingIteration.countdownStartedAt === undefined) {
+        return { label: "Grow Loop", value: formatGrowLoopTelegramValue({ iteration, state: "waiting" }) };
+      }
+      const elapsed = Date.now() - pendingIteration.countdownStartedAt;
+      const remainingSeconds = Math.max((pendingIteration.countdownDelayMs ?? 0) - elapsed, 0) / 1000;
+      return { label: "Grow Loop", value: formatGrowLoopTelegramValue({ iteration, state: "countdown", remainingSeconds }) };
+    }
+    if (runningIteration !== undefined) {
+      return { label: "Grow Loop", value: formatGrowLoopTelegramValue({ iteration: runningIteration, state: "running" }) };
+    }
+    return undefined;
+  };
+  const ensureTelegramStatusRegistered = () => {
+    if (unregisterTelegramStatus || telegramRegistration) return;
+    if (options.registerTelegramStatusLine) {
+      unregisterTelegramStatus = options.registerTelegramStatusLine(telegramStatusProvider) ?? undefined;
+      return;
+    }
+    const generation = telegramGeneration;
+    telegramRegistration = registerGrowLoopTelegramStatus(telegramStatusProvider)
+      .then((unregister) => {
+        if (generation !== telegramGeneration) {
+          unregister?.();
+          return;
+        }
+        unregisterTelegramStatus = unregister;
+      })
+      .finally(() => {
+        if (generation === telegramGeneration) telegramRegistration = undefined;
+      });
+  };
   const hideLoopStatus = (ctx: ExtensionContext) => {
     ownPromptPending = false;
+    runningIteration = undefined;
     clearPending();
     ctx.ui.setStatus(STATUS_KEY, undefined);
   };
+  ensureTelegramStatusRegistered();
   pi.on("resources_discover", async () => {
     const skillPaths = getExistingExtensionSkillPaths(import.meta.url);
     if (skillPaths.length === 0) return;
@@ -147,12 +241,23 @@ export default function growLoopExtension(
   pi.on("session_shutdown", async () => {
     ownPromptPending = false;
     scheduledThisTurn = false;
+    runningIteration = undefined;
     clearPending();
+    telegramGeneration += 1;
+    unregisterTelegramStatus?.();
+    unregisterTelegramStatus = undefined;
+    telegramRegistration = undefined;
     lastCtx?.ui.setStatus(STATUS_KEY, undefined);
   });
+  pi.on("session_start", async () => {
+    ensureTelegramStatusRegistered();
+  });
   pi.on("agent_settled", async (_event, ctx) => {
     lastCtx = ctx;
-    if (!pendingIteration) ctx.ui.setStatus(STATUS_KEY, undefined);
+    if (!pendingIteration) {
+      runningIteration = undefined;
+      ctx.ui.setStatus(STATUS_KEY, undefined);
+    }
   });
   pi.on("input", async (event, ctx) => {
     lastCtx = ctx;
@@ -194,6 +299,7 @@ export default function growLoopExtension(
     async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
       lastCtx = ctx;
       ownPromptPending = false;
+      runningIteration = undefined;
       clearPending();
       const isReschedule = scheduledThisTurn;
       if (!isReschedule) {
@@ -212,8 +318,9 @@ export default function growLoopExtension(
         clearPending,
         () => {
           ownPromptPending = true;
+          runningIteration = nextIteration;
         },
-        { ...options, followUpDelayMs: delayMs },
+        { followUpDelayMs: delayMs, countdownTickMs: options.countdownTickMs },
       );
       return {
         content: [

package/node_modules/@llblab/pi-grow-loop/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llblab/pi-grow-loop",
-  "version": "0.7.5",
+  "version": "0.8.0",
   "private": false,
   "description": "Semantic loop-engineering for agent-owned, visible, interruptible continuation in Pi",
   "keywords": [

package/node_modules/@llblab/pi-state-flow/AGENTS.md

@@ -43,7 +43,7 @@
 - `/state-flow-stop` must persist only the current session/branch's `config.enabled = false` and necessary runtime provenance, preserving all semantic checkpoints/tails and creating no semantic transition. It must retain a same-physical-session bounded passive context handoff across reload, resume, and tree restoration so disabling semantics never re-exposes pre-stop raw history. Active restart replaces passive mode but uses that bounded boundary for its one migration run; new and forked physical sessions inherit neither projection. It does not rewrite agent-level `autoStart` or change its policy for future new sessions.
 - Keep the injected runtime protocol compact and normative; put rationale and extended explanation in README rather than the model prompt. Never parse or strip State Flow HTML comments; they are ordinary historical text, while foreign comment handling remains owned by other extensions.
 - Do not claim strict boundedness for state, the current run trajectory, the turn specification, or the external full trace.
-- Remain extension-agnostic: do not import, name, special-case, or encode policy for any other extension or transport.
+- Remain extension-agnostic in core semantics, storage, and inference: core modules never import, name, special-case, or encode policy for another extension or transport. One optional leaf presentation adapter (`lib/telegram.ts`) may import public `pi-telegram` membranes to mirror status and expose the same start/stop affordances already owned by `state-flow-start` and `state-flow-stop`; it must fail open when the transport is absent or its registry is unready and must never alter core behavior.
 - Activate State Flow model tools only while enabled on the selected branch; preserve every unrelated active tool when toggling them. Keep mutation confined to `patch_state` and historical observation read-only.
 - Keep `.github/workflows/release.yml` as the sole version-tag release owner: it validates immutable tag identity, publishes through npm Trusted Publisher with provenance, verifies the public package, and only then creates the GitHub Release. Keep package, lockfile, tag, and changelog versions aligned; never add a long-lived npm token fallback.
 - Run `npm run validate` after retained code changes.

package/node_modules/@llblab/pi-state-flow/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 > Each release keeps at most 8 outcome records of at most 512 characters.
 
+## 0.9.0: Telegram status surface
+
+- `Interop`: Added an optional fail-open `pi-telegram` presentation adapter. With the transport installed, the status screen shows `State Flow: on · step #N` while enabled, and the inline main menu places a `🌀 State Flow: #N` or `⚫️ State Flow: off` section button directly before Settings.
+- `Control`: The section submenu exposes the branch lifecycle already owned by the commands: Start, Stop, Refresh, and Cancel start while a start deferred behind an active run is pending. A busy start waits for the current run to settle, Stop applies immediately, and the adapter calls the same start/stop functions as `/state-flow-start` and `/state-flow-stop`.
+- `Compatibility`: Registration fails open when pi-telegram is absent or its section registry is not ready, retries on session start, and disposes on session shutdown. Core semantics, storage, inference, and hosts without pi-telegram are unchanged.
+
 ## 0.8.1: Preserved answers and bounded fallback resolution
 
 - `Resolution`: A terminal draft is never discarded. A draft ending before eligibility — or an eligible draft whose final validation fails for a later acquisition — is preserved as the runtime-owned response at `turn_end`, then at most two same-run fallback turns exist only to obtain the `final:true` patch. Fallback turns never enter `response`; success commits their patches with the preserved answer intact, and exhaustion closes the iteration with the preserved answer, current state, one bounded warning, and a finalization diagnostic.

package/node_modules/@llblab/pi-state-flow/README.md

@@ -66,6 +66,8 @@ Stopping changes the current session/branch configuration, preserves semantic ch
 
 The compact status is an accent `state-flow` and dim `#<step>`. Detailed status distinguishes runtime config/meta from semantic materialization, reports scope keys, the selected temporal head and runtime revision, available hot offsets, per-scope retained patch tails, artifact counts, stale Markdown reasons, and pending publication. Retained tails may include inherited pre-origin records, so their counts are not active history depth. It labels global/CWD/session/effective state without dumping source bodies. Failed inspection means unavailable evidence, never a falsely clean count.
 
+When the optional `pi-telegram` extension is installed, State Flow mirrors the same identity there: the Status screen shows `State Flow: on · step #N` while enabled, and the inline main menu places a `🌀 State Flow: #N` or `⚫️ State Flow: off` section button directly before Settings. The button opens a compact control submenu for the current session branch: `Start` or `Stop`, `Refresh`, and `Cancel start` while a start deferred behind an active run is pending. Starting while a run is active waits for that run to settle; stopping applies immediately. Registration fails open when the transport is absent, retries when the section registry becomes ready, and disposes on session shutdown; the `/state-flow-*` commands remain the authority and nothing changes for hosts without `pi-telegram`.
+
 ## State, scope, and time
 
 Every scope has exactly the same semantic shape:

package/node_modules/@llblab/pi-state-flow/docs/architecture.md

@@ -19,7 +19,7 @@ The extension owns durable memory while enabled. Global semantic memory is alway
 - `memory`: external promotion records and memory diagnostics.
 - `continuation`: native-header discovery, runtime-provenance inspection, deterministic recommendation, and host startup precedence.
 - `publication`: remote policy, durable CAS queue/store, cross-process leases, and asynchronous worker lifecycle.
-- `status`, `extension`: operator projection and Pi adapter wiring.
+- `status`, `telegram`, `extension`: operator projection, the optional fail-open pi-telegram presentation adapter, and Pi adapter wiring.
 
 ## Semantic state
 
@@ -199,6 +199,8 @@ Unknown keys fail loading. State Flow memory ownership and global availability a
 
 `/state-flow-status` reports branch mode, runtime revision, temporal head/history depth, scope keys, patch tails, artifact freshness, memory-bearing scopes, external-promotion summaries, remote policy/queue state, and pending publication. Unavailable materialization is reported as unavailable, never fabricated as empty. Artifact source bodies are not read for status.
 
+With `pi-telegram` installed, the optional `telegram` adapter mirrors the same identity in Telegram: the Status screen row shows `State Flow: on · step #N` while enabled, and the main-menu section button before Settings opens the branch start/stop submenu. Registration is fail-open and retried on session start, disposal happens on session shutdown, the adapter reads the same snapshot as the compact terminal status, and its start/stop actions call the same functions as the commands.
+
 Opt-in `logging` appends local JSONL diagnostics for rejected `patch_state` calls and preserved drafts plus fallback turns while turn resolution is pending. A rejected call retains its exact attempted arguments, the precise error, and, when available, tool identity, call id, resolution attempt, and terminal-eligibility state; accepted patches are never logged. Records preserve useful exact text blocks and reduce other blocks to structural identity without duplicating reasoning. They are never semantic state, scope `meta.json`, Pi checkpoints, or repository input. Write failure changes no resolution, enablement, or accepted state and reports at most one bounded local warning.
 
 ## Validation boundaries

package/node_modules/@llblab/pi-state-flow/index.ts

@@ -185,4 +185,25 @@ export {
   type StateScope,
   type TerminalTransition
 } from "./lib/state.ts";
+export {
+  buildStateFlowSectionView,
+  createStateFlowTelegramAdapter,
+  formatStateFlowSectionLabel,
+  formatStateFlowStatusLine,
+  loadStateFlowTelegramModules,
+  STATE_FLOW_TELEGRAM_ID,
+  type StateFlowTelegramAdapter,
+  type StateFlowTelegramButton,
+  type StateFlowTelegramCallbackContext,
+  type StateFlowTelegramControlResult,
+  type StateFlowTelegramLoader,
+  type StateFlowTelegramModules,
+  type StateFlowTelegramPort,
+  type StateFlowTelegramSectionContext,
+  type StateFlowTelegramSectionModule,
+  type StateFlowTelegramSnapshot,
+  type StateFlowTelegramStatusLine,
+  type StateFlowTelegramStatusModule,
+  type StateFlowTelegramView
+} from "./lib/telegram.ts";
 export { advanceTemporalState, readTemporalState, type TemporalState } from "./lib/temporal.ts";

package/node_modules/@llblab/pi-state-flow/lib/extension.ts

@@ -7,6 +7,7 @@ import { assistantToolCallCount, finalizedAssistantResponse, stateFlowProtocol }
 import { createPassiveContinuation, currentRunTrajectory, passiveContinuationMessages, runtimeContextMessage, VALIDATION_MESSAGE_TYPE, withoutPrivateValidation, type PassiveContinuation } from "./context.ts";
 import { ArtifactReadTracker } from "./acquisition.ts";
 import { loadStateFlowConfig } from "./config.ts";
+import { createStateFlowTelegramAdapter, type StateFlowTelegramControlResult, type StateFlowTelegramLoader } from "./telegram.ts";
 import { isAbsolute, relative, resolve, sep } from "node:path";
 import { SkillReadTracker } from "./skills.ts";
 import { emptySnapshot, migrationFailure, persistableSnapshot, type Snapshot } from "./snapshot.ts";
@@ -44,6 +45,7 @@ export interface StateFlowExtensionOptions {
 	repositoryRoot?: string;
 	knowledgeRoot?: string;
 	onRuntime?: (accessor: { read(offset?: number, scope?: StateScope): MaterializedState }) => void;
+	telegram?: { load?: StateFlowTelegramLoader };
 }
 
 export const PATCH_STATE_TOOL_NAME = "patch_state";
@@ -85,6 +87,7 @@ export default function stateFlowExtension(pi: ExtensionAPI, options: StateFlowE
 	const globalMarkdown = new GlobalMarkdownDiscovery(options.knowledgeRoot ?? getKnowledgeRoot(agentDir));
 	let artifactInvalidations: ArtifactInvalidationRequest[] = [];
 	let loggingWarningReported = false;
+	let telegramStartPending = false;
 
 	function sessionAddress(ctx: ExtensionContext): SessionAddress {
 		return resolveSessionAddress(ctx.sessionManager.getSessionFile(), ctx.sessionManager.getSessionId(), ctx.sessionManager.getHeader()?.timestamp);
@@ -455,6 +458,7 @@ export default function stateFlowExtension(pi: ExtensionAPI, options: StateFlowE
 		artifactInvalidations = [];
 		artifactReads.setCandidates([]);
 		artifactRefreshPending = false;
+		telegramStartPending = false;
 		activeContext = ctx;
 		const session = sessionAddress(ctx);
 		runtime = new TemporalRuntime(ctx.cwd, session, repositoryRoot);
@@ -748,74 +752,79 @@ export default function stateFlowExtension(pi: ExtensionAPI, options: StateFlowE
 		},
 	});
 
-	pi.registerCommand("state-flow-start", {
-		description: "Start State Flow mode",
-		handler: async (_args, ctx) => {
-			if (!activeContext) restoreActiveBranch(ctx);
-			const previousSnapshot = structuredClone(snapshot);
-			const previousPassiveContinuation = passiveContinuation;
-			const previousBootstrapContinuation = bootstrapContinuation;
-			const previousArtifactRefreshPending = artifactRefreshPending;
-			const previousArtifactInvalidations = structuredClone(artifactInvalidations);
-			try {
-				if (!runtime?.view && !snapshot.meta.durableBase && !branchStartsWithoutRuntime) {
-					throw new Error("Selected branch revision is unavailable; restore its original Git history before starting State Flow");
-				}
-				const branch = ctx.sessionManager.getBranch();
-				activeContext = ctx;
-				runtime ??= createRuntime(ctx);
-				if (branchStartsWithoutRuntime) runtime.prepare();
-				const bootstrap = (!branchHasSnapshot || !snapshot.config.enabled)
-					&& (hasPriorConversation(branch) || previousPassiveContinuation !== undefined);
-				if (!runtime.view && snapshot.meta.durableBase) {
-					snapshot = runtime.restore(snapshot.meta.durableBase, snapshot);
-					setPendingPublication(snapshot.meta.pendingPublication);
-					branchHasSnapshot = true;
-				}
-				const existingBranch = branchHasSnapshot;
-				snapshot = existingBranch
-					? resumeEpisode(snapshot, bootstrap)
-					: startEpisode(bootstrap);
-				if (snapshot.meta.remotePublication === undefined) {
-					snapshot.meta.remotePublication = serializeRemotePublicationPolicyDocument(
-						resolveRemotePublicationPolicy(existingBranch ? undefined : config.remotePublication, { legacyRuntime: existingBranch }),
-					);
-				}
+	function startStateFlow(ctx: ExtensionContext): StateFlowTelegramControlResult {
+		if (!activeContext) restoreActiveBranch(ctx);
+		telegramStartPending = false;
+		const previousSnapshot = structuredClone(snapshot);
+		const previousPassiveContinuation = passiveContinuation;
+		const previousBootstrapContinuation = bootstrapContinuation;
+		const previousArtifactRefreshPending = artifactRefreshPending;
+		const previousArtifactInvalidations = structuredClone(artifactInvalidations);
+		try {
+			if (!runtime?.view && !snapshot.meta.durableBase && !branchStartsWithoutRuntime) {
+				throw new Error("Selected branch revision is unavailable; restore its original Git history before starting State Flow");
+			}
+			const branch = ctx.sessionManager.getBranch();
+			activeContext = ctx;
+			runtime ??= createRuntime(ctx);
+			if (branchStartsWithoutRuntime) runtime.prepare();
+			const bootstrap = (!branchHasSnapshot || !snapshot.config.enabled)
+				&& (hasPriorConversation(branch) || previousPassiveContinuation !== undefined);
+			if (!runtime.view && snapshot.meta.durableBase) {
+				snapshot = runtime.restore(snapshot.meta.durableBase, snapshot);
+				setPendingPublication(snapshot.meta.pendingPublication);
 				branchHasSnapshot = true;
-				const publication = runtime.view
-					? runtime.promote(snapshot) ?? runtime.publish(snapshot)
-					: runtime.initialize(snapshot, true, undefined, branchStartsWithoutRuntime);
-				recordPolicyPublication(publication, ctx);
-				installScopeStates();
-				delete snapshot.legacySession;
-				clearRunTransient();
-				passiveContinuation = undefined;
-				bootstrapContinuation = snapshot.meta.bootstrap
-					? previousPassiveContinuation ?? previousBootstrapContinuation
-					: undefined;
-				deferArtifactRefresh();
-				syncStateFlowTools();
-				persist();
-				updateUi(ctx);
-				ctx.ui.notify(
-					snapshot.meta.bootstrap
-						? "State Flow enabled. The next complete agent run will migrate active context into state."
-						: "State Flow enabled. The next prompt starts a stateful agent run.",
-					"info",
-				);
-			} catch (error) {
-				snapshot = previousSnapshot;
-				passiveContinuation = previousPassiveContinuation;
-				bootstrapContinuation = previousBootstrapContinuation;
-				artifactRefreshPending = previousArtifactRefreshPending;
-				artifactInvalidations = previousArtifactInvalidations;
-				artifactReads.setCandidates(artifactInvalidations);
-				syncStateFlowTools();
-				ctx.ui.notify(
-					`State Flow could not initialize CWD state: ${error instanceof Error ? error.message : String(error)}`,
-					"error",
+			}
+			const existingBranch = branchHasSnapshot;
+			snapshot = existingBranch
+				? resumeEpisode(snapshot, bootstrap)
+				: startEpisode(bootstrap);
+			if (snapshot.meta.remotePublication === undefined) {
+				snapshot.meta.remotePublication = serializeRemotePublicationPolicyDocument(
+					resolveRemotePublicationPolicy(existingBranch ? undefined : config.remotePublication, { legacyRuntime: existingBranch }),
 				);
 			}
+			branchHasSnapshot = true;
+			const publication = runtime.view
+				? runtime.promote(snapshot) ?? runtime.publish(snapshot)
+				: runtime.initialize(snapshot, true, undefined, branchStartsWithoutRuntime);
+			recordPolicyPublication(publication, ctx);
+			installScopeStates();
+			delete snapshot.legacySession;
+			clearRunTransient();
+			passiveContinuation = undefined;
+			bootstrapContinuation = snapshot.meta.bootstrap
+				? previousPassiveContinuation ?? previousBootstrapContinuation
+				: undefined;
+			deferArtifactRefresh();
+			syncStateFlowTools();
+			persist();
+			updateUi(ctx);
+			ctx.ui.notify(
+				snapshot.meta.bootstrap
+					? "State Flow enabled. The next complete agent run will migrate active context into state."
+					: "State Flow enabled. The next prompt starts a stateful agent run.",
+				"info",
+			);
+			return { ok: true, message: "State Flow enabled" };
+		} catch (error) {
+			snapshot = previousSnapshot;
+			passiveContinuation = previousPassiveContinuation;
+			bootstrapContinuation = previousBootstrapContinuation;
+			artifactRefreshPending = previousArtifactRefreshPending;
+			artifactInvalidations = previousArtifactInvalidations;
+			artifactReads.setCandidates(artifactInvalidations);
+			syncStateFlowTools();
+			const message = `State Flow could not initialize CWD state: ${error instanceof Error ? error.message : String(error)}`;
+			ctx.ui.notify(message, "error");
+			return { ok: false, message };
+		}
+	}
+
+	pi.registerCommand("state-flow-start", {
+		description: "Start State Flow mode",
+		handler: async (_args, ctx) => {
+			startStateFlow(ctx);
 		},
 	});
 
@@ -826,47 +835,85 @@ export default function stateFlowExtension(pi: ExtensionAPI, options: StateFlowE
 		},
 	});
 
+	function stopStateFlow(ctx: ExtensionContext): StateFlowTelegramControlResult {
+		if (!activeContext) restoreActiveBranch(ctx);
+		telegramStartPending = false;
+		let selected = runtime;
+		let current = snapshot;
+		if (!selected?.view && snapshot.meta.durableBase) {
+			selected = createRuntime(ctx);
+			current = selected.restore(snapshot.meta.durableBase, snapshot);
+		}
+		const stoppedAt = Date.now();
+		const exitStates = selected?.view ? selected.states() : undefined;
+		const exitHandoff = current.config.enabled && exitStates
+			? createPassiveContinuation(
+				projectStateForModel(overlayStates(exitStates.global, exitStates.cwd, exitStates.session)),
+				stoppedAt,
+			)
+			: undefined;
+		const retainedHandoff = exitHandoff ?? (!current.config.enabled ? passiveContinuation : undefined);
+		const stopped = stopEpisode(current);
+		const publication = selected?.view ? selected.publish(stopped) : undefined;
+		if (selected !== runtime) {
+			runtime = selected;
+			installScopeStates();
+		}
+		snapshot = stopped;
+		recordPolicyPublication(publication, ctx);
+		branchHasSnapshot = true;
+		clearRunTransient();
+		passiveContinuation = retainedHandoff;
+		bootstrapContinuation = undefined;
+		artifactInvalidations = [];
+		artifactReads.setCandidates([]);
+		artifactRefreshPending = false;
+		if (exitHandoff) pi.appendEntry(PASSIVE_STOP_ENTRY_TYPE, { at: stoppedAt });
+		syncStateFlowTools();
+		persist();
+		updateUi(ctx);
+		return { ok: true, message: "State Flow disabled" };
+	}
+
 	pi.registerCommand("state-flow-stop", {
 		description: "Stop State Flow on the current session branch",
 		handler: async (_args, ctx) => {
-			if (!activeContext) restoreActiveBranch(ctx);
-			let selected = runtime;
-			let current = snapshot;
-			if (!selected?.view && snapshot.meta.durableBase) {
-				selected = createRuntime(ctx);
-				current = selected.restore(snapshot.meta.durableBase, snapshot);
-			}
-			const stoppedAt = Date.now();
-			const exitStates = selected?.view ? selected.states() : undefined;
-			const exitHandoff = current.config.enabled && exitStates
-				? createPassiveContinuation(
-					projectStateForModel(overlayStates(exitStates.global, exitStates.cwd, exitStates.session)),
-					stoppedAt,
-				)
-				: undefined;
-			const retainedHandoff = exitHandoff ?? (!current.config.enabled ? passiveContinuation : undefined);
-			const stopped = stopEpisode(current);
-			const publication = selected?.view ? selected.publish(stopped) : undefined;
-			if (selected !== runtime) {
-				runtime = selected;
-				installScopeStates();
-			}
-			snapshot = stopped;
-			recordPolicyPublication(publication, ctx);
-			branchHasSnapshot = true;
-			clearRunTransient();
-			passiveContinuation = retainedHandoff;
-			bootstrapContinuation = undefined;
-			artifactInvalidations = [];
-			artifactReads.setCandidates([]);
-			artifactRefreshPending = false;
-			if (exitHandoff) pi.appendEntry(PASSIVE_STOP_ENTRY_TYPE, { at: stoppedAt });
-			syncStateFlowTools();
-			persist();
-			updateUi(ctx);
+			stopStateFlow(ctx);
 		},
 	});
 
+	const telegram = createStateFlowTelegramAdapter({
+		...(options.telegram?.load === undefined ? {} : { load: options.telegram.load }),
+		port: {
+			snapshot: () => ({
+				enabled: snapshot.config.enabled,
+				step: snapshot.meta.step,
+				bootstrap: snapshot.meta.bootstrap === true,
+				startPending: telegramStartPending,
+			}),
+			canStartNow: () => activeContext === undefined || activeContext.isIdle(),
+			start: () => {
+				if (!activeContext) throw new Error("State Flow is not attached to an active session yet");
+				return startStateFlow(activeContext);
+			},
+			stop: () => {
+				if (!activeContext) throw new Error("State Flow is not attached to an active session yet");
+				try {
+					return stopStateFlow(activeContext);
+				} catch (error) {
+					return { ok: false, message: error instanceof Error ? error.message : String(error) };
+				}
+			},
+			deferStart: () => {
+				telegramStartPending = true;
+			},
+			cancelStart: () => {
+				telegramStartPending = false;
+			},
+		},
+	});
+	void telegram.ensure();
+
 	pi.on("before_agent_start", (event, ctx) => {
 		if (!snapshot.config.enabled) return;
 		skillReads.clear();
@@ -1005,7 +1052,11 @@ export default function stateFlowExtension(pi: ExtensionAPI, options: StateFlowE
 		updateUi(ctx);
 	});
 
-	pi.on("agent_settled", (_event, _ctx) => {
+	pi.on("agent_settled", (_event, ctx) => {
+		if (telegramStartPending && !snapshot.config.enabled) {
+			telegramStartPending = false;
+			startStateFlow(ctx);
+		}
 		if (snapshot.meta.remotePublication?.mode === "turn-end") launchPublicationWorker();
 	});
 
@@ -1015,8 +1066,13 @@ export default function stateFlowExtension(pi: ExtensionAPI, options: StateFlowE
 		retryPendingPush(ctx);
 		if (snapshot.meta.remotePublication?.mode === "turn-end") launchPublicationWorker();
 		updateUi(ctx);
+		void telegram.ensure();
 	});
 	pi.on("session_tree", (_event, ctx) => {
 		restoreActiveBranch(ctx);
 	});
+	pi.on("session_shutdown", () => {
+		telegramStartPending = false;
+		telegram.dispose();
+	});
 }

package/node_modules/@llblab/pi-state-flow/lib/telegram.ts

@@ -0,0 +1,267 @@
+// Domain: optional pi-telegram presentation adapter for State Flow status and branch controls.
+//
+// This is a leaf adapter. Core semantics, storage, and inference never depend on it; when
+// pi-telegram is absent or its registry is not ready, registration fails open and retries.
+
+export const STATE_FLOW_TELEGRAM_ID = "@llblab/pi-state-flow";
+const STATUS_IMPORT_SPECIFIERS = [
+	"@llblab/pi-telegram/status",
+	new URL("../../pi-telegram/api/status.ts", import.meta.url).href,
+];
+const SECTIONS_IMPORT_SPECIFIERS = [
+	"@llblab/pi-telegram/sections",
+	new URL("../../pi-telegram/api/sections.ts", import.meta.url).href,
+];
+
+export interface StateFlowTelegramSnapshot {
+	enabled: boolean;
+	step: number;
+	bootstrap: boolean;
+	startPending: boolean;
+}
+
+export interface StateFlowTelegramStatusLine {
+	label: string;
+	value: string;
+}
+
+export interface StateFlowTelegramButton {
+	text: string;
+	callback_data: string;
+}
+
+export interface StateFlowTelegramView {
+	text: string;
+	parseMode?: "markdown" | "html" | "plain";
+	replyMarkup?: { inline_keyboard: StateFlowTelegramButton[][] };
+}
+
+export interface StateFlowTelegramSectionContext {
+	callbackData(action: string, payload?: string): string;
+	edit(view: StateFlowTelegramView): Promise<void>;
+	answerCallback(text?: string): Promise<void>;
+}
+
+export interface StateFlowTelegramCallbackContext extends StateFlowTelegramSectionContext {
+	action: string;
+	payload: string;
+}
+
+export interface StateFlowTelegramStatusModule {
+	registerTelegramStatusLineProvider(
+		provider: (ctx: { activeModel?: unknown }) => StateFlowTelegramStatusLine | undefined,
+		options: { id: string },
+	): () => void;
+}
+
+export interface StateFlowTelegramSectionModule {
+	registerTelegramSection(section: {
+		id: string;
+		label: string;
+		getLabel?: () => string;
+		render: (ctx: StateFlowTelegramSectionContext) => StateFlowTelegramView | Promise<StateFlowTelegramView>;
+		handleCallback?: (ctx: StateFlowTelegramCallbackContext) => "handled" | "pass" | Promise<"handled" | "pass">;
+	}): () => void;
+}
+
+export interface StateFlowTelegramModules {
+	status?: StateFlowTelegramStatusModule;
+	sections?: StateFlowTelegramSectionModule;
+}
+
+export type StateFlowTelegramLoader = () => Promise<StateFlowTelegramModules>;
+
+export interface StateFlowTelegramControlResult {
+	ok: boolean;
+	message: string;
+}
+
+export interface StateFlowTelegramPort {
+	snapshot(): StateFlowTelegramSnapshot;
+	canStartNow(): boolean;
+	start(): StateFlowTelegramControlResult;
+	stop(): StateFlowTelegramControlResult;
+	deferStart(): void;
+	cancelStart(): void;
+}
+
+export interface StateFlowTelegramAdapter {
+	ensure(): Promise<boolean>;
+	dispose(): void;
+}
+
+/** The Status screen mirrors the terminal status identity: hidden while State Flow is off. */
+export function formatStateFlowStatusLine(snapshot: StateFlowTelegramSnapshot): StateFlowTelegramStatusLine | undefined {
+	if (!snapshot.enabled) return snapshot.startPending ? { label: "State Flow", value: "starting…" } : undefined;
+	return { label: "State Flow", value: snapshot.bootstrap ? "bootstrap" : `on · step #${snapshot.step}` };
+}
+
+/** Main-menu section label doubles as the live status text. */
+export function formatStateFlowSectionLabel(snapshot: StateFlowTelegramSnapshot): string {
+	if (!snapshot.enabled) return snapshot.startPending ? "🌀 State Flow: starting…" : "⚫️ State Flow: off";
+	return snapshot.bootstrap ? "🌀 State Flow: bootstrap" : `🌀 State Flow: #${snapshot.step}`;
+}
+
+export function buildStateFlowSectionView(
+	snapshot: StateFlowTelegramSnapshot,
+	callbackData: (action: string) => string,
+): StateFlowTelegramView {
+	const lines = ["<b>🌀 State Flow</b>", ""];
+	if (snapshot.enabled) {
+		lines.push("Status: <b>enabled</b>", `State iteration: <code>#${snapshot.step}</code>`);
+		if (snapshot.bootstrap) lines.push("Bootstrap run: the next completed run migrates active context into state.");
+	} else if (snapshot.startPending) {
+		lines.push("Status: <b>off</b>", "Start is pending until the current turn settles.");
+	} else {
+		lines.push("Status: <b>off</b>", "State Flow is disabled on this session branch.");
+	}
+	const buttons: StateFlowTelegramButton[] = [];
+	if (snapshot.startPending) {
+		buttons.push({ text: "✖️ Cancel start", callback_data: callbackData("cancel") });
+	} else if (snapshot.enabled) {
+		buttons.push({ text: "⏹ Stop", callback_data: callbackData("stop") });
+	} else {
+		buttons.push({ text: "▶️ Start", callback_data: callbackData("start") });
+	}
+	buttons.push({ text: "🔄 Refresh", callback_data: callbackData("refresh") });
+	return { text: lines.join("\n"), parseMode: "html", replyMarkup: { inline_keyboard: [buttons] } };
+}
+
+function buildStateFlowTelegramSection(port: StateFlowTelegramPort) {
+	return {
+		id: STATE_FLOW_TELEGRAM_ID,
+		label: "🌀 State Flow",
+		getLabel: () => formatStateFlowSectionLabel(port.snapshot()),
+		render: (ctx: StateFlowTelegramSectionContext) =>
+			buildStateFlowSectionView(port.snapshot(), (action) => ctx.callbackData(action)),
+		handleCallback: async (ctx: StateFlowTelegramCallbackContext) => {
+			if (ctx.action !== "start" && ctx.action !== "stop" && ctx.action !== "cancel" && ctx.action !== "refresh") return "pass" as const;
+			let notice: string | undefined;
+			try {
+				if (ctx.action === "start") {
+					if (port.canStartNow()) notice = port.start().message;
+					else {
+						port.deferStart();
+						notice = "State Flow will start after the current turn";
+					}
+				} else if (ctx.action === "stop") {
+					notice = port.stop().message;
+				} else if (ctx.action === "cancel") {
+					port.cancelStart();
+					notice = "Pending start cancelled";
+				}
+			} catch (error) {
+				notice = error instanceof Error ? error.message : String(error);
+			}
+			await ctx.answerCallback(notice);
+			await ctx.edit(buildStateFlowSectionView(port.snapshot(), (action) => ctx.callbackData(action)));
+			return "handled" as const;
+		},
+	};
+}
+
+async function importTelegramModule<TModule>(
+	specifiers: readonly string[],
+	guard: (module: unknown) => module is TModule,
+): Promise<TModule | undefined> {
+	for (const specifier of specifiers) {
+		try {
+			const imported = await import(specifier);
+			if (guard(imported)) return imported;
+		} catch {
+			// pi-telegram is optional; its absence only disables the Telegram surface.
+		}
+	}
+	return undefined;
+}
+
+/** Default loader; injectable so tests and embedded hosts can control transport presence. */
+export async function loadStateFlowTelegramModules(): Promise<StateFlowTelegramModules> {
+	const status = await importTelegramModule<StateFlowTelegramStatusModule>(
+		STATUS_IMPORT_SPECIFIERS,
+		(module): module is StateFlowTelegramStatusModule =>
+			typeof (module as StateFlowTelegramStatusModule | undefined)?.registerTelegramStatusLineProvider === "function",
+	);
+	const sections = await importTelegramModule<StateFlowTelegramSectionModule>(
+		SECTIONS_IMPORT_SPECIFIERS,
+		(module): module is StateFlowTelegramSectionModule =>
+			typeof (module as StateFlowTelegramSectionModule | undefined)?.registerTelegramSection === "function",
+	);
+	return { ...(status === undefined ? {} : { status }), ...(sections === undefined ? {} : { sections }) };
+}
+
+export function createStateFlowTelegramAdapter(options: {
+	port: StateFlowTelegramPort;
+	load?: StateFlowTelegramLoader;
+}): StateFlowTelegramAdapter {
+	const load = options.load ?? loadStateFlowTelegramModules;
+	let generation = 0;
+	let statusRegistered = false;
+	let sectionRegistered = false;
+	let registration: Promise<boolean> | undefined;
+	const disposers: Array<() => void> = [];
+
+	const register = async (): Promise<boolean> => {
+		const epoch = generation;
+		let modules: StateFlowTelegramModules;
+		try {
+			modules = await load();
+		} catch {
+			return false;
+		}
+		// A shutdown during loading must not leave a registration behind.
+		if (epoch !== generation) return false;
+		if (!statusRegistered && modules.status) {
+			try {
+				const dispose = modules.status.registerTelegramStatusLineProvider(
+					() => formatStateFlowStatusLine(options.port.snapshot()),
+					{ id: STATE_FLOW_TELEGRAM_ID },
+				);
+				if (epoch === generation) {
+					disposers.push(dispose);
+					statusRegistered = true;
+				} else {
+					dispose();
+				}
+			} catch {
+				// Registry not initialized yet; the next ensure retries.
+			}
+		}
+		if (!sectionRegistered && modules.sections) {
+			try {
+				const dispose = modules.sections.registerTelegramSection(buildStateFlowTelegramSection(options.port));
+				if (epoch === generation) {
+					disposers.push(dispose);
+					sectionRegistered = true;
+				} else {
+					dispose();
+				}
+			} catch {
+				// Registry not initialized yet; the next ensure retries.
+			}
+		}
+		return statusRegistered || sectionRegistered;
+	};
+
+	return {
+		async ensure(): Promise<boolean> {
+			if (statusRegistered && sectionRegistered) return true;
+			registration ??= register().finally(() => {
+				registration = undefined;
+			});
+			return registration;
+		},
+		dispose(): void {
+			generation += 1;
+			for (const dispose of disposers.splice(0)) {
+				try {
+					dispose();
+				} catch {
+					// Disposal is best-effort; pi-telegram owns its registry lifetime.
+				}
+			}
+			statusRegistered = false;
+			sectionRegistered = false;
+		},
+	};
+}

package/node_modules/@llblab/pi-state-flow/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llblab/pi-state-flow",
-  "version": "0.8.1",
+  "version": "0.9.0",
   "private": false,
   "description": "Incremental scoped state/context compiler for Pi, inspired by SKILL.state",
   "keywords": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llblab/pi-kit",
-  "version": "0.9.1",
+  "version": "0.10.0",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -43,8 +43,8 @@
     "@llblab/pi-actors": "0.53.0",
     "@llblab/pi-clean-room": "0.1.1",
     "@llblab/pi-codex-usage": "0.9.4",
-    "@llblab/pi-grow-loop": "0.7.5",
-    "@llblab/pi-state-flow": "0.8.1",
+    "@llblab/pi-grow-loop": "0.8.0",
+    "@llblab/pi-state-flow": "0.9.0",
     "@llblab/pi-telegram": "0.45.4",
     "@llblab/skills": "1.15.0"
   },