@mlpal/yodex-ui 0.2.0 → 0.2.2

package/README.md

@@ -34,7 +34,12 @@ 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.
 - `state.capabilities` mirrors `ready.capabilities` ("questions", "approval", "attachments",

package/dist/client/rules.d.ts

@@ -0,0 +1,12 @@
+import type { PendingPermission } from "./types";
+/** The hook's session-scoped allow rules: a tool name plus, for commands, the exact command. */
+export type SessionRule = string;
+export declare function ruleFor(p: Pick<PendingPermission, "toolName" | "input">): SessionRule;
+/** Whether a session rule may answer this ask. A safety-flagged ask is never a rule's to answer:
+ *  the person sees it, every time. */
+export declare function ruleAnswers(rules: ReadonlySet<SessionRule>, ask: Pick<PendingPermission, "toolName" | "input" | "safetyReason">): boolean;
+export declare function revokeRules(rules: Set<SessionRule>, toolName: string): void;
+/** A changed sessionId prop switches the view only when it names a session other than the one
+ *  the hook already owns: a host passing back the id a new session was given on system.init is
+ *  not a switch, and must not drop the running stream. */
+export declare function switchesSession(nextProp: string | undefined, lastProp: string | undefined, owned: string | undefined): boolean;

package/dist/client/types.d.ts

@@ -59,6 +59,9 @@ export interface PendingPermission {
     sessionId: string;
     toolName: string;
     input: Record<string, unknown>;
+    /** Why the policy asked (yodex/2): a mode rule, or a HOP safety reason code. */
+    reason?: string;
+    safetyReason?: string;
 }
 export interface PendingQuestion {
     id: string;

package/dist/client/useYodexSession.d.ts

@@ -26,6 +26,16 @@ 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.
+     *  A later ask that carries a safety reason is never answered by such a rule: it is shown. */
+    allowForSession: (permissionId: string) => void;
+    /** Drop session rules: one tool's, or all of them, without remounting (no reconnect, no replay). */
+    revokeSessionRule: (toolName: string) => void;
+    clearSessionRules: () => 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/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,14 +2,16 @@ 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";
 export { SessionList, groupSessions, type SessionRow } from "./components/SessionList";
 export { Composer, type ComposerProps, type ComposerAttachment, type HopOption } from "./components/Composer";
 export { cn } from "./components/cn";
+export { ruleFor, ruleAnswers, revokeRules, switchesSession } from "./client/rules";