@selesai/code 0.8.2 → 0.8.4

package/dist/extensions/pi-subagents/test/unit/workflow-launch-params.test.ts

@@ -0,0 +1,113 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { prepareWorkflowLaunchParams } from "../../src/runs/foreground/subagent-executor.ts";
+
+describe("workflow launch params", () => {
+	it("keeps omitted workflow child async foreground", () => {
+		assert.deepEqual(
+			prepareWorkflowLaunchParams(
+				{},
+				{ agent: "worker", task: "Run" },
+				"workflow-run",
+				"run",
+			),
+			{
+				agent: "worker",
+				task: "Run",
+				async: false,
+				workflowParentRunId: "workflow-run",
+				workflowKey: "run",
+			},
+		);
+	});
+
+	it("preserves explicit async workflow children", () => {
+		assert.deepEqual(
+			prepareWorkflowLaunchParams(
+				{},
+				{ agent: "worker", task: "Run", async: true },
+				"workflow-run",
+				"run",
+			),
+			{
+				agent: "worker",
+				task: "Run",
+				async: true,
+				workflowParentRunId: "workflow-run",
+				workflowKey: "run",
+			},
+		);
+	});
+
+	it("places workflow child gates inside managed worktree tasks", () => {
+		assert.deepEqual(
+			prepareWorkflowLaunchParams(
+				{},
+				{ agent: "worker", task: "Implement", worktree: true, gate: "npm test" },
+				"workflow-run",
+				"gated",
+			),
+			{
+				worktree: true,
+				async: false,
+				workflowParentRunId: "workflow-run",
+				workflowKey: "gated",
+				tasks: [{
+					agent: "worker",
+					task: "Implement",
+					acceptance: { level: "verified", verify: [{ id: "gate", command: "npm test" }] },
+				}],
+			},
+		);
+	});
+
+	it("rejects gate defaults on retained resume items", () => {
+		assert.throws(
+			() => prepareWorkflowLaunchParams(
+				{ gate: "npm test" },
+				{ resume: "retained-run", task: "Continue" },
+				"workflow-run",
+				"continue",
+			),
+			/gate is not supported with retained resume/,
+		);
+		assert.throws(
+			() => prepareWorkflowLaunchParams(
+				{},
+				{ resume: "retained-run", task: "Continue", gate: "npm test" },
+				"workflow-run",
+				"continue",
+			),
+			/gate is not supported with retained resume/,
+		);
+	});
+
+	it("preserves execution limits when routing retained resume items", () => {
+		assert.deepEqual(
+			prepareWorkflowLaunchParams(
+				{ turnBudget: { maxTurns: 8 }, toolBudget: { hard: 12, block: ["read"] } },
+				{
+					resume: " retained-run ",
+					task: "Continue carefully",
+					maxRuntimeMs: 5_000,
+					turnBudget: { maxTurns: 3, graceTurns: 1 },
+					toolBudget: { soft: 2, hard: 4, block: "*" },
+				},
+				"workflow-run",
+				"continue",
+				{ missionDetached: true },
+			),
+			{
+				action: "resume",
+				id: "retained-run",
+				message: "Continue carefully",
+				workflowParentRunId: "workflow-run",
+				workflowKey: "continue",
+				mission: false,
+				timeoutMs: 5_000,
+				turnBudget: { maxTurns: 3, graceTurns: 1 },
+				toolBudget: { soft: 2, hard: 4, block: "*" },
+			},
+		);
+	});
+});

package/dist/extensions/pi-subagents/test/unit/worktree.test.ts

