@sigrun/tui 0.8.0 → 0.9.0

package/CHANGELOG.md

@@ -6,6 +6,12 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 
+## [0.9.0] - 2026-11-05
+
+- Decline on declinable interaction cards (`alt+s` in answer mode; `alt+d` is the
+  notices dismiss), the armed-hint chord, and the stepper review fixes (answer
+  labels, "Not answered yet" naming, Enter guard).
+
 ## [0.8.0] - 2026-11-04
 
 - Notices: an inline line for the current conversation's newest notice (a key dismisses

package/dist/actions.d.ts

@@ -63,6 +63,12 @@ export type Action = {
     readonly reverse: boolean;
 } | {
     readonly type: "answer-interaction";
+}
+/** Ask-user Task 5 (spec §5.2): decline the armed interaction record
+ *  (alt+s in every keymap — alt+d is the notices dismiss). Acts ONLY
+ *  in answer mode on a declinable record. */
+ | {
+    readonly type: "decline-interaction";
 } | {
     readonly type: "cancel-run";
 } | {

package/dist/api.d.ts

@@ -21,8 +21,8 @@ import type { NoticeActionResponse, NoticesResponse } from "@sigrun/shared/notic
 import type { JobsResponse, JobRunResponse } from "@sigrun/shared/views";
 import type { JobRevisionWire, JobRunWire } from "@sigrun/shared/jobs";
 import type { SessionMeta, SessionMetaPatch } from "@sigrun/shared/session-meta";
-import type { AbortResponse, AmbientList, CompactResponse, ConfigureResponse, ConversationCreateResponse, ConversationForkResponse, ConversationList, ConversationViewWire, InteractionAnswered, InteractionList, InteractionWire, MetaResponse, ModelsResponse, SettingsResponse, SettingsSectionsResponse, SubmissionResponse, WhoamiResponse } from "@sigrun/shared/views";
-export type { AbortResponse, AmbientList, AmbientWire, CompactResponse, ConfigureResponse, ConversationCreateResponse, ConversationForkResponse, ConversationList, ConversationSummary, ConversationViewWire, InteractionAnswered, InteractionList, InteractionWire, MetaResponse, ModelEntry, ModelsResponse, SettingsResponse, SettingsSectionsResponse, SettingsSectionEntry, SettingsSectionIndexEntry, SubmissionResponse, WhoamiResponse, } from "@sigrun/shared/views";
+import type { AbortResponse, AmbientList, CompactResponse, ConfigureResponse, ConversationCreateResponse, ConversationForkResponse, ConversationList, ConversationViewWire, InteractionAnswered, InteractionDeclined, InteractionList, InteractionWire, MetaResponse, ModelsResponse, SettingsResponse, SettingsSectionsResponse, SubmissionResponse, WhoamiResponse } from "@sigrun/shared/views";
+export type { AbortResponse, AmbientList, AmbientWire, CompactResponse, ConfigureResponse, ConversationCreateResponse, ConversationForkResponse, ConversationList, ConversationSummary, ConversationViewWire, InteractionAnswered, InteractionDeclined, InteractionList, InteractionWire, MetaResponse, ModelEntry, ModelsResponse, SettingsResponse, SettingsSectionsResponse, SettingsSectionEntry, SettingsSectionIndexEntry, SubmissionResponse, WhoamiResponse, } from "@sigrun/shared/views";
 export type { CommandRunResponse, CommandsResponse, SlashCommand } from "@sigrun/shared/commands";
 export type { JobSpec, JobSchedule, JobAction, JobWire, JobRunWire, JobRevisionWire, } from "@sigrun/shared/jobs";
 export type { JobsResponse, JobRunResponse } from "@sigrun/shared/views";
@@ -151,6 +151,12 @@ export declare class SigrunClient {
     getInteraction(id: number, callId: string): Promise<InteractionWire>;
     /** `POST .../interactions/:callId/answer` — the ONE generic answer route. */
     answerInteraction(id: number, callId: string, answer: InteractionAnswerInput): Promise<InteractionAnswered>;
+    /** `POST .../interactions/:callId/decline` — decline a pending
+     *  declinable record (ask-user spec §5.2; settles `skipped` with
+     *  `declinedVia: "button"`). A 404 `not_pending` means the record
+     *  settled under the user's fingers — the caller refetches through
+     *  {@link getInteraction} (the mid-stepper settle path). */
+    declineInteraction(id: number, callId: string): Promise<InteractionDeclined>;
     /** `GET /v1/conversations/:id/ambient`. */
     getAmbient(id: number): Promise<AmbientList>;
     /** `GET /v1/commands` — the slash-command catalog (a boot constant). */

package/dist/api.js

@@ -181,6 +181,14 @@ export class SigrunClient {
     answerInteraction(id, callId, answer) {
         return this.#send("POST", `/v1/conversations/${id}/interactions/${encodeURIComponent(callId)}/answer`, answer);
     }
+    /** `POST .../interactions/:callId/decline` — decline a pending
+     *  declinable record (ask-user spec §5.2; settles `skipped` with
+     *  `declinedVia: "button"`). A 404 `not_pending` means the record
+     *  settled under the user's fingers — the caller refetches through
+     *  {@link getInteraction} (the mid-stepper settle path). */
+    declineInteraction(id, callId) {
+        return this.#send("POST", `/v1/conversations/${id}/interactions/${encodeURIComponent(callId)}/decline`, {});
+    }
     /** `GET /v1/conversations/:id/ambient`. */
     getAmbient(id) {
         return this.#get(`/v1/conversations/${id}/ambient`);

package/dist/blocks/form/form.js

@@ -60,6 +60,21 @@ export function stepperSections(block, interaction) {
         child.type === "choice"));
     return allChoice ? sections : null;
 }
+/** The unanswered REQUIRED choices of the stepper (the review names
+ *  them and holds the submit — §7.2 of the ask-user design). Answered
+ *  means choiceValueText yields text (absent/""/[]/{other: ""} do not
+ *  count). */
+function unansweredSections(sections, ctx, values) {
+    return sections.filter((section) => {
+        for (const field of sectionFields(section)) {
+            if (field.type !== "choice" || field.required !== true)
+                continue;
+            if (choiceValueText(field, ctx, values[field.name] ?? null) === "")
+                return true;
+        }
+        return false;
+    });
+}
 /** The answerable fields of a stepper section (every field the review
  *  summarizes — §9.1's review step covers ALL of a section's fields,
  *  not only the choice). */
@@ -310,6 +325,9 @@ export class FormComponent {
                 const summary = answers.filter((text) => text !== "").join(", ");
                 lines.push(truncate(`  ${title}: ${summary}`, width));
             });
+            for (const section of unansweredSections(sections, this.#ctx, this.#values)) {
+                lines.push(truncate(`Not answered yet: ${bindText(section.title, this.#ctx)}`, width));
+            }
             if (!this.#readOnly && !this.#submitted) {
                 lines.push(truncate(`> [ ${this.#submitLabel} ]`, width));
             }
@@ -435,6 +453,10 @@ export class FormComponent {
                 return;
             }
             if (data === "\r" && !this.#submitted) {
+                // The review holds the submit while a required question is
+                // unanswered (§7.2) — Enter is ignored, not an error.
+                if (unansweredSections(sections, this.#ctx, this.#values).length > 0)
+                    return;
                 if (this.#submit())
                     this.#submitted = true;
             }

package/dist/keymaps/emacs.js

@@ -32,6 +32,7 @@ const BINDINGS = [
     { keys: "C-n / C-p", action: "move down / up" },
     { keys: "enter", action: "open / fold" },
     { keys: "C-o", action: "answer interaction" },
+    { keys: "M-s", action: "decline interaction (answer mode)" },
     { keys: "C-l", action: "redraw" },
     { keys: "C-h", action: "key reference" },
     { keys: "M-N", action: "notices" },
@@ -147,6 +148,10 @@ export function createEmacsKeymap() {
                 return { type: "prompt-jump", delta: 1 };
             if (data === "\x0f")
                 return { type: "answer-interaction" };
+            // Ask-user Task 5: M-s declines the armed interaction (M-d stays
+            // the notices dismiss; the app gates decline to answer mode).
+            if (data === "\x1bs")
+                return { type: "decline-interaction" };
             if (data === "\x0c")
                 return { type: "redraw" };
             if (data === "\x08")

package/dist/keymaps/standard.js

@@ -21,6 +21,7 @@ const BINDINGS = [
     { keys: "ctrl+n", action: "new conversation" },
     { keys: "ctrl+t", action: "cycle thinking" },
     { keys: "ctrl+o", action: "answer interaction" },
+    { keys: "alt+s", action: "decline interaction (answer mode)" },
     { keys: "ctrl+g", action: "notices" },
     { keys: "alt+d", action: "dismiss newest notice" },
     { keys: "ctrl+l", action: "redraw" },
@@ -60,6 +61,11 @@ export function createStandardKeymap() {
             return { type: "cycle-thinking" };
         if (matchesKey(data, Key.ctrl("o")))
             return { type: "answer-interaction" };
+        // Ask-user Task 5: alt+s declines the armed interaction (answer
+        // mode only — the app gates the action; outside answer mode this
+        // falls through as a no-op). alt+d stays the notices dismiss.
+        if (matchesKey(data, Key.alt("s")))
+            return { type: "decline-interaction" };
         // Notices Task 8: ctrl+g (the notices overlay — a control code,
         // never typed text) and alt+d (dismiss the inline notice; M-d is
         // readline's kill-word, a chord reserved readline never sends).

package/dist/keymaps/vim.js

@@ -47,6 +47,7 @@ const BINDINGS = [
     { keys: ":", action: "command line" },
     { keys: "ctrl+p", action: "conversation picker" },
     { keys: "ctrl+o", action: "answer interaction" },
+    { keys: "alt+s", action: "decline interaction (answer mode)" },
     { keys: "ctrl+l", action: "redraw" },
     { keys: "ctrl+c", action: "abort run (busy)" },
     { keys: "g?", action: "key reference" },
@@ -132,6 +133,10 @@ export function createVimKeymap(options) {
         }
         if (matchesKey(data, Key.ctrl("o")))
             return { type: "answer-interaction" };
+        // Ask-user Task 5: alt+s declines the armed interaction (the app
+        // gates the action to answer mode + a declinable record).
+        if (matchesKey(data, Key.alt("s")))
+            return { type: "decline-interaction" };
         return "pass";
     };
     /** Block-surface keys (spec §12.4): NORMAL mode over a `surface`

package/dist/ui/app.js

@@ -1149,6 +1149,10 @@ export class TuiApp {
                 if (!this.interactions.answerMode)
                     this.interactions.beginAnswer();
                 return;
+            case "decline-interaction":
+                // Gated inside: answer mode + a declinable record only.
+                await this.interactions.decline();
+                return;
             case "cancel-run":
                 this.#abortActive();
                 return;

package/dist/ui/interactions.d.ts

@@ -79,6 +79,18 @@ export declare class InteractionPrompter implements Component {
      * keep typing while a prompt waits).
      */
     handleKey(data: string): boolean;
+    /**
+     * Decline the armed interaction (ask-user spec §5.2 — the keymap's
+     *  `decline-interaction` action routes here). Gated exactly like the
+     *  affordance: answer mode armed on the top record, and the record is
+     *  declinable. Success exits answer mode (the list poll drops the
+     *  settled record). A 404 `not_pending` — the record settled under
+     *  the user's fingers — refetches through
+     *  {@link SigrunClient.getInteraction} and swaps the settled envelope
+     *  in read-only (the mid-edit settle path); any other failure reports
+     *  loud and keeps the card writable.
+     */
+    decline(): Promise<void>;
     /** Detach (the app calls this on dispose): stale fetches never land. */
     dispose(): void;
     /**

package/dist/ui/interactions.js

@@ -174,6 +174,13 @@ export class InteractionPrompter {
             this.#changed();
             return true;
         }
+        // The decline chord is the KEYMAP's (decline-interaction action,
+        // dispatched by the launcher): pass it through so the keymap sees
+        // it — the surface fall-through below would swallow it and the
+        // chord would never fire (review fix; the same ownership rule as
+        // the prompt's other action keys).
+        if (matchesKey(data, Key.alt("s")))
+            return false;
         this.#ensureSurface(top);
         if (this.#surface === undefined) {
             this.#exitAnswer();
@@ -332,6 +339,67 @@ export class InteractionPrompter {
         this.#answerMode = false;
         this.#answerCallId = undefined;
     }
+    /**
+     * Decline the armed interaction (ask-user spec §5.2 — the keymap's
+     *  `decline-interaction` action routes here). Gated exactly like the
+     *  affordance: answer mode armed on the top record, and the record is
+     *  declinable. Success exits answer mode (the list poll drops the
+     *  settled record). A 404 `not_pending` — the record settled under
+     *  the user's fingers — refetches through
+     *  {@link SigrunClient.getInteraction} and swaps the settled envelope
+     *  in read-only (the mid-edit settle path); any other failure reports
+     *  loud and keeps the card writable.
+     */
+    async decline() {
+        const top = this.#pending[0];
+        if (!this.#answerMode || top === undefined)
+            return;
+        if (this.#answerCallId !== top.callId)
+            return;
+        if (top.declinable !== true)
+            return;
+        const id = this.#conversationId;
+        if (id === undefined)
+            return;
+        try {
+            await this.#client.declineInteraction(id, top.callId);
+        }
+        catch (cause) {
+            const isNotPending = typeof cause === "object" &&
+                cause !== null &&
+                cause.status === 404;
+            if (!isNotPending) {
+                this.onError?.(describeCommandError("decline", cause));
+                this.#changed();
+                return;
+            }
+            // 404 not_pending: the settle raced the user. Refetch; a still-
+            // pending record must NOT wedge the card read-only.
+            try {
+                const fresh = await this.#client.getInteraction(id, top.callId);
+                if (this.#surface?.record.callId !== top.callId)
+                    return;
+                if (fresh.status === "pending") {
+                    this.onError?.(describeCommandError("decline", cause));
+                    this.#changed();
+                    return;
+                }
+                this.#surface =
+                    this.#surface === undefined
+                        ? undefined
+                        : { ...this.#surface, settled: fresh, access: "read" };
+                this.#surface?.state.setAccess("read");
+            }
+            catch {
+                this.onError?.(describeCommandError("decline", cause));
+                this.#changed();
+                return;
+            }
+        }
+        this.#exitAnswer();
+        void this.#refresh();
+        this.#changed();
+    }
     /** Generation-guarded, coalesced fetch of the pending list. */
     async #refresh() {
         const id = this.#conversationId;
@@ -408,11 +476,18 @@ export class InteractionPrompter {
             return [];
         const lines = [];
         const shown = this.#surface?.settled ?? top;
+        // Settled declines name their outcome (spec §5.2's "declined" /
+        // "declined — replied in chat"), never the raw 'skipped'.
+        const statusText = shown.status === "skipped" && shown.declinedVia !== undefined
+            ? shown.declinedVia === "message"
+                ? "declined — replied in chat"
+                : "declined"
+            : shown.status;
         const suffix = this.#answerMode
             ? " — answering"
             : shown.status === "pending"
                 ? ""
-                : ` — ${shown.status}`;
+                : ` — ${statusText}`;
         lines.push(`[interaction] ${shown.kind}${suffix}`);
         if (top.body !== undefined) {
             this.#ensureSurface(top);
@@ -428,7 +503,9 @@ export class InteractionPrompter {
         }
         if (top.body !== undefined) {
             lines.push(this.#answerMode
-                ? "1-9 answer · Tab next · esc cancel"
+                ? top.declinable === true
+                    ? "1-9 answer · alt+s decline · Tab next · esc cancel"
+                    : "1-9 answer · Tab next · esc cancel"
                 : "ctrl+o to answer");
         }
         return lines;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@sigrun/tui",
-	"version": "0.8.0",
+	"version": "0.9.0",
 	"description": "sigrun terminal client (pi-tui based) over the \u00a75 API \u2014 spawned by the sigrun CLI, or standalone against a server URL",
 	"type": "module",
 	"bin": {
@@ -21,7 +21,7 @@
 	},
 	"dependencies": {
 		"@earendil-works/pi-tui": "^1.3.0",
-		"@sigrun/shared": "0.8.0"
+		"@sigrun/shared": "0.9.0"
 	},
 	"devDependencies": {
 		"typescript": "^7.0.2",
@@ -48,4 +48,4 @@
 		"access": "public",
 		"provenance": true
 	}
-}
+}