@once-agent/sdk 0.1.2 → 0.1.4
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 +11 -10
- package/package.json +10 -2
package/README.md
CHANGED
|
@@ -230,7 +230,7 @@ setup -> scan -> protect -> apply -> doctor
|
|
|
230
230
|
### 1. Set up Once
|
|
231
231
|
|
|
232
232
|
```bash
|
|
233
|
-
npx
|
|
233
|
+
npx once setup .
|
|
234
234
|
```
|
|
235
235
|
|
|
236
236
|
Setup can install/configure the SDK, verify your API key, register a supported provider, and prepare local Once configuration.
|
|
@@ -238,13 +238,13 @@ Setup can install/configure the SDK, verify your API key, register a supported p
|
|
|
238
238
|
Preview setup without making changes:
|
|
239
239
|
|
|
240
240
|
```bash
|
|
241
|
-
npx
|
|
241
|
+
npx once setup . --plan
|
|
242
242
|
```
|
|
243
243
|
|
|
244
244
|
### 2. Scan for consequential operations
|
|
245
245
|
|
|
246
246
|
```bash
|
|
247
|
-
npx
|
|
247
|
+
npx once scan .
|
|
248
248
|
```
|
|
249
249
|
|
|
250
250
|
The scanner looks locally for likely side-effecting operations that may benefit from Once protection.
|
|
@@ -254,19 +254,19 @@ Source code is reviewed locally by the CLI. The scanner does not require uploadi
|
|
|
254
254
|
### 3. Review protection candidates
|
|
255
255
|
|
|
256
256
|
```bash
|
|
257
|
-
npx
|
|
257
|
+
npx once protect .
|
|
258
258
|
```
|
|
259
259
|
|
|
260
260
|
Include all confidence levels:
|
|
261
261
|
|
|
262
262
|
```bash
|
|
263
|
-
npx
|
|
263
|
+
npx once protect . --all
|
|
264
264
|
```
|
|
265
265
|
|
|
266
266
|
Write a review plan:
|
|
267
267
|
|
|
268
268
|
```bash
|
|
269
|
-
npx
|
|
269
|
+
npx once protect . --all --write-plan
|
|
270
270
|
```
|
|
271
271
|
|
|
272
272
|
This can create:
|
|
@@ -278,7 +278,7 @@ This can create:
|
|
|
278
278
|
### 4. Preview a patch
|
|
279
279
|
|
|
280
280
|
```bash
|
|
281
|
-
npx
|
|
281
|
+
npx once protect . --all --patch
|
|
282
282
|
```
|
|
283
283
|
|
|
284
284
|
This generates a reviewable patch preview without directly modifying the application source.
|
|
@@ -286,13 +286,13 @@ This generates a reviewable patch preview without directly modifying the applica
|
|
|
286
286
|
You can also generate integration guidance:
|
|
287
287
|
|
|
288
288
|
```bash
|
|
289
|
-
npx
|
|
289
|
+
npx once protect . --all --snippets
|
|
290
290
|
```
|
|
291
291
|
|
|
292
292
|
### 5. Apply an eligible transformation
|
|
293
293
|
|
|
294
294
|
```bash
|
|
295
|
-
npx
|
|
295
|
+
npx once protect . --apply
|
|
296
296
|
```
|
|
297
297
|
|
|
298
298
|
`--apply` is intentionally conservative.
|
|
@@ -306,7 +306,7 @@ If there are zero or multiple PATCHABLE candidates, automatic apply is rejected
|
|
|
306
306
|
### 6. Verify the connection
|
|
307
307
|
|
|
308
308
|
```bash
|
|
309
|
-
npx
|
|
309
|
+
npx once doctor
|
|
310
310
|
```
|
|
311
311
|
|
|
312
312
|
`doctor` verifies that the SDK can reach the configured Once service.
|
|
@@ -452,3 +452,4 @@ That is the failure mode Once is built to address.
|
|
|
452
452
|
|
|
453
453
|
MIT
|
|
454
454
|
|
|
455
|
+
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@once-agent/sdk",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.4",
|
|
4
4
|
"description": "Execution safety for side-effecting AI agent tools.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/index.js",
|
|
@@ -53,9 +53,17 @@
|
|
|
53
53
|
"@types/node": "^26.6.1"
|
|
54
54
|
},
|
|
55
55
|
"bin": {
|
|
56
|
-
"once": "
|
|
56
|
+
"once": "dist/cli.js"
|
|
57
57
|
},
|
|
58
58
|
"dependencies": {
|
|
59
59
|
"typescript": "^5.9.0"
|
|
60
|
+
},
|
|
61
|
+
"repository": {
|
|
62
|
+
"type": "git",
|
|
63
|
+
"url": "git+https://github.com/stringsofthemind-oss/once.git"
|
|
64
|
+
},
|
|
65
|
+
"homepage": "https://github.com/stringsofthemind-oss/once#readme",
|
|
66
|
+
"bugs": {
|
|
67
|
+
"url": "https://github.com/stringsofthemind-oss/once/issues"
|
|
60
68
|
}
|
|
61
69
|
}
|