@w6w/cli 0.9.16 → 0.9.23

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.
Files changed (43) hide show
  1. package/README.md +3 -0
  2. package/dist/mod.d.ts +1 -1
  3. package/dist/mod.d.ts.map +1 -1
  4. package/dist/mod.js +1 -1
  5. package/dist/src/args.d.ts +8 -1
  6. package/dist/src/args.d.ts.map +1 -1
  7. package/dist/src/args.js +15 -3
  8. package/dist/src/args.js.map +1 -1
  9. package/dist/src/commands/agents-studio.d.ts +24 -0
  10. package/dist/src/commands/agents-studio.d.ts.map +1 -0
  11. package/dist/src/commands/agents-studio.js +431 -0
  12. package/dist/src/commands/agents-studio.js.map +1 -0
  13. package/dist/src/commands/assets.d.ts +47 -0
  14. package/dist/src/commands/assets.d.ts.map +1 -0
  15. package/dist/src/commands/assets.js +412 -0
  16. package/dist/src/commands/assets.js.map +1 -0
  17. package/dist/src/commands/config.d.ts +21 -0
  18. package/dist/src/commands/config.d.ts.map +1 -0
  19. package/dist/src/commands/config.js +73 -0
  20. package/dist/src/commands/config.js.map +1 -0
  21. package/dist/src/commands/connections.d.ts +1 -1
  22. package/dist/src/commands/connections.d.ts.map +1 -1
  23. package/dist/src/commands/connections.js +27 -2
  24. package/dist/src/commands/connections.js.map +1 -1
  25. package/dist/src/commands/index.d.ts +5 -0
  26. package/dist/src/commands/index.d.ts.map +1 -1
  27. package/dist/src/commands/index.js +15 -0
  28. package/dist/src/commands/index.js.map +1 -1
  29. package/dist/src/commands/ls.d.ts +21 -0
  30. package/dist/src/commands/ls.d.ts.map +1 -0
  31. package/dist/src/commands/ls.js +53 -0
  32. package/dist/src/commands/ls.js.map +1 -0
  33. package/dist/src/commands/models.d.ts +16 -0
  34. package/dist/src/commands/models.d.ts.map +1 -0
  35. package/dist/src/commands/models.js +126 -0
  36. package/dist/src/commands/models.js.map +1 -0
  37. package/dist/src/commands/vars.d.ts.map +1 -1
  38. package/dist/src/commands/vars.js +2 -2
  39. package/dist/src/commands/vars.js.map +1 -1
  40. package/dist/src/help.generated.d.ts.map +1 -1
  41. package/dist/src/help.generated.js +2549 -51
  42. package/dist/src/help.generated.js.map +1 -1
  43. package/package.json +2 -2
@@ -17,7 +17,7 @@
17
17
  /** The command tree, generated from the shared wrapper surface contract. */
18
18
  export const HELP_TREE = {
19
19
  "binary": "w6w",
20
- "contractVersion": "0.8.0",
20
+ "contractVersion": "0.13.0",
21
21
  "tagline": "command-line client for the w6w workflow platform",
22
22
  "usage": "w6w <command> [options]",
23
23
  "docsUrl": "https://w6w.dev/docs/cli",
@@ -107,6 +107,134 @@ export const HELP_TREE = {
107
107
  '--app <id> addresses a connection URN by its app instead of a conn_… id — "w6w run --app sendgrid --action send_email" in place of "w6w run conn_01HQ8N --action send_email". It resolves against `w6w connections list`: one matching connection is used outright, and none or several is a usage error (several lists every candidate with the exact command to run against it). It cannot be combined with a URN argument, and it is CLI-only — there is no equivalent in the node or python wrapper.',
108
108
  ],
109
109
  },
110
+ {
111
+ "operation": "modelUsage.query",
112
+ "path": [
113
+ "model-usage",
114
+ ],
115
+ "name": "model-usage",
116
+ "aliases": [],
117
+ "summary": "Query recorded model usage, optionally grouped.",
118
+ "short": "Query recorded model usage, optionally grouped",
119
+ "headline": "query recorded model usage, optionally grouped",
120
+ "usage": "w6w model-usage [options]",
121
+ "naming": "w6w model-usage [--project <id>] [--group-by route|model|day] [--from <iso>] [--to <iso>] [--route <name>] [--model <id>] [--limit <n>] [--cursor <c>]",
122
+ "status": "required",
123
+ "params": [
124
+ {
125
+ "name": "project",
126
+ "kind": "flag",
127
+ "display": "--project <id>",
128
+ "description": "Project to scope to (default: the account's default project)",
129
+ "required": false,
130
+ },
131
+ {
132
+ "name": "groupBy",
133
+ "kind": "flag",
134
+ "display": "--group-by <value>",
135
+ "description": "Group usage by this dimension",
136
+ "required": false,
137
+ },
138
+ {
139
+ "name": "from",
140
+ "kind": "flag",
141
+ "display": "--from <iso>",
142
+ "description": "Start of the window (ISO timestamp)",
143
+ "required": false,
144
+ },
145
+ {
146
+ "name": "to",
147
+ "kind": "flag",
148
+ "display": "--to <iso>",
149
+ "description": "End of the window (ISO timestamp)",
150
+ "required": false,
151
+ },
152
+ {
153
+ "name": "route",
154
+ "kind": "flag",
155
+ "display": "--route <name>",
156
+ "description": "Only usage through this model route id (mrt_…)",
157
+ "required": false,
158
+ },
159
+ {
160
+ "name": "model",
161
+ "kind": "flag",
162
+ "display": "--model <id>",
163
+ "description": "Only usage of this catalog model id (mdl_…)",
164
+ "required": false,
165
+ },
166
+ {
167
+ "name": "limit",
168
+ "kind": "flag",
169
+ "display": "--limit <n>",
170
+ "description": "Maximum number of results per page",
171
+ "required": false,
172
+ },
173
+ {
174
+ "name": "cursor",
175
+ "kind": "flag",
176
+ "display": "--cursor <c>",
177
+ "description": "Pagination cursor from a previous page",
178
+ "required": false,
179
+ },
180
+ {
181
+ "name": "json",
182
+ "kind": "flag",
183
+ "display": "--json",
184
+ "description": "Output raw JSON instead of a table",
185
+ "required": false,
186
+ },
187
+ ],
188
+ "examples": [
189
+ "w6w model-usage",
190
+ "w6w model-usage --group-by route --from 2026-10-01",
191
+ ],
192
+ "notes": [],
193
+ },
194
+ {
195
+ "operation": "ls",
196
+ "path": [
197
+ "ls",
198
+ ],
199
+ "name": "ls",
200
+ "aliases": [],
201
+ "summary": "List integrations, workflows, functions or endpoints (endpoints is unstable).",
202
+ "short": "List integrations, workflows, functions or endpoints (endpoints is unstable)",
203
+ "headline": "list integrations, workflows, functions or endpoints (endpoints is unstable)",
204
+ "usage": "w6w ls <kind> [options]",
205
+ "naming": "w6w ls <kind> [--project <id>]",
206
+ "status": "live",
207
+ "params": [
208
+ {
209
+ "name": "kind",
210
+ "kind": "argument",
211
+ "display": "<kind>",
212
+ "description": "What to list: integrations | workflows | functions | endpoints (endpoints is unstable)",
213
+ "required": true,
214
+ },
215
+ {
216
+ "name": "project",
217
+ "kind": "flag",
218
+ "display": "--project <id>",
219
+ "description": "Project to scope to (workflows only; other kinds ignore it)",
220
+ "required": false,
221
+ },
222
+ {
223
+ "name": "json",
224
+ "kind": "flag",
225
+ "display": "--json",
226
+ "description": "Output raw JSON instead of a table",
227
+ "required": false,
228
+ },
229
+ ],
230
+ "examples": [
231
+ "w6w ls workflows",
232
+ "w6w ls integrations --json",
233
+ "w6w ls workflows --project prj_01HQ8N",
234
+ "w6w ls endpoints",
235
+ ],
236
+ "notes": [],
237
+ },
110
238
  ],
