@prettier-ai/dsh-client-ui-user-questions 0.1.2-alpha.1

package/lib/index.js

@@ -0,0 +1,16 @@
+//#region lib/types/index.js
+/**
+* Web question plugin, node half.
+*
+* Deliberately empty. Mounting `ask_user_question` here put it in the tools
+* registry's GLOBAL layer, so every agent saw it no matter which preset
+* composed it — a two-tool benchmark preset actually presented three, and a
+* locally authored `bash-only` preset presented two. Rendering a question is
+* a host UI capability; having the tool is an agent capability, and only a
+* preset decides that. The `tool-ask-user` row belongs in the presets that
+* want it (and in the TUI composition, which has no presets).
+*/
+/** Host plugin body — the model-facing tool is composed per preset, not here. */
+function apply() {}
+//#endregion
+export { apply };

package/lib/invariant.js

@@ -0,0 +1,24 @@
+//#region lib/types/invariant.js
+/**
+* Package-owned invariant companion for `@prettier-ai/dsh-client-ui-user-questions`.
+* @module @prettier-ai/dsh-client-ui-user-questions/invariant
+*/
+const PACKAGE_NAME = "@prettier-ai/dsh-client-ui-user-questions";
+/** Cordis companion plugin name. */
+const name = "client-ui-user-questions-invariant";
+/** Service required before the companion can reserve package ownership. */
+const inject = ["invariants"];
+/**
+* No runtime invariant: tool and slot registrations are effects
+* owned and observed by their respective registries; the host pending table is
+* exercised through the public wire protocol.
+*/
+const install = () => {};
+/**
+* Register this package's invariant companion.
+* @param ctx - Cordis context carrying the invariant service.
+* @returns The installed registration's disposer after setup succeeds.
+*/
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//#endregion
+export { apply, inject, name };

package/lib/types/client/PlanReviewPanel.d.ts

@@ -0,0 +1,14 @@
+import type { PendingQuestion, PlanReview, QuestionComposerProps } from './contract/slots.ts';
+/** The panel's own props: the question domain face, the narrowed review, and the locale seat. */
+export type PlanReviewPanelProps = {
+    pending: PendingQuestion;
+    review: PlanReview;
+} & Pick<QuestionComposerProps, 't'>;
+/**
+ * Render a plan review as a decision card.
+ *
+ * @param props - the question domain face, the narrowed plan review, and `t`.
+ * @returns The plan-review takeover for this request.
+ */
+export declare function PlanReviewPanel({ pending, review, t }: PlanReviewPanelProps): import("react").JSX.Element;
+//# sourceMappingURL=PlanReviewPanel.d.ts.map

package/lib/types/client/QuestionComposer.d.ts

@@ -0,0 +1,26 @@
+import { type QuestionComposerProps } from './contract/slots.ts';
+/**
+ * Split the conventional recommendation suffix without changing the answer value.
+ * @param label - Original option label returned if selected.
+ * @returns Display label plus recommendation state.
+ */
+export declare function parseRecommendedLabel(label: string): {
+    label: string;
+    recommended: boolean;
+};
+/**
+ * Composer takeover router. Generic-question drafts live in this entry's
+ * Session-scoped Slot store, keyed by the pending carrier, so a strict Session
+ * entry remount restores the same request without exposing it to another one.
+ *
+ * One takeover, two presentations: a request that declares a presentation intent this
+ * package renders uses that presentation (a plan review is one decision over one
+ * plan, not a question set), and every other request takes the generic flow.
+ * The routing lives here, at the one entry that owns the composer seat, so
+ * neither presentation can claim a request the other is already rendering.
+ *
+ * @param props - the selector-matched pending question carrier plus the framework standard kit.
+ * @returns The question flow, or the intent's own surface, for this request.
+ */
+export declare function QuestionComposer(props: QuestionComposerProps): import("react").JSX.Element;
+//# sourceMappingURL=QuestionComposer.d.ts.map

package/lib/types/client/contract/slots.d.ts

