@abstractframework/observer 0.1.6 → 0.1.9

package/README.md

@@ -6,7 +6,22 @@ What it does (implemented in `src/ui/app.tsx` + `src/lib/gateway_client.ts`):
 - **Discover** workflows/bundles exposed by an AbstractGateway
 - **Launch** or **schedule** runs (durable)
 - **Observe** runs by replaying + streaming the durable **ledger** (replay-first + SSE)
-- **Control** runs via durable commands (pause/resume/cancel/resume-wait)
+- **Control** runs via durable commands (`pause`, `resume`, `cancel`)
+- (Optional) **Voice** in run chat: gateway-based TTS + push-to-talk transcription (`src/ui/use_gateway_voice.ts`)
+
+## Where it fits (AbstractFramework ecosystem)
+AbstractObserver is one of the browser UIs in the **AbstractFramework** ecosystem:
+- AbstractFramework (ecosystem entrypoint): https://github.com/lpalbou/AbstractFramework
+- AbstractRuntime (durable runtime + ledger behind the gateway): https://github.com/lpalbou/abstractruntime
+- AbstractCore (LLM + tools integration used by runtime/workflows): https://github.com/lpalbou/abstractcore
+
+```mermaid
+flowchart LR
+  U[User] --> O[AbstractObserver<br/>browser UI]
+  O -->|HTTP fetch + SSE| G[AbstractGateway<br/>/api/gateway/*]
+  G --> R[AbstractRuntime<br/>durable runs + append-only ledger]
+  R --> C[AbstractCore<br/>LLM + tools (optional)]
+```
 
 ## Quickstart (npm)
 Prereqs:
@@ -15,9 +30,11 @@ Prereqs:
 
 Run the UI server:
 ```bash
-npx abstractobserver
+npx --yes --package @abstractframework/observer -- abstractobserver
 ```
 
+Note: the npm package is `@abstractframework/observer`, and the CLI binary is `abstractobserver`.
+
 Open `http://localhost:3001`, then go to **Settings** and configure:
 - **Gateway URL** (usually your gateway base URL, e.g. `http://localhost:8081`)
   - Leave it blank only for same-origin deployments (reverse proxy routes `/api`) or when using `npm run dev` (Vite `/api` proxy).
@@ -26,13 +43,13 @@ Open `http://localhost:3001`, then go to **Settings** and configure:
 ## Install options
 ### Global install
 ```bash
-npm install -g abstractobserver
+npm install -g @abstractframework/observer
 abstractobserver
 ```
 
 ### Pin a version (recommended for deployments)
 ```bash
-npx abstractobserver@0.1.4
+npx --yes --package @abstractframework/observer@0.1.6 -- abstractobserver
 ```
 
 ### CLI configuration
@@ -44,7 +61,7 @@ The CLI is a static file server implemented in `bin/cli.js`.
 ## Features (UI pages)
 All pages share the same gateway connection settings.
 
-- **Observe**: ledger, graph, digest, attachments, chat
+- **Observe**: ledger, graph, digest, attachments, chat (optional voice: PTT + TTS)
 - **Launch**: start runs, schedule runs, bundle upload/reload
 - **Mindmap**: knowledge-graph query UI (requires `POST /api/gateway/kg/query`)
 - **Backlog / Inbox (reports + email) / Processes**: maintainer tooling (high trust; requires additional gateway endpoints)
@@ -63,7 +80,7 @@ All pages share the same gateway connection settings.
 - Changelog: `CHANGELOG.md`
 - Contributing: `CONTRIBUTING.md`
 - Security policy (vulnerability reporting): `SECURITY.md`
-- Acknowledments: `ACKNOWLEDMENTS.md`
+- Acknowledgments: `ACKNOWLEDGMENTS.md`
 
 ## Development (from source)
 ```bash

package/bin/cli.js

@@ -15,9 +15,21 @@ const DIST_DIR = join(__dirname, '..', 'dist');
 const PORT = process.env.PORT || 3001;
 const HOST = process.env.HOST || '0.0.0.0';
 const ARGV = process.argv.slice(2);
+function parse_bool_env(name) {
+  const raw = process.env[name];
+  if (raw === undefined || raw === null || String(raw).trim() === "") return undefined;
+  const normalized = String(raw).trim().toLowerCase();
+  if (["1", "true", "yes", "on"].includes(normalized)) return true;
+  if (["0", "false", "no", "off"].includes(normalized)) return false;
+  console.warn(`#FALLBACK: ${name}="${raw}" is not a boolean; defaulting to false.`);
+  return false;
+}
+
 const MONITOR_GPU =
   ARGV.includes("--monitor-gpu") ||
   ["1", "true", "yes", "on"].includes(String(process.env.ABSTRACTOBSERVER_MONITOR_GPU || "").trim().toLowerCase());
+const ENABLE_BACKLOG = parse_bool_env("ABSTRACTOBSERVER_ENABLE_BACKLOG");
+const ENABLE_INBOX_TRIAGE = parse_bool_env("ABSTRACTOBSERVER_ENABLE_INBOX_TRIAGE");
 
 // MIME types for common file extensions
 const MIME_TYPES = {
@@ -40,10 +52,14 @@ function getMimeType(filePath) {
 }
 
 function inject_config_html(html) {
-  if (!MONITOR_GPU) return html;
+  const ui_config = {};
+  if (MONITOR_GPU) ui_config.monitor_gpu = true;
+  if (ENABLE_BACKLOG !== undefined) ui_config.enable_backlog = ENABLE_BACKLOG;
+  if (ENABLE_INBOX_TRIAGE !== undefined) ui_config.enable_inbox_triage = ENABLE_INBOX_TRIAGE;
+  if (!Object.keys(ui_config).length) return html;
   const marker = "window.__ABSTRACT_UI_CONFIG__";
   if (html.includes(marker)) return html;
-  const snippet = `<script>${marker}=Object.assign(${marker}||{}, { monitor_gpu: true });</script>`;
+  const snippet = `<script>${marker}=Object.assign(${marker}||{}, ${JSON.stringify(ui_config)});</script>`;
   if (html.includes("</head>")) return html.replace("</head>", `${snippet}\n</head>`);
   if (html.includes("</body>")) return html.replace("</body>", `${snippet}\n</body>`);
   return `${html}\n${snippet}\n`;