@wowok/agent-mcp 2.5.0 → 2.5.1

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 (13) hide show
  1. package/dist/schema/project/index.d.ts +20 -0
  2. package/dist/schema/project/index.js +15 -1
  3. package/dist/schemas/index.json +1 -1
  4. package/dist/schemas/onchain_operations.schema.json +0 -16
  5. package/dist/schemas/onchain_operations_guard.schema.json +0 -515
  6. package/dist/schemas/onchain_operations_payment.schema.json +0 -515
  7. package/dist/schemas/onchain_operations_permission.schema.json +0 -515
  8. package/dist/schemas/onchain_operations_personal.schema.json +0 -515
  9. package/dist/schemas/project_operation.output.json +39 -0
  10. package/dist/schemas/project_operation.schema.json +1 -1
  11. package/dist/tools/handlers/project.js +4 -0
  12. package/dist/tools/index.js +41 -17
  13. package/package.json +1 -1
package/dist/schemas/onchain_operations_personal.schema.json CHANGED
@@ -15,10 +15,6 @@
15
15
  "env": {
16
16
  "$ref": "#/definitions/env",
17
17
  "$schema": "http://json-schema.org/draft-07/schema#"
18
- },
19
- "submission": {
20
- "$ref": "#/definitions/submission",
21
- "$schema": "http://json-schema.org/draft-07/schema#"
22
18
  }
23
19
  },
24
20
  "required": [
@@ -793,517 +789,6 @@
793
789
  },
794
790
  "additionalProperties": false,
795
791
  "description": "IMPORTANT: Execution environment includes: account for signing operations, network selection ([object Object]), additional Guard permissions, and more. Used to specify context information during the call. If account is not specified, the default account (\"\") will be used."
