@abstractframework/observer 0.6.2 → 0.7.0

package/dist/index.html

@@ -19,8 +19,8 @@
     <!-- Favicon -->
     <link rel="icon" type="image/svg+xml" href="icon.svg" />
     <title>AbstractObserver</title>
-    <script type="module" crossorigin src="./assets/index-mOSIboQ8.js"></script>
-    <link rel="stylesheet" crossorigin href="./assets/index-CFQCB7Xx.css">
+    <script type="module" crossorigin src="./assets/index-C1U8dkAL.js"></script>
+    <link rel="stylesheet" crossorigin href="./assets/index-gYGGRAVm.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/llms.txt

@@ -0,0 +1,69 @@
+# AbstractObserver
+
+> Gateway-only observability UI (Web/PWA) for AbstractFramework runs: a browser SPA + tiny Node.js CLI that connects to an AbstractGateway HTTP API (HTTP fetch + SSE ledger streaming) and submits durable commands.
+
+This repository is UI-only:
+- The packaged CLI (`bin/cli.js` + `bin/server.js`) serves `dist/` (SPA fallback) at `/` or through the gateway at `/apps/observer/` (app-server mount contract: identity header, `<base href>`, cookie path, forwarded client address) and proxies `api/` to the Gateway after browser-session sign-in, using `@abstractframework/app-server`.
+- The browser talks to same-origin `/api` in hosted mode; direct Gateway URLs remain available for local development via `src/lib/gateway_client.ts` (treat this file as the source of truth for HTTP endpoints and request shapes).
+- Hosted sign-in uses Gateway URL + user + token only to create an app-scoped browser session. Settings persistence strips Gateway bearer tokens. With `@abstractframework/app-server` 0.1.10 or newer the proxy sends the browser's connection address as `X-Forwarded-For` and `X-AbstractFramework-App-Proxy: abstractobserver` to the Gateway.
+- On non-local hosted UI hostnames, the server-configured Gateway URL is authoritative; browser-supplied Gateway URL changes are rejected unless `ABSTRACTOBSERVER_ALLOW_REMOTE_BROWSER_GATEWAY_CONFIG=1` is enabled behind access control. Forwarded host headers are trusted only when `ABSTRACTOBSERVER_TRUST_PROXY_HEADERS=1` or `ABSTRACTGATEWAY_TRUST_PROXY_HEADERS=1`.
+
+## Quickstart
+- Run packaged UI server (no build step): `npx --yes --package @abstractframework/observer -- abstractobserver`
+- Dev server (Vite; proxies `/api` in dev): `npm install && npm run dev`
+- Unit tests (Vitest): `npm test`
+- Production build (writes `dist/`): `npm run build`
+- Regenerate `llms-full.txt`: `npm run llms:full`
+
+Notes:
+- Build output lives in `dist/` and is served by `bin/cli.js` (don’t edit `dist/` manually).
+- `@abstractframework/ui-kit` and `@abstractframework/panel-chat` are npm dependencies; the monitor packages are Vite aliases to sibling `../abstractuic/*/src` (see `vite.config.ts` and `docs/development.md`).
+- Responsive layout (phones, tablets, small windows): `docs/getting-started.md` → "Responsive layout"; rules in `src/ui/responsive.css`.
+- On/off switches and opening the Observer over plain http from another computer (voice needs https): `docs/getting-started.md` → "Switches", "Open the Observer from another computer over http"; fallbacks in `src/lib/secure-context.ts`.
+- Voice (Read aloud streamed per sentence, dictation in Ask/Discuss, Settings → Voice = the kit section with the gateway's default routes from `GET /voice/defaults`): `docs/faq.md` → "Does it support voice", routes in `docs/api.md` → Voice; code `src/ui/observer_voice.tsx`; tests `src/ui/observer_voice.test.tsx` + `scripts/voice_e2e.mjs` (fake routes: `scripts/fake_voice_proxy.mjs`). Needs AbstractGateway 0.13.0 or later.
+- Archived conversations: the Board appends `GET /runs?root_only=true&archived_only=true` (AbstractGateway 0.13.0+) and tags those runs **Archived**; Observer lists runs, not sessions, so it has no Archive button: `docs/api.md` → Runs, `docs/faq.md`; code `with_archived_roots()` in `src/ui/automations.ts`.
+- About: the shared ui-kit compact card (app, framework and gateway versions, links, licence line) from `GET /api/gateway/about`: `docs/faq.md` → "Which version am I running?"; code `src/ui/about.ts`.
+- `llms.txt` format reference: https://llmstxt.org/
+
+## Documentation (start here)
+- [README](README.md): Install and quickstart
+- [Getting started](docs/getting-started.md): Run the UI and connect to a gateway; Ask about a run (whole conversation, History note when the 50k-token window drops older messages, error cards never sent back) vs the top-bar Assistant (one gateway session per conversation, New conversation, no tools)
+- [FAQ](docs/faq.md): Common questions (grounded in code), including the CLI `/api` session proxy, the About dialog, chat history windows and the tool-less Assistant
+- [Docs index](docs/README.md): What to read next
+- [Architecture](docs/architecture.md): Components, data flow, diagrams
+- [Configuration](docs/configuration.md): launch flags, serving under the gateway at /apps/observer/, UI settings, deployment patterns
+- [API](docs/api.md): Gateway endpoints used by the UI, including Runtime Activity run pages and canonical artifact envelope search/stats for Runtime Artifact Explorer
+- [Automations](docs/automations.md): configurable growing-context budgets and result email; Launch → Automate (what, when in UTC intervals, independent/growing context, tool approval), the Automations page (icon controls, Edit: the row's Edit opens the form — title, task, interval, context, tools —, 409 conflicts), runs as a conversation, answering waits by kind, the automation's files (browse, open, download through the gateway), Discuss as an in-page chat with a fork, automation tags on Board/Observe/System, legacy schedules and Recreate, the stub gateway
+- [Development](docs/development.md): Local dev, workspace deps, tests, build
+- [Security](docs/security.md): Trust boundaries and operational guidance
+- [Troubleshooting](docs/troubleshooting.md): Common issues and fixes (CORS, mixed content, 401 under `/api`, About shows the gateway unavailable, stale service worker, automations)
+
+## Key entrypoints (code)
+- [CLI](bin/cli.js) and [app server](bin/server.js): launch flags (`--gateway-url`, `--port`, `--host`, `--monitor-gpu`, `--entity-app-url`, `--gateway-dir`), mount-capable handler, session proxy, folder reveal (browsers on this machine only)
+- [App shell + pages](src/ui/app.tsx): settings, page routing, observe/launch flows, durable commands
+- [Gateway client](src/lib/gateway_client.ts): HTTP client + SSE ledger streaming (API source of truth)
+- [Automations rules + controller](src/ui/automations.ts): workflow choice (`@default`), create body, run tags, capability gate, legacy prefill, typed wait answers, page controller
+- [Automations page](src/ui/automations_page.tsx) and [Automate fields](src/ui/automate_form.tsx): the page, rows and the ui-kit `AutomationPanel` wiring; the When/Context/Tools fields
+- [Discussion chat](src/ui/automation_discussion.tsx): panel-chat `WorkflowChat` + `presentInteraction` over the gateway client; folders through panel-chat `WorkspaceBrowser` (`/runs/{id}/workspace*`)
+- [Automations stub gateway](scripts/automations_stub_server.mjs): dev/test stub serving the ui-kit fixtures
+- [Vite config](vite.config.ts): workspace aliases + dev session proxy and `/api` fallback proxy
+- [Package metadata](package.json): npm name/version, scripts, Node engine
+- [llms-full generator](scripts/generate-llms-full.mjs): defines which files are embedded into `llms-full.txt`
+
+## Ecosystem context
+- [AbstractFramework](https://github.com/lpalbou/AbstractFramework): ecosystem entrypoint and component map
+- [AbstractRuntime](https://github.com/lpalbou/abstractruntime): durable workflow runtime behind the gateway ledger
+- [AbstractCore](https://github.com/lpalbou/abstractcore): unified LLM + tools layer commonly used by workflows
+
+## Common tasks
+- Add/change a gateway capability: update `src/lib/gateway_client.ts` (source of truth) → update `docs/api.md` → run `npm test` + `npm run build`.
+- Change CLI behavior/config: update `bin/cli.js` / `bin/server.js` → update `docs/configuration.md` → run `npm run build`.
+- Update docs for agents: edit docs → regenerate `llms-full.txt` with `npm run llms:full`.
+
+## Optional (project meta)
+- [Changelog](CHANGELOG.md): Release notes
+- [Contributing](CONTRIBUTING.md): How to develop and submit changes
+- [Security policy](SECURITY.md): Responsible vulnerability reporting
+- [Acknowledgments](ACKNOWLEDGMENTS.md): Credits
+- [Code of conduct](CODE_OF_CONDUCT.md): Conduct expectations and reporting
+- [License](LICENSE): MIT license

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@abstractframework/observer",
-  "version": "0.6.2",
+  "version": "0.7.0",
   "description": "Gateway-only observability UI for AbstractFramework - connect to a Run Gateway, replay/stream the ledger, and submit durable commands",
   "type": "module",
   "author": "Laurent-Philippe Albou",
@@ -44,8 +44,8 @@
   },
   "dependencies": {
     "@abstractframework/app-server": "^0.1.11",
-    "@abstractframework/panel-chat": "^0.2.5",
-    "@abstractframework/ui-kit": "^0.5.2",
+    "@abstractframework/panel-chat": "^0.4.1",
+    "@abstractframework/ui-kit": "^0.8.5",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "reactflow": "^11.10.4"