@wowok/agent-mcp 2.3.13 → 2.3.16

package/dist/schema/query/index.js

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { TokenTypeInfoSchema, QueryLocalMarkListResultSchema, QueryAccountListResultSchema, QueryLocalInfoListResultSchema, QueryLocalTokenListResultSchema, QueryAccountResultSchema } from "../local/index.js";
 import { AccountOrMark_AddressSchema, BalanceTypeSchema, CacheExpireTypeSchema, EntrypointSchema, GuardIdentifierSchema, GuardTableItemSchema, NameOrAddressSchema, ObjectBaseSchema, ObjectTypeSchema, QueryIdSchema, SupportedValueSchema, ValueTypeSchema, QueryReceivedResultSchema, LongNameSchema, DescriptionSchema } from "../common/index.js";
+const SemanticSummarySchema = z.any();
 import { isValidPermissionIndex } from '../utils/permission-index-utils.js';
 import { isValidGuardQueryId, isValidGuardQueryIdOrName } from '../utils/guard-query-utils.js';
 import { ENTITY_LINKER_ADDRESS, ENTITY_REGISTRAR_ADDRESS, isWitnessType, } from "@wowok/wowok";
@@ -8,6 +9,9 @@ import { DiscountType as WDiscountType } from "@wowok/wowok";
 import { QueryEnvSchema } from "../common/index.js";
 const MAX_MULTI_OPERANDS = 8;
 const VALUE_TYPE_DESCRIPTION = "Value type: can be specified as a string name (e.g., 'U64', 'Address', 'String') or a number (0-18). Supported types: Bool=0/'Bool', Address=1/'Address', String=2/'String', U8=3/'U8', U16=4/'U16', U32=5/'U32', U64=6/'U64', U128=7/'U128', U256=8/'U256', VecBool=9/'VecBool', VecAddress=10/'VecAddress', VecString=11/'VecString', VecU8=12/'VecU8', VecU16=13/'VecU16', VecU32=14/'VecU32', VecU64=15/'VecU64', VecU128=16/'VecU128', VecU256=17/'VecU256', VecVecU8=18/'VecVecU8'. Note: Value=19 is an INTERNAL type for wowok system use only and should NOT be used directly by users. String format is recommended for better readability.";
