camouflage-tui 2.2.2-beta.1 → 2.3.0-beta.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "camouflage-tui",
-  "version": "2.2.2-beta.1",
+  "version": "2.3.0-beta.1",
   "description": "High-performance terminal renderer for AI agent applications. A React Ink alternative built for streaming, persistence, and replay.",
   "license": "Apache-2.0",
   "type": "module",

package/src/binding.d.ts

@@ -212,6 +212,8 @@ export interface CamouflageHandle extends EventEmitter {
   on(event: "wizardCancelled", listener: (resp: WizardCancelledEvent) => void): this;
   on(event: "modeChangeRequested", listener: (resp: { direction: "next" | "prev" }) => void): this;
   on(event: "cancelRequested", listener: () => void): this;
+  /** The user is typing a path after `@`; answer with MentionCandidatesRegistered { for_query, candidates }. */
+  on(event: "mentionQuery", listener: (q: { query: string }) => void): this;
   on(event: "event", listener: (ev: Event) => void): this;
   on(event: "invalid", listener: (info: InvalidEvent) => void): this;
   on(event: "stderr", listener: (chunk: string) => void): this;

package/src/binding.js

@@ -342,6 +342,8 @@ export async function mount(opts = {}) {
         process.stderr.write(`[sdk:esc] CancelRequested line arrived, emitting cancelRequested\n`);
       }
       handle.emit("cancelRequested", {});
+    } else if (ev.event_type === "MentionQuery") {
+      handle.emit("mentionQuery", { query: ev.payload?.query ?? "" });
     }
     // Always also emit the raw Event for advanced consumers.
     handle.emit("event", ev);

package/src/types.d.ts

@@ -51,7 +51,8 @@ export type EventType =
   | "CancelRequested"
   | "TranscriptCleared"
   | "Splash"
-  | "ShowToast";
+  | "ShowToast"
+  | "MentionQuery";
 
 export type Direction = "inbound" | "outbound";
 
@@ -194,16 +195,32 @@ export type MentionCandidate = {
   label?: string;
   kind?: string;
 };
-export type MentionCandidatesRegistered = { candidates: MentionCandidate[] };
+export type MentionCandidatesRegistered = {
+  candidates: MentionCandidate[];
+  /** Set when answering a MentionQuery: the directory part these entries are
+   *  for (e.g. "../"). Without it the list replaces the default candidates. */
+  for_query?: string;
+};
 
 export type SelectListOption = {
   value: string;
   label: string;
+  /** Dim text after the label; also searched. */
   description?: string;
+  /** Group header shown above the first option of each group (hidden while searching). */
+  section?: string;
+  /** Values drawn in aligned columns after the label, e.g. ["256k", "$0.60 / $2.50"]. */
+  columns?: string[];
+  /** Draws an on/off badge, e.g. for enabled skills. */
+  state?: "on" | "off";
+  /** Extra text the search matches against. */
+  keywords?: string;
 };
 export type ShowSelectList = {
   id: string;
   prompt: string;
+  /** A dim line under the prompt. */
+  subtitle?: string;
   options: SelectListOption[];
   default?: string;
   allow_filter?: boolean;
@@ -325,6 +342,13 @@ export type ShowToast = {
   ttl_ms?: number;
 };
 
+/**
+ * Renderer → host: the user is typing a path after `@` (`./`, `../`, `~`,
+ * `/`). Answer with MentionCandidatesRegistered `{ for_query, candidates }`
+ * listing that directory; folder tokens end in "/".
+ */
+export type MentionQuery = { query: string };
+
 /** A diff to show inline: full before/after text, or a unified diff. */
 export type DiffPayload = {
   path: string;
@@ -378,6 +402,7 @@ export type Event = EnvelopeMeta &
     | { event_type: "TranscriptCleared"; payload?: Record<string, never> }
     | { event_type: "Splash"; payload: Splash }
     | { event_type: "ShowToast"; payload: ShowToast }
+    | { event_type: "MentionQuery"; payload: MentionQuery }
   );
 
 /** The payload type for a given event type, e.g. `PayloadOf<"ShowToast">`. */

package/src/types.js

@@ -22,7 +22,7 @@ const KNOWN_TYPES = new Set([
   "ShowForm", "FormResponse",
   "ShowWizard", "WizardCompleted", "WizardCancelled",
   "ModeChangeRequested", "CancelRequested",
-  "TranscriptCleared", "Splash", "ShowToast",
+  "TranscriptCleared", "Splash", "ShowToast", "MentionQuery",
 ]);
 
 /**