@mlpal/yodex-ui 0.1.0 → 0.2.1

package/README.md

@@ -34,9 +34,14 @@ function Chat({ url, token }: { url: string; token?: string }) {
   prompts, run status, usage, session and model lists.
 - The reducer and client are framework-free (`YodexClient`, `reduce`, `applyEvent`) for hosts that
   are not React.
-- Styling: Tailwind utilities compiled against the Obsidian Intelligence token names
+- Hosts that virtualize the transcript render `TranscriptRow` per item; `ApprovalPrompt` shows
+  `state.pendingApproval`; `PermissionPrompt` takes `onAllowSession` (the hook's `allowForSession`)
+  and opt-in `hotkeys` for the one prompt that should own `a`/`d`; the Composer steers a live run
+  through `onSteer` (the hook's `steer`) and takes `value`/`onChange`, `initialValue`, `hideAttach`,
+  `submitOnEnter` (defaults to keyboards only).
+- Styling: `styles.css` carries only utilities (no preflight, no Tailwind theme on `:root`), compiled against the Obsidian Intelligence token names
   (`--background`, `--primary`, `--muted`, `--success`, `--warning`, `--info`, …). Every component
   works at 390 px width with 44 px touch targets.
-- Forward-compatible with serve `yodex/2`: `run{hop, cwd}`, `question_request` / `question_response`,
-  `approval_response` and the extra `list_sessions` fields are rendered when the server sends them
-  and ignored by a `yodex/1` server.
+- `state.capabilities` mirrors `ready.capabilities` ("questions", "approval", "attachments",
+  "sessions_v2", …): the hook refuses attachments the server cannot take, `QuestionForm` and the
+  approval controls only ever show when the server asks, and a `yodex/1` server still works.

package/dist/client/client.d.ts

@@ -1,4 +1,4 @@
-import type { ClientMessage, ServerMessage } from "@mlpal/harness-protocol";
+import type { ClientMessage, ContentBlock, ServerMessage } from "@mlpal/harness-protocol";
 import type { AskOutcome, ConnectionState, IncomingMessage } from "./types";
 /** The subset of the WebSocket API the client uses, so tests can inject a fake. */
 export interface SocketLike {
@@ -17,26 +17,14 @@ export interface RunOptions {
     sessionId?: string;
     model?: string;
     mode?: string;
-    /** yodex/2: per-run HOP and working directory. Ignored by a yodex/1 server. */
+    /** yodex/2: the HOP for this run (must be the server's own unless it claims "hop_per_run"),
+     *  the working directory under the workspace root, and attachments ("attachments"). */
     hop?: string;
     cwd?: string;
+    blocks?: ContentBlock[];
 }
-/** Outgoing messages: yodex/1 plus the yodex/2 additions. */
-export type OutgoingMessage = ClientMessage | (Extract<ClientMessage, {
-    type: "run";
-}> & {
-    hop?: string;
-    cwd?: string;
-}) | {
-    type: "question_response";
-    id: string;
-    outcome: AskOutcome;
-} | {
-    type: "approval_response";
-    sessionId: string;
-    decision: "allow" | "deny";
-    reason?: string;
-};
+/** Outgoing messages: the protocol's ClientMessage (yodex/2, additive over yodex/1). */
+export type OutgoingMessage = ClientMessage;
 export interface YodexClientOptions {
     /** ws:// or wss:// URL of `yodex serve`'s /ws endpoint. */
     url: string;
@@ -121,5 +109,11 @@ export declare class YodexClient {
         requestId?: string;
         sessionId: string;
         messages: import("@mlpal/harness-protocol").SDKMessage[];
+        pendingQuestion?: {
+            id: string;
+            questions: import("@mlpal/harness-protocol").AskQuestion[];
+        };
+        pendingApproval?: import("@mlpal/harness-protocol").PendingApproval;
+        live?: boolean;
     }>;
 }

package/dist/client/types.d.ts

@@ -1,4 +1,5 @@
-import type { Author, ContentBlock, ResultEvent, ServerMessage, SessionSummary, ToolResultBlocks, Usage } from "@mlpal/harness-protocol";
+import type { AskQuestion, Author, ContentBlock, PendingApproval, ResultEvent, ServerCapability, ServerMessage, SessionSummary, ToolResultBlocks, Usage } from "@mlpal/harness-protocol";
+export type { AskAnswer, AskOption, AskOutcome, AskQuestion, PendingApproval, ServerCapability } from "@mlpal/harness-protocol";
 /** One rendered row of a session's transcript. Built by the reducer from the wire events. */
 export type TranscriptItem = {
     kind: "user";
@@ -58,28 +59,9 @@ export interface PendingPermission {
     sessionId: string;
     toolName: string;
     input: Record<string, unknown>;
-}
-/** The AskUserQuestion schema (harness tools/builtin/ask.ts), mirrored here until the wire
- *  protocol carries it. `question_request` / `question_response` land with serve yodex/2. */
-export interface AskOption {
-    label: string;
-    description?: string;
-    preview?: string;
-}
-export interface AskQuestion {
-    question: string;
-    header?: string;
-    multiSelect?: boolean;
-    options?: AskOption[];
-}
-export interface AskAnswer {
-    question: string;
-    answers: string[];
-    note?: string;
-}
-export interface AskOutcome {
-    declined: boolean;
-    answers: AskAnswer[];
+    /** Why the policy asked (yodex/2): a mode rule, or a HOP safety reason code. */
+    reason?: string;
+    safetyReason?: string;
 }
 export interface PendingQuestion {
     id: string;
@@ -90,6 +72,15 @@ export type ConnectionState = "connecting" | "connected" | "reconnecting" | "clo
 export interface SessionState {
     connection: ConnectionState;
     protocol?: string;
+    /** What the server serves beyond yodex/1 (ready.capabilities); empty on a yodex/1 server. */
+    capabilities: ServerCapability[];
+    /** The server's HOP and workspace root, from ready. */
+    hop?: string;
+    rootCwd?: string;
+    /** A run is streaming on this session on another connection (load_session.live). */
+    liveElsewhere?: boolean;
+    /** The last run parked at the safety edge; `approve` resumes it. */
+    pendingApproval?: PendingApproval;
     sessionId?: string;
     model?: string;
     cwd?: string;
@@ -114,17 +105,8 @@ export interface SessionState {
     /** The last transport or server error, cleared on the next run. */
     error?: string;
 }
-/** Forward-compatible view of the server stream: yodex/1 messages plus the yodex/2 additions
- *  this package already renders (question round-trips). Unknown messages are ignored. */
-export type IncomingMessage = ServerMessage | {
-    type: "question_request";
-    id: string;
-    sessionId: string;
-    questions: AskQuestion[];
-} | {
-    type: "question_cleared";
-    id: string;
-};
+/** The server stream (yodex/2, additive over yodex/1). Unknown messages are ignored. */
+export type IncomingMessage = ServerMessage;
 export type SessionAction = {
     type: "connection";
     state: ConnectionState;

package/dist/client/useYodexSession.d.ts

@@ -26,6 +26,12 @@ export interface YodexSession {
     deny: (permissionId: string, reason?: string) => void;
     answer: (questionId: string, outcome: AskOutcome) => void;
     approve: (decision: "allow" | "deny", reason?: string) => void;
+    /** Allow this tool (and, for Bash, this exact command) without asking again while this hook lives. */
+    allowForSession: (permissionId: string) => void;
+    /** Steer a running session: the text reaches the agent at its next turn boundary. */
+    steer: (text: string) => void;
+    /** What the run is waiting on, for the status row. */
+    waitingOn?: "permission" | "question";
     loadSession: (sessionId: string) => Promise<void>;
     refreshSessions: () => Promise<void>;
     refreshModels: () => Promise<void>;

package/dist/components/ApprovalPrompt.d.ts

@@ -0,0 +1,7 @@
+import type { PendingApproval } from "@mlpal/harness-protocol";
+/** The last run stopped at the HOP's safety edge (needs_approval). Approve to resume, or decline. */
+export declare function ApprovalPrompt({ approval, onDecide, className }: {
+    approval: PendingApproval;
+    onDecide: (decision: "allow" | "deny", reason?: string) => void;
+    className?: string;
+}): import("react").JSX.Element;

package/dist/components/Composer.d.ts

@@ -13,9 +13,18 @@ export interface HopOption {
 }
 export interface ComposerProps {
     onSubmit: (text: string, attachments: ComposerAttachment[]) => void;
-    /** While a run is live the send button becomes Stop. */
+    /** While a run is live the send button becomes Stop; with `onSteer`, typed text sends as a steer instead. */
     running?: boolean;
     onStop?: () => void;
+    onSteer?: (text: string) => void;
+    /** Controlled text (with onChange), or `initialValue` to prefill once. */
+    value?: string;
+    onChange?: (text: string) => void;
+    initialValue?: string;
+    /** Enter sends on keyboards; on touch devices the send button does (Shift+Enter always breaks a line).
+     *  Force one behaviour with true / false. */
+    submitOnEnter?: boolean;
+    hideAttach?: boolean;
     disabled?: boolean;
     /** Shown as a placeholder reason while disabled, e.g. "Workspace is waking up". */
     disabledReason?: string;
@@ -29,9 +38,4 @@ export interface ComposerProps {
     className?: string;
     autoFocus?: boolean;
 }
-/**
- * The input: a growing textarea, Enter sends and Shift+Enter breaks a line, images paste or
- * drop in as attachments, a HOP picker slot, Stop while running, and an outside-controlled
- * disabled state for a sleeping workspace.
- */
-export declare function Composer({ onSubmit, running, onStop, disabled, disabledReason, placeholder, hopOptions, hop, onHopChange, leading, maxAttachmentBytes, className, autoFocus }: ComposerProps): import("react").JSX.Element;
+export declare function Composer({ onSubmit, running, onStop, onSteer, value, onChange, initialValue, submitOnEnter, hideAttach, disabled, disabledReason, placeholder, hopOptions, hop, onHopChange, leading, maxAttachmentBytes, className, autoFocus }: ComposerProps): import("react").JSX.Element;

package/dist/components/PermissionPrompt.d.ts

@@ -1,9 +1,14 @@
 import type { PendingPermission } from "../client/types";
 export declare function permissionSummary(p: PendingPermission): string;
-/** The engine asks before a tool runs. Allow / Deny, with `a` / `d` as keys while focused. */
-export declare function PermissionPrompt({ request, onAllow, onDeny, className }: {
+export interface PermissionPromptProps {
     request: PendingPermission;
     onAllow: (id: string) => void;
     onDeny: (id: string, reason?: string) => void;
+    /** Shown as a third choice when given (the hook's allowForSession). */
+    onAllowSession?: (id: string) => void;
+    /** `a` / `d` answer this prompt while focus is outside an input. Enable on one prompt at a time. */
+    hotkeys?: boolean;
     className?: string;
-}): import("react").JSX.Element;
+}
+/** The engine asks before a tool runs: Allow, Allow for this session, or Deny with an optional reason. */
+export declare function PermissionPrompt({ request, onAllow, onDeny, onAllowSession, hotkeys, className }: PermissionPromptProps): import("react").JSX.Element;

package/dist/components/RunStatus.d.ts

@@ -4,6 +4,8 @@ export interface RunStatusProps {
     running: boolean;
     startedAt?: number;
     activity?: string;
+    /** The run is waiting on the person; shown instead of the activity. */
+    waitingOn?: "permission" | "question";
     lastResult?: ResultEvent;
     usageTotal?: Usage;
     connection?: ConnectionState;
@@ -14,4 +16,4 @@ export interface RunStatusProps {
     now?: () => number;
 }
 /** One row: what the agent is doing with elapsed time while running; the result line after. */
-export declare function RunStatus({ running, startedAt, activity, lastResult, usageTotal, connection, onStop, onApprove, className, now }: RunStatusProps): import("react").JSX.Element | null;
+export declare function RunStatus({ running, startedAt, activity, waitingOn, lastResult, usageTotal, connection, onStop, onApprove, className, now }: RunStatusProps): import("react").JSX.Element | null;

package/dist/components/SessionList.d.ts

@@ -1,14 +1,7 @@
 import type { SessionSummary } from "@mlpal/harness-protocol";
-/** A yodex/1 SessionSummary plus the yodex/2 fields when the server sends them. */
-export interface SessionRow extends SessionSummary {
-    name?: string;
-    hop?: string;
-    cwd?: string;
-    relCwd?: string;
-    projectName?: string;
-    lastMessagePreview?: string;
-    pendingQuestion?: boolean;
-}
+/** A SessionSummary; the yodex/2 fields (hop, relCwd, projectName, …) are present when the
+ *  server claims "sessions_v2". */
+export type SessionRow = SessionSummary;
 export declare function groupSessions(rows: SessionRow[]): Array<{
     project: string;
     rows: SessionRow[];

package/dist/components/Transcript.d.ts

@@ -9,4 +9,11 @@ export interface TranscriptProps {
     emptyState?: React.ReactNode;
     className?: string;
 }
+/** One transcript row. Exported so a host that virtualizes the list renders the same markup. */
+export declare function TranscriptRow({ item, onOpenFile }: {
+    item: TranscriptItem;
+    onOpenFile?: (path: string) => void;
+}): import("react").JSX.Element;
+/** The whole transcript in a scrolling column. For long sessions a host may virtualize with
+ *  TranscriptRow instead; announcements belong to RunStatus, not to the log itself. */
 export declare function Transcript({ items, autoScroll, onOpenFile, footer, emptyState, className }: TranscriptProps): import("react").JSX.Element;

package/dist/index.d.ts

@@ -2,11 +2,12 @@ export * from "./client/types";
 export { YodexClient, type YodexClientOptions, type RunOptions, type SocketLike, type SocketFactory, type OutgoingMessage } from "./client/client";
 export { reduce, applyEvent, initialState, elapsedLabel, resultLabel, formatTokens } from "./client/reducer";
 export { useYodexSession, type UseYodexSessionOptions, type YodexSession, type Attachment } from "./client/useYodexSession";
-export { Transcript, type TranscriptProps } from "./components/Transcript";
+export { Transcript, TranscriptRow, type TranscriptProps } from "./components/Transcript";
 export { AssistantMessage } from "./components/AssistantMessage";
 export { ToolCall, toolSummary } from "./components/ToolCall";
 export { DiffView, diffCounts } from "./components/DiffView";
-export { PermissionPrompt, permissionSummary } from "./components/PermissionPrompt";
+export { PermissionPrompt, permissionSummary, type PermissionPromptProps } from "./components/PermissionPrompt";
+export { ApprovalPrompt } from "./components/ApprovalPrompt";
 export { QuestionForm, buildOutcome, type QuestionDraft } from "./components/QuestionForm";
 export { PlanChecklist } from "./components/PlanChecklist";
 export { RunStatus } from "./components/RunStatus";