@@ -0,0 +1,109 @@
+/** Question composer props and one pending Remote waterfall response. */
+import type { PropsLocale, PropsRuntime, PropsStore } from '@prettier-ai/dsh-client-ui-slots';
+import type { SessionId } from '@prettier-ai/dsh-session/types';
+import type { AskUserQuestionAnswer, AskUserQuestionItem } from '@prettier-ai/dsh-user-questions';
+import type { createQuestionDraftStore } from '../draft-store.ts';
+declare module '@prettier-ai/dsh-client-ui-session/client' {
+    interface SessionPendingInteractionMap {
+        /** Pending question or plan-review request. */
+        question: PendingQuestion;
+    }
+}
+/** One structured answer batch covering every question of the request. */
+export type QuestionAnswer = AskUserQuestionAnswer;
+/** One question of the request. */
+type QuestionItem = AskUserQuestionItem;
+/** One option the asker offered on a question. */
+type QuestionOption = NonNullable<QuestionItem['options']>[number];
+/**
+ * A request narrowed to the `plan-review` presentation intent: everything the
+ * decision card renders and answers with, so the panel never re-reads the
+ * request fields. `approve` and `decline` are the asker's own options — an
+ * answer must carry one of those labels verbatim — and `plan` is the markdown
+ * body under review.
+ */
+export interface PlanReview {
+    /** The reviewed question's id, echoed in the answer. */
+    id: string;
+    /** The question text, kept as the card's accessible name. */
+    question: string;
+    /** The plan markdown under review. */
+    plan: string;
+    /** The option that approves the plan. */
+    approve: QuestionOption;
+    /** The option that declines it; absent when the asker offered no other option. */
+    decline?: QuestionOption;
+}
+/**
+ * Narrow a request to a renderable plan review, or return undefined to leave it
+ * to the generic question flow.
+ *
+ * The card is one decision over one plan, and it claims a request only when it
+ * can send every answer that request allows — an intent changes the layout,
+ * never which answers are reachable. So the batch must be a single question
+ * that declares the intent, carries the plan as its detail, offers the approve
+ * label the intent names, and is a binary single choice: at most one option
+ * besides approve, and not multi-select. A third option or a multi-select batch
+ * has answers two buttons cannot express, so the generic flow keeps it — as it
+ * keeps any request whose intent the asker's own service would have rejected,
+ * because the client sits downstream of a wire boundary and every request must
+ * stay answerable.
+ *
+ * @param questions - the request's whole question batch.
+ * @returns The narrowed review, or undefined when the generic flow owns it.
+ */
+export declare function planReviewOf(questions: readonly QuestionItem[]): PlanReview | undefined;
+/** One answerable Client presentation of a pending Host waterfall. */
+export declare class PendingQuestion {
+    #private;
+    readonly sessionId: SessionId;
+    /** Presentation discriminator used by Session pending-interaction consumers. */
+    readonly kind: 'question' | 'plan-review';
+    /** Opaque render identity and request key for the Session-scoped draft store. */
+    readonly key: string;
+    /** The request's question list. */
+    readonly questions: readonly AskUserQuestionItem[];
+    /** Result returned by the Remote Event listener to the Host waterfall. */
+    readonly result: Promise<QuestionAnswer>;
+    /**
+     * @param sessionId - Agent/Session identity owning the scoped request.
+     * @param questions - complete question batch.
+     * @param signal - Host request and delivery lifetime.
+     */
+    constructor(sessionId: SessionId, questions: readonly AskUserQuestionItem[], signal?: AbortSignal);
+    /**
+     * Resolve the Host waterfall with the whole answer batch.
+     * @param answer - complete structured answer batch.
+     */
+    answer(answer: QuestionAnswer): Promise<void>;
+    /** Delegate an unanswered request to the next waterfall listener. */
+    delegate(): void;
+    /**
+     * Test whether a rejection requests waterfall delegation.
+     * @param reason - rejection received from {@link PendingQuestion.result}.
+     * @returns whether {@link PendingQuestion.delegate} produced it.
+     */
+    isDelegation(reason: unknown): boolean;
+    /** Reject the Host waterfall because the user closed the question. */
+    cancel(): Promise<void>;
+    /**
+     * End an unanswered presentation when its transport, scope, or plugin lifetime ends.
+     * @param reason - rejection exposed to the waiting Remote Event listener.
+     */
+    abort(reason: unknown): void;
+    private finish;
+}
+/** Pending value returned by the composer-chain selector. */
+export type QuestionWait = PendingQuestion;
+/**
+ * Full component props: the framework runtime share (chain currency +
+ * session/global standard kit) plus the chain `matched` share — the entry's
+ * selector result, already narrowed to the question carrier — plus the
+ * standard locale seat; the carrier plus the domain face above carry the
+ * whole behavior surface.
+ */
+export type QuestionComposerProps = PropsRuntime<'conversation.composer'> & PropsStore<ReturnType<typeof createQuestionDraftStore>> & {
+    matched: QuestionWait;
+} & PropsLocale<'question'>;
+export {};
+//# sourceMappingURL=slots.d.ts.map

