@gaia-ai/addon-gaia-ui 0.9.2 → 0.10.0

package/dist/src/Entity/ticket/Data/detail.d.ts

@@ -24,5 +24,19 @@ import type { DropshClient, TicketDetailDocument } from '../../../types.js';
  * this include list must stay a superset of the list read's — dropping either
  * `parent_id` or `labels` degrades a rendered row to a raw uuid without failing a
  * fixture-driven test.
+ *
+ * GAIA-369 D5 added `blocked_by` for the Related tab's Blocked by rows, and the
+ * measurement is the reason it can be identities at all: live against the develop
+ * control plane under `session`, the `blocked_by` LINKAGE data is in the document
+ * with no include at all (`{"data": []}` on GAIA-369), and `include=blocked_by`
+ * sideloads `gaia_ticket--gaia_ticket` resources carrying `identifier` (measured
+ * on GAIA-23, GAIA-90 and GAIA-92 → GAIA-19, GAIA-97, GAIA-90). So the section
+ * renders rows without a second request and without a second read profile.
+ *
+ * That split is also the failure mode to keep in mind: because the linkage
+ * arrives regardless, dropping this include does NOT empty the section — it
+ * degrades every row to a raw uuid, silently. Hence the include set is pinned as
+ * a string in `tests/Entity/ticket/Data/detail.test.ts` rather than inferred from
+ * a rendered section, and this list must stay a superset of the list read's.
  */
 export declare function loadTicketDetail(client: DropshClient, ticketId: string): Promise<TicketDetailDocument>;

package/dist/src/Entity/ticket/Data/detail.js

@@ -23,7 +23,21 @@
  * this include list must stay a superset of the list read's — dropping either
  * `parent_id` or `labels` degrades a rendered row to a raw uuid without failing a
  * fixture-driven test.
+ *
+ * GAIA-369 D5 added `blocked_by` for the Related tab's Blocked by rows, and the
+ * measurement is the reason it can be identities at all: live against the develop
+ * control plane under `session`, the `blocked_by` LINKAGE data is in the document
+ * with no include at all (`{"data": []}` on GAIA-369), and `include=blocked_by`
+ * sideloads `gaia_ticket--gaia_ticket` resources carrying `identifier` (measured
+ * on GAIA-23, GAIA-90 and GAIA-92 → GAIA-19, GAIA-97, GAIA-90). So the section
+ * renders rows without a second request and without a second read profile.
+ *
+ * That split is also the failure mode to keep in mind: because the linkage
+ * arrives regardless, dropping this include does NOT empty the section — it
+ * degrades every row to a raw uuid, silently. Hence the include set is pinned as
+ * a string in `tests/Entity/ticket/Data/detail.test.ts` rather than inferred from
+ * a rendered section, and this list must stay a superset of the list read's.
  */
 export function loadTicketDetail(client, ticketId) {
-    return client.get(`gaia_ticket/gaia_ticket/${ticketId}?include=comments,sub_tickets,runs,referenced_tickets,conductor_id,assignee_user_id,parent_id,labels`);
+    return client.get(`gaia_ticket/gaia_ticket/${ticketId}?include=comments,sub_tickets,runs,referenced_tickets,conductor_id,assignee_user_id,parent_id,labels,blocked_by`);
 }

package/dist/src/Entity/ticket/Data/query.d.ts

@@ -55,3 +55,10 @@ export interface TicketQueryOptions {
     includes?: boolean;
 }
 export declare function buildTicketQueryParams(projectId: string, criteria: TicketCriteria, options?: TicketQueryOptions): DrupalJsonApiParams;
+/**
+ * Build the JSON:API query for one assignee's tickets (GAIA-377 D2).
+ *
+ * Same paging, fieldset and closed-filter cycle as the project builder; the
+ * scope is `assignee_user_id.id` instead of `project_id.id`.
+ */
+export declare function buildUserTicketQueryParams(userId: string, criteria: TicketCriteria, options?: TicketQueryOptions): DrupalJsonApiParams;

package/dist/src/Entity/ticket/Data/query.js

