@hachej/boring-ask-user 0.1.13

package/dist/front/index.js

@@ -0,0 +1,546 @@
+"use client";
+
+// src/front/index.tsx
+import { Button, EmptyState, Notice, Pane, PaneBody, PaneFooter, PaneHeader, PaneTitle } from "@hachej/boring-ui-kit";
+import {
+  UI_COMMAND_EVENT,
+  useWorkspaceAttention
+} from "@hachej/boring-workspace";
+import {
+  definePlugin
+} from "@hachej/boring-workspace/plugin";
+import { HelpCircle, XCircle } from "lucide-react";
+import { createContext as createContext2, useContext as useContext2, useEffect as useEffect2, useMemo as useMemo2, useSyncExternalStore, useState as useState2 } from "react";
+
+// src/shared/constants.ts
+var ASK_USER_PLUGIN_ID = "ask-user";
+var ASK_USER_PANEL_ID = "ask-user.questions";
+var ASK_USER_PANEL_TITLE = "Questions";
+var ASK_USER_SURFACE_KIND = "questions";
+var ASK_USER_COMMAND_KINDS = {
+  SUBMIT: "questions.submit",
+  CANCEL: "questions.cancel"
+};
+var ASK_USER_UI_STATE_SLOTS = {
+  PENDING: "questions.pending"
+};
+var ASK_USER_SCHEMA_LIMITS = {
+  maxFields: 8,
+  maxOptionsPerField: 50,
+  maxFieldNameLength: 64,
+  maxTitleLength: 200,
+  maxLabelLength: 160,
+  maxHelpTextLength: 500,
+  maxContextLength: 4e3,
+  maxSerializedSchemaBytes: 32e3,
+  maxFreeformAnswerLength: 4e3,
+  minTimeoutMs: 1e3,
+  maxTimeoutMs: 30 * 6e4,
+  defaultTimeoutMs: 10 * 6e4
+};
+
+// src/shared/error-codes.ts
+var ASK_USER_ERROR_CODES = {
+  PENDING_EXISTS: "ASK_USER_PENDING_EXISTS",
+  QUESTION_NOT_FOUND: "ASK_USER_QUESTION_NOT_FOUND",
+  QUESTION_ABANDONED: "ASK_USER_QUESTION_ABANDONED",
+  QUESTION_NOT_READY: "ASK_USER_QUESTION_NOT_READY",
+  SCHEMA_INVALID: "ASK_USER_SCHEMA_INVALID",
+  ANSWER_INVALID: "ASK_USER_ANSWER_INVALID",
+  SESSION_MISMATCH: "ASK_USER_SESSION_MISMATCH",
+  UI_UNAVAILABLE: "ASK_USER_UI_UNAVAILABLE",
+  ALREADY_ANSWERED: "ASK_USER_ALREADY_ANSWERED",
+  ALREADY_CANCELLED: "ASK_USER_ALREADY_CANCELLED",
+  UNAUTHORIZED: "ASK_USER_UNAUTHORIZED",
+  UI_ACK_TIMEOUT: "ASK_USER_UI_ACK_TIMEOUT",
+  RATE_LIMITED: "ASK_USER_RATE_LIMITED",
+  RUNTIME_UNAVAILABLE: "ASK_USER_RUNTIME_UNAVAILABLE"
+};
+var ASK_USER_ERROR_CODE_VALUES = Object.values(ASK_USER_ERROR_CODES);
+
+// src/front/primitives/QuestionForm.tsx
+import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState } from "react";
+import { Checkbox, ChoiceGroup, ChoiceGroupLegend, ChoiceItem, ChoiceItemBody, ChoiceItemDescription, ChoiceItemTitle, Field, FieldDescription, FieldError, FieldLabel, Input, Radio, Select, SelectContent, SelectItem, SelectTrigger, SelectValue, Textarea } from "@hachej/boring-ui-kit";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+var QuestionFormContext = createContext(null);
+var fieldClass = "space-y-1.5";
+var choiceControlClass = "mt-0.5";
+function useQuestionForm() {
+  const ctx = useContext(QuestionFormContext);
+  if (!ctx) throw new Error("useQuestionForm must be used inside QuestionFormProvider");
+  return ctx;
+}
+function QuestionFormProvider({
+  schema,
+  status = "ready",
+  disabled = false,
+  submitting: controlledSubmitting,
+  initialValues,
+  rendererRegistry = {},
+  onSubmit,
+  onCancel,
+  children
+}) {
+  const [values, setValues] = useState(() => defaultsFor(schema, initialValues));
+  const [touched, setTouched] = useState({});
+  const [submitting, setSubmitting] = useState(false);
+  const [submitted, setSubmitted] = useState(false);
+  const dirtyHints = {};
+  const formRef = useRef(null);
+  useEffect(() => {
+    setValues((current) => {
+      const next = defaultsFor(schema, initialValues);
+      for (const field of schema?.fields ?? []) {
+        if (touched[field.name] && current[field.name] !== void 0) {
+          next[field.name] = current[field.name];
+        }
+      }
+      return next;
+    });
+  }, [schema, initialValues, touched]);
+  const errors = useMemo(() => {
+    if (!schema) return {};
+    const allErrors = validateQuestionValues(schema, values).errors;
+    if (submitted) return allErrors;
+    return Object.fromEntries(Object.entries(allErrors).filter(([name]) => touched[name]));
+  }, [schema, values, submitted, touched]);
+  const setValue = useCallback((name, value2) => {
+    setTouched((current) => ({ ...current, [name]: true }));
+    setValues((current) => ({ ...current, [name]: value2 }));
+  }, []);
+  const touch = useCallback((name) => setTouched((current) => ({ ...current, [name]: true })), []);
+  const submit = useCallback(async () => {
+    if (!schema || status !== "ready" || disabled) return;
+    const result = validateQuestionValues(schema, values);
+    if (!result.valid) {
+      setSubmitted(true);
+      const first = Object.keys(result.errors)[0];
+      formRef.current?.querySelector(`[name="${cssEscape(first)}"]`)?.focus();
+      return;
+    }
+    setSubmitting(true);
+    try {
+      await onSubmit?.(values);
+    } finally {
+      setSubmitting(false);
+    }
+  }, [schema, status, disabled, values, onSubmit]);
+  const cancel = useCallback(() => {
+    if (Object.keys(touched).length > 0 && !window.confirm("Discard your answer?")) return;
+    onCancel?.();
+  }, [onCancel, touched]);
+  const value = { schema, status, values, touched, errors, submitting: controlledSubmitting ?? submitting, disabled, dirtyHints, setValue, touch, submit, cancel, rendererRegistry, formRef };
+  return /* @__PURE__ */ jsx(QuestionFormContext.Provider, { value, children });
+}
+function QuestionForm({ children, "aria-label": ariaLabel = "Question form" }) {
+  const { submit, cancel, status, formRef } = useQuestionForm();
+  return /* @__PURE__ */ jsxs("form", { ref: formRef, "data-question-form": true, "aria-label": ariaLabel, onSubmit: (event) => {
+    event.preventDefault();
+    void submit();
+  }, onKeyDown: (event) => {
+    if ((event.metaKey || event.ctrlKey) && event.key === "Enter") {
+      event.preventDefault();
+      void submit();
+    }
+    if (event.key === "Escape") {
+      event.preventDefault();
+      cancel();
+    }
+  }, children: [
+    /* @__PURE__ */ jsx("div", { "aria-live": "polite", className: "sr-only", children: status === "ready" ? "Question ready" : `Question ${status}` }),
+    children
+  ] });
+}
+function QuestionFields() {
+  const { schema } = useQuestionForm();
+  if (!schema) return null;
+  return /* @__PURE__ */ jsx(Fragment, { children: schema.fields.map((field) => /* @__PURE__ */ jsx(QuestionField, { field }, field.name)) });
+}
+function QuestionField({ field }) {
+  const { values, errors, disabled, submitting, setValue, touch, rendererRegistry, dirtyHints } = useQuestionForm();
+  const error = errors[field.name];
+  const helpId = `${field.name}-help`;
+  const errorId = `${field.name}-error`;
+  const hintId = `${field.name}-hint`;
+  const describedBy = [field.helpText ? helpId : void 0, error ? errorId : void 0, dirtyHints[field.name] ? hintId : void 0].filter(Boolean).join(" ");
+  const renderer = rendererRegistry[field.type] ?? defaultRenderers[field.type] ?? rendererRegistry.unsupported ?? UnsupportedFieldRenderer;
+  return /* @__PURE__ */ jsxs(Field, { "data-field": field.name, className: fieldClass, children: [
+    renderer({ field, value: values[field.name], error, disabled: disabled || submitting, describedBy, onChange: (value) => setValue(field.name, value), onBlur: () => touch(field.name) }),
+    field.helpText ? /* @__PURE__ */ jsx(FieldDescription, { id: helpId, children: field.helpText }) : null,
+    dirtyHints[field.name] ? /* @__PURE__ */ jsx(FieldDescription, { id: hintId, children: dirtyHints[field.name] }) : null,
+    error ? /* @__PURE__ */ jsx(FieldError, { id: errorId, role: "alert", children: error }) : null
+  ] });
+}
+function QuestionSubmitButton(props) {
+  const { status, submitting, disabled } = useQuestionForm();
+  return /* @__PURE__ */ jsx("button", { ...props, type: "submit", disabled: disabled || submitting || status !== "ready", children: props.children ?? "Submit" });
+}
+function QuestionCancelButton(props) {
+  const { cancel, disabled, submitting } = useQuestionForm();
+  return /* @__PURE__ */ jsx("button", { ...props, type: "button", disabled: disabled || submitting, onClick: (event) => {
+    props.onClick?.(event);
+    if (!event.defaultPrevented) cancel();
+  }, children: props.children ?? "Cancel" });
+}
+var defaultRenderers = {
+  text: ({ field, value, disabled, describedBy, error, onChange, onBlur }) => field.type === "text" && /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx(FieldLabel, { htmlFor: field.name, children: label(field) }),
+    /* @__PURE__ */ jsx(Input, { id: field.name, name: field.name, value: typeof value === "string" ? value : "", placeholder: field.placeholder, minLength: field.minLength, maxLength: field.maxLength, pattern: field.pattern, disabled, "aria-describedby": describedBy || void 0, "aria-invalid": !!error, "aria-errormessage": error ? `${field.name}-error` : void 0, onChange: (e) => onChange(e.target.value), onBlur })
+  ] }),
+  textarea: ({ field, value, disabled, describedBy, error, onChange, onBlur }) => field.type === "textarea" && /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx(FieldLabel, { htmlFor: field.name, children: label(field) }),
+    /* @__PURE__ */ jsx(Textarea, { id: field.name, name: field.name, value: typeof value === "string" ? value : "", placeholder: field.placeholder, minLength: field.minLength, maxLength: field.maxLength, disabled, "aria-describedby": describedBy || void 0, "aria-invalid": !!error, "aria-errormessage": error ? `${field.name}-error` : void 0, onChange: (e) => onChange(e.target.value), onBlur })
+  ] }),
+  select: ({ field, value, disabled, describedBy, error, onChange, onBlur }) => (field.type === "select" || field.type === "radio") && /* @__PURE__ */ jsxs(ChoiceGroup, { "aria-describedby": field.type === "radio" ? describedBy || void 0 : void 0, "aria-invalid": field.type === "radio" ? !!error : void 0, "aria-errormessage": field.type === "radio" && error ? `${field.name}-error` : void 0, children: [
+    /* @__PURE__ */ jsx(ChoiceGroupLegend, { children: label(field) }),
+    field.options.map((option) => field.type === "select" ? null : /* @__PURE__ */ jsxs(ChoiceItem, { children: [
+      /* @__PURE__ */ jsx(Radio, { className: choiceControlClass, name: field.name, checked: value === option.value, disabled, onChange: () => onChange(option.value), onBlur }),
+      /* @__PURE__ */ jsxs(ChoiceItemBody, { children: [
+        /* @__PURE__ */ jsx(ChoiceItemTitle, { children: option.label }),
+        option.description ? /* @__PURE__ */ jsx(ChoiceItemDescription, { children: option.description }) : null
+      ] })
+    ] }, option.value)),
+    field.type === "select" ? /* @__PURE__ */ jsxs(Select, { name: field.name, value: typeof value === "string" ? value : "", disabled, onValueChange: (next) => onChange(next), children: [
+      /* @__PURE__ */ jsx(SelectTrigger, { className: "w-full", "aria-describedby": describedBy || void 0, "aria-invalid": !!error, "aria-errormessage": error ? `${field.name}-error` : void 0, onBlur, children: /* @__PURE__ */ jsx(SelectValue, { placeholder: "Select\u2026" }) }),
+      /* @__PURE__ */ jsx(SelectContent, { children: field.options.map((o) => /* @__PURE__ */ jsx(SelectItem, { value: o.value, children: o.label }, o.value)) })
+    ] }) : null
+  ] }),
+  radio: (props) => defaultRenderers.select?.(props),
+  multiselect: ({ field, value, disabled, describedBy, error, onChange, onBlur }) => field.type === "multiselect" && /* @__PURE__ */ jsxs(ChoiceGroup, { "aria-describedby": describedBy || void 0, "aria-invalid": !!error, "aria-errormessage": error ? `${field.name}-error` : void 0, children: [
+    /* @__PURE__ */ jsx(ChoiceGroupLegend, { children: label(field) }),
+    field.options.map((option) => {
+      const list = Array.isArray(value) ? value : [];
+      return /* @__PURE__ */ jsxs(ChoiceItem, { children: [
+        /* @__PURE__ */ jsx(Checkbox, { className: choiceControlClass, name: field.name, checked: list.includes(option.value), disabled, onCheckedChange: (checked) => onChange(checked ? [...list, option.value] : list.filter((item) => item !== option.value)), onBlur }),
+        /* @__PURE__ */ jsxs(ChoiceItemBody, { children: [
+          /* @__PURE__ */ jsx(ChoiceItemTitle, { children: option.label }),
+          option.description ? /* @__PURE__ */ jsx(ChoiceItemDescription, { children: option.description }) : null
+        ] })
+      ] }, option.value);
+    })
+  ] }),
+  checkbox: ({ field, value, disabled, describedBy, error, onChange, onBlur }) => field.type === "checkbox" && /* @__PURE__ */ jsxs(ChoiceItem, { children: [
+    /* @__PURE__ */ jsx(Checkbox, { className: choiceControlClass, name: field.name, checked: value === true, disabled, "aria-describedby": describedBy || void 0, "aria-invalid": !!error, "aria-errormessage": error ? `${field.name}-error` : void 0, onCheckedChange: (checked) => onChange(checked === true), onBlur }),
+    /* @__PURE__ */ jsx(ChoiceItemTitle, { children: field.label })
+  ] }),
+  number: ({ field, value, disabled, describedBy, error, onChange, onBlur }) => field.type === "number" && /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx(FieldLabel, { htmlFor: field.name, children: label(field) }),
+    /* @__PURE__ */ jsx(Input, { id: field.name, type: "number", name: field.name, value: typeof value === "number" ? String(value) : "", min: field.min, max: field.max, step: field.integer ? 1 : field.step, disabled, "aria-describedby": describedBy || void 0, "aria-invalid": !!error, "aria-errormessage": error ? `${field.name}-error` : void 0, onChange: (e) => onChange(e.target.value === "" ? null : Number(e.target.value)), onBlur })
+  ] }),
+  unsupported: UnsupportedFieldRenderer
+};
+function UnsupportedFieldRenderer({ field }) {
+  return /* @__PURE__ */ jsxs(FieldDescription, { role: "note", children: [
+    "Unsupported question field: ",
+    field.type
+  ] });
+}
+function label(field) {
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    field.label,
+    "required" in field && field.required ? /* @__PURE__ */ jsx("span", { className: "text-destructive", "aria-hidden": "true", children: " *" }) : null
+  ] });
+}
+function defaultsFor(schema, initial) {
+  const values = { ...initial ?? {} };
+  for (const field of schema?.fields ?? []) if (values[field.name] === void 0 && "defaultValue" in field) values[field.name] = field.defaultValue;
+  return values;
+}
+function validateQuestionValues(schema, values) {
+  const errors = {};
+  for (const field of schema.fields) {
+    const value = values[field.name];
+    const empty = value === void 0 || value === null || value === "" || Array.isArray(value) && value.length === 0;
+    if ("required" in field && field.required && empty) {
+      errors[field.name] = "This field is required.";
+      continue;
+    }
+    if (empty) continue;
+    if (field.type === "text" || field.type === "textarea") {
+      if (typeof value !== "string") errors[field.name] = "Enter text.";
+      else if (field.minLength !== void 0 && value.length < field.minLength) errors[field.name] = `Must be at least ${field.minLength} characters.`;
+      else if (field.maxLength !== void 0 && value.length > field.maxLength) errors[field.name] = `Must be at most ${field.maxLength} characters.`;
+      else if (field.type === "text" && field.pattern && !new RegExp(field.pattern).test(value)) errors[field.name] = "Invalid format.";
+    } else if ((field.type === "select" || field.type === "radio") && (typeof value !== "string" || !field.options.some((o) => o.value === value))) errors[field.name] = "Choose a valid option.";
+    else if (field.type === "multiselect") {
+      if (!Array.isArray(value)) errors[field.name] = "Choose valid options.";
+      else if (field.minSelections !== void 0 && value.length < field.minSelections) errors[field.name] = `Choose at least ${field.minSelections}.`;
+      else if (field.maxSelections !== void 0 && value.length > field.maxSelections) errors[field.name] = `Choose at most ${field.maxSelections}.`;
+      else if (value.some((item) => !field.options.some((o) => o.value === item))) errors[field.name] = "Choose valid options.";
+    } else if (field.type === "checkbox" && typeof value !== "boolean") errors[field.name] = "Must be checked or unchecked.";
+    else if (field.type === "number") {
+      if (typeof value !== "number" || !Number.isFinite(value)) errors[field.name] = "Enter a number.";
+      else if (field.integer && !Number.isInteger(value)) errors[field.name] = "Enter a whole number.";
+      else if (field.min !== void 0 && value < field.min) errors[field.name] = `Must be at least ${field.min}.`;
+      else if (field.max !== void 0 && value > field.max) errors[field.name] = `Must be at most ${field.max}.`;
+    }
+  }
+  return { valid: Object.keys(errors).length === 0, errors };
+}
+function cssEscape(value) {
+  return globalThis.CSS?.escape?.(value) ?? value.replace(/[^A-Za-z0-9_-]/g, "\\$&");
+}
+
+// src/front/client.ts
+var QuestionsClientError = class extends Error {
+  constructor(code, message, statusCode = 0) {
+    super(message);
+    this.code = code;
+    this.statusCode = statusCode;
+  }
+  code;
+  statusCode;
+};
+function readPendingQuestionFromState(state) {
+  const slot = state?.[ASK_USER_UI_STATE_SLOTS.PENDING];
+  if (!slot || typeof slot !== "object") return null;
+  const question = slot.question;
+  return question && typeof question === "object" ? question : null;
+}
+function createQuestionsClient(options = {}) {
+  async function dispatch(command) {
+    const response = await fetch(`${options.apiBaseUrl ?? ""}/api/v1/questions/commands`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", ...options.headers ?? {} },
+      body: JSON.stringify(command)
+    });
+    const payload = await response.json().catch(() => ({}));
+    if (!response.ok) throw new QuestionsClientError(payload.error ?? ASK_USER_ERROR_CODES.UI_UNAVAILABLE, payload.message ?? "Question command failed", response.status);
+    return payload;
+  }
+  return {
+    dispatch,
+    cancel(question) {
+      return dispatch({ kind: ASK_USER_COMMAND_KINDS.CANCEL, params: { questionId: question.questionId, sessionId: question.sessionId, answerToken: question.answerToken } });
+    },
+    submit(question, values) {
+      if (!question.schema) throw new QuestionsClientError(ASK_USER_ERROR_CODES.QUESTION_NOT_READY, "Question is not ready");
+      const validation = validateQuestionValues(question.schema, values);
+      if (!validation.valid) throw new QuestionsClientError(ASK_USER_ERROR_CODES.ANSWER_INVALID, firstValidationMessage(validation));
+      return dispatch({ kind: ASK_USER_COMMAND_KINDS.SUBMIT, params: { questionId: question.questionId, sessionId: question.sessionId, answerToken: question.answerToken, values } });
+    }
+  };
+}
+function firstValidationMessage(validation) {
+  return Object.values(validation.errors)[0] ?? "Invalid answer";
+}
+
+// src/front/index.tsx
+import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+function createQuestionsStore() {
+  const listeners = /* @__PURE__ */ new Set();
+  let pending = null;
+  return {
+    getPending: () => pending,
+    setPending(question) {
+      pending = question;
+      for (const listener of [...listeners]) listener();
+    },
+    subscribe(listener) {
+      listeners.add(listener);
+      return () => listeners.delete(listener);
+    }
+  };
+}
+var sharedQuestionsStore = createQuestionsStore();
+var QuestionsRuntimeContext = createContext2(null);
+function sessionScopedBlockerId(sessionId) {
+  return sessionId === "default" || sessionId === "anonymous" ? void 0 : sessionId;
+}
+function pendingQuestionSnapshot(store) {
+  const pending = store.getPending();
+  return pending ? `${pending.sessionId}:${pending.questionId}:${pending.status}` : "none";
+}
+function useQuestionsRuntime() {
+  const ctx = useContext2(QuestionsRuntimeContext);
+  if (!ctx) throw new Error("askUserPlugin QuestionsPane must be rendered under AskUserProvider");
+  return ctx;
+}
+function AskUserProvider({ apiBaseUrl, authHeaders, children }) {
+  const { addBlocker, removeBlocker } = useWorkspaceAttention();
+  const runtime = useMemo2(() => ({ ...sharedQuestionsStore, apiBaseUrl, authHeaders }), [apiBaseUrl, authHeaders]);
+  const pendingSnapshot = useSyncExternalStore(runtime.subscribe, () => pendingQuestionSnapshot(runtime), () => "none");
+  useEffect2(() => {
+    const pending = runtime.getPending();
+    const blockerId = pending ? `${ASK_USER_PLUGIN_ID}:${pending.sessionId}:${pending.questionId}` : null;
+    if (pending?.status === "ready" && blockerId) {
+      addBlocker({
+        id: blockerId,
+        reason: "waiting_for_user_input",
+        surfaceKind: ASK_USER_SURFACE_KIND,
+        target: pending.questionId,
+        label: "Answer the question in Questions to continue",
+        sessionId: sessionScopedBlockerId(pending.sessionId),
+        actions: [{ id: "open", label: "Open Questions" }]
+      });
+    }
+    return () => {
+      if (blockerId) removeBlocker(blockerId);
+    };
+  }, [addBlocker, removeBlocker, runtime, pendingSnapshot]);
+  useEffect2(() => {
+    const onStop = (event) => {
+      const sessionId = event.detail?.sessionId;
+      const pending = runtime.getPending();
+      if (!pending || sessionId && sessionScopedBlockerId(pending.sessionId) && sessionId !== pending.sessionId) return;
+      runtime.setPending(null);
+      void createQuestionsClient({ apiBaseUrl: runtime.apiBaseUrl, headers: runtime.authHeaders }).cancel(pending).catch(() => void 0);
+    };
+    window.addEventListener("boring:workspace-composer-stop", onStop);
+    return () => window.removeEventListener("boring:workspace-composer-stop", onStop);
+  }, [runtime]);
+  useEffect2(() => {
+    let stopped = false;
+    async function refreshPending() {
+      try {
+        const response = await fetch(`${apiBaseUrl}/api/v1/ui/state`, { headers: authHeaders });
+        const state = await response.json().catch(() => null);
+        if (!stopped) runtime.setPending(readPendingQuestionFromState(state));
+      } catch {
+      }
+    }
+    const onVisibility = () => {
+      if (document.visibilityState === "visible") void refreshPending();
+    };
+    const onUiCommand = () => {
+      void refreshPending();
+    };
+    void refreshPending();
+    window.addEventListener("focus", refreshPending);
+    document.addEventListener("visibilitychange", onVisibility);
+    window.addEventListener(UI_COMMAND_EVENT, onUiCommand);
+    return () => {
+      stopped = true;
+      window.removeEventListener("focus", refreshPending);
+      document.removeEventListener("visibilitychange", onVisibility);
+      window.removeEventListener(UI_COMMAND_EVENT, onUiCommand);
+    };
+  }, [apiBaseUrl, authHeaders, runtime]);
+  return /* @__PURE__ */ jsx2(QuestionsRuntimeContext.Provider, { value: runtime, children });
+}
+function QuestionsPane({ api, params, className }) {
+  const runtime = useQuestionsRuntime();
+  const pending = useSyncExternalStore(runtime.subscribe, runtime.getPending, runtime.getPending);
+  const [closedQuestionId, setClosedQuestionId] = useState2(null);
+  const [error, setError] = useState2(null);
+  const [submitting, setSubmitting] = useState2(false);
+  const paramQuestion = params?.question;
+  const question = pending ?? (paramQuestion?.questionId === closedQuestionId ? null : paramQuestion) ?? null;
+  const client = useMemo2(() => createQuestionsClient({ apiBaseUrl: runtime.apiBaseUrl, headers: runtime.authHeaders }), [runtime.apiBaseUrl, runtime.authHeaders]);
+  useEffect2(() => {
+    const onStop = (event) => {
+      const sessionId = event.detail?.sessionId;
+      if (!question || sessionId && sessionScopedBlockerId(question.sessionId) && sessionId !== question.sessionId) return;
+      setClosedQuestionId(question.questionId);
+      runtime.setPending(null);
+      api.close();
+    };
+    window.addEventListener("boring:workspace-composer-stop", onStop);
+    return () => window.removeEventListener("boring:workspace-composer-stop", onStop);
+  }, [api, question, runtime]);
+  useEffect2(() => {
+    if (question && pending === null && !paramQuestion) api.close();
+  }, [api, pending, paramQuestion, question]);
+  return /* @__PURE__ */ jsx2("div", { className: className ?? "h-full", children: /* @__PURE__ */ jsxs2(Pane, { className: "h-full border-0 bg-background text-sm", children: [
+    /* @__PURE__ */ jsx2(PaneHeader, { className: "border-b bg-background/95", children: /* @__PURE__ */ jsx2("div", { children: /* @__PURE__ */ jsxs2(PaneTitle, { className: "flex items-center gap-2", children: [
+      /* @__PURE__ */ jsx2(HelpCircle, { className: "h-4 w-4 text-muted-foreground" }),
+      " Agent needs input"
+    ] }) }) }),
+    !question ? /* @__PURE__ */ jsx2(PaneBody, { className: "overflow-auto p-4", children: /* @__PURE__ */ jsx2(EmptyState, { icon: /* @__PURE__ */ jsx2(HelpCircle, { className: "h-5 w-5" }), title: "No pending questions", description: "When the agent needs a decision, the form will appear here.", className: "border border-dashed bg-muted/20" }) }) : null,
+    question?.status === "ready" && question.schema ? /* @__PURE__ */ jsx2(QuestionFormProvider, { schema: question.schema, submitting, onSubmit: async (values) => {
+      setSubmitting(true);
+      setError(null);
+      try {
+        await client.submit(question, values);
+        setClosedQuestionId(question.questionId);
+        runtime.setPending(null);
+        api.close();
+        params?.__closeWorkbenchOnDone?.();
+      } catch (err) {
+        setError(err instanceof QuestionsClientError ? err.message : String(err));
+      } finally {
+        setSubmitting(false);
+      }
+    }, onCancel: async () => {
+      setSubmitting(true);
+      setError(null);
+      try {
+        await client.cancel(question);
+        setClosedQuestionId(question.questionId);
+        runtime.setPending(null);
+        api.close();
+        params?.__closeWorkbenchOnDone?.();
+      } catch (err) {
+        setError(err instanceof QuestionsClientError ? err.message : String(err));
+      } finally {
+        setSubmitting(false);
+      }
+    }, children: /* @__PURE__ */ jsxs2(QuestionForm, { children: [
+      /* @__PURE__ */ jsx2(PaneBody, { className: "overflow-auto p-4", children: /* @__PURE__ */ jsxs2("div", { className: "space-y-4", children: [
+        /* @__PURE__ */ jsxs2("section", { className: "rounded-md border border-border/60 bg-muted/30 p-4", children: [
+          /* @__PURE__ */ jsx2("div", { className: "text-xs font-medium uppercase tracking-wide text-muted-foreground", children: "Waiting for answer" }),
+          /* @__PURE__ */ jsx2("h2", { className: "mt-2 text-balance text-sm font-semibold leading-5 text-foreground", children: question.title ?? "Question" }),
+          question.context ? /* @__PURE__ */ jsx2("p", { className: "mt-2 max-w-prose text-sm leading-6 text-muted-foreground", children: question.context }) : null
+        ] }),
+        /* @__PURE__ */ jsx2("div", { className: "space-y-4", children: /* @__PURE__ */ jsx2(QuestionFields, {}) }),
+        error ? /* @__PURE__ */ jsx2(Notice, { tone: "destructive", role: "alert", children: error }) : null
+      ] }) }),
+      /* @__PURE__ */ jsxs2(PaneFooter, { className: "justify-between border-t bg-background px-4 py-3", children: [
+        /* @__PURE__ */ jsx2("p", { className: "min-w-0 text-xs text-muted-foreground", children: "Sends answers and closes the pane." }),
+        /* @__PURE__ */ jsxs2("div", { className: "flex gap-2", children: [
+          /* @__PURE__ */ jsx2(Button, { asChild: true, variant: "outline", size: "sm", children: /* @__PURE__ */ jsx2(QuestionCancelButton, { children: "Cancel" }) }),
+          /* @__PURE__ */ jsx2(Button, { asChild: true, size: "sm", children: /* @__PURE__ */ jsx2(QuestionSubmitButton, { children: question.schema.submitLabel ?? "Send answers" }) })
+        ] })
+      ] })
+    ] }) }) : null,
+    question && question.status !== "ready" ? /* @__PURE__ */ jsx2(PaneBody, { className: "p-5", children: /* @__PURE__ */ jsx2(Notice, { children: /* @__PURE__ */ jsxs2("span", { className: "flex items-center gap-2", children: [
+      /* @__PURE__ */ jsx2(XCircle, { className: "h-4 w-4 text-muted-foreground" }),
+      "Question ",
+      question.status
+    ] }) }) }) : null
+  ] }) });
+}
+var askUserPlugin = definePlugin({
+  id: ASK_USER_PLUGIN_ID,
+  label: ASK_USER_PANEL_TITLE,
+  providers: [
+    {
+      id: `${ASK_USER_PLUGIN_ID}.provider`,
+      component: AskUserProvider
+    }
+  ],
+  panels: [
+    {
+      id: ASK_USER_PANEL_ID,
+      label: ASK_USER_PANEL_TITLE,
+      icon: HelpCircle,
+      component: QuestionsPane,
+      placement: "center",
+      source: "builtin",
+      chromeless: true
+    }
+  ],
+  surfaceResolvers: [
+    {
+      id: `${ASK_USER_PLUGIN_ID}.surface`,
+      kind: ASK_USER_SURFACE_KIND,
+      source: "builtin",
+      // No inner kind guard — the workspace's surface registry already
+      // pre-filters by the top-level `kind` field before calling resolve.
+      resolve(request) {
+        const metaQuestion = typeof request.meta === "object" && request.meta && "question" in request.meta ? request.meta.question : void 0;
+        return {
+          component: ASK_USER_PANEL_ID,
+          id: ASK_USER_PANEL_ID,
+          title: ASK_USER_PANEL_TITLE,
+          params: { questionId: request.target, question: metaQuestion }
+        };
+      }
+    }
+  ]
+});
+var front_default = askUserPlugin;
+export {
+  askUserPlugin,
+  front_default as default
+};