@softov/ahpc 0.3.0 → 0.4.0

package/dist/src/links.js

@@ -0,0 +1,120 @@
+/**
+ * `agent-host-session://` links, which are how one session names another.
+ *
+ * The reference host's session tools answer with one - `create_session`,
+ * `list_sessions` and `send_message` each put an `openLink` in their result -
+ * and its window turns the link into a click that opens the session or the
+ * chat. A terminal has no click, so here the same link is something to pick:
+ * the links in the open transcript are offered as a list, and one chosen
+ * opens what it names. The shape is the reference host's
+ * (`common/openSessionLink.ts`): `agent-host-session://<provider>/<id>`, with
+ * `?chat=<chatId>` for one chat of it and `&turn=<turnId>` for one turn.
+ */
+const LINK = /^agent-host-session:\/\/([^/?#]+)\/([^?#]+)(?:\?([^#]*))?(?:#.*)?$/i;
+/** A link wherever it sits in prose: up to the whitespace or the bracket that ends it. */
+const IN_TEXT = /agent-host-session:\/\/[^\s<>()\[\]"'`]+/gi;
+const param = (query, name) => {
+    const found = new RegExp(`(?:^|&)${name}=([^&]*)`).exec(query)?.[1];
+    if (found === undefined)
+        return undefined;
+    try {
+        return decodeURIComponent(found);
+    }
+    catch {
+        return found;
+    }
+};
+/** The link read, or undefined for text that is not one. */
+export function parseSessionLink(text) {
+    const found = LINK.exec(text.trim());
+    if (found === null)
+        return undefined;
+    let id;
+    try {
+        id = decodeURIComponent(found[2] ?? '');
+    }
+    catch {
+        id = found[2] ?? '';
+    }
+    if (id === '')
+        return undefined;
+    const query = found[3] ?? '';
+    const chatId = param(query, 'chat');
+    const turnId = param(query, 'turn');
+    return {
+        provider: found[1] ?? '',
+        id,
+        // The default chat is the session itself, which is how the reference
+        // host builds the link: it leaves the query off for it.
+        ...(chatId !== undefined && chatId !== '' && chatId !== 'default' ? { chatId } : {}),
+        ...(turnId !== undefined && turnId !== '' ? { turnId } : {}),
+    };
+}
+/** The id inside a session URI, whatever scheme it is under: `ahp-session:/x` and `claude:/x` are both `x`. */
+export const idOf = (uri) => {
+    const colon = uri.indexOf(':');
+    return (colon < 0 ? uri : uri.slice(colon + 1)).replace(/^\/+/, '');
+};
+/**
+ * The row a link names.
+ *
+ * Matched on the id and the provider, whichever scheme the row is under: a
+ * session this client started is `ahp-session:/` and one read off the host's
+ * catalogue is `<provider>:/`, and the link says neither.
+ */
+export const sessionOfLink = (link, rows) => rows.find((row) => idOf(row.resource) === link.id && row.provider === link.provider)
+    ?? rows.find((row) => idOf(row.resource) === link.id);
+/**
+ * Every link in the transcript, once each, in the order they appear.
+ *
+ * Read from what a person can see: the prose, the tool calls' outcomes and
+ * outputs, and the host's notices. A tool answering `create_session` puts the
+ * link in its output, which is where somebody reading the transcript finds it.
+ */
+export function linksIn(turns) {
+    const found = [];
+    const seen = new Set();
+    const take = (text, turnId) => {
+        if (!text)
+            return;
+        for (const match of text.matchAll(IN_TEXT)) {
+            const link = match[0].replace(/[.,;:!?]+$/, '');
+            if (seen.has(link) || parseSessionLink(link) === undefined)
+                continue;
+            seen.add(link);
+            const from = Math.max(0, (match.index ?? 0) - 40);
+            const context = text.slice(from, match.index ?? 0).replace(/\s+/g, ' ').trim();
+            found.push({ link, context, turnId });
+        }
+    };
+    for (const turn of turns) {
+        take(turn.message, turn.id);
+        for (const part of turn.parts) {
+            if (part.kind === 'markdown' || part.kind === 'systemNotification')
+                take(part.content, turn.id);
+            else if (part.kind === 'toolCall') {
+                take(part.call.outcome, turn.id);
+                take(part.call.output, turn.id);
+            }
+        }
+    }
+    return found;
+}
+/**
+ * Whether a chat URI is the chat a link names.
+ *
+ * The id is the URI's authority where it has one - `ahp-chat://<chatId>/<session>`,
+ * which is how the reference host and ahpd spell a chat - and the path
+ * otherwise, `ahp-chat:/<id>`, which is the protocol's own shape.
+ */
+export const chatMatches = (chatUri, chatId) => {
+    const found = /^[^:]+:\/\/([^/]+)\//.exec(chatUri)?.[1] ?? idOf(chatUri);
+    if (found === '')
+        return false;
+    try {
+        return decodeURIComponent(found) === chatId;
+    }
+    catch {
+        return found === chatId;
+    }
+};

package/dist/src/resources.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The host's filesystem, as a textui resource provider.
+ *
+ * textui's file picker, its search and its viewers read the resource
+ * registry and never `node:fs` - which is the reason they can be pointed at
+ * a filesystem on another machine. This is that pointing: `file:` on this
+ * client is the host's disk, reached through the protocol's `resource*`
+ * requests, so a folder picked in a dialog is a folder the host can start a
+ * session in. Read-only here; what writes goes through `ahpc resource`.
+ */
+import type { ResourceProvider } from '@textui/core';
+import type { HostConnection } from './ahp/connection.js';
+export declare function hostResources(host: HostConnection): ResourceProvider;

package/dist/src/resources.js

@@ -0,0 +1,46 @@
+/**
+ * The host's filesystem, as a textui resource provider.
+ *
+ * textui's file picker, its search and its viewers read the resource
+ * registry and never `node:fs` - which is the reason they can be pointed at
+ * a filesystem on another machine. This is that pointing: `file:` on this
+ * client is the host's disk, reached through the protocol's `resource*`
+ * requests, so a folder picked in a dialog is a folder the host can start a
+ * session in. Read-only here; what writes goes through `ahpc resource`.
+ */
+const nameOf = (uri) => decodeURIComponent(uri.replace(/\/+$/, '').split('/').pop() ?? '');
+export function hostResources(host) {
+    const resource = (uri, kind, size) => ({
+        uri,
+        kind: kind === 'directory' ? 'directory' : 'file',
+        metadata: { name: nameOf(uri), ...(size === undefined ? {} : { size }), readonly: true },
+        capabilities: kind === 'directory' ? ['list'] : ['read'],
+    });
+    return {
+        scheme: 'file',
+        // A host without the family answers -32601, which is the same answer as
+        // "nothing there" to something asking whether it can list a folder.
+        stat: async (uri) => {
+            if (!host.resourceResolve)
+                return null;
+            try {
+                const found = await host.resourceResolve(uri);
+                return resource(found.uri, found.type, found.size);
+            }
+            catch {
+                return null;
+            }
+        },
+        list: async (uri) => {
+            if (!host.resourceList)
+                return [];
+            return (await host.resourceList(uri)).map((entry) => resource(entry.uri, entry.kind, entry.size));
+        },
+        read: async (uri) => {
+            if (!host.resourceRead)
+                throw new Error('This host does not serve files.');
+            const found = await host.resourceRead(uri);
+            return found.encoding === 'base64' ? Uint8Array.from(Buffer.from(found.data, 'base64')) : found.data;
+        },
+    };
+}

package/dist/src/screens.js

@@ -3,24 +3,15 @@ import { defineComponent, useApp, useCapabilities, useEffect, useFocusScope, use
 import { Badge, Column, Divider, EmptyState, Field, Form, FormActions, Marquee, Panel, RadioGroup, Row, SearchBox, Select, TextInput, argumentOf, useForm } from '@textui/widgets';
 import { PRESETS, presetFor, scheduleProblem, zoneIsKnownHere } from './schedule.js';
 import { AUTOMATIONS_SCOPE, CHANGES_SCOPE, CHAT_SCOPE, CONTROLLER, MCP_SCOPE, SESSIONS_SCOPE, SKILLS_SCOPE, modelCommand, settingCommand, } from './control.js';
-import { branchName, branchDrift, ARCHIVED, AUTOMATIONS, AUTOMATION_ROW, CHANGES, CUSTOMIZATIONS, DRAFT, EXPANDED, FILTER, FOCUS, HISTORY, HOST, INPUT, CHANGE_AT, CHANGE_ROW, CHANGE_SCOPES, FILES_AT, FILES_ENTRIES, FILES_OPEN, MODEL, MODEL_CONFIG, OPEN, OPEN_FILE, CHAT_URI, PROVIDER, QUEUE, SELECTED, SESSIONS, SETTINGS, SIDEBAR, CHATS, CURSOR, FIND, FINDING, FIND_AT, OPEN_TERMINAL, PRESENT, SPLIT_AT, SPLIT_DEFAULT, TERMINAL, TERMINALS, TURNS, WORKSPACE, hiddenSessions, openSession, visibleSessions, workspaceName, } from './state.js';
-import { findBlocks, toBlocks } from './blocks.js';
+import { branchName, branchDrift, pullRequestLabel, ARCHIVED, AUTOMATIONS, AUTOMATION_ROW, CHANGES, CUSTOMIZATIONS, DRAFT, EXPANDED, FILTER, FOCUS, HISTORY, HOST, INPUT, CHANGE_AT, CHANGE_ROW, CHANGE_SCOPES, FILES_AT, FILES_ENTRIES, FILES_OPEN, MODEL, MODEL_CONFIG, OPEN, OPEN_FILE, CHAT_URI, PROVIDER, QUEUE, SELECTED, SESSIONS, SETTINGS, SIDEBAR, CHATS, CURSOR, FIND, FINDING, FIND_AT, OPEN_TERMINAL, PRESENT, SPLIT_AT, SPLIT_DEFAULT, TERMINAL, TERMINALS, TURNS, WORKSPACE, ANSWERS, INPUT_STATUS, MARKDOWN, boodFloorFor, hiddenSessions, openSession, sessionView, visibleSessions, workspaceName, } from './state.js';
+import { toBlocks } from './blocks.js';
 import { decodeStatus } from './ahp/status.js';
-import { ChatTranscript } from './view/transcript.js';
-import { ChatComposer } from './view/composer.js';
-import { ChatSessionHead } from './view/sessionhead.js';
-import { settingIcon, valueIcon } from './view/icons.js';
-import { ChatHitl, ChatInputStatus } from './view/hitl.js';
+import { ChatComposer, ChatHitl, ChatInputStatus, ChatSessionHead, ChatTranscript, ConnectionBadge, FileDiff, SessionDetails, SessionList, diffLines, findBlocks, openPicker, settingIcon, valueIcon, } from '@textui/chat';
 import { ChangesList } from './view/changes.js';
 import { FileList } from './view/files.js';
 import { AutomationList } from './view/automations.js';
 import { CustomizationList } from './view/customizations.js';
 import { TerminalView } from './view/terminal.js';
-import { FileDiff } from './view/filediff.js';
-import { diffLines } from './diff.js';
-import { ConnectionBadge, SessionList } from './view/sessions.js';
-import { SessionDetails } from './view/details.js';
-import { openPicker } from './view/picker.js';
 /**
  * The screens.
  *
@@ -31,9 +22,19 @@ import { openPicker } from './view/picker.js';
  * command palette, a confirm - is a layer or an expansion inside one of these,
  * because none of them is a place you navigate *to*.
  *
- * Every screen is composition. The parts are in `view/`, the actions are in
- * `control.ts`, and what is left here is which part goes where.
+ * Every screen is composition. The chat parts are `@textui/chat`'s, the
+ * AHP-only ones are in `view/`, the actions are in `control.ts`, and what is
+ * left here is which part goes where.
  */
+/**
+ * Keys the reference host seeds from the client's own settings and never asks
+ * about (`WELL_KNOWN_PICKER_PROPERTIES` in `agentHostChatInputPicker.ts`):
+ * how a worktree's branch is named and tracked, which ignored files come
+ * along, the shell's init script. Declared so the value rides in the config
+ * bag; drawn, they are five chips nobody can change, which is what "too many
+ * options" looked like.
+ */
+const SEEDED = new Set(['worktreeBranchPrefix', 'worktreeBranchTrack', 'worktreeCreateNewBranch', 'worktreeIncludeFiles', 'shellInitScripts']);
 /**
  * Everything the catalogue knows about one session, as rows.
  *
@@ -80,7 +81,7 @@ function describe(session, detail) {
         // how the pane came to show a blank "Permissions" against a host whose key
         // for it is `autoApprove`.
         ...(detail?.config.properties ?? [])
-            .filter((property) => property.values.length > 0)
+            .filter((property) => property.values.length > 0 && !SEEDED.has(property.key))
             .map((property) => ({
             id: `config.${property.key}`,
             label: property.title,
@@ -90,7 +91,7 @@ function describe(session, detail) {
         {
             id: 'branch',
             label: 'Branch',
-            value: [branchName(session), branchDrift(session)].filter(Boolean).join('  '),
+            value: [branchName(session), branchDrift(session), pullRequestLabel(session)].filter(Boolean).join('  '),
             absent: 'not a repository, or the host does not say',
         },
         // The identifiers, in full and copyable. A URI you can read half of is
@@ -202,7 +203,7 @@ export const SessionsScreen = defineComponent('SessionsScreen', () => {
     return (_jsxs(Row, { flex: 1, gap: 1, children: [_jsxs(Panel, { title: "Sessions", ...(reading ? { width: aside } : { flex: 1 }), meta: waiting > 0 ? `${theme.glyphs.warning} ${waiting} waiting on you` : `${sessions.length} shown`, children: [_jsx(SearchBox, { value: filter, placeholder: "title, provider or workspace", 
                         // Named, so `ctrl+f` has something to focus. A control whose id
                         // comes from its instance cannot be the target of a command.
-                        focusId: "chat.filter", onChange: (value) => app.store.set(FILTER, value) }), _jsx(SessionList, { sessions: sessions, selectedId: selected, focusId: "chat.sessions", 
+                        focusId: "chat.filter", onChange: (value) => app.store.set(FILTER, value) }), _jsx(SessionList, { sessions: sessions.map(sessionView), selectedId: selected, focusId: "chat.sessions", 
                         // The list, not the filter. Whatever registers first would
                         // otherwise hold the keyboard on arrival, and the filter is drawn
                         // above the list - which made every single-letter command a letter
@@ -341,6 +342,12 @@ function useHarnessCommands() {
     }, []);
     return items;
 }
+/**
+ * The keys that say where a session runs, which get a row of their own, in
+ * the order they read: after the directory, whether the session sits in it
+ * or in a worktree of it, and then the branch a worktree starts from.
+ */
+const WHERE = ['isolation', 'branch'];
 function useComposerOptions() {
     const unicode = useCapabilities().unicode;
     const controller = useRequiredService(CONTROLLER);
@@ -357,15 +364,27 @@ function useComposerOptions() {
     }, []);
     // Asking is also what registers a command per property, so the chips below
     // have something to open and the palette has the same questions in it.
+    // Asked again after every answer while there is no session yet, because
+    // the questions depend on the answers: `branch` is read-only until
+    // isolation is `worktree`, and the reference host rewrites the schema on
+    // `resolveSessionConfig` to say so. On what the values say rather than the
+    // object, since the host's echo of the same answers is a new object every
+    // time and would ask forever. And again when the directory changes, since
+    // isolation and the branches are questions about one repository. An open
+    // session's config arrives on its own channel, and asking for it after
+    // every change would answer with the value the host held before the
+    // change reached it.
+    const answered = open ? '' : JSON.stringify(settings);
     useEffect(() => {
         void controller.settings().then(setConfig)
             .catch((error) => controller.report(error));
-    }, [provider, open]);
+    }, [provider, open, answered, open ? '' : workspace]);
     const agent = agents.find((found) => found.provider === provider);
     // A harness with no models is the ordinary answer for one nobody has signed
     // into, so the chip says so rather than opening on an empty list. Until the
     // catalogue has arrived there is no harness to say it about.
     const models = agent ? agent.models : null;
+    const fromConfig = fromConfigOf(unicode, config, models, model, settings, open);
     return [
         {
             id: 'harness',
@@ -412,42 +431,58 @@ function useComposerOptions() {
                 commandId: modelCommand(property.key),
             };
         }),
-        ...(config?.properties ?? [])
-            .filter((property) => property.values.length > 0)
-            // A key the model also asks about is the model's to answer: the session
-            // key is the whole harness's default and the model's is what this
-            // message runs at, and drawing both put two controls on one row
-            // disagreeing about the same setting.
-            .filter((property) => !(models?.find((found) => found.id === model)?.options ?? [])
-            .some((one) => one.key === property.key))
-            .map((property) => {
-            const value = settings[property.key];
-            const chosen = property.values.find((found) => found.value === value);
-            return {
-                id: property.key,
-                // The value's own mark where it has one - which of five approval
-                // modes is in force is the thing worth reading from the row itself.
-                // The question's mark otherwise, so a branch chip is still a branch.
-                icon: (value !== undefined
-                    ? valueIcon(unicode, value, chosen?.label)
-                    : undefined)
-                    ?? settingIcon(unicode, property.key, property.title),
-                label: chosen?.label ?? value ?? property.title,
-                // The question, for anything showing these with room for the pair.
-                title: property.title,
-                // Shown but not asked where the host says it cannot be changed on a
-                // running session: offering it produces a refusal, not an edit.
-                ...(open && !property.sessionMutable ? {} : { commandId: settingCommand(property.key) }),
-            };
-        }),
+        ...fromConfig.filter((option) => !option.where),
         {
             id: 'workspace',
             icon: settingIcon(unicode, 'workspace'),
             label: workspaceName(workspace ? `file://${workspace}` : undefined),
+            where: true,
             ...(open ? {} : { commandId: 'compose.workspace' }),
         },
+        ...fromConfig.filter((option) => option.where)
+            .sort((a, b) => WHERE.indexOf(a.id) - WHERE.indexOf(b.id)),
     ];
 }