@@ -61,6 +61,22 @@ export function describeCriteria(criteria) {
 export function buildTicketQueryParams(projectId, criteria, options = {}) {
     const params = new DrupalJsonApiParams();
     params.addFilter('project_id.id', projectId);
+    applyTicketCriteria(params, criteria, options);
+    return params;
+}
+/**
+ * Build the JSON:API query for one assignee's tickets (GAIA-377 D2).
+ *
+ * Same paging, fieldset and closed-filter cycle as the project builder; the
+ * scope is `assignee_user_id.id` instead of `project_id.id`.
+ */
+export function buildUserTicketQueryParams(userId, criteria, options = {}) {
+    const params = new DrupalJsonApiParams();
+    params.addFilter('assignee_user_id.id', userId);
+    applyTicketCriteria(params, criteria, options);
+    return params;
+}
+function applyTicketCriteria(params, criteria, options) {
     if (criteria.query) {
         params.addGroup('search', 'OR');
         params.addFilter('identifier', criteria.query, 'CONTAINS', 'search');
@@ -77,7 +93,8 @@ export function buildTicketQueryParams(projectId, criteria, options = {}) {
     if (criteria.parent)
         params.addFilter('parent_id.id', criteria.parent.id);
     // Assigned to this user only; a top-level AND like parent, never part of
-    // the search OR group (GAIA-299 AC-4).
+    // the search OR group (GAIA-299 AC-4). Skipped when the builder itself is
+    // already scoped to an assignee (user ticket list).
     if (criteria.who)
         params.addFilter('assignee_user_id.id', criteria.who.id);
     const { size, index } = options.page ?? { size: PAGE_SIZE, index: 0 };
@@ -96,5 +113,4 @@ export function buildTicketQueryParams(projectId, criteria, options = {}) {
     // Page one carries no offset, so its query is the shortest it can be.
     if (index > 0)
         params.addPageOffset(index * size);
-    return params;
 }

package/dist/src/Entity/ticket/Data/tickets.d.ts

@@ -204,8 +204,32 @@ export declare function mapTicketDocument(document: {
  *  {@link Page}, whose four members and their meaning are documented there
  *  (GAIA-294). */
 export type TicketPage = Page<TicketRow>;
+/**
+ * How many tickets the criteria match once the `closed` criterion is DROPPED —
+ * GAIA-370.
+ *
+ * The size of the COLLECTION, never of a page: it is the server's own
+ * `meta.count` (GAIA-305), read off a one-row response, so an answer of 285 costs
+ * the same single read as an answer of 1 and cannot be a recount of whatever the
+ * screen happens to be holding. `null` when the server reports no count, which
+ * `readTotal` already treats as the explicit unknown rather than as a zero.
+ *
+ * It builds the SAME query as {@link loadFilteredTickets} — the same OR group over
+ * identifier/title, the same project/state/parent/who ANDs — with exactly one
+ * criterion removed. That is what makes the number it returns an answer to "how
+ * many is `closed` holding back" and not to some other question; a second,
+ * hand-written query here could drift from the one the rows came from, and then
+ * the count beside `No tickets.` would describe a different collection than the
+ * emptiness it explains.
+ *
+ * `includes: false` and `page[limit]=1`: no row is mapped, so no sideload is worth
+ * requesting.
+ */
+export declare function countTicketsIgnoringClosed(client: DropshClient, projectId: string, criteria: TicketCriteria): Promise<number | null>;
 /** Server-side filtered/searched ticket list for a project — ONE page of it. The
  *  query sideloads `parent_id` + `conductor_id`; each row's parent/conductor is
  *  resolved from the document's `included` (AC-5). */
 export declare function loadFilteredTickets(client: DropshClient, projectId: string, criteria: TicketCriteria, page?: number): Promise<TicketPage>;
+/** One page of tickets assigned to a user (GAIA-377 D2). */
+export declare function loadUserTickets(client: DropshClient, userId: string, criteria: TicketCriteria, page?: number): Promise<TicketPage>;
 export {};

package/dist/src/Entity/ticket/Data/tickets.js

@@ -5,7 +5,7 @@
 import { asString } from '../../../lib/format.js';
 import { loadPage, } from '../../collection.js';
 import { LIST_PAGE_SIZE } from '../../cycle.js';
-import { buildTicketQueryParams } from './query.js';
+import { buildTicketQueryParams, buildUserTicketQueryParams, } from './query.js';
 /** Build the {@link IncludedIndex} from a document's `included` array. */
 function indexIncluded(included) {
     const index = new Map();
@@ -247,6 +247,32 @@ export function mapTicketData(item, included) {
 export function mapTicketDocument(document) {
     return mapTicketData(document.data ?? {}, indexIncluded(document.included));
 }
+/**
+ * How many tickets the criteria match once the `closed` criterion is DROPPED —
+ * GAIA-370.
+ *
+ * The size of the COLLECTION, never of a page: it is the server's own
+ * `meta.count` (GAIA-305), read off a one-row response, so an answer of 285 costs
+ * the same single read as an answer of 1 and cannot be a recount of whatever the
+ * screen happens to be holding. `null` when the server reports no count, which
+ * `readTotal` already treats as the explicit unknown rather than as a zero.
+ *
+ * It builds the SAME query as {@link loadFilteredTickets} — the same OR group over
+ * identifier/title, the same project/state/parent/who ANDs — with exactly one
+ * criterion removed. That is what makes the number it returns an answer to "how
+ * many is `closed` holding back" and not to some other question; a second,
+ * hand-written query here could drift from the one the rows came from, and then
+ * the count beside `No tickets.` would describe a different collection than the
+ * emptiness it explains.
+ *
+ * `includes: false` and `page[limit]=1`: no row is mapped, so no sideload is worth
+ * requesting.
+ */
+export async function countTicketsIgnoringClosed(client, projectId, criteria) {
+    const params = buildTicketQueryParams(projectId, { ...criteria, closed: null }, { page: { size: 1, index: 0 }, includes: false });
+    const page = await loadPage(client, 'gaia_ticket/gaia_ticket', params, () => [], 0, { offset: 0, limit: 1 });
+    return page.total;
+}
 /** Server-side filtered/searched ticket list for a project — ONE page of it. The
  *  query sideloads `parent_id` + `conductor_id`; each row's parent/conductor is
  *  resolved from the document's `included` (AC-5). */
@@ -266,3 +292,17 @@ export async function loadFilteredTickets(client, projectId, criteria, page = 0)
         return data.map((item) => mapTicketData(item, index));
     }, page, window);
 }
+/** One page of tickets assigned to a user (GAIA-377 D2). */
+export async function loadUserTickets(client, userId, criteria, page = 0) {
+    const window = {
+        offset: page * LIST_PAGE_SIZE,
+        limit: LIST_PAGE_SIZE,
+    };
+    const params = buildUserTicketQueryParams(userId, criteria, {
+        page: { size: window.limit, index: page },
+    });
+    return loadPage(client, 'gaia_ticket/gaia_ticket', params, (data, included) => {
+        const index = indexIncluded(included);
+        return data.map((item) => mapTicketData(item, index));
+    }, page, window);
+}

package/dist/src/Entity/ticket/Screen/create-ticket-form.d.ts

@@ -1,8 +1,9 @@
 import type { VNode } from '@opentui/core';
-import { AsyncScreen } from '../../../Screen/async-screen.js';
-import { type ScreenAction, type ScreenContext } from '../../../Screen/screen.js';
+import { AsyncModalScreen } from '../../../Screen/async-modal-screen.js';
+import type { ModalChrome } from '../../../Screen/modal-screen.js';
+import type { ScreenAction, ScreenContext } from '../../../Screen/screen.js';
 import { type CreateFormOptions } from '../Form/create.js';
-export declare class CreateTicketFormScreen extends AsyncScreen<CreateFormOptions> {
+export declare class CreateTicketFormScreen extends AsyncModalScreen<CreateFormOptions> {
     readonly modal = true;
     static readonly route: {
         id: string;
@@ -66,7 +67,12 @@ export declare class CreateTicketFormScreen extends AsyncScreen<CreateFormOption
     takeAction(): ScreenAction | undefined;
     handleInput(input: string, context: ScreenContext): boolean;
     reset(): void;
-    present(context: ScreenContext): import("../../../Screen/screen.js").ScreenPresentation;
+    protected modalChrome(context: ScreenContext): ModalChrome;
+    protected actions(): import("../../../Component/footer-actions/index.js").ActionItem[];
+    /** Two status rows so Ctrl+D is not clipped in the modal box (AC-1). */
+    protected modalStatusLines(): string[];
+    private fieldActions;
+    private submitActions;
     /**
      * Write the ticket straight to the control plane (GAIA-309).
      *

package/dist/src/Entity/ticket/Screen/create-ticket-form.js

@@ -2,10 +2,10 @@ import { writeFileSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { buildCreateLaunch, shortName } from '../../../Agent/launch.js';
+import { actionItem, formatActionLadder, } from '../../../Component/footer-actions/index.js';
 import { serverMessage } from '../../../lib/jsonapi-error.js';
 import { columnNode } from '../../../lib/vnode.js';
-import { AsyncScreen } from '../../../Screen/async-screen.js';
-import { presentation, } from '../../../Screen/screen.js';
+import { AsyncModalScreen } from '../../../Screen/async-modal-screen.js';
 import { createOptionLoader, } from '../../../Widget/option-source.js';
 import { CREATE_FORM_REGION, createFormTree, } from '../Component/create-form/index.js';
 import { buildTicketCreateBody, createTicket } from '../Data/write.js';
@@ -28,10 +28,7 @@ import { keyToIntent } from '../Form/keys.js';
 // is the only clue the label list is togglable — to buy room for the new keys.
 // The modal frame splits a body row on `\n` already (`tui-kernel.ts`), so a
 // second row costs no kernel change; R3 already accepts that the popup grew.
-const CHANGE_KEYS = ' ↑↓ field · ←→ change · Space toggle';
-const PICK_KEYS = ' ↑↓ field · ←→ suggestion · Enter pick';
-const SUBMIT_KEYS = ' Ctrl+S agent · Ctrl+D direct · Esc cancel ';
-export class CreateTicketFormScreen extends AsyncScreen {
+export class CreateTicketFormScreen extends AsyncModalScreen {
     modal = true;
     static route = {
         id: 'ticket.create',
@@ -238,21 +235,45 @@ export class CreateTicketFormScreen extends AsyncScreen {
         this.sources = {};
         super.reset();
     }
-    present(context) {
-        return presentation(this.surface(context), {
+    modalChrome(context) {
+        return {
             title: '⚡ New ticket',
             meta: context.project?.name ??
                 context.project?.slug ??
                 context.options?.project ??
                 '',
-            status: this.form && CREATE_FORM.activeField(this.form).kind === 'autocomplete'
-                ? `${PICK_KEYS}\n${SUBMIT_KEYS}`
-                : `${CHANGE_KEYS}\n${SUBMIT_KEYS}`,
-            // The popup's box supplies its own border and padding, so the body it
-            // holds must not also carry the body window's inset — see
-            // `presentation()`.
-            modal: true,
-        });
+        };
+    }
+    actions() {
+        return [...this.fieldActions(), ...this.submitActions()];
+    }
+    /** Two status rows so Ctrl+D is not clipped in the modal box (AC-1). */
+    modalStatusLines() {
+        return [
+            formatActionLadder(this.fieldActions()),
+            formatActionLadder(this.submitActions()),
+        ];
+    }
+    fieldActions() {
+        return this.form &&
+            CREATE_FORM.activeField(this.form).kind === 'autocomplete'
+            ? [
+                actionItem('create-field', '↑↓', 'field'),
+                actionItem('create-suggest', '←→', 'suggestion'),
+                actionItem('create-pick', 'Enter', 'pick'),
+            ]
+            : [
+                actionItem('create-field', '↑↓', 'field'),
+                actionItem('create-change', '←→', 'change'),
+                actionItem('create-toggle', 'Space', 'toggle'),
+            ];
+    }
+    submitActions() {
+        return [
+            actionItem('create-agent', 'Ctrl+S', 'agent'),
+            actionItem('create-direct', 'Ctrl+D', 'direct'),
+            actionItem('create-esc', 'Esc', 'cancel'),
+        ];
     }
     /**
      * Write the ticket straight to the control plane (GAIA-309).

package/dist/src/Entity/ticket/Screen/edit-assignment-form.d.ts

@@ -1,6 +1,7 @@
 import type { VNode } from '@opentui/core';
-import { AsyncScreen } from '../../../Screen/async-screen.js';
-import { type ScreenAction, type ScreenContext } from '../../../Screen/screen.js';
+import { AsyncModalScreen } from '../../../Screen/async-modal-screen.js';
+import type { ModalChrome } from '../../../Screen/modal-screen.js';
+import type { ScreenAction, ScreenContext } from '../../../Screen/screen.js';
 import type { TicketDetailDocument } from '../../../types.js';
 import { type EditFormOptions } from '../Form/edit.js';
 interface EditAssignmentData {
@@ -11,7 +12,7 @@ interface EditAssignmentInput {
     readonly document: TicketDetailDocument;
 }
 export declare const editAssignmentInputContext: import("../../../Routing/context.js").ContextKey<EditAssignmentInput>;
-export declare class EditAssignmentFormScreen extends AsyncScreen<EditAssignmentData> {
+export declare class EditAssignmentFormScreen extends AsyncModalScreen<EditAssignmentData> {
     static result(ticketId: string, assigneeId: string): {
         type: "ticket-assignment-updated";
         ticketId: string;
@@ -77,6 +78,7 @@ export declare class EditAssignmentFormScreen extends AsyncScreen<EditAssignment
      */
     leave(): void;
     reset(): void;
-    present(context: ScreenContext): import("../../../Screen/screen.js").ScreenPresentation;
+    protected modalChrome(context: ScreenContext): ModalChrome;
+    protected actions(): import("../../../Component/footer-actions/index.js").ActionItem[];
 }
 export {};

package/dist/src/Entity/ticket/Screen/edit-assignment-form.js

@@ -1,8 +1,8 @@
+import { actionItem } from '../../../Component/footer-actions/index.js';
 import { serverMessage } from '../../../lib/jsonapi-error.js';
 import { columnNode } from '../../../lib/vnode.js';
 import { defineContext } from '../../../Routing/context.js';
-import { AsyncScreen } from '../../../Screen/async-screen.js';
-import { presentation, } from '../../../Screen/screen.js';
+import { AsyncModalScreen } from '../../../Screen/async-modal-screen.js';
 import { createOptionLoader, } from '../../../Widget/option-source.js';
 import { activeRunInfo } from '../../run/Data/active-run.js';
 import { EDIT_FORM_REGION, editFormTree, } from '../Component/edit-form/index.js';
@@ -18,7 +18,7 @@ const relationshipId = (document, name) => {
         return undefined;
     return Array.isArray(data) ? data[0]?.id : data.id;
 };
-export class EditAssignmentFormScreen extends AsyncScreen {
+export class EditAssignmentFormScreen extends AsyncModalScreen {
     static result(ticketId, assigneeId) {
         return { type: 'ticket-assignment-updated', ticketId, assigneeId };
     }
@@ -251,21 +251,22 @@ export class EditAssignmentFormScreen extends AsyncScreen {
         this.context = undefined;
         super.reset();
     }
-    present(context) {
-        return presentation(this.surface(context), {
-            // GAIA-308: the popup is no longer only about assignment — it carries the
-            // estimate and the spent time too, so the chrome stops naming one half.
+    modalChrome(context) {
+        // GAIA-308: chrome names the ticket, not only assignment.
+        return {
             title: '✎ Edit ticket',
             meta: String(this.readyValue?.document.data?.attributes?.identifier ??
                 context.params?.ticketId ??
                 ''),
-            // GAIA-360 D12 — Esc closes the popup; Cancel ticket is the lifecycle
-            // action. Status must not say "Esc cancel".
-            status: ' ↑↓ field · ←→ change · Ctrl+S save · Esc close ',
-            // The popup's box supplies its own border and padding, so the body it
-            // holds must not also carry the body window's inset — see
-            // `presentation()`.
-            modal: true,
-        });
+        };
+    }
+    actions() {
+        // GAIA-360 D12 — Esc:close (not cancel); Cancel ticket is lifecycle.
+        return [
+            actionItem('edit-field', '↑↓', 'field'),
+            actionItem('edit-change', '←→', 'change'),
+            actionItem('edit-save', 'Ctrl+S', 'save'),
+            actionItem('edit-esc', 'Esc', 'close'),
+        ];
     }
 }

package/dist/src/Entity/ticket/Screen/parent-filter-form.d.ts

@@ -1,8 +1,9 @@
 import type { VNode } from '@opentui/core';
-import { AsyncScreen } from '../../../Screen/async-screen.js';
-import { type ScreenAction, type ScreenContext } from '../../../Screen/screen.js';
+import { AsyncModalScreen } from '../../../Screen/async-modal-screen.js';
+import type { ModalChrome } from '../../../Screen/modal-screen.js';
+import type { ScreenAction, ScreenContext } from '../../../Screen/screen.js';
 import { type ParentFilterOptions } from '../Form/parent-filter.js';
-export declare class ParentFilterScreen extends AsyncScreen<ParentFilterOptions> {
+export declare class ParentFilterScreen extends AsyncModalScreen<ParentFilterOptions> {
     readonly modal = true;
     static readonly route: {
         id: string;
@@ -40,5 +41,6 @@ export declare class ParentFilterScreen extends AsyncScreen<ParentFilterOptions>
     takeAction(): ScreenAction | undefined;
     handleInput(input: string, context: ScreenContext): boolean;
     reset(): void;
-    present(context: ScreenContext): import("../../../Screen/screen.js").ScreenPresentation;
+    protected modalChrome(context: ScreenContext): ModalChrome;
+    protected actions(): import("../../../Component/footer-actions/index.js").ActionItem[];
 }

package/dist/src/Entity/ticket/Screen/parent-filter-form.js

@@ -9,15 +9,15 @@
 // loads through, never a second lookup. The source builds its query with
 // `parent: null` criteria (F7), so an active parent filter can never narrow
 // the picker to that parent's own children.
+import { actionItem } from '../../../Component/footer-actions/index.js';
 import { columnNode } from '../../../lib/vnode.js';
-import { AsyncScreen } from '../../../Screen/async-screen.js';
-import { presentation, } from '../../../Screen/screen.js';
+import { AsyncModalScreen } from '../../../Screen/async-modal-screen.js';
 import { createOptionLoader, primeSources, } from '../../../Widget/option-source.js';
 import { FIELDS_REGION, renderDeclaredFieldsTree, } from '../../../Widget/render.js';
 import { keyToIntent } from '../Form/keys.js';
 import { PARENT_FILTER_FORM, } from '../Form/parent-filter.js';
 import { parentOptionSource } from '../Form/parent-source.js';
-export class ParentFilterScreen extends AsyncScreen {
+export class ParentFilterScreen extends AsyncModalScreen {
     modal = true;
     static route = {
         id: 'project.tickets.parent-filter',
@@ -186,15 +186,18 @@ export class ParentFilterScreen extends AsyncScreen {
         this.sources = {};
         super.reset();
     }
-    present(context) {
-        return presentation(this.surface(context), {
+    modalChrome(context) {
+        return {
             title: '⚡ Filter by parent',
             meta: context.project?.name ?? context.project?.slug ?? '',
-            status: ' ↑↓/←→ suggestion · Enter pick · Del clear · Esc cancel ',
-            // The popup's box supplies its own border and padding, so the body it
-            // holds must not also carry the body window's inset — see
-            // `presentation()`.
-            modal: true,
-        });
+        };
+    }
+    actions() {
+        return [
+            actionItem('parent-suggest', '↑↓/←→', 'suggestion'),
+            actionItem('parent-pick', 'Enter', 'pick'),
+            actionItem('parent-clear', 'Del', 'clear'),
+            actionItem('parent-esc', 'Esc', 'cancel'),
+        ];
     }
 }

package/dist/src/Entity/ticket/Screen/ticket-agents.d.ts

@@ -1,6 +1,7 @@
 import type { VNode } from '@opentui/core';
 import { AsyncScreen } from '../../../Screen/async-screen.js';
-import { type ScreenContext } from '../../../Screen/screen.js';
+import type { FullScreenChrome } from '../../../Screen/full-screen.js';
+import type { ScreenContext } from '../../../Screen/screen.js';
 import type { HostedAgent } from '../../../types.js';
 /**
  * The ticket agents list, declared once (GAIA-345 D2/D10).
@@ -127,7 +128,9 @@ export declare class TicketAgentsScreen extends AsyncScreen<HostedAgent[]> {
     protected load(context: ScreenContext): Promise<HostedAgent[]>;
     protected renderLoading(): string[];
     protected renderReady(rows: HostedAgent[]): VNode;
-    present(context: ScreenContext): import("../../../Screen/screen.js").ScreenPresentation;
+    protected chrome(_context: ScreenContext): FullScreenChrome;
+    protected actions(): import("../../../Component/footer-actions/index.js").ActionItem[];
+    protected notice(): string | undefined;
     focus(index: number, context: ScreenContext): boolean;
     activate(index: number, context: ScreenContext): boolean;
     select(index: number, context: ScreenContext): boolean;

package/dist/src/Entity/ticket/Screen/ticket-agents.js

@@ -18,9 +18,9 @@
 // `Agent/Data/` for it to sit in. `PICKER_TABLE` is the precedent for exactly
 // that case, and it sits in `Entity/project/Screen/project-picker.ts` for exactly
 // this reason.
+import { actionItem } from '../../../Component/footer-actions/index.js';
 import { ListCursor } from '../../../lib/cursor.js';
 import { AsyncScreen } from '../../../Screen/async-screen.js';
-import { presentation } from '../../../Screen/screen.js';
 import { listRowIds, listTableTree } from '../../collection.js';
 /**
  * The ticket agents list, declared once (GAIA-345 D2/D10).
@@ -179,24 +179,24 @@ export class TicketAgentsScreen extends AsyncScreen {
             selectedIndex: this.selectedIndex,
         });
     }
-    present(context) {
+    chrome(_context) {
         const rows = this.rows;
-        return presentation(this.surface(context), {
+        return {
             selectable: rows.length,
             selectedIndex: this.selectedIndex,
-            // Row 0 is the table's own header, so the selected AGENT is one row below
-            // its index. Still the row the kernel scrolls into view and nothing more:
-            // the highlight is a prop on that row's cells now (GAIA-340 D3).
-            // The node a click on each row lands on (GAIA-340 Task 11), read off the
-            // SAME configuration that keys the rows (GAIA-345 D2) — which retires the
-            // hand-written `agentRowIds`, a second expression of an id the component
-            // spelled independently.
             rowIds: listRowIds(AGENT_TABLE, rows),
             title: 'Ticket-Agents',
-            meta: `${rows.length} agent(s)  ·  Enter switch · z overview · r retry · x close · Esc back`,
-            status: this.status ||
-                ' ↑↓ select · Enter switch · z overview · r retry · x close · Tab tabs · Esc back · q quit ',
-        });
+            meta: `${rows.length} agent(s)`,
+        };
+    }
+    actions() {
+        return [
+            actionItem('agents-enter', 'Enter', 'switch'),
+            actionItem('agents-tab', 'Tab', 'tabs'),
+        ];
+    }
+    notice() {
+        return this.status || undefined;
     }
     focus(index, context) {
         const row = this.readyValue?.[index];