796
- },
797
- "submission": {
798
- "type": "object",
799
- "properties": {
800
- "type": {
801
- "type": "string",
802
- "const": "submission",
803
- "description": "Discriminator for this result variant. Constraint: always 'submission'. Example: 'submission'"
804
- },
805
- "guard": {
806
- "type": "array",
807
- "items": {
808
- "type": "object",
809
- "properties": {
810
- "object": {
811
- "type": "string",
812
- "description": "Guard object name or ID to verify against. Example: 'my-delivery-guard' or '0x123...'"
813
- },
814
- "impack": {
815
- "type": "boolean",
816
- "description": "Whether this Guard's verification result participates in the final logic. Constraint: if false, the Guard is checked but does not block the operation. Example: true"
817
- }
818
- },
819
- "required": [
820
- "object",
821
- "impack"
822
- ],
823
- "additionalProperties": false
824
- },
825
- "maxItems": 20,
826
- "description": "Array of Guard objects to verify. Constraint: at most 20 entries (MAX_GUARD_COUNT_PASSPORT). Relation: each entry corresponds to a Guard bound to the operation."
827
- },
828
- "submission": {
829
- "type": "array",
830
- "items": {
831
- "type": "object",
832
- "properties": {
833
- "guard": {
834
- "$ref": "#/definitions/submission/properties/guard/items/properties/object",
835
- "description": "Guard object name or ID that requires submission data. Example: 'my-delivery-guard'"
836
- },
837
- "submission": {
838
- "type": "array",
839
- "items": {
840
- "type": "object",
841
- "properties": {
842
- "identifier": {
843
- "type": "integer",
844
- "minimum": 0,
845
- "maximum": 255,
846
- "description": "Identifier (0-255) for data lookup in Guard table."
847
- },
848
- "b_submission": {
849
- "type": "boolean",
850
- "description": "Whether user submission is required for this data"
851
- },
852
- "value_type": {
853
- "anyOf": [
854
- {
855
- "type": "number",
856
- "const": 0,
857
- "description": "Bool (0)"
858
- },
859
- {
860
- "type": "number",
861
- "const": 1,
862
- "description": "Address (1)"
863
- },
864
- {
865
- "type": "number",
866
- "const": 2,
867
- "description": "String (2)"
868
- },
869
- {
870
- "type": "number",
871
- "const": 3,
872
- "description": "U8 (3)"
873
- },
874
- {
875
- "type": "number",
876
- "const": 4,
877
- "description": "U16 (4)"
878
- },
879
- {
880
- "type": "number",
881
- "const": 5,
882
- "description": "U32 (5)"
883
- },
884
- {
885
- "type": "number",
886
- "const": 6,
887
- "description": "U64 (6)"
888
- },
889
- {
890
- "type": "number",
891
- "const": 7,
892
- "description": "U128 (7)"
893
- },
894
- {
895
- "type": "number",
896
- "const": 8,
897
- "description": "U256 (8)"
898
- },
899
- {
900
- "type": "number",
901
- "const": 9,
902
- "description": "VecBool (9)"
903
- },
904
- {
905
- "type": "number",
906
- "const": 10,
907
- "description": "VecAddress (10)"
908
- },
909
- {
910
- "type": "number",
911
- "const": 11,
912
- "description": "VecString (11)"
913
- },
914
- {
915
- "type": "number",
916
- "const": 12,
917
- "description": "VecU8 (12)"
918
- },
919
- {
920
- "type": "number",
921
- "const": 13,
922
- "description": "VecU16 (13)"
923
- },
924
- {
925
- "type": "number",
926
- "const": 14,
927
- "description": "VecU32 (14)"
928
- },
929
- {
930
- "type": "number",
931
- "const": 15,
932
- "description": "VecU64 (15)"
933
- },
934
- {
935
- "type": "number",
936
- "const": 16,
937
- "description": "VecU128 (16)"
938
- },
939
- {
940
- "type": "number",
941
- "const": 17,
942
- "description": "VecU256 (17)"
943
- },
944
- {
945
- "type": "number",
946
- "const": 18,
947
- "description": "VecVecU8 (18)"
948
- },
949
- {
950
- "type": "string",
951
- "const": "Bool",
952
- "description": "Bool"
953
- },
954
- {
955
- "type": "string",
956
- "const": "Address",
957
- "description": "Address"
958
- },
959
- {
960
- "type": "string",
961
- "const": "String",
962
- "description": "String"
963
- },
964
- {
965
- "type": "string",
966
- "const": "U8",
967
- "description": "U8"
968
- },
969
- {
970
- "type": "string",
971
- "const": "U16",
972
- "description": "U16"
973
- },
974
- {
975
- "type": "string",
976
- "const": "U32",
977
- "description": "U32"
978
- },
979
- {
980
- "type": "string",
981
- "const": "U64",
982
- "description": "U64"
983
- },
984
- {
985
- "type": "string",
986
- "const": "U128",
987
- "description": "U128"
988
- },
989
- {
990
- "type": "string",
991
- "const": "U256",
992
- "description": "U256"
993
- },
994
- {
995
- "type": "string",
996
- "const": "VecBool",
997
- "description": "VecBool"
998
- },
999
- {
1000
- "type": "string",
1001
- "const": "VecAddress",
1002
- "description": "VecAddress"
1003
- },
1004
- {
1005
- "type": "string",
1006
- "const": "VecString",
1007
- "description": "VecString"
1008
- },
1009
- {
1010
- "type": "string",
1011
- "const": "VecU8",
1012
- "description": "VecU8"
1013
- },
1014
- {
1015
- "type": "string",
1016
- "const": "VecU16",
1017
- "description": "VecU16"
1018
- },
1019
- {
1020
- "type": "string",
1021
- "const": "VecU32",
1022
- "description": "VecU32"
1023
- },
1024
- {
1025
- "type": "string",
1026
- "const": "VecU64",
1027
- "description": "VecU64"
1028
- },
1029
- {
1030
- "type": "string",
1031
- "const": "VecU128",
1032
- "description": "VecU128"
1033
- },
1034
- {
1035
- "type": "string",
1036
- "const": "VecU256",
1037
- "description": "VecU256"
1038
- },
1039
- {
1040
- "type": "string",
1041
- "const": "VecVecU8",
1042
- "description": "VecVecU8"
1043
- },
1044
- {
1045
- "type": "string",
1046
- "const": "bool",
1047
- "description": "bool"
1048
- },
1049
- {
1050
- "type": "string",
1051
- "const": "address",
1052
- "description": "address"
1053
- },
1054
- {
1055
- "type": "string",
1056
- "const": "string",
1057
- "description": "string"
1058
- },
1059
- {
1060
- "type": "string",
1061
- "const": "u8",
1062
- "description": "u8"
1063
- },
1064
- {
1065
- "type": "string",
1066
- "const": "u16",
1067
- "description": "u16"
1068
- },
1069
- {
1070
- "type": "string",
1071
- "const": "u32",
1072
- "description": "u32"
1073
- },
1074
- {
1075
- "type": "string",
1076
- "const": "u64",
1077
- "description": "u64"
1078
- },
1079
- {
1080
- "type": "string",
1081
- "const": "u128",
1082
- "description": "u128"
1083
- },
1084
- {
1085
- "type": "string",
1086
- "const": "u256",
1087
- "description": "u256"
1088
- },
1089
- {
1090
- "type": "string",
1091
- "const": "vecbool",
1092
- "description": "vecbool"
1093
- },
1094
- {
1095
- "type": "string",
1096
- "const": "vecaddress",
1097
- "description": "vecaddress"
1098
- },
1099
- {
1100
- "type": "string",
1101
- "const": "vecstring",
1102
- "description": "vecstring"
1103
- },
1104
- {
1105
- "type": "string",
1106
- "const": "vecu8",
1107
- "description": "vecu8"
1108
- },
1109
- {
1110
- "type": "string",
1111
- "const": "vecu16",
1112
- "description": "vecu16"
1113
- },
1114
- {
1115
- "type": "string",
1116
- "const": "vecu32",
1117
- "description": "vecu32"
1118
- },
1119
- {
1120
- "type": "string",
1121
- "const": "vecu64",
1122
- "description": "vecu64"
1123
- },
1124
- {
1125
- "type": "string",
1126
- "const": "vecu128",
1127
- "description": "vecu128"
1128
- },
1129
- {
1130
- "type": "string",
1131
- "const": "vecu256",
1132
- "description": "vecu256"
1133
- },
1134
- {
1135
- "type": "string",
1136
- "const": "vecvecu8",
1137
- "description": "vecvecu8"
1138
- }
1139
- ],
1140
- "description": "Type of the value"
1141
- },
1142
- "value": {
1143
- "anyOf": [
1144
- {
1145
- "type": "boolean"
1146
- },
1147
- {
1148
- "anyOf": [
1149
- {
1150
- "type": "object",
1151
- "properties": {
1152
- "name_or_address": {
1153
- "$ref": "#/definitions/submission/properties/guard/items/properties/object",
1154
- "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
1155
- },
1156
- "local_mark_first": {
1157
- "type": "boolean",
1158
- "description": "Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks"
1159
- }
1160
- },
1161
- "additionalProperties": false,
1162
- "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account."
1163
- },
1164
- {
1165
- "type": "string"
1166
- }
1167
- ]
1168
- },
1169
- {
1170
- "type": "string"
1171
- },
1172
- {
1173
- "type": "number"
1174
- },
1175
- {
1176
- "type": "array",
1177
- "items": {
1178
- "type": "boolean"
1179
- }
1180
- },
1181
- {
1182
- "anyOf": [
1183
- {
1184
- "type": "object",
1185
- "properties": {
1186
- "entities": {
1187
- "type": "array",
1188
- "items": {
1189
- "$ref": "#/definitions/submission/properties/submission/items/properties/submission/items/properties/value/anyOf/1/anyOf/0"
1190
- }
1191
- },
1192
- "check_all_founded": {
1193
- "type": "boolean",
1194
- "description": "Whether to check all entities are found, if true, all entities must be found (abort and throw exception if any ID not found); if false, only return found IDs"
1195
- }
1196
- },
1197
- "required": [
1198
- "entities"
1199
- ],
1200
- "additionalProperties": false,
1201
- "description": "Used to batch find account or object IDs by name"
1202
- },
1203
- {
1204
- "type": "array",
1205
- "items": {
1206
- "type": "string"
1207
- }
1208
- }
1209
- ]
1210
- },
1211
- {
1212
- "type": "array",
1213
- "items": {
1214
- "type": "string"
1215
- }
1216
- },
1217
- {
1218
- "type": "array",
1219
- "items": {
1220
- "type": "number"
1221
- }
1222
- },
1223
- {
1224
- "type": "array",
1225
- "items": {
1226
- "type": "array",
1227
- "items": {
1228
- "type": "number"
1229
- }
1230
- }
1231
- }
1232
- ],
1233
- "description": "The actual value data"
1234
- },
1235
- "name": {
1236
- "type": "string",
1237
- "default": "",
1238
- "description": "Name or description of this data"
1239
- },
1240
- "object_type": {
1241
- "type": "string",
1242
- "enum": [
1243
- "Permission",
1244
- "Repository",
1245
- "Arb",
1246
- "Arbitration",
1247
- "Service",
1248
- "Machine",
1249
- "Order",
1250
- "Progress",
1251
- "Payment",
1252
- "Treasury",
1253
- "Guard",
1254
- "Demand",
1255
- "Passport",
1256
- "Allocation",
1257
- "Resource",
1258
- "Reward",
1259
- "Discount",
1260
- "EntityRegistrar",
1261
- "EntityLinker",
1262
- "Proof",
1263
- "WReceivedObject",
1264
- "Contact",
1265
- "TableItem_ProgressHistory",
1266
- "TableItem_PermissionPerm",
1267
- "TableItem_DemandPresenter",
1268
- "TableItem_MachineNode",
1269
- "TableItem_TreasuryHistory",
1270
- "TableItem_RepositoryData",
1271
- "TableItem_RewardRecord",
1272
- "TableItem_EntityLinker",
1273
- "TableItem_AddressMark",
1274
- "TableItem_EntityRegistrar"
1275
- ],
1276
- "description": "Object type when value_type is Address and represents a specific object"
1277
- }
1278
- },
1279
- "required": [
1280
- "identifier",
1281
- "b_submission",
1282
- "value_type"
1283
- ],
1284
- "additionalProperties": false,
1285
- "description": "Guard table item"
1286
- },
1287
- "description": "User-submitted data matching the Guard's required fields. Relation: structure must match the Guard table's column definitions. Example: [{field:'delivery_proof', value:'Qm...'}]"
1288
- }
1289
- },
1290
- "required": [
1291
- "guard",
1292
- "submission"
1293
- ],
1294
- "additionalProperties": false,
1295
- "description": "One Guard's submission data: the Guard to verify plus the user-provided data that satisfies its requirements."
1296
- },
1297
- "description": "User-submitted data for each Guard. Relation: one entry per Guard in the guard array; fill submission fields and resubmit via call_with_submission."
1298
- }
1299
- },
1300
- "required": [
1301
- "type",
1302
- "guard",
1303
- "submission"
1304
- ],
1305
- "additionalProperties": false,
1306
- "description": "Guard verification required. The operation was blocked because one or more Guards require user-submitted data. Fill the submission array and resubmit. Semantic status is 'pending_input'."
1307
792
  }