+/** The session's own questions, as chips. */
+function fromConfigOf(unicode, config, models, model, settings, open) {
+    return (config?.properties ?? [])
+        // Something to choose from, or a host that said to ask it: `branch` is
+        // `enumDynamic` with its values behind `sessionConfigCompletions`, and
+        // a chip that needed the list up front never showed the one question
+        // that has more answers than a schema holds.
+        .filter((property) => (property.values.length > 0 || property.enumDynamic === true) && !SEEDED.has(property.key))
+        // A key the model also asks about is the model's to answer: the session
+        // key is the whole harness's default and the model's is what this
+        // message runs at, and drawing both put two controls on one row
+        // disagreeing about the same setting.
+        .filter((property) => !(models?.find((found) => found.id === model)?.options ?? [])
+        .some((one) => one.key === property.key))
+        // Shown but not asked where the host says it cannot be changed on a
+        // running session, or at all: offering it produces a refusal, not an
+        // edit. And a value that is neither askable nor known is nothing to
+        // draw: a read-only `branch` with no default is a chip saying "Branch".
+        .map((property) => ({ property, asked: !((open && !property.sessionMutable) || property.readOnly === true) }))
+        .filter(({ property, asked }) => asked || settings[property.key] !== undefined)
+        .map(({ property, asked }) => {
+        const value = settings[property.key];
+        const chosen = property.values.find((found) => found.value === value);
+        return {
+            id: property.key,
+            // The value's own mark where it has one - which of five approval
+            // modes is in force is the thing worth reading from the row itself.
+            // The question's mark otherwise, so a branch chip is still a branch.
+            icon: (value !== undefined
+                ? valueIcon(unicode, value, chosen?.label)
+                : undefined)
+                ?? settingIcon(unicode, property.key, property.title),
+            label: chosen?.label ?? value ?? property.title,
+            // The question, for anything showing these with room for the pair.
+            title: property.title,
+            ...(WHERE.includes(property.key) ? { where: true } : {}),
+            ...(asked ? { commandId: settingCommand(property.key) } : {}),
+        };
+    });
+}
 // -------------------------------------------------------------------- 2. chat
 /**
  * What goes after a slash, from both places it can come from.
@@ -533,6 +568,12 @@ export const ChatScreen = defineComponent('ChatScreen', () => {
     const present = useStoreValue(PRESENT, []) ?? [];
     const chat = useStoreValue(CHAT_URI, null) ?? null;
     const running = turns.some((turn) => turn.state === 'running');
+    // What the components used to read for themselves. The switch, the row
+    // under the composer and the draft answers are this client's state; the
+    // components take them as props and know nothing of the paths.
+    const markdown = useStoreValue(MARKDOWN, true) ?? true;
+    const inputStatus = useStoreValue(INPUT_STATUS, null) ?? null;
+    const [answers, setAnswers] = useStore(`${ANSWERS}/${input?.id ?? 'none'}`, {});
     /*
      * Memoised, and the three below it with it, because of what the
      * transcript does with them.
@@ -593,7 +634,7 @@ export const ChatScreen = defineComponent('ChatScreen', () => {
     // What the caption is made of, as one value that can be compared. The
     // parts are rebuilt every render and the caption they describe is not.
     const headSignature = JSON.stringify([session, model, chat, settingRows, chats.length, reading]);
-    const head = useMemo(() => (_jsxs(Column, { padding: [0, 0, 1, 0], children: [session ? (_jsx(ChatSessionHead, { session: session, present: present, ...(model ? { model } : {}), ...(chat ? { chat } : {}), settings: chats.length > 1
+    const head = useMemo(() => (_jsxs(Column, { padding: [0, 0, 1, 0], children: [session ? (_jsx(ChatSessionHead, { session: sessionView(session), present: present, ...(model ? { model } : {}), ...(chat ? { chat } : {}), settings: chats.length > 1
                     // Where a session holds several, which one is being read is the
                     // first thing somebody needs from the header - a transcript
                     // that changed under the same title is otherwise unexplained.
@@ -669,7 +710,11 @@ export const ChatScreen = defineComponent('ChatScreen', () => {
             // The top of the conversation, inside it. See `head`.
             , { 
                 // The top of the conversation, inside it. See `head`.
-                head: head, flex: 1, blocks: blocks, expanded: expanded, ...(finding && query.trim() !== '' ? { match: query.trim(), pinCursor: true } : {}), cursor: cursor ?? 0, onCursor: onCursor, onToggle: onToggle }), input ? (_jsx(ChatHitl, { input: input, onApprove: (option) => controller.approve(option), onDeny: () => controller.deny(), onAnswer: (answers, accepted) => controller.answer(answers, accepted), 
+                head: head, flex: 1, blocks: blocks, expanded: expanded, ...(finding && query.trim() !== '' ? { match: query.trim(), pinCursor: true } : {}), cursor: cursor ?? 0, onCursor: onCursor, onToggle: onToggle, markdown: markdown }), input ? (_jsx(ChatHitl, { input: input, draft: answers ?? {}, onDraft: setAnswers, 
+                // Where it starts, so the creature has somewhere to stand that is
+                // not on it. The block sits above the composer, so this is the
+                // floor while a question is up.
+                onMeasure: (rect) => app.store.set(boodFloorFor('ask'), rect?.y ?? 0), onApprove: (option) => controller.approve(option), onDeny: () => controller.deny(), onAnswer: (answers, accepted) => controller.answer(answers, accepted), 
                 // The block takes keys globally while it is up, escape included -
                 // which is right for `a` and `d` and wrong for the one key that is
                 // how you leave. Sent back to the transcript unconditionally it
@@ -688,7 +733,7 @@ export const ChatScreen = defineComponent('ChatScreen', () => {
                         app.screens.pop();
                     else
                         app.focus.focus('chat.transcript');
-                } })) : null, _jsx(ChatInputStatus, {}), _jsx(ChatComposer, { value: draft, running: running, queued: queued.length, options: options, onOption: (option, anchorId) => {
+                } })) : null, _jsx(ChatInputStatus, { status: inputStatus }), _jsx(ChatComposer, { value: draft, onMeasure: (rect) => app.store.set(boodFloorFor('composer'), rect?.y ?? 0), running: running, queued: queued.length, options: options, onOption: (option, anchorId) => {
                     if (option.commandId)
                         openPicker(app, { commandId: option.commandId, anchorId });
                 }, commands: slashCommands(app, skills), paths: paths, onPath: (path) => {
@@ -741,7 +786,7 @@ export const NewSessionScreen = defineComponent('NewSessionScreen', () => {
     const options = useComposerOptions();
     const harnessSkills = useHarnessCommands();
     const newPaths = usePathCompletions(draft, 'ahp-root://');
-    return (_jsxs(Column, { flex: 1, gap: 1, children: [_jsxs(Column, { flex: 1, justify: "center", align: "center", gap: 0, children: [_jsx("text", { content: "A new session", fg: "muted" }), _jsx("text", { content: "The first message is what starts it.", fg: "subtle" }), _jsx("text", { content: `${theme.glyphs.chevronLeft} esc for the sessions you already have`, fg: "subtle" })] }), _jsx(ChatComposer, { value: draft, options: options, onOption: (option, anchorId) => {
+    return (_jsxs(Column, { flex: 1, gap: 1, children: [_jsxs(Column, { flex: 1, justify: "center", align: "center", gap: 0, children: [_jsx("text", { content: "A new session", fg: "muted" }), _jsx("text", { content: "The first message is what starts it.", fg: "subtle" }), _jsx("text", { content: `${theme.glyphs.chevronLeft} esc for the sessions you already have`, fg: "subtle" })] }), _jsx(ChatComposer, { value: draft, onMeasure: (rect) => app.store.set(boodFloorFor('composer'), rect?.y ?? 0), options: options, onOption: (option, anchorId) => {
                     if (option.commandId)
                         openPicker(app, { commandId: option.commandId, anchorId });
                 }, 

package/dist/src/state.d.ts

@@ -1,4 +1,5 @@
 import type { BindingPath, ReactiveStore } from '@textui/core';
+import type { ChatSession } from '@textui/chat';
 import type { HostEvent } from './ahp/connection.js';
 import type { Changeset, PendingInput, QueuedMessage, SessionSummary, Turn } from './ahp/types.js';
 /**
@@ -237,6 +238,14 @@ export declare const CURSOR: BindingPath;
  * link's target rather than its label.
  */
 export declare const MARKDOWN: BindingPath;
