@xingular/harness 1.2.0 → 1.3.1-unstable.1

package/dist/sdk/terminal/tui/commands.js

@@ -183,7 +183,7 @@ export function createTerminalCommands(host) {
         const coreNames = coreCommandNames(session);
         const aliases = new Set(LEGACY_BUILTIN_COMMAND_ALIASES.keys());
         for (const command of pluginCommands) {
-            if (coreNames.has(command.name))
+            if (command.rootOnly || coreNames.has(command.name))
                 continue;
             aliases.add(`plugin:${command.name}`);
             if (command.legacyBare)
@@ -200,11 +200,13 @@ export function createTerminalCommands(host) {
         const prompts = session.resourceLoader.getPrompts().prompts;
         const commands = new Map(BUILTINS.map(command => [command.name, command]));
         for (const command of pluginCommands) {
+            if (command.rootOnly)
+                continue;
             const invocation = `${command.prefix}:${command.name}`;
             commands.set(invocation, { name: invocation, description: command.description, group: 'Plugins' });
         }
         for (const module of BUILTIN_PLUGIN_REGISTRY.modules) {
-            const defaultCommand = module.defaultCommand && BUILTIN_PLUGIN_REGISTRY.command(module.commandPrefix ?? module.descriptor.id, module.defaultCommand);
+            const defaultCommand = module.defaultCommand && BUILTIN_PLUGIN_REGISTRY.defaultCommand(module.commandPrefix ?? module.descriptor.id);
             if (defaultCommand) {
                 const invocation = `${defaultCommand.prefix}:`;
                 commands.set(invocation, { name: invocation, description: defaultCommand.description, group: 'Plugins' });
@@ -399,6 +401,14 @@ export function createTerminalCommands(host) {
                 case 'trajectory':
                     await openPage('trajectory', { runId: argument });
                     break;
+                case 'todo': {
+                    const items = await host.todo();
+                    if (!items.length)
+                        notify('No todo list in this reply yet. The agent writes one with todo_write for multi-step work.');
+                    else
+                        host.showTodo(items);
+                    break;
+                }
                 case 'subagents':
                     await openPage('subagents');
                     break;

package/dist/sdk/terminal/tui/dialogs.js

@@ -343,6 +343,7 @@ export class TerminalDialogs {
                     : { ...defaults, ...source };
                 handle = this.tui.showOverlay(component, overlayOptions);
                 options?.onHandle?.(handle);
+                component.mounted?.();
                 this.changed();
             }).catch(error => {
                 if (!settled) {

package/dist/sdk/terminal/tui/pageOverlay.d.ts

@@ -15,7 +15,10 @@ export declare class PageOverlay implements Component, Focusable {
     private disposed;
     private pointerLayout?;
     private hoveredTab?;
+    private activated;
     constructor(options: PageOverlayOptions);
+    /** The host shows this overlay now: the page starts. */
+    mounted(): void;
     get page(): TerminalPage;
     get focused(): boolean;
     set focused(value: boolean);

package/dist/sdk/terminal/tui/pageOverlay.js

@@ -7,9 +7,20 @@ export class PageOverlay {
     disposed = false;
     pointerLayout;
     hoveredTab;
+    activated = false;
     constructor(options) {
         this.options = options;
-        options.page.activate?.();
+        // A page may open a dialog as it starts. It starts once its own overlay is showing, so the dialog
+        // lands above it; a host that never reports mounting still starts it on the next turn.
+        const fallback = setTimeout(() => this.mounted(), 0);
+        fallback.unref?.();
+    }
+    /** The host shows this overlay now: the page starts. */
+    mounted() {
+        if (this.activated || this.disposed)
+            return;
+        this.activated = true;
+        this.options.page.activate?.();
     }
     get page() { return this.options.page; }
     get focused() { return this.focusedValue; }
@@ -132,20 +143,27 @@ export class PageOverlay {
             contentWidth: contentWidth(width),
             centered
         };
-        const escapeHint = page.ownsNavigation ? 'Esc back/close' : 'Esc close';
-        const fullFooter = page.ownsNavigation ? `${escapeHint} · ${page.hint()}` : [
-            page.hint(),
+        const pageHint = page.hint();
+        const returnsToPage = pageHint.split(' · ').includes('Esc back');
+        const escapeHint = page.ownsNavigation ? 'Esc back/close' : returnsToPage ? 'Esc back' : 'Esc close';
+        const fullFooter = page.ownsNavigation ? `${escapeHint} · ${pageHint}` : [
+            pageHint,
             tabs.length > 1 ? 'Tab/Shift+Tab sections' : '',
-            escapeHint
+            returnsToPage ? '' : escapeHint
         ].filter(Boolean).join(' · ');
         const footerWidth = Math.max(0, width - CHROME_PAD * 2);
-        const primaryHint = page.hint().split(' · ')[0] ?? '';
+        const primaryHint = pageHint.split(' · ')[0] ?? '';
         const compactFooter = [
             primaryHint,
             !page.ownsNavigation && tabs.length > 1 ? 'Tab/⇧Tab' : '',
             escapeHint
         ].filter(Boolean).join(' · ');
-        const footer = visibleWidth(fullFooter) <= footerWidth ? fullFooter : compactFooter;
+        const navigationFooter = [!page.ownsNavigation && tabs.length > 1 ? 'Tab/⇧Tab' : '', escapeHint].filter(Boolean).join(' · ');
+        const footer = visibleWidth(fullFooter) <= footerWidth
+            ? fullFooter
+            : visibleWidth(compactFooter) <= footerWidth
+                ? compactFooter
+                : visibleWidth(navigationFooter) <= footerWidth ? navigationFooter : escapeHint;
         return pageFrame({
             title: '',
             headerLine: tabStrip(tabs, page.activeTab(), inner, theme, 'top', this.hoveredTab),

package/dist/sdk/terminal/tui/pages/agentsPage.js

@@ -12,7 +12,7 @@ export const AGENT_SCOPES = {
     global: 'Global: every folder'
 };
 const TABS = [{ id: 'agents', title: 'Agents' }];
-const GROUP = { builtin: 'Built-in', global: 'Global', project: 'Project', variant: 'From the variant' };
+const GROUP = { builtin: 'Built-in', global: 'Global', project: 'Project', variant: 'From the variant', plugin: 'From a plugin' };
 function clean(value) {
     return stripTerminalSequences(value).replace(/[\x00-\x08\x0b-\x1f\x7f]/g, ' ').replace(/[ \t]+/g, ' ').trim();
 }
@@ -57,7 +57,7 @@ export class AgentsPage {
         if (!overview)
             return [];
         const rows = [{ id: 'new', label: 'New profile', group: 'Actions', detail: 'from a template, then opens in your editor', tone: 'accent', data: { kind: 'new' } }];
-        for (const source of ['builtin', 'global', 'project', 'variant']) {
+        for (const source of ['builtin', 'global', 'project', 'variant', 'plugin']) {
             for (const profile of overview.profiles.filter(entry => entry.source === source)) {
                 rows.push({
                     id: `profile:${profile.name}`, label: profile.name, group: GROUP[source], detail: clean(profile.description), tone: 'muted',
@@ -123,6 +123,9 @@ export class AgentsPage {
         }
         const { profile } = row;
         const own = profile.source === 'global' || profile.source === 'project' ? profile.source : null;
+        // A package's profile comes with the package: it is switched on and off on the plugins page.
+        if (profile.source === 'plugin')
+            return;
         const choice = await this.options.ui.select(`${profile.name} · ${GROUP[profile.source]}`, [...(own ? [AGENT_ACTIONS.edit] : []), AGENT_ACTIONS.copy, ...(own ? [AGENT_ACTIONS.remove] : [])]);
         if (choice === AGENT_ACTIONS.edit && profile.path)
             return this.attempt(() => this.open(profile.path));

package/dist/sdk/terminal/tui/pages/annotatePage.d.ts

@@ -1,9 +1,10 @@
 /**
- * The annotate pane (`/annotate:` and `/annotate:annotate`, PROP-0018): the person works in a browser window or an app's own
- * windows, and this page is the panel beside it. With the inspector on, hovering outlines a
- * component and a click opens a comment popover with three choices: keep it as a note, add it to
- * this session's queue, or send it to the agent now. The page lists the queue, what was sent and
- * what the agent says it fixed, and the notes kept on the side.
+ * The annotate page (`/annotate:` and `/annotate:notes`, PROP-0018, PROP-0048): one full page with
+ * two tabs. **Annotate** is the panel beside the window being inspected: the target and its address
+ * or app are chosen in the page itself, the inspector outlines a component, and a click opens a
+ * popover with two buttons, Annotate and Annotate & send. Every annotation is shared with this
+ * session at once; `s` sends all the unsent ones. **All annotations** is the searchable list of every
+ * saved annotation.
  */
 import type { Theme } from '@earendil-works/pi-coding-agent';
 import type { MenuCall, MenuUi } from "../../pluginMenu.js";
@@ -22,7 +23,12 @@ export type AnnotateStart = {
 } | {
     kind: 'bridge';
     name?: string;
+}
+/** Opens on the list of apps with a DevTools port. */
+ | {
+    kind: 'apps';
 };
+export type AnnotateTab = 'annotate' | 'all';
 export interface AnnotatePageOptions {
     theme(): Theme;
     call: MenuCall;
@@ -31,61 +37,109 @@ export interface AnnotatePageOptions {
     };
     changed(): void;
     start: AnnotateStart;
+    initialTab?: AnnotateTab;
     /** How often the inspector is asked for the person's next comment, in milliseconds. */
     pollMs?: number;
 }
-type Row = {
+interface DevToolsApp {
+    endpoint: string;
+    port: number;
+    name: string;
+    browser: string;
+    electron: boolean;
+    windows: number;
+}
+type NoteRow = {
     kind: 'note';
     note: Note;
 };
+type AppRow = {
+    kind: 'app';
+    app: DevToolsApp;
+} | {
+    kind: 'port';
+} | {
+    kind: 'launch';
+} | {
+    kind: 'bridge';
+} | {
+    kind: 'web';
+};
 export declare const ANNOTATE_ACTIONS: {
     readonly reveal: "Show it in the window";
-    readonly send: "Send to the agent now";
-    readonly confirm: "Confirm sending it (it came from the page)";
-    readonly queue: "Ask the agent to fix it (add to queue)";
-    readonly dequeue: "Take it out of the queue";
+    readonly send: "Send it now";
+    readonly confirm: "Confirm and send it (it came from the page)";
     readonly edit: "Edit the comment";
     readonly resolve: "Resolve";
+    readonly reopen: "Reopen";
+    readonly share: "Share it with this session";
+    readonly unshare: "Stop sharing it with this session";
     readonly delete: "Delete";
 };
 export declare function describeTarget(target: NoteTarget): string;
-/** Which section of the panel a note belongs in, for this session; null when it is not shown. */
-export declare function section(note: Note, sessionId: string | null): 'Queue' | 'Sent and fixed' | 'Saved' | null;
+/** Which group of the Annotate tab a note belongs in, for this session; null when it is not shown there. */
+export declare function section(note: Note, sessionId: string | null): 'Unsent' | 'Sent' | null;
 export declare class AnnotatePage implements TerminalPage {
     private readonly options;
     presentation: "fullscreen";
+    private tab;
+    private view;
+    private field;
     private notes;
     private sessionId;
     private target;
+    private apps;
     private bridgeSnippet;
     private error;
     private busy;
     private disposed;
     private polling;
+    private focusedValue;
     private timer;
     private refreshes;
-    private readonly list;
+    private listTop;
+    private readonly noteList;
+    private readonly appList;
+    private readonly allList;
     constructor(options: AnnotatePageOptions);
     get focused(): boolean;
     set focused(value: boolean);
+    private syncFocus;
     tabs(): readonly TabInfo[];
     activeTab(): string;
+    selectTab(id: string): void;
     hint(): string;
     activate(): void;
     dispose(): void;
     private start;
+    /** Shows the target that is still open, with the inspector on again; false when no window is open. */
+    private restore;
     private refreshTarget;
+    private openPage;
+    private attachApp;
+    private attachBridge;
+    private openField;
+    private closeField;
+    private submitField;
+    private showApps;
+    appRows(): ListRow<AppRow>[];
+    private chooseApp;
     reload(): Promise<void>;
-    rows(): ListRow<Row>[];
-    private queued;
+    /** The Annotate tab: this session's unsent and sent annotations. */
+    rows(): ListRow<NoteRow>[];
+    private shared;
+    /** The All annotations tab: every saved annotation. */
+    allRows(): ListRow<NoteRow>[];
     /** Polls the inspector for the person's next comment, and the notes every few seconds. */
     private schedule;
     private tick;
     private toggleInspect;
+    /** Runs one action at a time; a key pressed meanwhile is answered, never dropped silently. */
     private attempt;
-    sendQueue(): Promise<void>;
+    sendAll(): Promise<void>;
     private chooseWindow;
     private noteMenu;
+    private currentList;
     handleMouse(event: TerminalMouseInput): import("@earendil-works/pi-tui").TuiMouseEventResult | undefined;
     handleInput(data: string): boolean;
     private header;