@@ -178,8 +178,8 @@ describe("worktree", () => {
 		assert.equal(
 			findWorktreeTaskCwdConflict(
 				[
-					{ agent: "builder-a" },
-					{ agent: "builder-b", cwd: sharedCwd },
+					{ agent: "worker-a" },
+					{ agent: "worker-b", cwd: sharedCwd },
 				],
 				sharedCwd,
 			),
@@ -191,7 +191,7 @@ describe("worktree", () => {
 		const sharedCwd = path.join("/tmp", "repo");
 		assert.equal(
 			findWorktreeTaskCwdConflict(
-				[{ agent: "builder-a", cwd: "." }],
+				[{ agent: "worker-a", cwd: "." }],
 				sharedCwd,
 			),
 			undefined,
@@ -202,14 +202,14 @@ describe("worktree", () => {
 		const sharedCwd = path.join("/tmp", "repo");
 		const conflict = findWorktreeTaskCwdConflict(
 			[
-				{ agent: "builder-a", cwd: sharedCwd },
-				{ agent: "builder-b", cwd: path.join(sharedCwd, "packages", "app") },
+				{ agent: "worker-a", cwd: sharedCwd },
+				{ agent: "worker-b", cwd: path.join(sharedCwd, "packages", "app") },
 			],
 			sharedCwd,
 		);
 		assert.deepEqual(conflict, {
 			index: 1,
-			agent: "builder-b",
+			agent: "worker-b",
 			cwd: path.join(sharedCwd, "packages", "app"),
 		});
 	});
@@ -338,7 +338,7 @@ describe("worktree", () => {
 			setup = createWorktrees(repoDir, "captured", 1);
 			const worktreePath = setup.worktrees[0]!.path;
 			fs.writeFileSync(path.join(worktreePath, "tracked.txt"), "captured\n", "utf-8");
-			const diffs = diffWorktrees(setup, ["builder"], path.join(repoDir, "artifacts", "captured"));
+			const diffs = diffWorktrees(setup, ["worker"], path.join(repoDir, "artifacts", "captured"));
 			assert.equal(diffs[0]?.error, undefined);
 			assert.ok(fs.statSync(diffs[0]!.patchPath).size > 0);
 

package/dist/extensions/pi-subagents/test/unit/writer-budget-guidance.test.ts

@@ -7,11 +7,11 @@ const readProjectFile = (file: string): string => readFileSync(join(process.cwd(
 
 describe("writer budget guidance", () => {
 	it("keeps hard turn and tool caps off mutation-capable workers", () => {
-		const readme = readProjectFile("README.md");
+		const toolReference = readProjectFile("docs/tool-reference.md");
 		const skill = readProjectFile("skills/pi-subagents/SKILL.md");
 		const reviewLoop = readProjectFile("prompts/review-loop.md");
 
-		for (const text of [readme, skill, reviewLoop]) {
+		for (const text of [toolReference, skill, reviewLoop]) {
 			assert.match(text, /As a conservative orchestration policy, do not (?:pass|set) `turnBudget`(?:, a hard `toolBudget`, or a tight `usageBudget`| or a hard `toolBudget`)/);
 			assert.match(text, /default tool budget blocks read\/search tools rather than mutation tools/i);
 			assert.match(text, /checkpoint after the current tool returns/);
@@ -19,12 +19,12 @@ describe("writer budget guidance", () => {
 			assert.match(text, /build\/test state/);
 			assert.match(text, /commit or PR state/);
 		}
-		assert.match(readme, /elapsed timeout is not a mutation-safe boundary/i);
+		assert.match(toolReference, /elapsed timeout is not a mutation-safe boundary/i);
 	});
 
 	it("documents deferred hard-limit termination at tool-using boundaries", () => {
-		const readme = readProjectFile("README.md");
-		assert.match(readme, /termination occurs at the next assistant boundary/);
-		assert.match(readme, /`termination-deferred`/);
+		const toolReference = readProjectFile("docs/tool-reference.md");
+		assert.match(toolReference, /termination occurs at the next assistant boundary/);
+		assert.match(toolReference, /`termination-deferred`/);
 	});
 });

package/dist/extensions/workflow/extension.ts

@@ -1,24 +1,26 @@
-// ponytail: single pi extension that mounts every workflow mode. One load
-// resolves a single writer tool + N start/end tool pairs. Avoids the per-mode
-// load conflict (multiple extension modules would each try to register the
-// shared writer).
+// ponytail: thin shell. Registers the four /workflow-* commands and launches
+// each mode's scripted workflow through pi-subagents' launchSlashSubagent.
 
 import type { ExtensionAPI } from "@selesai/code";
-import { __resetWorkflowRegistryForTests, createWorkflowExtension } from "./adapter.ts";
-import { prototypeMode } from "./modes/prototype.ts";
-import { quicktypeMode } from "./modes/quicktype.ts";
-import { taskMode } from "./modes/task.ts";
-import { loopMode } from "./modes/loop.ts";
-
-export { __resetWorkflowRegistryForTests };
-
-const MODES = [prototypeMode, quicktypeMode, taskMode, loopMode] as const;
+import { launchSlashSubagent } from "../pi-subagents/src/slash/slash-commands.ts";
+import { buildLoopScript, buildPrototypeScript, buildQuicktypeScript, buildTaskScript } from "./modes.ts";
 
 export default function workflowModesExtension(pi: ExtensionAPI): void {
-  for (const mode of MODES) {
-    createWorkflowExtension(mode.config, {
-      commandName: mode.commandName,
-      commandDescription: mode.commandDescription,
-    })(pi);
-  }
+  const register = (name: string, description: string, build: (goal: string) => string) =>
+    pi.registerCommand(name, {
+      description,
+      handler: async (args, ctx) => {
+        const goal = args.trim();
+        if (!goal) {
+          ctx.ui.notify(`${description}\nUsage: /${name} <goal>`, "info");
+          return;
+        }
+        launchSlashSubagent(pi, ctx, { workflowScript: build(goal), async: true, agentScope: "both" });
+      },
+    });
+
+  register("workflow-task", "Run the task workflow (plan → reuse → handoff → auto build↔review loop) as a scripted workflow.", buildTaskScript);
+  register("workflow-prototype", "Run the full prototype workflow (research → plan → reuse → handoff → auto loop → audit) as a scripted workflow.", buildPrototypeScript);
+  register("workflow-quicktype", "Run the quicker prototype workflow without research (plan → reuse → handoff → auto loop → audit) as a scripted workflow.", buildQuicktypeScript);
+  register("workflow-loop", "Run a direct auto build↔review loop for an already-agreed plan as a scripted workflow.", buildLoopScript);
 }

package/dist/extensions/workflow/modes.ts

@@ -0,0 +1,65 @@
+// ponytail: four workflow modes as pi-subagents workflowScript builders.
+// One-shot-and-sleep: phases run as runs.run steps and the loop auto-repeats
+// until the reviewer reports clean. A workflowScript has no checkpoints, so
+// there are no human gates.
+
+function js(value: string): string {
+  return JSON.stringify(value);
+}
+
+const AUTO_LOOP = String.raw`
+const autoLoop = async (goal, context) => {
+  let round = 1;
+  while (true) {
+    const build = await runs.run('build-' + round, {
+      agent: 'builder',
+      task: 'Implement the approved work in the workspace and run relevant checks.\n\nSource of truth (handoff/plan):\n' + context + '\n\nGoal:\n' + goal + (round > 1 ? '\n\nAddress the previous review feedback first.' : ''),
+    });
+    const review = await runs.run('review-' + round, {
+      agent: 'commentator',
+      task: 'Independently review the uncommitted diff and report concrete evidence (what you inspected and what you ran). Do not modify the workspace.\n\nAcceptance criteria (source of truth):\n' + context + '\n\nBuilder completion summary:\n' + build.output + '\n\nEnd with exactly one line: WORKFLOW_REVIEW_STATUS: clean OR WORKFLOW_REVIEW_STATUS: blocking.',
+    });
+    if (/WORKFLOW_REVIEW_STATUS\s*:\s*clean/i.test(review.output)) {
+      return { result: 'clean', rounds: round };
+    }
+    round += 1;
+  }
+};`;
+
+export function buildLoopScript(goal: string): string {
+  return String.raw`const goal = ${js(goal)};
+${AUTO_LOOP}
+return await autoLoop(goal, goal);`;
+}
+
+export function buildTaskScript(goal: string): string {
+  return String.raw`const goal = ${js(goal)};
+const plan = await runs.run('plan', { agent: 'architect', task: 'Produce a concrete implementation plan for: ' + goal + '. Cover what to build, how, in what order, which files and components, and the finished result. Return inline.' });
+const reuse = await runs.run('reuse', { agent: 'explorer', task: 'Explore the codebase for reusable patterns relevant to: ' + plan.output + '. Point at relevant areas and dependencies; skip cleanly if wholly new. Return inline.' });
+const handoff = await runs.run('handoff', { agent: 'recapper', task: 'Compile a self-contained handoff from the plan and reuse findings so fresh agents understand the goal, constraints, and acceptance criteria without re-planning.\n\nPlan:\n' + plan.output + '\n\nReuse findings:\n' + reuse.output + '\n\nReturn inline.' });
+${AUTO_LOOP}
+return await autoLoop(goal, handoff.output);`;
+}
+
+export function buildPrototypeScript(goal: string): string {
+  return String.raw`const goal = ${js(goal)};
+const research = await runs.run('research', { agent: 'researcher', task: 'Research the external, fast-changing knowledge this task depends on (libraries, SDKs, APIs, unfamiliar alternatives). Task: ' + goal + '. Synthesize actionable findings with sources. Return inline.' });
+const plan = await runs.run('plan', { agent: 'architect', task: 'Produce a concrete build plan from the research findings.\n\nResearch:\n' + research.output + '\n\nRequest:\n' + goal + '\n\nReturn inline.' });
+const reuse = await runs.run('reuse', { agent: 'explorer', task: 'Explore the codebase for reusable patterns relevant to: ' + plan.output + '. Return inline.' });
+const handoff = await runs.run('handoff', { agent: 'recapper', task: 'Compile a self-contained handoff from the plan and reuse findings.\n\nPlan:\n' + plan.output + '\n\nReuse:\n' + reuse.output + '\n\nReturn inline.' });
+${AUTO_LOOP}
+const loop = await autoLoop(goal, handoff.output);
+const audit = await runs.run('audit', { agent: 'commentator', task: 'Final audit of the uncommitted changes for correctness, plan adherence, and over-engineering (cut bloat, dead flexibility, reinvented stdlib). Plan:\n' + plan.output + '\n\nReport concrete evidence. Do not modify the workspace.' });
+return { ...loop, audited: true };`;
+}
+
+export function buildQuicktypeScript(goal: string): string {
+  return String.raw`const goal = ${js(goal)};
+const plan = await runs.run('plan', { agent: 'architect', task: 'Produce a concrete build plan for: ' + goal + '. Cover what to build, how, in what order, which components, and the finished result. Return inline.' });
+const reuse = await runs.run('reuse', { agent: 'explorer', task: 'Explore the codebase for reusable patterns relevant to: ' + plan.output + '. Return inline.' });
+const handoff = await runs.run('handoff', { agent: 'recapper', task: 'Compile a self-contained handoff from the plan and reuse findings.\n\nPlan:\n' + plan.output + '\n\nReuse:\n' + reuse.output + '\n\nReturn inline.' });
+${AUTO_LOOP}
+const loop = await autoLoop(goal, handoff.output);
+const audit = await runs.run('audit', { agent: 'commentator', task: 'Final audit of the uncommitted changes for correctness, plan adherence, and over-engineering (cut bloat, dead flexibility, reinvented stdlib). Plan:\n' + plan.output + '\n\nReport concrete evidence. Do not modify the workspace.' });
+return { ...loop, audited: true };`;
+}

package/dist/index.d.ts

@@ -18,7 +18,7 @@ export type { ResourceCollision, ResourceDiagnostic, ResourceLoader } from "./co
 export { DefaultResourceLoader, loadProjectContextFiles } from "./core/resource-loader.ts";
 export { AgentSessionRuntime, type AgentSessionRuntimeDiagnostic, type AgentSessionServices, type CreateAgentSessionFromServicesOptions, type CreateAgentSessionOptions, type CreateAgentSessionResult, type CreateAgentSessionRuntimeFactory, type CreateAgentSessionRuntimeResult, type CreateAgentSessionServicesOptions, createAgentSession, createAgentSessionFromServices, createAgentSessionRuntime, createAgentSessionServices, createBashTool, createCodingTools, createEditTool, createFindTool, createGrepTool, createLsTool, createReadOnlyTools, createReadTool, createWriteTool, type PromptTemplate, } from "./core/sdk.ts";
 export { type BranchSummaryEntry, buildContextEntries, buildSessionContext, type CompactionEntry, CURRENT_SESSION_VERSION, type CustomEntry, type CustomMessageEntry, type FileEntry, getLatestCompactionEntry, type ModelChangeEntry, migrateSessionEntries, type NewSessionOptions, parseSessionEntries, type SessionContext, type SessionEntry, type SessionEntryBase, type SessionHeader, type SessionInfo, type SessionInfoEntry, SessionManager, type SessionMessageEntry, type SessionTreeNode, sessionEntryToContextMessages, type ThinkingLevelChangeEntry, } from "./core/session-manager.ts";
-export { type AutoHandoffSettings, type CompactionSettings, type DefaultProjectTrust, type ImageSettings, type PackageSource, type RetrySettings, SettingsManager, type SettingsManagerCreateOptions, } from "./core/settings-manager.ts";
+export { type AutoHandoffSettings, type CompactionSettings, type DefaultProjectTrust, type ImageSettings, type PackageSource, type RetrySettings, SettingsManager, type SettingsManagerCreateOptions, type TuiMode, } from "./core/settings-manager.ts";
 export { formatSkillsForPrompt, type LoadSkillsFromDirOptions, type LoadSkillsResult, loadSkills, loadSkillsFromDir, type Skill, type SkillFrontmatter, } from "./core/skills.ts";
 export { createSyntheticSourceInfo } from "./core/source-info.ts";
 export { type EditDiffResult, generateDiffString, generateUnifiedPatch } from "./core/tools/edit-diff.ts";

package/dist/main.js

@@ -722,6 +722,7 @@ export async function main(args, options) {
             initialImages,
             initialMessages: parsed.messages,
             verbose: parsed.verbose,
+            tuiMode: parsed.tuiMode,
         });
         if (startupBenchmark) {
             await interactiveMode.init();

package/dist/modes/interactive/components/settings-selector.d.ts

@@ -1,7 +1,7 @@
 import type { ThinkingLevel } from "@earendil-works/pi-agent-core";
 import type { Transport } from "@earendil-works/pi-ai";
-import { Container, SettingsList } from "@earendil-works/pi-tui";
-import type { DefaultProjectTrust, WarningSettings } from "../../../core/settings-manager.ts";
+import { Container, type ScrollViewScrollbar, SettingsList } from "@earendil-works/pi-tui";
+import type { DefaultProjectTrust, TuiMode, WarningSettings } from "../../../core/settings-manager.ts";
 import { type TerminalTheme } from "../theme/theme.ts";
 export interface SettingsConfig {
     autoCompact: boolean;
@@ -34,6 +34,8 @@ export interface SettingsConfig {
     defaultProjectTrust: DefaultProjectTrust;
     clearOnShrink: boolean;
     showTerminalProgress: boolean;
+    tuiMode: TuiMode;
+    fullscreenScrollbar: ScrollViewScrollbar;
     warnings: WarningSettings;
 }
 export interface SettingsCallbacks {
@@ -65,6 +67,8 @@ export interface SettingsCallbacks {
     onDefaultProjectTrustChange: (defaultProjectTrust: DefaultProjectTrust) => void;
     onClearOnShrinkChange: (enabled: boolean) => void;
     onShowTerminalProgressChange: (enabled: boolean) => void;
+    onTuiModeChange: (mode: TuiMode) => void;
+    onFullscreenScrollbarChange: (mode: ScrollViewScrollbar) => void;
     onWarningsChange: (warnings: WarningSettings) => void;
     onCancel: () => void;
 }

package/dist/modes/interactive/components/settings-selector.js

@@ -402,6 +402,20 @@ export class SettingsSelectorComponent extends Container {
                     done(value);
                 }, () => done()),
             },
+            {
+                id: "tui-mode",
+                label: "TUI mode",
+                description: "Switches immediately; fullscreen is the Selesai default",
+                currentValue: config.tuiMode,
+                values: ["fullscreen", "regular"],
+            },
+            {
+                id: "fullscreen-scrollbar",
+                label: "Fullscreen scrollbar",
+                description: "Scrollbar behavior in fullscreen mode; has no effect in regular mode",
+                currentValue: config.fullscreenScrollbar,
+                values: ["auto", "always", "hidden"],
+            },
             {
                 id: "theme",
                 label: "Theme",
@@ -586,6 +600,12 @@ export class SettingsSelectorComponent extends Container {
                 case "terminal-progress":
                     callbacks.onShowTerminalProgressChange(newValue === "true");
                     break;
+                case "tui-mode":
+                    callbacks.onTuiModeChange(newValue);
+                    break;
+                case "fullscreen-scrollbar":
+                    callbacks.onFullscreenScrollbarChange(newValue);
+                    break;
                 case "theme":
                     callbacks.onThemeChange(newValue);
                     break;

package/dist/modes/interactive/interactive-mode.d.ts

@@ -3,8 +3,11 @@
  * Handles TUI rendering and user interaction, delegating business logic to AgentSession.
  */
 import type { ImageContent } from "@earendil-works/pi-ai/compat";
+import type { Terminal } from "@earendil-works/pi-tui";
+import { type TUI, TuiAltScreen, TuiMainScreen } from "@earendil-works/pi-tui";
 import { type AgentSessionRuntime } from "../../core/agent-session-runtime.ts";
 import { SessionManager } from "../../core/session-manager.ts";
+import type { TuiMode } from "../../core/settings-manager.ts";
 import { type LatestPiRelease } from "../../utils/version-check.ts";
 type PendingUserInput = {
     text: string;
@@ -29,14 +32,32 @@ export interface InteractiveModeOptions {
     initialMessages?: string[];
     /** Force verbose startup (overrides quietStartup setting) */
     verbose?: boolean;
+    /** TUI layout mode. */
+    tuiMode?: TuiMode;
 }
+interface InteractiveTuiOptions {
+    tuiMode: TuiMode;
+    showHardwareCursor: boolean;
+    logDirectory: string;
+    terminal?: Terminal;
+    onRightClickPaste?: () => void;
+}
+/** Composition root for selecting the interactive terminal renderer. */
+export declare function createInteractiveTui(options: InteractiveTuiOptions): TuiMainScreen | TuiAltScreen;
+/** Stable reference for components while InteractiveMode replaces the active renderer. */
+export declare function createInteractiveTuiReference(getTui: () => TUI): TUI;
 export declare class InteractiveMode {
     private runtimeHost;
+    private renderer;
     private ui;
+    private mainScreenRenderState;
+    private documentContainer;
     private loadedResourcesContainer;
     private chatContainer;
     private pendingMessagesContainer;
     private statusContainer;
+    private transcriptScrollView;
+    private fullscreenLayoutRoot;
     private defaultEditor;
     private editor;
     private editorComponentFactory;
@@ -45,6 +66,7 @@ export declare class InteractiveMode {
     private fdPath;
     private editorContainer;
     private footer;
+    private footerContainer;
     private footerDataProvider;
     private keybindings;
     private version;
@@ -95,6 +117,7 @@ export declare class InteractiveMode {
     private builtInHeader;
     private customHeader;
     private options;
+    private readonly onRightClickPaste;
     private autoTrustOnReloadCwd;
     private themeController;
     private get session();
@@ -108,6 +131,9 @@ export declare class InteractiveMode {
     private createBaseAutocompleteProvider;
     private setupAutocompleteProvider;
     private showStartupNoticesIfNeeded;
+    private mountInteractiveTui;
+    private stopInteractiveTui;
+    private switchTuiMode;
     init(): Promise<void>;
     /**
      * Update terminal title with session name and cwd.
@@ -193,6 +219,7 @@ export declare class InteractiveMode {
      */
     private setExtensionHeader;
     private addExtensionTerminalInputListener;
+    private rebindExtensionTerminalInputListeners;
     private clearExtensionTerminalInputListeners;
     /**
      * Create the ExtensionUIContext for extensions.
@@ -240,6 +267,7 @@ export declare class InteractiveMode {
      */
     private showExtensionError;
     private setupKeyHandlers;
+    private handleRightClickPaste;
     private handleClipboardPaste;
     private consumePendingInputImages;
     private handleGitCommand;