@ours.network/mcp 0.17.0-nightly.9 → 0.17.0

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
@@ -40,47 +40,6 @@ fail atomically without retrieving or writing any file.
40
40
  |---------|---------|---------|
41
41
  | `OURS_STATE_DIR` | `~/.ours` | Node identity + serialized state. Distinct per node. |
42
42
  | `OURS_BROKER_URL` | `wss://broker1.ours.network` | The ADAPT broker to connect through. Set to `ws://localhost:9000` for a local broker. |
43
- | `OURS_SERVICE_NAME` | *(none)* | Boot-service instance name (also `serviceName` in `config.json`). See below. |
44
-
45
- Nightly installers can associate a client application with one local daemon profile in
46
- `~/.ours/installer-profiles.json`. Platform shims pass `--application claude-code`, `codex`, or
47
- `hermes` only to the client commands `proxy` and `watch`; lifecycle commands reject the flag.
48
- Explicit `OURS_CONFIG`, `OURS_PORT`, or `OURS_STATE_DIR` wins. Otherwise the association selects
49
- the config before the historical `~/.ours/config.json` / `3050` fallback.
50
-
51
- An associated client fails closed: the selected config must still resolve the registered port and
52
- state directory; unauthenticated `/info` must report that state directory before the protected API
53
- is probed; and authentication must succeed. Drift, an unreachable daemon, or a 401/403 instructs
54
- the operator to rerun the Nightly installer—there is no silent fallback. Token precedence remains
55
- `OURS_API_TOKEN` → selected config `apiToken` → selected state directory `daemon-token`; tokens are
56
- never read from or written to the registry. Installed associations force client auto-start off.
57
-
58
- ### Running more than one daemon on a host
59
-
60
- `install-service` bakes the resolved port, broker and state directory into a single boot
61
- definition — `ours.service` on Linux, `solutions.adaptframework.ours` on macOS. Two daemons
62
- installed that way would write the **same** definition, so the second silently replaces the
63
- first.
64
-
65
- Give a daemon an instance name and it gets its own definition instead:
66
-
67
- ```sh
68
- OURS_CONFIG=~/.ours-tg/config.json OURS_SERVICE_NAME=tg ours-mcp install-service
69
- # → ours-tg.service / solutions.adaptframework.ours.tg
70
- ```
71
-
72
- Named definitions also persist that exact `OURS_CONFIG` path. This is required because visibility,
73
- API-token source, transcription, GC, and other config-only settings must resolve from the same file
74
- after reboot; persisting only port/state/broker would not preserve an auth-isolated profile.
75
-
76
- With no name — the default, and every existing deployment — the unit and label are exactly what
77
- they always were. A name must be 1–32 characters of letters, digits, hyphen or underscore,
78
- starting and ending with a letter or digit; anything else is **refused** rather than rewritten,
79
- because falling back to the shared unit is the overwrite this prevents. Removing a named
80
- instance needs the same name: `OURS_SERVICE_NAME=tg ours-mcp uninstall-service`.
81
-
82
- An isolated daemon also needs its own `OURS_CONFIG`/`stateDir` and its own port — the API token
83
- lives in the state directory, so two daemons must never share one.
84
43
 
85
44
  ### Voice-message transcription
86
45