@a5c-ai/agent-mux-tui 0.4.0 → 0.4.10-staging.7a8768ec

package/README.md

@@ -12,6 +12,38 @@ npm i -g @a5c-ai/agent-mux-tui
 amux-tui
 ```
 
+## Development
+
+Package-level `build` and `test` scripts are routed through the repo-root
+`scripts/agent-mux-build.cjs` helper so `@a5c-ai/agent-mux-tui` runs with its
+agent-mux prerequisites built in dependency order and its tests executed from
+the repo root. Use `npm run build:local --workspace=@a5c-ai/agent-mux-tui`
+when you only want the package-local TypeScript compile.
+
+Run `npm run verify:release --workspace=@a5c-ai/agent-mux-tui` after a build to
+confirm the packed package surface still includes the README-linked kanban/workspaces
+planning artifacts.
+
+## Kanban/workspaces surface
+
+The package now ships first-phase `kanban` and `workspaces` views backed by the
+shared kanban/workspace control plane.
+
+- Runtime today: `kanban` view (list-first issue browsing, issue detail,
+  keyboard-driven backlog actions through an injected control plane, and linked
+  workspace/session handoff)
+- Runtime today: `workspaces` view (workspace inventory, linked issue/session/run
+  context, lifecycle actions routed through the injected control plane, and
+  issue/session handoff back into the rest of the TUI)
+
+- Spec: [`specs/kanban-workspaces-spec.md`](specs/kanban-workspaces-spec.md)
+- Backlog decomposition: [`specs/kanban-workspaces-subtasks.md`](specs/kanban-workspaces-subtasks.md)
+- Cross-package design note:
+  [`../../docs/agent-mux/archive/design/20-tui-kanban-workspaces.md`](../../docs/agent-mux/archive/design/20-tui-kanban-workspaces.md)
+
+The planning documents remain useful design references for follow-on expansion
+of both surfaces.
+
 ## Writing a plugin
 
 ```ts
@@ -69,3 +101,55 @@ Events from the resulting `client.run()` are pushed into the shared
 The built-in plugins (`text-delta`, `thinking-delta`, `tool-call`,
 `tool-error`, `cost`, `chat-view`, `sessions-view`, `fallback`) are all
 implemented through these same extension points — use them as references.
+
+The logs / observability view is part of the supported built-in surface. Press
+`l` to open it. The metrics header aggregates the full buffered `EventStream`,
+the global `/` filter only narrows the visible log rows, and pressing `e`
+exports the full buffered stream to `session-log-<timestamp>.json` in the
+current working directory.
+
+## View hotkeys
+
+| Key | View       | Purpose                                       |
+|-----|------------|-----------------------------------------------|
+| `1` | chat       | streaming run output + filter                 |
+| `2` | sessions   | session list (press `d` to inspect + export)  |
+| `3` | cost       | cost/usage summary                            |
+| `4` | adapters   | discovered adapters                           |
+| `5` | models     | model registry per adapter                    |
+| `6` | profiles   | run-options profiles                          |
+| `7` | plugins    | native plugins per adapter                    |
+| `8` | kanban     | backlog/board browsing + issue actions        |
+| `W` | workspaces | workspace lifecycle inventory + actions       |
+| `9` | help       | keybindings + tips                            |
+| `0` | mcp        | registered MCP servers                        |
+| `-` | doctor     | capability matrix / diagnostics               |
+| `l` | logs       | observability metrics + filtered log stream   |
+| `A` | auth       | auth status per adapter                       |
+| `C` | config     | config view                                   |
+| `K` | skills     | installed skills (d: delete, r: refresh)      |
+| `G` | agents     | installed sub-agents (d: delete, r: refresh)  |
+| `H` | hooks      | registered hooks (d: remove, r: refresh)      |
+
+Global: chat composer auto-focuses in `chat`; `Esc` temporarily dismisses it;
+`/` filter, `:` / Ctrl-K palette, `m` model picker, `N` agent picker, `P`
+profile picker, `i` interrupt, `y`/`n` approval, `q` quit.
+
+Inside `kanban`, press `w` to jump to the linked workspace for the selected
+issue. Inside `workspaces`, press `g` to jump back to the linked issue. If you
+open `session-detail` from either view, `b`/`Esc` returns to the originating
+surface instead of always falling back to `sessions`.
+
+## Logs / Observability View
+
+The `logs` view is a built-in tab registered as `builtin:observability-view`.
+
+- Hotkey: `l`
+- Purpose: show aggregated tokens, cost, latency, error count, and tool-call
+  count for the buffered event stream.
+- Filtering: the global `/` filter applies to the log rows in this view,
+  including `type:<prefix>` filters. Metrics continue to reflect the full
+  buffered stream so you can inspect a subset without losing session totals.
+- Export: press `e` while the view is active to write the full buffered event
+  stream as pretty-printed JSON to `session-log-<timestamp>.json` in the
+  current working directory.

package/dist/app.d.ts

@@ -1,9 +1,27 @@
-import type { AgentMuxClient } from '@a5c-ai/agent-mux';
+import type { AgentMuxClient, DeferredPromptTarget, RunHandle } from '@a5c-ai/agent-mux';
 import type { TuiPlugin } from './plugin.js';
+import type { KanbanControlPlane } from './kanban-control-plane.js';
 export interface AppProps {
     client: AgentMuxClient;
     plugins: TuiPlugin[];
+    kanban?: KanbanControlPlane;
     defaultAgent?: string;
+    initialViewId?: string;
+    disableChatAutoPrompt?: boolean;
 }
-export declare function App({ client, plugins, defaultAgent }: AppProps): import("react/jsx-runtime").JSX.Element;
-//# sourceMappingURL=app.d.ts.map
+type ActiveRunCommand = {
+    kind: 'send';
+    prompt: string;
+} | {
+    kind: 'queue';
+    prompt: string;
+    when: DeferredPromptTarget;
+} | {
+    kind: 'steer';
+    prompt: string;
+    when: DeferredPromptTarget;
+};
+export declare function parseActiveRunCommand(prompt: string): ActiveRunCommand | null;
+export declare function dispatchPromptToActiveRun(handle: RunHandle, prompt: string): Promise<string>;
+export declare function App({ client, plugins, kanban, defaultAgent, initialViewId, disableChatAutoPrompt, }: AppProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAyB,MAAM,mBAAmB,CAAC;AAE/E,OAAO,KAAK,EAAE,SAAS,EAA+B,MAAM,aAAa,CAAC;AAO1E,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAQD,wBAAgB,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,YAA4B,EAAE,EAAE,QAAQ,2CA+Y9E"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAc,oBAAoB,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAErG,OAAO,KAAK,EAAE,SAAS,EAA+B,MAAM,aAAa,CAAC;AAa1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,KAAK,gBAAgB,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,oBAAoB,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,oBAAoB,CAAA;CAAE,CAAC;AAElE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAc7E;AAeD,wBAAsB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAelG;AA6BD,wBAAgB,GAAG,CAAC,EAClB,MAAM,EACN,OAAO,EACP,MAAM,EACN,YAAuB,EACvB,aAAsB,EACtB,qBAA6B,GAC9B,EAAE,QAAQ,2CA4rBV"}