gz-research-assistant 0.1.0

package/README.md

@@ -0,0 +1,43 @@
+# gz-research-assistant
+
+Installable research assistant with gz-ui components, diagnostics, recording, assertions and local replay integration. Requires React 19 and gz-ui's peer dependencies.
+
+```sh
+npm install gz-research-assistant @chenhui996/gg-ui @ant-design/icons antd react react-dom
+```
+
+```tsx
+import { useEffect } from 'react';
+import {
+  ResearchAssistant,
+  startAssistant,
+  assistantRuntime,
+  recorder,
+} from 'gz-research-assistant';
+import '@chenhui996/gg-ui/gg-ui.css';
+import 'gz-research-assistant/style.css';
+
+export function AssistantForSession() {
+  useEffect(() => {
+    const stop = startAssistant();
+    return () => {
+      stop();
+      assistantRuntime.clear();
+      recorder.clear();
+    };
+  }, []);
+  return <ResearchAssistant developer bridgeUrl="/__laya-pilot" />;
+}
+```
+
+Mount one instance per page after login. Remount with a user/session key and clear on logout. The package never imports your store or reads your token. `startAssistant({isBusinessFailure, ignoreRequest})` lets the host define response-code semantics and excluded requests. Hooks are installed once and restored by the returned cleanup. Keep a single lifecycle owner.
+
+For imperative SDK integration, import `mountAssistant` from `gz-research-assistant/sdk`, call it with a container, props and runtime options, then invoke the returned disposer on logout/unmount. For diagnostics without React UI use `gz-research-assistant/core`. Import the same CSS for SDK use.
+
+Browser automation uses `gz-laya-pilot` as a dependency. The browser imports only its schema and semantic targets. To execute, the host provides a same-origin bridge to a Node process calling `runCase`; never bundle Node execution or model keys into the browser. This repository's `vite/laya-pilot.plugin.ts` and `tools/laya-pilot-recorded-runner.mjs` are a restricted localhost mock adapter, not a production test service.
+
+Bridge: `GET /status` returns RunStatus + available; `POST /run` accepts `{testCase, delay, headed}` and returns 202 + status; `POST /stop` stops the run. POST uses JSON and `X-Laya-Pilot: recorded-case-v1`. The host must authenticate, validate input, restrict test targets and serialize runs. Server results use idle/running/passed/completed/failed/stopped and assertion evidence.
+
+Timeline data stays in memory (300 events / 60 requests / 15 minutes), with private inputs excluded and JSON previews redacted. Timeline text is presentation only. Passive history never reconstructs input values or runnable selectors. Active recordings store structured targets and actions; add `data-testid`, proper labels or `data-assistant-label` to improve semantics. Closed Shadow DOM and cross-origin frames require host adapters.
+
+OverlayScrollbars handles scroll visibility/dragging. Performance warnings are bounded heuristics, not proof of a memory leak. rrweb visual replay and OpenTelemetry trace correlation are optional future integrations, not silently enabled collection.

package/dist/AssistantAvatar.d.ts

@@ -0,0 +1 @@
+export default function AssistantAvatar(): import("react/jsx-runtime").JSX.Element;

package/dist/FloatingPanel.d.ts

@@ -0,0 +1,9 @@
+import { type FC, type ReactNode } from 'react';
+interface Props {
+    open: boolean;
+    onMinimize: () => void;
+    children: ReactNode;
+    developer: boolean;
+}
+declare const FloatingPanel: FC<Props>;
+export default FloatingPanel;

package/dist/PerformancePanel.d.ts

@@ -0,0 +1,8 @@
+import { type PerformanceEvidence } from './performance';
+export default function PerformancePanel({ metrics, data, now, paused, offline, }: {
+    metrics: Record<string, number>;
+    data: PerformanceEvidence;
+    now: number;
+    paused: boolean;
+    offline: boolean;
+}): import("react/jsx-runtime").JSX.Element;