omnius 1.0.607 → 1.0.609

package/.aiwg/addons/omnius-docs/README.md

@@ -2,13 +2,15 @@
 
 This project-local addon exposes Omnius documentation as small discoverable skills. It is for agents that need to answer questions about Omnius without loading the entire docs tree.
 
-Start with `omnius-docs`, then load a more specific skill when the task is
+Start with `omnius-agent-onboarding` when the agent has no Omnius context, or
+`omnius-docs` when it already knows the documentation domain. Then load a more specific skill when the task is
 about inference providers, tools/web search, service integration, version
 compatibility, realtime, sponsors, Telegram, operations, or browser
 interaction validation.
 
 Documentation-routing skills:
 
+- `omnius-agent-onboarding`
 - `omnius-inference-docs`
 - `omnius-tools-docs`
 - `omnius-integration-docs`

package/.aiwg/addons/omnius-docs/manifest.json

@@ -2,8 +2,8 @@
   "id": "omnius-docs",
   "type": "addon",
   "name": "Omnius Documentation",
-  "version": "1.1.0",
-  "description": "Project-local Omnius documentation bundle for discover-then-expand agent workflows.",
+  "version": "1.2.0",
+  "description": "Project-local Omnius agent onboarding, system map, and discover-then-expand documentation bundle.",
   "manifestVersion": "1",
   "platforms": {
     "claude": "full",
@@ -16,6 +16,8 @@
     "omnius",
     "documentation",
     "discovery",
+    "agent-onboarding",
+    "system-map",
     "inference",
     "tools",
     "operations",

package/.aiwg/addons/omnius-docs/skills/omnius-agent-onboarding/SKILL.md

@@ -0,0 +1,70 @@
+---
+name: omnius-agent-onboarding
+description: Bootstrap any agent into Omnius, choose the correct entrypoint, locate layer/module/state ownership, and verify live behavior without guessing.
+compaction_strategy: structured
+---
+
+# omnius-agent-onboarding
+
+Use this skill when an agent is new to Omnius or unsure which command, REST
+route, tool, runtime, state root, or source module owns a requested outcome.
+
+## Triggers
+
+- how do I use Omnius
+- integrate an agent with Omnius
+- where is this implemented
+- which Omnius endpoint or command
+- Omnius architecture, runtime, state, or ownership
+- debug Omnius without prior context
+
+## Minimal Bootstrap
+
+1. Run `omnius docs` or read `GET /v1/discovery/bootstrap`.
+2. Search the desired outcome with `omnius discover "<intent>"`.
+3. Expand one stable ID with `omnius show <id>`.
+4. Read `use_when`, `avoid_when`, interfaces, workflow, safety, state,
+   verification, failure recovery, and source-of-truth.
+5. For live work, compare `GET /version`, then inspect `/openapi.json` and the
+   relevant live registry before executing.
+6. Verify the requested terminal result; accepted/queued is not completion.
+
+## Route By Agent Size
+
+- Small-context agent: bootstrap + one `workflow.*` entry + one referenced page.
+- Coding agent: also expand the owning `layer.*` and `module.*` entries.
+- Service integrator: also expand the exact `api.*`, tool, or provider entry
+  and validate the running OpenAPI/live registry.
+- Operator: expand `layer.operations`, the affected `runtime.*`, and
+  `workflow.debug-runtime`.
+- Maintainer: read `docs/architecture/agent-system-map.md`, then inspect the
+  canonical registry and targeted tests before editing.
+
+## Entrypoint Rules
+
+- `omnius`: interactive TUI and human-only slash commands.
+- `omnius "<task>"`: one foreground shell task.
+- `POST /v1/chat`: stateful daemon conversation.
+- `POST /v1/chat/completions`: OpenAI-compatible request, optionally an agent loop.
+- `POST /v1/run`: long asynchronous task with an ID, events, and cancellation.
+- `POST /v1/tools/{name}/call`: only when metadata declares direct-call exposure.
+
+Never infer a REST command from a slash command or a direct route from a tool
+name. Expand `workflow.choose-entrypoint` when uncertain.
+
+## State Rules
+
+- `<project>/.omnius`: project conversations, tasks/runs, context, indexes,
+  memories, and project preferences.
+- `~/.omnius`: daemon/update identity, global config and credentials, managed
+  runtimes, shared model/media storage, and workspace registry.
+
+Resolve the active workspace before touching project state. Do not emit secrets.
+
+## Canonical References
+
+- Generated bootstrap/catalog: `docs/DISCOVERY.md`, `docs/DISCOVERY.json`
+- System ownership: `docs/architecture/agent-system-map.md`
+- Service integration: `docs/guides/agent-integration.md`
+- Live REST contract: `GET /openapi.json`
+- Source discovery contract: `docs/discovery/agent-map.json`

package/.aiwg/addons/omnius-docs/skills/omnius-docs/SKILL.md

@@ -21,13 +21,16 @@ Find and use Omnius documentation without loading the whole docs tree.
 ## Workflow
 
 1. Start with `README.md` only for product overview and top-level docs map.
-2. Search `docs/DISCOVERY.json` by stable ID, alias, or intent.
+2. If the caller is new to Omnius, use the `omnius-agent-onboarding` skill and
+   read the bootstrap in `docs/DISCOVERY.md`.
+3. Search `docs/DISCOVERY.json` by stable ID, alias, or intent.
 3. For setup questions, open `docs/getting-started/`.
 4. For user workflows, open the relevant file under `docs/guides/`.
 5. For commands, config, and API inventory, open `docs/reference/`.
 6. For runtime and deployment questions, open `docs/operations/`.
-7. For implementation shape, open `docs/architecture/overview.md`.
-8. Read only the smallest relevant page before answering.
+8. For implementation shape and ownership, open
+   `docs/architecture/agent-system-map.md` before the shorter overview.
+9. Read only the smallest relevant page before answering.
 
 ## Map
 
@@ -38,6 +41,7 @@ Find and use Omnius documentation without loading the whole docs tree.
 - Bring your own inference: `docs/guides/bring-your-own-inference.md`
 - Tools and web search: `docs/guides/tools-and-web-search.md`
 - Agent integration: `docs/guides/agent-integration.md`
+- Agent system map: `docs/architecture/agent-system-map.md`
 - Service compatibility: `docs/operations/version-compatibility.md`
 - Realtime: `docs/guides/realtime.md`
 - Sponsor and COHERE: `docs/guides/sponsor-and-cohere.md`
@@ -49,7 +53,7 @@ Find and use Omnius documentation without loading the whole docs tree.
 - Configuration: `docs/reference/configuration.md`
 - Runtime hygiene: `docs/operations/runtime-hygiene.md`
 - Security and remote access: `docs/operations/security-and-remote-access.md`
-- Architecture: `docs/architecture/overview.md`
+- Architecture: `docs/architecture/agent-system-map.md`
 
 ## Canonical Sources
 

package/.aiwg/addons/omnius-rest-docs/README.md

@@ -6,5 +6,6 @@ Agents should discover it with `skill_list filter="rest"` or `/skills rest`, the
 
 The human-readable docs live in `docs/rest/`. The machine-readable contract is generated by `packages/cli/src/api/openapi.ts` and served by the daemon at `/openapi.json`.
 
-For intent-first lookup, use `omnius discover`, `GET /v1/discovery`, or the
+For a new agent, start with `GET /v1/discovery/bootstrap`. For intent-first
+lookup, use `omnius discover`, `GET /v1/discovery`, or the
 bundled `docs/DISCOVERY.json` before opening a REST family page.

package/.aiwg/addons/omnius-rest-docs/skills/omnius-rest-docs/SKILL.md

@@ -29,13 +29,15 @@ Explore Omnius REST API documentation without loading the whole API reference in
 
 ## Workflow
 
-1. Start with `docs/rest/INDEX.md`.
-2. For intent lookup, search `docs/DISCOVERY.json` or `GET /v1/discovery`.
+1. If the caller does not know which Omnius surface it needs, read
+   `GET /v1/discovery/bootstrap` and expand `workflow.choose-entrypoint`.
+2. Start with `docs/rest/INDEX.md`.
+3. For intent lookup, search `docs/DISCOVERY.json` or `GET /v1/discovery`.
 3. Identify the endpoint family that matches the user's question.
 4. Open `docs/reference/rest-api.md` when the user needs endpoint inventory or method/path details.
 5. Open only the relevant file under `docs/rest/endpoints/` or `docs/rest/examples/` for family-specific usage.
 6. Treat `packages/cli/src/api/openapi.ts` and the live daemon `/openapi.json` as the canonical machine contract.
-7. Prefer concise endpoint-specific guidance over copying long tables.
+8. Prefer concise endpoint-specific guidance over copying long tables.
 
 ## Endpoint Family Map
 

package/README.md

@@ -49,6 +49,9 @@ which endpoint owns a capability:
 
 ```bash
 omnius discover "bring your own inference"
+omnius show workflow.choose-entrypoint
+omnius show layer.orchestration
+omnius show store.project
 omnius show provider.anthropic
 omnius show provider.gemini
 omnius show tool.web-search
@@ -57,14 +60,15 @@ omnius show capability.osint-research
 omnius capabilities --json
 ```
 
-With the daemon running, the same discovery cascade is available at
-`GET /v1/discovery`, with exact entry expansion at
+With the daemon running, begin at `GET /v1/discovery/bootstrap`. The same
+discovery cascade is available at `GET /v1/discovery`, with exact entry expansion at
 `GET /v1/discovery/{id}`. The live API contract remains available at
 `/openapi.json`, direct tool metadata at `/v1/tools`, and skills at
 `/v1/skills`.
 
 Start with [the discovery guide](docs/DISCOVERY.md) when integrating another
-agent or service. Use [bring-your-own inference](docs/guides/bring-your-own-inference.md)
+agent or service, and use the [agent system map](docs/architecture/agent-system-map.md)
+to trace layers, modules, runtimes, and state ownership. Use [bring-your-own inference](docs/guides/bring-your-own-inference.md)
 for provider protocols and keys, and [tools and web search](docs/guides/tools-and-web-search.md)
 for the distinction between direct tools and agent-bound tools. The
 [categorized OSINT research guide](docs/guides/osint-research.md) documents
@@ -222,6 +226,7 @@ The complete endpoint inventory follows. It is kept in lockstep with the served
 
 | Method | Path | Purpose |
 | --- | --- | --- |
+| `GET` | `/v1/discovery/bootstrap` | Compact agent bootstrap and start-here map |
 | `GET` | `/v1/discovery` | Search or list the bundled capability catalog |
 | `GET` | `/v1/discovery/{id}` | Expand one stable capability entry |
 
@@ -369,9 +374,11 @@ Context-window dumps are written for main agents, sub-agents, internal runners,
 | `POST` | `/v1/voice/start` · `/v1/voice/stop` | Enable/warm voice · pause voice input |
 | `GET`/`POST` | `/v1/voice/models` · `/v1/voice/models/switch` | List · switch and enable an exact TTS model |
 | `GET`/`POST` | `/v1/voice/supertonic-settings` | Read · update voice tuning |
-| `GET`/`POST` | `/v1/voice/asr-models` · `/v1/voice/asr-models/switch` | List · switch ASR model |
+| `GET`/`PATCH` | `/v1/asr/engines` · `/v1/asr/selection` | List readiness/capabilities · select exact ASR engine/model |
+| `POST` | `/v1/asr/activate` · `/v1/asr/engines/{engineId}/setup` | Activate · install pinned ASR runtime/weights |
+| `POST` | `/v1/asr/transcriptions` · `/v1/asr/test` | Transcribe · test the selected ASR backend |
 | `POST` | `/v1/voice/tts` · `/v1/audio/speech` | Synthesize speech (+ OpenAI alias) |
-| `POST` | `/v1/voice/transcribe` · `/v1/audio/transcriptions` · `/v1/voice/transcribe/stream` | Transcribe (+ alias + streaming) |
+| `POST` | `/v1/voice/transcribe` · `/v1/audio/transcriptions` · `/v1/voice/transcribe/stream` | Transcribe (+ alias + isolated final SSE) |
 | `GET`/`POST` | `/v1/voice/clone-refs` | List · upload clone reference |
 | `POST` | `/v1/voice/clone-refs/upload` · `/v1/voice/clone-refs/from-url` | Upload · fetch clone reference |
 | `POST` | `/v1/voice/clone-refs/{filename}/activate` · `/v1/voice/clone-refs/{filename}/rename` | Activate · rename clone reference |
@@ -386,6 +393,15 @@ voice. The built-in registry includes GLaDOS, Overwatch, and the packaged
 sub-model set; use `OMNIUS_VOICEBOX_MODELS=all` for the full suite or a
 comma-separated list of `voicebox_*` IDs for an explicit subset.
 
+ASR is a separate multi-engine registry: Whisper, managed transcribe-cli,
+Nemotron readiness, and pinned `microsoft/VibeVoice-ASR`. VibeVoice is a
+file/final backend (not incremental PCM) with up to 60-minute transcription,
+speaker diarization, timestamps, and optional context/hotwords. Its ~17.35 GB
+weights are installed into the unified ASR cache on demand and never bundled
+in npm; activation is CUDA-only and fails closed unless the exact GPU is
+verified through `nvidia-smi` (discrete Linux) or `tegrastats` plus CUDA Torch
+device properties (Jetson/L4T).
+
 ### Generative media
 
 Backed by the unified `~/.omnius` store and shared venvs (see [Shared Media Dependencies](#shared-media-dependencies)). Outputs land in the global gallery at `~/.omnius/media/{images,videos,audio,music}`.

package/dist/discovery.d.ts

@@ -1,4 +1,5 @@
-export type DiscoveryKind = "capability" | "provider" | "tool" | "api" | "command" | "skill" | "guide" | "config" | "operation";
+export type DiscoveryKind = "capability" | "layer" | "module" | "workflow" | "runtime" | "store" | "provider" | "tool" | "api" | "command" | "skill" | "guide" | "config" | "operation";
+export declare const DISCOVERY_KINDS: readonly ["capability", "layer", "module", "workflow", "runtime", "store", "provider", "tool", "api", "command", "skill", "guide", "config", "operation"];
 export interface DiscoveryInterface {
     type: string;
     target: string;
@@ -9,6 +10,40 @@ export interface DiscoveryReference {
     target: string;
     relation?: string;
 }
+export interface DiscoveryStep {
+    step: string;
+    action: string;
+    interface?: string;
+    expected?: string;
+    on_failure?: string;
+}
+export interface DiscoveryExample {
+    title?: string;
+    command?: string;
+    request?: Record<string, unknown>;
+    notes?: string;
+}
+export interface DiscoveryFailureMode {
+    symptom: string;
+    likely_cause: string;
+    recovery: string;
+}
+export interface DiscoveryVerification {
+    check: string;
+    expected: string;
+}
+export interface DiscoveryBootstrap {
+    strategy: string[];
+    start_here: string[];
+    agent_profiles?: Record<string, string[]>;
+    common_intents?: Array<{
+        intent: string;
+        query: string;
+        expand?: string;
+    }>;
+    live_checks?: string[];
+    safety_rules?: string[];
+}
 export interface DiscoveryEntry {
     id: string;
     kind: DiscoveryKind;
@@ -17,16 +52,30 @@ export interface DiscoveryEntry {
     aliases?: string[];
     keywords?: string[];
     maturity?: string;
+    layer?: string;
+    audiences?: string[];
+    use_when?: string[];
+    avoid_when?: string[];
+    inputs?: string[];
+    outputs?: string[];
+    source_of_truth?: string[];
     prerequisites?: string[];
     interfaces?: DiscoveryInterface[];
     references?: DiscoveryReference[];
     related?: string[];
+    workflow?: DiscoveryStep[];
+    examples?: DiscoveryExample[];
+    verification?: DiscoveryVerification[];
+    failure_modes?: DiscoveryFailureMode[];
+    state?: Record<string, unknown>;
+    safety?: Record<string, unknown>;
     [key: string]: unknown;
 }
 export interface DiscoveryCatalog {
     schema_version: string;
     generated_at?: string;
     package_version?: string;
+    bootstrap?: DiscoveryBootstrap;
     entries: DiscoveryEntry[];
     [key: string]: unknown;
 }
@@ -34,6 +83,9 @@ export interface DiscoveryQueryOptions {
     kind?: DiscoveryKind;
     limit?: number;
     offset?: number;
+    audience?: string;
+    layer?: string;
+    includeInternal?: boolean;
 }
 export interface DiscoveryResult {
     score: number;
@@ -42,9 +94,10 @@ export interface DiscoveryResult {
 export declare function findDiscoveryCatalogPath(): string | null;
 export declare function loadDiscoveryCatalog(): DiscoveryCatalog;
 export declare function discoverCapabilities(query?: string, options?: DiscoveryQueryOptions, catalog?: DiscoveryCatalog): DiscoveryResult[];
-export declare function rankCapabilities(query?: string, kind?: DiscoveryKind, catalog?: DiscoveryCatalog): DiscoveryResult[];
+export declare function rankCapabilities(query?: string, kind?: DiscoveryKind, catalog?: DiscoveryCatalog, options?: Pick<DiscoveryQueryOptions, "audience" | "layer" | "includeInternal">): DiscoveryResult[];
 export declare function showCapability(id: string, catalog?: DiscoveryCatalog): DiscoveryEntry | undefined;
 export declare function renderDiscoveryEntry(entry: DiscoveryEntry): string;
+export declare function discoveryBootstrap(catalog?: DiscoveryCatalog): DiscoveryBootstrap;
 export declare function discoverySchemaVersion(): string;
 export declare function discoveryDocsRoot(): string | null;
 //# sourceMappingURL=discovery.d.ts.map