@opengeni/ogtool 0.1.0 → 0.2.2

package/README.md

@@ -1,30 +1,34 @@
 # `@opengeni/ogtool`
 
-`ogtool` is the dependency-free command-line client for the session-bound OpenGeni Toolspace MCP
-surface. Stock OpenGeni sandbox images include this exact package CLI. Custom rigs and connected
-machines can install the same release-coherent artifact from npm.
+`ogtool` is the bundled command-line wrapper for one exact OpenGeni execution attempt's Codemode
+surface. It uses the same `@opengeni/codemode` client and frozen tool catalog as Bun programs;
+it does not rediscover or proxy MCP servers. Stock OpenGeni sandbox images include this exact
+package CLI. Custom rigs can run the same release-coherent artifact with Bun.
 
-```bash
-npm exec --yes --package=@opengeni/ogtool@<version> -- ogtool list
-npm exec --yes --package=@opengeni/ogtool@<version> -- ogtool call <tool-name> '{"key":"value"}'
+```sh
+bun x -p @opengeni/ogtool@<version> ogtool list
+bun x -p @opengeni/ogtool@<version> ogtool call <tool-path> '{"key":"value"}'
+bun x -p @opengeni/ogtool@<version> ogtool declarations opengeni-codemode.d.ts
 ```
 
 Always replace `<version>` with the exact version in the deployment BOM; do not silently track
 `latest` in a production image. An embedding host may expose that pinned spec through
 `OPENGENI_OGTOOL_PACKAGE_SPEC`.
 
-The CLI reads `OPENGENI_TOOLSPACE_URL` and the bearer path in
-`OPENGENI_TOOLSPACE_TOKEN_FILE`. The token remains in the protected file and is read anew for
+The CLI reads `OPENGENI_CODEMODE_URL` and the bearer path in
+`OPENGENI_CODEMODE_TOKEN_FILE`. The token remains in the protected file and is read anew for
 each CLI process, so worker-side token renewal does not require reinstalling or restarting the
 CLI. `ogtool doctor` checks local availability without printing the token.
 
 Commands:
 
-- `ogtool list` / `ogtool tools/list`
-- `ogtool call <tool-name> [json-object]` / `ogtool tools/call ...`
+- `ogtool list`
+- `ogtool call <tool-path-or-model-name> [json-object]`
+- `ogtool declarations [output-file]`
 - `ogtool doctor`
 - `ogtool --version`
 
-If the CLI is absent and package installation is unavailable, callers can use MCP Streamable HTTP
-directly with the same URL and bearer file. `ogtool` is a convenience client, not a second tool or
-credential surface.
+The HTTP client submits a caller-chosen operation id and polls the durable result. A lost response
+therefore cannot silently replay a side effect. `@opengeni/ogtool` also re-exports the typed
+`@opengeni/codemode` client for application code. Codemode is a projection of the attempt's one
+tool authority, not a second tool or credential surface.