+const tolerantNumber = z.union([z.number(), z.string()]);
+const tolerantStringNullable = z.union([z.string(), z.null(), z.undefined()]);
+const tolerantNumberNullable = z.union([z.number(), z.string(), z.null(), z.undefined()]);
 export const AmountTypeSchema = z.enum(["GuardU64Identifier", "Fixed"]).describe("Amount type. GuardU64Identifier indicates the amount comes from U64 type data defined in Guard table (Identifier index), Fixed indicates using a fixed amount.");
 export const GuardQuerySchema = z.object({
     id: QueryIdSchema,
@@ -43,7 +47,7 @@ export const VoteInEntityLinkerSchema = z.object({
     like: z.boolean().optional().describe("Whether liked"),
     dislike: z.boolean().optional().describe("Whether disliked"),
     affiliation: z.boolean().optional().describe("Whether affiliated"),
-    time: z.number().describe("Time"),
+    time: tolerantNumber.describe("Time"),
 }).describe("Follow record");
 export const ObjectEntityRegistrarSchema = ObjectBaseSchema.extend({
     entity_count: z.number().describe("Entity count. Number of entities registered in the entity registrar table. Use 'query_table' or 'query_table_item' to get 'EntityRegistrar' table items."),
@@ -56,16 +60,16 @@ export const ObjectResourceSchema = ObjectBaseSchema.extend({
 }).describe("On-chain address tag manager");
 export const TableItem_EntityLinkerSchema = ObjectBaseSchema.extend({
     address: z.string().describe("Followed ID"),
-    pos: z.number().describe("Current follow information position"),
-    count: z.number().describe("Follower count. Number of entities who have been followed others. Use 'query_table' or 'query_table_item' to get 'EntityLinker' table items."),
+    pos: tolerantNumber.describe("Current follow information position"),
+    count: tolerantNumber.describe("Follower count. Number of entities who have been followed others. Use 'query_table' or 'query_table_item' to get 'EntityLinker' table items."),
     votes: z.array(VoteInEntityLinkerSchema).describe("Follow records"),
 }).describe("On-chain followed object data");
 export const TableItem_EntityRegistrarSchema = ObjectBaseSchema.extend({
     address: z.string().describe("Entity ID"),
     description: z.string().describe("Entity description"),
-    time: z.number().describe("On-chain registration time"),
-    referrer: z.union([z.string(), z.null()]).describe("Referrer"),
-    mark_object: z.union([z.string(), z.null()]).describe("Your on-chain address mark object by entity ID"),
+    time: tolerantNumber.describe("On-chain registration time"),
+    referrer: tolerantStringNullable.describe("Referrer"),
+    mark_object: tolerantStringNullable.describe("Your on-chain address mark object by entity ID"),
     records: z.array(RecordsInEntitySchema).describe("Information records"),
 }).describe("On-chain entity data");
 export const TableItem_AddressMarkSchema = ObjectBaseSchema.extend({
@@ -134,13 +138,13 @@ export const ProgressSessionHolderSchema = z.object({
     retained_submission: z.array(GuardSubmissionSchema).describe("Used to define submitted data after Guard verification"),
     msg: z.string().describe("Information submitted to complete operation"),
     accomplished: z.boolean().describe("Whether completed"),
-    time: z.number().describe("Session creation time"),
+    time: tolerantNumber.describe("Session creation time"),
 }).describe("An operation in Progress session");
 export const ProgressSessionSchema = z.object({
     next_node: z.string().describe("Next node ID"),
     forwards: z.array(ProgressSessionHolderSchema).describe("Operation list in Progress session"),
-    weights: z.number().describe("Total operation weight"),
-    threshold: z.number().describe("Operation threshold. When total operation weight exceeds threshold, session is considered completed and Progress moves from current node to next node."),
+    weights: tolerantNumber.describe("Total operation weight"),
+    threshold: tolerantNumber.describe("Operation threshold. When total operation weight exceeds threshold, session is considered completed and Progress moves from current node to next node."),
 }).describe("Progress session");
 export const ObjectProgressSchema = ObjectBaseSchema.extend({
     machine: z.string().describe("Machine ID that Progress object belongs to"),
@@ -335,8 +339,8 @@ export const TableItem_RewardRecordSchema = ObjectBaseSchema.extend({
     total: BalanceTypeSchema.describe("Total reward amount"),
     record: z.array(z.object({
         amount: BalanceTypeSchema.describe("Reward amount"),
-        time: z.number().describe("Reward time"),
-        store_from_id: z.union([z.string(), z.null()]).describe("Stored value from Guard table. This stores the value (address or number converted to address, including submitted values) from the Guard table at the specified index for Guard verification purposes."),
+        time: tolerantNumber.describe("Reward time"),
+        store_from_id: tolerantStringNullable.describe("Stored value from Guard table. This stores the value (address or number converted to address, including submitted values) from the Guard table at the specified index for Guard verification purposes."),
     })).describe("Reward record list"),
 }).describe("Reward object's reward record");
 export const ObjectRepositorySchema = ObjectBaseSchema.extend({
@@ -820,31 +824,31 @@ export const ObjectPassportSchema = ObjectBaseSchema.extend({
 }).describe("Passport object");
 export const TableItem_PermissionPermSchema = ObjectBaseSchema.extend({
     address: z.string().describe("User ID or Guard ID"),
-    perm: z.array(PermissionIndexTypeSchema).describe("Permission list obtained after user or Guard object verification"),
+    perm: z.array(PermissionIndexTypeSchema.nullable().or(z.number())).describe("Permission list obtained after user or Guard object verification"),
 }).describe("Permission object's permission record");
 export const TableItem_DemandPresenterSchema = ObjectBaseSchema.extend({
     address: z.string().describe("Referrer ID"),
     recommend: z.string().describe("Recommendation letter"),
-    service: z.union([z.string(), z.null()]).describe("Recommended service object ID"),
-    update_time: z.number().describe("Last update time"),
-    acceptance_score: z.union([z.number(), z.null()]).describe("Demand object feedback score"),
+    service: tolerantStringNullable.describe("Recommended service object ID"),
+    update_time: tolerantNumber.describe("Last update time"),
+    acceptance_score: tolerantNumberNullable.describe("Demand object feedback score"),
     feedback: z.string().describe("Demand object feedback information"),
-    feedback_time: z.number().describe("Demand object feedback time"),
+    feedback_time: tolerantNumber.describe("Demand object feedback time"),
 }).describe("Demand object's Service recommendation record");
 export const MachineForwardGuardSchema = z.object({
     guard: z.string().describe("Guard object ID"),
-    retained_submission: z.array(z.number()).optional().describe("Data submitted by user during Guard object verification"),
+    retained_submission: z.array(tolerantNumber).nullable().optional().describe("Data submitted by user during Guard object verification"),
 }).strict().describe("Record of Guard object in MachineForwardGuard object");
 export const MachineForwardSchema = z.object({
     name: z.string().describe("Forward name"),
-    namedOperator: z.string().optional().describe("Forward operation permission 1: Namespace (one of the two must be specified); recommended if Progress object operators are different (e.g., different delivery personnel for different orders)."),
-    permissionIndex: PermissionIndexTypeSchema.optional().describe("Forward operation permission 2: Permission index (one of the two must be specified); recommended if all Progress object operators are the same (e.g., same reward reviewers for all orders)."),
-    weight: z.number().int().min(0).max(65535).describe("Forward weight"),
-    guard: MachineForwardGuardSchema.optional().describe("Guard object ID, if defined, Guard verification must also pass to complete Forward (e.g., completed promised supply chain sub-order)."),
+    namedOperator: tolerantStringNullable.describe("Forward operation permission 1: Namespace (one of the two must be specified); recommended if Progress object operators are different (e.g., different delivery personnel for different orders)."),
+    permissionIndex: tolerantNumberNullable.describe("Forward operation permission 2: Permission index (one of the two must be specified); recommended if all Progress object operators are the same (e.g., same reward reviewers for all orders)."),
+    weight: tolerantNumber.describe("Forward weight"),
+    guard: MachineForwardGuardSchema.nullable().optional().describe("Guard object ID, if defined, Guard verification must also pass to complete Forward (e.g., completed promised supply chain sub-order)."),
 }).strict().describe("Forward in Machine object");
 export const MachineNodePairSchema = z.object({
     prev_node: z.string().describe("Previous node name"),
-    threshold: z.number().int().min(0).max(4294967295).describe("Threshold to trigger node advancement. If total Forward weight is greater than or equal to threshold, node advancement is triggered."),
+    threshold: tolerantNumber.describe("Threshold to trigger node advancement. If total Forward weight is greater than or equal to threshold, node advancement is triggered."),
     forwards: z.array(MachineForwardSchema).describe("Forward list"),
 }).strict().describe("Node pair in Machine object");
 export const MachineNodeSchema = z.object({
@@ -856,20 +860,20 @@ export const TableItem_MachineNodeSchema = ObjectBaseSchema.extend({
     value: z.array(MachineNodePairSchema).describe("Node pair list"),
 }).describe("Node record in Machine object");
 export const TableItem_ProgressHistorySchema = ObjectBaseSchema.extend({
-    index: z.number().int().describe("Progress record index (starting from 0)"),
+    index: tolerantNumber.describe("Progress record index (starting from 0)"),
     node: z.string().describe("Previous node name"),
     next_node: z.string().describe("Next node name"),
     session: z.array(ProgressSessionSchema).describe("Progress session list"),
-    time: z.number().describe("Progress record completion time (Unix timestamp)"),
+    time: tolerantNumberNullable.describe("Progress record completion time (Unix timestamp)"),
 }).describe("Completed progress record in Progress object");
 export const TableItem_TreasuryHistorySchema = ObjectBaseSchema.extend({
     payment: NameOrAddressSchema.describe("Payment object ID"),
     op: TreasuryOpSchema.describe("Operation type"),
     signer: z.string().describe("Operator ID"),
-    external_guard: z.union([z.string(), z.null()]).describe("Guard object ID verified during operation (none if operated through Permission)"),
+    external_guard: tolerantStringNullable.describe("Guard object ID verified during operation (none if operated through Permission)"),
     amount: BalanceTypeSchema.describe("Payment amount"),
-    time: z.number().describe("Payment time (Unix timestamp)"),
-    store_from_id: z.union([z.string(), z.null()]).describe("Stored value from Guard table. This stores the value (address or number converted to address, including submitted values) from the Guard table at the specified index for Guard verification purposes."),
+    time: tolerantNumber.describe("Payment time (Unix timestamp)"),
+    store_from_id: tolerantStringNullable.describe("Stored value from Guard table. This stores the value (address or number converted to address, including submitted values) from the Guard table at the specified index for Guard verification purposes."),
 }).describe("Payment record in Treasury object");
 export const ObjectsQuerySchema = QueryEnvSchema.extend({
     objects: z.array(NameOrAddressSchema).describe("List of object IDs to query"),
@@ -1034,6 +1038,7 @@ export const OnchainEventsInputSchema = z.object({
 }).describe("Input parameters for querying on-chain WOWOK events");
 export const OnchainEventsResultSchema = z.object({
     result: z.union([EventAnswerSchema, z.null()]).describe("Event query result containing list of events and pagination info, or null if no data found"),
+    semantic: SemanticSummarySchema.optional().describe("Business semantic summary for the event query"),
 }).describe("Result of on-chain events query");
 export const TableItem_RepositoryDataOrUndefinedSchema = z.union([TableItem_RepositoryDataSchema, z.null()]).describe("Repository data item or null");
 export const TableItem_PermissionPermOrUndefinedSchema = z.union([TableItem_PermissionPermSchema, z.null()]).describe("Permission permission item or null");
@@ -1337,5 +1342,6 @@ export const AllQueryResultsSchema = z.union([
     OnchainQueryResultSchema_Part2,
 ]);
 export const WatchQueryOperationsResultSchema = z.object({
-    result: AllQueryResultsSchema
+    result: AllQueryResultsSchema,
+    semantic: SemanticSummarySchema.optional().describe("Business semantic summary for the query operation"),
 }).describe("Watch query operations result schema");

package/dist/schemas/account_operation.output.json

@@ -686,14 +686,7 @@
                                       },
                                       "parsedJson": {
                                         "type": "object",
-                                        "additionalProperties": {
-                                          "type": [
-                                            "string",
-                                            "number",
-                                            "boolean",
-                                            "null"
-                                          ]
-                                        },
+                                        "additionalProperties": {},
                                         "description": "Parsed JSON value of the event"
                                       },
                                       "sender": {
@@ -763,14 +756,7 @@
                                       },
                                       "parsedJson": {
                                         "type": "object",
-                                        "additionalProperties": {
-                                          "type": [
-                                            "string",
-                                            "number",
-                                            "boolean",
-                                            "null"
-                                          ]
-                                        },
+                                        "additionalProperties": {},
                                         "description": "Parsed JSON value of the event"
                                       },
                                       "sender": {
@@ -1375,6 +1361,29 @@
                 "error": {
                   "type": "string",
                   "description": "Error message"
+                },
+                "error_code": {
+                  "type": "string",
+                  "enum": [
+                    "invalid_parameter",
+                    "guard_rejected",
+                    "state_conflict",
+                    "insufficient_balance",
+                    "object_not_found",
+                    "permission_denied",
+                    "immutable_violation",
+                    "network_error",
+                    "unknown"
+                  ],
+                  "description": "Error classification for programmatic recovery"
+                },
+                "retryable": {
+                  "type": "boolean",
+                  "description": "Whether the operation can be retried as-is"
+                },
+                "recovery_hint": {
+                  "type": "string",
+                  "description": "Recovery suggestion for AI or user"
                 }
               },
               "required": [
@@ -1385,6 +1394,9 @@
             }
           ],
           "description": "Account operation output schema with discriminator"
+        },
+        "semantic": {
+          "description": "Business semantic summary for account operation"
         }
       },
       "required": [

package/dist/schemas/account_operation.schema.json

@@ -72,7 +72,7 @@
           "properties": {
             "address": {
               "type": "string",
-              "description": "Valid ID: 0x prefix + 64 hex characters, or builtin ID (0x5-0x9, @0xaaa, @0xaab, @0x403, @0xacc, @0xc)"
+              "description": "Valid ID: 0x prefix + 64 hex characters, or builtin ID (0x5-0x9, 0xa, 0xc, 0xd, 0x403, 0xaaa, 0xaab, 0xacc)"
             },
             "name": {
               "$ref": "#/definitions/account_operation/properties/gen/properties/name",
@@ -250,7 +250,7 @@
         }
       },
       "additionalProperties": false,
-      "description": "Account operations"
+      "description": "Account operations. Parameters MUST be wrapped in the operation type property (e.g. {transfer: {...}}, NOT {amount: ...}). Unwrapped parameters are rejected."
     }
   }
 }