111
239
  "groups": [
112
240
  {
@@ -192,7 +320,7 @@ export const HELP_TREE = {
192
320
  "short": "Delete a connection",
193
321
  "headline": "delete a connection",
194
322
  "usage": "w6w connections delete <id> [options]",
195
- "naming": "w6w connections delete <id>",
323
+ "naming": "w6w connections delete <id> [--force]",
196
324
  "status": "required",
197
325
  "params": [
198
326
  {
@@ -202,6 +330,13 @@ export const HELP_TREE = {
202
330
  "description": "Connection id (see: w6w connections list)",
203
331
  "required": true,
204
332
  },
333
+ {
334
+ "name": "force",
335
+ "kind": "flag",
336
+ "display": "--force",
337
+ "description": "Delete even if Functions/Endpoints still use it; they are disabled, not edited",
338
+ "required": false,
339
+ },
205
340
  {
206
341
  "name": "json",
207
342
  "kind": "flag",
@@ -434,7 +569,7 @@ export const HELP_TREE = {
434
569
  },
435
570
  ],
436
571
  "examples": [
437
- 'w6w workflows create --definition \'{"manifestVersion":"2","name":"nightly","steps":[]}\'',
572
+ 'w6w workflows create --definition \'{"manifestVersion":"2","name":"nightly","nodes":[]}\'',
438
573
  'w6w workflows create --definition "$(cat workflow.json)" --project prj_01HQ8N',
439
574
  ],
440
575
  "notes": [],
@@ -1293,7 +1428,7 @@ export const HELP_TREE = {
1293
1428
  "name": "name",
1294
1429
  "kind": "argument",
1295
1430
  "display": "<name>",
1296
- "description": "Variable name to create (must match ^[a-z_][a-z0-9_]*$)",
1431
+ "description": "Variable name to create (must match ^[A-Za-z_][A-Za-z0-9_]*$)",
1297
1432
  "required": true,
1298
1433
  },
1299
1434
  {
@@ -2588,31 +2723,136 @@ export const HELP_TREE = {
2588
2723
  ],
2589
2724
  },
2590
2725
  {
2591
- "name": "auth",
2592
- "summary": "Save, remove and inspect the stored API token",
2593
- "headline": "save, remove and inspect the stored API token",
2594
- "usage": "w6w auth <command> [options]",
2726
+ "name": "models",
2727
+ "summary": "Browse the model catalog",
2728
+ "headline": "browse the model catalog",
2729
+ "usage": "w6w models <command> [options]",
2595
2730
  "commands": [
2596
2731
  {
2597
- "operation": "auth.login",
2732
+ "operation": "models.list",
2598
2733
  "path": [
2599
- "auth",
2600
- "login",
2734
+ "models",
2735
+ "list",
2601
2736
  ],
2602
- "name": "login",
2737
+ "name": "list",
2603
2738
  "aliases": [],
2604
- "summary": "Save an API token for a base URL so later commands authenticate from it.",
2605
- "short": "Save an API token for a base URL so later commands authenticate from it",
2606
- "headline": "save an API token for a base URL so later commands authenticate from it",
2607
- "usage": "w6w auth login [<token>] [options]",
2608
- "naming": "w6w auth login [<token>]",
2609
- "status": "live",
2739
+ "summary": "List the model catalog (keyset-paged).",
2740
+ "short": "List the model catalog (keyset-paged)",
2741
+ "headline": "list the model catalog (keyset-paged)",
2742
+ "usage": "w6w models list [options]",
2743
+ "naming": "w6w models ls [--provider <id>] [--status <s>] [--limit <n>] [--cursor <c>]",
2744
+ "status": "required",
2610
2745
  "params": [
2611
2746
  {
2612
- "name": "token",
2747
+ "name": "provider",
2748
+ "kind": "flag",
2749
+ "display": "--provider <id>",
2750
+ "description": "Only models from this provider (e.g. openai)",
2751
+ "required": false,
2752
+ },
2753
+ {
2754
+ "name": "status",
2755
+ "kind": "flag",
2756
+ "display": "--status <s>",
2757
+ "description": "Only models with this status",
2758
+ "required": false,
2759
+ },
2760
+ {
2761
+ "name": "limit",
2762
+ "kind": "flag",
2763
+ "display": "--limit <n>",
2764
+ "description": "Maximum number of results per page",
2765
+ "required": false,
2766
+ },
2767
+ {
2768
+ "name": "cursor",
2769
+ "kind": "flag",
2770
+ "display": "--cursor <c>",
2771
+ "description": "Pagination cursor from a previous page",
2772
+ "required": false,
2773
+ },
2774
+ {
2775
+ "name": "json",
2776
+ "kind": "flag",
2777
+ "display": "--json",
2778
+ "description": "Output raw JSON instead of a table",
2779
+ "required": false,
2780
+ },
2781
+ ],
2782
+ "examples": [
2783
+ "w6w models ls",
2784
+ "w6w models ls --provider openai",
2785
+ ],
2786
+ "notes": [],
2787
+ },
2788
+ {
2789
+ "operation": "models.get",
2790
+ "path": [
2791
+ "models",
2792
+ "get",
2793
+ ],
2794
+ "name": "get",
2795
+ "aliases": [],
2796
+ "summary": "Fetch one catalog model by id.",
2797
+ "short": "Fetch one catalog model by id",
2798
+ "headline": "fetch one catalog model by id",
2799
+ "usage": "w6w models get <id> [options]",
2800
+ "naming": "w6w models get <id>",
2801
+ "status": "required",
2802
+ "params": [
2803
+ {
2804
+ "name": "id",
2613
2805
  "kind": "argument",
2614
- "display": "<token>",
2615
- "description": "The API token to save, or `-` to read it from standard input (default when input is piped)",
2806
+ "display": "<id>",
2807
+ "description": "Catalog model id (mdl_…), not a provider-native id like gpt-4o",
2808
+ "required": true,
2809
+ },
2810
+ {
2811
+ "name": "json",
2812
+ "kind": "flag",
2813
+ "display": "--json",
2814
+ "description": "Output raw JSON instead of a table",
2815
+ "required": false,
2816
+ },
2817
+ ],
2818
+ "examples": [
2819
+ "w6w models get mdl_01HQ8N",
2820
+ ],
2821
+ "notes": [],
2822
+ },
2823
+ ],
2824
+ "options": [],
2825
+ "examples": [
2826
+ "w6w models ls",
2827
+ "w6w models get mdl_01HQ8N",
2828
+ ],
2829
+ },
2830
+ {
2831
+ "name": "model-routes",
2832
+ "summary": "List model routes and run completions through them",
2833
+ "headline": "list model routes and run completions through them",
2834
+ "usage": "w6w model-routes <command> [options]",
2835
+ "commands": [
2836
+ {
2837
+ "operation": "modelRoutes.list",
2838
+ "path": [
2839
+ "model-routes",
2840
+ "list",
2841
+ ],
2842
+ "name": "list",
2843
+ "aliases": [],
2844
+ "summary": "List the caller's model routes in a project.",
2845
+ "short": "List the caller's model routes in a project",
2846
+ "headline": "list the caller's model routes in a project",
2847
+ "usage": "w6w model-routes list [options]",
2848
+ "naming": "w6w model-routes list [--project <id>]",
2849
+ "status": "required",
2850
+ "params": [
2851
+ {
2852
+ "name": "project",
2853
+ "kind": "flag",
2854
+ "display": "--project <id>",
2855
+ "description": "Project to scope to (default: the account's default project)",
2616
2856
  "required": false,
2617
2857
  },
2618
2858
  {
@@ -2624,27 +2864,40 @@ export const HELP_TREE = {
2624
2864
  },
2625
2865
  ],
2626
2866
  "examples": [
2627
- "printf '%s' \"$W6W_TOKEN\" | w6w auth login -",
2628
- "w6w auth login <token>",
2629
- "w6w auth login - --base-url https://w6w.example.com",
2867
+ "w6w model-routes list",
2868
+ "w6w model-routes list --project prj_01HQ8N",
2630
2869
  ],
2631
2870
  "notes": [],
2632
2871
  },
2633
2872
  {
2634
- "operation": "auth.logout",
2873
+ "operation": "modelRoutes.get",
2635
2874
  "path": [
2636
- "auth",
2637
- "logout",
2875
+ "model-routes",
2876
+ "get",
2638
2877
  ],
2639
- "name": "logout",
2878
+ "name": "get",
2640
2879
  "aliases": [],
2641
- "summary": "Remove the stored API token for a base URL.",
2642
- "short": "Remove the stored API token for a base URL",
2643
- "headline": "remove the stored API token for a base URL",
2644
- "usage": "w6w auth logout [options]",
2645
- "naming": "w6w auth logout",
2646
- "status": "live",
2880
+ "summary": "Fetch one model route by name.",
2881
+ "short": "Fetch one model route by name",
2882
+ "headline": "fetch one model route by name",
2883
+ "usage": "w6w model-routes get <name> [options]",
2884
+ "naming": "w6w model-routes get <name> [--project <id>]",
2885
+ "status": "required",
2647
2886
  "params": [
2887
+ {
2888
+ "name": "name",
2889
+ "kind": "argument",
2890
+ "display": "<name>",
2891
+ "description": "Model route name",
2892
+ "required": true,
2893
+ },
2894
+ {
2895
+ "name": "project",
2896
+ "kind": "flag",
2897
+ "display": "--project <id>",
2898
+ "description": "Project to scope to (default: the account's default project)",
2899
+ "required": false,
2900
+ },
2648
2901
  {
2649
2902
  "name": "json",
2650
2903
  "kind": "flag",
@@ -2654,26 +2907,60 @@ export const HELP_TREE = {
2654
2907
  },
2655
2908
  ],
2656
2909
  "examples": [
2657
- "w6w auth logout",
2658
- "w6w auth logout --base-url https://w6w.example.com",
2910
+ "w6w model-routes get summarize",
2659
2911
  ],
2660
2912
  "notes": [],
2661
2913
  },
2662
2914
  {
2663
- "operation": "auth.status",
2915
+ "operation": "modelRoutes.complete",
2664
2916
  "path": [
2665
- "auth",
2666
- "status",
2917
+ "model-routes",
2918
+ "complete",
2667
2919
  ],
2668
- "name": "status",
2920
+ "name": "complete",
2669
2921
  "aliases": [],
2670
- "summary": "Show the resolved base URL, where it came from, and whether a token is available.",
2671
- "short": "Show the resolved base URL, where it came from, and whether a token is available",
2672
- "headline": "show the resolved base URL, where it came from, and whether a token is available",
2673
- "usage": "w6w auth status [options]",
2674
- "naming": "w6w auth status",
2675
- "status": "live",
2922
+ "summary": "Run a completion through a model route.",
2923
+ "short": "Run a completion through a model route",
2924
+ "headline": "run a completion through a model route",
2925
+ "usage": "w6w model-routes complete <name> --input <json> [options]",
2926
+ "naming": "w6w model-routes complete <name> --input <json> [--project <id>] [--dialect <d>] [--response <r>]",
2927
+ "status": "required",
2676
2928
  "params": [
2929
+ {
2930
+ "name": "name",
2931
+ "kind": "argument",
2932
+ "display": "<name>",
2933
+ "description": "Model route name",
2934
+ "required": true,
2935
+ },
2936
+ {
2937
+ "name": "input",
2938
+ "kind": "flag",
2939
+ "display": "--input <json>",
2940
+ "description": "The completion input, as a JSON object",
2941
+ "required": true,
2942
+ },
2943
+ {
2944
+ "name": "project",
2945
+ "kind": "flag",
2946
+ "display": "--project <id>",
2947
+ "description": "Project to scope to (default: the account's default project)",
2948
+ "required": false,
2949
+ },
2950
+ {
2951
+ "name": "dialect",
2952
+ "kind": "flag",
2953
+ "display": "--dialect <d>",
2954
+ "description": "Request dialect: openai | anthropic | ollama",
2955
+ "required": false,
2956
+ },
2957
+ {
2958
+ "name": "response",
2959
+ "kind": "flag",
2960
+ "display": "--response <r>",
2961
+ "description": "Response shape: both | output | raw",
2962
+ "required": false,
2963
+ },
2677
2964
  {
2678
2965
  "name": "json",
2679
2966
  "kind": "flag",
@@ -2683,18 +2970,2047 @@ export const HELP_TREE = {
2683
2970
  },
2684
2971
  ],
2685
2972
  "examples": [
2686
- "w6w auth status",
2687
- "w6w auth status --json",
2973
+ 'w6w model-routes complete summarize --input \'{"messages":[{"role":"user","content":"Hi"}]}\'',
2974
+ 'w6w model-routes complete summarize --input \'{"prompt":"Hi"}\' --dialect openai --response output',
2688
2975
  ],
2689
2976
  "notes": [],
2690
2977
  },
2691
2978
  ],
2692
- "options": [],
2693
- "examples": [
2694
- "w6w auth status",
2979
+ "options": [
2980
+ {
2981
+ "name": "project",
2982
+ "kind": "flag",
2983
+ "display": "--project <id>",
2984
+ "description": "Project to scope to (default: the account's default project)",
2985
+ "required": false,
2986
+ },
2987
+ ],
2988
+ "examples": [
2989
+ "w6w model-routes list",
2990
+ "w6w model-routes get summarize",
2991
+ ],
2992
+ },
2993
+ {
2994
+ "name": "assets",
2995
+ "summary": "Upload, inspect and download versioned assets (skills, context files)",
2996
+ "headline": "upload, inspect and download versioned assets (skills, context files)",
2997
+ "usage": "w6w assets <command> [options]",
2998
+ "commands": [
2999
+ {
3000
+ "operation": "assets.uploads.create",
3001
+ "path": [
3002
+ "assets",
3003
+ "upload-create",
3004
+ ],
3005
+ "name": "upload-create",
3006
+ "aliases": [],
3007
+ "summary": "Reserve a resumable asset upload (declare the entries; no bytes yet).",
3008
+ "short": "Reserve a resumable asset upload (declare the entries; no bytes yet)",
3009
+ "headline": "reserve a resumable asset upload (declare the entries; no bytes yet)",
3010
+ "usage": "w6w assets upload-create --purpose <skill|context|asset> --idempotency-key <value> --entries <json> [options]",
3011
+ "naming": "w6w assets upload-create --purpose <skill|context|asset> --idempotency-key <key> --entries <json> [--name <n>] [--visibility private|project|account] [--asset-id <id>] [--target <json>]",
3012
+ "status": "required",
3013
+ "params": [
3014
+ {
3015
+ "name": "purpose",
3016
+ "kind": "flag",
3017
+ "display": "--purpose <skill|context|asset>",
3018
+ "description": "What the upload is for: skill | context (asset for upload-create)",
3019
+ "required": true,
3020
+ },
3021
+ {
3022
+ "name": "idempotencyKey",
3023
+ "kind": "flag",
3024
+ "display": "--idempotency-key <value>",
3025
+ "description": "A caller-chosen key; replaying it with the same entries returns the same upload",
3026
+ "required": true,
3027
+ },
3028
+ {
3029
+ "name": "entries",
3030
+ "kind": "flag",
3031
+ "display": "--entries <json>",
3032
+ "description": "The declared entries, as a JSON array of {path, sizeBytes, sha256, mediaType?}",
3033
+ "required": true,
3034
+ },
3035
+ {
3036
+ "name": "name",
3037
+ "kind": "flag",
3038
+ "display": "--name <n>",
3039
+ "description": "Display name for a new asset",
3040
+ "required": false,
3041
+ },
3042
+ {
3043
+ "name": "visibility",
3044
+ "kind": "flag",
3045
+ "display": "--visibility <value>",
3046
+ "description": "Who can see the asset: private | project | account (default private)",
3047
+ "required": false,
3048
+ },
3049
+ {
3050
+ "name": "assetId",
3051
+ "kind": "flag",
3052
+ "display": "--asset-id <value>",
3053
+ "description": "Publish a new version of this existing asset instead of creating one",
3054
+ "required": false,
3055
+ },
3056
+ {
3057
+ "name": "target",
3058
+ "kind": "flag",
3059
+ "display": "--target <json>",
3060
+ "description": 'Purpose-specific destination, as a JSON object like {"skillId":"sk_…"}',
3061
+ "required": false,
3062
+ },
3063
+ {
3064
+ "name": "json",
3065
+ "kind": "flag",
3066
+ "display": "--json",
3067
+ "description": "Output raw JSON instead of a table",
3068
+ "required": false,
3069
+ },
3070
+ ],
3071
+ "examples": [
3072
+ 'w6w assets upload-create --purpose skill --idempotency-key k1 --entries \'[{"path":"SKILL.md","sizeBytes":12,"sha256":"<hex>"}]\'',
3073
+ ],
3074
+ "notes": [],
3075
+ },
3076
+ {
3077
+ "operation": "assets.uploads.putEntry",
3078
+ "path": [
3079
+ "assets",
3080
+ "upload-put",
3081
+ ],
3082
+ "name": "upload-put",
3083
+ "aliases": [],
3084
+ "summary": "Send one declared entry's raw bytes.",
3085
+ "short": "Send one declared entry's raw bytes",
3086
+ "headline": "send one declared entry's raw bytes",
3087
+ "usage": "w6w assets upload-put <id> <index> --file <path> [options]",
3088
+ "naming": "w6w assets upload-put <id> <index> --file <path>",
3089
+ "status": "required",
3090
+ "params": [
3091
+ {
3092
+ "name": "id",
3093
+ "kind": "argument",
3094
+ "display": "<id>",
3095
+ "description": "Upload id (see: `w6w assets upload-create`)",
3096
+ "required": true,
3097
+ },
3098
+ {
3099
+ "name": "index",
3100
+ "kind": "argument",
3101
+ "display": "<index>",
3102
+ "description": "Zero-based index of the declared entry",
3103
+ "required": true,
3104
+ },
3105
+ {
3106
+ "name": "body",
3107
+ "kind": "flag",
3108
+ "display": "--file <path>",
3109
+ "description": "Path of the file whose bytes are sent as the entry",
3110
+ "required": true,
3111
+ },
3112
+ {
3113
+ "name": "json",
3114
+ "kind": "flag",
3115
+ "display": "--json",
3116
+ "description": "Output raw JSON instead of a table",
3117
+ "required": false,
3118
+ },
3119
+ ],
3120
+ "examples": [
3121
+ "w6w assets upload-put up_01HQ8N 0 --file ./SKILL.md",
3122
+ ],
3123
+ "notes": [],
3124
+ },
3125
+ {
3126
+ "operation": "assets.uploads.finalize",
3127
+ "path": [
3128
+ "assets",
3129
+ "upload-finalize",
3130
+ ],
3131
+ "name": "upload-finalize",
3132
+ "aliases": [],
3133
+ "summary": "Publish a fully received upload as an asset version.",
3134
+ "short": "Publish a fully received upload as an asset version",
3135
+ "headline": "publish a fully received upload as an asset version",
3136
+ "usage": "w6w assets upload-finalize <id> [options]",
3137
+ "naming": "w6w assets upload-finalize <id>",
3138
+ "status": "required",
3139
+ "params": [
3140
+ {
3141
+ "name": "id",
3142
+ "kind": "argument",
3143
+ "display": "<id>",
3144
+ "description": "Upload id (up_…)",
3145
+ "required": true,
3146
+ },
3147
+ {
3148
+ "name": "json",
3149
+ "kind": "flag",
3150
+ "display": "--json",
3151
+ "description": "Output raw JSON instead of a table",
3152
+ "required": false,
3153
+ },
3154
+ ],
3155
+ "examples": [
3156
+ "w6w assets upload-finalize up_01HQ8N",
3157
+ ],
3158
+ "notes": [],
3159
+ },
3160
+ {
3161
+ "operation": "assets.uploads.get",
3162
+ "path": [
3163
+ "assets",
3164
+ "upload-status",
3165
+ ],
3166
+ "name": "upload-status",
3167
+ "aliases": [],
3168
+ "summary": "Read an upload's status and per-entry state (the resume point).",
3169
+ "short": "Read an upload's status and per-entry state (the resume point)",
3170
+ "headline": "read an upload's status and per-entry state (the resume point)",
3171
+ "usage": "w6w assets upload-status <id> [options]",
3172
+ "naming": "w6w assets upload-status <id>",
3173
+ "status": "required",
3174
+ "params": [
3175
+ {
3176
+ "name": "id",
3177
+ "kind": "argument",
3178
+ "display": "<id>",
3179
+ "description": "Upload id (up_…)",
3180
+ "required": true,
3181
+ },
3182
+ {
3183
+ "name": "json",
3184
+ "kind": "flag",
3185
+ "display": "--json",
3186
+ "description": "Output raw JSON instead of a table",
3187
+ "required": false,
3188
+ },
3189
+ ],
3190
+ "examples": [
3191
+ "w6w assets upload-status up_01HQ8N",
3192
+ ],
3193
+ "notes": [],
3194
+ },
3195
+ {
3196
+ "operation": "assets.uploads.abort",
3197
+ "path": [
3198
+ "assets",
3199
+ "upload-abort",
3200
+ ],
3201
+ "name": "upload-abort",
3202
+ "aliases": [],
3203
+ "summary": "Abort an open upload and release its reservation.",
3204
+ "short": "Abort an open upload and release its reservation",
3205
+ "headline": "abort an open upload and release its reservation",
3206
+ "usage": "w6w assets upload-abort <id> [options]",
3207
+ "naming": "w6w assets upload-abort <id>",
3208
+ "status": "required",
3209
+ "params": [
3210
+ {
3211
+ "name": "id",
3212
+ "kind": "argument",
3213
+ "display": "<id>",
3214
+ "description": "Upload id (up_…)",
3215
+ "required": true,
3216
+ },
3217
+ {
3218
+ "name": "json",
3219
+ "kind": "flag",
3220
+ "display": "--json",
3221
+ "description": "Output raw JSON instead of a table",
3222
+ "required": false,
3223
+ },
3224
+ ],
3225
+ "examples": [
3226
+ "w6w assets upload-abort up_01HQ8N",
3227
+ ],
3228
+ "notes": [],
3229
+ },
3230
+ {
3231
+ "operation": "assets.get",
3232
+ "path": [
3233
+ "assets",
3234
+ "get",
3235
+ ],
3236
+ "name": "get",
3237
+ "aliases": [],
3238
+ "summary": "Fetch one asset.",
3239
+ "short": "Fetch one asset",
3240
+ "headline": "fetch one asset",
3241
+ "usage": "w6w assets get <id> [options]",
3242
+ "naming": "w6w assets get <id>",
3243
+ "status": "required",
3244
+ "params": [
3245
+ {
3246
+ "name": "id",
3247
+ "kind": "argument",
3248
+ "display": "<id>",
3249
+ "description": "Asset id",
3250
+ "required": true,
3251
+ },
3252
+ {
3253
+ "name": "json",
3254
+ "kind": "flag",
3255
+ "display": "--json",
3256
+ "description": "Output raw JSON instead of a table",
3257
+ "required": false,
3258
+ },
3259
+ ],
3260
+ "examples": [
3261
+ "w6w assets get ast_01HQ8N",
3262
+ ],
3263
+ "notes": [],
3264
+ },
3265
+ {
3266
+ "operation": "assets.versions",
3267
+ "path": [
3268
+ "assets",
3269
+ "versions",
3270
+ ],
3271
+ "name": "versions",
3272
+ "aliases": [],
3273
+ "summary": "List an asset's versions.",
3274
+ "short": "List an asset's versions",
3275
+ "headline": "list an asset's versions",
3276
+ "usage": "w6w assets versions <id> [options]",
3277
+ "naming": "w6w assets versions <id>",
3278
+ "status": "required",
3279
+ "params": [
3280
+ {
3281
+ "name": "id",
3282
+ "kind": "argument",
3283
+ "display": "<id>",
3284
+ "description": "Asset id",
3285
+ "required": true,
3286
+ },
3287
+ {
3288
+ "name": "json",
3289
+ "kind": "flag",
3290
+ "display": "--json",
3291
+ "description": "Output raw JSON instead of a table",
3292
+ "required": false,
3293
+ },
3294
+ ],
3295
+ "examples": [
3296
+ "w6w assets versions ast_01HQ8N",
3297
+ ],
3298
+ "notes": [],
3299
+ },
3300
+ {
3301
+ "operation": "assets.files",
3302
+ "path": [
3303
+ "assets",
3304
+ "files",
3305
+ ],
3306
+ "name": "files",
3307
+ "aliases": [],
3308
+ "summary": "List the files of one asset version.",
3309
+ "short": "List the files of one asset version",
3310
+ "headline": "list the files of one asset version",
3311
+ "usage": "w6w assets files <id> <versionId> [options]",
3312
+ "naming": "w6w assets files <id> <versionId>",
3313
+ "status": "required",
3314
+ "params": [
3315
+ {
3316
+ "name": "id",
3317
+ "kind": "argument",
3318
+ "display": "<id>",
3319
+ "description": "Asset id",
3320
+ "required": true,
3321
+ },
3322
+ {
3323
+ "name": "versionId",
3324
+ "kind": "argument",
3325
+ "display": "<versionId>",
3326
+ "description": "Asset version id",
3327
+ "required": true,
3328
+ },
3329
+ {
3330
+ "name": "json",
3331
+ "kind": "flag",
3332
+ "display": "--json",
3333
+ "description": "Output raw JSON instead of a table",
3334
+ "required": false,
3335
+ },
3336
+ ],
3337
+ "examples": [
3338
+ "w6w assets files ast_01HQ8N ver_01HQ8N",
3339
+ ],
3340
+ "notes": [],
3341
+ },
3342
+ {
3343
+ "operation": "assets.content",
3344
+ "path": [
3345
+ "assets",
3346
+ "content",
3347
+ ],
3348
+ "name": "content",
3349
+ "aliases": [],
3350
+ "summary": "Download one file's raw bytes.",
3351
+ "short": "Download one file's raw bytes",
3352
+ "headline": "download one file's raw bytes",
3353
+ "usage": "w6w assets content <id> <versionId> <fileId> [options]",
3354
+ "naming": "w6w assets content <id> <versionId> <fileId> [--out <path>]",
3355
+ "status": "required",
3356
+ "params": [
3357
+ {
3358
+ "name": "id",
3359
+ "kind": "argument",
3360
+ "display": "<id>",
3361
+ "description": "Asset id",
3362
+ "required": true,
3363
+ },
3364
+ {
3365
+ "name": "versionId",
3366
+ "kind": "argument",
3367
+ "display": "<versionId>",
3368
+ "description": "Asset version id",
3369
+ "required": true,
3370
+ },
3371
+ {
3372
+ "name": "fileId",
3373
+ "kind": "argument",
3374
+ "display": "<fileId>",
3375
+ "description": "File id within the asset version (see: `w6w assets files`)",
3376
+ "required": true,
3377
+ },
3378
+ {
3379
+ "name": "out",
3380
+ "kind": "flag",
3381
+ "display": "--out <path>",
3382
+ "description": "Write the bytes to this file instead of standard output",
3383
+ "required": false,
3384
+ },
3385
+ {
3386
+ "name": "json",
3387
+ "kind": "flag",
3388
+ "display": "--json",
3389
+ "description": "Output raw JSON instead of a table",
3390
+ "required": false,
3391
+ },
3392
+ ],
3393
+ "examples": [
3394
+ "w6w assets content ast_01HQ8N ver_01HQ8N fil_01HQ8N --out ./SKILL.md",
3395
+ ],
3396
+ "notes": [],
3397
+ },
3398
+ {
3399
+ "operation": "assets.archiveDownload",
3400
+ "path": [
3401
+ "assets",
3402
+ "archive-download",
3403
+ ],
3404
+ "name": "archive-download",
3405
+ "aliases": [],
3406
+ "summary": "Download one version as a store-only ZIP.",
3407
+ "short": "Download one version as a store-only ZIP",
3408
+ "headline": "download one version as a store-only ZIP",
3409
+ "usage": "w6w assets archive-download <id> <versionId> [options]",
3410
+ "naming": "w6w assets archive-download <id> <versionId> [--out <path>]",
3411
+ "status": "required",
3412
+ "params": [
3413
+ {
3414
+ "name": "id",
3415
+ "kind": "argument",
3416
+ "display": "<id>",
3417
+ "description": "Asset id",
3418
+ "required": true,
3419
+ },
3420
+ {
3421
+ "name": "versionId",
3422
+ "kind": "argument",
3423
+ "display": "<versionId>",
3424
+ "description": "Asset version id",
3425
+ "required": true,
3426
+ },
3427
+ {
3428
+ "name": "out",
3429
+ "kind": "flag",
3430
+ "display": "--out <path>",
3431
+ "description": "Write the bytes to this file instead of standard output",
3432
+ "required": false,
3433
+ },
3434
+ {
3435
+ "name": "json",
3436
+ "kind": "flag",
3437
+ "display": "--json",
3438
+ "description": "Output raw JSON instead of a table",
3439
+ "required": false,
3440
+ },
3441
+ ],
3442
+ "examples": [
3443
+ "w6w assets archive-download ast_01HQ8N ver_01HQ8N --out ./asset.zip",
3444
+ ],
3445
+ "notes": [],
3446
+ },
3447
+ {
3448
+ "operation": "assets.archive",
3449
+ "path": [
3450
+ "assets",
3451
+ "archive",
3452
+ ],
3453
+ "name": "archive",
3454
+ "aliases": [],
3455
+ "summary": "Archive an asset (retire it from listings; bytes are kept).",
3456
+ "short": "Archive an asset (retire it from listings; bytes are kept)",
3457
+ "headline": "archive an asset (retire it from listings; bytes are kept)",
3458
+ "usage": "w6w assets archive <id> [options]",
3459
+ "naming": "w6w assets archive <id>",
3460
+ "status": "required",
3461
+ "params": [
3462
+ {
3463
+ "name": "id",
3464
+ "kind": "argument",
3465
+ "display": "<id>",
3466
+ "description": "Asset id",
3467
+ "required": true,
3468
+ },
3469
+ {
3470
+ "name": "json",
3471
+ "kind": "flag",
3472
+ "display": "--json",
3473
+ "description": "Output raw JSON instead of a table",
3474
+ "required": false,
3475
+ },
3476
+ ],
3477
+ "examples": [
3478
+ "w6w assets archive ast_01HQ8N",
3479
+ ],
3480
+ "notes": [],
3481
+ },
3482
+ {
3483
+ "operation": "assets.purge",
3484
+ "path": [
3485
+ "assets",
3486
+ "purge",
3487
+ ],
3488
+ "name": "purge",
3489
+ "aliases": [],
3490
+ "summary": "Permanently delete an asset, its versions and their bytes (account admin only).",
3491
+ "short": "Permanently delete an asset, its versions and their bytes (account admin only)",
3492
+ "headline": "permanently delete an asset, its versions and their bytes (account admin only)",
3493
+ "usage": "w6w assets purge <id> [options]",
3494
+ "naming": "w6w assets purge <id>",
3495
+ "status": "required",
3496
+ "params": [
3497
+ {
3498
+ "name": "id",
3499
+ "kind": "argument",
3500
+ "display": "<id>",
3501
+ "description": "Asset id",
3502
+ "required": true,
3503
+ },
3504
+ {
3505
+ "name": "json",
3506
+ "kind": "flag",
3507
+ "display": "--json",
3508
+ "description": "Output raw JSON instead of a table",
3509
+ "required": false,
3510
+ },
3511
+ ],
3512
+ "examples": [
3513
+ "w6w assets purge ast_01HQ8N",
3514
+ ],
3515
+ "notes": [],
3516
+ },
3517
+ {
3518
+ "operation": "assets.upload",
3519
+ "path": [
3520
+ "assets",
3521
+ "upload",
3522
+ ],
3523
+ "name": "upload",
3524
+ "aliases": [],
3525
+ "summary": "Upload a directory (or a ZIP) as an asset: walk, hash, create, put each entry with progress, finalize.",
3526
+ "short": "Upload a directory (or a ZIP) as an asset: walk, hash, create, put each entry with progress, finalize",
3527
+ "headline": "upload a directory (or a ZIP) as an asset: walk, hash, create, put each entry with progress, finalize",
3528
+ "usage": "w6w assets upload <path> --purpose <skill|context> [options]",
3529
+ "naming": "w6w assets upload <path> --purpose <skill|context> [--skill <id>] [--collection <id>] [--visibility <v>] [--retry]",
3530
+ "status": "live",
3531
+ "params": [
3532
+ {
3533
+ "name": "path",
3534
+ "kind": "argument",
3535
+ "display": "<path>",
3536
+ "description": "A directory to upload (or a .zip file, sent as a single archive)",
3537
+ "required": true,
3538
+ },
3539
+ {
3540
+ "name": "purpose",
3541
+ "kind": "flag",
3542
+ "display": "--purpose <skill|context>",
3543
+ "description": "What the upload is for: skill | context (asset for upload-create)",
3544
+ "required": true,
3545
+ },
3546
+ {
3547
+ "name": "skill",
3548
+ "kind": "flag",
3549
+ "display": "--skill <id>",
3550
+ "description": "Attach the uploaded files to this skill id",
3551
+ "required": false,
3552
+ },
3553
+ {
3554
+ "name": "collection",
3555
+ "kind": "flag",
3556
+ "display": "--collection <id>",
3557
+ "description": "Attach the uploaded files to this context collection id",
3558
+ "required": false,
3559
+ },
3560
+ {
3561
+ "name": "visibility",
3562
+ "kind": "flag",
3563
+ "display": "--visibility <v>",
3564
+ "description": "Who can see the uploaded context: private | project | account",
3565
+ "required": false,
3566
+ },
3567
+ {
3568
+ "name": "retry",
3569
+ "kind": "flag",
3570
+ "display": "--retry",
3571
+ "description": "Resume an interrupted upload: skip entries the server already received",
3572
+ "required": false,
3573
+ },
3574
+ {
3575
+ "name": "json",
3576
+ "kind": "flag",
3577
+ "display": "--json",
3578
+ "description": "Output raw JSON instead of a table",
3579
+ "required": false,
3580
+ },
3581
+ ],
3582
+ "examples": [
3583
+ "w6w assets upload ./my-skill --purpose skill --skill sk_01HQ8N",
3584
+ "w6w assets upload ./docs --purpose context --collection cc_01HQ8N --retry",
3585
+ ],
3586
+ "notes": [],
3587
+ },
3588
+ ],
3589
+ "options": [],
3590
+ "examples": [
3591
+ "w6w assets upload ./my-skill --purpose skill",
3592
+ "w6w assets get ast_01HQ8N",
3593
+ ],
3594
+ },
3595
+ {
3596
+ "name": "skills",
3597
+ "summary": "List, inspect and archive skills (upload them with: w6w assets upload --purpose skill)",
3598
+ "headline": "list, inspect and archive skills (upload them with: w6w assets upload --purpose skill)",
3599
+ "usage": "w6w skills <command> [options]",
3600
+ "commands": [
3601
+ {
3602
+ "operation": "skills.list",
3603
+ "path": [
3604
+ "skills",
3605
+ "list",
3606
+ ],
3607
+ "name": "list",
3608
+ "aliases": [],
3609
+ "summary": "List skills visible to the caller.",
3610
+ "short": "List skills visible to the caller",
3611
+ "headline": "list skills visible to the caller",
3612
+ "usage": "w6w skills list [options]",
3613
+ "naming": "w6w skills list [--include-archived] [--limit <n>]",
3614
+ "status": "required",
3615
+ "params": [
3616
+ {
3617
+ "name": "includeArchived",
3618
+ "kind": "flag",
3619
+ "display": "--include-archived",
3620
+ "description": "Include archived rows (default: hidden)",
3621
+ "required": false,
3622
+ },
3623
+ {
3624
+ "name": "limit",
3625
+ "kind": "flag",
3626
+ "display": "--limit <n>",
3627
+ "description": "Maximum number of results per page",
3628
+ "required": false,
3629
+ },
3630
+ {
3631
+ "name": "json",
3632
+ "kind": "flag",
3633
+ "display": "--json",
3634
+ "description": "Output raw JSON instead of a table",
3635
+ "required": false,
3636
+ },
3637
+ ],
3638
+ "examples": [
3639
+ "w6w skills list",
3640
+ "w6w skills list --include-archived --limit 20",
3641
+ ],
3642
+ "notes": [],
3643
+ },
3644
+ {
3645
+ "operation": "skills.get",
3646
+ "path": [
3647
+ "skills",
3648
+ "get",
3649
+ ],
3650
+ "name": "get",
3651
+ "aliases": [],
3652
+ "summary": "Fetch one skill.",
3653
+ "short": "Fetch one skill",
3654
+ "headline": "fetch one skill",
3655
+ "usage": "w6w skills get <id> [options]",
3656
+ "naming": "w6w skills get <id>",
3657
+ "status": "required",
3658
+ "params": [
3659
+ {
3660
+ "name": "id",
3661
+ "kind": "argument",
3662
+ "display": "<id>",
3663
+ "description": "Skill id (see: w6w skills list)",
3664
+ "required": true,
3665
+ },
3666
+ {
3667
+ "name": "json",
3668
+ "kind": "flag",
3669
+ "display": "--json",
3670
+ "description": "Output raw JSON instead of a table",
3671
+ "required": false,
3672
+ },
3673
+ ],
3674
+ "examples": [
3675
+ "w6w skills get sk_01HQ8N",
3676
+ ],
3677
+ "notes": [],
3678
+ },
3679
+ {
3680
+ "operation": "skills.versions",
3681
+ "path": [
3682
+ "skills",
3683
+ "versions",
3684
+ ],
3685
+ "name": "versions",
3686
+ "aliases": [],
3687
+ "summary": "List a skill's versions.",
3688
+ "short": "List a skill's versions",
3689
+ "headline": "list a skill's versions",
3690
+ "usage": "w6w skills versions <id> [options]",
3691
+ "naming": "w6w skills versions <id>",
3692
+ "status": "required",
3693
+ "params": [
3694
+ {
3695
+ "name": "id",
3696
+ "kind": "argument",
3697
+ "display": "<id>",
3698
+ "description": "Skill id (see: w6w skills list)",
3699
+ "required": true,
3700
+ },
3701
+ {
3702
+ "name": "json",
3703
+ "kind": "flag",
3704
+ "display": "--json",
3705
+ "description": "Output raw JSON instead of a table",
3706
+ "required": false,
3707
+ },
3708
+ ],
3709
+ "examples": [
3710
+ "w6w skills versions sk_01HQ8N",
3711
+ ],
3712
+ "notes": [],
3713
+ },
3714
+ {
3715
+ "operation": "skills.archive",
3716
+ "path": [
3717
+ "skills",
3718
+ "archive",
3719
+ ],
3720
+ "name": "archive",
3721
+ "aliases": [],
3722
+ "summary": "Archive a skill (retire it from listings).",
3723
+ "short": "Archive a skill (retire it from listings)",
3724
+ "headline": "archive a skill (retire it from listings)",
3725
+ "usage": "w6w skills archive <id> [options]",
3726
+ "naming": "w6w skills archive <id>",
3727
+ "status": "required",
3728
+ "params": [
3729
+ {
3730
+ "name": "id",
3731
+ "kind": "argument",
3732
+ "display": "<id>",
3733
+ "description": "Skill id (see: w6w skills list)",
3734
+ "required": true,
3735
+ },
3736
+ {
3737
+ "name": "json",
3738
+ "kind": "flag",
3739
+ "display": "--json",
3740
+ "description": "Output raw JSON instead of a table",
3741
+ "required": false,
3742
+ },
3743
+ ],
3744
+ "examples": [
3745
+ "w6w skills archive sk_01HQ8N",
3746
+ ],
3747
+ "notes": [],
3748
+ },
3749
+ ],
3750
+ "options": [],
3751
+ "examples": [
3752
+ "w6w skills list",
3753
+ "w6w skills versions sk_01HQ8N",
3754
+ ],
3755
+ },
3756
+ {
3757
+ "name": "context",
3758
+ "summary": "Create and edit context collections and their text entries",
3759
+ "headline": "create and edit context collections and their text entries",
3760
+ "usage": "w6w context <command> [options]",
3761
+ "commands": [
3762
+ {
3763
+ "operation": "context.list",
3764
+ "path": [
3765
+ "context",
3766
+ "list",
3767
+ ],
3768
+ "name": "list",
3769
+ "aliases": [],
3770
+ "summary": "List context collections visible to the caller.",
3771
+ "short": "List context collections visible to the caller",
3772
+ "headline": "list context collections visible to the caller",
3773
+ "usage": "w6w context list [options]",
3774
+ "naming": "w6w context list [--include-archived] [--limit <n>]",
3775
+ "status": "required",
3776
+ "params": [
3777
+ {
3778
+ "name": "includeArchived",
3779
+ "kind": "flag",
3780
+ "display": "--include-archived",
3781
+ "description": "Include archived rows (default: hidden)",
3782
+ "required": false,
3783
+ },
3784
+ {
3785
+ "name": "limit",
3786
+ "kind": "flag",
3787
+ "display": "--limit <n>",
3788
+ "description": "Maximum number of results per page",
3789
+ "required": false,
3790
+ },
3791
+ {
3792
+ "name": "json",
3793
+ "kind": "flag",
3794
+ "display": "--json",
3795
+ "description": "Output raw JSON instead of a table",
3796
+ "required": false,
3797
+ },
3798
+ ],
3799
+ "examples": [
3800
+ "w6w context list",
3801
+ "w6w context list --include-archived",
3802
+ ],
3803
+ "notes": [],
3804
+ },
3805
+ {
3806
+ "operation": "context.create",
3807
+ "path": [
3808
+ "context",
3809
+ "create",
3810
+ ],
3811
+ "name": "create",
3812
+ "aliases": [],
3813
+ "summary": "Create a context collection.",
3814
+ "short": "Create a context collection",
3815
+ "headline": "create a context collection",
3816
+ "usage": "w6w context create <name> [options]",
3817
+ "naming": "w6w context create <name> [--description <d>] [--tags <t,t>] [--visibility private|project|account]",
3818
+ "status": "required",
3819
+ "params": [
3820
+ {
3821
+ "name": "name",
3822
+ "kind": "argument",
3823
+ "display": "<name>",
3824
+ "description": "Collection name",
3825
+ "required": true,
3826
+ },
3827
+ {
3828
+ "name": "description",
3829
+ "kind": "flag",
3830
+ "display": "--description <d>",
3831
+ "description": "Human-readable description",
3832
+ "required": false,
3833
+ },
3834
+ {
3835
+ "name": "tags",
3836
+ "kind": "flag",
3837
+ "display": "--tags <t,t>",
3838
+ "description": "Tags, comma-separated or a JSON array of strings",
3839
+ "required": false,
3840
+ },
3841
+ {
3842
+ "name": "visibility",
3843
+ "kind": "flag",
3844
+ "display": "--visibility <value>",
3845
+ "description": "Who can see the collection: private | project | account",
3846
+ "required": false,
3847
+ },
3848
+ {
3849
+ "name": "json",
3850
+ "kind": "flag",
3851
+ "display": "--json",
3852
+ "description": "Output raw JSON instead of a table",
3853
+ "required": false,
3854
+ },
3855
+ ],
3856
+ "examples": [
3857
+ 'w6w context create handbook --description "Team handbook" --tags docs,hr',
3858
+ ],
3859
+ "notes": [],
3860
+ },
3861
+ {
3862
+ "operation": "context.get",
3863
+ "path": [
3864
+ "context",
3865
+ "get",
3866
+ ],
3867
+ "name": "get",
3868
+ "aliases": [],
3869
+ "summary": "Fetch one context collection.",
3870
+ "short": "Fetch one context collection",
3871
+ "headline": "fetch one context collection",
3872
+ "usage": "w6w context get <id> [options]",
3873
+ "naming": "w6w context get <id>",
3874
+ "status": "required",
3875
+ "params": [
3876
+ {
3877
+ "name": "id",
3878
+ "kind": "argument",
3879
+ "display": "<id>",
3880
+ "description": "Context collection id (see: w6w context list)",
3881
+ "required": true,
3882
+ },
3883
+ {
3884
+ "name": "json",
3885
+ "kind": "flag",
3886
+ "display": "--json",
3887
+ "description": "Output raw JSON instead of a table",
3888
+ "required": false,
3889
+ },
3890
+ ],
3891
+ "examples": [
3892
+ "w6w context get cc_01HQ8N",
3893
+ ],
3894
+ "notes": [],
3895
+ },
3896
+ {
3897
+ "operation": "context.update",
3898
+ "path": [
3899
+ "context",
3900
+ "update",
3901
+ ],
3902
+ "name": "update",
3903
+ "aliases": [],
3904
+ "summary": "Patch a context collection's name, description or tags.",
3905
+ "short": "Patch a context collection's name, description or tags",
3906
+ "headline": "patch a context collection's name, description or tags",
3907
+ "usage": "w6w context update <id> --name <n> [options]",
3908
+ "naming": "w6w context update <id> [--name <n>] [--description <d>] [--tags <t,t>]",
3909
+ "status": "required",
3910
+ "params": [
3911
+ {
3912
+ "name": "id",
3913
+ "kind": "argument",
3914
+ "display": "<id>",
3915
+ "description": "Context collection id (see: w6w context list)",
3916
+ "required": true,
3917
+ },
3918
+ {
3919
+ "name": "name",
3920
+ "kind": "flag",
3921
+ "display": "--name <n>",
3922
+ "description": "New collection name",
3923
+ "required": true,
3924
+ },
3925
+ {
3926
+ "name": "description",
3927
+ "kind": "flag",
3928
+ "display": "--description <d>",
3929
+ "description": "Human-readable description",
3930
+ "required": false,
3931
+ },
3932
+ {
3933
+ "name": "tags",
3934
+ "kind": "flag",
3935
+ "display": "--tags <t,t>",
3936
+ "description": "Tags, comma-separated or a JSON array of strings",
3937
+ "required": false,
3938
+ },
3939
+ {
3940
+ "name": "json",
3941
+ "kind": "flag",
3942
+ "display": "--json",
3943
+ "description": "Output raw JSON instead of a table",
3944
+ "required": false,
3945
+ },
3946
+ ],
3947
+ "examples": [
3948
+ 'w6w context update cc_01HQ8N --description "Updated handbook"',
3949
+ ],
3950
+ "notes": [],
3951
+ },
3952
+ {
3953
+ "operation": "context.archive",
3954
+ "path": [
3955
+ "context",
3956
+ "archive",
3957
+ ],
3958
+ "name": "archive",
3959
+ "aliases": [],
3960
+ "summary": "Archive a context collection.",
3961
+ "short": "Archive a context collection",
3962
+ "headline": "archive a context collection",
3963
+ "usage": "w6w context archive <id> [options]",
3964
+ "naming": "w6w context archive <id>",
3965
+ "status": "required",
3966
+ "params": [
3967
+ {
3968
+ "name": "id",
3969
+ "kind": "argument",
3970
+ "display": "<id>",
3971
+ "description": "Context collection id (see: w6w context list)",
3972
+ "required": true,
3973
+ },
3974
+ {
3975
+ "name": "json",
3976
+ "kind": "flag",
3977
+ "display": "--json",
3978
+ "description": "Output raw JSON instead of a table",
3979
+ "required": false,
3980
+ },
3981
+ ],
3982
+ "examples": [
3983
+ "w6w context archive cc_01HQ8N",
3984
+ ],
3985
+ "notes": [],
3986
+ },
3987
+ {
3988
+ "operation": "context.entries.list",
3989
+ "path": [
3990
+ "context",
3991
+ "entries-list",
3992
+ ],
3993
+ "name": "entries-list",
3994
+ "aliases": [],
3995
+ "summary": "List the entries of a context collection.",
3996
+ "short": "List the entries of a context collection",
3997
+ "headline": "list the entries of a context collection",
3998
+ "usage": "w6w context entries-list <id> [options]",
3999
+ "naming": "w6w context entries-list <id> [--include-archived]",
4000
+ "status": "required",
4001
+ "params": [
4002
+ {
4003
+ "name": "id",
4004
+ "kind": "argument",
4005
+ "display": "<id>",
4006
+ "description": "Context collection id (see: w6w context list)",
4007
+ "required": true,
4008
+ },
4009
+ {
4010
+ "name": "includeArchived",
4011
+ "kind": "flag",
4012
+ "display": "--include-archived",
4013
+ "description": "Include archived rows (default: hidden)",
4014
+ "required": false,
4015
+ },
4016
+ {
4017
+ "name": "json",
4018
+ "kind": "flag",
4019
+ "display": "--json",
4020
+ "description": "Output raw JSON instead of a table",
4021
+ "required": false,
4022
+ },
4023
+ ],
4024
+ "examples": [
4025
+ "w6w context entries-list cc_01HQ8N",
4026
+ ],
4027
+ "notes": [],
4028
+ },
4029
+ {
4030
+ "operation": "context.entries.create",
4031
+ "path": [
4032
+ "context",
4033
+ "entries-create",
4034
+ ],
4035
+ "name": "entries-create",
4036
+ "aliases": [],
4037
+ "summary": "Add a text entry to a context collection.",
4038
+ "short": "Add a text entry to a context collection",
4039
+ "headline": "add a text entry to a context collection",
4040
+ "usage": "w6w context entries-create <id> <name> --text <text> [options]",
4041
+ "naming": "w6w context entries-create <id> <name> --text <text>",
4042
+ "status": "required",
4043
+ "params": [
4044
+ {
4045
+ "name": "id",
4046
+ "kind": "argument",
4047
+ "display": "<id>",
4048
+ "description": "Context collection id (see: w6w context list)",
4049
+ "required": true,
4050
+ },
4051
+ {
4052
+ "name": "name",
4053
+ "kind": "argument",
4054
+ "display": "<name>",
4055
+ "description": "Display name",
4056
+ "required": true,
4057
+ },
4058
+ {
4059
+ "name": "text",
4060
+ "kind": "flag",
4061
+ "display": "--text <text>",
4062
+ "description": "The entry's text content",
4063
+ "required": true,
4064
+ },
4065
+ {
4066
+ "name": "json",
4067
+ "kind": "flag",
4068
+ "display": "--json",
4069
+ "description": "Output raw JSON instead of a table",
4070
+ "required": false,
4071
+ },
4072
+ ],
4073
+ "examples": [
4074
+ 'w6w context entries-create cc_01HQ8N welcome --text "Welcome aboard"',
4075
+ ],
4076
+ "notes": [],
4077
+ },
4078
+ {
4079
+ "operation": "context.entries.update",
4080
+ "path": [
4081
+ "context",
4082
+ "entries-update",
4083
+ ],
4084
+ "name": "entries-update",
4085
+ "aliases": [],
4086
+ "summary": "Replace a text entry's content.",
4087
+ "short": "Replace a text entry's content",
4088
+ "headline": "replace a text entry's content",
4089
+ "usage": "w6w context entries-update <id> <entryId> --text <text> --revision <n> [options]",
4090
+ "naming": "w6w context entries-update <id> <entryId> --text <text> --revision <n> [--if-unmodified-since <ts>]",
4091
+ "status": "required",
4092
+ "params": [
4093
+ {
4094
+ "name": "id",
4095
+ "kind": "argument",
4096
+ "display": "<id>",
4097
+ "description": "Context collection id (see: w6w context list)",
4098
+ "required": true,
4099
+ },
4100
+ {
4101
+ "name": "entryId",
4102
+ "kind": "argument",
4103
+ "display": "<entryId>",
4104
+ "description": "Entry id (see: w6w context entries-list)",
4105
+ "required": true,
4106
+ },
4107
+ {
4108
+ "name": "text",
4109
+ "kind": "flag",
4110
+ "display": "--text <text>",
4111
+ "description": "The entry's text content",
4112
+ "required": true,
4113
+ },
4114
+ {
4115
+ "name": "revision",
4116
+ "kind": "flag",
4117
+ "display": "--revision <n>",
4118
+ "description": "The revision you last read (from the entry/agent you are editing); a stale one is refused with a conflict",
4119
+ "required": true,
4120
+ },
4121
+ {
4122
+ "name": "ifUnmodifiedSince",
4123
+ "kind": "flag",
4124
+ "display": "--if-unmodified-since <value>",
4125
+ "description": "Refuse the write if the entry changed since this updatedAt (see: w6w context entries-list); the server requires it",
4126
+ "required": false,
4127
+ },
4128
+ {
4129
+ "name": "json",
4130
+ "kind": "flag",
4131
+ "display": "--json",
4132
+ "description": "Output raw JSON instead of a table",
4133
+ "required": false,
4134
+ },
4135
+ ],
4136
+ "examples": [
4137
+ 'w6w context entries-update cc_01HQ8N ent_01HQ8N --text "Hello again" --revision 1 --if-unmodified-since 2026-10-24T09:00:00.000Z',
4138
+ ],
4139
+ "notes": [],
4140
+ },
4141
+ ],
4142
+ "options": [],
4143
+ "examples": [
4144
+ "w6w context list",
4145
+ "w6w context entries-list cc_01HQ8N",
4146
+ ],
4147
+ },
4148
+ {
4149
+ "name": "context-entries",
4150
+ "summary": "Create and edit context entries independent of any collection",
4151
+ "headline": "create and edit context entries independent of any collection",
4152
+ "usage": "w6w context-entries <command> [options]",
4153
+ "commands": [
4154
+ {
4155
+ "operation": "contextEntries.list",
4156
+ "path": [
4157
+ "context-entries",
4158
+ "list",
4159
+ ],
4160
+ "name": "list",
4161
+ "aliases": [],
4162
+ "summary": "List context entries visible to the caller, across collections.",
4163
+ "short": "List context entries visible to the caller, across collections",
4164
+ "headline": "list context entries visible to the caller, across collections",
4165
+ "usage": "w6w context-entries list [options]",
4166
+ "naming": "w6w context-entries list [--collection-id <id>] [--include-archived] [--project <p>]",
4167
+ "status": "required",
4168
+ "params": [
4169
+ {
4170
+ "name": "collectionId",
4171
+ "kind": "flag",
4172
+ "display": "--collection-id <value>",
4173
+ "description": "Only entries that are members of this collection id",
4174
+ "required": false,
4175
+ },
4176
+ {
4177
+ "name": "includeArchived",
4178
+ "kind": "flag",
4179
+ "display": "--include-archived",
4180
+ "description": "Include archived rows (default: hidden)",
4181
+ "required": false,
4182
+ },
4183
+ {
4184
+ "name": "project",
4185
+ "kind": "flag",
4186
+ "display": "--project <p>",
4187
+ "description": "Project to scope to (default: the account's default project)",
4188
+ "required": false,
4189
+ },
4190
+ {
4191
+ "name": "json",
4192
+ "kind": "flag",
4193
+ "display": "--json",
4194
+ "description": "Output raw JSON instead of a table",
4195
+ "required": false,
4196
+ },
4197
+ ],
4198
+ "examples": [
4199
+ "w6w context-entries list",
4200
+ "w6w context-entries list --collection-id cc_01HQ8N --include-archived",
4201
+ ],
4202
+ "notes": [],
4203
+ },
4204
+ {
4205
+ "operation": "contextEntries.create",
4206
+ "path": [
4207
+ "context-entries",
4208
+ "create",
4209
+ ],
4210
+ "name": "create",
4211
+ "aliases": [],
4212
+ "summary": "Create a text entry, optionally in collections.",
4213
+ "short": "Create a text entry, optionally in collections",
4214
+ "headline": "create a text entry, optionally in collections",
4215
+ "usage": "w6w context-entries create <name> --text <text> [options]",
4216
+ "naming": "w6w context-entries create <name> --text <text> [--visibility <v>] [--collection-id <id>...]",
4217
+ "status": "required",
4218
+ "params": [
4219
+ {
4220
+ "name": "name",
4221
+ "kind": "argument",
4222
+ "display": "<name>",
4223
+ "description": "Entry name",
4224
+ "required": true,
4225
+ },
4226
+ {
4227
+ "name": "text",
4228
+ "kind": "flag",
4229
+ "display": "--text <text>",
4230
+ "description": "The entry's text content",
4231
+ "required": true,
4232
+ },
4233
+ {
4234
+ "name": "visibility",
4235
+ "kind": "flag",
4236
+ "display": "--visibility <v>",
4237
+ "description": "Who can see the entry: private | project | account",
4238
+ "required": false,
4239
+ },
4240
+ {
4241
+ "name": "collectionIds",
4242
+ "kind": "flag",
4243
+ "display": "--collection-id <id>",
4244
+ "description": "Make the entry a member of this collection id (comma-separate several)",
4245
+ "required": false,
4246
+ },
4247
+ {
4248
+ "name": "json",
4249
+ "kind": "flag",
4250
+ "display": "--json",
4251
+ "description": "Output raw JSON instead of a table",
4252
+ "required": false,
4253
+ },
4254
+ ],
4255
+ "examples": [
4256
+ 'w6w context-entries create welcome --text "Welcome aboard" --visibility account',
4257
+ ],
4258
+ "notes": [],
4259
+ },
4260
+ {
4261
+ "operation": "contextEntries.get",
4262
+ "path": [
4263
+ "context-entries",
4264
+ "get",
4265
+ ],
4266
+ "name": "get",
4267
+ "aliases": [],
4268
+ "summary": "Fetch one context entry.",
4269
+ "short": "Fetch one context entry",
4270
+ "headline": "fetch one context entry",
4271
+ "usage": "w6w context-entries get <id> [options]",
4272
+ "naming": "w6w context-entries get <id>",
4273
+ "status": "required",
4274
+ "params": [
4275
+ {
4276
+ "name": "id",
4277
+ "kind": "argument",
4278
+ "display": "<id>",
4279
+ "description": "Context entry id (see: w6w context-entries list)",
4280
+ "required": true,
4281
+ },
4282
+ {
4283
+ "name": "json",
4284
+ "kind": "flag",
4285
+ "display": "--json",
4286
+ "description": "Output raw JSON instead of a table",
4287
+ "required": false,
4288
+ },
4289
+ ],
4290
+ "examples": [
4291
+ "w6w context-entries get ent_01HQ8N",
4292
+ ],
4293
+ "notes": [],
4294
+ },
4295
+ {
4296
+ "operation": "contextEntries.update",
4297
+ "path": [
4298
+ "context-entries",
4299
+ "update",
4300
+ ],
4301
+ "name": "update",
4302
+ "aliases": [],
4303
+ "summary": "Replace a text entry's content.",
4304
+ "short": "Replace a text entry's content",
4305
+ "headline": "replace a text entry's content",
4306
+ "usage": "w6w context-entries update <id> --text <text> --revision <n> [options]",
4307
+ "naming": "w6w context-entries update <id> --text <text> --revision <n> [--if-unmodified-since <ts>]",
4308
+ "status": "required",
4309
+ "params": [
4310
+ {
4311
+ "name": "id",
4312
+ "kind": "argument",
4313
+ "display": "<id>",
4314
+ "description": "Context entry id (see: w6w context-entries list)",
4315
+ "required": true,
4316
+ },
4317
+ {
4318
+ "name": "text",
4319
+ "kind": "flag",
4320
+ "display": "--text <text>",
4321
+ "description": "The entry's text content",
4322
+ "required": true,
4323
+ },
4324
+ {
4325
+ "name": "revision",
4326
+ "kind": "flag",
4327
+ "display": "--revision <n>",
4328
+ "description": "The revision you last read (from the entry/agent you are editing); a stale one is refused with a conflict",
4329
+ "required": true,
4330
+ },
4331
+ {
4332
+ "name": "ifUnmodifiedSince",
4333
+ "kind": "flag",
4334
+ "display": "--if-unmodified-since <value>",
4335
+ "description": "Refuse the write if the entry changed since this updatedAt (see: w6w context-entries get); the server requires it",
4336
+ "required": false,
4337
+ },
4338
+ {
4339
+ "name": "json",
4340
+ "kind": "flag",
4341
+ "display": "--json",
4342
+ "description": "Output raw JSON instead of a table",
4343
+ "required": false,
4344
+ },
4345
+ ],
4346
+ "examples": [
4347
+ 'w6w context-entries update ent_01HQ8N --text "Hello again" --revision 1 --if-unmodified-since 2026-10-24T09:00:00.000Z',
4348
+ ],
4349
+ "notes": [],
4350
+ },
4351
+ {
4352
+ "operation": "contextEntries.archive",
4353
+ "path": [
4354
+ "context-entries",
4355
+ "archive",
4356
+ ],
4357
+ "name": "archive",
4358
+ "aliases": [],
4359
+ "summary": "Archive a context entry.",
4360
+ "short": "Archive a context entry",
4361
+ "headline": "archive a context entry",
4362
+ "usage": "w6w context-entries archive <id> [options]",
4363
+ "naming": "w6w context-entries archive <id>",
4364
+ "status": "required",
4365
+ "params": [
4366
+ {
4367
+ "name": "id",
4368
+ "kind": "argument",
4369
+ "display": "<id>",
4370
+ "description": "Context entry id (see: w6w context-entries list)",
4371
+ "required": true,
4372
+ },
4373
+ {
4374
+ "name": "json",
4375
+ "kind": "flag",
4376
+ "display": "--json",
4377
+ "description": "Output raw JSON instead of a table",
4378
+ "required": false,
4379
+ },
4380
+ ],
4381
+ "examples": [
4382
+ "w6w context-entries archive ent_01HQ8N",
4383
+ ],
4384
+ "notes": [],
4385
+ },
4386
+ {
4387
+ "operation": "contextEntries.addToCollection",
4388
+ "path": [
4389
+ "context-entries",
4390
+ "add-to-collection",
4391
+ ],
4392
+ "name": "add-to-collection",
4393
+ "aliases": [],
4394
+ "summary": "Add an entry to a collection.",
4395
+ "short": "Add an entry to a collection",
4396
+ "headline": "add an entry to a collection",
4397
+ "usage": "w6w context-entries add-to-collection <id> <collectionId> [options]",
4398
+ "naming": "w6w context-entries add-to-collection <id> <collectionId>",
4399
+ "status": "required",
4400
+ "params": [
4401
+ {
4402
+ "name": "id",
4403
+ "kind": "argument",
4404
+ "display": "<id>",
4405
+ "description": "Context entry id (see: w6w context-entries list)",
4406
+ "required": true,
4407
+ },
4408
+ {
4409
+ "name": "collectionId",
4410
+ "kind": "argument",
4411
+ "display": "<collectionId>",
4412
+ "description": "Context collection id (see: w6w context list)",
4413
+ "required": true,
4414
+ },
4415
+ {
4416
+ "name": "json",
4417
+ "kind": "flag",
4418
+ "display": "--json",
4419
+ "description": "Output raw JSON instead of a table",
4420
+ "required": false,
4421
+ },
4422
+ ],
4423
+ "examples": [
4424
+ "w6w context-entries add-to-collection ent_01HQ8N cc_01HQ8N",
4425
+ ],
4426
+ "notes": [],
4427
+ },
4428
+ {
4429
+ "operation": "contextEntries.removeFromCollection",
4430
+ "path": [
4431
+ "context-entries",
4432
+ "remove-from-collection",
4433
+ ],
4434
+ "name": "remove-from-collection",
4435
+ "aliases": [],
4436
+ "summary": "Remove an entry from a collection.",
4437
+ "short": "Remove an entry from a collection",
4438
+ "headline": "remove an entry from a collection",
4439
+ "usage": "w6w context-entries remove-from-collection <id> <collectionId> [options]",
4440
+ "naming": "w6w context-entries remove-from-collection <id> <collectionId>",
4441
+ "status": "required",
4442
+ "params": [
4443
+ {
4444
+ "name": "id",
4445
+ "kind": "argument",
4446
+ "display": "<id>",
4447
+ "description": "Context entry id (see: w6w context-entries list)",
4448
+ "required": true,
4449
+ },
4450
+ {
4451
+ "name": "collectionId",
4452
+ "kind": "argument",
4453
+ "display": "<collectionId>",
4454
+ "description": "Context collection id (see: w6w context list)",
4455
+ "required": true,
4456
+ },
4457
+ {
4458
+ "name": "json",
4459
+ "kind": "flag",
4460
+ "display": "--json",
4461
+ "description": "Output raw JSON instead of a table",
4462
+ "required": false,
4463
+ },
4464
+ ],
4465
+ "examples": [
4466
+ "w6w context-entries remove-from-collection ent_01HQ8N cc_01HQ8N",
4467
+ ],
4468
+ "notes": [],
4469
+ },
4470
+ ],
4471
+ "options": [],
4472
+ "examples": [
4473
+ "w6w context-entries list",
4474
+ "w6w context-entries get ent_01HQ8N",
4475
+ ],
4476
+ },
4477
+ {
4478
+ "name": "agents",
4479
+ "summary": "Create and edit agent drafts (drafts only: no agent runtime exists yet)",
4480
+ "headline": "create and edit agent drafts (drafts only: no agent runtime exists yet)",
4481
+ "usage": "w6w agents <command> [options]",
4482
+ "commands": [
4483
+ {
4484
+ "operation": "agents.list",
4485
+ "path": [
4486
+ "agents",
4487
+ "list",
4488
+ ],
4489
+ "name": "list",
4490
+ "aliases": [],
4491
+ "summary": "List agent drafts visible to the caller.",
4492
+ "short": "List agent drafts visible to the caller",
4493
+ "headline": "list agent drafts visible to the caller",
4494
+ "usage": "w6w agents list [options]",
4495
+ "naming": "w6w agents list [--include-archived]",
4496
+ "status": "required",
4497
+ "params": [
4498
+ {
4499
+ "name": "includeArchived",
4500
+ "kind": "flag",
4501
+ "display": "--include-archived",
4502
+ "description": "Include archived rows (default: hidden)",
4503
+ "required": false,
4504
+ },
4505
+ {
4506
+ "name": "json",
4507
+ "kind": "flag",
4508
+ "display": "--json",
4509
+ "description": "Output raw JSON instead of a table",
4510
+ "required": false,
4511
+ },
4512
+ ],
4513
+ "examples": [
4514
+ "w6w agents list",
4515
+ "w6w agents list --include-archived",
4516
+ ],
4517
+ "notes": [],
4518
+ },
4519
+ {
4520
+ "operation": "agents.create",
4521
+ "path": [
4522
+ "agents",
4523
+ "create",
4524
+ ],
4525
+ "name": "create",
4526
+ "aliases": [],
4527
+ "summary": "Create an agent draft.",
4528
+ "short": "Create an agent draft",
4529
+ "headline": "create an agent draft",
4530
+ "usage": "w6w agents create [options]",
4531
+ "naming": "w6w agents create [--name <n>] [--instructions <text>] [--model-route-id <id>] [--skills <json>] [--context <json>] [--visibility private|project|account] [--project <id>] [--temperature <n>] [--top-p <n>] [--max-output-tokens <n>] [--stop <text>]...",
4532
+ "status": "required",
4533
+ "params": [
4534
+ {
4535
+ "name": "name",
4536
+ "kind": "flag",
4537
+ "display": "--name <n>",
4538
+ "description": "Display name",
4539
+ "required": false,
4540
+ },
4541
+ {
4542
+ "name": "instructions",
4543
+ "kind": "flag",
4544
+ "display": "--instructions <text>",
4545
+ "description": "The agent's instructions (up to 64 KiB)",
4546
+ "required": false,
4547
+ },
4548
+ {
4549
+ "name": "modelRouteId",
4550
+ "kind": "flag",
4551
+ "display": "--model-route-id <value>",
4552
+ "description": "Model route the agent runs through (see: w6w model-routes list)",
4553
+ "required": false,
4554
+ },
4555
+ {
4556
+ "name": "skills",
4557
+ "kind": "flag",
4558
+ "display": "--skills <json>",
4559
+ "description": 'Pinned skill versions, as a JSON array of {"skillId":"…","skillVersionId":"…"}',
4560
+ "required": false,
4561
+ },
4562
+ {
4563
+ "name": "context",
4564
+ "kind": "flag",
4565
+ "display": "--context <json>",
4566
+ "description": 'Pinned context versions, as a JSON array of {"collectionId":"…","entryId":"…","assetVersionId":"…"}',
4567
+ "required": false,
4568
+ },
4569
+ {
4570
+ "name": "visibility",
4571
+ "kind": "flag",
4572
+ "display": "--visibility <value>",
4573
+ "description": "Who can see the agent: private | project | account",
4574
+ "required": false,
4575
+ },
4576
+ {
4577
+ "name": "project",
4578
+ "kind": "flag",
4579
+ "display": "--project <id>",
4580
+ "description": "Project to scope to (default: the account's default project)",
4581
+ "required": false,
4582
+ },
4583
+ {
4584
+ "name": "temperature",
4585
+ "kind": "flag",
4586
+ "display": "--temperature <n>",
4587
+ "description": "Sampling temperature, 0 to 2",
4588
+ "required": false,
4589
+ },
4590
+ {
4591
+ "name": "topP",
4592
+ "kind": "flag",
4593
+ "display": "--top-p <n>",
4594
+ "description": "Nucleus sampling, 0 to 1",
4595
+ "required": false,
4596
+ },
4597
+ {
4598
+ "name": "maxOutputTokens",
4599
+ "kind": "flag",
4600
+ "display": "--max-output-tokens <n>",
4601
+ "description": "Cap on generated tokens (integer, 1 to 1000000)",
4602
+ "required": false,
4603
+ },
4604
+ {
4605
+ "name": "stop",
4606
+ "kind": "flag",
4607
+ "display": "--stop <text>",
4608
+ "description": "Stop sequence; repeat the flag for more (at most 4)",
4609
+ "required": false,
4610
+ },
4611
+ {
4612
+ "name": "json",
4613
+ "kind": "flag",
4614
+ "display": "--json",
4615
+ "description": "Output raw JSON instead of a table",
4616
+ "required": false,
4617
+ },
4618
+ ],
4619
+ "examples": [
4620
+ 'w6w agents create --name triage --instructions "Route support mail" --model-route-id mr_01HQ8N',
4621
+ 'w6w agents create --name triage --temperature 0.2 --stop END --stop "###"',
4622
+ ],
4623
+ "notes": [],
4624
+ },
4625
+ {
4626
+ "operation": "agents.get",
4627
+ "path": [
4628
+ "agents",
4629
+ "get",
4630
+ ],
4631
+ "name": "get",
4632
+ "aliases": [],
4633
+ "summary": "Fetch one agent draft.",
4634
+ "short": "Fetch one agent draft",
4635
+ "headline": "fetch one agent draft",
4636
+ "usage": "w6w agents get <id> [options]",
4637
+ "naming": "w6w agents get <id>",
4638
+ "status": "required",
4639
+ "params": [
4640
+ {
4641
+ "name": "id",
4642
+ "kind": "argument",
4643
+ "display": "<id>",
4644
+ "description": "Agent id (see: w6w agents list)",
4645
+ "required": true,
4646
+ },
4647
+ {
4648
+ "name": "json",
4649
+ "kind": "flag",
4650
+ "display": "--json",
4651
+ "description": "Output raw JSON instead of a table",
4652
+ "required": false,
4653
+ },
4654
+ ],
4655
+ "examples": [
4656
+ "w6w agents get ag_01HQ8N",
4657
+ ],
4658
+ "notes": [],
4659
+ },
4660
+ {
4661
+ "operation": "agents.update",
4662
+ "path": [
4663
+ "agents",
4664
+ "update",
4665
+ ],
4666
+ "name": "update",
4667
+ "aliases": [],
4668
+ "summary": "Patch an agent draft.",
4669
+ "short": "Patch an agent draft",
4670
+ "headline": "patch an agent draft",
4671
+ "usage": "w6w agents update <id> --revision <n> [options]",
4672
+ "naming": "w6w agents update <id> --revision <n> [--name <n>] [--instructions <text>] [--model-route-id <id>] [--skills <json>] [--context <json>] [--visibility private|project|account] [--project <id>] [--if-unmodified-since <ts>] [--temperature <n>] [--top-p <n>] [--max-output-tokens <n>] [--stop <text>]...",
4673
+ "status": "required",
4674
+ "params": [
4675
+ {
4676
+ "name": "id",
4677
+ "kind": "argument",
4678
+ "display": "<id>",
4679
+ "description": "Agent id (see: w6w agents list)",
4680
+ "required": true,
4681
+ },
4682
+ {
4683
+ "name": "name",
4684
+ "kind": "flag",
4685
+ "display": "--name <n>",
4686
+ "description": "Display name",
4687
+ "required": false,
4688
+ },
4689
+ {
4690
+ "name": "instructions",
4691
+ "kind": "flag",
4692
+ "display": "--instructions <text>",
4693
+ "description": "The agent's instructions (up to 64 KiB)",
4694
+ "required": false,
4695
+ },
4696
+ {
4697
+ "name": "modelRouteId",
4698
+ "kind": "flag",
4699
+ "display": "--model-route-id <value>",
4700
+ "description": "Model route the agent runs through (see: w6w model-routes list)",
4701
+ "required": false,
4702
+ },
4703
+ {
4704
+ "name": "skills",
4705
+ "kind": "flag",
4706
+ "display": "--skills <json>",
4707
+ "description": 'Pinned skill versions, as a JSON array of {"skillId":"…","skillVersionId":"…"}',
4708
+ "required": false,
4709
+ },
4710
+ {
4711
+ "name": "context",
4712
+ "kind": "flag",
4713
+ "display": "--context <json>",
4714
+ "description": 'Pinned context versions, as a JSON array of {"collectionId":"…","entryId":"…","assetVersionId":"…"}',
4715
+ "required": false,
4716
+ },
4717
+ {
4718
+ "name": "visibility",
4719
+ "kind": "flag",
4720
+ "display": "--visibility <value>",
4721
+ "description": "Who can see the agent: private | project | account",
4722
+ "required": false,
4723
+ },
4724
+ {
4725
+ "name": "project",
4726
+ "kind": "flag",
4727
+ "display": "--project <id>",
4728
+ "description": "Project to scope to (default: the account's default project)",
4729
+ "required": false,
4730
+ },
4731
+ {
4732
+ "name": "revision",
4733
+ "kind": "flag",
4734
+ "display": "--revision <n>",
4735
+ "description": "The revision you last read (from the entry/agent you are editing); a stale one is refused with a conflict",
4736
+ "required": true,
4737
+ },
4738
+ {
4739
+ "name": "ifUnmodifiedSince",
4740
+ "kind": "flag",
4741
+ "display": "--if-unmodified-since <value>",
4742
+ "description": "Refuse the write if the agent changed since this updatedAt (see: w6w agents get); the server requires it",
4743
+ "required": false,
4744
+ },
4745
+ {
4746
+ "name": "temperature",
4747
+ "kind": "flag",
4748
+ "display": "--temperature <n>",
4749
+ "description": "Sampling temperature, 0 to 2",
4750
+ "required": false,
4751
+ },
4752
+ {
4753
+ "name": "topP",
4754
+ "kind": "flag",
4755
+ "display": "--top-p <n>",
4756
+ "description": "Nucleus sampling, 0 to 1",
4757
+ "required": false,
4758
+ },
4759
+ {
4760
+ "name": "maxOutputTokens",
4761
+ "kind": "flag",
4762
+ "display": "--max-output-tokens <n>",
4763
+ "description": "Cap on generated tokens (integer, 1 to 1000000)",
4764
+ "required": false,
4765
+ },
4766
+ {
4767
+ "name": "stop",
4768
+ "kind": "flag",
4769
+ "display": "--stop <text>",
4770
+ "description": "Stop sequence; repeat the flag for more (at most 4)",
4771
+ "required": false,
4772
+ },
4773
+ {
4774
+ "name": "json",
4775
+ "kind": "flag",
4776
+ "display": "--json",
4777
+ "description": "Output raw JSON instead of a table",
4778
+ "required": false,
4779
+ },
4780
+ ],
4781
+ "examples": [
4782
+ 'w6w agents update ag_01HQ8N --revision 3 --instructions "Be brief" --if-unmodified-since 2026-10-24T09:00:00.000Z',
4783
+ ],
4784
+ "notes": [],
4785
+ },
4786
+ {
4787
+ "operation": "agents.archive",
4788
+ "path": [
4789
+ "agents",
4790
+ "archive",
4791
+ ],
4792
+ "name": "archive",
4793
+ "aliases": [],
4794
+ "summary": "Archive an agent draft.",
4795
+ "short": "Archive an agent draft",
4796
+ "headline": "archive an agent draft",
4797
+ "usage": "w6w agents archive <id> [options]",
4798
+ "naming": "w6w agents archive <id>",
4799
+ "status": "required",
4800
+ "params": [
4801
+ {
4802
+ "name": "id",
4803
+ "kind": "argument",
4804
+ "display": "<id>",
4805
+ "description": "Agent id (see: w6w agents list)",
4806
+ "required": true,
4807
+ },
4808
+ {
4809
+ "name": "json",
4810
+ "kind": "flag",
4811
+ "display": "--json",
4812
+ "description": "Output raw JSON instead of a table",
4813
+ "required": false,
4814
+ },
4815
+ ],
4816
+ "examples": [
4817
+ "w6w agents archive ag_01HQ8N",
4818
+ ],
4819
+ "notes": [],
4820
+ },
4821
+ ],
4822
+ "options": [],
4823
+ "examples": [
4824
+ "w6w agents list",
4825
+ "w6w agents get ag_01HQ8N",
4826
+ ],
4827
+ },
4828
+ {
4829
+ "name": "auth",
4830
+ "summary": "Save, remove and inspect the stored API token",
4831
+ "headline": "save, remove and inspect the stored API token",
4832
+ "usage": "w6w auth <command> [options]",
4833
+ "commands": [
4834
+ {
4835
+ "operation": "auth.login",
4836
+ "path": [
4837
+ "auth",
4838
+ "login",
4839
+ ],
4840
+ "name": "login",
4841
+ "aliases": [],
4842
+ "summary": "Save an API token for a base URL so later commands authenticate from it.",
4843
+ "short": "Save an API token for a base URL so later commands authenticate from it",
4844
+ "headline": "save an API token for a base URL so later commands authenticate from it",
4845
+ "usage": "w6w auth login [<token>] [options]",
4846
+ "naming": "w6w auth login [<token>]",
4847
+ "status": "live",
4848
+ "params": [
4849
+ {
4850
+ "name": "token",
4851
+ "kind": "argument",
4852
+ "display": "<token>",
4853
+ "description": "The API token to save, or `-` to read it from standard input (default when input is piped)",
4854
+ "required": false,
4855
+ },
4856
+ {
4857
+ "name": "json",
4858
+ "kind": "flag",
4859
+ "display": "--json",
4860
+ "description": "Output raw JSON instead of a table",
4861
+ "required": false,
4862
+ },
4863
+ ],
4864
+ "examples": [
4865
+ "printf '%s' \"$W6W_TOKEN\" | w6w auth login -",
4866
+ "w6w auth login <token>",
4867
+ "w6w auth login - --base-url https://w6w.example.com",
4868
+ ],
4869
+ "notes": [],
4870
+ },
4871
+ {
4872
+ "operation": "auth.logout",
4873
+ "path": [
4874
+ "auth",
4875
+ "logout",
4876
+ ],
4877
+ "name": "logout",
4878
+ "aliases": [],
4879
+ "summary": "Remove the stored API token for a base URL.",
4880
+ "short": "Remove the stored API token for a base URL",
4881
+ "headline": "remove the stored API token for a base URL",
4882
+ "usage": "w6w auth logout [options]",
4883
+ "naming": "w6w auth logout",
4884
+ "status": "live",
4885
+ "params": [
4886
+ {
4887
+ "name": "json",
4888
+ "kind": "flag",
4889
+ "display": "--json",
4890
+ "description": "Output raw JSON instead of a table",
4891
+ "required": false,
4892
+ },
4893
+ ],
4894
+ "examples": [
4895
+ "w6w auth logout",
4896
+ "w6w auth logout --base-url https://w6w.example.com",
4897
+ ],
4898
+ "notes": [],
4899
+ },
4900
+ {
4901
+ "operation": "auth.status",
4902
+ "path": [
4903
+ "auth",
4904
+ "status",
4905
+ ],
4906
+ "name": "status",
4907
+ "aliases": [],
4908
+ "summary": "Show the resolved base URL, where it came from, and whether a token is available.",
4909
+ "short": "Show the resolved base URL, where it came from, and whether a token is available",
4910
+ "headline": "show the resolved base URL, where it came from, and whether a token is available",
4911
+ "usage": "w6w auth status [options]",
4912
+ "naming": "w6w auth status",
4913
+ "status": "live",
4914
+ "params": [
4915
+ {
4916
+ "name": "json",
4917
+ "kind": "flag",
4918
+ "display": "--json",
4919
+ "description": "Output raw JSON instead of a table",
4920
+ "required": false,
4921
+ },
4922
+ ],
4923
+ "examples": [
4924
+ "w6w auth status",
4925
+ "w6w auth status --json",
4926
+ ],
4927
+ "notes": [],
4928
+ },
4929
+ ],
4930
+ "options": [],
4931
+ "examples": [
4932
+ "w6w auth status",
2695
4933
  "printf '%s' \"$W6W_TOKEN\" | w6w auth login -",
2696
4934
  ],
2697
4935
  },
4936
+ {
4937
+ "name": "config",
4938
+ "summary": "Show and set the API base URL",
4939
+ "headline": "show and set the API base URL",
4940
+ "usage": "w6w config <command> [options]",
4941
+ "commands": [
4942
+ {
4943
+ "operation": "config.get-base-url",
4944
+ "path": [
4945
+ "config",
4946
+ "get-base-url",
4947
+ ],
4948
+ "name": "get-base-url",
4949
+ "aliases": [],
4950
+ "summary": "Show the effective API base URL and where it came from.",
4951
+ "short": "Show the effective API base URL and where it came from",
4952
+ "headline": "show the effective API base URL and where it came from",
4953
+ "usage": "w6w config get-base-url [options]",
4954
+ "naming": "w6w config get-base-url",
4955
+ "status": "live",
4956
+ "params": [
4957
+ {
4958
+ "name": "json",
4959
+ "kind": "flag",
4960
+ "display": "--json",
4961
+ "description": "Output raw JSON instead of a table",
4962
+ "required": false,
4963
+ },
4964
+ ],
4965
+ "examples": [
4966
+ "w6w config get-base-url",
4967
+ "w6w config get-base-url --json",
4968
+ ],
4969
+ "notes": [],
4970
+ },
4971
+ {
4972
+ "operation": "config.set-base-url",
4973
+ "path": [
4974
+ "config",
4975
+ "set-base-url",
4976
+ ],
4977
+ "name": "set-base-url",
4978
+ "aliases": [],
4979
+ "summary": "Save the API base URL used when no flag or environment variable overrides it.",
4980
+ "short": "Save the API base URL used when no flag or environment variable overrides it",
4981
+ "headline": "save the API base URL used when no flag or environment variable overrides it",
4982
+ "usage": "w6w config set-base-url <url> [options]",
4983
+ "naming": "w6w config set-base-url <url>",
4984
+ "status": "live",
4985
+ "params": [
4986
+ {
4987
+ "name": "url",
4988
+ "kind": "argument",
4989
+ "display": "<url>",
4990
+ "description": "The API origin to save, like https://api.example.com (a trailing slash is dropped)",
4991
+ "required": true,
4992
+ },
4993
+ {
4994
+ "name": "json",
4995
+ "kind": "flag",
4996
+ "display": "--json",
4997
+ "description": "Output raw JSON instead of a table",
4998
+ "required": false,
4999
+ },
5000
+ ],
5001
+ "examples": [
5002
+ "w6w config set-base-url https://w6w.example.com",
5003
+ "w6w config set-base-url https://api.w6w.io",
5004
+ ],
5005
+ "notes": [],
5006
+ },
5007
+ ],
5008
+ "options": [],
5009
+ "examples": [
5010
+ "w6w config get-base-url",
5011
+ "w6w config set-base-url https://w6w.example.com",
5012
+ ],
5013
+ },
2698
5014
  ],
2699
5015
  "globalFlags": [
2700
5016
  {
@@ -2766,6 +5082,12 @@ export const COMMAND_PATHS = [
2766
5082
  [
2767
5083
  "run",
2768
5084
  ],
5085
+ [
5086
+ "model-usage",
5087
+ ],
5088
+ [
5089
+ "ls",
5090
+ ],
2769
5091
  [
2770
5092
  "connections",
2771
5093
  "list",
@@ -2990,6 +5312,174 @@ export const COMMAND_PATHS = [
2990
5312
  "reliability",
2991
5313
  "members",
2992
5314
  ],
5315
+ [
5316
+ "models",
5317
+ "list",
5318
+ ],
5319
+ [
5320
+ "models",
5321
+ "get",
5322
+ ],
5323
+ [
5324
+ "model-routes",
5325
+ "list",
5326
+ ],
5327
+ [
5328
+ "model-routes",
5329
+ "get",
5330
+ ],
5331
+ [
5332
+ "model-routes",
5333
+ "complete",
5334
+ ],
5335
+ [
5336
+ "assets",
5337
+ "upload-create",
5338
+ ],
5339
+ [
5340
+ "assets",
5341
+ "upload-put",
5342
+ ],
5343
+ [
5344
+ "assets",
5345
+ "upload-finalize",
5346
+ ],
5347
+ [
5348
+ "assets",
5349
+ "upload-status",
5350
+ ],
5351
+ [
5352
+ "assets",
5353
+ "upload-abort",
5354
+ ],
5355
+ [
5356
+ "assets",
5357
+ "get",
5358
+ ],
5359
+ [
5360
+ "assets",
5361
+ "versions",
5362
+ ],
5363
+ [
5364
+ "assets",
5365
+ "files",
5366
+ ],
5367
+ [
5368
+ "assets",
5369
+ "content",
5370
+ ],
5371
+ [
5372
+ "assets",
5373
+ "archive-download",
5374
+ ],
5375
+ [
5376
+ "assets",
5377
+ "archive",
5378
+ ],
5379
+ [
5380
+ "assets",
5381
+ "purge",
5382
+ ],
5383
+ [
5384
+ "assets",
5385
+ "upload",
5386
+ ],
5387
+ [
5388
+ "skills",
5389
+ "list",
5390
+ ],
5391
+ [
5392
+ "skills",
5393
+ "get",
5394
+ ],
5395
+ [
5396
+ "skills",
5397
+ "versions",
5398
+ ],
5399
+ [
5400
+ "skills",
5401
+ "archive",
5402
+ ],
5403
+ [
5404
+ "context",
5405
+ "list",
5406
+ ],
5407
+ [
5408
+ "context",
5409
+ "create",
5410
+ ],
5411
+ [
5412
+ "context",
5413
+ "get",
5414
+ ],
5415
+ [
5416
+ "context",
5417
+ "update",
5418
+ ],
5419
+ [
5420
+ "context",
5421
+ "archive",
5422
+ ],
5423
+ [
5424
+ "context",
5425
+ "entries-list",
5426
+ ],
5427
+ [
5428
+ "context",
5429
+ "entries-create",
5430
+ ],
5431
+ [
5432
+ "context",
5433
+ "entries-update",
5434
+ ],
5435
+ [
5436
+ "context-entries",
5437
+ "list",
5438
+ ],
5439
+ [
5440
+ "context-entries",
5441
+ "create",
5442
+ ],
5443
+ [
5444
+ "context-entries",
5445
+ "get",
5446
+ ],
5447
+ [
5448
+ "context-entries",
5449
+ "update",
5450
+ ],
5451
+ [
5452
+ "context-entries",
5453
+ "archive",
5454
+ ],
5455
+ [
5456
+ "context-entries",
5457
+ "add-to-collection",
5458
+ ],
5459
+ [
5460
+ "context-entries",
5461
+ "remove-from-collection",
5462
+ ],
5463
+ [
5464
+ "agents",
5465
+ "list",
5466
+ ],
5467
+ [
5468
+ "agents",
5469
+ "create",
5470
+ ],
5471
+ [
5472
+ "agents",
5473
+ "get",
5474
+ ],
5475
+ [
5476
+ "agents",
5477
+ "update",
5478
+ ],
5479
+ [
5480
+ "agents",
5481
+ "archive",
5482
+ ],
2993
5483
  [
2994
5484
  "auth",
2995
5485
  "login",
@@ -3002,6 +5492,14 @@ export const COMMAND_PATHS = [
3002
5492
  "auth",
3003
5493
  "status",
3004
5494
  ],
5495
+ [
5496
+ "config",
5497
+ "get-base-url",
5498
+ ],
5499
+ [
5500
+ "config",
5501
+ "set-base-url",
5502
+ ],
3005
5503
  ];
3006
5504
  /** The exit-code contract, verbatim from the shared contract's `cli.exitCodes`. */
3007
5505
  export const EXIT_CODES = [