+/**
+ * Draft answers to the question the host is waiting on, one map per request.
+ *
+ * In the store, not in the block: AHP has an action for a draft answer
+ * precisely because another client may be looking at the same question, and
+ * a value only one box knows is one nobody else can see.
+ */
+export declare const ANSWERS: BindingPath;
 /**
  * Whether the catalogue's detail pane is out, or `null` for "whatever the
  * terminal is wide enough for".
@@ -344,6 +353,39 @@ export declare function projectName(session: SessionSummary): string;
  * "the host does not say" against a host that was saying it all along.
  */
 export declare function branchName(session: SessionSummary): string | undefined;
+/**
+ * A session as the components take it: decoded, and with nothing in it that
+ * only this client knows how to read.
+ *
+ * The status bitfield, the git metadata, the project name and the pull
+ * request are all AHP's business, and `@textui/chat` has no opinion about
+ * any of them.
+ */
+export declare function sessionView(session: SessionSummary): ChatSession;
+/** A pull request the session's branch is known by, and what became of it. */
+export interface PullRequest {
+    /** The number in its URL, which is how a person names one. */
+    number: string;
+    /** The last state the host observed, where it observed one. */
+    state?: 'open' | 'closed' | 'merged';
+}
+/**
+ * The pull request the reference host found for this session, if it applies.
+ *
+ * `_meta.github` is the reference host's, the way `_meta.git` is: a
+ * convention read by its own window, not a declaration. `pullRequestUrls` is
+ * the history, most recent first, and only the most recent counts. Two
+ * checks are the host's own, and are kept here so a row never says more than
+ * the host would: a request found for another branch is not this branch's
+ * (`pullRequestBranchName`, when the host has recorded one), and a state is
+ * only the state of the URL it was observed on (`pullRequestStateUrl`) - the
+ * host keeps reporting the last request it knew while it looks for one on the
+ * branch the checkout moved to, and "merged" beside the wrong number is worse
+ * than no state at all.
+ */
+export declare function pullRequest(session: SessionSummary): PullRequest | undefined;
+/** The pull request as a row says it: the number, and its state where known. */
+export declare function pullRequestLabel(session: SessionSummary): string | undefined;
 /**
  * How far the branch has drifted, where the host counted.
  *

package/dist/src/state.js

@@ -234,6 +234,14 @@ export const CURSOR = '$/screen.chat/cursor';
  * link's target rather than its label.
  */
 export const MARKDOWN = '$/chat/ui/markdown';
