@oddington/cli 0.1.29 → 0.1.31
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 +30 -1
- package/dist/os.js +185 -176
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -27,6 +27,16 @@ management, repository targets, local app repository context, Dropbox authorizat
|
|
|
27
27
|
remote File-storage configuration and Routine deployment use `https://api.oddington.ai`. These addresses are fixed; workspace
|
|
28
28
|
configuration and `ODDINGTON_OS_ORIGIN` do not override them.
|
|
29
29
|
|
|
30
|
+
Connection use is the canonical `POST /workspaces/<workspace>/connections/use`
|
|
31
|
+
operation on the API host. The verified member or retained Run supplies authority;
|
|
32
|
+
the request names the Connection and exact Run ID. Hosted ad hoc execution needs
|
|
33
|
+
both `ODDINGTON_CONNECTION_RUN_TOKEN` and `ODDINGTON_CONNECTION_RUN_ID`.
|
|
34
|
+
Inbox publication goes directly to the selected workspace's `/api/inbox/check`,
|
|
35
|
+
`/api/inbox/publish`, `/api/inbox/resolve` and `/api/inbox/files` operations.
|
|
36
|
+
Data and shared Files go directly to their OS owners. Local publication validates
|
|
37
|
+
the whole captured set before applying Records, retaining Files and publishing
|
|
38
|
+
Asks/Digests; retry resumes the same retained identities and receipts.
|
|
39
|
+
|
|
30
40
|
## Local apps
|
|
31
41
|
|
|
32
42
|
From anywhere inside the app’s Git worktree, run:
|
|
@@ -471,7 +481,26 @@ is required unless an authored item declares executable handlers. JSON input
|
|
|
471
481
|
is validated before business work; its file/stdin path is transport, not input.
|
|
472
482
|
Omitted input is `{}`. Each JSON value is bounded to 256 KiB.
|
|
473
483
|
|
|
474
|
-
|
|
484
|
+
To execute the active deployed version on OS, use:
|
|
485
|
+
|
|
486
|
+
```sh
|
|
487
|
+
os routine run invoice-import --remote --input input.json
|
|
488
|
+
os routine run invoice-import --remote --input - --json
|
|
489
|
+
os routine cancel <run> --json
|
|
490
|
+
```
|
|
491
|
+
|
|
492
|
+
Remote start reads only worktree identity and business input. It neither uploads
|
|
493
|
+
local source nor creates a local captured change set. It reports the accepted
|
|
494
|
+
Run's `id`, `state` and inspection URL, then returns; disconnecting does not cancel
|
|
495
|
+
the Run. OS-owned changes apply during execution and need no publish command.
|
|
496
|
+
Uncertain acknowledgements retry the same start key and input. If recovery is
|
|
497
|
+
still unavailable, output retains `startKey` and warns that OS may have accepted
|
|
498
|
+
the action; repeating the command deliberately requests another Run. Cancellation
|
|
499
|
+
resolves the Run through current workspace membership, works outside a checkout,
|
|
500
|
+
and reports the recorded state while OS stops execution. Neither command accepts
|
|
501
|
+
workspace, version, command, environment or authority overrides.
|
|
502
|
+
|
|
503
|
+
Before local execution, the command names installed connections and explains that
|
|
475
504
|
local filesystem changes, model calls and provider effects happen immediately.
|
|
476
505
|
Only Record, File, Ask and Digest changes stay local for review. The child
|
|
477
506
|
receives temporary installed authority, which is revoked when execution ends.
|