@softov/ahpc 0.2.0 → 0.4.0

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  --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.

package/dist/src/tui.js

@@ -2,6 +2,7 @@ import { WRITER_KEY, createApp } from '@textui/core';
 import { writeFile } from 'node:fs/promises';
 import { bufferToSvg, createNodeTerminal, createWriter, renderStill, } from '@textui/terminal';
 import { registerChat } from './app.js';
+import { parseSessionLink } from './links.js';
 import { CONTROLLER } from './control.js';
 import { connect, sink } from './connect.js';
 import { loadConfig } from './config.js';
@@ -30,6 +31,11 @@ What this client serves back
                         terminal attached this prints one frame and exits,
                         so a background shell publishes nothing.
 
+Seeing the wire
+  --wire <file>         Append every frame, both directions, as JSON lines:
+                        { at, from, peer, frame }. AHPC_RECORD=<file> is
+                        the same thing from a shell.
+
 Appearance
   --theme <name>        workbench, paper-light, ...
   --shell <name>        The shell layout
@@ -37,7 +43,8 @@ Appearance
   --bood                Let the creature loose on the whole screen. It
                         keeps off the composer and off anything asking
                         a question, and alt+g turns it off again.
-  --session <uri>       Open this session
+  --session <uri>       Open this session, by its URI or by an
+                        agent-host-session:// link
 
 Stills, for a README or a test
   --static, -s          One frame to stdout instead of running
@@ -53,6 +60,7 @@ Stills, for a README or a test
   --approve             Answer the confirmation the script stops at
   --answer              ...and then the question
 
+  --version, -v         What version this is
   --help, -h            This
 
 Commands
@@ -147,6 +155,9 @@ export function parse(argv) {
             case '--publish-writable':
                 options.publishWritable = true;
                 break;
+            case '--wire':
+                options.wire = String(argv[++i]);
+                break;
             case '--help':
             case '-h':
                 options.help = true;
@@ -197,10 +208,15 @@ async function still(options) {
         // of scripted words rather than all of them, and the caret is wherever the
         // agent had got to. `--settled` runs until the script has nothing left it
         // can do without being answered, which is how the confirmation is reached.
-        before: (app) => {
+        before: async (app) => {
             const controller = app.services.require(CONTROLLER);
-            if (options.session)
-                controller.open(options.session);
+            // A URI, or the link the reference host's tools answer with.
+            if (options.session) {
+                if (parseSessionLink(options.session))
+                    await controller.openLink(options.session);
+                else
+                    controller.open(options.session);
+            }
             /*
              * Pushed when asked for, and not otherwise.
              *
@@ -345,6 +361,15 @@ export async function tui(argv) {
     app.services.provide(WRITER_KEY, createWriter(terminal.capabilities()));
     sink.report = (message) => reportHostError(app.store, message);
     await app.start();
+    // `--session`, on the screen as well as in a still: the conversation named,
+    // by its URI or by an `agent-host-session://` link, opened on arrival.
+    if (options.session) {
+        const controller = app.services.require(CONTROLLER);
+        const named = options.session;
+        const opened = parseSessionLink(named) ? controller.openLink(named) : (controller.open(named), Promise.resolve(true));
+        void opened.then((ok) => { if (ok)
+            app.screens.push('chat'); });
+    }
     /**
      * The last resort, and the reason it exists at all.
      *

package/dist/src/version.d.ts

@@ -0,0 +1,2 @@
+/** The version in the nearest `package.json`, or `unknown` where there is none. */
+export declare const version: () => string;

package/dist/src/version.js

@@ -0,0 +1,38 @@
+/*
+ * What version this is, read from the manifest rather than written twice.
+ *
+ * A literal in the source is a literal that drifts: the one in `mcp/serve.ts`
+ * said 0.1 while the package said 0.2 within a day of being written, and a
+ * `--version` that lies is worse than no `--version` at all.
+ *
+ * Found by walking up from this module rather than by a fixed relative path,
+ * because the depth differs: `src/version.ts` in a checkout and
+ * `dist/src/version.js` in an install, and neither should have to know which
+ * it is. `package.json` is always at the package root and npm always ships
+ * it, so the first one above this file is the right one.
+ *
+ * This file imports nothing but Node, on purpose. The entry point answers
+ * `--version` before it decides which front end to load, and loading one to
+ * answer it would make the fastest question the slowest.
+ */
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/** The version in the nearest `package.json`, or `unknown` where there is none. */
+export const version = () => {
+    let at = dirname(fileURLToPath(import.meta.url));
+    for (;;) {
+        try {
+            const found = JSON.parse(readFileSync(join(at, 'package.json'), 'utf8'));
+            if (typeof found.version === 'string')
+                return found.version;
+        }
+        catch { /* not this directory */ }
+        const up = dirname(at);
+        // The root of the filesystem, which means there is no manifest anywhere
+        // above this file - a bundler inlined it, or something unpacked it wrong.
+        if (up === at)
+            return 'unknown';
+        at = up;
+    }
+};

package/dist/src/view/creature.d.ts

@@ -43,18 +43,6 @@ export type { CreatureProps, Form, Mood } from './bood/index.js';
  * that matches the status row above it.
  */
 export declare function moodOf(activity: Activity): Mood;
-/**
- * Say which row this component starts at, so nothing stands on top of it.
- *
- * Its top row rather than its height: the row is where the thing actually is,
- * and a height has to be added to a guess about everything below it to mean
- * anything. Published rather than assumed because it moves - the composer
- * grows a slash menu upward and grows again with a wrapped draft, and the
- * block that asks about a tool is only there while something is waiting.
- * Cleared on the way out, or a screen that had one would keep making room for
- * it after it had gone.
- */
-export declare function useFloorTop(key: string, row: number): void;
 /**
  * One animal per run, rather than one per component that draws one.
  *

package/dist/src/view/creature.js

@@ -25,8 +25,6 @@
  * instead of being the big one shrunk.
  */
 import { BOOD, boodHeight, livelyNames } from './bood/index.js';
-import { useApp, useEffect } from '@textui/core';
-import { boodFloorFor } from '../state.js';
 export { BoodSprite, Creature, MOODS, FORMS, creatureFrames, creatureMotion, creatureSize, drawCreature, livelyNames, } from './bood/index.js';
 /**
  * What the figure is doing, from what the session is doing.
@@ -48,24 +46,6 @@ export function moodOf(activity) {
             : activity === 'input' ? 'thinking'
                 : 'happy';
 }
-/**
- * Say which row this component starts at, so nothing stands on top of it.
- *
- * Its top row rather than its height: the row is where the thing actually is,
- * and a height has to be added to a guess about everything below it to mean
- * anything. Published rather than assumed because it moves - the composer
- * grows a slash menu upward and grows again with a wrapped draft, and the
- * block that asks about a tool is only there while something is waiting.
- * Cleared on the way out, or a screen that had one would keep making room for
- * it after it had gone.
- */
-export function useFloorTop(key, row) {
-    const app = useApp();
-    useEffect(() => {
-        app.store.set(boodFloorFor(key), row);
-        return () => app.store.set(boodFloorFor(key), 0);
-    }, [key, row]);
-}
 /**
  * One animal per run, rather than one per component that draws one.
  *