+/**
+ * Draft answers to the question the host is waiting on, one map per request.
+ *
+ * In the store, not in the block: AHP has an action for a draft answer
+ * precisely because another client may be looking at the same question, and
+ * a value only one box knows is one nobody else can see.
+ */
+export const ANSWERS = '$/chat/ui/answers';
 /**
  * Whether the catalogue's detail pane is out, or `null` for "whatever the
  * terminal is wide enough for".
@@ -483,7 +491,9 @@ export function projectName(session) {
  * anything here, including a `git` that is not an object.
  */
 function git(session) {
-    const found = session._meta?.git;
+    return objectAt(session._meta?.git);
+}
+function objectAt(found) {
     return typeof found === 'object' && found !== null && !Array.isArray(found)
         ? found
         : {};
@@ -511,6 +521,75 @@ export function branchName(session) {
     }
     return undefined;
 }
+/**
+ * A session as the components take it: decoded, and with nothing in it that
+ * only this client knows how to read.
+ *
+ * The status bitfield, the git metadata, the project name and the pull
+ * request are all AHP's business, and `@textui/chat` has no opinion about
+ * any of them.
+ */
+export function sessionView(session) {
+    const branch = branchName(session);
+    const pull = pullRequestLabel(session);
+    return {
+        id: session.resource,
+        title: session.title,
+        provider: session.provider,
+        status: decodeStatus(session.status),
+        createdAt: session.createdAt,
+        modifiedAt: session.modifiedAt,
+        workingDirectories: session.workingDirectories,
+        project: projectName(session),
+        ...(branch ? { branch } : {}),
+        ...(pull ? { pullRequest: pull } : {}),
+        ...(session.activity ? { activity: session.activity } : {}),
+        ...(session.origin?.kind === 'automation' ? { origin: 'by an automation' } : {}),
+        ...(session.changes ? { changes: session.changes } : {}),
+    };
+}
+/** The key two spellings of one pull request URL share: case and a trailing slash. */
+const urlKey = (url) => url.trim().replace(/\/+$/, '').toLowerCase();
+/**
+ * The pull request the reference host found for this session, if it applies.
+ *
+ * `_meta.github` is the reference host's, the way `_meta.git` is: a
+ * convention read by its own window, not a declaration. `pullRequestUrls` is
+ * the history, most recent first, and only the most recent counts. Two
+ * checks are the host's own, and are kept here so a row never says more than
+ * the host would: a request found for another branch is not this branch's
+ * (`pullRequestBranchName`, when the host has recorded one), and a state is
+ * only the state of the URL it was observed on (`pullRequestStateUrl`) - the
+ * host keeps reporting the last request it knew while it looks for one on the
+ * branch the checkout moved to, and "merged" beside the wrong number is worse
+ * than no state at all.
+ */
+export function pullRequest(session) {
+    const found = objectAt(session._meta?.github);
+    const urls = Array.isArray(found.pullRequestUrls)
+        ? found.pullRequestUrls.filter((url) => typeof url === 'string')
+        : typeof found.pullRequestUrl === 'string' ? [found.pullRequestUrl] : [];
+    const url = urls[0];
+    if (url === undefined)
+        return undefined;
+    const branch = found.pullRequestBranchName;
+    if (typeof branch === 'string' && branch !== branchName(session))
+        return undefined;
+    const number = /\/pull\/(\d+)\/?$/.exec(url)?.[1];
+    if (number === undefined)
+        return undefined;
+    const state = found.pullRequestState;
+    const applies = typeof found.pullRequestStateUrl === 'string' && urlKey(found.pullRequestStateUrl) === urlKey(url);
+    return {
+        number,
+        ...(applies && (state === 'open' || state === 'closed' || state === 'merged') ? { state } : {}),
+    };
+}
+/** The pull request as a row says it: the number, and its state where known. */
+export function pullRequestLabel(session) {
+    const found = pullRequest(session);
+    return found === undefined ? undefined : [`#${found.number}`, found.state].filter(Boolean).join(' ');
+}
 /**
  * How far the branch has drifted, where the host counted.
  *

package/dist/src/tui.d.ts

@@ -77,9 +77,11 @@ interface Options {
     publish?: string;
     /** Whether the host may write into it. Read-only otherwise. */
     publishWritable?: boolean;