package/lib/types/client/draft-store.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Session-scoped draft state for the generic question composer. The Slot
+ * registry owns store instances; this module exports only the factory so a
+ * plugin reload cannot reuse a module-global handle.
+ */
+import { type EngineStoreHandle } from '@prettier-ai/dsh-client-store';
+/** One in-progress answer, including an explicit skip. */
+export interface QuestionDraftAnswer {
+    /** Offered labels currently selected. */
+    selected: string[];
+    /** Human-authored alternative or additional answer. */
+    custom: string;
+    /** Whether the user explicitly skipped this question. */
+    skipped: boolean;
+}
+/** Navigation and answer drafts for one pending request. */
+export interface QuestionDraftProgress {
+    /** Current question index. */
+    index: number;
+    /** One draft per question, in request order. */
+    drafts: QuestionDraftAnswer[];
+}
+interface QuestionDraftState {
+    requestKey?: string;
+    progress: QuestionDraftProgress;
+}
+type QuestionDraftActions = {
+    replace: (draft: QuestionDraftState, requestKey: string, progress: QuestionDraftProgress) => void;
+    clear: (draft: QuestionDraftState, requestKey: string) => void;
+};
+/**
+ * Declare the question composer's transient Session store.
+ * @returns a non-persisted store handle whose instance is owned by the Slot registry.
+ */
+export declare function createQuestionDraftStore(): EngineStoreHandle<QuestionDraftState, QuestionDraftActions>;
+export {};
+//# sourceMappingURL=draft-store.d.ts.map

package/lib/types/client/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Web question plugin, browser half: QuestionComposer registered as a
+ * selector-routed entry of the conversation-declared composer chain, plus the
+ * `question` dictionaries. The selector narrows the owner's currency to the
+ * question carrier (matched prop), and the whole behavior surface rides the
+ * carrier (domain encoding in contract/slots.ts PendingQuestion); copy rides
+ * the standard locale seat. Export discipline: packages/client/AGENTS.md.
+ *
+ * One entry, two shapes: the composer renders a request that declares a
+ * presentation intent as that intent's own surface (`plan-review` → the plan
+ * decision card) and every other request as the generic question flow. A
+ * separate chain entry per shape would race the same carrier, so the shape
+ * choice lives inside this entry — see QuestionComposer.
+ */
+import type { Context as ClientContext } from '@prettier-ai/cordis';
+import { type QuestionKey } from './locales.ts';
+export type { PendingQuestion, PlanReview, QuestionAnswer, QuestionComposerProps, QuestionWait, } from './contract/slots.ts';
+export type { QuestionKey } from './locales.ts';
+declare module '@prettier-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** The question composer's copy. */
+        question: QuestionKey;
+    }
+}
+/** Required services: Agent scopes, Remote Events, Session UI, Slot registry, and copy. */
+export declare const inject: string[];
+/**
+ * Client plugin body: register the `question` dictionaries and the question
+ * composer into the composer chain. Zero business face — data and verbs live
+ * on the matched carrier; t rides the standard locale seat.
+ * @param ctx - client root context.
+ */
+export declare function apply(ctx: ClientContext): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/client/locales.d.ts

