@selesai/code 0.5.28 → 0.6.1

package/dist/extensions/pi-intercom/types.ts

@@ -1,3 +1,5 @@
+export const EXTENSION_BUS_FEATURE = "extension-bus-v1";
+
 export interface SessionInfo {
   id: string;
   name?: string;
@@ -7,11 +9,28 @@ export interface SessionInfo {
   startedAt: number;
   lastActivity: number;
   status?: string;
+  peerUid?: number;
+  trustedLocal?: boolean;
+  /** Live context-window usage, pushed via presence from the source session's
+   *  getContextUsage(). contextPct is 0..100 (rounded); contextTokens /
+   *  contextWindow are raw token counts. All optional: unknown right after a
+   *  compaction (before the next assistant response), when no model is selected,
+   *  or on older clients that never report it. */
+  contextPct?: number;
+  contextTokens?: number;
+  contextWindow?: number;
 }
 
 export interface Message {
   id: string;
   timestamp: number;
+  senderSequence?: number;
+  brokerReceivedAt?: number;
+  brokerDeliveredAt?: number;
+  receiverReceivedAt?: number;
+  injectedAt?: number;
+  supersedes?: string;
+  retryOf?: string;
   replyTo?: string;
   expectsReply?: boolean;
   content: {
@@ -27,15 +46,62 @@ export interface Attachment {
   language?: string;
 }
 
+export type MessageReceiptStatus = "receiver_received" | "queued" | "injected" | "acknowledged" | "expired" | "cancelled" | "superseded" | "cancellation_requested";
+
+export interface MessageReceipt {
+  messageId: string;
+  status: MessageReceiptStatus;
+  timestamp: number;
+  detail?: string;
+}
+
+export type MessageControlAction = "cancel" | "supersede";
+
+export interface MessageControl {
+  messageId: string;
+  action: MessageControlAction;
+  timestamp: number;
+  supersededBy?: string;
+  detail?: string;
+}
+
+export interface ExtensionCapability {
+  namespace: string;
+  ownerEligible: boolean;
+}
+
+export type SessionRegistration = Omit<SessionInfo, "id" | "peerUid" | "trustedLocal"> & {
+  extensions?: ExtensionCapability[];
+};
+
 export type ClientMessage =
-  | { type: "register"; session: Omit<SessionInfo, "id"> }
+  | { type: "register"; session: SessionRegistration; sessionId?: string; stateId?: string }
   | { type: "unregister" }
+  | { type: "extension_capabilities_update"; extensions: ExtensionCapability[] }
   | { type: "list"; requestId: string }
   | { type: "send"; to: string; message: Message }
-  | { type: "presence"; name?: string; status?: string; model?: string };
+  | { type: "message_receipt"; receipt: MessageReceipt }
+  | { type: "cancel_message"; messageId: string }
+  | { type: "cancel_ask"; messageId: string }
+  | { type: "presence"; name?: string; status?: string; model?: string; contextPct?: number | null; contextTokens?: number | null; contextWindow?: number | null }
+  | {
+      type: "extension_publish";
+      namespace: string;
+      audience: "owner" | "capable";
+      ownerEpoch?: string;
+      ownerOnly?: boolean;
+      payload: unknown;
+    }
+  | {
+      type: "extension_state_commit";
+      namespace: string;
+      ownerEpoch: string;
+      expectedRevision: number;
+      payload: unknown;
+    };
 
 export type BrokerMessage =
-  | { type: "registered"; sessionId: string }
+  | { type: "registered"; sessionId: string; features?: string[] }
   | { type: "sessions"; requestId: string; sessions: SessionInfo[] }
   | { type: "message"; from: SessionInfo; message: Message }
   | { type: "presence_update"; session: SessionInfo }
@@ -43,4 +109,28 @@ export type BrokerMessage =
   | { type: "session_left"; sessionId: string }
   | { type: "error"; error: string }
   | { type: "delivered"; messageId: string }
-  | { type: "delivery_failed"; messageId: string; reason: string };
+  | { type: "delivery_failed"; messageId: string; reason: string }
+  | { type: "message_receipt"; from: SessionInfo; receipt: MessageReceipt }
+  | { type: "message_control"; from: SessionInfo; control: MessageControl }
+  | { type: "extension_owner"; namespace: string; ownerId?: string; ownerEpoch?: string }
+  | {
+      type: "extension_message";
+      namespace: string;
+      fromSessionId: string;
+      ownerId?: string;
+      ownerEpoch?: string;
+      payload: unknown;
+    }
+  | {
+      type: "extension_state";
+      namespace: string;
+      revision: number;
+      payload: unknown;
+    }
+  | {
+      type: "extension_state_result";
+      namespace: string;
+      committed: boolean;
+      revision: number;
+      reason?: string;
+    };

package/dist/extensions/pi-intercom/ui/compose.ts

@@ -1,8 +1,8 @@
 import type { Component, TUI } from "@earendil-works/pi-tui";
 import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 import type { KeybindingsManager, Theme } from "@selesai/code";
-import type { IntercomClient } from "../broker/client.js";
-import type { SessionInfo } from "../types.js";
+import type { IntercomClient } from "../broker/client.ts";
+import type { SessionInfo } from "../types.ts";
 
 export interface ComposeResult {
   sent: boolean;
@@ -103,8 +103,12 @@ export class ComposeOverlay implements Component {
   }
 
   render(width: number): string[] {
-    const innerWidth = Math.max(24, Math.min(width - 2, 72));
-    const contentWidth = Math.max(1, innerWidth - 2);
+    const innerWidth = Math.max(1, Math.min(width, 72));
+    if (innerWidth === 1) {
+      return [this.theme.fg("accent", "│")];
+    }
+
+    const contentWidth = Math.max(0, innerWidth - 2);
     const footer = `${this.keybindings.getKeys("tui.select.confirm").join("/")}: Send • ${this.keybindings.getKeys("tui.select.cancel").join("/")}: Close`;
     const border = (text: string) => this.theme.fg("accent", text);
     const row = (text = "") => {

package/dist/extensions/pi-intercom/ui/inline-message.ts

@@ -1,7 +1,7 @@
 import type { Component } from "@earendil-works/pi-tui";
 import { truncateToWidth, visibleWidth, wrapTextWithAnsi } from "@earendil-works/pi-tui";
 import type { Theme } from "@selesai/code";
-import type { SessionInfo, Message } from "../types.js";
+import type { SessionInfo, Message } from "../types.ts";
 
 export class InlineMessageComponent implements Component {
   private from: SessionInfo;
@@ -9,13 +9,26 @@ export class InlineMessageComponent implements Component {
   private theme: Theme;
   private replyCommand?: string;
   private bodyText?: string;
+  private collapsed: boolean;
+  // Caches assume message/bodyText never mutate after construction; theme
+  // styling stays outside the caches so live theme changes apply per render.
+  private collapsedPreview?: string;
+  private wrappedBody?: { width: number; lines: string[] };
 
-  constructor(from: SessionInfo, message: Message, theme: Theme, replyCommand?: string, bodyText?: string) {
+  constructor(
+    from: SessionInfo,
+    message: Message,
+    theme: Theme,
+    replyCommand?: string,
+    bodyText?: string,
+    collapsed = false,
+  ) {
     this.from = from;
     this.message = message;
     this.theme = theme;
     this.replyCommand = replyCommand;
     this.bodyText = bodyText;
+    this.collapsed = collapsed;
   }
 
   invalidate(): void {}
@@ -23,53 +36,76 @@ export class InlineMessageComponent implements Component {
   render(width: number): string[] {
     const lines: string[] = [];
     const borderChar = "─";
+    const senderName = this.from.name || this.from.id.slice(0, 8);
     if (width < 3) {
-      return [truncateToWidth(`From ${this.from.name || this.from.id.slice(0, 8)}`, width)];
+      return [truncateToWidth(`From ${senderName}`, width)];
     }
     const bodyWidth = Math.max(1, width - 2);
 
-    const senderName = this.from.name || this.from.id.slice(0, 8);
     const header = ` 📨 From: ${senderName} (${this.from.cwd}) `;
-    const headerText = truncateToWidth(header, bodyWidth, "");
+    const headerText = truncateToWidth(this.collapsed ? `${header} Ctrl+O expands ` : header, bodyWidth, "");
     const headerPadding = Math.max(0, bodyWidth - visibleWidth(headerText));
-    lines.push(this.theme.fg("accent", `╭${headerText}${borderChar.repeat(headerPadding)}╮`));
+    lines.push(
+      this.theme.fg("muted", "╭") +
+        this.theme.fg("toolTitle", headerText) +
+        this.theme.fg("muted", `${borderChar.repeat(headerPadding)}╮`),
+    );
 
-    const contentLines = wrapTextWithAnsi(this.bodyText || this.message.content.text, bodyWidth);
-    for (const line of contentLines) {
-      const text = truncateToWidth(line, bodyWidth, "");
+    const frameLine = (content: string): string => {
+      const text = truncateToWidth(content, bodyWidth, "");
       const padding = Math.max(0, bodyWidth - visibleWidth(text));
-      lines.push(this.theme.fg("accent", `│${text}${" ".repeat(padding)}│`));
+      return this.theme.fg("muted", "│") + text + this.theme.fg("muted", `${" ".repeat(padding)}│`);
+    };
+
+    if (this.collapsed) {
+      this.collapsedPreview ??= (this.bodyText || this.message.content.text).replace(/\s+/g, " ").trim();
+      lines.push(frameLine(this.theme.fg("text", this.collapsedPreview)));
+
+      const meta: string[] = [];
+      if (this.replyCommand) meta.push(`↩ To reply: ${this.replyCommand}`);
+      if (this.message.content.attachments?.length) {
+        const count = this.message.content.attachments.length;
+        meta.push(`📎 ${count} attachment${count === 1 ? "" : "s"}`);
+      }
+      if (this.message.replyTo && !this.message.expectsReply) meta.push(`↳ Reply to ${this.message.replyTo.slice(0, 8)}`);
+      meta.push("Ctrl+O to expand");
+
+      lines.push(frameLine(this.theme.fg("dim", ` ${meta.join(" · ")}`)));
+      lines.push(this.theme.fg("muted", `╰${borderChar.repeat(bodyWidth)}╯`));
+      return lines;
+    }
+
+    if (this.wrappedBody?.width !== bodyWidth) {
+      this.wrappedBody = {
+        width: bodyWidth,
+        lines: wrapTextWithAnsi(this.bodyText || this.message.content.text, bodyWidth),
+      };
+    }
+    for (const line of this.wrappedBody.lines) {
+      lines.push(frameLine(this.theme.fg("text", line)));
     }
 
     if (this.replyCommand) {
-      lines.push(this.theme.fg("accent", `│${" ".repeat(bodyWidth)}│`));
+      lines.push(frameLine(""));
       const replyLines = wrapTextWithAnsi(this.theme.fg("dim", ` ↩ To reply: ${this.replyCommand}`), bodyWidth);
       for (const line of replyLines) {
-        const text = truncateToWidth(line, bodyWidth, "");
-        const padding = Math.max(0, bodyWidth - visibleWidth(text));
-        lines.push(this.theme.fg("accent", `│${text}${" ".repeat(padding)}│`));
+        lines.push(frameLine(line));
       }
     }
 
     if (this.message.content.attachments?.length) {
-      lines.push(this.theme.fg("accent", `│${" ".repeat(bodyWidth)}│`));
+      lines.push(frameLine(""));
       for (const att of this.message.content.attachments) {
-        const label = this.theme.fg("dim", ` 📎 ${att.name}`);
-        const text = truncateToWidth(label, bodyWidth, "");
-        const padding = Math.max(0, bodyWidth - visibleWidth(text));
-        lines.push(this.theme.fg("accent", `│${text}${" ".repeat(padding)}│`));
+        lines.push(frameLine(this.theme.fg("dim", ` 📎 ${att.name}`)));
       }
     }
 
     if (this.message.replyTo && !this.message.expectsReply) {
-      lines.push(this.theme.fg("accent", `│${" ".repeat(bodyWidth)}│`));
-      const reply = this.theme.fg("dim", ` ↳ Reply to ${this.message.replyTo.slice(0, 8)}`);
-      const text = truncateToWidth(reply, bodyWidth, "");
-      const padding = Math.max(0, bodyWidth - visibleWidth(text));
-      lines.push(this.theme.fg("accent", `│${text}${" ".repeat(padding)}│`));
+      lines.push(frameLine(""));
+      lines.push(frameLine(this.theme.fg("dim", ` ↳ Reply to ${this.message.replyTo.slice(0, 8)}`)));
     }
 
-    lines.push(this.theme.fg("accent", `╰${borderChar.repeat(bodyWidth)}╯`));
+    lines.push(this.theme.fg("muted", `╰${borderChar.repeat(bodyWidth)}╯`));
 
     return lines;
   }

package/dist/extensions/pi-intercom/ui/session-list.ts

@@ -1,7 +1,7 @@
 import type { Component } from "@earendil-works/pi-tui";
 import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 import type { KeybindingsManager, Theme } from "@selesai/code";
-import type { SessionInfo } from "../types.js";
+import type { SessionInfo } from "../types.ts";
 
 function middleTruncate(text: string, maxWidth: number): string {
   if (visibleWidth(text) <= maxWidth) {
@@ -101,8 +101,12 @@ export class SessionListOverlay implements Component {
   }
 
   render(width: number): string[] {
-    const innerWidth = Math.max(36, Math.min(width - 2, 88));
-    const contentWidth = Math.max(1, innerWidth - 2);
+    const innerWidth = Math.max(1, Math.min(width, 88));
+    if (innerWidth === 1) {
+      return [this.theme.fg("accent", "│")];
+    }
+
+    const contentWidth = Math.max(0, innerWidth - 2);
     const footer = `${this.keybindings.getKeys("tui.select.confirm").join("/")}: Message • ${this.keybindings.getKeys("tui.select.cancel").join("/")}: Close`;
     const border = (text: string) => this.theme.fg("accent", text);
     const row = (text = "") => {

package/dist/extensions/pi-subagents/CHANGELOG.md

@@ -2,6 +2,94 @@
 
 ## [Unreleased]
 
+### Changed
+- Made per-child debug artifacts opt-in with `artifacts: true` instead of writing prompt, output, transcript, and metadata copies for every run by default.
+
+## [0.40.0] - 2026-08-01
+
+### Added
+- Documented an optional recommended model-tiering setup in the README: fast workhorse, standard well-scoped, deep-but-bounded, and taste/intent tiers, with cross-provider `fallbackModels` guidance for usage-limit resilience.
+- Added `description` to `subagents.agentOverrides` so deployments can replace the discovered description for builtin and custom agents in list output. Thanks to @chronoAP for #724.
+
+### Changed
+- Refreshed the bundled `pi-subagents` skill for the 0.39 surface: Fleet inspector live controls (`s` steer, `D` stop), the recommended model-tiering recipe, `agentOverrides.description`, `projectRootResolution: "git-root"`, running-card live-detail/model badges, and the newer extension RPC capability projections (`fleetStatus`, `launchResolvedExtensions`, `runtimeAcknowledgedExtensions`, `(runId, index)` correlation). Corrected the stale README "inspection-only" fleet inspector wording.
+
+### Fixed
+- Grouped intercom results now report child process status separately from provenance-aware output availability, including salvage guidance when a failed process produced output. Thanks to @youlikemodernart for #727.
+- Collapsed running foreground subagent rows now show the model and thinking level: single-result cards include the effective thinking suffix and parallel/chain rows show the per-child model badge, matching the async widget.
+
+## [0.39.0] - 2026-08-01
+
+### Added
+- Added session-scoped `allowedAgents` capability ceilings for restricting launchable agent roles without global agent disabling. Thanks to @aoguai for #719.
+- Added stable foreground result row indexes for correlating child progress and final results. Thanks to @rochecompaan (Patchmill) for #720.
+- Added watchdog current-scope context, optional every-N-tools scope-monitor cadence, and visible main-session blocker auto-follow, inspired by Scopey (github.com/ArchAstro/scopey) by Calvin Grunewald (@CalvinGrunewald).
+- Added optional `runtimeAcknowledgedExtensions` status/result/RPC metadata for cooperating child-runtime extensions that emit `subagent:acknowledge-extension`. Thanks to @saleemlala for #705.
+- Added `/subagents-detach` for detaching the active foreground single-subagent run without terminating the child. Thanks to @magoz for #708/#711.
+- Added agent frontmatter aliases and built-in worker aliases for `developer`, `coder`, `implementer`, and `develop`, while keeping canonical names in execution state. Thanks to @selimerunkut for #695.
+- Added explicit chain approval checkpoints with `{ checkpoint, message? }`, `approve-checkpoint`/`reject-checkpoint` controls, persisted checkpoint status, and terminal `rejected` outcomes. Thanks to @saleemlala for #694.
+- Added optional root `usageBudget` limits for reported token and cost totals, with soft status reporting and hard gating for later child launches without stopping already-running children. Thanks to @saleemlala for #693.
+- Added optional `launchResolvedExtensions` status/result/RPC metadata with opaque launch-resolved child extension identifiers and ambient-extension state. Thanks to @saleemlala for #691.
+- Added Fleet inspector controls to steer the selected live async child and stop its top-level async run with confirmation. Thanks to @saleemlala for #692.
+
+### Changed
+- Reduced repeated runtime filesystem work by caching stable Pi config-directory resolution, incrementally sanitizing run history, and limiting nested control-result polling to files created for the active request.
+
+### Fixed
+- Show per-child async task descriptions in the persistent running-subagents status widget instead of repeating the run-level description for every parallel child.
+- Restored model and thinking-effort badges in the persistent running-subagents status widget.
+- Retained foreground controls until scheduling owners and active children settle, keeping queued foreground work steerable after early result handling. Thanks to @magoz for #708/#709/#710.
+- Render resolved model and thinking effort for active and recent foreground children in Fleet inspector summaries and details. Thanks to @saleemlala for #706.
+- Resynchronized async job control-event scans that resume inside an oversized JSONL record, avoiding malformed-tail parse noise while preserving later control events. Thanks to @vicary for #700.
+- Report signal-terminated child processes with a canonical signal error instead of stderr-tail noise and classify those results separately from ordinary task failures. Thanks to @cking000bigdemon for #688.
+
+## [0.38.0] - 2026-07-30
+
+### Added
+- Added `j`/`k` navigation aliases to the non-filterable `/subagents-stop` selector and clarify step list while preserving text input in editor and search modes. Thanks to @magoz for #686.
+- Added the optional versioned `fleetStatus` RPC capability with bounded, current-session child roles, goals, model/effort, split token usage, elapsed timestamps, stable opaque reconciliation keys, and explicit overflow counts. Thanks to @neumie for #682.
+
+### Fixed
+- Enabled the advertised `j`/`k` navigation aliases after activating the persistent FleetView while leaving printable editor input untouched before activation. Thanks to @magoz for #685.
+- Added opt-in `subagents.projectRootResolution: "git-root"` so monorepos and git worktrees can keep the default nearest-root behavior unless they choose to resolve project packages and `agentOverrides` from the git root. Thanks to @klajdo-f for #677.
+- Recognized structurally compatible custom editors in FleetView focus detection, restoring FleetView arrow-key activation and navigation when a custom editor has focus. Thanks to @magoz for #679.
+- Scoped foreground fleet records to their originating parent session and propagated resolved model, thinking effort, and split input/output usage through live foreground controls.
+- Matched fleet RPC filtering to the canonical session-file identity used by live async and foreground state.
+- Kept pi-intercom stable IDs from leaking into child sessions and used the current intercom runtime ID for unnamed supervisor targets.
+- Improved acceptance policy validation errors and tool-schema guidance for invalid evidence kinds. Thanks to @atimofeev for #672.
+- Tolerated temporary steering inbox scan failures so pending steer requests can be retried on the next poll. Thanks to @hughcars for #670.
+- Retried short, zero-activity child startup exits on the same model with bounded backoff, reducing concurrent subagent launch races without replaying model or tool work. Thanks to @felipeteodorocw for #671.
+- Bounded streamed subagent progress snapshots so a long or deeply nested fan-out no longer emits a `tool_execution_update` line above the child-stdout protocol cap and gets the child killed with `protocol_output_limit`. Streamed `onUpdate` snapshots now carry compact tool-call summaries instead of the full message transcript, cap `recentTools`, and truncate `recentOutput` line length; the returned result and detached-exit recovery keep the full transcript. Thanks to @shaharmor for #680/#681.
+
+## [0.37.2] - 2026-07-28
+
+### Changed
+- Reduced repeated scanning and file reads in live TUI rendering and skill loading.
+
+### Fixed
+- Passed `--no-context-files` to child Pi runs when an agent disables inherited project context, avoiding stale prompt-header parsing as Pi's context block format changes. Thanks to @KorenKrita for #667.
+
+## [0.37.1] - 2026-07-27
+
+### Added
+- Added package-owned resume control to the extension RPC surface, including preserved revival metadata and native result-delivery controls. Thanks to @shaneconner for #656.
+
+### Changed
+- Added a generous 30-minute foreground wall-clock timeout when neither the call nor selected agent provides `timeoutMs`/`maxRuntimeMs`. Explicit call values and agent timeout defaults remain authoritative.
+- Split the bundled `pi-subagents` skill into a short router plus focused reference files to avoid truncation and unnecessary context loading. Thanks to @peedrr for #659.
+- Added `fleetViewPlacement` so the persistent FleetView can be placed above or below the editor. Thanks to @rtbe for #660.
+- Refreshed the bundled `pi-subagents` skill for 0.35–0.37 control and config surface: `/subagents`, `/subagents-stop`, `/subagents-watchdog`, `stop`/`append-step`, parallel `count`, watchdog overview, frontmatter `async`/`timeoutMs`/`turnBudget` defaults, `artifactDir`/`asyncWidget`, fresh/fork badges, and builtin worker/delegate ambient-tool boundaries.
+
+### Fixed
+- Suppressed redundant local completion notifications after acknowledged grouped intercom delivery, while preserving fallback notifications when relay delivery is unavailable. Thanks to @Wiandono for #662.
+- Stopped the persistent FleetView from refreshing through a stale extension context after session replacement or reload. Thanks to @kylegl for #657.
+- Invalidated the live Fleet inspector before timer-driven refreshes so cached transcript frames do not repeat stale headers. Thanks to @shaneconner for #661.
+- Removed repository write tools from the bundled planner and marked it read-only so planning-only runs cannot modify project files while producing `plan.md`. Thanks to @DrunkenDonkey80 for #664.
+- Kept async child model inheritance stable after parent continuation so background launches keep using the authenticated parent provider/model. Thanks to @DrunkenDonkey80 for #663.
+- Accepted persisted async recovery descriptors that include the launch contract digest written by async execution. Thanks to @boadij for #654 and #652.
+- Classified verification-only tasks that prohibit product/source/config files as read-only. Thanks to @git-geeky for #648.
+- Matched pi-mcp-adapter metadata cache identity so valid direct MCP tools are not rejected as stale when tool filters, socket transport, URL interpolation, or command-backed secrets are configured. Thanks to @mattrobenolt for #649.
+
 ## [0.37.0] - 2026-07-25
 
 ### Added

package/dist/extensions/pi-subagents/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nico Bailon
+
+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.