@abstractframework/observer 0.1.12 → 0.1.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -4,16 +4,15 @@ Gateway-only observability UI (Web/PWA) for AbstractFramework runs.
4
4
 
5
5
  What it does (implemented in `src/ui/app.tsx` + `src/lib/gateway_client.ts`):
6
6
  - **Discover** workflows/bundles exposed by an AbstractGateway
7
- - **Launch** or **schedule** runs (durable)
7
+ - **Launch** runs, or create **automations** that the gateway runs on a schedule (durable)
8
8
  - **Observe** runs and subruns by replaying + streaming the durable **ledger** (replay-first + SSE)
9
9
  - **Inspect runtime state** across active runs, generated artifacts, provider calls, and gateway audit logs
10
10
  - **Control** runs via durable commands (`pause`, `resume`, `cancel`)
11
11
  - (Optional) **Voice** in run chat: gateway-based TTS + push-to-talk transcription (`src/ui/use_gateway_voice.ts`)
12
12
 
13
- ## Watching entities (the entity app moved)
13
+ ## Watching entities (the entity app)
14
14
 
15
- The **entity app** (memory graph + visits UI, formerly `/entity.html`)
16
- lives in its own package since 2026-07-12:
15
+ The **entity app** (memory graph + visits UI) is its own package,
17
16
  [AbstractEntity](https://github.com/lpalbou/AbstractEntity)
18
17
  (`npx @abstractframework/entity`, default port `3007`). The observer still
19
18
  *watches* entities — the Board's entities strip reads
@@ -32,7 +31,7 @@ flowchart LR
32
31
  U[User] --> O[AbstractObserver<br/>browser UI]
33
32
  O -->|HTTP fetch + SSE| G[AbstractGateway<br/>/api/gateway/*]
34
33
  G --> R[AbstractRuntime<br/>durable runs + append-only ledger]
35
- R --> C[AbstractCore<br/>LLM + tools (optional)]
34
+ R --> C["AbstractCore<br/>LLM + tools (optional)"]
36
35
  ```
37
36
 
38
37
  ## Quickstart (npm)
@@ -73,7 +72,7 @@ abstractobserver
73
72
 
74
73
  ### Pin a version (recommended for deployments)
75
74
  ```bash
76
- npx --yes --package @abstractframework/observer@0.1.12 -- abstractobserver
75
+ npx --yes --package @abstractframework/observer@0.1.14 -- abstractobserver
77
76
  ```
78
77
 
79
78
  ### CLI configuration
@@ -92,10 +91,12 @@ All pages share the same gateway connection settings.
92
91
 
93
92
  - **Board** (Mission Control, the landing page): kanban columns Pending / Working / Review / Done across every run — cards move themselves by state; the Review column carries inline Approve/Deny/Answer; an entities strip shows each entity's phase and links into the entity app; run lists poll live (5s visible / 30s hidden)
94
93
  - **Observe**: workflow/subworkflow navigator, overview, human timeline, raw ledger, provider calls, graph, digest, attachments, chat (optional voice: PTT + TTS)
95
- - **Runtime**: Activity, Artifacts, Memory, and Logs modes for platform-level monitoring. The Artifact Explorer uses Gateway artifact envelopes and exact stats, separates Voice/Music/Sound/unclassified audio from render kinds such as Markdown/HTML/JSON, previews media inline, and links artifacts back to producing runs, ledgers, and trace/audit actions when metadata is available
96
- - **Launch**: start runs, schedule runs, bundle upload/reload
97
- - **Runtime → Memory**: knowledge-graph (active memory) query UI (requires `POST /api/gateway/kg/query`)
94
+ - **System** (the Runtime view): Activity, Artifacts, Memory, and Logs modes for platform-level monitoring. The Artifact Explorer uses Gateway artifact envelopes and exact stats, separates Voice/Music/Sound/unclassified audio from render kinds such as Markdown/HTML/JSON, previews media inline, and links artifacts back to producing runs, ledgers, and trace/audit actions when metadata is available
95
+ - **Launch**: Run once, or Automate (what, when in UTC intervals, independent or growing context, tool approval); bundle upload/reload
96
+ - **Automations**: every automation of the signed-in user, with pause/resume/run now (also while paused)/stop current/revise/archive, its runs read as a conversation, answers to waiting runs by kind (question, tool approval, event), and Discuss (a fork at an occurrence with its full history, its own workspace and the automation's files read-only); legacy schedules keep their controls and can be recreated as automations (`docs/automations.md`)
97
+ - **System → Memory**: knowledge-graph (active memory) query UI (requires `POST /api/gateway/kg/query`)
98
98
  - **Settings**: connection status, theme and display preferences, optional remote tool worker
99
+ - **About** (the info button in the top bar): the AbstractObserver version, links to its website, source, documentation and issue tracker, and the versions the connected gateway reports
99
100
 
100
101
  ## Documentation
101
102
  - Start here: `docs/getting-started.md`
@@ -104,6 +105,8 @@ All pages share the same gateway connection settings.
104
105
  - Architecture (with diagrams): `docs/architecture.md`
105
106
  - Configuration & deployment: `docs/configuration.md`
106
107
  - API (gateway endpoints used): `docs/api.md`
108
+ - Automations (create, manage, answer, discuss): `docs/automations.md`
109
+ - Troubleshooting: `docs/troubleshooting.md`
107
110
  - Development: `docs/development.md`
108
111
  - Security & trust boundaries: `docs/security.md`
109
112
 
@@ -112,6 +115,7 @@ All pages share the same gateway connection settings.
112
115
  - Contributing: `CONTRIBUTING.md`
113
116
  - Security policy (vulnerability reporting): `SECURITY.md`
114
117
  - Acknowledgments: `ACKNOWLEDGMENTS.md`
118
+ - Code of conduct: `CODE_OF_CONDUCT.md`
115
119
 
116
120
  ## Development (from source)
117
121
  ```bash