@@ -0,0 +1,40 @@
+/** `question` namespace dictionaries. */
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    'error.incomplete': string;
+    'error.unanswered': string;
+    'nav.prev': string;
+    'nav.next': string;
+    'nav.minimize': string;
+    'nav.maximize': string;
+    'nav.cancel': string;
+    'option.recommended': string;
+    'custom.placeholder': string;
+    'action.skip': string;
+    'action.next': string;
+    'plan.header': string;
+    'plan.approve': string;
+    'plan.decline': string;
+    'plan.discuss': string;
+};
+/** The question namespace key union. */
+export type QuestionKey = keyof typeof zh;
+/** English dictionary, checked complete against the zh key set. */
+export declare const en: {
+    'error.incomplete': string;
+    'error.unanswered': string;
+    'nav.prev': string;
+    'nav.next': string;
+    'nav.minimize': string;
+    'nav.maximize': string;
+    'nav.cancel': string;
+    'option.recommended': string;
+    'custom.placeholder': string;
+    'action.skip': string;
+    'action.next': string;
+    'plan.header': string;
+    'plan.approve': string;
+    'plan.decline': string;
+    'plan.discuss': string;
+};
+//# sourceMappingURL=locales.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Web question plugin, node half.
+ *
+ * Deliberately empty. Mounting `ask_user_question` here put it in the tools
+ * registry's GLOBAL layer, so every agent saw it no matter which preset
+ * composed it — a two-tool benchmark preset actually presented three, and a
+ * locally authored `bash-only` preset presented two. Rendering a question is
+ * a host UI capability; having the tool is an agent capability, and only a
+ * preset decides that. The `tool-ask-user` row belongs in the presets that
+ * want it (and in the TUI composition, which has no presets).
+ */
+/** Host plugin body — the model-facing tool is composed per preset, not here. */
+export declare function apply(): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Package-owned invariant companion for `@prettier-ai/dsh-client-ui-user-questions`.
+ * @module @prettier-ai/dsh-client-ui-user-questions/invariant
+ */
+import type { Context } from '@prettier-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "client-ui-user-questions-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns The installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/package.json

@@ -0,0 +1,94 @@
+{
+  "name": "@prettier-ai/dsh-client-ui-user-questions",
+  "description": "Web ask_user_question composer takeover and plan-review presentation UI",
+  "version": "0.1.2-alpha.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/client/ui-user-questions"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "client": {
+      "inject": [
+        "@prettier-ai/dsh-api-remotes",
+        "@prettier-ai/dsh-api-session-controller",
+        "@prettier-ai/dsh-client-locale",
+        "@prettier-ai/dsh-client-ui-conversation",
+        "@prettier-ai/dsh-client-ui-renderer",
+        "@prettier-ai/dsh-client-ui-session"
+      ],
+      "platform": "web"
+    }
+  },
+  "license": "MIT",
+  "dependencies": {
+    "clsx": "^2.0.0"
+  },
+  "peerDependencies": {
+    "@prettier-ai/cordis": "^4.0.1",
+    "@prettier-ai/dsh-api-remotes": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-api-session-controller": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-invariants": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-locale": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-renderer": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-typert-protocol": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-session": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-session": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-user-questions": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-conversation": "^0.1.2-alpha.1"
+  },
+  "devDependencies": {
+    "@types/react": "~18.3.1",
+    "react": "^18.2.0",
+    "@prettier-ai/dsh-api-remotes": "^0.1.2-alpha.1",
+    "@prettier-ai/cordis": "^4.0.1",
+    "@prettier-ai/dsh-api-session-controller": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-agent": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-store": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-locale": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-invariants": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-system-prompt": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-primitives": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-renderer": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-slots": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-user-questions": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-tools": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-typert-protocol": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-connection": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-session": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-conversation": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-session": "^0.1.2-alpha.1"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  }
+}