Metadata-Version: 2.4
Name: heyasa
Version: 0.1.1
Summary: Hey Asa — Unified Autonomous CLI Shell & Multi-Protocol Gateway for willman, willpad (willmux), and subactor standardized by wellmanifest/wellman and wellmanifest/nl-*
Author: Tom Sapletta
Author-email: Tom Sapletta <tom@sapletta.com>
License-Expression: Apache-2.0
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: mcp
Requires-Dist: mcp>=1.0.0; extra == "mcp"
Provides-Extra: grpc
Requires-Dist: grpcio>=1.60.0; extra == "grpc"
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: goal>=2.1.0; python_version >= "3.12" and extra == "dev"
Requires-Dist: costs>=0.1.53; python_version >= "3.9" and extra == "dev"
Dynamic: license-file

# Hey Asa (`heyasa`)

**Unified Autonomous CLI Shell & Multi-Protocol Gateway** dla ekosystemów **`willman`**, **`willpad` (`willmux`)** oraz **`subactor`** (a także wtyczek **`dockuri`** i **`taskand`**), ustandaryzowany przez **`wellmanifest/wellman`**, **`wellmanifest/autonomy`** oraz rodzinę **`wellmanifest/nl-*`** (`nl-dsl-llm`, `nl-uri-dsl-llm`, `nl-api-llm`).

## Główne właściwości

- **Jedna nazwa i marka**: `heyasa` (asystent **Asa**, wake phrase: `Hey Asa`).
- **Wybór silnika autonomicznego (`-e` / `--engine`)**:
  - `auto` (domyślny — deterministyczny klasyfikator intencji `nl-uri-dsl-llm` + `willuri`),
  - `willman` — kolejka zadań DAG, cykl bodźców Koru (`stimulate`), obserwacyjna samonaprawa (`willman.observation-policy/v1`), flota projektów (`ProjectFleet`), artefakty,
  - `willpad` — sterownik przestrzeni roboczej `willmux` (okna `A`–`F`, centralny pad w trybach `quad`/`radial`/`panel`, kompaktowy czat Table 4, narzędzia okien `shot`/`ocr`/`copy`/`record`, plany z zależnościami `chat_plan`/`chat_run`, Rynek),
  - `subactor` — kontraktowa autonomia z `../subactor` (`IntentIR v1` → `ExecutionPlan` → bramka `AQL` → `OQL` → `urirun`, Founder Control `:8091`, `subactor-shell` ACP/SQLite/Vault),
  - `dockuri` — modularne usługi autonomiczne `proc://.../v1` (`QueueHealService`, `SelfImprovementService`, `FinancialIntegrityService`, `ScannerIndexService`),
  - `taskand` — kapsuły wykonawcze `proc://.../v1` i workflowy przeglądarkowe `task2willmux`.
- **Domyślne poziomy autonomii (`--autonomy`)**:
  - **Tryb interaktywny (TTY / REPL)**: `confirm` — prezentuje plan i oczekuje na zgodę operatora przed wykonaniem mutacji,
  - **Tryb wsadowy / agentowy (non-TTY / batch)**: `execute-once` — wykonuje maksymalnie jeden atomowy cykl i automatycznie wraca do stanu `safe`,
  - Pozostałe tryby: `suggest` (tylko plan / `--dry-run`) oraz `auto` (w ramach jawnego grantu autonomii).
- **Wieloprotokołowe interfejsy**:
  - `heyasa [polecenie]` / `heyasa shell` — CLI one-shot oraz interaktywny REPL,
  - `heyasa mcp` — serwer MCP (`stdio` oraz `streamable-http` na `:7081`) zgodny z `NUL-015`,
  - `heyasa serve` — zunifikowany serwer REST + SSE (`:7080`),
  - `heyasa grpc` — serwer gRPC (`:7082` oraz UDS),
  - `heyasa acp` — serwer Agent Client Protocol v1 (`stdin/stdout` JSON-RPC),
  - `heyasa open <uri>` — dispatcher RFC 3986 Action URI (`heyasa://`, `willpad://`, `willmux://`, `willman://`, `subactor://`, `proc://`),
  - `heyasa switch <tool|pane|preset|next|prev>` — błyskawiczne przełączanie narzędzi na ekranie (`chat`, `files`, `willman`, `subactor`, `dockuri`, `approval`, presety `ops`/`dev`/`compact`),
  - `heyasa hud [--top|--bottom|--bench|--export-tauri]` — uruchamianie i przełączanie okna HUD (`willmux` / `willman`) zajmującego maksymalnie **50% wysokości ekranu** (Quake-style scratchpad / Tauri v2 Wry / Chromium `--app`).



## License

Licensed under Apache-2.0.