+    /** A file every frame is appended to, both directions, as JSON lines. */
+    wire?: string;
     help: boolean;
 }
-export declare const USAGE = "ahpc - a terminal client for the Agent Host Protocol\n\n  ahpc [options]\n\nThe host\n  --host <url>          A live agent host, ws://host:port\n  --token <tkn>         A bearer token for it\n  --config-file <f>     Read this instead of ~/.config/ahpc/config.json\n  (none of these)       The scripted host, which needs nothing installed\n\nWhere the agent works\n  --path <dir>          A path on the host, not on this machine. The host\n                        has to serve it, and says so if it does not.\n                        Left out, the host decides.\n\nWhat this client serves back\n  --publish <dir>       Serve this directory to the host under\n                        virtual://<clientId>/. Nothing is served without\n                        it, and every such request is refused.\n  --publish-writable    Let the host write into it. Read-only otherwise.\n                        Serving lasts as long as the screen does: with no\n                        terminal attached this prints one frame and exits,\n                        so a background shell publishes nothing.\n\nAppearance\n  --theme <name>        workbench, paper-light, ...\n  --shell <name>        The shell layout\n  --screen <name>       Which screen to open on\n  --bood                Let the creature loose on the whole screen. It\n                        keeps off the composer and off anything asking\n                        a question, and alt+g turns it off again.\n  --session <uri>       Open this session\n\nStills, for a README or a test\n  --static, -s          One frame to stdout instead of running\n  --width, -w <n>       Columns\n  --height <n>          Rows\n  --unicode <level>     ascii, bmp, full\n  --colors <n>          0, 4, 8 or 24\n  --svg <file>          Write the still as SVG here\n  --tick <ms>           Milliseconds per scripted word\n  --settled             Run the script out before the frame\n  --pump <n>            Or exactly this many scripted words\n  --say <text>          Say this on the open session first\n  --approve             Answer the confirmation the script stops at\n  --answer              ...and then the question\n\n  --version, -v         What version this is\n  --help, -h            This\n\nCommands\n  ahpc <command> ...    Drive a host without the screen. 'ahpc help' lists\n                        them: sessions, prompts, approvals, terminals.\n";
+export declare const USAGE = "ahpc - a terminal client for the Agent Host Protocol\n\n  ahpc [options]\n\nThe host\n  --host <url>          A live agent host, ws://host:port\n  --token <tkn>         A bearer token for it\n  --config-file <f>     Read this instead of ~/.config/ahpc/config.json\n  (none of these)       The scripted host, which needs nothing installed\n\nWhere the agent works\n  --path <dir>          A path on the host, not on this machine. The host\n                        has to serve it, and says so if it does not.\n                        Left out, the host decides.\n\nWhat this client serves back\n  --publish <dir>       Serve this directory to the host under\n                        virtual://<clientId>/. Nothing is served without\n                        it, and every such request is refused.\n  --publish-writable    Let the host write into it. Read-only otherwise.\n                        Serving lasts as long as the screen does: with no\n                        terminal attached this prints one frame and exits,\n                        so a background shell publishes nothing.\n\nSeeing the wire\n  --wire <file>         Append every frame, both directions, as JSON lines:\n                        { at, from, peer, frame }. AHPC_RECORD=<file> is\n                        the same thing from a shell.\n\nAppearance\n  --theme <name>        workbench, paper-light, ...\n  --shell <name>        The shell layout\n  --screen <name>       Which screen to open on\n  --bood                Let the creature loose on the whole screen. It\n                        keeps off the composer and off anything asking\n                        a question, and alt+g turns it off again.\n  --session <uri>       Open this session, by its URI or by an\n                        agent-host-session:// link\n\nStills, for a README or a test\n  --static, -s          One frame to stdout instead of running\n  --width, -w <n>       Columns\n  --height <n>          Rows\n  --unicode <level>     ascii, bmp, full\n  --colors <n>          0, 4, 8 or 24\n  --svg <file>          Write the still as SVG here\n  --tick <ms>           Milliseconds per scripted word\n  --settled             Run the script out before the frame\n  --pump <n>            Or exactly this many scripted words\n  --say <text>          Say this on the open session first\n  --approve             Answer the confirmation the script stops at\n  --answer              ...and then the question\n\n  --version, -v         What version this is\n  --help, -h            This\n\nCommands\n  ahpc <command> ...    Drive a host without the screen. 'ahpc help' lists\n                        them: sessions, prompts, approvals, terminals.\n";
 export declare function parse(argv: string[]): Options;
 /**
  * The screen.