1308
793
  }
1309
794
  }
package/dist/schemas/project_operation.output.json CHANGED
@@ -356,6 +356,14 @@
356
356
  "next_step": {
357
357
  "type": "string"
358
358
  },
359
+ "next_action": {
360
+ "type": "string",
361
+ "enum": [
362
+ "aggregate_risks",
363
+ "none"
364
+ ],
365
+ "description": "Next project_operation action to call. 'aggregate_risks' when puzzles are complete enough; 'none' if user must fill missing fields first."
366
+ },
359
367
  "warnings": {
360
368
  "type": "array",
361
369
  "items": {
@@ -369,6 +377,7 @@
369
377
  "puzzles",
370
378
  "overall_completeness",
371
379
  "next_step",
380
+ "next_action",
372
381
  "warnings"
373
382
  ],
374
383
  "additionalProperties": false
@@ -534,6 +543,15 @@
534
543
  "type": "boolean",
535
544
  "description": "Whether the user can proceed to the next stage. False only when CRITICAL risks exist."
536
545
  },
546
+ "next_action": {
547
+ "type": "string",
548
+ "enum": [
549
+ "generate_deployment_doc",
550
+ "fix_risks",
551
+ "none"
552
+ ],
553
+ "description": "Next project_operation action. 'generate_deployment_doc' when can_proceed=true; 'fix_risks' when CRITICAL risks exist; 'none' for other cases."
554
+ },
537
555
  "user_action_required": {
538
556
  "type": "string",
539
557
  "description": "Human-readable next-step guidance."
@@ -548,6 +566,7 @@
548
566
  "calibrated_at",
549
567
  "warnings",
550
568
  "can_proceed",
569
+ "next_action",
551
570
  "user_action_required"
552
571
  ],
