@mihe-dev/react 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Neek Digital Solutions Ltd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,69 @@
-# Temporary Holding Version
+# @mihe-dev/react
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Mihe is an assistant you embed in your React app. It knows your screens,
+components and actions, and it operates the app for your users, under your
+own permission model: it finds things, opens screens, fills in and points
+at forms, and runs actions, asking for approval wherever you say it must.
+Users can type or talk to it.
+
+## Install
+
+```bash
+npm install @mihe-dev/react
+```
+
+React 18 or later. The package is ES modules with TypeScript types, and it
+marks itself `"use client"`, so it works in Next.js App Router, Vite and
+other bundlers without extra configuration.
+
+## A first integration
+
+```tsx
+import { AssistantProvider, AssistantWidget, useAssistantScreen } from "@mihe-dev/react";
+
+export function Root({ children }: { children: React.ReactNode }) {
+  return (
+    <AssistantProvider
+      url="wss://runtime.mihe.dev/v1/ws"
+      publicKey={process.env.NEXT_PUBLIC_MIHE_PUBLIC_KEY!}
+      // Your server mints this token for the signed-in user, signed with
+      // your app secret. It carries who they are and what they may do.
+      getUserToken={() => fetch("/api/mihe/token").then((r) => r.text())}
+      navigate={(route) => router.push(route)}
+    >
+      {children}
+      <AssistantWidget />
+    </AssistantProvider>
+  );
+}
+
+function OrdersPage() {
+  // Tell the assistant where the user is and what they can see.
+  useAssistantScreen({
+    screenId: "orders.list",
+    route: "/orders",
+    title: "Orders",
+    visibleData: { pending: 16 },
+  });
+  // …
+}
+```
+
+Create an app and its keys in the [dashboard](https://app.mihe.dev), then
+follow the [quickstart](https://mihe.dev/docs/quickstart).
+
+## Documentation
+
+- [Quickstart](https://mihe.dev/docs/quickstart)
+- [Screens and components](https://mihe.dev/docs/screens-and-components):
+  what the assistant can see and point at
+- [Actions](https://mihe.dev/docs/actions) and
+  [permissions and risk](https://mihe.dev/docs/permissions-and-risk):
+  what it can do, and what needs approval
+- [User tokens](https://mihe.dev/docs/user-tokens)
+- [The widget](https://mihe.dev/docs/widget) and [voice](https://mihe.dev/docs/voice)
+- [SDK reference](https://mihe.dev/docs/sdk-reference)
+
+## License
+
+MIT © Neek Digital Solutions Ltd

package/dist/card.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The approval surface for a proposed action, shared by the panel and the orb.
+ *
+ * It renders `label`, `description` and `input` from the proposal payload,
+ * which the runtime copies from its registry, never from the assistant's
+ * prose. Text smuggled into a product name or a document therefore cannot
+ * change what a user is shown they are about to approve.
+ */
+import { formatValue, humanizeKey, type ProposalPayload } from "@mihe-dev/js";
+export { formatValue, humanizeKey };
+/**
+ * The approval surface for a proposed action.
+ *
+ * High-risk actions require this tap — the runtime refuses a spoken or typed
+ * "yes" for them — so this component is a security boundary, not decoration.
+ */
+export declare function ConfirmationCard({ proposal, onRespond, }: {
+    proposal: ProposalPayload;
+    onRespond: (proposalId: string, confirmed: boolean) => void;
+}): import("react").JSX.Element;
+//# sourceMappingURL=card.d.ts.map

package/dist/card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"card.d.ts","sourceRoot":"","sources":["../../../react/src/card.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAE9E,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;AAIpC;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,SAAS,GACV,EAAE;IACD,QAAQ,EAAE,eAAe,CAAC;IAC1B,SAAS,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;CAC7D,+BAiDA"}

package/dist/card.js

@@ -0,0 +1,74 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { formatValue, humanizeKey } from "@mihe-dev/js";
+export { formatValue, humanizeKey };
+const FONT = "system-ui, -apple-system, 'Segoe UI', sans-serif";
+/**
+ * The approval surface for a proposed action.
+ *
+ * High-risk actions require this tap — the runtime refuses a spoken or typed
+ * "yes" for them — so this component is a security boundary, not decoration.
+ */
+export function ConfirmationCard({ proposal, onRespond, }) {
+    const entries = Object.entries(proposal.input ?? {});
+    return (_jsxs("div", { style: styles.card, role: "group", "aria-label": `Confirm: ${proposal.label}`, children: [_jsxs("div", { style: styles.cardHeader, children: [_jsx("strong", { children: proposal.label }), _jsx("span", { style: {
+                            ...styles.riskBadge,
+                            background: proposal.risk === "high" ? "#fee2e2" : "#fef3c7",
+                            color: proposal.risk === "high" ? "#991b1b" : "#92400e",
+                        }, children: proposal.risk === "high" ? "Needs care" : "Confirm" })] }), _jsx("p", { style: styles.cardDescription, children: proposal.description }), entries.length > 0 && (_jsx("dl", { style: styles.cardInput, children: entries.map(([key, value]) => (_jsxs("div", { style: styles.cardRow, children: [_jsx("dt", { style: styles.cardKey, children: humanizeKey(key) }), _jsx("dd", { style: styles.cardValue, children: _jsx(InputValue, { value: value }) })] }, key))) })), _jsxs("div", { style: styles.cardActions, children: [_jsx("button", { type: "button", onClick: () => onRespond(proposal.proposalId, false), style: styles.secondaryButton, children: "Cancel" }), _jsx("button", { type: "button", onClick: () => onRespond(proposal.proposalId, true), style: styles.primaryButton, children: "Confirm" })] })] }));
+}
+/** Lists stay separate so a user can check each line before approving. */
+function InputValue({ value }) {
+    if (Array.isArray(value) && value.length > 0) {
+        return (_jsx("ol", { style: styles.inputList, children: value.map((item, index) => (_jsx("li", { children: _jsx(InputValue, { value: item }) }, index))) }));
+    }
+    return _jsx("span", { style: styles.inputText, children: formatValue(value) });
+}
+const styles = {
+    card: {
+        border: "1px solid #e2e8f0",
+        borderRadius: 10,
+        padding: 12,
+        background: "#fff",
+        boxShadow: "0 2px 8px rgba(15,23,42,0.06)",
+    },
+    cardHeader: {
+        display: "flex",
+        alignItems: "center",
+        justifyContent: "space-between",
+        gap: 8,
+        marginBottom: 6,
+    },
+    riskBadge: {
+        fontSize: 11,
+        fontWeight: 600,
+        padding: "2px 8px",
+        borderRadius: 999,
+        whiteSpace: "nowrap",
+    },
+    cardDescription: { margin: "0 0 10px", color: "#475569", fontSize: 13 },
+    cardInput: { margin: "0 0 12px", display: "flex", flexDirection: "column", gap: 8, maxHeight: "40vh", overflowY: "auto" },
+    cardRow: { display: "flex", flexWrap: "wrap", gap: 8, fontSize: 13 },
+    cardKey: { color: "#64748b", minWidth: 90, margin: 0 },
+    cardValue: { margin: 0, fontWeight: 500, overflowWrap: "anywhere", minWidth: 0, flex: "1 1 160px" },
+    inputList: { margin: 0, paddingLeft: 20, display: "grid", gap: 8 },
+    inputText: { whiteSpace: "pre-wrap" },
+    cardActions: { display: "flex", gap: 8, justifyContent: "flex-end" },
+    secondaryButton: {
+        padding: "7px 14px",
+        borderRadius: 8,
+        border: "1px solid #cbd5e1",
+        background: "#fff",
+        cursor: "pointer",
+        font: `500 13px ${FONT}`,
+    },
+    primaryButton: {
+        padding: "7px 14px",
+        borderRadius: 8,
+        border: "none",
+        background: "#4f7cff",
+        color: "#fff",
+        cursor: "pointer",
+        font: `600 13px ${FONT}`,
+    },
+};
+//# sourceMappingURL=card.js.map

package/dist/card.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"card.js","sourceRoot":"","sources":["../../../react/src/card.tsx"],"names":[],"mappings":"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"}

package/dist/hooks.d.ts

@@ -0,0 +1,189 @@
+/**
+ * The three registration hooks (spec §8.3–8.5).
+ *
+ * All three are declarative: a screen or component is registered while it is
+ * mounted and gone when it unmounts, so the assistant's picture of the app can
+ * never describe something the user is no longer looking at.
+ */
+import { COMPONENT_ATTRIBUTE, type ActionHandler, type AssistantChart, type AssistantTable, type AssistantTabs, type ComponentDeclaration, type ScreenDeclaration } from "@mihe-dev/js";
+export type { AssistantChart, AssistantQueryParam, AssistantTable, AssistantTableColumn, AssistantTableQuery, AssistantTabs, } from "@mihe-dev/js";
+/**
+ * Declare the screen the user is on.
+ *
+ * Call once per page or view. `visibleData` is what makes answers concrete —
+ * "you have 7 low-stock products" rather than "check your stock levels" — so
+ * include the summary values already on screen, and only those.
+ */
+export declare function useAssistantScreen(screen: ScreenDeclaration): void;
+/**
+ * Declare a component the assistant can talk about or point at, and get back
+ * the props that make it findable.
+ *
+ * ```tsx
+ * const props = useAssistantComponent("products.addButton", {
+ *   type: "button",
+ *   label: "Add Product",
+ *   description: "Opens the form to create a new product",
+ * });
+ * return <button {...props}>Add Product</button>;
+ * ```
+ *
+ * The returned props must be spread onto a real DOM element. Without them the
+ * component is described to the assistant but cannot be highlighted, which
+ * produces the confusing case of an assistant confidently pointing at nothing.
+ */
+export declare function useAssistantComponent(componentKey: string, meta: ComponentDeclaration): {
+    [COMPONENT_ATTRIBUTE]: string;
+};
+/**
+ * Register a handler for an action the assistant may run in the browser.
+ *
+ * The action itself — its risk tier, permissions, and whether it needs
+ * confirmation — is configured in the dashboard, not here. This only supplies
+ * the code that runs once the runtime has decided it may.
+ *
+ * Whatever the handler returns becomes the tool result the model sees, so
+ * return something descriptive: `{ shown: 7 }` tells it more than `undefined`.
+ * Throwing is fine and reports honestly — the assistant will tell the user it
+ * failed rather than claiming success.
+ */
+export declare function useAssistantAction(action: ActionHandler): void;
+/**
+ * Let the assistant see which tab is open and switch to another.
+ *
+ * ```tsx
+ * const [tab, setTab] = useState("sales");
+ * useAssistantTabs({
+ *   id: "reports.tabs",
+ *   label: "Report",
+ *   tabs: [{ value: "sales", label: "Sales" }, { value: "stock", label: "Stock" }],
+ *   value: tab,
+ *   onChange: setTab,
+ * });
+ * ```
+ *
+ * Tabs are built a dozen ways — a UI library's component, a route segment, a
+ * query parameter, plain state — so the SDK never touches them. It reports
+ * what you declare and calls your `onChange`, and the runtime only ever asks
+ * for a value you listed (amendment 67).
+ *
+ * Pass the tab that is really showing as `value`. The assistant is told it,
+ * and a switch is not reported done until `value` matches what was asked.
+ */
+export declare function useAssistantTabs(tabs: AssistantTabs): void;
+/**
+ * Let the assistant read a table on the screen.
+ *
+ * ```tsx
+ * useAssistantTable({
+ *   id: "orders.table",
+ *   label: "Orders",
+ *   columns: [
+ *     { key: "orderNumber", label: "Order" },
+ *     { key: "total", label: "Total" },
+ *   ],
+ *   rows: orders,
+ *   rowId: (order) => order.id,
+ *   rowIdName: "orderId",
+ *   total,
+ * });
+ * ```
+ *
+ * The rows are not sent with the screen. The model is told the table and its
+ * columns, and reads rows with `read_table` when a question needs them, so a
+ * table costs a line per answer rather than its contents (amendment 67).
+ * Only the declared columns ever leave the browser, and cell text is treated
+ * as data, never instructions.
+ */
+export declare function useAssistantTable<Row>(table: AssistantTable<Row>): void;
+/**
+ * Add the figures a component shows to the screen's `visibleData`, under
+ * `key`.
+ *
+ * For values that live below the page that calls `useAssistantScreen`: the
+ * stat cards inside a tab, a summary panel. They are dropped when the
+ * component unmounts or the screen changes, and held back while the screen
+ * says it is loading, as `visibleData` is.
+ *
+ * ```tsx
+ * useAssistantValues("stockSummary", { currentStockValue, periodInflow });
+ * ```
+ */
+export declare function useAssistantValues(key: string, values: Record<string, unknown>): void;
+/**
+ * Let the assistant explain a chart.
+ *
+ * ```tsx
+ * useAssistantChart({
+ *   id: "stock.trend",
+ *   title: "Stock trend",
+ *   data: series,
+ *   x: { key: "bucket", label: "Month", format: (v) => monthLabel(String(v)) },
+ *   series: [
+ *     { key: "inflowValue", name: "Stock in", unit: "NGN" },
+ *     { key: "outflowValue", name: "Stock out", unit: "NGN" },
+ *   ],
+ * });
+ * ```
+ *
+ * Each series is summarised here, in the browser, and the summary is what
+ * the model gets with the screen: start, end, high, low, total and the
+ * largest steps. That answers most questions about a trend in a few dozen
+ * tokens a series. The points are read with `read_chart` when an exact value
+ * is wanted (amendment 67). A picture of the chart is never sent.
+ */
+export declare function useAssistantChart<Datum>(chart: AssistantChart<Datum>): void;
+/** Props that turn any element into an assistant trigger. */
+export interface AssistantTriggerProps {
+    onClick: () => void;
+    onKeyDown: (event: {
+        key: string;
+        preventDefault: () => void;
+    }) => void;
+    role: "button";
+    tabIndex: 0;
+    "aria-expanded": boolean;
+    "aria-controls": string;
+    "aria-haspopup": "dialog";
+}
+/**
+ * Make anything open the assistant — a nav button, a menu item, a card, a
+ * plain div.
+ *
+ * ```tsx
+ * const trigger = useAssistantTrigger();
+ * return <div {...trigger}>Ask the assistant</div>;
+ * ```
+ *
+ * The `role`, `tabIndex`, and `onKeyDown` are why this is a hook rather than
+ * advice to call `toggle()` yourself: a `div` with only an `onClick` is
+ * invisible to keyboards and screen readers, and that is the most common way
+ * a custom trigger ships broken. On a real `<button>` they are harmless.
+ *
+ * **Returns `null` when there is no assistant**, so the caller can render
+ * nothing rather than a control that does not work. Triggers live in shared
+ * chrome — a command palette, a nav item, a help link — which is exactly the
+ * code that renders whether or not a host app has configured the assistant.
+ * Throwing there would make the whole surface conditional on something it has
+ * no reason to know about.
+ */
+export declare function useAssistantTrigger(): AssistantTriggerProps | null;
+/**
+ * A one-tap "ask this" trigger, for suggestion chips and contextual help
+ * links.
+ *
+ * ```tsx
+ * <button onClick={useAssistantPrompt("How do I add a product?")}>
+ *   How do I add a product?
+ * </button>
+ * ```
+ *
+ * Sending opens the assistant, so the reply is visible without the host app
+ * having to coordinate two calls.
+ *
+ * `null` when there is no assistant, for the same reason as
+ * [`useAssistantTrigger`]: a chip that silently does nothing is worse than one
+ * that was never rendered.
+ */
+export declare function useAssistantPrompt(text: string): (() => void) | null;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../react/src/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EACL,mBAAmB,EAOnB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACvB,MAAM,cAAc,CAAC;AAItB,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,GACd,MAAM,cAAc,CAAC;AAEtB;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAalE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,oBAAoB,GACzB;IAAE,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAAE,CAiBnC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAgB9D;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAsB1D;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,KAAK,EAAE,cAAc,CAAC,GAAG,CAAC,GAAG,IAAI,CAoBvE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAarF;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,IAAI,CAiB3E;AAED,6DAA6D;AAC7D,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,SAAS,EAAE,CAAC,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,IAAI,CAAA;KAAE,KAAK,IAAI,CAAC;IACxE,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,CAAC,CAAC;IACZ,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,QAAQ,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,IAAI,qBAAqB,GAAG,IAAI,CAuBlE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAKpE"}