553
572
  "additionalProperties": false
@@ -648,6 +667,15 @@
648
667
  "type": "boolean",
649
668
  "description": "Whether the user can proceed to stage 5. False when D-errors exist."
650
669
  },
670
+ "next_action": {
671
+ "type": "string",
672
+ "enum": [
673
+ "trace_substeps",
674
+ "fix_doc_errors",
675
+ "none"
676
+ ],
677
+ "description": "Next project_operation action. 'trace_substeps' when can_proceed=true; 'fix_doc_errors' when D-errors exist; 'none' for other cases."
678
+ },
651
679
  "user_action_required": {
652
680
  "type": "string"
653
681
  }
@@ -657,6 +685,7 @@
657
685
  "markdown",
658
686
  "meta",
659
687
  "can_proceed",
688
+ "next_action",
660
689
  "user_action_required"
661
690
  ],
662
691
  "additionalProperties": false
@@ -863,6 +892,15 @@
863
892
  "type": "boolean",
864
893
  "description": "Whether deployment can complete. False when D-10 fails or substeps FAILED."
865
894
  },
895
+ "next_action": {
896
+ "type": "string",
897
+ "enum": [
898
+ "deploy",
899
+ "fix_substeps",
900
+ "none"
901
+ ],
902
+ "description": "Next action. 'deploy' when can_proceed=true (execute substeps via onchain_operations); 'fix_substeps' when issues exist; 'none' when done."
903
+ },
866
904
  "user_action_required": {
867
905
  "type": "string"
868
906
  }
@@ -880,6 +918,7 @@
880
918
  "topological_order",
881
919
  "d10_check",
882
920
  "can_proceed",
921
+ "next_action",
883
922
  "user_action_required"
884
923
  ],
885
924
  "additionalProperties": false
package/dist/schemas/project_operation.schema.json CHANGED
@@ -26,7 +26,7 @@
26
26
  "generate_deployment_doc",
27
27
  "trace_substeps"
28
28
  ],
29
- "description": "Query/action to perform"
29
+ "description": "Action to perform. Two categories:\n1. Graph Query (10): list_projects, list_objects, shareable, dependencies, referenced_by, pre_publish_check, cross_project_refs, graph_stats, save_graph, load_graph.\n2. Project-Based Deployment 5-Stage (4): Call IN ORDER — analyze_intent (Stage 2) → aggregate_risks (Stage 3) → generate_deployment_doc (Stage 4) → trace_substeps (Stage 5). Each action's output includes `next_action` telling you which action to call next. Stage 1 (Project Naming) uses the `project` + `version` params."
30
30
  },
31
31
  "project": {
32
32
  "type": "string",
package/dist/tools/handlers/project.js CHANGED
@@ -93,6 +93,7 @@ async function handleAnalyzeIntent(validated) {
93
93
  puzzles: result.puzzles,
94
94
  overall_completeness: result.overall_completeness,
95
95
  next_step: result.next_step,
96
+ next_action: result.overall_completeness === "complete" ? "aggregate_risks" : "none",
96
97
  warnings: result.warnings,
97
98
  evolution_context: evolutionContext,
98
99
  experience_feedback: experienceFeedback,
@@ -121,6 +122,7 @@ async function handleAggregateRisks(validated) {
121
122
  calibrated_at: result.calibrated_at,
122
123
  warnings: result.warnings,
123
124
  can_proceed: !hasCritical,
125
+ next_action: hasCritical ? "fix_risks" : "generate_deployment_doc",
124
126
  user_action_required: hasCritical
125
127
  ? `Fix ${result.severity_summary.CRITICAL} CRITICAL risk(s) before proceeding`
126
128
  : unconfirmedHigh > 0
@@ -175,6 +177,7 @@ async function handleGenerateDeploymentDoc(validated) {
175
177
  },
176
178
  validation: validationResult,
177
179
  can_proceed: errorCount === 0,
180
+ next_action: errorCount === 0 ? "trace_substeps" : "fix_doc_errors",
178
181
  user_action_required: errorCount > 0
179
182
  ? `Fix ${errorCount} D-error(s) before deploying`
180
183
  : warningCount > 0
@@ -223,6 +226,7 @@ async function handleTraceSubsteps(validated) {
223
226
  topological_order: result.topological_order,
224
227
  d10_check: result.d10_check,
225
228
  can_proceed: canProceed,
229
+ next_action: canProceed ? "deploy" : "fix_substeps",
226
230
  user_action_required: issueParts.length > 0
227
231
  ? `Fix: ${issueParts.join(", ")}`
228
232
  : "All substeps passed. Deployment complete.",